@tekyzinc/gsd-t 2.39.13 → 2.46.11

package/docs/requirements.md

@@ -37,6 +37,31 @@
 | REQ-029 | Diagram Rendering Toolchain — three rendering backends supported, each free and open source, selected automatically based on availability: (1) Primary — Mermaid CLI (mmdc, @mermaid-js/mermaid-cli, MIT, npm) renders .mmd files to SVG via headless Chromium; (2) Enhanced — D2 (MPL-2.0, terrastruct/d2, Go binary) as optional renderer for architecture and dataflow diagrams — uses dagre/ELK/neato layouts (TALA excluded, paid); (3) Fallback — Kroki HTTP API (MIT, yuzutech/kroki) renders any supported format via single HTTP POST to kroki.io (public free tier) or self-hosted Docker instance | P2 | complete (M17) | test/scan.test.js + verify-gates.js |
 | REQ-030 | MCP Diagram Server Support — gsd-t-scan supports optional MCP-based diagram generation when registered MCP servers are detected in Claude Code settings: diagram-bridge-mcp (MIT, tohachan) selects optimal format and renders via Kroki; C4Diagrammer (MIT, jonverrier) specialized for existing codebase → C4 architecture diagrams; mcp-mermaid (MIT, hustcc) for 22 Mermaid diagram types; MCP path is preferred over CLI when available | P3 | complete (M17) | test/scan.test.js + verify-gates.js |
 
+| REQ-031 | Per-Task Telemetry Collection — metrics-collector.js emits structured records to task-metrics.jsonl with weighted signal taxonomy (5 signal types), pre-flight intelligence check warns on domain failure patterns | P1 | complete (M25) | test/metrics-collector.test.js |
+| REQ-032 | Milestone Rollup & Process ELO — metrics-rollup.js aggregates task-metrics into rollup.jsonl with first_pass_rate, ELO scoring (K=32), trend comparison, 4 detection heuristics (first-pass-failure-spike, rework-rate-anomaly, context-overflow-correlation, duration-regression) | P1 | complete (M25) | test/metrics-rollup.test.js |
+| REQ-033 | Metrics Dashboard Panel — Chart.js trend line (first_pass_rate over milestones), domain health heatmap, ELO display in existing dashboard via GET /metrics endpoint | P2 | complete (M25) | test/dashboard-server.test.js (extend) |
+| REQ-034 | gsd-t-metrics Command — 50th command reads task-metrics.jsonl + rollup.jsonl, displays metrics summary, ELO, signal distribution, domain breakdown, trend comparison, heuristic warnings | P1 | complete (M25) | validated by use |
+| REQ-035 | Process ELO in Status — gsd-t-status displays current ELO score and quality budget summary from rollup.jsonl | P2 | complete (M25) | validated by use |
+
+| REQ-036 | Declarative Rule Engine — bin/rule-engine.js loads rules from rules.jsonl, evaluates triggers against task-metrics with 8 operators (gt, gte, lt, lte, eq, neq, in, pattern_count), tracks activation counts, flags inactive rules, consolidates related rules | P1 | planned | test/rule-engine.test.js |
+| REQ-037 | Patch Template System — patch-templates.jsonl maps rule triggers to file edits (append, prepend, insert_after, replace), templates reference target files and edit content | P1 | planned | test/rule-engine.test.js |
+| REQ-038 | Patch Lifecycle Manager — bin/patch-lifecycle.js manages 5-stage lifecycle (candidate->applied->measured->promoted->graduated) with promotion gate (>55% improvement over 2+ milestones) and graduation (3+ milestones sustained) | P1 | planned | test/patch-lifecycle.test.js |
+| REQ-039 | Active Rule Injection in Execute — gsd-t-execute.md injects firing rules (max 10 lines) into subagent prompts before task dispatch | P1 | planned | validated by use |
+| REQ-040 | Rule-Based Pre-Mortem in Plan — gsd-t-plan.md Step 1.7 enhanced with getPreMortemRules to surface historical rule matches for domain types | P2 | planned | validated by use |
+| REQ-041 | Distillation Extension — gsd-t-complete-milestone.md distillation step extended with rule evaluation, patch candidate generation, promotion gate check, graduation, consolidation, and quality budget governance | P1 | planned | validated by use |
+| REQ-042 | Quality Budget Governance — per-milestone rework ceiling (default 20%), auto-tightens constraints (force discuss, require contract review, split large tasks) when exceeded | P2 | planned | validated by use |
+
+| REQ-043 | Global Sync Manager — bin/global-sync-manager.js reads local metrics, writes global aggregated files to ~/.claude/metrics/, provides APIs for global rollup, global rules, signal distribution comparison, universal rule promotion | P1 | planned | test/global-sync-manager.test.js |
+| REQ-044 | Cross-Project Rule Propagation — gsd-t-version-update-all syncs global rules (universal or promotion_count >= 2) to all registered projects as candidates | P1 | planned | test/global-rule-sync.test.js |
+| REQ-045 | Universal Rule Promotion — rules promoted in 3+ projects marked universal, 5+ projects become npm distribution candidates shipped in examples/rules/ | P1 | planned | test/global-sync-manager.test.js |
+| REQ-046 | Cross-Project Signal Comparison — gsd-t-metrics --cross-project displays signal-type distribution comparison across registered projects | P2 | planned | validated by use |
+| REQ-047 | Global ELO & Rankings — gsd-t-status displays global ELO score and cross-project rank when global metrics exist | P2 | planned | validated by use |
+| REQ-048 | Global Rule Promotion on Milestone Completion — gsd-t-complete-milestone copies promoted rules to global-rules.jsonl and updates global rollup after local promotion | P1 | planned | validated by use |
+| REQ-049 | E2E Enforcement Rule — when playwright.config.* or cypress.config.* exists, ALL test-running commands (execute, quick, debug, test-sync, integrate, verify, complete-milestone) MUST run the full E2E suite. Unit-only results are NEVER sufficient. QA subagent prompts explicitly mandate E2E detection and execution. | P1 | complete | enforced in 7 command files + CLAUDE.md + pre-commit-gate contract |
+| REQ-050 | Functional E2E Test Quality Standard — Playwright specs MUST verify functional behavior (state changes, data flow, content updates after actions), NOT just element existence (isVisible, toBeEnabled). Shallow layout tests that would pass on an empty HTML page are flagged and block verification. QA subagent audits for shallow tests. | P1 | complete | enforced in execute, qa, test-sync, verify, quick, debug, integrate, complete-milestone + global CLAUDE.md + CLAUDE-global template |
+| REQ-051 | Document Ripple Completion Gate — when a change affects multiple files, identify the full blast radius BEFORE starting, complete ALL updates in one pass, and only report completion after every downstream document is updated. Partial delivery is never acceptable. The user should never need to ask "did you update everything?" | P1 | complete | enforced in global CLAUDE.md + CLAUDE-global template + project CLAUDE.md |
+| REQ-052 | Doc-Ripple Subagent — dedicated agent auto-spawned after code-modifying commands (execute, integrate, quick, debug, wave) that analyzes git diff, identifies full blast radius of affected documents, and spawns parallel subagents to update them. Produces manifest audit trail. Threshold logic skips trivial changes. | P1 | complete | M28: contract ACTIVE, command file, 43 tests, wired into execute/integrate/quick/debug/wave |
+
 ## Technical Requirements
 
 | ID | Requirement | Priority | Status |
@@ -99,8 +124,47 @@
 | REQ-029 | Diagram Rendering Toolchain — Mermaid CLI → D2 → Kroki fallback chain      | scan-diagrams    | pending         | planned |
 | REQ-030 | MCP Diagram Server Support — diagram-bridge-mcp / C4Diagrammer / mcp-mermaid | scan-diagrams  | pending         | planned |
 
-**Orphaned requirements**: REQ-001 through REQ-017 (all M1–M13 deliverables, complete — not mapped to M14 tasks by design).
-**Unanchored tasks**: command Task 2 (bin/gsd-t.js installer update) and Task 3 (4 reference files) are infrastructure supporting REQ-023 — implicitly mapped.
+## Requirements Traceability (updated by plan phase — M25)
+
+| REQ-ID  | Requirement Summary                                         | Domain              | Task(s)                        | Status  |
+|---------|-------------------------------------------------------------|---------------------|--------------------------------|---------|
+| REQ-031 | Per-Task Telemetry Collection — collector + emission        | metrics-collection  | Task 1, 2, 3, 4, 5            | planned |
+| REQ-032 | Milestone Rollup & Process ELO — rollup + heuristics       | metrics-rollup      | Task 1, 2, 3, 4, 5            | planned |
+| REQ-033 | Metrics Dashboard Panel — /metrics endpoint + Chart.js     | metrics-dashboard   | Task 1, 2                      | planned |
+| REQ-034 | gsd-t-metrics Command — 50th command                       | metrics-commands    | Task 1, 3, 4                   | planned |
+| REQ-035 | Process ELO in Status — ELO display in status output       | metrics-commands    | Task 2                         | planned |
+
+**Orphaned requirements**: REQ-001 through REQ-017 (all M1-M13 deliverables, complete — not mapped to M14+ tasks by design).
+**Unanchored tasks**: metrics-commands Task 3 (CLI count) and Task 4 (4 reference files) are infrastructure supporting REQ-034 — implicitly mapped.
+
+## Requirements Traceability (updated by plan phase — M26)
+
+| REQ-ID  | Requirement Summary                                         | Domain              | Task(s)                        | Status  |
+|---------|-------------------------------------------------------------|---------------------|--------------------------------|---------|
+| REQ-036 | Declarative Rule Engine — rule evaluator + activation tracking | rule-engine       | Task 1, 2, 3                   | pending |
+| REQ-037 | Patch Template System — templates.jsonl + seed data          | rule-engine         | Task 2, 4                      | pending |
+| REQ-038 | Patch Lifecycle Manager — 5-stage lifecycle + promotion gate | patch-lifecycle     | Task 1, 2, 3                   | pending |
+| REQ-039 | Active Rule Injection in Execute                             | command-integration | Task 1                         | pending |
+| REQ-040 | Rule-Based Pre-Mortem in Plan                                | command-integration | Task 2                         | pending |
+| REQ-041 | Distillation Extension — rules + patches + graduation        | command-integration | Task 3                         | pending |
+| REQ-042 | Quality Budget Governance — rework ceiling + tightening      | command-integration | Task 3                         | pending |
+
+**Orphaned requirements**: None — all M26 REQs mapped to tasks.
+**Unanchored tasks**: rule-engine Task 5 (tests) and patch-lifecycle Task 4 (tests) are QA infrastructure supporting all REQs. command-integration Task 4 (reference docs) supports Pre-Commit Gate compliance.
+
+## Requirements Traceability (updated by plan phase — M27)
+
+| REQ-ID  | Requirement Summary                                         | Domain              | Task(s)                        | Status  |
+|---------|-------------------------------------------------------------|---------------------|--------------------------------|---------|
+| REQ-043 | Global Sync Manager — read local, write global, compare     | global-metrics      | Task 1, 2, 3, 4               | pending |
+| REQ-044 | Cross-Project Rule Propagation — update-all syncs rules     | cross-project-sync  | Task 1, 3                      | pending |
+| REQ-045 | Universal Rule Promotion — 3+ universal, 5+ npm candidate   | global-metrics, cross-project-sync | gm Task 3, cps Task 2 | pending |
+| REQ-046 | Cross-Project Signal Comparison — metrics --cross-project    | command-extensions  | Task 1                         | pending |
+| REQ-047 | Global ELO & Rankings — status global ELO display            | command-extensions  | Task 2                         | pending |
+| REQ-048 | Global Rule Promotion on Milestone Completion                | command-extensions  | Task 3                         | pending |
+
+**Orphaned requirements**: None — all M27 REQs mapped to tasks.
+**Unanchored tasks**: global-metrics Task 4 (tests) and cross-project-sync Task 3 (tests) are QA infrastructure supporting REQ-043 through REQ-045. command-extensions Task 4 (reference docs) supports Pre-Commit Gate compliance.
 
 ---
 

package/examples/.gsd-t/contracts/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27

package/examples/.gsd-t/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27

package/examples/.gsd-t/domains/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27

package/examples/.gsd-t/domains/example-domain/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27

package/examples/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27

package/examples/rules/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "@tekyzinc/gsd-t",
-  "version": "2.39.13",
-  "description": "GSD-T: Contract-Driven Development for Claude Code — 49 slash commands with graph-powered code analysis, real-time agent dashboard, execution intelligence, backlog management, impact analysis, test sync, milestone archival, and PRD generation",
-  "author": "Tekyz, Inc.",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Tekyz-Inc/get-stuff-done-teams.git"
-  },
-  "homepage": "https://github.com/Tekyz-Inc/get-stuff-done-teams#readme",
-  "keywords": [
-    "claude-code",
-    "gsd",
-    "ai-development",
-    "agent-teams",
-    "contract-driven-development",
-    "slash-commands"
-  ],
-  "main": "bin/gsd-t.js",
-  "bin": {
-    "gsd-t": "bin/gsd-t.js"
-  },
-  "scripts": {
-    "test": "node --test",
-    "prepublishOnly": "npm test"
-  },
-  "files": [
-    "bin/",
-    "commands/",
-    "scripts/",
-    "templates/",
-    "examples/",
-    "docs/",
-    "CHANGELOG.md"
-  ],
-  "engines": {
-    "node": ">=16.0.0"
-  }
-}
+{
+  "name": "@tekyzinc/gsd-t",
+  "version": "2.46.11",
+  "description": "GSD-T: Contract-Driven Development for Claude Code — 51 slash commands with headless CI/CD mode, graph-powered code analysis, real-time agent dashboard, execution intelligence, task telemetry, doc-ripple enforcement, backlog management, impact analysis, test sync, milestone archival, and PRD generation",
+  "author": "Tekyz, Inc.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tekyz-Inc/get-stuff-done-teams.git"
+  },
+  "homepage": "https://github.com/Tekyz-Inc/get-stuff-done-teams#readme",
+  "keywords": [
+    "claude-code",
+    "gsd",
+    "ai-development",
+    "agent-teams",
+    "contract-driven-development",
+    "slash-commands"
+  ],
+  "main": "bin/gsd-t.js",
+  "bin": {
+    "gsd-t": "bin/gsd-t.js"
+  },
+  "scripts": {
+    "test": "node --test",
+    "prepublishOnly": "npm test"
+  },
+  "files": [
+    "bin/",
+    "commands/",
+    "scripts/",
+    "templates/",
+    "examples/",
+    "docs/",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/scripts/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27

package/scripts/gsd-t-dashboard-server.js

@@ -109,11 +109,28 @@ function handleEvents(req, res, eventsDir) {
   req.on("close", () => { clearInterval(timer); if (unwatchFile) unwatchFile(); if (dirWatcher) dirWatcher.close(); });
 }
 
-function startServer(port, eventsDir, htmlPath) {
+function readMetricsData(metricsDir) {
+  const taskFile = path.join(metricsDir, "task-metrics.jsonl");
+  const rollupFile = path.join(metricsDir, "rollup.jsonl");
+  const taskMetrics = fs.existsSync(taskFile) ? safeReadJsonl(taskFile) : [];
+  const rollups = fs.existsSync(rollupFile) ? safeReadJsonl(rollupFile) : [];
+  return { taskMetrics, rollups };
+}
+
+function handleMetrics(req, res, projectDir) {
+  const metricsDir = path.join(projectDir, ".gsd-t", "metrics");
+  const data = readMetricsData(metricsDir);
+  res.writeHead(200, { "Content-Type": "application/json" });
+  res.end(JSON.stringify(data));
+}
+
+function startServer(port, eventsDir, htmlPath, projectDir) {
+  const projDir = projectDir || path.resolve(eventsDir, "..", "..");
   const server = http.createServer((req, res) => {
     const url = req.url.split("?")[0];
     if (url === "/" || url === "") return handleRoot(req, res, htmlPath);
     if (url === "/events") return handleEvents(req, res, eventsDir);
+    if (url === "/metrics") return handleMetrics(req, res, projDir);
     if (url === "/ping") return handlePing(req, res, port);
     if (url === "/stop") return handleStop(req, res, server);
     res.writeHead(404); res.end("Not found");
@@ -122,7 +139,7 @@ function startServer(port, eventsDir, htmlPath) {
   return { server, url: `http://localhost:${port}` };
 }
 
-module.exports = { startServer, tailEventsFile, readExistingEvents, parseEventLine, findEventsDir };
+module.exports = { startServer, tailEventsFile, readExistingEvents, parseEventLine, findEventsDir, readMetricsData };
 
 if (require.main === module) {
   const argv = process.argv.slice(2);

package/scripts/gsd-t-dashboard.html

@@ -8,6 +8,7 @@
 <script src="https://unpkg.com/dagre@0.8.5/dist/dagre.min.js"></script>
 <script src="https://unpkg.com/reactflow@11.11.4/dist/umd/index.js"></script>
 <link rel="stylesheet" href="https://unpkg.com/reactflow@11.11.4/dist/style.css">
+<script src="https://cdn.jsdelivr.net/npm/chart.js@4/dist/chart.umd.min.js"></script>
 <style>
 :root{--bg:#0d1117;--surface:#161b22;--border:#30363d;--text:#e6edf3;--muted:#7d8590;
   --green:#3fb950;--green-bg:#1a3a1e;--red:#f85149;--red-bg:#3a1a1a;
@@ -50,6 +51,15 @@ body{background:var(--bg);color:var(--text);font-family:var(--font);font-size:12
 .model-name{width:50px;color:var(--text);font-weight:500;}.model-bar-bg{flex:1;height:8px;background:var(--bg);border-radius:4px;overflow:hidden;}
 .model-bar{height:100%;border-radius:4px;transition:width .3s ease;}.model-bar.opus{background:var(--blue);}.model-bar.sonnet{background:var(--green);}.model-bar.haiku{background:var(--yellow);}
 .model-cnt{color:var(--muted);font-size:10px;min-width:20px;text-align:right;}
+.metrics-panel{background:var(--surface);border-top:1px solid var(--border);padding:12px;flex-shrink:0;max-height:280px;overflow-y:auto;}
+.metrics-panel .sb-hdr{padding:0 0 8px;border-bottom:none;}
+.elo-display{display:flex;align-items:center;gap:8px;margin-bottom:8px;font-size:12px;}
+.elo-score{font-size:18px;font-weight:bold;color:var(--blue);}
+.elo-delta{font-size:12px;}.elo-delta.up{color:var(--green);}.elo-delta.down{color:var(--red);}
+.metrics-chart{height:120px;margin-bottom:8px;}
+.domain-heat{width:100%;border-collapse:collapse;font-size:10px;margin-top:4px;}
+.domain-heat th{color:var(--muted);text-align:left;padding:2px 6px;border-bottom:1px solid var(--border);}
+.domain-heat td{padding:2px 6px;}.rate-good{color:var(--green);}.rate-warn{color:var(--yellow);}.rate-bad{color:var(--red);}
 </style>
 </head>
 <body>
@@ -65,6 +75,15 @@ body{background:var(--bg);color:var(--text);font-family:var(--font);font-size:12
     <div id="models" class="models"><div class="noevents">No model data yet</div></div>
     <div class="sb-hdr">Live Event Feed</div>
     <div id="feed" class="feed"><div class="noevents">Waiting for events...</div></div>
+    <div class="metrics-panel">
+      <div class="sb-hdr">Process Metrics</div>
+      <div id="elo-display" class="elo-display"><span class="noevents">No metrics data</span></div>
+      <div class="metrics-chart"><canvas id="trend-chart"></canvas></div>
+      <table id="domain-heat" class="domain-heat" style="display:none">
+        <thead><tr><th>Domain</th><th>Pass%</th><th>Avg(s)</th><th>Tasks</th></tr></thead>
+        <tbody id="domain-heat-body"></tbody>
+      </table>
+    </div>
   </div>
 </div>
 <script>
@@ -194,6 +213,50 @@ function Dashboard(){
 }
 
 ReactDOM.render(React.createElement(Dashboard),document.getElementById('rf-root'));
+
+// ── Metrics Panel ──────────────────────────────────────────────────────────
+(function initMetrics(){
+  let trendChart=null;
+  function rateClass(r){return r>=0.8?'rate-good':r>=0.6?'rate-warn':'rate-bad';}
+  function fetchMetrics(){
+    fetch(`http://localhost:${PORT}/metrics`).then(r=>r.json()).then(data=>{
+      renderELO(data.rollups);renderTrend(data.rollups);renderHeatmap(data.rollups);
+    }).catch(()=>{});
+  }
+  function renderELO(rollups){
+    const el=document.getElementById('elo-display');
+    if(!rollups||!rollups.length){el.innerHTML='<span class="noevents">No metrics data</span>';return;}
+    const last=rollups[rollups.length-1];
+    const dc=last.elo_delta>=0?'up':'down';const arrow=last.elo_delta>=0?'+':'';
+    el.innerHTML=`<span class="elo-score">${Math.round(last.elo_after)}</span><span>ELO</span>`+
+      `<span class="elo-delta ${dc}">${arrow}${last.elo_delta.toFixed(1)}</span>`;
+  }
+  function renderTrend(rollups){
+    const ctx=document.getElementById('trend-chart');
+    if(!ctx||!rollups||rollups.length<1)return;
+    const labels=rollups.map(r=>r.milestone);
+    const rates=rollups.map(r=>(r.first_pass_rate*100).toFixed(1));
+    if(trendChart)trendChart.destroy();
+    trendChart=new Chart(ctx,{type:'line',data:{labels,datasets:[{label:'First-Pass %',
+      data:rates,borderColor:'#3fb950',backgroundColor:'rgba(63,185,80,0.1)',fill:true,tension:0.3}]},
+      options:{responsive:true,maintainAspectRatio:false,scales:{y:{min:0,max:100,
+      ticks:{color:'#7d8590',font:{size:9}}},x:{ticks:{color:'#7d8590',font:{size:9}}}},
+      plugins:{legend:{labels:{color:'#e6edf3',font:{size:10}}}}}});
+  }
+  function renderHeatmap(rollups){
+    const tbl=document.getElementById('domain-heat');const body=document.getElementById('domain-heat-body');
+    if(!rollups||!rollups.length||!tbl||!body){return;}
+    const last=rollups[rollups.length-1];
+    if(!last.domain_breakdown||!last.domain_breakdown.length)return;
+    tbl.style.display='table';
+    body.innerHTML=last.domain_breakdown.map(d=>{
+      const r=d.first_pass_rate;const cls=rateClass(r);
+      return `<tr><td>${d.domain}</td><td class="${cls}">${(r*100).toFixed(0)}%</td>`+
+        `<td>${d.avg_duration_s.toFixed(0)}</td><td>${d.tasks}</td></tr>`;
+    }).join('');
+  }
+  fetchMetrics();setInterval(fetchMetrics,30000);
+})();
 </script>
 </body>
 </html>

package/scripts/gsd-t-event-writer.js

@@ -30,6 +30,7 @@ const VALID_EVENT_TYPES = new Set([
   "experience_retrieval",
   "outcome_tagged",
   "distillation",
+  "task_complete",
 ]);
 
 const VALID_OUTCOMES = new Set(["success", "failure", "learning", "deferred", null]);

package/templates/CLAUDE-global.md

@@ -44,20 +44,22 @@ PROJECT or FEATURE or SCAN
 | `/user:gsd-t-milestone` | Define new milestone |
 | `/user:gsd-t-partition` | Decompose into domains + contracts |
 | `/user:gsd-t-discuss` | Multi-perspective design exploration |
-| `/user:gsd-t-plan` | Create atomic task lists per domain |
+| `/user:gsd-t-plan` | Create atomic task lists per domain (tasks auto-split to fit one context window) |
 | `/user:gsd-t-impact` | Analyze downstream effects before execution |
-| `/user:gsd-t-execute` | Run tasks (solo or team) |
+| `/user:gsd-t-execute` | Run tasks — task-level fresh dispatch, worktree isolation, adaptive replanning, active rule injection |
 | `/user:gsd-t-test-sync` | Keep tests aligned with code changes |
 | `/user:gsd-t-qa` | QA agent — test generation, execution, gap reporting |
+| `/user:gsd-t-doc-ripple` | Automated document ripple — update downstream docs after code changes |
 | `/user:gsd-t-integrate` | Wire domains together |
-| `/user:gsd-t-verify` | Run quality gates |
-| `/user:gsd-t-complete-milestone` | Archive milestone + git tag |
+| `/user:gsd-t-verify` | Run quality gates + goal-backward behavior verification |
+| `/user:gsd-t-complete-milestone` | Archive milestone + git tag (goal-backward gate, rule engine distillation) |
 | `/user:gsd-t-wave` | Full cycle (auto-advances all phases) |
-| `/user:gsd-t-status` | Cross-domain progress view |
+| `/user:gsd-t-status` | Cross-domain progress view with token breakdown, global ELO and cross-project rankings |
 | `/user:gsd-t-debug` | Systematic debugging |
 | `/user:gsd-t-quick` | Fast task, respects contracts |
 | `/user:gsd-t-reflect` | Generate retrospective from event stream, propose memory updates |
 | `/user:gsd-t-visualize` | Launch browser dashboard |
+| `/user:gsd-t-metrics` | View task telemetry, process ELO, domain health, and cross-project comparison (`--cross-project`) |
 | `/user:gsd-t-health` | Validate .gsd-t/ structure, optionally repair |
 | `/user:gsd-t-pause` | Save exact position for reliable resume |
 | `/user:gsd-t-populate` | Auto-populate docs from existing codebase |
@@ -232,6 +234,49 @@ After Playwright tests finish (pass or fail), **kill any app/server processes th
 
 This applies everywhere Playwright tests are executed: execute, test-sync, verify, quick, wave, debug, complete-milestone, and integrate.
 
+### E2E Enforcement Rule (MANDATORY)
+
+**Running only unit tests when E2E tests exist is a test failure.** This is non-negotiable.
+
+```
+BEFORE reporting "tests pass" for ANY task:
+  ├── Does playwright.config.* or cypress.config.* exist?
+  │     YES → You MUST run the full E2E suite. Unit-only results are INCOMPLETE.
+  │     NO  → Unit/integration tests are sufficient.
+  ├── Did you run every detected test runner?
+  │     NO → Run it now. Do not commit until ALL suites pass.
+  └── Report format MUST include all suites:
+        "Unit: X/Y pass | E2E: X/Y pass" (or "E2E: N/A — no config")
+```
+
+The conditional "if UI/routes/flows changed" in command files applies to **writing new E2E specs**, not to **running existing ones**. You always run existing E2E specs. Always.
+
+### E2E Test Quality Standard (MANDATORY)
+
+**E2E tests must be FUNCTIONAL tests, not LAYOUT tests.** This is non-negotiable.
+
+A layout test checks that elements exist (`isVisible`, `toBeAttached`, `toBeEnabled`, `toHaveCount`). A functional test checks that features work — actions produce correct outcomes.
+
+```
+LAYOUT TEST (WRONG — passes even if every feature is broken):
+  await expect(page.locator('#tab-sessions')).toBeVisible();
+  await page.click('#tab-sessions');
+  // ← No assertion that the tab's content actually loaded
+
+FUNCTIONAL TEST (RIGHT — fails if the feature is broken):
+  await page.click('#tab-sessions');
+  await expect(page.locator('.session-list')).toContainText('Session 1');
+  // ← Proves clicking the tab loaded the session data
+```
+
+Every Playwright assertion must verify one of:
+- **State changed**: After click/type/submit, the app state is different (new content, updated data, changed status)
+- **Data flowed**: User input → API call → response rendered (use `page.waitForResponse` or assert on rendered data)
+- **Content loaded**: Navigation/tab switch → destination content appeared (assert on text/data unique to destination)
+- **Widget responded**: Terminal accepted keystrokes and produced output, editor saved changes, form submitted and data persisted
+
+**If a test would pass on an empty HTML page with the correct element IDs and no JavaScript, it is not a functional test.** Rewrite it.
+
 ## QA Agent (Mandatory)
 
 Any GSD-T phase that produces or validates code **MUST run QA**. The QA agent's sole job is test generation, execution, and gap reporting. It never writes feature code.
@@ -246,12 +291,20 @@ Any GSD-T phase that produces or validates code **MUST run QA**. The QA agent's
 **Task subagent spawn instruction (execute/integrate):**
 ```
 Task subagent (general-purpose):
-"Run the full test suite and contract compliance tests.
-Read .gsd-t/contracts/ for contract definitions.
-Report: pass/fail counts and any coverage gaps."
+"Run ALL configured test suites — detect and run every one:
+a. Unit tests (vitest/jest/mocha): run the full suite
+b. E2E tests: check for playwright.config.* or cypress.config.* — if found, run the FULL E2E suite
+c. NEVER skip E2E when a config file exists. Running only unit tests is a QA FAILURE.
+d. Read .gsd-t/contracts/ for contract definitions. Check contract compliance.
+e. AUDIT E2E test quality: Review each Playwright spec — if any test only checks element
+   existence (isVisible, toBeAttached, toBeEnabled) without verifying functional behavior
+   (state changes, data loaded, content updated after user actions), flag it as
+   'SHALLOW TEST — needs functional assertions'. A passing test suite that doesn't catch
+   broken features is a QA FAILURE.
+Report format: 'Unit: X/Y pass | E2E: X/Y pass (or N/A if no config) | Contract: compliant/violations | Shallow tests: N'"
 ```
 
-**QA failure blocks phase completion.** Lead cannot proceed until QA reports PASS or user explicitly overrides.
+**QA failure OR shallow tests found blocks phase completion.** Lead cannot proceed until QA reports PASS with zero shallow tests, or user explicitly overrides.
 
 ## Model Display (MANDATORY)
 
@@ -340,6 +393,35 @@ BEFORE EVERY COMMIT:
 
 If ANY answer is YES and the doc is NOT updated, update it BEFORE committing. No exceptions.
 
+## Document Ripple Completion Gate (MANDATORY)
+
+**NEVER report a task as "done" or present a summary until ALL downstream documents are updated.** This is not optional.
+
+When a change affects multiple files (e.g., a new standard that applies across command files, a renamed API, a new convention), you MUST:
+
+1. **Identify the full blast radius BEFORE starting**: List every file that needs the change
+2. **Complete ALL updates in one pass**: Do not update 3 of 8 files and then present a summary
+3. **Run the Pre-Commit Gate on the COMPLETE changeset**: Not on a partial subset
+4. **Only THEN report completion**
+
+```
+BEFORE reporting "done" or presenting a summary:
+  ├── Did this change establish a new standard, rule, or convention?
+  │     YES → Grep for every file that should enforce it. Update ALL of them.
+  ├── Did this change modify a pattern used in multiple command files?
+  │     YES → Find and update EVERY command file that uses that pattern.
+  ├── Did this change affect a template (CLAUDE-global, CLAUDE-project, etc.)?
+  │     YES → The template AND the live equivalent (~/.claude/CLAUDE.md) must match.
+  ├── Did this change add a new requirement?
+  │     YES → Add to docs/requirements.md in the same pass.
+  ├── Have I checked EVERY file in the blast radius?
+  │     NO → Keep going. Do not present partial work.
+  └── Am I about to say "want me to also update X?" or "should I check Y?"
+        YES → STOP. Just update X and check Y. Then report done.
+```
+
+**The test for this gate**: If the user asks "did you update all the documents?" and the answer would be "no, I missed some" — you failed this gate. The user should never need to ask.
+
 ## Execution Behavior
 - ALWAYS check docs/architecture.md before adding or modifying components.
 - ALWAYS check docs/workflows.md before changing any multi-step process.
@@ -427,7 +509,7 @@ Successor mapping:
 | `execute` | `test-sync` | |
 | `test-sync` | `verify` | `integrate` (if multi-domain) |
 | `integrate` | `verify` | |
-| `verify` | `complete-milestone` | |
+| `verify` | *(auto-invokes complete-milestone)* | |
 | `complete-milestone` | `status` | |
 | `scan` | `promote-debt` | `milestone` |
 | `init` | `scan` | `milestone` |

package/templates/desktop.ini

@@ -0,0 +1,2 @@
+[.ShellClassInfo]
+IconResource=C:\Program Files\Google\Drive File Stream\122.0.1.0\GoogleDriveFS.exe,27