# Tech context
<!-- generated by `orchestrator understand`; the PKG is source of truth, edits here are advisory -->

| Aspect | Value |
|---|---|
| Languages | javascript, python |
| Framework | fastapi |
| Database | yes |
| Migrations | yes |
| Test runner | pytest |
| Task type (default) | feature |
| Version | `3.25.0` |
| Requires Python | `>=3.12` |

## Infrastructure & runtime
_Read from manifests, build files, and container configs. Absence means "not declared here", not "unused"._

**To stand it up, you'll need:** PostgreSQL, SQL via SQLAlchemy (ORM), SQLite, DB migrations (Alembic), Temporal (workflow engine), LangGraph (agent orchestration), AWS (boto3), S3 / MinIO object storage.

- **Web / API:** FastAPI (HTTP API), uvicorn (ASGI server)
- **Datastores:** PostgreSQL, SQL via SQLAlchemy (ORM), SQLite, DB migrations (Alembic)
- **Messaging / workers:** Temporal (workflow engine), LangGraph (agent orchestration)
- **Cloud / storage:** AWS (boto3), S3 / MinIO object storage
- **Observability:** OpenTelemetry (tracing), Jaeger (tracing)
- **Auth / crypto:** JWT auth
- **Domain / semantic:** RDF graph (rdflib), SHACL validation
- **Containers & deploy:** docker-compose: PostgreSQL, MinIO (S3 object storage), MinIO client, Temporal (workflow engine), Temporal UI, Jaeger (tracing)
- **Build & CI:** GitHub Actions
- **External services (env):** Anthropic API, Jira, Confluence

## Entry points
_How this system starts._

- `orchestrator` → orchestrator.cli:app (console script)
- `orchestrator-mcp` → orchestrator.plugin.__main__:main (console script)
- `main()` @ scripts/agentic_eval.py:100
- `main()` @ scripts/audit_eval.py:54
- `main()` @ scripts/bench_aggregate.py:94
- `main()` @ scripts/codegen_ab.py:242
- `main()` @ scripts/codegen_benchmark.py:1853
- `main()` @ scripts/live_sdlc_worker.py:44

## Most-used external imports
_Everything imported from outside this codebase, by how often — standard library and test dependencies included, so this is wider than the install list._

- `__future__.annotations` — imported 631 times
- `pathlib.Path` — imported 257 times
- `typing.Any` — imported 235 times
- `pytest` — imported 178 times
- `dataclasses.dataclass` — imported 136 times
- `json` — imported 135 times
- `collections.abc` — imported 115 times
- `os` — imported 97 times
- `asyncio` — imported 77 times
- `httpx` — imported 73 times

_Top 10 of 202._
