cleargate 0.10.0 → 0.11.0

package/dist/cli.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  checkVerbMismatch,
+  parseFrontmatter,
+  reconcileDecomposition,
+  reconcileLifecycle
+} from "./chunk-HZPJ5QX4.js";
 import {
   AcquireError,
   acquireAccessToken,
@@ -15,10 +21,10 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "cleargate",
-  version: "0.10.0",
+  version: "0.11.0",
   private: false,
   type: "module",
-  description: "Planning framework for Claude Code agents \u2014 sprint/epic/story protocol, four-agent loop (architect/developer/qa/reporter), Karpathy-style awareness wiki.",
+  description: "Planning framework for Claude Code agents \u2014 sprint/epic/story protocol, five-role agent team (architect/developer/qa/devops/reporter), Karpathy-style awareness wiki.",
   license: "MIT",
   bin: {
     cleargate: "dist/cli.js"
@@ -62,9 +68,12 @@ var package_default = {
     build: "tsup",
     dev: "tsup --watch",
     typecheck: "tsc --noEmit",
-    pretest: "npm run build",
-    test: "vitest run",
-    "test:watch": "vitest"
+    test: "tsx --test --test-reporter=spec 'test/**/*.node.test.ts'",
+    "test:file": "tsx --test --test-reporter=spec",
+    "test:vitest": "npm run build && vitest run",
+    "test:vitest:watch": "vitest",
+    "test:node": "tsx --test --test-reporter=spec 'test/**/*.node.test.ts'",
+    "test:node:file": "tsx --test --test-reporter=spec"
   },
   dependencies: {
     "@napi-rs/keyring": "^1.2.0",
@@ -1069,53 +1078,14 @@ function getCodebaseVersion(opts) {
 // src/lib/stamp-frontmatter.ts
 import * as fs3 from "fs/promises";
 
-// src/wiki/parse-frontmatter.ts
-import yaml from "js-yaml";
-function parseFrontmatter(raw) {
-  const lines = raw.split("\n");
-  if (lines[0] !== "---") {
-    throw new Error("parseFrontmatter: input does not start with ---");
-  }
-  let closeIdx = -1;
-  for (let i = 1; i < lines.length; i++) {
-    if (lines[i] === "---") {
-      closeIdx = i;
-      break;
-    }
-  }
-  if (closeIdx === -1) {
-    throw new Error("parseFrontmatter: missing closing ---");
-  }
-  const yamlText = lines.slice(1, closeIdx).join("\n");
-  const bodyLines = lines.slice(closeIdx + 1);
-  if (bodyLines[0] === "") bodyLines.shift();
-  const body = bodyLines.join("\n");
-  if (yamlText.trim() === "") {
-    return { fm: {}, body };
-  }
-  let parsed;
-  try {
-    parsed = yaml.load(yamlText, { schema: yaml.CORE_SCHEMA });
-  } catch (err) {
-    throw new Error(`parseFrontmatter: invalid YAML: ${err.message}`);
-  }
-  if (parsed === null || parsed === void 0) {
-    return { fm: {}, body };
-  }
-  if (typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error("parseFrontmatter: frontmatter is not a YAML mapping");
-  }
-  return { fm: parsed, body };
-}
-
 // src/lib/frontmatter-yaml.ts
-import yaml2 from "js-yaml";
+import yaml from "js-yaml";
 function serializeFrontmatter(fm) {
   if (Object.keys(fm).length === 0) {
     return "---\n---";
   }
-  const yamlBody = yaml2.dump(fm, {
-    schema: yaml2.CORE_SCHEMA,
+  const yamlBody = yaml.dump(fm, {
+    schema: yaml.CORE_SCHEMA,
     lineWidth: -1,
     noRefs: true,
     noCompatMode: true,
@@ -1297,7 +1267,20 @@ var HOOK_FILES_WITH_PIN = /* @__PURE__ */ new Set([
   ".claude/hooks/stamp-and-gate.sh",
   ".claude/hooks/session-start.sh"
 ]);
-var SKIP_FILES = /* @__PURE__ */ new Set(["CLAUDE.md"]);
+var SKIP_FILES = /* @__PURE__ */ new Set(["CLAUDE.md", "MANIFEST.json"]);
+var FIRST_INSTALL_ONLY = [
+  ".gitignore",
+  ".cleargate/FLASHCARD.md",
+  /^\.cleargate\/scripts\//
+];
+function isFirstInstallOnly(relPath) {
+  for (const pattern of FIRST_INSTALL_ONLY) {
+    if (typeof pattern === "string" ? pattern === relPath : pattern.test(relPath)) {
+      return true;
+    }
+  }
+  return false;
+}
 function listFilesRecursive(dir) {
   const results = [];
   function walk(current, rel) {
@@ -1351,6 +1334,14 @@ function copyPayload(payloadDir, targetCwd, opts) {
         report.actions.push({ action: "skipped", relPath });
         continue;
       }
+      if (isFirstInstallOnly(relPath)) {
+        if (needsExec && process.platform !== "win32") {
+          fs5.chmodSync(dstPath, 493);
+        }
+        report.skipped++;
+        report.actions.push({ action: "skipped", relPath });
+        continue;
+      }
       fs5.writeFileSync(dstPath, srcBuffer);
       if (needsExec && process.platform !== "win32") {
         fs5.chmodSync(dstPath, 493);
@@ -1483,7 +1474,8 @@ var PREFIX_MAP = [
   { prefix: "SPRINT-", type: "sprint", bucket: "sprints" },
   { prefix: "PROPOSAL-", type: "proposal", bucket: "proposals" },
   { prefix: "CR-", type: "cr", bucket: "crs" },
-  { prefix: "BUG-", type: "bug", bucket: "bugs" }
+  { prefix: "BUG-", type: "bug", bucket: "bugs" },
+  { prefix: "INITIATIVE-", type: "initiative", bucket: "initiatives" }
 ];
 function deriveBucket(filename) {
   const base = filename.includes("/") ? filename.split("/").pop() : filename;
@@ -3496,7 +3488,7 @@ function loadWikiPages(wikiRoot) {
 import * as fs19 from "fs";
 import * as path19 from "path";
 import { spawnSync as spawnSync5 } from "child_process";
-import yaml3 from "js-yaml";
+import yaml2 from "js-yaml";
 
 // src/lib/work-item-type.ts
 var FM_KEY_MAP = [
@@ -3504,14 +3496,18 @@ var FM_KEY_MAP = [
   { key: "epic_id", type: "epic" },
   { key: "proposal_id", type: "proposal" },
   { key: "cr_id", type: "cr" },
-  { key: "bug_id", type: "bug" }
+  { key: "bug_id", type: "bug" },
+  { key: "initiative_id", type: "initiative" },
+  { key: "sprint_id", type: "sprint" }
 ];
 var PREFIX_MAP2 = [
   { prefix: "STORY-", type: "story" },
   { prefix: "EPIC-", type: "epic" },
   { prefix: "PROPOSAL-", type: "proposal" },
   { prefix: "CR-", type: "cr" },
-  { prefix: "BUG-", type: "bug" }
+  { prefix: "BUG-", type: "bug" },
+  { prefix: "INITIATIVE-", type: "initiative" },
+  { prefix: "SPRINT-", type: "sprint" }
 ];
 function detectWorkItemTypeFromFm(fm) {
   for (const { key, type } of FM_KEY_MAP) {
@@ -3536,7 +3532,9 @@ var WORK_ITEM_TRANSITIONS = {
   epic: ["ready-for-decomposition", "ready-for-coding"],
   story: ["ready-for-execution"],
   cr: ["ready-to-apply"],
-  bug: ["ready-for-fix"]
+  bug: ["ready-for-fix"],
+  initiative: ["ready-for-decomposition"],
+  sprint: ["ready-for-execution"]
 };
 
 // src/wiki/lint-checks.ts
@@ -3743,7 +3741,7 @@ function parseCachedGateResult(raw) {
   if (typeof raw === "string") {
     if (!raw.startsWith("{")) return null;
     try {
-      const parsed = yaml3.load(raw);
+      const parsed = yaml2.load(raw);
       if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
       const p = parsed;
       return { pass: p["pass"], failing_criteria: p["failing_criteria"], last_gate_check: p["last_gate_check"] };
@@ -3831,7 +3829,7 @@ function discoverPlainTextMentions(pages, repoRoot) {
     if (p.page.id) byId.set(p.page.id, true);
   }
   const suggestions = [];
-  const ID_PATTERN2 = /\b((?:EPIC|STORY|SPRINT|PROPOSAL|CR|BUG)-[\w-]+)\b/g;
+  const ID_PATTERN = /\b((?:EPIC|STORY|SPRINT|PROPOSAL|CR|BUG)-[\w-]+)\b/g;
   const LINK_PATTERN = /\[\[[\w-]+\]\]/g;
   for (const page of pages) {
     const relPage = path19.relative(wikiRoot, page.absPath).replace(/\\/g, "/");
@@ -3840,7 +3838,7 @@ function discoverPlainTextMentions(pages, repoRoot) {
       const inner = m[0].slice(2, -2);
       wrappedRefs.add(inner);
     }
-    for (const m of page.body.matchAll(ID_PATTERN2)) {
+    for (const m of page.body.matchAll(ID_PATTERN)) {
       const mentionedId = m[1];
       if (!byId.has(mentionedId)) continue;
       if (wrappedRefs.has(mentionedId)) continue;
@@ -3874,7 +3872,7 @@ function checkIndexBudget(repoRoot, indexTokenCeiling) {
 // src/lib/wiki-config.ts
 import * as fs20 from "fs";
 import * as path20 from "path";
-import yaml4 from "js-yaml";
+import yaml3 from "js-yaml";
 var DEFAULT_INDEX_TOKEN_CEILING = 8e3;
 var DEFAULT_BUCKET_PAGINATION_CEILING = 50;
 function loadWikiConfig(repoRoot) {
@@ -3896,7 +3894,7 @@ function loadWikiConfig(repoRoot) {
   }
   let parsed;
   try {
-    parsed = yaml4.load(raw, { schema: yaml4.CORE_SCHEMA });
+    parsed = yaml3.load(raw, { schema: yaml3.CORE_SCHEMA });
   } catch (err) {
     throw new Error(`Malformed YAML in ${configPath}: ${String(err)}`);
   }
@@ -5138,7 +5136,7 @@ async function doctorHandler(flags, cli) {
 
 // src/commands/gate.ts
 import * as fs29 from "fs";
-import * as path29 from "path";
+import * as path30 from "path";
 import { spawnSync as spawnSync8 } from "child_process";
 
 // src/commands/execution-mode.ts
@@ -5226,12 +5224,19 @@ function printInertAndExit(stdoutFn, exitFn) {
   return exitFn(0);
 }
 
+// src/lib/script-paths.ts
+import * as path28 from "path";
+function resolveCleargateScript(opts, scriptName) {
+  const cwd = opts.cwd ?? process.cwd();
+  return path28.join(cwd, ".cleargate", "scripts", scriptName);
+}
+
 // src/commands/gate.ts
-import yaml6 from "js-yaml";
+import yaml5 from "js-yaml";
 
 // src/lib/readiness-predicates.ts
 import * as fs27 from "fs";
-import * as path28 from "path";
+import * as path29 from "path";
 function parsePredicate(src) {
   const s = src.trim();
   const fmMatch = s.match(
@@ -5263,7 +5268,7 @@ function parsePredicate(src) {
     return { kind: "body-contains", needle: bodyMatch[1], negated: false };
   }
   const sectionMatch = s.match(
-    /^section\((\d+)\) has (≥|>=|==|>)(\d+) (checked-checkbox|unchecked-checkbox|listed-item)$/
+    /^section\((\d+)\) has (≥|>=|==|>)(\d+) (checked-checkbox|unchecked-checkbox|listed-item|declared-item)$/
   );
   if (sectionMatch) {
     const index = parseInt(sectionMatch[1], 10);
@@ -5291,6 +5296,9 @@ function parsePredicate(src) {
     const value = statusMatch[2].trim().replace(/^['"]|['"]$/g, "");
     return { kind: "status-of", id, value };
   }
+  if (s === "existing-surfaces-verified") {
+    return { kind: "existing-surfaces-verified" };
+  }
   throw new Error(`unsupported predicate shape: ${src}`);
 }
 function parseValue(raw) {
@@ -5319,6 +5327,8 @@ function evaluate(predicate, doc, opts) {
       return evalLinkTargetExists(parsed, opts);
     case "status-of":
       return evalStatusOf(parsed, opts, projectRoot);
+    case "existing-surfaces-verified":
+      return evalExistingSurfacesVerified(doc, projectRoot);
   }
 }
 function evalFrontmatter(parsed, doc, projectRoot) {
@@ -5395,8 +5405,14 @@ function compareValues(actual, op, expected) {
 }
 function resolveLinkedPath(ref, docAbsPath, projectRoot) {
   const candidates = [
-    path28.resolve(path28.dirname(docAbsPath), ref),
-    path28.resolve(projectRoot, ref)
+    path29.resolve(path29.dirname(docAbsPath), ref),
+    // 1. relative to citer
+    path29.resolve(projectRoot, ref),
+    // 2. project root
+    path29.resolve(projectRoot, ".cleargate", "delivery", "pending-sync", ref),
+    // 3. live
+    path29.resolve(projectRoot, ".cleargate", "delivery", "archive", ref)
+    // 4. archived
   ];
   for (const candidate of candidates) {
     if (!candidate.startsWith(projectRoot)) continue;
@@ -5533,6 +5549,9 @@ function evalSection(parsed, doc) {
     case "listed-item":
       actualCount = (sectionContent.match(/^\s*- /gm) || []).length;
       break;
+    case "declared-item":
+      actualCount = countDeclaredItems(sectionContent);
+      break;
   }
   const pass = applyCountOp(actualCount, parsed.count.op, parsed.count.n);
   const opStr = parsed.count.op === ">=" ? "\u2265" : parsed.count.op;
@@ -5549,9 +5568,39 @@ function applyCountOp(actual, op, n) {
       return actual > n;
   }
 }
+function countDeclaredItems(sectionContent) {
+  const lines = sectionContent.split("\n");
+  let count = 0;
+  let inTable = false;
+  for (const line of lines) {
+    if (/^\s*- /.test(line)) {
+      count++;
+      inTable = false;
+      continue;
+    }
+    if (/^\|.+\|/.test(line)) {
+      if (/^\|[\s\-:]+\|[\s\-:|]*$/.test(line.replace(/\s/g, ""))) {
+        inTable = true;
+        continue;
+      }
+      if (inTable) {
+        count++;
+      }
+      continue;
+    }
+    if (inTable && !/^\|/.test(line)) {
+      inTable = false;
+    }
+    if (/^(\*{1,2}|_{1,2})?[A-Z][^|*\n]*(\*{1,2}|_{1,2})?:/.test(line.trim())) {
+      count++;
+      continue;
+    }
+  }
+  return count;
+}
 function evalFileExists(parsed, projectRoot) {
-  const resolved = path28.resolve(projectRoot, parsed.path);
-  if (!resolved.startsWith(projectRoot + path28.sep) && resolved !== projectRoot) {
+  const resolved = path29.resolve(projectRoot, parsed.path);
+  if (!resolved.startsWith(projectRoot + path29.sep) && resolved !== projectRoot) {
     return {
       pass: false,
       detail: `path '${parsed.path}' resolves outside project root (sandbox violation)`
@@ -5565,7 +5614,7 @@ function evalFileExists(parsed, projectRoot) {
 }
 function evalLinkTargetExists(parsed, opts) {
   const projectRoot = opts?.projectRoot ?? process.cwd();
-  const wikiIndexPath = opts?.wikiIndexPath ?? path28.join(projectRoot, ".cleargate", "wiki", "index.md");
+  const wikiIndexPath = opts?.wikiIndexPath ?? path29.join(projectRoot, ".cleargate", "wiki", "index.md");
   if (!wikiIndexPath.startsWith(projectRoot)) {
     return { pass: false, detail: "wikiIndexPath resolves outside project root" };
   }
@@ -5582,7 +5631,7 @@ function evalLinkTargetExists(parsed, opts) {
   };
 }
 function evalStatusOf(parsed, opts, projectRoot) {
-  const wikiIndexPath = opts?.wikiIndexPath ?? path28.join(projectRoot, ".cleargate", "wiki", "index.md");
+  const wikiIndexPath = opts?.wikiIndexPath ?? path29.join(projectRoot, ".cleargate", "wiki", "index.md");
   if (!wikiIndexPath.startsWith(projectRoot)) {
     return { pass: false, detail: "wikiIndexPath resolves outside project root" };
   }
@@ -5599,7 +5648,7 @@ function evalStatusOf(parsed, opts, projectRoot) {
     return { pass: false, detail: `[[${parsed.id}]] not found in wiki index` };
   }
   const rawPath = rowMatch[1].trim();
-  const fullPath = path28.resolve(projectRoot, rawPath);
+  const fullPath = path29.resolve(projectRoot, rawPath);
   if (!fullPath.startsWith(projectRoot)) {
     return { pass: false, detail: `wiki path for ${parsed.id} resolves outside project root` };
   }
@@ -5614,10 +5663,64 @@ function evalStatusOf(parsed, opts, projectRoot) {
     detail: pass ? `status-of([[${parsed.id}]]) == ${parsed.value}` : `status-of([[${parsed.id}]]) is '${status}', expected '${parsed.value}'`
   };
 }
+function evalExistingSurfacesVerified(doc, projectRoot) {
+  const body = doc.body;
+  const rawParts = body.split(/^(?=## )/m);
+  let sectionContent;
+  for (const part of rawParts) {
+    if (part.startsWith("## Existing Surfaces")) {
+      sectionContent = part;
+      break;
+    }
+  }
+  if (!sectionContent) {
+    return {
+      pass: true,
+      detail: `not-applicable: ## Existing Surfaces section absent \u2014 reuse-audit-recorded already failing`
+    };
+  }
+  const PATH_RE = /[a-zA-Z0-9_./-]+\.[a-zA-Z]{1,5}(?::[a-zA-Z_][a-zA-Z0-9_]*)?/g;
+  const rawMatches = sectionContent.match(PATH_RE) ?? [];
+  const paths = [...new Set(rawMatches.map((m) => m.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)$/, "")))];
+  if (paths.length === 0) {
+    const SENTINEL_RE = /no overlap found|no existing surface|no prior implementation|audit returned empty/i;
+    if (SENTINEL_RE.test(sectionContent)) {
+      return {
+        pass: true,
+        detail: `## Existing Surfaces contains no path citations; sentinel phrase present \u2014 audit explicitly empty`
+      };
+    }
+    return {
+      pass: false,
+      detail: `'## Existing Surfaces' has no path citations and no "no overlap found" sentinel`
+    };
+  }
+  const missing = [];
+  for (const p of paths) {
+    const resolved = path29.resolve(projectRoot, p);
+    if (!resolved.startsWith(projectRoot + path29.sep) && resolved !== projectRoot) {
+      missing.push(p);
+      continue;
+    }
+    if (!fs27.existsSync(resolved)) {
+      missing.push(p);
+    }
+  }
+  if (missing.length > 0) {
+    return {
+      pass: false,
+      detail: `cited paths do not exist on disk: ${missing.join(", ")}`
+    };
+  }
+  return {
+    pass: true,
+    detail: `all ${paths.length} cited path${paths.length === 1 ? "" : "s"} exist on disk`
+  };
+}
 
 // src/lib/frontmatter-cache.ts
 import * as fs28 from "fs/promises";
-import yaml5 from "js-yaml";
+import yaml4 from "js-yaml";
 async function readCachedGate(absPath) {
   let raw;
   try {
@@ -5685,7 +5788,7 @@ function coerceCachedGate(val) {
   }
   if (typeof val === "string" && val.startsWith("{")) {
     try {
-      const parsed = yaml5.load(val, { schema: yaml5.CORE_SCHEMA });
+      const parsed = yaml4.load(val, { schema: yaml4.CORE_SCHEMA });
       if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
       const p = parsed;
       return {
@@ -5708,7 +5811,7 @@ function loadGateBlocks(gatesDocPath) {
   let match;
   while ((match = fenceRe.exec(raw)) !== null) {
     const yamlContent = match[1];
-    const parsed = yaml6.load(yamlContent);
+    const parsed = yaml5.load(yamlContent);
     const block = Array.isArray(parsed) ? parsed[0] : parsed;
     if (block && typeof block === "object" && "work_item_type" in block && "transition" in block && "severity" in block && "criteria" in block) {
       blocks.push(block);
@@ -5737,7 +5840,7 @@ async function gateCheckHandler(file, opts, cli) {
   const exitFn = cli?.exit ?? ((code) => process.exit(code));
   const cwd = cli?.cwd ?? process.cwd();
   const nowFn = cli?.now ?? (() => /* @__PURE__ */ new Date());
-  const absPath = path29.isAbsolute(file) ? file : path29.resolve(cwd, file);
+  const absPath = path30.isAbsolute(file) ? file : path30.resolve(cwd, file);
   if (!fs29.existsSync(absPath)) {
     stderrFn(`[cleargate gate] error: file not found: ${absPath}`);
     return exitFn(1);
@@ -5763,7 +5866,7 @@ async function gateCheckHandler(file, opts, cli) {
     return exitFn(1);
   }
   const projectRoot = cwd;
-  const gatesDocPath = cli?.gatesDocPath ?? path29.join(projectRoot, ".cleargate", "knowledge", "readiness-gates.md");
+  const gatesDocPath = cli?.gatesDocPath ?? path30.join(projectRoot, ".cleargate", "knowledge", "readiness-gates.md");
   if (!fs29.existsSync(gatesDocPath)) {
     stderrFn(`[cleargate gate] error: readiness-gates.md not found at: ${gatesDocPath}`);
     return exitFn(1);
@@ -5787,7 +5890,6 @@ async function gateCheckHandler(file, opts, cli) {
   const wikiIndexPath = cli?.wikiIndexPath;
   const parsedDoc = { fm, body, absPath };
   const evalOpts = { projectRoot, ...wikiIndexPath ? { wikiIndexPath } : {} };
-  const failingCriteria = [];
   const allResults = [];
   for (const criterion of gate2.criteria) {
     let result;
@@ -5796,9 +5898,32 @@ async function gateCheckHandler(file, opts, cli) {
     } catch (err) {
       result = { pass: false, detail: `predicate error: ${String(err)}` };
     }
-    allResults.push({ id: criterion.id, ...result });
-    if (!result.pass) {
-      failingCriteria.push({ id: criterion.id, detail: result.detail });
+    allResults.push({ id: criterion.id, ...result, or_group: criterion.or_group });
+  }
+  const failingCriteria = [];
+  const orGroups = /* @__PURE__ */ new Map();
+  for (const r of allResults) {
+    if (r.or_group) {
+      const existing = orGroups.get(r.or_group) ?? [];
+      existing.push(r);
+      orGroups.set(r.or_group, existing);
+    }
+  }
+  for (const r of allResults) {
+    if (r.or_group) {
+      const groupMembers = orGroups.get(r.or_group);
+      const isFirstMember = groupMembers[0].id === r.id;
+      if (isFirstMember) {
+        const anyPasses = groupMembers.some((m) => m.pass);
+        if (!anyPasses) {
+          const details = groupMembers.map((m) => `${m.id}: ${m.detail}`).join("; ");
+          failingCriteria.push({ id: r.or_group, detail: `OR-group failed \u2014 all alternatives failed: ${details}` });
+        }
+      }
+    } else {
+      if (!r.pass) {
+        failingCriteria.push({ id: r.id, detail: r.detail });
+      }
     }
   }
   const overallPass = failingCriteria.length === 0;
@@ -5815,15 +5940,15 @@ async function gateCheckHandler(file, opts, cli) {
   if (overallPass) {
     stdoutFn(`\u2705 ${detectedType}.${transition} passed (${gate2.criteria.length} criteria)`);
   } else {
-    for (const r of allResults) {
-      if (!r.pass) {
-        if (isAdvisory) {
-          stdoutFn(`\u26A0 ${r.id}: ${r.detail} (advisory)`);
-        } else {
-          stdoutFn(`\u274C ${r.id}: ${r.detail}`);
-        }
+    for (const fc of failingCriteria) {
+      if (isAdvisory) {
+        stdoutFn(`\u26A0 ${fc.id}: ${fc.detail} (advisory)`);
+      } else {
+        stdoutFn(`\u274C ${fc.id}: ${fc.detail}`);
       }
-      if (opts.verbose) {
+    }
+    if (opts.verbose) {
+      for (const r of allResults) {
         stdoutFn(`  [${r.pass ? "pass" : "fail"}] ${r.id}: ${r.detail}`);
       }
     }
@@ -5837,7 +5962,7 @@ async function gateExplainHandler(file, cli) {
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? ((code) => process.exit(code));
   const cwd = cli?.cwd ?? process.cwd();
-  const absPath = path29.isAbsolute(file) ? file : path29.resolve(cwd, file);
+  const absPath = path30.isAbsolute(file) ? file : path30.resolve(cwd, file);
   if (!fs29.existsSync(absPath)) {
     stderrFn(`[cleargate gate] error: file not found: ${absPath}`);
     return exitFn(1);
@@ -5870,7 +5995,7 @@ async function gateExplainHandler(file, cli) {
 function resolveRunScriptForGate(opts) {
   if (opts.runScriptPath) return opts.runScriptPath;
   const cwd = opts.cwd ?? process.cwd();
-  return path29.join(cwd, ".cleargate", "scripts", "run_script.sh");
+  return path30.join(cwd, ".cleargate", "scripts", "run_script.sh");
 }
 function gateQaHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
@@ -5886,9 +6011,11 @@ function gateQaHandler(opts, cli) {
     return printInertAndExit(stdoutFn, exitFn);
   }
   const runScript = resolveRunScriptForGate(cli ?? {});
+  const qaCwd = cli?.cwd ?? process.cwd();
+  const gateRunnerPath = resolveCleargateScript({ cwd: qaCwd }, "pre_gate_runner.sh");
   const result = spawnFn(
     "bash",
-    [runScript, "pre_gate_runner.sh", "qa", opts.worktree, opts.branch],
+    [runScript, "bash", gateRunnerPath, "qa", opts.worktree, opts.branch],
     { stdio: "inherit" }
   );
   if (result.error) {
@@ -5912,9 +6039,11 @@ function gateArchHandler(opts, cli) {
     return printInertAndExit(stdoutFn, exitFn);
   }
   const runScript = resolveRunScriptForGate(cli ?? {});
+  const archCwd = cli?.cwd ?? process.cwd();
+  const archGateRunnerPath = resolveCleargateScript({ cwd: archCwd }, "pre_gate_runner.sh");
   const result = spawnFn(
     "bash",
-    [runScript, "pre_gate_runner.sh", "arch", opts.worktree, opts.branch],
+    [runScript, "bash", archGateRunnerPath, "arch", opts.worktree, opts.branch],
     { stdio: "inherit" }
   );
   if (result.error) {
@@ -5962,319 +6091,10 @@ function gateRunHandler(name, opts, cli) {
 }
 
 // src/commands/sprint.ts
-import * as fs31 from "fs";
-import * as path31 from "path";
-import { spawnSync as spawnSync11, execSync as execSync2 } from "child_process";
-import yaml7 from "js-yaml";
-
-// src/lib/lifecycle-reconcile.ts
 import * as fs30 from "fs";
-import * as path30 from "path";
-import { spawnSync as spawnSync10 } from "child_process";
-var VERB_STATUS_MAP = {
-  feat: {
-    types: ["STORY", "EPIC", "CR"],
-    expected: ["Done", "Completed"]
-  },
-  fix: {
-    types: ["BUG", "HOTFIX"],
-    expected: ["Verified", "Done", "Completed"]
-  }
-};
-var ID_PATTERN = /\b(STORY-\d{3}-\d{2}|(CR|BUG|EPIC|HOTFIX)-\d{3}|(PROPOSAL|PROP)-\d{3})\b/g;
-function normalizeId(raw) {
-  return raw.replace(/^PROP-(\d+)$/, "PROPOSAL-$1");
-}
-function idType(id) {
-  if (/^STORY-\d{3}-\d{2}$/.test(id)) return "STORY";
-  if (/^CR-\d{3}$/.test(id)) return "CR";
-  if (/^BUG-\d{3}$/.test(id)) return "BUG";
-  if (/^EPIC-\d{3}$/.test(id)) return "EPIC";
-  if (/^PROPOSAL-\d{3}$/.test(id)) return "PROPOSAL";
-  if (/^HOTFIX-\d{3}$/.test(id)) return "HOTFIX";
-  return null;
-}
-function parseCommitMessage(msg) {
-  const lines = msg.split("\n");
-  const subject = lines[0] ?? "";
-  let firstBodyLine = "";
-  for (let i = 1; i < lines.length; i++) {
-    if (lines[i]?.trim()) {
-      firstBodyLine = lines[i];
-      break;
-    }
-  }
-  const verbMatch = /^(\w+)[(!]/.exec(subject) ?? /^(\w+):/.exec(subject);
-  const verb = verbMatch ? verbMatch[1].toLowerCase() : "";
-  const searchText = subject + (firstBodyLine ? "\n" + firstBodyLine : "");
-  const results = [];
-  const seen = /* @__PURE__ */ new Set();
-  let m;
-  ID_PATTERN.lastIndex = 0;
-  while ((m = ID_PATTERN.exec(searchText)) !== null) {
-    const rawId = m[0];
-    const id = normalizeId(rawId);
-    if (seen.has(id)) continue;
-    seen.add(id);
-    const type = idType(id);
-    if (!type) continue;
-    results.push({ verb, id, type });
-  }
-  return results;
-}
-function findArtifactFile(deliveryRoot, id) {
-  const prefix = `${id}_`;
-  const dirs = [
-    { rel: "pending-sync", inArchive: false },
-    { rel: "archive", inArchive: true }
-  ];
-  for (const { rel, inArchive } of dirs) {
-    const dir = path30.join(deliveryRoot, rel);
-    let entries;
-    try {
-      entries = fs30.readdirSync(dir);
-    } catch {
-      continue;
-    }
-    const match = entries.find(
-      (e) => (e.startsWith(prefix) || e === `${id}.md`) && e.endsWith(".md")
-    );
-    if (match) {
-      const absPath = path30.join(dir, match);
-      return { absPath, inArchive, relPath: `${rel}/${match}` };
-    }
-  }
-  return null;
-}
-function readArtifactStatus(absPath) {
-  let raw;
-  try {
-    raw = fs30.readFileSync(absPath, "utf8");
-  } catch {
-    return { status: null, carryOver: false };
-  }
-  try {
-    const { fm } = parseFrontmatter(raw);
-    const status = typeof fm["status"] === "string" ? fm["status"] : null;
-    const carryOver = fm["carry_over"] === true;
-    return { status, carryOver };
-  } catch {
-    return { status: null, carryOver: false };
-  }
-}
-function reconcileLifecycle(opts) {
-  const { since, until = /* @__PURE__ */ new Date(), deliveryRoot, repoRoot } = opts;
-  const gitRunner = opts.gitRunner ?? ((cmd, args) => {
-    const result = spawnSync10(cmd, args, { encoding: "utf8", cwd: repoRoot });
-    return result.stdout ?? "";
-  });
-  const sinceIso = since.toISOString();
-  const untilIso = until.toISOString();
-  const logOutput = gitRunner("git", [
-    "log",
-    `--after=${sinceIso}`,
-    `--before=${untilIso}`,
-    "--format=%H%x00%s%x00%b%x00---COMMIT---",
-    "--"
-  ]);
-  const idToItem = /* @__PURE__ */ new Map();
-  const cleanIds = /* @__PURE__ */ new Set();
-  if (logOutput.trim()) {
-    const rawCommits = logOutput.split("---COMMIT---\n").filter((c) => c.trim());
-    for (const raw of rawCommits) {
-      const [sha = "", subject = "", body = ""] = raw.split("\0");
-      const trimSha = sha.trim();
-      const trimSubject = subject.trim();
-      const trimBody = body.trim();
-      if (!trimSha || !trimSubject) continue;
-      const commitMsg = trimSubject + (trimBody ? "\n\n" + trimBody : "");
-      const parsed = parseCommitMessage(commitMsg);
-      for (const { verb, id, type } of parsed) {
-        if (verb === "merge" || verb === "chore" || verb === "docs" || verb === "refactor" || verb === "test" || verb === "file" || verb === "plan") {
-          continue;
-        }
-        if (type === "PROPOSAL") continue;
-        const verbConfig = VERB_STATUS_MAP[verb];
-        if (!verbConfig) continue;
-        const found = findArtifactFile(deliveryRoot, id);
-        if (!found) {
-          continue;
-        }
-        const { status, carryOver } = readArtifactStatus(found.absPath);
-        if (carryOver) continue;
-        let expectedStatuses;
-        if (verb === "feat" && type === "BUG") {
-          expectedStatuses = ["Verified", "Done", "Completed"];
-        } else if (!verbConfig.types.includes(type)) {
-          continue;
-        } else {
-          expectedStatuses = verbConfig.expected;
-        }
-        const isTerminal = status !== null && expectedStatuses.includes(status);
-        const isArchived = found.inArchive;
-        if (isTerminal && isArchived) {
-          cleanIds.add(id);
-          idToItem.delete(id);
-        } else if (!idToItem.has(id)) {
-          const expectedStr = expectedStatuses[0] ?? "Done";
-          idToItem.set(id, {
-            id,
-            type,
-            expected_status: expectedStr,
-            actual_status: status,
-            file_path: found.relPath,
-            in_archive: isArchived,
-            commit_shas: [trimSha],
-            carry_over: carryOver
-          });
-        } else {
-          const existing = idToItem.get(id);
-          if (!existing.commit_shas.includes(trimSha)) {
-            existing.commit_shas.push(trimSha);
-          }
-        }
-      }
-    }
-  }
-  for (const id of cleanIds) {
-    idToItem.delete(id);
-  }
-  const drift = Array.from(idToItem.values());
-  return { drift, clean: cleanIds.size };
-}
-function reconcileDecomposition(opts) {
-  const { sprintPlanPath, deliveryRoot } = opts;
-  let raw;
-  try {
-    raw = fs30.readFileSync(sprintPlanPath, "utf8");
-  } catch {
-    return { missing: [], clean: 0 };
-  }
-  let fm;
-  try {
-    ({ fm } = parseFrontmatter(raw));
-  } catch {
-    return { missing: [], clean: 0 };
-  }
-  const epics = Array.isArray(fm["epics"]) ? fm["epics"].map(String) : [];
-  const proposals = Array.isArray(fm["proposals"]) ? fm["proposals"].map(String) : [];
-  const pendingDir = path30.join(deliveryRoot, "pending-sync");
-  const archiveDir = path30.join(deliveryRoot, "archive");
-  function listMdFiles(dir) {
-    try {
-      return fs30.readdirSync(dir).filter((f) => f.endsWith(".md"));
-    } catch {
-      return [];
-    }
-  }
-  const pendingFiles = listMdFiles(pendingDir);
-  const archiveFiles = listMdFiles(archiveDir);
-  const allFiles = [...pendingFiles, ...archiveFiles];
-  const missing = [];
-  let clean = 0;
-  for (const epicId of epics) {
-    const epicFile = allFiles.find(
-      (f) => f.startsWith(`${epicId}_`) || f === `${epicId}.md`
-    );
-    if (!epicFile) {
-      missing.push({
-        id: epicId,
-        type: "epic",
-        reason: "file-missing",
-        expected_files: [`pending-sync/${epicId}_<name>.md`]
-      });
-      continue;
-    }
-    const childStories = findChildStories(
-      epicId,
-      pendingDir,
-      pendingFiles,
-      archiveDir,
-      archiveFiles
-    );
-    if (childStories.length === 0) {
-      missing.push({
-        id: epicId,
-        type: "epic",
-        reason: "no-child-stories",
-        expected_files: [
-          `pending-sync/${epicId.replace("EPIC-", "STORY-")}-01_<name>.md`
-        ]
-      });
-    } else {
-      clean++;
-    }
-  }
-  for (const proposalId of proposals) {
-    const decomposedEpic = findDecomposedEpic(
-      proposalId,
-      pendingDir,
-      pendingFiles
-    );
-    if (!decomposedEpic) {
-      missing.push({
-        id: proposalId,
-        type: "proposal",
-        reason: "no-decomposed-epic",
-        expected_files: [`pending-sync/EPIC-<NNN>_<name>.md with context_source citing ${proposalId}`]
-      });
-    } else {
-      clean++;
-    }
-  }
-  return { missing, clean };
-}
-function findChildStories(epicId, pendingDir, pendingFiles, archiveDir, archiveFiles) {
-  const results = [];
-  const epicNumMatch = /^EPIC-(\d+)$/.exec(epicId);
-  if (!epicNumMatch) return results;
-  const epicNum = epicNumMatch[1];
-  const storyPrefix = `STORY-${epicNum}-`;
-  for (const [files, dir] of [[pendingFiles, pendingDir], [archiveFiles, archiveDir]]) {
-    for (const f of files) {
-      if (!f.startsWith(storyPrefix) && !f.startsWith("STORY-")) continue;
-      if (!f.includes(storyPrefix)) continue;
-      const absPath = path30.join(dir, f);
-      try {
-        const raw = fs30.readFileSync(absPath, "utf8");
-        const { fm } = parseFrontmatter(raw);
-        const parentRef = fm["parent_epic_ref"];
-        if (parentRef === epicId) {
-          results.push(f);
-        }
-      } catch {
-      }
-    }
-  }
-  return results;
-}
-function findDecomposedEpic(proposalId, pendingDir, pendingFiles) {
-  for (const f of pendingFiles) {
-    if (!f.startsWith("EPIC-")) continue;
-    const absPath = path30.join(pendingDir, f);
-    try {
-      const raw = fs30.readFileSync(absPath, "utf8");
-      const { fm } = parseFrontmatter(raw);
-      const contextSource = fm["context_source"];
-      if (typeof contextSource === "string" && contextSource.includes(proposalId)) {
-        return f;
-      }
-    } catch {
-    }
-  }
-  return null;
-}
-function checkVerbMismatch(verb, type) {
-  if (verb === "feat" && type === "BUG") {
-    return `verb 'feat' unusual for BUG; expected 'fix'`;
-  }
-  if (verb === "fix" && (type === "STORY" || type === "EPIC" || type === "CR")) {
-    return `verb 'fix' unusual for ${type}; expected 'feat'`;
-  }
-  return null;
-}
-
-// src/commands/sprint.ts
+import * as path31 from "path";
+import { spawnSync as spawnSync10, execSync as execSync2 } from "child_process";
+import yaml6 from "js-yaml";
 var TERMINAL_STATUSES2 = /* @__PURE__ */ new Set(["Completed", "Done", "Abandoned", "Closed", "Resolved"]);
 function resolveRunScript(opts) {
   if (opts.runScriptPath) return opts.runScriptPath;
@@ -6288,7 +6108,7 @@ function sprintInitHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? defaultExit;
-  const spawnFn = cli?.spawnFn ?? spawnSync11;
+  const spawnFn = cli?.spawnFn ?? spawnSync10;
   const cwd = cli?.cwd ?? process.cwd();
   const allowDrift = opts.allowDrift ?? cli?.allowDrift ?? false;
   const mode = readSprintExecutionMode(opts.sprintId, {
@@ -6303,13 +6123,13 @@ function sprintInitHandler(opts, cli) {
   let sprintPlanPath = null;
   const pendingDir = path31.join(deliveryRoot, "pending-sync");
   try {
-    const entries = fs31.readdirSync(pendingDir);
+    const entries = fs30.readdirSync(pendingDir);
     const sprintFile = entries.find(
       (e) => (e.startsWith(`${opts.sprintId}_`) || e === `${opts.sprintId}.md`) && e.endsWith(".md")
     );
     if (sprintFile) {
       sprintPlanPath = path31.join(pendingDir, sprintFile);
-      const raw = fs31.readFileSync(sprintPlanPath, "utf8");
+      const raw = fs30.readFileSync(sprintPlanPath, "utf8");
       const { fm } = parseFileFrontmatter(raw);
       if (fm["lifecycle_init_mode"] === "block") {
         lifecycleInitMode = "block";
@@ -6343,7 +6163,7 @@ function sprintInitHandler(opts, cli) {
         stderrFn("[cleargate sprint init] lifecycle drift waived via --allow-drift flag");
         if (sprintPlanPath) {
           try {
-            const rawSprint = fs31.readFileSync(sprintPlanPath, "utf8");
+            const rawSprint = fs30.readFileSync(sprintPlanPath, "utf8");
             const { fm, body } = parseFileFrontmatter(rawSprint);
             const waiverLine = `lifecycle waiver: ${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]} for ${lifecycleResult.drift.map((d) => d.id).join(", ")}`;
             const currentContextSource = typeof fm["context_source"] === "string" ? fm["context_source"] : "";
@@ -6392,8 +6212,12 @@ ${waiverLine}` : waiverLine;
     }
   }
   const runScript = resolveRunScript(cli ?? {});
-  const args = ["init_sprint.mjs", opts.sprintId, "--stories", opts.stories];
-  const result = spawnFn("bash", [runScript, ...args], { stdio: "inherit" });
+  const scriptPath = resolveCleargateScript({ cwd }, "init_sprint.mjs");
+  const result = spawnFn(
+    "bash",
+    [runScript, "node", scriptPath, opts.sprintId, "--stories", opts.stories],
+    { stdio: "inherit" }
+  );
   if (result.error) {
     stderrFn(`[cleargate sprint init] error: ${result.error.message}`);
     return exitFn(1);
@@ -6408,7 +6232,7 @@ function sprintCloseHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? defaultExit;
-  const spawnFn = cli?.spawnFn ?? spawnSync11;
+  const spawnFn = cli?.spawnFn ?? spawnSync10;
   const mode = readSprintExecutionMode(opts.sprintId, {
     sprintFilePath: cli?.sprintFilePath,
     cwd: cli?.cwd
@@ -6417,11 +6241,13 @@ function sprintCloseHandler(opts, cli) {
     return printInertAndExit(stdoutFn, exitFn);
   }
   const runScript = resolveRunScript(cli ?? {});
-  const args = ["close_sprint.mjs", opts.sprintId];
+  const closeCwd = cli?.cwd ?? process.cwd();
+  const closeScriptPath = resolveCleargateScript({ cwd: closeCwd }, "close_sprint.mjs");
+  const closeArgs = [runScript, "node", closeScriptPath, opts.sprintId];
   if (opts.assumeAck === true) {
-    args.push("--assume-ack");
+    closeArgs.push("--assume-ack");
   }
-  const result = spawnFn("bash", [runScript, ...args], { stdio: "inherit" });
+  const result = spawnFn("bash", closeArgs, { stdio: "inherit" });
   if (result.error) {
     stderrFn(`[cleargate sprint close] error: ${result.error.message}`);
     return exitFn(1);
@@ -6442,12 +6268,12 @@ function reconcileLifecycleCliHandler(opts, cli) {
   } else {
     try {
       const pendingDir = path31.join(deliveryRoot, "pending-sync");
-      const entries = fs31.readdirSync(pendingDir);
+      const entries = fs30.readdirSync(pendingDir);
       const sprintFile = entries.find(
         (e) => (e.startsWith(`${opts.sprintId}_`) || e === `${opts.sprintId}.md`) && e.endsWith(".md")
       );
       if (sprintFile) {
-        const raw = fs31.readFileSync(path31.join(pendingDir, sprintFile), "utf8");
+        const raw = fs30.readFileSync(path31.join(pendingDir, sprintFile), "utf8");
         const { fm } = parseFileFrontmatter(raw);
         const startDate = fm["start_date"];
         since = typeof startDate === "string" ? new Date(startDate) : new Date(Date.now() - 90 * 24 * 60 * 60 * 1e3);
@@ -6504,7 +6330,7 @@ function parseFileFrontmatter(raw) {
   if (yamlText.trim() === "") return { fm: {}, body };
   let parsed;
   try {
-    parsed = yaml7.load(yamlText, { schema: yaml7.CORE_SCHEMA });
+    parsed = yaml6.load(yamlText, { schema: yaml6.CORE_SCHEMA });
   } catch {
     return { fm: {}, body };
   }
@@ -6512,8 +6338,8 @@ function parseFileFrontmatter(raw) {
   return { fm: parsed, body };
 }
 function serializeFileContent(fm, body) {
-  const yamlBody = yaml7.dump(fm, {
-    schema: yaml7.CORE_SCHEMA,
+  const yamlBody = yaml6.dump(fm, {
+    schema: yaml6.CORE_SCHEMA,
     lineWidth: -1,
     noRefs: true,
     noCompatMode: true,
@@ -6528,8 +6354,8 @@ ${body}`;
 }
 function atomicWriteStr(filePath, content) {
   const tmp = `${filePath}.tmp.${process.pid}`;
-  fs31.writeFileSync(tmp, content, "utf8");
-  fs31.renameSync(tmp, filePath);
+  fs30.writeFileSync(tmp, content, "utf8");
+  fs30.renameSync(tmp, filePath);
 }
 function deriveSprintBranchForArchive(sprintId) {
   const match = /^SPRINT-(\d+)/.exec(sprintId);
@@ -6543,7 +6369,7 @@ function stampFile(raw, status, completedAt) {
   return serializeFileContent(fm, body);
 }
 function stampSprintClose(sprintPath, now) {
-  const previousContent = fs31.readFileSync(sprintPath, "utf8");
+  const previousContent = fs30.readFileSync(sprintPath, "utf8");
   const { fm, body } = parseFileFrontmatter(previousContent);
   const currentStatus = typeof fm["status"] === "string" ? fm["status"] : "";
   const alreadyTerminal = TERMINAL_STATUSES2.has(currentStatus);
@@ -6570,7 +6396,7 @@ async function sprintArchiveHandler(opts, cli) {
     const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
     const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
     const exitFn = cli?.exit ?? defaultExit;
-    const spawnFn = cli?.spawnFn ?? spawnSync11;
+    const spawnFn = cli?.spawnFn ?? spawnSync10;
     const cwd = cli?.cwd ?? process.cwd();
     const wikiBuildFn = cli?.wikiBuildFn ?? (async (wCwd, wStdout) => {
       const fakeExit = (code) => {
@@ -6604,13 +6430,13 @@ async function sprintArchiveHandler(opts, cli) {
       return printInertAndExit(stdoutFn, exitFn);
     }
     const stateFile = path31.join(cwd, ".cleargate", "sprint-runs", opts.sprintId, "state.json");
-    if (!fs31.existsSync(stateFile)) {
+    if (!fs30.existsSync(stateFile)) {
       stderrFn(`[cleargate sprint archive] state.json not found at ${stateFile}`);
       return exitFn(1);
     }
     let state2;
     try {
-      state2 = JSON.parse(fs31.readFileSync(stateFile, "utf8"));
+      state2 = JSON.parse(fs30.readFileSync(stateFile, "utf8"));
     } catch (err) {
       stderrFn(`[cleargate sprint archive] failed to parse state.json: ${err.message}`);
       return exitFn(1);
@@ -6625,15 +6451,15 @@ async function sprintArchiveHandler(opts, cli) {
     const pendingDir = path31.join(cwd, ".cleargate", "delivery", "pending-sync");
     const archiveDir = path31.join(cwd, ".cleargate", "delivery", "archive");
     let sprintFile = null;
-    for (const entry of fs31.readdirSync(pendingDir)) {
+    for (const entry of fs30.readdirSync(pendingDir)) {
       if ((entry.startsWith(`${opts.sprintId}_`) || entry === `${opts.sprintId}.md`) && entry.endsWith(".md")) {
         sprintFile = path31.join(pendingDir, entry);
         break;
       }
     }
     let epicIds = [];
-    if (sprintFile && fs31.existsSync(sprintFile)) {
-      const { fm } = parseFileFrontmatter(fs31.readFileSync(sprintFile, "utf8"));
+    if (sprintFile && fs30.existsSync(sprintFile)) {
+      const { fm } = parseFileFrontmatter(fs30.readFileSync(sprintFile, "utf8"));
       const epics = fm["epics"];
       if (Array.isArray(epics)) {
         epicIds = epics.map(String);
@@ -6648,7 +6474,7 @@ async function sprintArchiveHandler(opts, cli) {
       });
     }
     for (const epicId of epicIds) {
-      for (const entry of fs31.readdirSync(pendingDir)) {
+      for (const entry of fs30.readdirSync(pendingDir)) {
         if ((entry.startsWith(`${epicId}_`) || entry === `${epicId}.md`) && entry.endsWith(".md")) {
           plan.push({
             src: path31.join(pendingDir, entry),
@@ -6660,7 +6486,7 @@ async function sprintArchiveHandler(opts, cli) {
       }
       const storyKeys = storyKeysForEpic(stateStories, epicId);
       for (const storyId of storyKeys) {
-        for (const entry of fs31.readdirSync(pendingDir)) {
+        for (const entry of fs30.readdirSync(pendingDir)) {
           if ((entry.startsWith(`${storyId}_`) || entry === `${storyId}.md`) && entry.endsWith(".md")) {
             plan.push({
               src: path31.join(pendingDir, entry),
@@ -6675,13 +6501,13 @@ async function sprintArchiveHandler(opts, cli) {
     const storyIdsInState = new Set(Object.keys(stateStories));
     const planSrcs = new Set(plan.map((p) => p.src));
     const orphans = [];
-    for (const entry of fs31.readdirSync(pendingDir)) {
+    for (const entry of fs30.readdirSync(pendingDir)) {
       if (!entry.startsWith("STORY-") || !entry.endsWith(".md")) continue;
       const candidate = path31.join(pendingDir, entry);
       if (planSrcs.has(candidate)) continue;
       let raw;
       try {
-        raw = fs31.readFileSync(candidate, "utf8");
+        raw = fs30.readFileSync(candidate, "utf8");
       } catch {
         continue;
       }
@@ -6719,8 +6545,8 @@ async function sprintArchiveHandler(opts, cli) {
     }
     let sprintFileSnapshot = null;
     const wikiRoot = path31.join(cwd, ".cleargate", "wiki");
-    const wikiInitialised = fs31.existsSync(wikiRoot);
-    if (sprintFile && fs31.existsSync(sprintFile)) {
+    const wikiInitialised = fs30.existsSync(wikiRoot);
+    if (sprintFile && fs30.existsSync(sprintFile)) {
       const { previousContent } = stampSprintClose(sprintFile, () => completedAt);
       sprintFileSnapshot = previousContent;
       if (wikiInitialised) {
@@ -6747,15 +6573,15 @@ async function sprintArchiveHandler(opts, cli) {
       }
     }
     for (const entry of plan) {
-      if (!fs31.existsSync(entry.src)) {
+      if (!fs30.existsSync(entry.src)) {
         stderrFn(`[cleargate sprint archive] source not found: ${entry.src} \u2014 skipping`);
         continue;
       }
-      const raw = fs31.readFileSync(entry.src, "utf8");
+      const raw = fs30.readFileSync(entry.src, "utf8");
       const stamped = stampFile(raw, entry.status, completedAt);
       const dest = path31.join(archiveDir, entry.destName);
       atomicWriteStr(entry.src, stamped);
-      fs31.renameSync(entry.src, dest);
+      fs30.renameSync(entry.src, dest);
       stdoutFn(`archived: ${entry.destName}`);
     }
     try {
@@ -6819,9 +6645,9 @@ function checkPrevSprintCompleted(sprintId, cwd) {
   let resolvedPrevId = prevId;
   for (const pid of [prevId, prevIdAlt]) {
     const stateFile = path31.join(sprintRunsBase, pid, "state.json");
-    if (fs31.existsSync(stateFile)) {
+    if (fs30.existsSync(stateFile)) {
       try {
-        const raw = fs31.readFileSync(stateFile, "utf8");
+        const raw = fs30.readFileSync(stateFile, "utf8");
         stateJson = JSON.parse(raw);
         resolvedPrevId = pid;
         break;
@@ -6928,10 +6754,10 @@ function findSprintFile(sprintId, cwd) {
     path31.join(cwd, ".cleargate", "delivery", "archive")
   ];
   for (const dir of searchDirs) {
-    if (!fs31.existsSync(dir)) continue;
+    if (!fs30.existsSync(dir)) continue;
     let entries;
     try {
-      entries = fs31.readdirSync(dir);
+      entries = fs30.readdirSync(dir);
     } catch {
       continue;
     }
@@ -6953,7 +6779,7 @@ function findWorkItemFileLocal(cwd, workItemId) {
   for (const dir of searchDirs) {
     let entries;
     try {
-      entries = fs31.readdirSync(dir);
+      entries = fs30.readdirSync(dir);
     } catch {
       continue;
     }
@@ -6965,7 +6791,7 @@ function findWorkItemFileLocal(cwd, workItemId) {
 function readCachedGateSync(absPath) {
   let raw;
   try {
-    raw = fs31.readFileSync(absPath, "utf8");
+    raw = fs30.readFileSync(absPath, "utf8");
   } catch {
     return null;
   }
@@ -7041,7 +6867,7 @@ function checkPerItemReadinessGates(sprintId, cwd, execFn, mode) {
     let fm;
     let raw;
     try {
-      raw = fs31.readFileSync(absPath, "utf8");
+      raw = fs30.readFileSync(absPath, "utf8");
       ({ fm } = parseFrontmatter(raw));
     } catch {
       totalChecked++;
@@ -7085,7 +6911,7 @@ function checkPerItemReadinessGates(sprintId, cwd, execFn, mode) {
   let sprintRaw;
   let sprintFm = {};
   try {
-    sprintRaw = fs31.readFileSync(sprintFilePath, "utf8");
+    sprintRaw = fs30.readFileSync(sprintFilePath, "utf8");
     ({ fm: sprintFm } = parseFrontmatter(sprintRaw));
   } catch {
   }
@@ -7126,6 +6952,41 @@ function checkPerItemReadinessGates(sprintId, cwd, execFn, mode) {
    Run: cleargate gate check <file> -v   for each`
   };
 }
+function refreshScopedGateCaches(sprintId, cwd, execFn) {
+  const result = { refreshed: [], skipped: [], errors: [] };
+  const sprintFilePath = findSprintFile(sprintId, cwd);
+  if (!sprintFilePath) {
+    return result;
+  }
+  const childIds = extractInScopeWorkItemIds(sprintFilePath, cwd, execFn);
+  if (!childIds || childIds.length === 0) {
+    return result;
+  }
+  for (const id of childIds) {
+    const absPath = findWorkItemFileLocal(cwd, id);
+    if (!absPath) {
+      continue;
+    }
+    let status = "";
+    try {
+      const raw = fs30.readFileSync(absPath, "utf8");
+      const { fm } = parseFrontmatter(raw);
+      status = String(fm["status"] ?? "");
+    } catch {
+    }
+    if (TERMINAL_STATUSES2.has(status)) {
+      result.skipped.push(id);
+      continue;
+    }
+    try {
+      execFn(`cleargate gate check "${absPath}"`, { cwd, encoding: "utf8" });
+      result.refreshed.push(id);
+    } catch (err) {
+      result.errors.push({ id, message: String(err) });
+    }
+  }
+  return result;
+}
 function emitPunchList(sprintId, results, stdoutFn, stderrFn) {
   const failures = results.filter((r) => !r.pass && !r.skipped);
   if (failures.length === 0) {
@@ -7157,6 +7018,13 @@ function sprintPreflightHandler(opts, cli) {
   }
   const execFn = cli?.execFn ?? ((cmd, execOpts) => execSync2(cmd, { ...execOpts, stdio: "pipe" }));
   const mode = readSprintExecutionMode(opts.sprintId, { cwd });
+  const refresh = refreshScopedGateCaches(opts.sprintId, cwd, execFn);
+  stdoutFn(`Step 0: refreshed ${refresh.refreshed.length} items, ${refresh.errors.length} errors.
+`);
+  for (const e of refresh.errors) {
+    stdoutFn(`  - ${e.id}: ${e.message}
+`);
+  }
   const results = [
     checkPrevSprintCompleted(opts.sprintId, cwd),
     checkNoLeftoverWorktrees(cwd, execFn),
@@ -7173,9 +7041,9 @@ function sprintPreflightHandler(opts, cli) {
 }
 
 // src/commands/story.ts
-import * as fs32 from "fs";
+import * as fs31 from "fs";
 import * as path32 from "path";
-import { spawnSync as spawnSync12 } from "child_process";
+import { spawnSync as spawnSync11 } from "child_process";
 function defaultExit2(code) {
   return process.exit(code);
 }
@@ -7191,8 +7059,8 @@ function deriveSprintBranch(sprintId) {
 }
 function atomicWriteString(filePath, text) {
   const tmpFile = `${filePath}.tmp.${process.pid}`;
-  fs32.writeFileSync(tmpFile, text, "utf8");
-  fs32.renameSync(tmpFile, filePath);
+  fs31.writeFileSync(tmpFile, text, "utf8");
+  fs31.renameSync(tmpFile, filePath);
 }
 function stateJsonPath(cwd, sprintId) {
   return path32.join(cwd, ".cleargate", "sprint-runs", sprintId, "state.json");
@@ -7201,7 +7069,7 @@ function storyStartHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? defaultExit2;
-  const spawnFn = cli?.spawnFn ?? spawnSync12;
+  const spawnFn = cli?.spawnFn ?? spawnSync11;
   const cwd = cli?.cwd ?? process.cwd();
   const sprintId = cli?.sprintId ?? resolveSprintIdFromSentinel(cwd) ?? "SPRINT-UNKNOWN";
   const mode = readSprintExecutionMode(sprintId, {
@@ -7229,9 +7097,10 @@ function storyStartHandler(opts, cli) {
     return exitFn(step1.status ?? 1);
   }
   const runScript = resolveRunScript2(cli ?? { cwd });
+  const updateStateScript = resolveCleargateScript({ cwd }, "update_state.mjs");
   const step2 = spawnFn(
     "bash",
-    [runScript, "update_state.mjs", opts.storyId, "Bouncing"],
+    [runScript, "node", updateStateScript, opts.storyId, "Bouncing"],
     { stdio: "pipe", cwd, encoding: "utf8" }
   );
   if (step2.error) {
@@ -7244,13 +7113,13 @@ function storyStartHandler(opts, cli) {
     return exitFn(step2.status ?? 1);
   }
   const stateFile = stateJsonPath(cwd, sprintId);
-  if (!fs32.existsSync(stateFile)) {
+  if (!fs31.existsSync(stateFile)) {
     stderrFn(`[cleargate story start] step 3: state.json not found at ${stateFile}`);
     return exitFn(1);
   }
   let state2;
   try {
-    state2 = JSON.parse(fs32.readFileSync(stateFile, "utf8"));
+    state2 = JSON.parse(fs31.readFileSync(stateFile, "utf8"));
   } catch (err) {
     stderrFn(`[cleargate story start] step 3: failed to parse state.json: ${err.message}`);
     return exitFn(1);
@@ -7279,7 +7148,7 @@ function storyCompleteHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? defaultExit2;
-  const spawnFn = cli?.spawnFn ?? spawnSync12;
+  const spawnFn = cli?.spawnFn ?? spawnSync11;
   const cwd = cli?.cwd ?? process.cwd();
   const sprintId = cli?.sprintId ?? resolveSprintIdFromSentinel(cwd) ?? "SPRINT-UNKNOWN";
   const mode = readSprintExecutionMode(sprintId, {
@@ -7369,9 +7238,10 @@ function storyCompleteHandler(opts, cli) {
     return exitFn(step5.status ?? 1);
   }
   const runScript = resolveRunScript2(cli ?? { cwd });
+  const updateStateDoneScript = resolveCleargateScript({ cwd }, "update_state.mjs");
   const step6 = spawnFn(
     "bash",
-    [runScript, "update_state.mjs", opts.storyId, "Done"],
+    [runScript, "node", updateStateDoneScript, opts.storyId, "Done"],
     { stdio: "pipe", cwd, encoding: "utf8" }
   );
   if (step6.error) {
@@ -7389,7 +7259,7 @@ function storyCompleteHandler(opts, cli) {
 
 // src/commands/state.ts
 import * as path33 from "path";
-import { spawnSync as spawnSync13 } from "child_process";
+import { spawnSync as spawnSync12 } from "child_process";
 function defaultExit3(code) {
   return process.exit(code);
 }
@@ -7402,7 +7272,7 @@ function stateUpdateHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? defaultExit3;
-  const spawnFn = cli?.spawnFn ?? spawnSync13;
+  const spawnFn = cli?.spawnFn ?? spawnSync12;
   const cwd = cli?.cwd;
   const sprintId = cli?.sprintId ?? resolveSprintIdFromSentinel(cwd) ?? "SPRINT-UNKNOWN";
   const mode = readSprintExecutionMode(sprintId, {
@@ -7413,9 +7283,11 @@ function stateUpdateHandler(opts, cli) {
     return printInertAndExit(stdoutFn, exitFn);
   }
   const runScript = resolveRunScript3(cli ?? {});
+  const updateCwd = cli?.cwd ?? process.cwd();
+  const updateScriptPath = resolveCleargateScript({ cwd: updateCwd }, "update_state.mjs");
   const result = spawnFn(
     "bash",
-    [runScript, "update_state.mjs", opts.storyId, opts.newState],
+    [runScript, "node", updateScriptPath, opts.storyId, opts.newState],
     { stdio: "inherit" }
   );
   if (result.error) {
@@ -7429,7 +7301,7 @@ function stateValidateHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? defaultExit3;
-  const spawnFn = cli?.spawnFn ?? spawnSync13;
+  const spawnFn = cli?.spawnFn ?? spawnSync12;
   const mode = readSprintExecutionMode(opts.sprintId, {
     sprintFilePath: cli?.sprintFilePath,
     cwd: cli?.cwd
@@ -7438,9 +7310,11 @@ function stateValidateHandler(opts, cli) {
     return printInertAndExit(stdoutFn, exitFn);
   }
   const runScript = resolveRunScript3(cli ?? {});
+  const validateCwd = cli?.cwd ?? process.cwd();
+  const validateScriptPath = resolveCleargateScript({ cwd: validateCwd }, "validate_state.mjs");
   const result = spawnFn(
     "bash",
-    [runScript, "validate_state.mjs", opts.sprintId],
+    [runScript, "node", validateScriptPath, opts.sprintId],
     { stdio: "inherit" }
   );
   if (result.error) {
@@ -7452,17 +7326,17 @@ function stateValidateHandler(opts, cli) {
 }
 
 // src/commands/stamp-tokens.ts
-import * as fs34 from "fs";
+import * as fs33 from "fs";
 import * as path35 from "path";
 
 // src/lib/ledger-reader.ts
-import * as fs33 from "fs";
+import * as fs32 from "fs";
 import * as path34 from "path";
 function findSprintRunsRoot(startDir) {
   let dir = startDir;
   while (true) {
     const candidate = path34.join(dir, ".cleargate", "sprint-runs");
-    if (fs33.existsSync(candidate)) {
+    if (fs32.existsSync(candidate)) {
       return candidate;
     }
     const parent = path34.dirname(dir);
@@ -7518,13 +7392,13 @@ function readLedgerForWorkItem(workItemId, opts = {}) {
     }
     sprintRunsRoot = found;
   }
-  if (!fs33.existsSync(sprintRunsRoot)) {
+  if (!fs32.existsSync(sprintRunsRoot)) {
     return [];
   }
   let ledgerFiles;
   try {
-    const entries = fs33.readdirSync(sprintRunsRoot, { withFileTypes: true });
-    ledgerFiles = entries.filter((e) => e.isDirectory()).map((e) => path34.join(sprintRunsRoot, e.name, "token-ledger.jsonl")).filter((f) => fs33.existsSync(f));
+    const entries = fs32.readdirSync(sprintRunsRoot, { withFileTypes: true });
+    ledgerFiles = entries.filter((e) => e.isDirectory()).map((e) => path34.join(sprintRunsRoot, e.name, "token-ledger.jsonl")).filter((f) => fs32.existsSync(f));
   } catch {
     return [];
   }
@@ -7532,7 +7406,7 @@ function readLedgerForWorkItem(workItemId, opts = {}) {
   for (const ledgerFile of ledgerFiles) {
     let content;
     try {
-      content = fs33.readFileSync(ledgerFile, "utf-8");
+      content = fs32.readFileSync(ledgerFile, "utf-8");
     } catch {
       continue;
     }
@@ -7591,7 +7465,7 @@ async function stampTokensHandler(file, opts, cli) {
   }
   let rawContent;
   try {
-    rawContent = fs34.readFileSync(absPath, "utf-8");
+    rawContent = fs33.readFileSync(absPath, "utf-8");
   } catch {
     stdoutFn(`[stamp-tokens] error: cannot read file: ${absPath}`);
     exitFn(1);
@@ -7663,7 +7537,7 @@ async function stampTokensHandler(file, opts, cli) {
     return;
   }
   try {
-    fs34.writeFileSync(absPath, serialized, "utf-8");
+    fs33.writeFileSync(absPath, serialized, "utf-8");
   } catch {
     stdoutFn(`[stamp-tokens] error: cannot write file: ${absPath}`);
     exitFn(1);
@@ -7673,7 +7547,7 @@ async function stampTokensHandler(file, opts, cli) {
   exitFn(0);
 }
 function extractWorkItemId(fm, absPath) {
-  const idKeys = ["story_id", "epic_id", "proposal_id", "cr_id", "bug_id"];
+  const idKeys = ["story_id", "epic_id", "proposal_id", "cr_id", "bug_id", "initiative_id", "sprint_id"];
   for (const key of idKeys) {
     const val = fm[key];
     if (typeof val === "string" && val.trim() !== "") {
@@ -7681,13 +7555,13 @@ function extractWorkItemId(fm, absPath) {
     }
   }
   const basename13 = path35.basename(absPath);
-  const match = basename13.match(/^(STORY|EPIC|PROPOSAL|CR|BUG)-\d+(-\d+)?/i);
+  const match = basename13.match(/^(STORY|EPIC|PROPOSAL|CR|BUG|INITIATIVE|SPRINT)-\d+(-\d+)?/i);
   if (match) {
     return match[0].toUpperCase();
   }
   const typeFromPath = detectWorkItemType(absPath);
   if (typeFromPath) {
-    const idMatch = basename13.match(/((?:STORY|EPIC|PROPOSAL|CR|BUG)-\d+(?:-\d+)?)/i);
+    const idMatch = basename13.match(/((?:STORY|EPIC|PROPOSAL|CR|BUG|INITIATIVE|SPRINT)-\d+(?:-\d+)?)/i);
     if (idMatch) {
       return idMatch[1].toUpperCase();
     }
@@ -7784,7 +7658,7 @@ ${body}`;
 }
 
 // src/commands/upgrade.ts
-import * as fs35 from "fs";
+import * as fs34 from "fs";
 import * as fsp from "fs/promises";
 import * as path36 from "path";
 
@@ -8149,7 +8023,7 @@ async function upgradeHandler(flags, cli) {
       const pkgRoot = cli?.packageRoot ?? path36.join(path36.dirname(new URL(import.meta.url).pathname), "..", "..");
       const changelogPath = path36.join(pkgRoot, "CHANGELOG.md");
       try {
-        const changelogContent = fs35.readFileSync(changelogPath, "utf-8");
+        const changelogContent = fs34.readFileSync(changelogPath, "utf-8");
         const sections = sliceChangelog(changelogContent, installedVersion, targetVersion);
         if (sections.length > 0) {
           const deltaText = sections.map((s) => s.body).join("\n\n");
@@ -8239,7 +8113,7 @@ async function upgradeHandler(flags, cli) {
 }
 
 // src/commands/uninstall.ts
-import * as fs36 from "fs";
+import * as fs35 from "fs";
 import * as fsp2 from "fs/promises";
 import * as path37 from "path";
 import { execSync as execSync3 } from "child_process";
@@ -8268,9 +8142,9 @@ function shouldPreserve(entry, preserveSet, removeSet) {
 }
 function resolveProjectName(target) {
   const pkgPath = path37.join(target, "package.json");
-  if (fs36.existsSync(pkgPath)) {
+  if (fs35.existsSync(pkgPath)) {
     try {
-      const raw = fs36.readFileSync(pkgPath, "utf-8");
+      const raw = fs35.readFileSync(pkgPath, "utf-8");
       const parsed = JSON.parse(raw);
       if (parsed.name && typeof parsed.name === "string") {
         return parsed.name;
@@ -8308,7 +8182,7 @@ function detectUncommittedChanges(target, manifestPaths, gitRunner) {
 }
 async function removeFromPackageJson(target, dryRun) {
   const pkgPath = path37.join(target, "package.json");
-  if (!fs36.existsSync(pkgPath)) return false;
+  if (!fs35.existsSync(pkgPath)) return false;
   let raw;
   try {
     raw = await fsp2.readFile(pkgPath, "utf-8");
@@ -8349,7 +8223,7 @@ async function removeFile(filePath) {
 }
 async function removeDir(dirPath) {
   try {
-    fs36.rmSync(dirPath, { recursive: true, force: true });
+    fs35.rmSync(dirPath, { recursive: true, force: true });
   } catch {
   }
 }
@@ -8373,8 +8247,8 @@ async function uninstallHandler(opts) {
   const cleargateDir = path37.join(target, ".cleargate");
   const manifestPath = path37.join(cleargateDir, ".install-manifest.json");
   const uninstalledPath = path37.join(cleargateDir, ".uninstalled");
-  if (!fs36.existsSync(manifestPath)) {
-    if (fs36.existsSync(uninstalledPath)) {
+  if (!fs35.existsSync(manifestPath)) {
+    if (fs35.existsSync(uninstalledPath)) {
       stdout("already uninstalled");
       exit(0);
       return;
@@ -8383,7 +8257,7 @@ async function uninstallHandler(opts) {
     exit(0);
     return;
   }
-  if (fs36.existsSync(uninstalledPath) && !fs36.existsSync(manifestPath)) {
+  if (fs35.existsSync(uninstalledPath) && !fs35.existsSync(manifestPath)) {
     stdout("already uninstalled");
     exit(0);
     return;
@@ -8407,8 +8281,8 @@ async function uninstallHandler(opts) {
   }
   const claudeMdPath = path37.join(target, "CLAUDE.md");
   let claudeMdContent = null;
-  if (fs36.existsSync(claudeMdPath)) {
-    claudeMdContent = fs36.readFileSync(claudeMdPath, "utf-8");
+  if (fs35.existsSync(claudeMdPath)) {
+    claudeMdContent = fs35.readFileSync(claudeMdPath, "utf-8");
     if (!claudeMdContent.includes(CLEARGATE_START)) {
       stderr("CLAUDE.md is missing <!-- CLEARGATE:START --> marker");
       exit(1);
@@ -8425,7 +8299,7 @@ async function uninstallHandler(opts) {
   const toSkip = [];
   for (const entry of snapshot.files) {
     const filePath = path37.join(target, entry.path);
-    if (!fs36.existsSync(filePath)) {
+    if (!fs35.existsSync(filePath)) {
       toSkip.push(entry);
       continue;
     }
@@ -8499,9 +8373,9 @@ async function uninstallHandler(opts) {
     }
   }
   const settingsPath = path37.join(target, ".claude", "settings.json");
-  if (fs36.existsSync(settingsPath)) {
+  if (fs35.existsSync(settingsPath)) {
     try {
-      const raw = fs36.readFileSync(settingsPath, "utf-8");
+      const raw = fs35.readFileSync(settingsPath, "utf-8");
       const settings = JSON.parse(raw);
       const cleaned = removeClearGateHooks(settings);
       await writeAtomic3(settingsPath, JSON.stringify(cleaned, null, 2) + "\n");
@@ -8543,26 +8417,26 @@ import * as fsPromises8 from "fs/promises";
 import * as path45 from "path";
 
 // src/lib/sync-log.ts
-import * as fs37 from "fs";
+import * as fs36 from "fs";
 import * as fsPromises2 from "fs/promises";
 import * as path38 from "path";
 function resolveActiveSprintDir(projectRoot, _opts) {
   const sprintRunsRoot = path38.join(projectRoot, ".cleargate", "sprint-runs");
   const offSprint = path38.join(sprintRunsRoot, "_off-sprint");
-  if (!fs37.existsSync(sprintRunsRoot)) {
-    fs37.mkdirSync(sprintRunsRoot, { recursive: true });
-    fs37.mkdirSync(offSprint, { recursive: true });
+  if (!fs36.existsSync(sprintRunsRoot)) {
+    fs36.mkdirSync(sprintRunsRoot, { recursive: true });
+    fs36.mkdirSync(offSprint, { recursive: true });
     return offSprint;
   }
-  const entries = fs37.readdirSync(sprintRunsRoot, { withFileTypes: true });
+  const entries = fs36.readdirSync(sprintRunsRoot, { withFileTypes: true });
   const sprintDirs = entries.filter((e) => e.isDirectory() && e.name !== "_off-sprint").map((e) => {
     const fullPath = path38.join(sprintRunsRoot, e.name);
-    const stat = fs37.statSync(fullPath);
+    const stat = fs36.statSync(fullPath);
     return { name: e.name, fullPath, mtimeMs: stat.mtimeMs };
   }).sort((a, b) => b.mtimeMs - a.mtimeMs);
   if (sprintDirs.length === 0) {
-    if (!fs37.existsSync(offSprint)) {
-      fs37.mkdirSync(offSprint, { recursive: true });
+    if (!fs36.existsSync(offSprint)) {
+      fs36.mkdirSync(offSprint, { recursive: true });
     }
     return offSprint;
   }
@@ -8685,7 +8559,7 @@ function classify2(local, remote, since) {
 }
 
 // src/lib/merge-helper.ts
-import { promises as fs38 } from "fs";
+import { promises as fs37 } from "fs";
 import * as os5 from "os";
 import * as path39 from "path";
 function promptFourChoice(opts) {
@@ -8765,16 +8639,16 @@ ${remote}
 >>>>>>> remote
 `;
         try {
-          await fs38.writeFile(tmpFile, markerContent, "utf-8");
+          await fs37.writeFile(tmpFile, markerContent, "utf-8");
           await openInEditor(tmpFile, { editor: editor ?? process.env["EDITOR"] ?? "vi" });
-          const edited = await fs38.readFile(tmpFile, "utf-8");
+          const edited = await fs37.readFile(tmpFile, "utf-8");
           if (containsConflictMarkers(edited)) {
             stdout("File still contains conflict markers \u2014 please resolve all conflicts.\n");
             continue;
           }
           return { resolution: "edited", body: edited };
         } finally {
-          await fs38.unlink(tmpFile).catch(() => {
+          await fs37.unlink(tmpFile).catch(() => {
           });
         }
       }
@@ -9117,7 +8991,7 @@ async function hasAnyRemoteAuthored(projectRoot) {
 }
 
 // src/lib/active-criteria.ts
-import * as fs39 from "fs";
+import * as fs38 from "fs";
 import * as fsPromises5 from "fs/promises";
 import * as path42 from "path";
 async function resolveActiveItems(projectRoot, localItems, nowFn = () => (/* @__PURE__ */ new Date()).toISOString()) {
@@ -9163,7 +9037,7 @@ async function findSprintFile2(projectRoot, sprintId) {
   const archive = path42.join(projectRoot, ".cleargate", "delivery", "archive");
   for (const dir of [pendingSync, archive]) {
     try {
-      const entries = fs39.readdirSync(dir, { withFileTypes: true });
+      const entries = fs38.readdirSync(dir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isFile() && entry.name.startsWith(sprintId) && entry.name.endsWith(".md")) {
           return path42.join(dir, entry.name);
@@ -9917,7 +9791,7 @@ async function syncWorkItems(opts) {
 }
 
 // src/lib/admin-url.ts
-import * as fs40 from "fs";
+import * as fs39 from "fs";
 import * as os6 from "os";
 import * as path47 from "path";
 var DEFAULT_BASE = "https://admin.cleargate.soula.ge/";
@@ -9943,7 +9817,7 @@ function readLocalConfig() {
   const home = os6.homedir();
   if (!home) return null;
   const configPath = path47.join(home, ".cleargate", "config.json");
-  const raw = fs40.readFileSync(configPath, "utf8");
+  const raw = fs39.readFileSync(configPath, "utf8");
   return JSON.parse(raw);
 }
 
@@ -10631,7 +10505,7 @@ function formatEntry(entry) {
 }
 
 // src/commands/admin-login.ts
-import * as fs41 from "fs";
+import * as fs40 from "fs";
 import * as path51 from "path";
 import * as os7 from "os";
 var DEFAULT_MCP_URL = "http://localhost:3000";
@@ -10645,10 +10519,10 @@ function resolveAuthFilePath(opts) {
 }
 function writeAdminAuth(filePath, token) {
   const dir = path51.dirname(filePath);
-  fs41.mkdirSync(dir, { recursive: true });
+  fs40.mkdirSync(dir, { recursive: true });
   const payload = JSON.stringify({ version: 1, token }, null, 2);
-  fs41.writeFileSync(filePath, payload, { encoding: "utf8", mode: 384 });
-  fs41.chmodSync(filePath, 384);
+  fs40.writeFileSync(filePath, payload, { encoding: "utf8", mode: 384 });
+  fs40.chmodSync(filePath, 384);
 }
 async function adminLoginHandler(opts = {}) {
   const fetchFn = opts.fetch ?? globalThis.fetch;
@@ -10757,7 +10631,7 @@ async function adminLoginHandler(opts = {}) {
 }
 
 // src/commands/hotfix.ts
-import * as fs42 from "fs";
+import * as fs41 from "fs";
 import * as path52 from "path";
 function defaultExit4(code) {
   return process.exit(code);
@@ -10768,7 +10642,7 @@ function maxHotfixId(pendingDir) {
   let max = 0;
   let entries;
   try {
-    entries = fs42.readdirSync(pendingDir);
+    entries = fs41.readdirSync(pendingDir);
   } catch {
     return 0;
   }
@@ -10788,7 +10662,7 @@ function countActiveHotfixes(repoRoot) {
   let count = 0;
   let pendingEntries = [];
   try {
-    pendingEntries = fs42.readdirSync(pendingDir);
+    pendingEntries = fs41.readdirSync(pendingDir);
   } catch {
   }
   for (const entry of pendingEntries) {
@@ -10796,13 +10670,13 @@ function countActiveHotfixes(repoRoot) {
   }
   let archiveEntries = [];
   try {
-    archiveEntries = fs42.readdirSync(archiveDir);
+    archiveEntries = fs41.readdirSync(archiveDir);
   } catch {
   }
   for (const entry of archiveEntries) {
     if (entry.startsWith("HOTFIX-") && entry.endsWith(".md")) {
       try {
-        const stat = fs42.statSync(path52.join(archiveDir, entry));
+        const stat = fs41.statSync(path52.join(archiveDir, entry));
         if (stat.mtimeMs >= sevenDaysAgo) count++;
       } catch {
       }
@@ -10837,7 +10711,7 @@ function hotfixNewHandler(opts, cli) {
   const templatePath = resolveTemplatePath(repoRoot);
   let templateContent;
   try {
-    templateContent = fs42.readFileSync(templatePath, "utf8");
+    templateContent = fs41.readFileSync(templatePath, "utf8");
   } catch {
     stderrFn(`[cleargate hotfix new] template not found: ${templatePath}`);
     return exitFn(2);
@@ -10847,8 +10721,8 @@ function hotfixNewHandler(opts, cli) {
   const fileName = `${idStr}_${fileSlug}.md`;
   const outPath = path52.join(pendingDir, fileName);
   try {
-    fs42.mkdirSync(pendingDir, { recursive: true });
-    fs42.writeFileSync(outPath, content, "utf8");
+    fs41.mkdirSync(pendingDir, { recursive: true });
+    fs41.writeFileSync(outPath, content, "utf8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     stderrFn(`[cleargate hotfix new] write failed: ${msg}`);