nntrivi2001
57dc91585d
Internal SmartGift build of a Claude Code monitoring dashboard. Lanes: a durable unit of parallel agent work, one per working directory, tracked across session restarts. Managed lanes are git worktrees the dashboard provisions and can reset or remove behind a three-check destroy guard and a counted preflight; adopted lanes are directories you already own and are never destroyable. Pipelines: a lane moves through pipeline stages. A stage the agent declares with evidence renders green; a stage inferred from the tool-event stream renders dashed amber and never counts as done. Detection is forward-only within a 30-minute window, and never writes the declared stage. Workspace: one page at /run with a lane grid, the selected lane's pipeline, and a full Claude console behind a disclosure.
21 lines
778 B
Markdown
21 lines
778 B
Markdown
# Module Map
|
|
|
|
## Backend
|
|
- `server/index.js`: app composition, startup behavior, periodic maintenance.
|
|
- `server/db.js`: schema and prepared statement ownership.
|
|
- `server/routes/*.js`: endpoint contracts by domain.
|
|
- `server/websocket.js`: WS lifecycle and broadcast behavior.
|
|
|
|
## Frontend
|
|
- `client/src/pages/`: route-level screens.
|
|
- `client/src/components/`: reusable UI building blocks.
|
|
- `client/src/lib/api.ts`: client API access patterns.
|
|
- `client/src/hooks/useWebSocket.ts`: live update pipeline.
|
|
|
|
## MCP
|
|
- `mcp/src/index.ts`: runtime entrypoint.
|
|
- `mcp/src/server.ts`: MCP assembly.
|
|
- `mcp/src/tools/domains/`: domain tool registration.
|
|
- `mcp/src/clients/dashboard-api-client.ts`: resilient API bridge.
|
|
- `mcp/src/policy/tool-guards.ts`: mutation/destructive gates.
|