W3 T3/T4/E2: design-doc discovery runs bin/gstack-design-doc-find on the state root; drop DESIGN_DOC_HELD rows

scripts/resolvers/design-doc-discovery.ts

@@ -1,47 +1,26 @@
 /**
- * {{DESIGN_DOC_DISCOVERY}} — the canonical design-doc discovery block (#703).
+ * {{DESIGN_DOC_DISCOVERY}} — the canonical design-doc discovery block.
  *
- * Finds the design doc a plan review should read: newest branch-scoped doc
- * under ~/.gstack/projects/<slug>/, falling back to newest project-scoped
- * doc, then lets a repo-local doc (DESIGN.md or docs/designs/*.md) win when
- * it is at least as fresh. office-hours dual-writes docs/designs/ alongside
- * ~/.gstack, and the committed copy is what teammates see — but a stale old
- * repo doc must never shadow a newer private session.
- *
- * Single source of truth for the freshness-preference logic that previously
- * lived verbatim in plan-ceo-review, plan-eng-review, plan-devex-review, and
- * the prerequisite-skill re-check in review.ts (GStack 2 fork-port wave,
- * time-attack/gstack). Drift between copies meant plan reviews could
- * disagree about which design doc wins.
+ * One invocation of bin/gstack-design-doc-find, which owns the precedence
+ * (newest branch-scoped doc in the state root's project directory, then the
+ * newest project-scoped doc, then a repo-local DESIGN.md or docs/designs/*.md
+ * when it is at least as fresh) and resolves the state root through
+ * bin/gstack-paths. Plan reviews, autoplan and the prerequisite-skill re-check
+ * in spec-review.ts all render this one block, so they agree on which doc wins.
  *
  * The fragment carries no code fences — the {{DESIGN_DOC_DISCOVERY}} token
  * sits inside each caller's ```bash block. Callers must set $SLUG and
- * $BRANCH first (and `setopt +o nomatch` for zsh); the block sets $DESIGN
- * and prints "Design doc found: ..." or "No design doc found".
+ * $BRANCH first; the block sets $DESIGN and prints "Design doc found: ..." or
+ * "No design doc found".
  */
 
 import type { TemplateContext } from './types';
 
 /**
- * Raw canonical fragment, exported so TS resolvers (review.ts's prerequisite
- * re-check) can interpolate it into their own template strings instead of
- * embedding a drifting copy.
+ * Raw canonical fragment, exported so TS resolvers (spec-review.ts's
+ * prerequisite re-check) can interpolate it into their own template strings.
  */
-export const DESIGN_DOC_DISCOVERY_BLOCK = `_LOCALDOC=$(ls -t ~/.gstack/projects/$SLUG/*-$BRANCH-design-*.md 2>/dev/null | head -1)
-[ -z "$_LOCALDOC" ] && _LOCALDOC=$(ls -t ~/.gstack/projects/$SLUG/*-design-*.md 2>/dev/null | head -1)
-# Repo-local docs win when at least as fresh (#703): office-hours dual-writes
-# docs/designs/ alongside ~/.gstack, and the committed copy is what teammates
-# see. A stale old repo doc never shadows a newer private session.
-_REPOTOP=$(git rev-parse --show-toplevel 2>/dev/null || echo "")
-_REPODOC=""
-if [ -n "$_REPOTOP" ]; then
-  [ -f "$_REPOTOP/DESIGN.md" ] && _REPODOC="$_REPOTOP/DESIGN.md"
-  [ -z "$_REPODOC" ] && _REPODOC=$(ls -t "$_REPOTOP"/docs/designs/*.md 2>/dev/null | head -1)
-fi
-DESIGN="$_LOCALDOC"
-if [ -n "$_REPODOC" ] && { [ -z "$_LOCALDOC" ] || [ "$_REPODOC" -nt "$_LOCALDOC" ]; }; then
-  DESIGN="$_REPODOC"
-fi
+export const DESIGN_DOC_DISCOVERY_BLOCK = `DESIGN=$(~/.claude/skills/gstack/bin/gstack-design-doc-find "$SLUG" "$BRANCH")
 [ -n "$DESIGN" ] && echo "Design doc found: $DESIGN" || echo "No design doc found"`;
 
 export function generateDesignDocDiscovery(_ctx: TemplateContext): string {