@tekyzinc/gsd-t 5.5.10 → 5.5.11

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [5.5.11] - 2026-07-29
+
+### Fixed — the new style gate would have failed 27 untouched documents in three projects
+
+Caught by running the gate live in a downstream project immediately after propagation rather than trusting the "copied 1 bin tool(s)" report. v5.5.10 shipped the gate to all 33 registered projects, but the grandfather list that exempts pre-v1.2.0 documents existed only in the GSD-T repo. binvoice (19 documents), NiceNote (6) and IssueRecorder (2) had none — so the next `gsd-t-verify` run in those projects would have failed on documents nobody touched, written to a then-valid standard.
+
+The gate now establishes its own starting line: on the `--dir` path, when the list file is absent and the directory already holds documents, it writes the list once from the existing set and reports `seeded: { reason: "seeded-pre-existing", count, docs }`.
+
+This is **not a fallback** — it masks no failure and continues past none; it defines where the gate begins. Three properties keep it honest: written **once** (a self-re-seeding list would silently absolve every newly-drifted document, which is the banned behavior), keyed on the file being absent, and always surfaced naming every document covered. A document created after the seed is gated normally; a single `--doc` call never seeds; an un-writable directory returns exit 64 with the reason rather than a silent mass-pass or mass-fail.
+
+- `bin/gsd-t-pseudocode-style.cjs`: `seedGrandfatherList()` + envelope `seeded` field.
+- `test/pseudocode-style-gate.test.js`: 4 new tests (15 → 19) — seed happens, seed never re-runs, `--doc` never seeds, un-writable directory exits 64.
+- `.gsd-t/contracts/pseudocode-source-of-truth-contract.md`: §1.1.5 documents the seed and why it is not a fallback.
+
+Verified live: binvoice's 19 documents now report `exitCode 0`, 19 seeded, 0 violations. Suite 3052/0/13-skip.
+
 ## [5.5.10] - 2026-07-29
 
 ### Added — PseudoCode style is governed: the flow IS the document

package/README.md

@@ -1,6 +1,6 @@
 # GSD-T: Contract-Driven Development for Claude Code
 
-**v5.5.10** - A methodology for reliable, parallelizable development using Claude Code with optional Agent Teams support.
+**v5.5.11** - 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.

package/bin/gsd-t-pseudocode-style.cjs

@@ -252,10 +252,56 @@ function loadGrandfathered(dir) {
       const t = l.trim();
       if (t && !t.startsWith("#")) out.add(t);
     }
-  } catch { /* absent list = nothing grandfathered */ }
+  } catch { /* absent list = nothing grandfathered (see seedGrandfatherList) */ }
   return out;
 }
 
+/**
+ * First-run seed for a project that already had PseudoCode docs before this gate
+ * existed.
+ *
+ * WHY THIS IS NOT A FALLBACK (No-Fallback-Ever doctrine):
+ * this does not continue past a failure or mask one. It establishes the gate's
+ * STARTING LINE. The gate governs docs authored under contract §1.1; docs that
+ * predate it were written to a different (then-valid) standard, and retroactively
+ * failing them would make an unrelated verify run fail in a downstream project for
+ * work nobody touched. That is a false failure, not a caught defect.
+ *
+ * The seed is: WRITTEN ONCE (never rewritten — a list that re-seeded itself would
+ * silently absolve every newly-drifted doc, which IS the banned behavior), keyed on
+ * the list file being ABSENT, and always SURFACED with reason "seeded-pre-existing"
+ * naming every doc it covers. A doc created AFTER the seed is gated normally.
+ *
+ * @returns {{ seeded: boolean, names: string[], error?: string }}
+ */
+function seedGrandfatherList(dir, docBasenames) {
+  const listPath = path.join(dir, GRANDFATHER_FILE);
+  if (fs.existsSync(listPath)) return { seeded: false, names: [] };
+  if (docBasenames.length === 0) return { seeded: false, names: [] };
+
+  const body = [
+    "# Docs that predate the §1.1 flow-line style gate (contract v1.2.0).",
+    "# Seeded automatically on this gate's FIRST run in this project, so pre-existing",
+    "# docs are not retroactively failed. Each is reported as a logged skip WITH A",
+    "# REASON — never a silent pass.",
+    "#",
+    "# This file is written ONCE and never re-seeded: a doc created after this point",
+    "# is gated normally. Removing a name here is how a doc opts INTO the gate —",
+    "# convert it to the §1.1 flow style in the same change.",
+    ...docBasenames,
+    "",
+  ].join("\n");
+
+  try {
+    fs.writeFileSync(listPath, body, "utf8");
+  } catch (e) {
+    // Cannot write (read-only checkout, permissions) — surface it, do NOT
+    // silently fail 20 docs and do NOT silently pass them either.
+    return { seeded: false, names: [], error: `cannot seed ${GRANDFATHER_FILE}: ${e && e.message}` };
+  }
+  return { seeded: true, names: docBasenames.slice() };
+}
+
 /**
  * Run the gate over one doc or a whole directory (§7 discovery glob).
  * Never throws.
@@ -283,6 +329,17 @@ function run({ doc, dir }) {
     }
   }
 
+  // First-run seed: a project whose docs predate this gate gets its starting line
+  // established once, surfaced with a reason. Only on the --dir path (the whole-set
+  // view); a single --doc call never seeds.
+  let seedInfo = null;
+  if (dir) {
+    seedInfo = seedGrandfatherList(dir, docs.map((d) => path.basename(d)).sort());
+    if (seedInfo.error) {
+      return { ok: false, exitCode: 64, reason: seedInfo.error, violations: [] };
+    }
+  }
+
   const results = [];
   const violations = [];
   const skips = [];
@@ -295,7 +352,7 @@ function run({ doc, dir }) {
     if (r.exitCode > worstExit) worstExit = r.exitCode;
   }
 
-  return {
+  const envelope = {
     ok: worstExit === 0,
     exitCode: worstExit,
     docsChecked: docs.length,
@@ -303,6 +360,11 @@ function run({ doc, dir }) {
     skips,
     violations,
   };
+  if (seedInfo && seedInfo.seeded) {
+    // Surfaced, never silent: name the migration and every doc it covers.
+    envelope.seeded = { reason: "seeded-pre-existing", count: seedInfo.names.length, docs: seedInfo.names };
+  }
+  return envelope;
 }
 
 function parseArgs(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "5.5.10",
+  "version": "5.5.11",
   "description": "GSD-T: Contract-Driven Development for Claude Code — 54 slash commands with headless-by-default workflow spawning, unattended supervisor relay with event stream, graph-powered code analysis, real-time agent dashboard, task telemetry, doc-ripple enforcement, backlog management, impact analysis, test sync, milestone archival, and PRD generation",
   "author": "Tekyz, Inc.",
   "license": "MIT",