feat: Claude Code Monitor — lanes, pipelines and a merged workspace

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.
2026-07-29 17:07:45 +07:00
commit 57dc91585d
783 changed files with 221743 additions and 0 deletions
@@ -0,0 +1,21 @@
+---
+name: mcp-maintainer
+description: Operate and maintain the local MCP server for this repository. Use for MCP tool updates, policy-guard changes, host configuration, and MCP runtime troubleshooting.
+---
+
+# MCP Maintainer Skill
+
+## Workflow
+- Confirm dashboard API availability (`/api/health`).
+- Inspect affected MCP domain modules under `mcp/src/tools/domains/`.
+- Preserve safety gates in `mcp/src/policy/tool-guards.ts`.
+- Validate with `npm run mcp:typecheck` and `npm run mcp:build`.
+
+## Safety rules
+- Keep loopback-only target checks enabled.
+- Keep mutating and destructive tools behind explicit flags.
+- Do not log protocol data to stdout.
+
+## References
+- `references/tool-domain-map.md`
+- `references/operations-runbook.md`
@@ -0,0 +1,4 @@
+interface:
+  display_name: "MCP Maintainer"
+  short_description: "Maintain MCP tools, policy gates, and host integration."
+  default_prompt: "Use mcp-maintainer to update MCP tooling safely and verify runtime integrity."
@@ -0,0 +1,14 @@
+# MCP Operations Runbook
+
+## Modes
+- Read-only:
+  - `MCP_DASHBOARD_ALLOW_MUTATIONS=false`
+  - `MCP_DASHBOARD_ALLOW_DESTRUCTIVE=false`
+- Admin:
+  - Set mutations true for controlled maintenance operations.
+- Destructive:
+  - Set both true and require `confirmation_token = CLEAR_ALL_DATA`.
+
+## Verification
+- `npm run mcp:typecheck`
+- `npm run mcp:build`
@@ -0,0 +1,8 @@
+# MCP Tool Domain Map
+
+- `observability-tools.ts`: health, stats, analytics, snapshots, export.
+- `session-tools.ts`: list/get/create/update sessions.
+- `agent-tools.ts`: list/get/create/update agents.
+- `event-tools.ts`: event listing and hook ingestion.
+- `pricing-tools.ts`: pricing CRUD and cost calculations.
+- `maintenance-tools.ts`: cleanup, reimport, reinstall hooks, destructive clear.
@@ -0,0 +1,21 @@
+---
+name: release-guard
+description: Run release-readiness checks for this repository. Use when validating docs, scripts, verification coverage, and operational safety before merge or release.
+---
+
+# Release Guard Skill
+
+## Workflow
+- Check command consistency across docs and `package.json`.
+- Verify architecture docs align with current code paths.
+- Validate that safety controls are still documented and enforced.
+- Report pass/fail with concrete file references.
+
+## Focus areas
+- Hook flow and failure behavior.
+- Session/agent lifecycle semantics.
+- MCP safety gates and host setup instructions.
+- Troubleshooting accuracy.
+
+## References
+- `references/release-checklist.md`
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Release Guard"
+  short_description: "Audit release readiness across code, docs, and safety controls."
+  default_prompt: "Use release-guard to audit this branch for release readiness and report concrete findings."
@@ -0,0 +1,7 @@
+# Release Checklist
+
+- Commands in docs exist in root `package.json`.
+- Validation steps are documented for backend, frontend, and MCP.
+- Behavior-changing diffs mention migration/compatibility impacts.
+- Safety-sensitive operations remain guarded by explicit flags.
+- Troubleshooting sections reflect the current architecture.
@@ -0,0 +1,21 @@
+---
+name: repo-onboarding
+description: Understand this repository quickly before making changes. Use for architecture discovery, ownership mapping, command selection, and initial implementation planning.
+---
+
+# Repo Onboarding Skill
+
+## Workflow
+- Read `AGENTS.md`, `README.md`, and `ARCHITECTURE.md`.
+- Determine target layer: `server/`, `client/`, `mcp/`, or docs.
+- Identify the minimal file set needed for the task.
+- Select verification commands before editing.
+
+## Verification defaults
+- Backend: `npm run test:server`
+- Frontend: `npm run test:client`
+- MCP: `npm run mcp:typecheck` and `npm run mcp:build`
+
+## References
+- `references/module-map.md`
+- `references/verification-map.md`
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Repo Onboarding"
+  short_description: "Map architecture, ownership, and verification strategy before coding."
+  default_prompt: "Use repo-onboarding to analyze scope, affected modules, and validation commands for this task."
@@ -0,0 +1,9 @@
+# Module Map
+
+- `server/index.js`: app startup and route mounting.
+- `server/routes/*.js`: API contracts and route behavior.
+- `server/db.js`: schema and statement layer.
+- `server/websocket.js`: live update broadcast path.
+- `client/src/pages/`: route-level UI.
+- `client/src/components/`: reusable UI primitives.
+- `mcp/src/tools/domains/`: MCP tool families.
@@ -0,0 +1,11 @@
+# Verification Map
+
+- Backend changes:
+  - `npm run test:server`
+- Frontend changes:
+  - `npm run test:client`
+- MCP changes:
+  - `npm run mcp:typecheck`
+  - `npm run mcp:build`
+- Docs-only changes:
+  - validate command consistency against root `package.json`