Repository map¶

Path	Purpose
`src/`	React/Vite frontend and browser adapters.
`src/domain/`	Typed snapshot, command, mission, and constellation contracts.
`src/adapters/mock/`	Deterministic browser-local adapter.
`src/adapters/replay/`	Read-only fixture adapter.
`src/adapters/speech/clientWhisper/`	Client-only Whisper Worker and model state.
`backend/orion_backend/`	FastAPI application and live service boundaries.
`backend/tests/`	Backend contract and provider-gated tests.
`docs/`	Detailed runbooks, requirements, tickets, and evidence.
`docs-site/`	Curated public MkDocs documentation.
`mkdocs.yml`	MkDocs navigation and strict build settings.
`infra/deploy/template.yaml`	CloudFormation resources and outputs.
`infra/deploy/scripts/`	Validation, backend deploy, and frontend/docs publish scripts.
`public/`	Browser assets shipped with the frontend.
`requirements-docs.txt`	MkDocs Material build dependency.

Ownership rule¶

Keep public explanations in docs-site/. Keep deep evidence and operational records in docs/. Update both when a public claim changes.

Runtime source of truth¶

The code and deployment configuration are authoritative for active provider names, routes, and limits. A document is not permission to enable a future-only provider.