A reasoning runtime that interprets user queries and delivers curated answers from across network provider sources.
uv sync
uv run uvicorn --factory dss.entrypoint.app:create_app --port 8077POST /v1/turns — the Accept header selects application/json or
text/event-stream. The reasoning is stubbed today; the transport, the port,
and the turn flow are real.
See docs/RUNNING.md for curl recipes, the error paths,
the runtime knobs, and which parts are still fake. Two pieces of configuration
are worth knowing before a first run: the schema packs, which nothing
clones, and the district index (src/dss/config/districts.csv), which the
/discover spatial filter needs and without which the app refuses to boot.
CLAUDE.md— layout, tech stack, testing tiersCONVENTIONS.md— naming, commits, git workflowdocs/DSS_ARCHITECTURE.md— boundary and open itemsdocs/HEXAGONAL_ARCHITECTURE.md— ports and adaptersdocs/ADR/— accepted decisions