Route map (authoritative)

This document is the route truth for Atlas. Phase Truth-A adds automated checks against ui/src/App.tsx and cmd/atlas-gateway/main.go.

Workstation SPA (/app/*)

Base path: basename = /app (see ui/src/main.tsx).

Path pattern	Kind	Notes
/app	redirect	→ /app/home
/app/home	page	Home / Today surface
/app/investigate	page	Tabs: ?tab=search|corpus|compare|graph
/app/cases	page	Case list
/app/cases/:id	page	Case workspace; phase in ?phase= (corpus, resolve, graph, plan, review)
/app/cases/:id/:legacyTab	redirect	Historical tab URLs → /app/cases/:id?phase=… (see ui/src/App.tsx)
/app/studio	page	Studio workspace (≥1024px) or mobile fallback
/app/studio/bundle/:id	page	Read-only bundle permalink (all viewports)
/app/govern	page	Governance / clean-core
/app/operate/corpus	page	Corpus + collector / graph health (Operate)
/app/settings/access	page	People & access (djed-iam-ui, gated)
/app/access/invite/:token	page	Invite acceptance (IAM)
/app/_playground	dev-only	When DEV, VITE_ATLAS_PLAYGROUND=1, or VITE_ENABLE_PLAYGROUND=1

Legacy redirects (telemetry: legacy-redirect; source: ui/src/shell/legacy-redirects.ts)

From	To
/app/overview	/app/home
/app/command-center	/app/home
/app/control	/app/govern
/app/resolve	/app/investigate
/app/evidence	/app/investigate
/app/knowledge	/app/investigate?tab=corpus
/app/corpus	/app/investigate?tab=corpus
/app/compare	/app/investigate?tab=compare
/app/graph	/app/investigate?tab=graph
/app/explorer	/app/investigate?tab=graph
/app/plan	/app/cases?intent=new-plan
/app/planner	/app/cases?intent=new-plan
/app/clean-core	/app/govern

Gateway API (/api/atlas/*)

All routes are under the /api/atlas prefix (chi mountAPI).

Core & retrieval

• GET/POST /api/atlas/resolve
• GET /api/atlas/resolve/intents
• POST /api/atlas/traverse
• GET /api/atlas/artifacts, GET /api/atlas/artifacts/{id}
• GET /api/atlas/corpus, GET /api/atlas/corpus/{id}
• GET /api/atlas/guidance
• GET /api/atlas/plan/versions
• POST /api/atlas/plan
• POST /api/atlas/answer/stream
• GET /api/atlas/crawl/status
• GET /api/atlas/documents, GET /api/atlas/documents/{id}

Studio

• POST /api/atlas/studio/classify, /plan, /scaffold, /pipeline
• GET/POST /api/atlas/studio/generations, GET/DELETE /api/atlas/studio/generations/{id}, DELETE /api/atlas/studio/generations

Control & corpus ops

• GET /api/atlas/control/scorecard
• GET /api/atlas/clean-core/readiness
• POST /api/atlas/corpus/extract, POST /api/atlas/corpus/recrawl (alias)
• GET /api/atlas/corpus/status, GET /api/atlas/graph/status
• POST /api/atlas/graph/rebuild

Projects

• POST/GET /api/atlas/projects
• GET/PATCH/DELETE /api/atlas/projects/{id}
• GET /api/atlas/projects/{id}/evidence
• POST /api/atlas/projects/{id}/evidence/upload
• GET /api/atlas/projects/{id}/assets
• POST /api/atlas/projects/{id}/assets/report, .../report/pdf, .../evidence-export, .../migration-plan
• GET /api/atlas/projects/{id}/assets/latest-plan
• GET /api/atlas/projects/{id}/assets/{assetID}/download

Cases

• POST/GET /api/atlas/cases
• GET/PATCH/DELETE /api/atlas/cases/{id}
• POST /api/atlas/cases/{id}/duplicate, /bundle, /estimate
• GET /api/atlas/cases/{id}/bundles, /estimates, /runs, /events, /summary, /evidence, /recommendations, /feedback, /audit
• POST /api/atlas/cases/{id}/investigate
• PATCH /api/atlas/cases/{id}/recommendations/{recId}

Plan lifecycle (case-scoped)

Under /api/atlas/cases/{caseId}/plans:

• GET /, POST /
• POST /generate
• GET /{planId}
• POST /{planId}/transitions, /reviews, /transports
• GET /{planId}/reviews, /deliveries

Under /api/atlas/cases/{caseId}/plan-webhooks:

• GET /, POST /
• DELETE /{webhookId}