Agent Reference¶
This section is the agent-facing handbook for ElasticBLAST Control Plane. The pages were extracted from .github/copilot-instructions.md so the always-loaded charter stays small while the deep references remain searchable.
Audience: AI coding agents (GitHub Copilot, Claude, Cursor) and new human contributors who need fast orientation in the codebase.
Pages¶
| Page | When to read |
|---|---|
| Codebase Map | Quick "where does X live" lookup across api/, web/, infra/, terminal/. |
| Repo Layout | Full directory tree + edit-boundary table. |
| Auth Flow | MSAL + managed identity request lifecycle. |
| Browser Terminal | terminal sidecar lifecycle, image, exec contract. |
| Resource Plane | FastAPI/Celery ownership, task families, queues, and durable state contracts. |
| Monitoring UI | Current Dashboard bands, cards, optional Message Flow, and refresh behavior. |
| Dashboard UI | Current dark/light tokens, flat panel styling, motion, and accessibility rules. |
| Version Management | bump-version.sh policy and SPA header stamp pipeline. |
| Security Audit Follow-up | Open design items from the 20-finding security sweep. |
Related¶
- Full charter: .github/copilot-instructions.md
- Navigation map: AGENTS.md