@tekyzinc/gsd-t 5.19.10 → 5.20.10

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [5.20.10] - 2026-09-17
+
+### Changed — `/gsd-t-estimate` is the sheet only, and the sheet now has a written spec
+
+Two shipped Hilo estimates each needed a dozen hand-corrections, all on structure and
+formatting the command had left to memory: a second header row written under the real one,
+`Mon ...` never updated, the sage highlight cleared as a "stray fill", Calibri where Arial
+belongs, a Team Mix with no Project Manager or Business Analyst, one row at Count 1.40, three
+part-timers at 0.42/0.56/0.23 where the rule is fill-one-then-spill, flat 160/160/147 hours
+for every role, a fourth month column at −12.80 hrs, size cells holding the legend text
+"XS - Extra Small", Phase cells that lost their dropdown, an empty Technology Stack tab, and
+an off-by-one that wrote Total Hrs one column too far right.
+
+- NEW `templates/estimate-sheet-spec.md` (propagated to `~/.claude/templates/`): exact layout,
+  formulas and styling for the three tabs; roster rules (one row per person, no Count > 1.00,
+  saturate-then-spill, every MF factor staffed); ramp weights by discipline; the last month as a
+  remainder formula; month-column count recomputed after any roster change; the Overview cells
+  the estimates index imports; and a read-back audit checklist that runs after every write.
+- `commands/gsd-t-estimate.md`: PRD dropped (that is `/gsd-t-prd`); scope = T-Shirt Size +
+  Team Mix + Technology Stack; `--sheet <url>` accepted (gap-analysis already passed it); reads
+  the target sheet's real layout before writing; Team Mix is its own PAUSE; Technology Stack is
+  a step, not a leftover tab; the write step is clear-then-paint, small batches, no
+  `X-Goog-User-Project`, `copyPaste` for Phase cells, verified by reading back; Step 2.5 and the
+  Red Team can no longer be skipped silently.
+- `templates/estimate-config.json`: the sheet's own MF list is the source of truth; `sheetSpec`
+  pointer added. Playbook Phase 6 now points at `/gsd-t-prd`. `bin/gsd-t.js` SHARED_TEMPLATES
+  carries the spec so it lands in every install.
+- NEW `bin/gsd-t-estimate-sheet.cjs` — `gsd-t estimate-sheet read | plan-check | write | audit`,
+  the deterministic writer. The model supplies judgment only (sizes, per-discipline FTE,
+  tech-stack lines) as a JSON plan; the tool reads the sheet, splits FTE into people
+  (saturate then spill), computes months, column count and the ramp, writes every formula and
+  style from the current shape, then audits by reading back. Exit 4 on any ✗, halt on the first
+  failing batch, no fallbacks (the fallback guard caught two real ones during the build: an
+  unknown discipline silently ramped as PM, and MF coverage passing when the T-Shirt layout was
+  unreadable). Run read-only against the hand-corrected ATP sheet it passed every structural
+  check and surfaced the two real gaps. Ships in GLOBAL and PROJECT bin lists; 21 unit tests,
+  including the loop-closer: the writer's own output passes its own audit, and each historical
+  defect fails its named check. The command now calls it instead of writing cells by hand.
+
+## [5.19.11] - 2026-09-15
+
+### Fixed — a broken git made the worktree prompt vanish with nothing said
+
+An Xcode update left the licence unaccepted, so every git command exited 69 with a licence
+notice. The worktree picker's first check asks "is this a git repo" and read that failure as
+a plain "no" — which is the ordinary case for most directories, so it exited silently. The
+launcher then skipped the worktree prompt entirely and started the session where it stood.
+A prompt that disappears reads as a GSD-T bug; the actual cause was git, two commands away.
+
+- `bin/gsd-t-pick-worktree.cjs`: "not a repository" and "git could not answer" are now
+  different answers. git's own exit tells them apart — a genuine non-repo says so on stderr;
+  anything else (missing binary, unaccepted licence, broken install) HALTS with what git said
+  and how to fix it. The sibling checks in `gsd-t-worktree-detect.cjs` already halted this way;
+  this one was the inconsistent member.
+- `test/m111-pick-worktree.test.js`: 3 regression tests — a licence-style failure halts, a
+  directory that is genuinely not a repo stays silent, and git missing from PATH also halts.
+
 ## [5.19.10] - 2026-09-09
 
 ### Added — M117 Graph Search Guard: the graph rule finally fires on the path work actually takes

package/README.md

@@ -1,6 +1,6 @@
 # GSD-T: Contract-Driven Development for Claude Code
 
-**v5.19.10** - A methodology for reliable, parallelizable development using Claude Code with optional Agent Teams support.
+**v5.20.10** - 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.
@@ -184,7 +184,7 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 | `/gsd-t-scan` | Deep codebase analysis → techdebt.md | Manual |
 | `/gsd-t-gap-analysis` | Requirements gap analysis — spec vs. existing code | Manual |
 | `/gsd-t-promote-debt` | Convert techdebt items to milestones | Manual |
-| `/gsd-t-estimate` | Turn any work doc (scan, requirements, feature/app spec) into a Tekyz client estimate (Google Sheet: T-Shirt Size + Team Mix) + matching PRD — supervised, with an operator-arbitrated Estimate Red Team | Manual |
+| `/gsd-t-estimate` | Turn any work doc (scan, gap-analysis sheet, requirements, feature/app spec) into a Tekyz client estimate Google Sheet — T-Shirt Size + Team Mix + Technology Stack, written by the deterministic `gsd-t estimate-sheet` tool from a JSON plan and read-back-audited against `templates/estimate-sheet-spec.md` — supervised, with an operator-arbitrated Estimate Red Team. No PRD (that is `/gsd-t-prd`) | Manual |
 | `/gsd-t-stories` | Generate a dev-team handoff doc in the Tekyz user-stories format (stories + workflows + acceptance criteria + Mermaid flow diagrams + mapped test cases) from any source | Manual |
 | `/gsd-t-demo-videos` | Narrated screen-recording walkthroughs of a running app — coverage plan, UI-driven seeding, batched TTS with a measured one-voice gate, continuous recording, mux, silence trim | Manual |
 | `/gsd-t-populate` | Auto-populate docs from existing codebase | Manual |