@tekyzinc/gsd-t 3.23.11 → 3.25.10

package/docs/architecture.md

@@ -1126,3 +1126,197 @@ A new Red Team category — "Test Pass-Through — Journey Edition" — extends
 
 Contract: `.gsd-t/contracts/journey-coverage-contract.md` v1.0.0.
 
+## Live Activity Observability (M54 — v3.24.10)
+
+The dashboard left rail today only catches detached `claude -p` workers via `.gsd-t/spawns/*.json`. Heavy in-session work (a backgrounded `Bash`, a `Monitor` watch, a slow tool_use) has no rail representation, leaving the user blind to what's running. M54 adds a "LIVE ACTIVITY" section between MAIN SESSION and LIVE SPAWNS that surfaces all four kinds in one place.
+
+**Module**: `bin/live-activity-report.cjs` — `computeLiveActivities({projectDir, now?})` returns the contract shape. Pure read-only, silent-fail. Mirrors `bin/parallelism-report.cjs` shape; installed via `installGlobalBinTools()` to `~/.claude/bin/live-activity-report.cjs`.
+
+**Data flow**:
+
+```
+  .gsd-t/events/*.jsonl              ─┐         (heartbeat-emitted tool events)
+  ~/.claude/projects/<slug>/<sid>.jsonl ┼─▶  bin/live-activity-report.cjs
+  .gsd-t/spawns/*.json               ─┘            │  (dedupe by tool_use_id)
+                                                   ▼
+                              scripts/gsd-t-dashboard-server.js
+                              (5s in-memory cache, additive endpoints)
+                                ├── GET /api/live-activity            → JSON index
+                                ├── GET /api/live-activity/<id>/tail  → last 64 KB stdout/stderr
+                                └── GET /api/live-activity/<id>/stream → SSE follow-up
+                                                   │
+                                                   ▼
+                              scripts/gsd-t-transcript.html
+                              `<aside class="left-rail">` — new section "LIVE ACTIVITY"
+                              polls /api/live-activity every 5s; pulses new entries
+```
+
+**Liveness falsifiers** (any → entry leaves activities[]):
+1. Explicit terminating event (tool_result, monitor_stopped, spawn_completed).
+2. PID check fails (`process.kill(pid, 0)` throws ESRCH) for kinds with a recorded PID.
+3. Source file mtime > 60s old.
+
+**Pulse semantics**: new entries get class `.la-pulsing`. Pulse stops on click OR on liveness loss OR after 30s — whichever first. No auto-switch of the bottom pane on entry arrival; only the pulse signals attention.
+
+**Silent-fail invariant**: malformed events JSONL, missing slug-decoded transcript, unreadable spawn-plan JSON — every case logs to `metrics.notes` and continues with partial data. Observer must never throw when watching a live system.
+
+**Out of scope**: cross-project aggregation (read OTHER projects' transcripts) is M55 candidate territory.
+
+Contract: `.gsd-t/contracts/live-activity-contract.md` v1.0.0 STABLE (D1 complete 2026-05-07).
+
+**Endpoint signatures** (D1 implemented):
+- `GET /api/live-activity` → `handleLiveActivity(req, res, projectDir)` — 5s cache, `Cache-Control: no-store`, returns JSON envelope `{schemaVersion:1, activities:[], notes:[]}`
+- `GET /api/live-activity/<id>/tail` → `handleLiveActivityTail(req, res, projectDir, id)` — 5s per-id cache, path-traversal guard via `isValidActivityId`, 400 on invalid id, 404 on unknown id
+- `GET /api/live-activity/<id>/stream` → `handleLiveActivityStream(req, res, projectDir, id)` — SSE, uncached, 15s heartbeat, closes when activity removed
+
+**Install path**: `~/.claude/bin/live-activity-report.cjs` (via `GLOBAL_BIN_TOOLS` in `bin/gsd-t.js`, installed by `installGlobalBinTools()`).
+
+**D2 rail section** (`scripts/gsd-t-transcript.html`, D2 complete 2026-05-07):
+
+The viewer's left rail gains a new `<section id="rail-live-activity">` inserted between MAIN SESSION and LIVE SPAWNS. The section is purely additive — no existing sections were modified.
+
+Rail behavior:
+- 5s polling interval via `setInterval` (`wireLiveActivity()` IIFE in inline `<script>`)
+- On each poll, `reconcile(activities)` diffs the DOM against the API response:
+  - New entries: `appendActivity(entry)` creates `.la-entry` with dot + icon + 40-char label + duration counter; applies `.la-pulsing`
+  - Removed entries: `removeActivity(id)` removes element from DOM
+  - Existing entries: `updateDuration(id, startedAt)` refreshes the wall-clock counter
+- Pulse stops on: (a) click, (b) entry absent in next response, (c) 30s elapsed (`setTimeout`)
+- Click handler: `stopPulse(id)` + `loadTailUrl(tailUrl)` — loads tail content into the bottom pane; NO auto-switch on entry arrival
+- Error tolerance: fetch 500 or network error → log once, empty section header, no crash
+
+CSS additions: `@keyframes accent-pulse` (~1.5s), `.la-pulsing`, `.la-dot-running` (teal), `.la-dot-stale` (dimmed), `.la-icon-{bash,monitor,tool,spawn}`, `.la-label` (40-char truncated).
+
+**Executable attestation**: 2 live-journey specs in `e2e/live-journeys/`:
+- `live-activity.spec.ts`: single bash, asserts 5s appearance, pulse, duration tick, click→tail, kill→5s disappearance; self-skips if no dashboard
+- `live-activity-multikind.spec.ts`: 3 concurrent kinds (bash + monitor + tool) via synthetic events JSONL, asserts dedup correctness; self-skips if no dashboard
+
+## CLI-Preflight Pattern + Verify-Gate (M55 — v3.25.10)
+
+M55 ships a deterministic, pluggable state-precondition library + parallel-CLI
+substrate + two-track verify-gate that lift the practical parallelism ceiling
+from ~3 LLM workers to ~6–10 mixed workers (1 LLM judge + N CLIs) by replacing
+deterministic LLM work with deterministic CLI work, prove the lift via empirical
+measurement, and gate every spawn with deterministic state checks.
+
+### Five domains, three waves
+
+| Domain | Owns | Wave |
+|--------|------|------|
+| D1 — `m55-d1-state-precondition-library` | `bin/cli-preflight.cjs` + 6 checks under `bin/cli-preflight-checks/` + `cli-preflight-contract.md` | Wave 1 (parallel) |
+| D2 — `m55-d2-parallel-cli-substrate` | `bin/parallel-cli.cjs` + `bin/parallel-cli-tee.cjs` + `bin/m55-substrate-proof.cjs` + `parallel-cli-contract.md` | Wave 2 |
+| D3 — `m55-d3-ratelimit-probe-map` | `bin/gsd-t-ratelimit-probe.cjs` + worker + 4 fixtures + `.gsd-t/ratelimit-map.json` + `ratelimit-map-contract.md` | Wave 1 (parallel) |
+| D4 — `m55-d4-context-brief-generator` | `bin/gsd-t-context-brief.cjs` + 6 kind collectors + `context-brief-contract.md` | Wave 1 (parallel) |
+| D5 — `m55-d5-verify-gate-and-wirein` | `bin/gsd-t-verify-gate.cjs` + judge companion + 3 e2e/journeys SC3 specs + all wire-ins + doc ripple + `verify-gate-contract.md` | Wave 3 |
+
+### Pattern A — State Preflight (D1)
+
+`bin/cli-preflight.cjs::runPreflight({projectDir, checks?})` returns a versioned
+envelope `{schemaVersion: '1.0.0', ok, checks: [], notes: []}`. Six built-in
+checks (kebab-case ids; severity `error`/`warn`/`info`):
+
+- `branch-guard` (error) — reads project CLAUDE.md `Expected branch:` line, compares to `git branch --show-current`
+- `contracts-stable` (warn) — flags `Status: DRAFT`/`PROPOSED` contracts past PARTITIONED
+- `deps-installed` (warn) — `node_modules/` present + lockfile mtime ≥ manifest mtime
+- `manifest-fresh` (info) — `.gsd-t/journey-manifest.json` mtime ≥ every `e2e/journeys/*` mtime
+- `ports-free` (error) — `requiredFreePorts: number[]` from `.gsd-t/.unattended/config.json` not occupied
+- `working-tree-state` (warn) — `git status --porcelain` clean (or whitelisted)
+
+Top-level `ok` flips to `false` only when at least one `severity:"error"`
+check fails. Non-error failures (warn/info) record but do not block. Adding a
+new check is a single-file drop into `bin/cli-preflight-checks/`. CLI exit
+codes: 0 = ok, 4 = fail. captureSpawn-exempt (pure inspection, no LLM spawn).
+
+### Pattern B — Context Brief (D4)
+
+`bin/gsd-t-context-brief.cjs::generateBrief({projectDir, kind, domain, spawnId})`
+generates a ≤10 KB / ≤2,500-token JSON snapshot that replaces the 30–60k context
+re-read every parallel worker would otherwise perform — the dominant ITPM-relief
+lever in M55. Six kinds: `execute`, `verify`, `qa`, `red-team`,
+`design-verify`, `scan`. Schema includes `sourceMtimes` for freshness and
+ALPHABETICAL top-level keys for deterministic byte-identical re-runs.
+
+Briefs land at `.gsd-t/briefs/{spawnId}.json` (gitignored — per-spawn
+ephemera). Workers receive `$BRIEF_PATH` in their prompt scaffold.
+
+`qa`, `red-team`, and `design-verify` kinds fail-closed on missing required
+sources. `--strict` upgrades fail-open kinds (`execute`, `verify`, `scan`) to
+fail-closed. Path safety: `--domain` and `--spawn-id` accept ONLY `^[a-zA-Z0-9_-]+$`.
+
+### Pattern C — Empirical Rate-Limit Map (D3)
+
+`bin/gsd-t-ratelimit-probe.cjs` sweeps a `{1,2,3,4,5,6,8} workers × {10k,30k,60k,100k} context` matrix
+across real Claude Max OAuth spawns. The published `.gsd-t/ratelimit-map.json`
+declares: `peakConcurrency=8`, `safeConcurrencyAt60kContext=5`,
+`perWorkerContextBudgetTokens=30000`, `backoffMs=0`,
+`steadyState3Workers5MinPass=true`, **0/84 total 429s**.
+
+D5's verify-gate reads `recommended.peakConcurrency` and passes it to
+`runParallel`'s `maxConcurrency`. If the map is missing,
+verify-gate falls back to `maxConcurrency=2` and logs a structured note.
+
+Account masking enforced: `oauth-c2cc7a8131c440c8`-prefix only, never raw
+token, per `ratelimit-map-contract.md` § Account Masking.
+
+### Pattern D — Parallel-CLI Substrate (D2)
+
+`bin/parallel-cli.cjs::runParallel({workers, maxConcurrency, failFast?, teeDir?})`
+is the engine D5's verify-gate fans out through. Every worker spawn flows
+through `bin/gsd-t-token-capture.cjs::captureSpawn` (CLIs render `—` in the
+Tokens cell — never `0`, never `N/A`). Per-worker NDJSON tee via
+`bin/parallel-cli-tee.cjs`. Per-worker timeout cancels only that worker;
+fail-fast SIGTERM in-flight + 5s grace SIGKILL.
+
+`bin/m55-substrate-proof.cjs` records the empirical speedup: **5.57×** wall-clock
+reduction (T_serial=1813.3ms vs T_par=325.6ms across 6 sleep=250ms workers).
+
+### Two-Track Verify-Gate (D5)
+
+`bin/gsd-t-verify-gate.cjs::runVerifyGate(...)` runs BOTH tracks unconditionally
+unless explicitly skipped via `--skip-track1`/`--skip-track2` (diagnostic-only).
+
+- **Track 1** = D1 preflight envelope; hard-fails on any `severity:"error"` check.
+- **Track 2** = D2 `runParallel` fans out off-the-shelf CLIs: `tsc` (typecheck),
+  `biome`/`ruff` (lint), `npm test` (tests), `knip` (dead-code), `gitleaks` (secrets),
+  `scc`/`lizard` (complexity). Detected via `node_modules/.bin/` and PATH probes —
+  D5 NEVER auto-installs.
+
+`top-level ok = (skipTrack1 || track1.ok) && (skipTrack2 || track2.ok)` —
+purely deterministic. The LLM judge sees only the `summary` field (≤500 tokens,
+head-and-tail snippets per worker; raw stdout/stderr stays at
+`.gsd-t/verify-gate/{runId}/{workerId}.{stdout,stderr}.ndjson` for human-only
+inspection). The judge confirms or contradicts the deterministic verdict; it
+never overrides `ok`.
+
+`bin/gsd-t-verify-gate-judge.cjs` produces the ≤500-token LLM prompt scaffold,
+shrinking failedWorkers/failedChecks lists and snippets iteratively to fit
+the budget regardless of envelope size.
+
+### Wire-Ins
+
+Four CLI subcommands in `bin/gsd-t.js`: `gsd-t preflight`, `gsd-t brief`,
+`gsd-t verify-gate`, `gsd-t verify-gate-judge`. All four added to
+`GLOBAL_BIN_TOOLS` so `~/.claude/bin/` updates propagate via `gsd-t update-all`.
+
+Command-file additive blocks (gated by `<!-- M55-D5: ... -->` markers asserted
+by 3 wire-in tests):
+- `commands/gsd-t-execute.md` Step 1 — preflight + brief invocation, threads
+  `$BRIEF_PATH` into worker prompt scaffolds
+- `commands/gsd-t-verify.md` Step 2 — verify-gate invocation + judge pipe
+- `templates/prompts/{qa,red-team,design-verify}-subagent.md` — "brief first"
+  rule directs workers to grep the ≤2,500-token snapshot before re-walking the repo
+
+### Success Criteria — Falsifiable
+
+1. ✓ State-preflight envelope schema published as STABLE contract (D1)
+2. ✓ Substrate proves ≥3× speedup — measured 5.57× (D2)
+3. ✓ Verify-gate blocks ≥3 distinct preflight failure classes — wrong branch +
+   port conflict + DRAFT contract, evidenced by 3 e2e/journeys specs (D5)
+4. ☐ ≥40% token reduction per milestone for execute+verify cycles (measured
+   during integrate phase)
+5. ✓ Zero 429 errors at parallelism level D3 declared safe + peak parallelism
+   ≥6 — measured 0/84 errors at peak 8 (D3)
+6. ☐ Verify-gate wall-clock ≤ ½ trailing-3 median (measured during integrate)
+7. ☐ Red Team GRUDGING PASS — ≥5 broken patches, all caught (post-wave)
+8. ☐ Zero regressions on `npm test` baseline (verified pre-tag)
+

package/docs/diagrams/.gsd-t/.context-meter-state.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "timestamp": "2026-05-08T21:54:51.779Z",
+  "inputTokens": 568337,
+  "modelWindowSize": 200000,
+  "pct": 284.1685,
+  "threshold": "threshold",
+  "checkCount": 46,
+  "lastError": null
+}

package/docs/diagrams/.gsd-t/context-meter.log

@@ -0,0 +1,9 @@
+2026-05-08T16:23:08.224Z INFO measure tokens=69123 pct=34.6 band=normal
+2026-05-08T16:23:17.818Z INFO measure tokens=70098 pct=35.0 band=normal
+2026-05-08T21:51:23.165Z INFO measure tokens=265016 pct=132.5 band=threshold
+2026-05-08T21:51:54.256Z INFO measure tokens=291845 pct=145.9 band=threshold
+2026-05-08T21:52:36.042Z INFO measure tokens=294072 pct=147.0 band=threshold
+2026-05-08T21:53:30.736Z INFO measure tokens=436660 pct=218.3 band=threshold
+2026-05-08T21:54:10.654Z INFO measure tokens=490907 pct=245.5 band=threshold
+2026-05-08T21:54:31.984Z INFO measure tokens=567731 pct=283.9 band=threshold
+2026-05-08T21:54:51.784Z INFO measure tokens=568337 pct=284.2 band=threshold

package/docs/diagrams/.gsd-t/events/2026-05-08.jsonl

@@ -0,0 +1,45 @@
+{"ts":"2026-05-08T16:22:57.175Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":"msg_01KgFLkew5bD72zsCcM2u1DU","tool_use_id":"toolu_01JZsXT1GVJNkSZfgy54LvBX"}
+{"ts":"2026-05-08T16:23:03.120Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01Hvdv46b4GehZQFnkRUQXLn"}
+{"ts":"2026-05-08T16:23:06.143Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01MaHk587ncdH94J8qqymQaB"}
+{"ts":"2026-05-08T16:23:08.086Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01HxkJiLm6pyCUNrs7CSwMTD"}
+{"ts":"2026-05-08T16:23:10.446Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01MKZyiUqALKNJpt6ki9K9MM"}
+{"ts":"2026-05-08T16:23:12.462Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01LtLjC6PWbpWKy4L6nuqvqx"}
+{"ts":"2026-05-08T16:23:13.947Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01MPq57PVdjMxG9hw4sdeK1j"}
+{"ts":"2026-05-08T16:23:17.653Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01GrQbXpFziFvavDG6W9HY86"}
+{"ts":"2026-05-08T16:23:17.660Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01UjVxGmEYauKEbfcH8qPWmY"}
+{"ts":"2026-05-08T16:23:22.475Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_012sk837YCss5KVssn2hAivZ"}
+{"ts":"2026-05-08T16:23:22.850Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_012FBXytscHWfMD5ykXsYPrZ"}
+{"ts":"2026-05-08T16:23:23.248Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_014ZnZ4yuL2JxMfsVWHGQbm2"}
+{"ts":"2026-05-08T21:50:49.031Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01Y8haTfjqq6yoXBEoAYqiNT","tool_use_id":"toolu_01VDcaxyrmoVxijB1Wxo3p6x"}
+{"ts":"2026-05-08T21:51:23.028Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01QqkKceGoNHtYo3AnMBoCzA","tool_use_id":"toolu_017C8N385vpB6ZSTpy8J5sY1"}
+{"ts":"2026-05-08T21:51:26.871Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":"msg_01DgEh9ZfbYFniLPzsGDpUYs","tool_use_id":"toolu_01Tb2x2jCiY2g3Dg2tBdzNYB"}
+{"ts":"2026-05-08T21:51:33.761Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01Nf7eNsPadsxJ73qivr6tmg"}
+{"ts":"2026-05-08T21:51:40.484Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01UjDmgBSactSVEnRfJpLKR4","tool_use_id":"toolu_018FUKZcdL33f7WwoFDCK8Qk"}
+{"ts":"2026-05-08T21:51:43.587Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":null,"tool_use_id":"toolu_01FormMZJXS3rKerWkJDs6SF"}
+{"ts":"2026-05-08T21:51:54.106Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_018zpujsk8CUh65F6EDMSNna","tool_use_id":"toolu_01QX8oKRQ9jqYTdRZ3tu855s"}
+{"ts":"2026-05-08T21:51:59.622Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01V1JeoSEeLKrmVHY4Dyhsms","tool_use_id":"toolu_01B6rn6dYWcPzG8mfyUYXuKB"}
+{"ts":"2026-05-08T21:52:05.836Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01HHYra8n2foLZtCLDfbH5KW","tool_use_id":"toolu_01AFenJJBm4XauyqeaZEYdV9"}
+{"ts":"2026-05-08T21:52:11.370Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":null,"tool_use_id":"toolu_01XqiCs9FUjbD3KD1jC2iwCg"}
+{"ts":"2026-05-08T21:52:32.335Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01GfawRzpNVLovF8KWUvJQ5V","tool_use_id":"toolu_01UXvV5ZJKcVoUyeWM1iphxx"}
+{"ts":"2026-05-08T21:52:35.889Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":"msg_01T2TNxMmqrqaM9kQ2QGvB8C","tool_use_id":"toolu_0146DD86PuPkHr732jeCGJGz"}
+{"ts":"2026-05-08T21:52:42.989Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01KaunG5UmE7DKSS959cWsch"}
+{"ts":"2026-05-08T21:52:43.290Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_019HkxtywX4bFiKGyBDYsBMf"}
+{"ts":"2026-05-08T21:53:02.207Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01Pihjb1Hd98wfC5JAiAH3RG","tool_use_id":"toolu_01QpAsRhXR27xHDp4cNy2M1D"}
+{"ts":"2026-05-08T21:53:24.553Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01QoJZB1izEQDeemwLwP6YAo","tool_use_id":"toolu_01GCadE9ZAU5UTe8nZ7PwGE3"}
+{"ts":"2026-05-08T21:53:30.588Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01HcybQmgWUHJXFCL7vmh1H9"}
+{"ts":"2026-05-08T21:53:30.779Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01McfJ6SK8m2JR68K2DnJGeh"}
+{"ts":"2026-05-08T21:53:40.135Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":"msg_01DaAphVxVzm7RdtrPzgP7Gh","tool_use_id":"toolu_01Fy7xusPQkET8i5eaZy2tS8"}
+{"ts":"2026-05-08T21:54:05.418Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Bash","outcome":null,"turn_id":"msg_01SHncXzFGJupXcmr3QAvuPq","tool_use_id":"toolu_01Uq7YDhKMxYHDLg5Bha4kbP"}
+{"ts":"2026-05-08T21:54:10.319Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01DV8yuRJfpaXjaK9QBgBSpC"}
+{"ts":"2026-05-08T21:54:10.515Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":"msg_01TGkjdHKBYViFmXE3sJuAS9","tool_use_id":"toolu_015F7ZhupoVM1oKFdk4T8Cqc"}
+{"ts":"2026-05-08T21:54:16.813Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01QmKB2q8LmDn5PqjGuzEvw7"}
+{"ts":"2026-05-08T21:54:17.340Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":"msg_01GzETBwtHmptRsE9y5DnvKA","tool_use_id":"toolu_01DRogBZb7aauMMH6kWsFpxF"}
+{"ts":"2026-05-08T21:54:24.260Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Read","outcome":null,"turn_id":null,"tool_use_id":"toolu_01LATgyuNcJ9UzyyYaXsaZiV"}
+{"ts":"2026-05-08T21:54:30.692Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01PmNNUjJ79zaTvZg9HhjeD6"}
+{"ts":"2026-05-08T21:54:31.834Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01RXuaP5jG8csNCFZgRGm22S"}
+{"ts":"2026-05-08T21:54:33.092Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_0118aoercCMNRMc2CNbqWrCC"}
+{"ts":"2026-05-08T21:54:34.509Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01CgiEk9wt31j2egkMb3yQmt"}
+{"ts":"2026-05-08T21:54:35.520Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_0116wxRw4dKvzavucWrvBMAD"}
+{"ts":"2026-05-08T21:54:36.605Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01HfkCjA2aTADjPa4pGcMb3T"}
+{"ts":"2026-05-08T21:54:51.623Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_01HzKm1nAKaTouMc38yHVYrQ"}
+{"ts":"2026-05-08T21:54:58.071Z","command":null,"phase":null,"trace_id":null,"event_type":"tool_call","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"Edit","outcome":null,"turn_id":null,"tool_use_id":"toolu_016Fg48FxTXPwVcAQzXrzHfu"}

package/docs/diagrams/.gsd-t/events/2026-05-09.jsonl

@@ -0,0 +1 @@
+{"ts":"2026-05-09T13:51:36.482Z","command":null,"phase":null,"trace_id":null,"event_type":"session_end","agent_id":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","parent_agent_id":null,"reasoning":"other","outcome":null}

package/docs/diagrams/.gsd-t/heartbeat-cd9e7f59-ba5b-406a-9ed6-16762f039e81.jsonl

@@ -0,0 +1,48 @@
+{"ts":"2026-05-08T16:22:57.174Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"01-top-level-map.png"}}
+{"ts":"2026-05-08T16:23:03.119Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T16:23:06.142Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T16:23:08.085Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T16:23:10.445Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T16:23:12.461Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T16:23:13.946Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T16:23:17.652Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"03-wave-mode.png"}}
+{"ts":"2026-05-08T16:23:17.659Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"02-milestone-lifecycle.png"}}
+{"ts":"2026-05-08T16:23:22.474Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"04-design-to-code.png"}}
+{"ts":"2026-05-08T16:23:22.849Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"05-backlog.png"}}
+{"ts":"2026-05-08T16:23:23.247Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"06-automation-utilities.png"}}
+{"ts":"2026-05-08T16:23:34.870Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"session_stop"}
+{"ts":"2026-05-08T21:50:49.029Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"cd /Users/david/projects/GSD-T/docs/diagrams && for f in 01-top-level-map.d2 02-milestone-lifecycle.d2 03-wave-mode.d2 04-design-to-code.d2 05-backlog","desc":"Render all 6 D2 diagrams to SVG in parallel"}}
+{"ts":"2026-05-08T21:51:23.027Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"for f in *.svg; do\n  base=\"${f%.svg}\"\n  qlmanage -t -s 2400 -o . \"$f\" 2>&1 | tail -1\ndone\necho \"---\"\n# qlmanage outputs as ${base}.svg.png — rename to","desc":"Convert SVGs to PNGs using macOS qlmanage at 2400px width"}}
+{"ts":"2026-05-08T21:51:26.870Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"01-top-level-map-d2.png"}}
+{"ts":"2026-05-08T21:51:33.760Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"_theme.d2"}}
+{"ts":"2026-05-08T21:51:40.483Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"for f in 01-top-level-map.d2 02-milestone-lifecycle.d2 03-wave-mode.d2 04-design-to-code.d2 05-backlog.d2 06-automation-utilities.d2; do\n  base=\"${f%.","desc":"Re-render with light theme 0 and regenerate PNGs"}}
+{"ts":"2026-05-08T21:51:43.586Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"d2 --help 2>&1 | head -60","desc":"Check d2 command flags"}}
+{"ts":"2026-05-08T21:51:54.104Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"for f in 01-top-level-map.d2 02-milestone-lifecycle.d2 03-wave-mode.d2 04-design-to-code.d2 05-backlog.d2 06-automation-utilities.d2; do\n  base=\"${f%.","desc":"Re-render light-theme SVGs and PNGs"}}
+{"ts":"2026-05-08T21:51:59.621Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"rm -f *-d2.png *.svg.png\nfor f in *.svg; do\n  qlmanage -t -s 2400 -o . \"$f\" 2>&1 | grep -v \"Testing\\|Done\"\ndone\nls *.svg.png 2>/dev/null\nfor f in *.sv","desc":"Force fresh PNG generation from light SVGs"}}
+{"ts":"2026-05-08T21:52:05.835Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"cd /Users/david/projects/GSD-T/docs/diagrams\n# Clear qlmanage cache\nqlmanage -r cache 2>&1 | tail -2\nrm -f *-d2.png\n# Generate freshly\nfor f in *.svg;","desc":"Clear quicklook cache and regenerate PNGs from updated SVGs"}}
+{"ts":"2026-05-08T21:52:11.369Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"cd /Users/david/projects/GSD-T/docs/diagrams\n# Sanity check: the SVG itself should now use light theme. Inspect the first one.\nhead -1 01-top-level-ma","desc":"Verify SVG uses light theme colors"}}
+{"ts":"2026-05-08T21:52:32.334Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"cd /Users/david/projects/GSD-T/docs/diagrams\n# Use Chrome headless with file:// URLs to convert SVG → PNG\nCHROME=$(ls \"/Applications/Google Chrome.app","desc":"Convert SVG to PNG using headless Chrome (clean cache, fresh output)"}}
+{"ts":"2026-05-08T21:52:35.889Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"01-top-level-map-d2.png"}}
+{"ts":"2026-05-08T21:52:42.988Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"02-milestone-lifecycle-d2.png"}}
+{"ts":"2026-05-08T21:52:43.289Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"03-wave-mode-d2.png"}}
+{"ts":"2026-05-08T21:53:02.202Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"cd /Users/david/projects/GSD-T/docs/diagrams\n# Remove the markdown title block from each diagram (lines starting with \"title:\" through the closing lin","desc":"Strip in-diagram titles and re-render SVGs"}}
+{"ts":"2026-05-08T21:53:24.552Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"cd /Users/david/projects/GSD-T/docs/diagrams\nCHROME=\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"\nrm -f *-d2.png\n\nfor f in *.svg; do\n","desc":"Render PNGs at correct aspect ratio for each SVG"}}
+{"ts":"2026-05-08T21:53:30.587Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"02-milestone-lifecycle-d2.png"}}
+{"ts":"2026-05-08T21:53:30.772Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"03-wave-mode-d2.png"}}
+{"ts":"2026-05-08T21:53:40.134Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"04-design-to-code-d2.png"}}
+{"ts":"2026-05-08T21:54:05.417Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Bash","agent_id":null,"data":{"cmd":"cd /Users/david/projects/GSD-T/docs/diagrams\nCHROME=\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"\nrm -f *-d2.png\n\n# Render each at 2x","desc":"Render PNGs at 2x native viewBox size"}}
+{"ts":"2026-05-08T21:54:10.319Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"06-automation-utilities-d2.png"}}
+{"ts":"2026-05-08T21:54:10.514Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"01-top-level-map-d2.png"}}
+{"ts":"2026-05-08T21:54:16.812Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"04-design-to-code-d2.png"}}
+{"ts":"2026-05-08T21:54:17.339Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"05-backlog-d2.png"}}
+{"ts":"2026-05-08T21:54:24.259Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Read","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:30.691Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:31.833Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:33.091Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:34.508Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:35.519Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:36.604Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:51.622Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/docs/workflow-diagram.md"}}
+{"ts":"2026-05-08T21:54:58.070Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"tool","tool":"Edit","agent_id":null,"data":{"file":"~/projects/GSD-T/.gsd-t/progress.md"}}
+{"ts":"2026-05-08T21:55:09.703Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"session_stop"}
+{"ts":"2026-05-09T13:51:36.481Z","sid":"cd9e7f59-ba5b-406a-9ed6-16762f039e81","evt":"session_end","data":{"reason":"other"}}

package/docs/diagrams/01-top-level-map.d2

@@ -0,0 +1,77 @@
+...@_theme.d2
+
+
+user: User input { class: endpoint }
+
+router: "/gsd\nsmart router" { class: router }
+
+user -> router: types
+
+continuation: continue last command { class: cmd }
+talk: dialog only\n(no spawn) { class: subagent }
+entry: Entry kind? { class: decision }
+
+router -> continuation: continuation
+router -> talk: conversational
+router -> entry: workflow
+
+onboard: {
+  class: group
+  label: Onboarding
+  iss: "/gsd-t-init-scan-setup" { class: cmd }
+  init: "/gsd-t-init" { class: cmd }
+  scan: "/gsd-t-scan" { class: cmd }
+  setup: "/gsd-t-setup" { class: cmd }
+  iss -> init -> scan -> setup
+}
+
+design: {
+  class: group
+  label: Design pipeline
+  dd: "/gsd-t-design-decompose" { class: cmd }
+  db: "/gsd-t-design-build" { class: cmd }
+  dr: "/gsd-t-design-review" { class: cmd }
+  da: "/gsd-t-design-audit" { class: cmd }
+  dd -> db -> dr
+  db -> da: optional { style.stroke-dash: 3 }
+}
+
+backlog: {
+  class: group
+  label: Backlog
+  badd: "/gsd-t-backlog-add" { class: cmd }
+  bpromo: "/gsd-t-backlog-promote" { class: cmd }
+  badd -> bpromo
+}
+
+proj: "/gsd-t-project" { class: cmd }
+feat: "/gsd-t-feature" { class: cmd }
+gap: "/gsd-t-gap-analysis" { class: cmd }
+quick: "/gsd-t-quick" { class: cmd }
+debug: "/gsd-t-debug" { class: cmd }
+stat: "/gsd-t-status" { class: cmd }
+
+mile: "/gsd-t-milestone" { class: cmd; style.bold: true }
+auto: Hands-off? { class: decision }
+wave: "/gsd-t-wave\n(full cycle)" { class: cmd; style.bold: true }
+part: "/gsd-t-partition" { class: cmd }
+
+entry -> proj: greenfield
+entry -> onboard.iss: onboard repo
+entry -> feat: new feature
+entry -> gap: spec vs code
+entry -> quick: small task
+entry -> debug: bug
+entry -> design.dd: design-to-code
+entry -> backlog.badd: capture idea
+entry -> stat: status
+
+proj -> mile
+feat -> mile
+gap -> mile: gaps found { style.stroke-dash: 3 }
+onboard.scan -> mile: techdebt { style.stroke-dash: 3 }
+backlog.bpromo -> mile
+
+mile -> auto
+auto -> wave: yes
+auto -> part: step-by-step

package/docs/diagrams/01-top-level-map.mmd

@@ -0,0 +1,48 @@
+flowchart TD
+    USER([User input])
+
+    USER --> ROUTER{{"/gsd<br/>(smart router)"}}
+
+    ROUTER -->|"plain text<br/>(auto-route hook)"| ROUTER
+    ROUTER -->|continuation| RESUME["/gsd-t-resume"]
+    ROUTER -->|conversational| TALK["dialog-only<br/>no spawn"]
+    ROUTER -->|workflow| ENTRY{Entry kind?}
+
+    ENTRY -->|new greenfield| PROJ["/gsd-t-project"]
+    ENTRY -->|existing repo onboard| ISS["/gsd-t-init-scan-setup"]
+    ENTRY -->|new feature| FEAT["/gsd-t-feature"]
+    ENTRY -->|spec vs code| GAP["/gsd-t-gap-analysis"]
+    ENTRY -->|small task| QUICK["/gsd-t-quick"]
+    ENTRY -->|bug| DEBUG["/gsd-t-debug"]
+    ENTRY -->|design-to-code| DD["/gsd-t-design-decompose"]
+    ENTRY -->|backlog idea| BADD["/gsd-t-backlog-add"]
+    ENTRY -->|status check| STAT["/gsd-t-status"]
+
+    ISS --> INIT["/gsd-t-init"]
+    INIT --> SCAN["/gsd-t-scan"]
+    SCAN --> SETUP["/gsd-t-setup"]
+    SCAN -.->|techdebt found| PROMO["/gsd-t-promote-debt"]
+
+    PROJ --> MILE["/gsd-t-milestone"]
+    FEAT --> MILE
+    GAP -.->|gaps found| MILE
+    PROMO --> MILE
+    BADD --> BPROMO["/gsd-t-backlog-promote"]
+    BPROMO --> MILE
+    BPROMO -.->|small| QUICK
+    BPROMO -.->|bug| DEBUG
+
+    MILE --> WAVE_OR_MANUAL{Auto or manual?}
+    WAVE_OR_MANUAL -->|hands-off| WAVE["/gsd-t-wave<br/>(full cycle)"]
+    WAVE_OR_MANUAL -->|step-by-step| PART["/gsd-t-partition"]
+
+    DD --> DB["/gsd-t-design-build"]
+    DB --> DR["/gsd-t-design-review"]
+    DB -.-> DA["/gsd-t-design-audit"]
+
+    classDef entry fill:#e1f5ff,stroke:#0288d1
+    classDef milestone fill:#fff4e1,stroke:#f57c00
+    classDef router fill:#f3e5f5,stroke:#7b1fa2
+    class PROJ,ISS,FEAT,GAP,QUICK,DEBUG,DD,BADD,STAT entry
+    class MILE,WAVE,PART milestone
+    class ROUTER,ENTRY,WAVE_OR_MANUAL router