@tekyzinc/gsd-t 4.0.27 → 4.0.28

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [4.0.28] - 2026-06-04 (M80 Scan Document-Phase Fixes - patch)
+
+### Fixed - scan workflow crashed at the document phase, then shipped a truncated plain-English doc
+
+Three bugs in the scan workflow's late (document) stage, all surfaced by running the deep scan on the GSD-T repo itself (5,647 files, 181 verified findings). Each runs AFTER ~220 finder/verify/synthesis agents, so a late-stage bug wastes the whole expensive run.
+
+1. **`ReferenceError: findingsJson is not defined`** crashed the entire workflow at the Document phase. The variable was consumed by `baseCtx` (the context every document agent reads) but never declared. Fixed by defining it as a compact JSON projection of the verified findings.
+2. **Plain-English companion shipped truncated** (65 of 181 entries — Critical+High + a 2-item tail; Medium/Low silently dropped). The prior design fanned each ~30KB chunk to a separate haiku agent via heredoc-append, which reported "OK" without faithfully writing the blob. Rewritten to a SINGLE owning agent that writes all chunks sequentially and self-verifies the on-disk `### TD-` count, with an independent second-agent count check; completeness is surfaced in the return (`plainEnglishComplete`).
+3. **`parseComponents` returned zero domains** from the freshly regenerated `scan/architecture.md`. The document agent writes domains as a `## Components / Domains` section of `### N. Title` subsections (and Structure as a markdown table), but the parser only knew the legacy `## Component Inventory` table + bare-line Structure format — so the renderer's domain list came up empty.
+
+- `templates/workflows/gsd-t-scan.workflow.js`: define `findingsJson`; single self-verifying plain-English writer; surface `plainEnglishComplete`/`plainEnglishEntries`/`plainEnglishExpected`.
+- `bin/scan-data-collector.js`: `parseComponents` now also parses `## Components / Domains` `### N.` subsections and Structure markdown tables.
+- `test/m80-scan-document-phase-refs.test.js`: regression tests (baseCtx refs declared, findingsJson declared-before-use, single-owner PE write guard, domain parsing of the new format). Mutation-tested against a workflow copy with the bug reintroduced.
+
+All three fixes proven in the real Workflow sandbox via resume (cached finder/verify/synthesis agents, live document phase): final run returned `plainEnglishComplete:true` (181/181), 17 domains parsed.
+
 ## [4.0.27] - 2026-06-04 (M79 Diagram Quality - patch)
 
 ### Fixed - scan-report diagrams were generic boilerplate, clashed with the dark theme, and one was actively misleading

package/README.md

@@ -1,27 +1,25 @@
 # GSD-T: Contract-Driven Development for Claude Code
 
-A methodology for reliable, parallelizable development using Claude Code with optional Agent Teams support.
+**v4.0.27** - A methodology for reliable, parallelizable development using Claude Code with optional Agent Teams support.
 
 **Eliminates context rot** — task-level fresh dispatch (one subagent per task, ~10-20% context each) means compaction never triggers.
 **Compaction-proof debug loops** — `gsd-t headless --debug-loop` runs test-fix-retest cycles as separate `claude -p` sessions. A JSONL debug ledger persists all hypothesis/fix/learning history across fresh sessions. Anti-repetition preamble injection prevents retrying failed hypotheses. Escalation tiers (sonnet → opus → human) and a hard iteration ceiling enforced externally.
-**Safe parallel execution** — worktree isolation gives each domain agent its own filesystem; sequential atomic merges prevent conflicts.
+**Safe parallel execution** — file-disjointness gates (`gsd-t-file-disjointness.cjs`) verify no two concurrent domain workers claim the same write targets before spawning; sequential atomic merges prevent conflicts.
 **Maintains test coverage** — automatically keeps tests aligned with code changes.
 **Catches downstream effects** — analyzes impact before changes break things.
 **Protects existing work** — destructive action guard prevents schema drops, architecture replacements, and data loss without explicit approval.
 **Visualizes execution in real time** — live browser dashboard renders agent hierarchy, tool activity, and phase progression from the event stream.
-**Generates visual scan reports** — every `/gsd-t-scan` produces a self-contained HTML report with 6 live architectural diagrams, a tech debt register, and domain health scores; optional DOCX/PDF export via `--export docx|pdf`.
+**Generates visual scan reports** — every `/gsd-t-scan` runs a volume-scaled native Workflow (M66+): a volume-probe stage counts files/routes/tables/components and derives a slice list (1-40+ slices depending on codebase size), parallel deep-finder agents enumerate every module, a synthesis stage merges findings into a prioritized tech-debt register, and a deterministic render stage produces a self-contained HTML report with architectural diagrams, domain health scores, and living-doc cross-population. Optional DOCX/PDF export via `--export docx|pdf`.
 **Self-learning rule engine** — declarative rules in rules.jsonl detect failure patterns from task metrics. Candidate patches progress through a 5-stage lifecycle (candidate, applied, measured, promoted, graduated) with >55% improvement gates before becoming permanent methodology artifacts.
 **Cross-project learning** — proven rules propagate to `~/.claude/metrics/` and sync across all registered projects via `update-all`. Rules validated in 3+ projects become universal; 5+ projects qualify for npm distribution. Cross-project signal comparison and global ELO rankings available via `gsd-t-metrics --cross-project` and `gsd-t-status`.
-**Stack Rules Engine** — auto-detects project tech stack (React, TypeScript, Node API, Python, Go, Rust) from manifest files and injects mandatory best-practice rules into subagent prompts at execute-time. Universal security rules always apply; stack-specific rules layer on top. Includes **design-to-code** rules for pixel-perfect frontend implementation from Figma, screenshots, or design images — with Figma MCP integration, design token extraction, stack capability evaluation, and mandatory visual verification: every screen is rendered in a real browser, screenshotted at mobile/tablet/desktop, and compared pixel-by-pixel against the Figma design. Auto-bootstraps during partition when design references are detected. Extensible: drop a `.md` file in `templates/stacks/` to add a new stack.
-**External Task Orchestrator + Streaming Watcher UI (M40, v3.14.10)** — JS orchestrator drives `claude -p` one task per spawn: short-lived, fresh context, architecturally compaction-free. Benchmarks 0.72× wall-clock vs in-session on 20-task/3-wave workloads. Paired with a zero-Claude-cost local streaming UI at `127.0.0.1:7842` that renders all workers' stream-json output as a continuous claude.ai-style feed — task/wave banners, duration + usage chips, token corner bar, localStorage filters, replay via `WS /feed?from=N`. Recovery: `--resume` reconciles interrupted runs using commit + progress.md evidence; ambiguous tasks (commit without progress entry) are flagged for operator triage, never silently claimed done. CLI: `gsd-t orchestrate`, `gsd-t benchmark-orchestrator`, `gsd-t stream-feed`. Contracts: `stream-json-sink-contract.md` v1.1.0, `wave-join-contract.md`, `completion-signal-contract.md`, `metrics-schema-contract.md`.
-**Always-Headless Spawn (M43 D4, v3.16.x+) — Channel Separation** — every GSD-T command spawns detached, unconditionally. No `--watch`, no `--in-session`, no `--headless` opt-in, no context-meter threshold that reroutes. The dialog channel is reserved for human↔Claude conversation; every workflow turn is a detached headless child. Interactive session shows a launch banner + live-transcript URL + event-stream path, then exits — results surface via the read-back banner on the user's next message. Detached workers emit JSONL events to `.gsd-t/events/YYYY-MM-DD.jsonl` at every phase boundary — shared by dashboard and (historically) the watch command. The only in-session surface is the `/gsd` router (for dialog-only exploratory turns). See `.gsd-t/contracts/headless-default-contract.md` v2.0.0 and `unattended-event-stream-contract.md` v1.0.0.
-**Live Transcript as Primary Surface (M43 D6, v3.16.13 — extended in M47, v3.21.10)** — every detached spawn prints a one-line banner (`▶ Live transcript: http://127.0.0.1:{port}/transcript/{id}`) pointing at a browser viewer that SSE-streams the child's stdout and renders a collapsible "Tool Cost" sidebar panel showing per-tool attributed tokens and cost (sourced from `/transcript/:id/tool-cost`, which proxies to the M43 D2 tool-attribution library). The dashboard server auto-starts (`scripts/gsd-t-dashboard-autostart.cjs`) idempotently on each spawn — a port probe backs off when a server is already running, otherwise a fork-detach writes `.gsd-t/.dashboard.pid`. Port is project-scoped via `projectScopedDefaultPort(projectDir)` so multi-project workflows don't clobber each other.
-**Rigorous User-Journey Coverage + Anti-Drift Test Quality (M52, v3.23.10)** — closes the M48→M51 drift pattern where each test round only caught previously-named bug shapes. Two-part fix: (a) `bin/journey-coverage.cjs` regex listener detector + `gsd-t check-coverage` CLI + `scripts/hooks/pre-commit-journey-coverage` commit gate (auto-installed on `gsd-t init`) — blocks viewer-source commits when uncovered listeners exist; (b) 12 inaugural journey specs in `e2e/journeys/` covering all 20 detected viewer listeners with functional assertions (zero `toBeVisible`-only tests). Red Team GRUDGING PASS: 5/5 broken viewer patches caught; hook block-then-unblock exercised. Suite: 2195/2195 unit + 35/35 E2E pass.
-**Universal Playwright Bootstrap + Deterministic UI Enforcement (M50, v3.22.10)** — converts the prose-only "Playwright Readiness Guard" into three executable enforcement layers so agents cannot skip UI tests. Layer 1: `bin/playwright-bootstrap.cjs` + `bin/ui-detection.cjs` wired into `init`/`update-all`/`doctor`/new `gsd-t setup-playwright [path]` subcommand — idempotent installer detects package manager, installs `@playwright/test` + chromium, writes config from a contract-locked template, scaffolds `e2e/`. Layer 2: `bin/headless-auto-spawn.cjs::autoSpawnHeadless()` auto-installs before any of 9 whitelisted testing/UI commands when `hasUI && !hasPlaywright`; install failure → `mode: 'blocked-needs-human'` exit-4. Layer 3: `scripts/hooks/pre-commit-playwright-gate` (opt-in via `gsd-t doctor --install-hooks`) reads `.gsd-t/.last-playwright-pass` and blocks viewer-source commits when staged files are newer than the last playwright test pass. Also ships the M47/M48/M49 E2E viewer specs (`e2e/viewer/title`, `timestamps`, `chat-bubbles`, `dual-pane`, `lazy-dashboard`). 62 new unit tests; E2E 8/9 pass.
-**Focused Visualizer Redesign (M47, v3.21.10)** — `/transcripts` opens directly to a dual-pane focused view: the **top pane** auto-streams the orchestrator's main in-session conversation (zero clicks — fetched via new `GET /api/main-session`), and the **bottom pane** streams whichever spawn the user clicks. A keyboard- and mouse-resizable splitter sits between them, with position persisted in `sessionStorage` (along with selection, completed-section toggle, and right-rail collapsed state). The left rail splits into three sections — `★ Main Session`, `Live Spawns`, and `Completed` (last 100 spawns, newest first, status-badged, collapsible). When a spawn transitions running → completed it moves rail sections live without a full reload, and stays selected if focused. The right rail (Spawn Plan / Parallelism / Tool Cost) is preserved under a new collapsible toggle. Bookmarks to `/transcript/:spawnId` continue to land that spawn pre-selected in the bottom pane. Contract: `dashboard-server-contract.md` v1.3.0 (additive — `status: 'active' \| 'completed'` field on in-session entries, derived from a 30s mtime window; `/api/main-session` endpoint with path-traversal guard + `Cache-Control: no-store`).
-- **Surgical model selection** — `bin/model-selector.js` assigns haiku/sonnet/opus per phase via a declarative rules table; `/advisor` escalation path with convention-based fallback.
-- **Per-spawn token telemetry** — `.gsd-t/token-metrics.jsonl` records one 18-field row per Task subagent spawn.
-**Context Meter (M34/M38/M43 D4) — Observational Only** — PostToolUse hook writes `.gsd-t/.context-meter-state.json` via local token estimation. Under M43 D4 (channel-separation inversion, `headless-default-contract.md` v2.0.0) the meter is OBSERVATIONAL ONLY: the pct is recorded into the token-log `Ctx%` column on the next spawn, but no threshold gates any routing decision — every command spawns detached regardless. The `context-meter-contract.md` single-band model is preserved for the value itself; it no longer drives in-flight pauses or spawn-time rerouting.
+**Stack Rules Engine** — auto-detects project tech stack from manifest files (`package.json`, `requirements.txt`, `pyproject.toml`, `go.mod`, `Cargo.toml`) and injects mandatory best-practice rules into subagent prompts at execute-time. 29 stack templates currently ship (`templates/stacks/`), covering React, TypeScript, Vue, Next.js, Node API, Python, FastAPI, Flutter, Tailwind, Playwright, Prisma, PostgreSQL, Supabase, Firebase, Neo4j, GraphQL, Redux, Zustand, Vite, Docker, GitHub Actions, LLM integrations, queues, REST API, and more. Universal `_security.md` and `_auth.md` rules always apply. Includes **design-to-code** rules for pixel-perfect frontend implementation from Figma, screenshots, or design images - with Figma MCP integration, design token extraction, stack capability evaluation, and mandatory visual verification. Auto-bootstraps during partition when design references are detected. Extensible: drop a `.md` file in `templates/stacks/` to add a new stack.
+**Native Workflow Orchestration (M61+)** — all major phases run as self-contained native Workflow scripts (`templates/workflows/`): execute, verify, wave, integrate, debug, quick, phase, and scan. The Workflow runtime owns spawning and context; no external orchestrator processes are needed for routine build/debug/deliver actions. Detached workers emit JSONL events to `.gsd-t/events/YYYY-MM-DD.jsonl` at every phase boundary, consumed by the real-time dashboard. The `/gsd` smart router handles plain-text messages via the auto-route hook.
+**Real-Time Agent Dashboard** — `gsd-t-stream-feed-server.js` serves a streaming UI at `127.0.0.1:7842` that renders all workers' stream-json output as a continuous feed with task/wave banners, duration + usage chips, token corner bar, localStorage filters, and replay via `WS /feed?from=N`. Dashboard auto-starts idempotently on each spawn (`scripts/gsd-t-dashboard-autostart.cjs`). Port is project-scoped via `projectScopedDefaultPort(projectDir)` so multi-project workflows do not clobber each other.
+**Rigorous User-Journey Coverage + Anti-Drift Test Quality** — `bin/journey-coverage.cjs` regex listener detector + `gsd-t check-coverage` CLI + `scripts/hooks/pre-commit-journey-coverage` commit gate blocks viewer-source commits when uncovered listeners exist. Journey specs in `e2e/journeys/` use functional assertions (zero `toBeVisible`-only tests) per the E2E Test Quality Standard in CLAUDE.md.
+**Universal Playwright Bootstrap + Deterministic UI Enforcement (M50)** — three executable enforcement layers: (1) `bin/playwright-bootstrap.cjs` + `bin/ui-detection.cjs` - idempotent installer detects package manager, installs `@playwright/test` + chromium, scaffolds `e2e/`; (2) Workflow runtime runs `playwright-bootstrap.cjs::installPlaywright()` before any E2E stage when `hasUI && !hasPlaywright`; install failure halts with `blocked-needs-human`; (3) `scripts/hooks/pre-commit-playwright-gate` (opt-in via `gsd-t doctor --install-hooks`) blocks viewer-source commits when staged files are newer than `.gsd-t/.last-playwright-pass`. The `gsd-t setup-playwright [path]` subcommand handles manual install.
+**Visualizer (`/gsd-t-visualize`)** — launches a real-time browser dashboard with dual-pane view: top pane streams the main session, bottom pane streams whichever spawn the user clicks. Left rail shows Live Spawns and Completed (last 100 spawns, status-badged, collapsible). Right rail shows Spawn Plan / Parallelism / Tool Cost. Powered by `gsd-t-stream-feed-server.js` + `gsd-t-dashboard.html`.
+**Surgical model selection** — `bin/model-selector.js` assigns haiku/sonnet/opus per phase via a declarative rules table; `/advisor` escalation path with convention-based fallback.
+**Token Telemetry** — `gsd-t-calibration-hook.js` records token usage per spawn to `.gsd-t/token-metrics.jsonl` (18-field rows). `gsd-t-token-aggregator.js` aggregates across tasks for the `/gsd-t-metrics` view. Use the native Claude Code `/context` command for live in-session context percentage.
 **Quality North Star** — projects define a `## Quality North Star` section in CLAUDE.md (1–3 sentences, e.g., "This is a published npm library. Every public API must be intuitive and backward-compatible."). `gsd-t-init` auto-detects preset (library/web-app/cli) from package.json signals; `gsd-t-setup` configures it for existing projects. Subagents read it as a quality lens; absent = silent skip (backward compatible).
 **Design Brief Artifact** — during partition, UI/frontend projects (React, Vue, Svelte, Flutter, Tailwind) automatically get `.gsd-t/contracts/design-brief.md` with color palette, typography, spacing system, component patterns, and tone/voice. Non-UI projects skip silently. User-customized briefs are preserved. Referenced in plan phase for visual consistency.
 **Design Verification Agent** — after QA passes on design-to-code projects, a dedicated verification agent opens a browser with both the built frontend AND the original design (Figma page, design image, or MCP screenshot) side-by-side for direct visual comparison. Produces a structured element-by-element comparison table (30+ rows) with specific design values vs. implementation values and MATCH/DEVIATION verdicts. An artifact gate enforces that the comparison table exists — missing it blocks completion. Separation of concerns: coding agents code, verification agents verify. Wired into execute (Step 5.25) and quick (Step 5.25). Only fires when `.gsd-t/contracts/design-contract.md` exists — non-design projects are unaffected.
@@ -37,7 +35,7 @@ A methodology for reliable, parallelizable development using Claude Code with op
 npx @tekyzinc/gsd-t install
 ```
 
-This installs 49 GSD-T commands + 5 utility commands (54 total) to `~/.claude/commands/` and the global CLAUDE.md to `~/.claude/CLAUDE.md`. Works on Windows, Mac, and Linux.
+This installs 46 GSD-T workflow commands + 5 utility commands (51 total) to `~/.claude/commands/` and the global CLAUDE.md to `~/.claude/CLAUDE.md`. Works on Windows, Mac, and Linux.
 
 ### Start Using It
 
@@ -84,7 +82,7 @@ GSD-T reads all state files and tells you exactly where you left off.
 ## CLI Commands
 
 ```bash
-npx @tekyzinc/gsd-t install        # Install commands + global CLAUDE.md
+npx @tekyzinc/gsd-t install        # Install commands + global CLAUDE.md (51 commands)
 npx @tekyzinc/gsd-t update         # Update global commands + CLAUDE.md
 npx @tekyzinc/gsd-t update-all     # Update globally + all registered project CLAUDE.md files
 npx @tekyzinc/gsd-t init [name]    # Scaffold GSD-T project (auto-registers)
@@ -93,6 +91,7 @@ npx @tekyzinc/gsd-t status         # Check installation + version
 npx @tekyzinc/gsd-t doctor         # Diagnose common issues
 npx @tekyzinc/gsd-t changelog      # Open changelog in the browser
 npx @tekyzinc/gsd-t uninstall      # Remove commands (keeps project files)
+npx @tekyzinc/gsd-t setup-playwright [path]  # Install Playwright + chromium for a project
 
 # Headless mode (CI/CD)
 gsd-t headless verify --json --timeout=1200  # Run verify non-interactively
@@ -184,7 +183,6 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 |---------|---------|------|
 | `/gsd-t-milestone` | Define new milestone | Manual |
 | `/gsd-t-partition` | Decompose into domains + contracts | In wave |
-| `/gsd-t-discuss` | Multi-perspective design exploration | In wave |
 | `/gsd-t-plan` | Create atomic task lists per domain (tasks auto-split to fit one context window) | In wave |
 | `/gsd-t-impact` | Analyze downstream effects | In wave |
 | `/gsd-t-execute` | Run tasks — task-level fresh dispatch, worktree isolation, adaptive replanning | In wave |
@@ -196,14 +194,6 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 | `/gsd-t-verify` | Run quality gates + goal-backward behavior verification | In wave |
 | `/gsd-t-complete-milestone` | Archive + git tag (goal-backward gate required) | In wave |
 
-### Overnight / Idle-Run Commands (slower than in-session — use only for unattended overnight or multi-hour idle runs)
-
-| Command | Purpose | Auto |
-|---------|---------|------|
-| `/gsd-t-unattended` | Launch detached supervisor for overnight/idle runs only | Manual |
-| `/gsd-t-unattended-watch` | Watch tick — fires every 270s via ScheduleWakeup, reports supervisor status | Auto |
-| `/gsd-t-unattended-stop` | Touch stop sentinel — supervisor halts after current worker finishes | Manual |
-
 ### Automation & Utilities
 
 | Command | Purpose | Auto |
@@ -243,6 +233,7 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 |---------|---------|------|
 | `/branch` | Create and switch to a new git branch | Manual |
 | `/checkin` | Auto-bump version, stage, commit, and push | Manual |
+| `/cpua` | Commit, Publish, Update All — bump version, publish to npm, propagate to all registered projects | Manual |
 | `/Claude-md` | Reload CLAUDE.md directives mid-session | Manual |
 | `/global-change` | Apply file changes across all registered GSD-T projects | Manual |
 
@@ -256,10 +247,9 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 | **Project/Feature/Scan** | Initialize work | Solo (team for large scans) |
 | **Milestone** | Define deliverable | Solo |
 | **Partition** | Decompose into domains + contracts | Solo |
-| **Discuss** | Explore design decisions | Both |
 | **Plan** | Create atomic task lists | Solo (always) |
 | **Impact** | Downstream effect analysis | Solo |
-| **Execute** | Build it — task-level parallelism via `gsd-t parallel --help` (M44 D2/D3); conditional on >1 gate-passing task, falls back to sequential silently | Both |
+| **Execute** | Build it - domain workers run in parallel (file-disjointness gated); Workflow: preflight → brief → disjointness → parallel workers → integrate → verify-gate | Both |
 | **Test-Sync** | Maintain test coverage | Solo |
 | **Integrate** | Wire domains together | Solo (always) |
 | **Verify** | Quality gates | Both |
@@ -338,104 +328,27 @@ your-project/
 
 ---
 
-## Overnight / Idle-Run Supervisor (M36 — v3.10.10+)
-
-> **Daytime work runs in-session.** This supervisor is provided for unattended overnight or multi-hour idle runs only — it is dramatically slower than in-session execution because every worker iteration pays cold-context startup cost (re-reads CLAUDE.md, progress.md, all domain files) before doing real work, then is bounded to a 270s cache-warm budget. Reach for it only when you genuinely cannot supervise the run.
-
-```bash
-# Launch from the CLI (detached OS process)
-gsd-t unattended --hours=24
-
-# Or from within Claude Code
-/gsd-t-unattended
-
-# Stop (graceful — supervisor halts after the current worker finishes)
-/gsd-t-unattended-stop
-```
-
-**How it works:**
-
-- `gsd-t unattended` spawns `bin/gsd-t-unattended.js` as a fully detached OS process. The supervisor runs `claude -p` workers in a relay — one worker per iteration — each in a fresh context window. State is written atomically to `.gsd-t/.unattended/state.json` between iterations.
-- `/gsd-t-unattended` does the same from inside Claude Code, then calls `ScheduleWakeup(270, '/gsd-t-unattended-watch')` to start an in-session watch loop that ticks every 270 seconds and prints progress.
-- If you run `/clear` + `/gsd-t-resume` during a live run, the resume command auto-detects the running supervisor and re-attaches the watch loop — no re-launch needed.
-- The supervisor halts automatically when: the milestone reaches COMPLETED status, the `--hours` wall-clock cap expires, `--max-iterations` is reached, safety rails detect a stall or unrecoverable error, or the stop sentinel is touched.
+## Unattended / Background Runs
 
-**Platform support:** macOS and Linux fully supported (including sleep-prevention via `caffeinate` on macOS). Windows is supported except sleep-prevention. See `docs/unattended-windows-caveats.md` for known Windows limitations.
+For zero-touch overnight or multi-hour runs, use the `/loop` skill with a GSD-T command, or the `/gsd-t-unattended` skill (via the Smart Router). State is written atomically to `.gsd-t/.unattended/state.json` between worker iterations.
 
-**Key flags:**
+The supervisor halts automatically when: the milestone reaches COMPLETED status, the wall-clock cap expires, `--max-iterations` is reached, safety rails detect a stall or unrecoverable error, or the stop sentinel is touched.
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--hours=N` | 24  |  Wall-clock cap |
-| `--max-iterations=N` | 200 | Iteration cap |
-| `--milestone=NAME` | (current) | Override active milestone |
-| `--dry-run` | false | Preflight only — no spawn |
-
-**State files** live under `.gsd-t/.unattended/`: `supervisor.pid`, `state.json`, `run.log`, `stop` (sentinel). Authoritative field definitions: `.gsd-t/contracts/unattended-supervisor-contract.md` v1.0.0.
+**State files** live under `.gsd-t/.unattended/`: `supervisor.pid`, `state.json`, `run.log`, `stop` (sentinel).
 
 ---
 
-## Context Meter Setup (M34 — v2.75.10+)
-
-The Context Meter replaces the v2.74.12 task-counter proxy with real context-window measurement via the Anthropic `count_tokens` API. This is the authoritative signal for session-stop gates in `gsd-t-execute`, `gsd-t-wave`, `gsd-t-quick`, `gsd-t-integrate`, and `gsd-t-debug`.
-
-### 1. Set your API key
-
-Create a key at [console.anthropic.com](https://console.anthropic.com) (free tier is sufficient — `count_tokens` calls are inexpensive) and export it in your shell profile:
-
-```bash
-export ANTHROPIC_API_KEY="sk-ant-..."
-```
-
-The env var name is configurable in `.gsd-t/context-meter-config.json` (default: `ANTHROPIC_API_KEY`).
-
-### 2. Verify with `gsd-t doctor`
-
-```bash
-npx @tekyzinc/gsd-t doctor
-```
-
-Doctor checks:
-- `ANTHROPIC_API_KEY` is set (RED if missing)
-- PostToolUse hook is registered in `~/.claude/settings.json`
-- `scripts/gsd-t-context-meter.js` exists in the project
-- `.gsd-t/context-meter-config.json` parses cleanly
-- A live `count_tokens` dry-run succeeds (RED on 401/403/network failure)
-
-### 3. Adjust thresholds (optional)
-
-Edit `.gsd-t/context-meter-config.json`:
+## Context and Token Monitoring
 
-```json
-{
-  "enabled": true,
-  "apiKeyEnvVar": "ANTHROPIC_API_KEY",
-  "modelWindowSize": 200000,
-  "thresholdPct": 85,
-  "checkFrequency": 1
-}
-```
-
-- `modelWindowSize` — total context window (200K for Opus/Sonnet)
-- `thresholdPct` — percentage at which the orchestrator halts (85% = stop band; 70% = warn band — cue for explicit pause/resume; no silent degradation)
-- `checkFrequency` — run `count_tokens` every N tool calls (1 = every call; higher = cheaper + slightly delayed signal)
-
-### 4. Live status
+GSD-T uses the Claude Code native `/context` command for live in-session context usage. The `ANTHROPIC_API_KEY` env var is used for token count diagnostics and measurement only - not for inference (inference runs via Claude Max subscription).
 
 ```bash
-npx @tekyzinc/gsd-t status
+export ANTHROPIC_API_KEY="sk-ant-..."  # for count_tokens diagnostics
 ```
 
-Displays a Context line with `{pct}% of {window} tokens ({band}) — last check {time ago}`. Missing state file shows `N/A (meter hook not run this session)`.
-
-### Upgrading from pre-M34
+The `gsd-t-calibration-hook.js` hook auto-detects model window size (1M for Opus 4.7/4.8, Sonnet 4.5+) and records token usage to `.gsd-t/token-metrics.jsonl` (one 18-field row per spawn). The `gsd-t-token-aggregator.js` script aggregates JSONL data for the `/gsd-t-metrics` view.
 
-Running `gsd-t update-all` handles the migration automatically:
-- Copies the new hook script, runtime files, config template, and `context-meter-config.cjs` loader into every registered project
-- Runs a one-time task-counter retirement — deletes `bin/task-counter.cjs`, `.gsd-t/task-counter-config.json`, `.gsd-t/.task-counter-state.json`, and the `.gsd-t/.task-counter` state file
-- Writes `.gsd-t/.task-counter-retired-v1` marker (subsequent runs are no-op)
-
-After upgrading, **you must set `ANTHROPIC_API_KEY`** — `gsd-t doctor` will fail otherwise.
+If `.gsd-t/context-meter-config.json` exists, you can adjust `thresholdPct` and `modelWindowSize` (use `1000000` for current 1M-window models). Run `gsd-t doctor` to verify configuration.
 
 ---
 
@@ -472,45 +385,81 @@ Verify with: `/gsd-t-help`
 ```
 get-stuff-done-teams/
 ├── README.md
-├── package.json
+├── package.json                       # @tekyzinc/gsd-t v4.0.27
 ├── LICENSE
-├── bin/
-│   └── gsd-t.js                       # CLI installer
-├── commands/                          # 56 slash commands
-│   ├── gsd-t-*.md                     # 50 GSD-T workflow commands
-│   ├── gsd.md                         # GSD-T smart router
+├── bin/                               # CLI entry + orchestrators + support modules (52 modules)
+│   ├── gsd-t.js                       # CLI installer + all subcommands
+│   ├── orchestrator.js                # Design orchestrator
+│   ├── cli-preflight.cjs              # Preflight gate (branch, ports, contracts)
+│   ├── gsd-t-verify-gate.cjs          # Two-track verify gate (preflight + parallel CLIs)
+│   ├── gsd-t-parallel.cjs             # Task-level parallelism + mode-aware gating
+│   ├── gsd-t-task-graph.cjs           # Dependency graph + topological sort
+│   ├── gsd-t-file-disjointness.cjs    # Pre-spawn file overlap gate
+│   ├── gsd-t-context-brief.cjs        # <=2500-token JSON snapshot for worker spawns
+│   ├── gsd-t-context-brief-kinds/     # 11 brief collectors (execute, verify, scan, qa, ...)
+│   ├── scan-*.js                      # Scan data collection, schema, diagrams, HTML report
+│   ├── graph-*.js                     # Code graph engine (CGC/Neo4j integration)
+│   ├── journey-coverage.cjs           # Listener detector + coverage gap reporting
+│   ├── playwright-bootstrap.cjs       # Idempotent Playwright installer
+│   ├── model-selector.js              # Phase-to-model assignment (haiku/sonnet/opus)
+│   ├── rule-engine.js                 # Declarative failure-pattern rules
+│   ├── patch-lifecycle.js             # 5-stage patch candidate→graduated lifecycle
+│   └── metrics-collector.js           # Task telemetry + ELO tracking
+├── commands/                          # 51 slash commands
+│   ├── gsd-t-*.md                     # 46 GSD-T workflow commands
+│   ├── gsd.md                         # Smart router
 │   ├── branch.md                      # Git branch helper
-│   ├── checkin.md                     # Auto-version + commit/push helper
-│   └── Claude-md.md                   # Reload CLAUDE.md directives
-├── templates/                         # Document templates (10 base + stacks/)
-│   ├── CLAUDE-global.md
-│   ├── CLAUDE-project.md
-│   ├── requirements.md
-│   ├── architecture.md
-│   ├── workflows.md
-│   ├── infrastructure.md
-│   ├── progress.md
-│   ├── backlog.md
-│   ├── backlog-settings.md
-│   ├── design-contract.md             # Design-to-code token extraction template
-│   └── stacks/                        # Stack Rules Engine templates
+│   ├── checkin.md                     # Auto-version + commit/push
+│   ├── cpua.md                        # Commit, Publish, Update All
+│   └── global-change.md               # Cross-project file propagation
+├── templates/
+│   ├── CLAUDE-global.md               # Global CLAUDE.md template
+│   ├── CLAUDE-project.md              # Project CLAUDE.md template
+│   ├── requirements.md / architecture.md / workflows.md / infrastructure.md / progress.md
+│   ├── backlog.md / backlog-settings.md
+│   ├── design-contract.md / element-contract.md / widget-contract.md / page-contract.md
+│   ├── workflows/                     # 9 native Workflow scripts
+│   │   ├── gsd-t-execute.workflow.js
+│   │   ├── gsd-t-verify.workflow.js
+│   │   ├── gsd-t-wave.workflow.js
+│   │   ├── gsd-t-scan.workflow.js     # Volume-scaled (M66+)
+│   │   ├── gsd-t-integrate.workflow.js
+│   │   ├── gsd-t-debug.workflow.js
+│   │   ├── gsd-t-quick.workflow.js
+│   │   ├── gsd-t-phase.workflow.js
+│   │   └── _lib.js                    # Shared workflow helpers
+│   ├── prompts/                       # Validation subagent protocols
+│   │   ├── qa-subagent.md
+│   │   ├── red-team-subagent.md
+│   │   └── design-verify-subagent.md
+│   └── stacks/                        # Stack Rules Engine (29 templates)
 │       ├── _security.md               # Universal — always injected
-│       ├── react.md
-│       ├── typescript.md
-│       ├── design-to-code.md          # Pixel-perfect design implementation
-│       └── node-api.md
-├── scripts/                           # Runtime utility scripts (installed to ~/.claude/scripts/)
+│       ├── _auth.md                   # Universal auth rules
+│       ├── react.md / typescript.md / vue.md / nextjs.md / node-api.md
+│       ├── python.md / fastapi.md / flutter.md / tailwind.md
+│       ├── playwright.md / prisma.md / postgresql.md / supabase.md
+│       ├── firebase.md / neo4j.md / graphql.md / docker.md
+│       └── ... (29 total — ls templates/stacks/ for full list)
+├── scripts/                           # Runtime utility scripts
 │   ├── gsd-t-tools.js                 # State CLI (get/set/validate/list)
 │   ├── gsd-t-statusline.js            # Context usage bar
 │   ├── gsd-t-event-writer.js          # Structured JSONL event writer
-│   ├── gsd-t-dashboard-server.js      # Zero-dep SSE server for dashboard
-│   └── gsd-t-dashboard.html           # React Flow + Dagre real-time dashboard
+│   ├── gsd-t-stream-feed-server.js    # WebSocket + SSE streaming server
+│   ├── gsd-t-stream-feed.html         # Streaming feed viewer
+│   ├── gsd-t-dashboard.html           # Real-time agent dashboard
+│   ├── gsd-t-dashboard-autostart.cjs  # Idempotent dashboard launcher
+│   ├── gsd-t-token-aggregator.js      # JSONL token data aggregation
+│   ├── gsd-t-date-guard.js            # PreToolUse timestamp validation hook
+│   ├── gsd-t-auto-route.js            # UserPromptSubmit smart-router hook
+│   └── gsd-t-design-review-server.js  # Design review proxy + queue server
+├── test/                              # 78 test files (Node built-in test runner)
+├── e2e/                               # Playwright E2E specs
 ├── examples/
 │   ├── settings.json
 │   └── .gsd-t/
-├── docs/
-│   ├── GSD-T-README.md                # Detailed methodology + usage guide
-│   └── methodology.md
+└── docs/
+    ├── GSD-T-README.md                # Detailed methodology + usage guide
+    └── methodology.md
 ```
 
 ---

package/bin/scan-data-collector.js

@@ -52,6 +52,7 @@ function parseFilesAndLoc(text) {
 }
 
 function parseComponents(text) {
+  if (!text) return [];
   const sec = text.match(/## Component Inventory([\s\S]*?)(?=\n## |\n---|\n#[^#]|$)/);
   if (sec) {
     const tableRows = sec[1].split('\n')
@@ -66,8 +67,35 @@ function parseComponents(text) {
       .filter(Boolean);
     if (tableRows.length > 0) return tableRows;
   }
+  // M80: the deep-scan document agent writes the real domain list under a
+  // "## Components / Domains" (or "## Components") heading as "### N. Title"
+  // subsections — parse those as the authoritative domain entries. (The prior
+  // parser only knew "## Component Inventory" tables + a bare-line Structure
+  // format, so the freshly regenerated scan/architecture.md yielded zero domains
+  // and broke the renderer's domain list — caught by the GSD-T self-scan.)
+  const compSec = text.match(/## Components(?:\s*\/\s*Domains)?\b([\s\S]*?)(?=\n## |\n---\s*\n|$)/);
+  if (compSec) {
+    const domains = [];
+    for (const m of compSec[1].matchAll(/^#{3,4}\s+(?:\d+\.\s+)?(.+?)\s*$/gm)) {
+      const name = m[1].trim().replace(/\*\*/g, '').replace(/`/g, '');
+      if (name && !/^(overview|summary|notes?)$/i.test(name)) {
+        domains.push({ name, filePath: '', size: '', purpose: '', files: 1, healthScore: 80 });
+      }
+    }
+    if (domains.length > 0) return domains;
+  }
   const structSec = text.match(/## Structure([\s\S]*?)(?=\n## |\n---|\n#[^#]|$)/);
   if (!structSec) return [];
+  // Structure rendered as a markdown TABLE: | `bin/` | purpose | N files | ~LOC |
+  const tableDirs = structSec[1].split('\n')
+    .filter(l => /^\|/.test(l) && !/---/.test(l) && !/Directory|Grand Total|^\|\s*Component/i.test(l))
+    .map(row => {
+      const cols = row.split('|').map(c => c.trim().replace(/\*\*/g, '').replace(/`/g, '')).filter(Boolean);
+      if (cols.length < 2 || !/\//.test(cols[0]) || /^total/i.test(cols[0])) return null;
+      return { name: cols[0].replace(/\/$/, ''), filePath: cols[0], size: cols.slice(2).join(', '), purpose: cols[1] || '', files: 1, healthScore: 80 };
+    })
+    .filter(Boolean);
+  if (tableDirs.length > 0) return tableDirs;
   const entryRe = /^([a-zA-Z0-9_.\-]+\/)\s+(?:~?\s*)?(?:(\d+)\s+files?\s*)?\(?\s*~?\s*([\d,]+)\s+LOC\s*\)?\s*(.*)$/gm;
   const out = [];
   let m;