feat: analytics parity — tool cost, date ranges, budgets, query explorer, replay, snapshots (v2.4.0)

Analytics parity phases 2–7 (docs/plans/analytics-parity/), built on
138e706 and ported onto v2.3.1:
- Cost by AI tool (?tool= on cost/analytics/stats/workflows, by_tool,
  Codex fast/priority and flex tiers, agenthub_cost_usd_total{tool,model})
- Date ranges (from/to) on cost/analytics/workflows; Analytics range select
  with Today / This week (Monday) / This month (1st) / 7d / 30d / 90d / All /
  Custom; workflow filters carried into workflow-stats.js (read worker)
- Budgets and cost alerts as alert rule types (alert_rules rebuilt without
  its rule_type CHECK), GET /api/budgets/status, rule preview, spend pace,
  status-bar budget chip; rules stay editable in place
- Query Explorer (/query, allowlisted sort, CSV/JSON export) and scheduled
  reports (report_definitions/report_runs, Settings → Reports)
- Session Replay tab and immutable snapshots (session_snapshots, /snapshot/:token)
- Remote Codex sync, push ingest with a hashed token, privacy redaction and
  ignored folders (Settings → Data), Cursor sessions (no cost)
- Read-only MCP server, statusline, Grafana/Prometheus files

Also: resizable sidebar, pet run/wave animations, the workspace home keeps a
half-typed prompt, and the pre-commit hook runs only the related tests for a
small commit.

docs/DEPLOYMENT.md

@@ -189,7 +189,8 @@ npm run dev:server
 # Terminal 2: Client only
 npm run dev:client
 
-# Terminal 3: MCP server (optional)
+# Terminal 3: MCP server (optional; normally Claude Code starts it — docs/MCP.md)
+node mcp/server.js
 ```
 
 ---
@@ -257,6 +258,8 @@ DASHBOARD_CODEX_POLL_MS=15000           # Codex rollout journals → codex lane
 CODEX_HOME=                             # where Codex keeps sessions/ (default ~/.codex)
 DASHBOARD_ANTIGRAVITY_POLL_MS=15000     # agy conversation files → Antigravity sessions/tokens
 AGENTHUB_GEMINI_DIR=                    # where agy keeps its data (default ~/.gemini)
+DASHBOARD_CURSOR_POLL_MS=15000          # Cursor agent transcripts → Cursor sessions (no tokens)
+AGENTHUB_CURSOR_DIR=                    # where Cursor keeps its data (default ~/.cursor)
 
 # Pricing and saved settings
 AGENTHUB_PRICING_SYNC=                  # 0|false|off disables automatic pricing from LiteLLM (default on)
@@ -532,21 +535,17 @@ graph TB
 
 ### Monitoring Metrics
 
-```javascript
-// Add to server/index.js for metrics endpoint
-app.get('/metrics', (req, res) => {
-  const metrics = {
-    uptime: process.uptime(),
-    memory: process.memoryUsage(),
-    cpu: process.cpuUsage(),
-    sessions: db.prepare('SELECT COUNT(*) as count FROM sessions').get(),
-    agents: db.prepare('SELECT COUNT(*) as count FROM agents').get(),
-    websocket_clients: wss.clients.size
-  };
-  res.json(metrics);
-});
+The server already exposes Prometheus metrics at `GET /api/metrics`
+([API.md § Prometheus exposition](./API.md#prometheus-exposition)). A scrape
+config, recording rules and three Grafana boards ship in `monitoring/`:
+
+```bash
+DASHBOARD_ALLOWED_HOSTS=host.docker.internal npm start
+GF_SECURITY_ADMIN_PASSWORD='choose-one' docker compose -f docker-compose.monitoring.yml up -d
 ```
 
+See [MONITORING.md](./MONITORING.md).
+
 ---
 
 ## Backup & Recovery