cleargate 0.10.0 → 0.11.0

package/dist/cli.cjs

@@ -696,10 +696,10 @@ var import_commander = require("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"
@@ -743,9 +743,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",
@@ -1991,7 +1994,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) {
@@ -2045,6 +2061,14 @@ function copyPayload(payloadDir, targetCwd, opts) {
         report.actions.push({ action: "skipped", relPath });
         continue;
       }
+      if (isFirstInstallOnly(relPath)) {
+        if (needsExec && process.platform !== "win32") {
+          fs7.chmodSync(dstPath, 493);
+        }
+        report.skipped++;
+        report.actions.push({ action: "skipped", relPath });
+        continue;
+      }
       fs7.writeFileSync(dstPath, srcBuffer);
       if (needsExec && process.platform !== "win32") {
         fs7.chmodSync(dstPath, 493);
@@ -2183,7 +2207,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;
@@ -4223,14 +4248,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) {
@@ -4255,7 +4284,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
@@ -5868,7 +5899,7 @@ async function doctorHandler(flags, cli) {
 // src/commands/gate.ts
 init_cjs_shims();
 var fs32 = __toESM(require("fs"), 1);
-var path33 = __toESM(require("path"), 1);
+var path34 = __toESM(require("path"), 1);
 var import_node_child_process8 = require("child_process");
 
 // src/commands/execution-mode.ts
@@ -5957,13 +5988,21 @@ function printInertAndExit(stdoutFn, exitFn) {
   return exitFn(0);
 }
 
+// src/lib/script-paths.ts
+init_cjs_shims();
+var path32 = __toESM(require("path"), 1);
+function resolveCleargateScript(opts, scriptName) {
+  const cwd = opts.cwd ?? process.cwd();
+  return path32.join(cwd, ".cleargate", "scripts", scriptName);
+}
+
 // src/commands/gate.ts
 var import_js_yaml6 = __toESM(require("js-yaml"), 1);
 
 // src/lib/readiness-predicates.ts
 init_cjs_shims();
 var fs30 = __toESM(require("fs"), 1);
-var path32 = __toESM(require("path"), 1);
+var path33 = __toESM(require("path"), 1);
 function parsePredicate(src) {
   const s = src.trim();
   const fmMatch = s.match(
@@ -5995,7 +6034,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);
@@ -6023,6 +6062,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) {
@@ -6051,6 +6093,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) {
@@ -6127,8 +6171,14 @@ function compareValues(actual, op, expected) {
 }
 function resolveLinkedPath(ref, docAbsPath, projectRoot) {
   const candidates = [
-    path32.resolve(path32.dirname(docAbsPath), ref),
-    path32.resolve(projectRoot, ref)
+    path33.resolve(path33.dirname(docAbsPath), ref),
+    // 1. relative to citer
+    path33.resolve(projectRoot, ref),
+    // 2. project root
+    path33.resolve(projectRoot, ".cleargate", "delivery", "pending-sync", ref),
+    // 3. live
+    path33.resolve(projectRoot, ".cleargate", "delivery", "archive", ref)
+    // 4. archived
   ];
   for (const candidate of candidates) {
     if (!candidate.startsWith(projectRoot)) continue;
@@ -6265,6 +6315,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;
@@ -6281,9 +6334,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 = path32.resolve(projectRoot, parsed.path);
-  if (!resolved.startsWith(projectRoot + path32.sep) && resolved !== projectRoot) {
+  const resolved = path33.resolve(projectRoot, parsed.path);
+  if (!resolved.startsWith(projectRoot + path33.sep) && resolved !== projectRoot) {
     return {
       pass: false,
       detail: `path '${parsed.path}' resolves outside project root (sandbox violation)`
@@ -6297,7 +6380,7 @@ function evalFileExists(parsed, projectRoot) {
 }
 function evalLinkTargetExists(parsed, opts) {
   const projectRoot = opts?.projectRoot ?? process.cwd();
-  const wikiIndexPath = opts?.wikiIndexPath ?? path32.join(projectRoot, ".cleargate", "wiki", "index.md");
+  const wikiIndexPath = opts?.wikiIndexPath ?? path33.join(projectRoot, ".cleargate", "wiki", "index.md");
   if (!wikiIndexPath.startsWith(projectRoot)) {
     return { pass: false, detail: "wikiIndexPath resolves outside project root" };
   }
@@ -6314,7 +6397,7 @@ function evalLinkTargetExists(parsed, opts) {
   };
 }
 function evalStatusOf(parsed, opts, projectRoot) {
-  const wikiIndexPath = opts?.wikiIndexPath ?? path32.join(projectRoot, ".cleargate", "wiki", "index.md");
+  const wikiIndexPath = opts?.wikiIndexPath ?? path33.join(projectRoot, ".cleargate", "wiki", "index.md");
   if (!wikiIndexPath.startsWith(projectRoot)) {
     return { pass: false, detail: "wikiIndexPath resolves outside project root" };
   }
@@ -6331,7 +6414,7 @@ function evalStatusOf(parsed, opts, projectRoot) {
     return { pass: false, detail: `[[${parsed.id}]] not found in wiki index` };
   }
   const rawPath = rowMatch[1].trim();
-  const fullPath = path32.resolve(projectRoot, rawPath);
+  const fullPath = path33.resolve(projectRoot, rawPath);
   if (!fullPath.startsWith(projectRoot)) {
     return { pass: false, detail: `wiki path for ${parsed.id} resolves outside project root` };
   }
@@ -6346,6 +6429,60 @@ 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 = path33.resolve(projectRoot, p);
+    if (!resolved.startsWith(projectRoot + path33.sep) && resolved !== projectRoot) {
+      missing.push(p);
+      continue;
+    }
+    if (!fs30.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
 init_cjs_shims();
@@ -6470,7 +6607,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 = path33.isAbsolute(file) ? file : path33.resolve(cwd, file);
+  const absPath = path34.isAbsolute(file) ? file : path34.resolve(cwd, file);
   if (!fs32.existsSync(absPath)) {
     stderrFn(`[cleargate gate] error: file not found: ${absPath}`);
     return exitFn(1);
@@ -6496,7 +6633,7 @@ async function gateCheckHandler(file, opts, cli) {
     return exitFn(1);
   }
   const projectRoot = cwd;
-  const gatesDocPath = cli?.gatesDocPath ?? path33.join(projectRoot, ".cleargate", "knowledge", "readiness-gates.md");
+  const gatesDocPath = cli?.gatesDocPath ?? path34.join(projectRoot, ".cleargate", "knowledge", "readiness-gates.md");
   if (!fs32.existsSync(gatesDocPath)) {
     stderrFn(`[cleargate gate] error: readiness-gates.md not found at: ${gatesDocPath}`);
     return exitFn(1);
@@ -6520,7 +6657,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;
@@ -6529,9 +6665,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;
@@ -6548,15 +6707,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}`);
       }
     }
@@ -6570,7 +6729,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 = path33.isAbsolute(file) ? file : path33.resolve(cwd, file);
+  const absPath = path34.isAbsolute(file) ? file : path34.resolve(cwd, file);
   if (!fs32.existsSync(absPath)) {
     stderrFn(`[cleargate gate] error: file not found: ${absPath}`);
     return exitFn(1);
@@ -6603,7 +6762,7 @@ async function gateExplainHandler(file, cli) {
 function resolveRunScriptForGate(opts) {
   if (opts.runScriptPath) return opts.runScriptPath;
   const cwd = opts.cwd ?? process.cwd();
-  return path33.join(cwd, ".cleargate", "scripts", "run_script.sh");
+  return path34.join(cwd, ".cleargate", "scripts", "run_script.sh");
 }
 function gateQaHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
@@ -6619,9 +6778,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) {
@@ -6645,9 +6806,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) {
@@ -6698,14 +6861,14 @@ function gateRunHandler(name, opts, cli) {
 // src/commands/sprint.ts
 init_cjs_shims();
 var fs34 = __toESM(require("fs"), 1);
-var path35 = __toESM(require("path"), 1);
+var path36 = __toESM(require("path"), 1);
 var import_node_child_process11 = require("child_process");
 var import_js_yaml7 = __toESM(require("js-yaml"), 1);
 
 // src/lib/lifecycle-reconcile.ts
 init_cjs_shims();
 var fs33 = __toESM(require("fs"), 1);
-var path34 = __toESM(require("path"), 1);
+var path35 = __toESM(require("path"), 1);
 var import_node_child_process10 = require("child_process");
 var VERB_STATUS_MAP = {
   feat: {
@@ -6765,7 +6928,7 @@ function findArtifactFile(deliveryRoot, id) {
     { rel: "archive", inArchive: true }
   ];
   for (const { rel, inArchive } of dirs) {
-    const dir = path34.join(deliveryRoot, rel);
+    const dir = path35.join(deliveryRoot, rel);
     let entries;
     try {
       entries = fs33.readdirSync(dir);
@@ -6776,7 +6939,7 @@ function findArtifactFile(deliveryRoot, id) {
       (e) => (e.startsWith(prefix) || e === `${id}.md`) && e.endsWith(".md")
     );
     if (match) {
-      const absPath = path34.join(dir, match);
+      const absPath = path35.join(dir, match);
       return { absPath, inArchive, relPath: `${rel}/${match}` };
     }
   }
@@ -6894,8 +7057,8 @@ function reconcileDecomposition(opts) {
   }
   const epics = Array.isArray(fm["epics"]) ? fm["epics"].map(String) : [];
   const proposals = Array.isArray(fm["proposals"]) ? fm["proposals"].map(String) : [];
-  const pendingDir = path34.join(deliveryRoot, "pending-sync");
-  const archiveDir = path34.join(deliveryRoot, "archive");
+  const pendingDir = path35.join(deliveryRoot, "pending-sync");
+  const archiveDir = path35.join(deliveryRoot, "archive");
   function listMdFiles(dir) {
     try {
       return fs33.readdirSync(dir).filter((f) => f.endsWith(".md"));
@@ -6970,7 +7133,7 @@ function findChildStories(epicId, pendingDir, pendingFiles, archiveDir, archiveF
     for (const f of files) {
       if (!f.startsWith(storyPrefix) && !f.startsWith("STORY-")) continue;
       if (!f.includes(storyPrefix)) continue;
-      const absPath = path34.join(dir, f);
+      const absPath = path35.join(dir, f);
       try {
         const raw = fs33.readFileSync(absPath, "utf8");
         const { fm } = parseFrontmatter(raw);
@@ -6987,7 +7150,7 @@ function findChildStories(epicId, pendingDir, pendingFiles, archiveDir, archiveF
 function findDecomposedEpic(proposalId, pendingDir, pendingFiles) {
   for (const f of pendingFiles) {
     if (!f.startsWith("EPIC-")) continue;
-    const absPath = path34.join(pendingDir, f);
+    const absPath = path35.join(pendingDir, f);
     try {
       const raw = fs33.readFileSync(absPath, "utf8");
       const { fm } = parseFrontmatter(raw);
@@ -7015,7 +7178,7 @@ var TERMINAL_STATUSES2 = /* @__PURE__ */ new Set(["Completed", "Done", "Abandone
 function resolveRunScript(opts) {
   if (opts.runScriptPath) return opts.runScriptPath;
   const cwd = opts.cwd ?? process.cwd();
-  return path35.join(cwd, ".cleargate", "scripts", "run_script.sh");
+  return path36.join(cwd, ".cleargate", "scripts", "run_script.sh");
 }
 function defaultExit(code) {
   return process.exit(code);
@@ -7034,17 +7197,17 @@ function sprintInitHandler(opts, cli) {
   if (mode === "v1") {
     return printInertAndExit(stdoutFn, exitFn);
   }
-  const deliveryRoot = path35.join(cwd, ".cleargate", "delivery");
+  const deliveryRoot = path36.join(cwd, ".cleargate", "delivery");
   let lifecycleInitMode = "warn";
   let sprintPlanPath = null;
-  const pendingDir = path35.join(deliveryRoot, "pending-sync");
+  const pendingDir = path36.join(deliveryRoot, "pending-sync");
   try {
     const entries = fs34.readdirSync(pendingDir);
     const sprintFile = entries.find(
       (e) => (e.startsWith(`${opts.sprintId}_`) || e === `${opts.sprintId}.md`) && e.endsWith(".md")
     );
     if (sprintFile) {
-      sprintPlanPath = path35.join(pendingDir, sprintFile);
+      sprintPlanPath = path36.join(pendingDir, sprintFile);
       const raw = fs34.readFileSync(sprintPlanPath, "utf8");
       const { fm } = parseFileFrontmatter(raw);
       if (fm["lifecycle_init_mode"] === "block") {
@@ -7128,8 +7291,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);
@@ -7153,11 +7320,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);
@@ -7170,20 +7339,20 @@ function reconcileLifecycleCliHandler(opts, cli) {
   const stderrFn = cli?.stderr ?? ((s) => process.stderr.write(s + "\n"));
   const exitFn = cli?.exit ?? defaultExit;
   const cwd = cli?.cwd ?? process.cwd();
-  const deliveryRoot = path35.join(cwd, ".cleargate", "delivery");
+  const deliveryRoot = path36.join(cwd, ".cleargate", "delivery");
   let since;
   let until;
   if (opts.since) {
     since = new Date(opts.since);
   } else {
     try {
-      const pendingDir = path35.join(deliveryRoot, "pending-sync");
+      const pendingDir = path36.join(deliveryRoot, "pending-sync");
       const entries = fs34.readdirSync(pendingDir);
       const sprintFile = entries.find(
         (e) => (e.startsWith(`${opts.sprintId}_`) || e === `${opts.sprintId}.md`) && e.endsWith(".md")
       );
       if (sprintFile) {
-        const raw = fs34.readFileSync(path35.join(pendingDir, sprintFile), "utf8");
+        const raw = fs34.readFileSync(path36.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);
@@ -7339,7 +7508,7 @@ async function sprintArchiveHandler(opts, cli) {
     if (mode === "v1") {
       return printInertAndExit(stdoutFn, exitFn);
     }
-    const stateFile = path35.join(cwd, ".cleargate", "sprint-runs", opts.sprintId, "state.json");
+    const stateFile = path36.join(cwd, ".cleargate", "sprint-runs", opts.sprintId, "state.json");
     if (!fs34.existsSync(stateFile)) {
       stderrFn(`[cleargate sprint archive] state.json not found at ${stateFile}`);
       return exitFn(1);
@@ -7358,12 +7527,12 @@ async function sprintArchiveHandler(opts, cli) {
       return exitFn(1);
     }
     const stateStories = state2.stories ?? {};
-    const pendingDir = path35.join(cwd, ".cleargate", "delivery", "pending-sync");
-    const archiveDir = path35.join(cwd, ".cleargate", "delivery", "archive");
+    const pendingDir = path36.join(cwd, ".cleargate", "delivery", "pending-sync");
+    const archiveDir = path36.join(cwd, ".cleargate", "delivery", "archive");
     let sprintFile = null;
     for (const entry of fs34.readdirSync(pendingDir)) {
       if ((entry.startsWith(`${opts.sprintId}_`) || entry === `${opts.sprintId}.md`) && entry.endsWith(".md")) {
-        sprintFile = path35.join(pendingDir, entry);
+        sprintFile = path36.join(pendingDir, entry);
         break;
       }
     }
@@ -7379,7 +7548,7 @@ async function sprintArchiveHandler(opts, cli) {
     if (sprintFile) {
       plan.push({
         src: sprintFile,
-        destName: path35.basename(sprintFile),
+        destName: path36.basename(sprintFile),
         status: "Completed"
       });
     }
@@ -7387,7 +7556,7 @@ async function sprintArchiveHandler(opts, cli) {
       for (const entry of fs34.readdirSync(pendingDir)) {
         if ((entry.startsWith(`${epicId}_`) || entry === `${epicId}.md`) && entry.endsWith(".md")) {
           plan.push({
-            src: path35.join(pendingDir, entry),
+            src: path36.join(pendingDir, entry),
             destName: entry,
             status: "Approved"
           });
@@ -7399,7 +7568,7 @@ async function sprintArchiveHandler(opts, cli) {
         for (const entry of fs34.readdirSync(pendingDir)) {
           if ((entry.startsWith(`${storyId}_`) || entry === `${storyId}.md`) && entry.endsWith(".md")) {
             plan.push({
-              src: path35.join(pendingDir, entry),
+              src: path36.join(pendingDir, entry),
               destName: entry,
               status: "Done"
             });
@@ -7413,7 +7582,7 @@ async function sprintArchiveHandler(opts, cli) {
     const orphans = [];
     for (const entry of fs34.readdirSync(pendingDir)) {
       if (!entry.startsWith("STORY-") || !entry.endsWith(".md")) continue;
-      const candidate = path35.join(pendingDir, entry);
+      const candidate = path36.join(pendingDir, entry);
       if (planSrcs.has(candidate)) continue;
       let raw;
       try {
@@ -7434,18 +7603,18 @@ async function sprintArchiveHandler(opts, cli) {
     }
     const completedAt = (/* @__PURE__ */ new Date()).toISOString();
     const sprintBranch = deriveSprintBranchForArchive(opts.sprintId);
-    const activePath = path35.join(cwd, ".cleargate", "sprint-runs", ".active");
+    const activePath = path36.join(cwd, ".cleargate", "sprint-runs", ".active");
     if (opts.dryRun) {
       stdoutFn(`[dry-run] Sprint archive plan for ${opts.sprintId}:`);
       stdoutFn(`  Sprint branch: ${sprintBranch}`);
       stdoutFn(`  Files to archive (${plan.length}):`);
       for (const entry of plan) {
         stdoutFn(
-          `    ${path35.basename(entry.src)} \u2192 archive/${entry.destName}  [stamp: status=${entry.status}, completed_at=<now>]`
+          `    ${path36.basename(entry.src)} \u2192 archive/${entry.destName}  [stamp: status=${entry.status}, completed_at=<now>]`
         );
       }
       if (orphans.length > 0) {
-        stdoutFn(`  Orphan files (${orphans.length}): ${orphans.map((o) => path35.basename(o)).join(", ")}`);
+        stdoutFn(`  Orphan files (${orphans.length}): ${orphans.map((o) => path36.basename(o)).join(", ")}`);
       }
       stdoutFn(`  .active \u2192 "" (truncate)`);
       stdoutFn(`  git checkout main`);
@@ -7454,7 +7623,7 @@ async function sprintArchiveHandler(opts, cli) {
       return exitFn(0);
     }
     let sprintFileSnapshot = null;
-    const wikiRoot = path35.join(cwd, ".cleargate", "wiki");
+    const wikiRoot = path36.join(cwd, ".cleargate", "wiki");
     const wikiInitialised = fs34.existsSync(wikiRoot);
     if (sprintFile && fs34.existsSync(sprintFile)) {
       const { previousContent } = stampSprintClose(sprintFile, () => completedAt);
@@ -7489,7 +7658,7 @@ async function sprintArchiveHandler(opts, cli) {
       }
       const raw = fs34.readFileSync(entry.src, "utf8");
       const stamped = stampFile(raw, entry.status, completedAt);
-      const dest = path35.join(archiveDir, entry.destName);
+      const dest = path36.join(archiveDir, entry.destName);
       atomicWriteStr(entry.src, stamped);
       fs34.renameSync(entry.src, dest);
       stdoutFn(`archived: ${entry.destName}`);
@@ -7550,11 +7719,11 @@ function checkPrevSprintCompleted(sprintId, cwd) {
   const prevNum = sprintNum - 1;
   const prevId = `SPRINT-${String(prevNum).padStart(2, "0")}`;
   const prevIdAlt = `SPRINT-${prevNum}`;
-  const sprintRunsBase = path35.join(cwd, ".cleargate", "sprint-runs");
+  const sprintRunsBase = path36.join(cwd, ".cleargate", "sprint-runs");
   let stateJson = null;
   let resolvedPrevId = prevId;
   for (const pid of [prevId, prevIdAlt]) {
-    const stateFile = path35.join(sprintRunsBase, pid, "state.json");
+    const stateFile = path36.join(sprintRunsBase, pid, "state.json");
     if (fs34.existsSync(stateFile)) {
       try {
         const raw = fs34.readFileSync(stateFile, "utf8");
@@ -7660,8 +7829,8 @@ function checkMainClean(cwd, execFn) {
 }
 function findSprintFile(sprintId, cwd) {
   const searchDirs = [
-    path35.join(cwd, ".cleargate", "delivery", "pending-sync"),
-    path35.join(cwd, ".cleargate", "delivery", "archive")
+    path36.join(cwd, ".cleargate", "delivery", "pending-sync"),
+    path36.join(cwd, ".cleargate", "delivery", "archive")
   ];
   for (const dir of searchDirs) {
     if (!fs34.existsSync(dir)) continue;
@@ -7674,7 +7843,7 @@ function findSprintFile(sprintId, cwd) {
     const prefix = `${sprintId}_`;
     for (const entry of entries) {
       if ((entry.startsWith(prefix) || entry === `${sprintId}.md`) && entry.endsWith(".md")) {
-        return path35.join(dir, entry);
+        return path36.join(dir, entry);
       }
     }
   }
@@ -7682,8 +7851,8 @@ function findSprintFile(sprintId, cwd) {
 }
 function findWorkItemFileLocal(cwd, workItemId) {
   const searchDirs = [
-    path35.join(cwd, ".cleargate", "delivery", "pending-sync"),
-    path35.join(cwd, ".cleargate", "delivery", "archive")
+    path36.join(cwd, ".cleargate", "delivery", "pending-sync"),
+    path36.join(cwd, ".cleargate", "delivery", "archive")
   ];
   const prefix = `${workItemId}_`;
   for (const dir of searchDirs) {
@@ -7694,7 +7863,7 @@ function findWorkItemFileLocal(cwd, workItemId) {
       continue;
     }
     const match = entries.find((e) => (e.startsWith(prefix) || e === `${workItemId}.md`) && e.endsWith(".md"));
-    if (match) return path35.join(dir, match);
+    if (match) return path36.join(dir, match);
   }
   return null;
 }
@@ -7725,7 +7894,7 @@ function readCachedGateSync(absPath) {
   return null;
 }
 function extractInScopeWorkItemIds(sprintFilePath, cwd, execFn) {
-  const scriptPath = path35.join(cwd, ".cleargate", "scripts", "assert_story_files.mjs");
+  const scriptPath = path36.join(cwd, ".cleargate", "scripts", "assert_story_files.mjs");
   const cmd = `node "${scriptPath}" "${sprintFilePath}" --emit-json`;
   let stdout;
   try {
@@ -7862,6 +8031,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 = fs34.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) {
@@ -7893,6 +8097,13 @@ function sprintPreflightHandler(opts, cli) {
   }
   const execFn = cli?.execFn ?? ((cmd, execOpts) => (0, import_node_child_process11.execSync)(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),
@@ -7911,7 +8122,7 @@ function sprintPreflightHandler(opts, cli) {
 // src/commands/story.ts
 init_cjs_shims();
 var fs35 = __toESM(require("fs"), 1);
-var path36 = __toESM(require("path"), 1);
+var path37 = __toESM(require("path"), 1);
 var import_node_child_process12 = require("child_process");
 function defaultExit2(code) {
   return process.exit(code);
@@ -7919,7 +8130,7 @@ function defaultExit2(code) {
 function resolveRunScript2(opts) {
   if (opts.runScriptPath) return opts.runScriptPath;
   const cwd = opts.cwd ?? process.cwd();
-  return path36.join(cwd, ".cleargate", "scripts", "run_script.sh");
+  return path37.join(cwd, ".cleargate", "scripts", "run_script.sh");
 }
 function deriveSprintBranch(sprintId) {
   const match = /^SPRINT-(\d+)/.exec(sprintId);
@@ -7932,7 +8143,7 @@ function atomicWriteString(filePath, text) {
   fs35.renameSync(tmpFile, filePath);
 }
 function stateJsonPath(cwd, sprintId) {
-  return path36.join(cwd, ".cleargate", "sprint-runs", sprintId, "state.json");
+  return path37.join(cwd, ".cleargate", "sprint-runs", sprintId, "state.json");
 }
 function storyStartHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
@@ -7949,7 +8160,7 @@ function storyStartHandler(opts, cli) {
     return printInertAndExit(stdoutFn, exitFn);
   }
   const sprintBranch = deriveSprintBranch(sprintId);
-  const worktreePath = path36.join(cwd, ".worktrees", opts.storyId);
+  const worktreePath = path37.join(cwd, ".worktrees", opts.storyId);
   const storyBranch = `story/${opts.storyId}`;
   const step1 = spawnFn(
     "git",
@@ -7966,9 +8177,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) {
@@ -8028,7 +8240,7 @@ function storyCompleteHandler(opts, cli) {
   }
   const sprintBranch = deriveSprintBranch(sprintId);
   const storyBranch = `story/${opts.storyId}`;
-  const worktreeRel = path36.join(".worktrees", opts.storyId);
+  const worktreeRel = path37.join(".worktrees", opts.storyId);
   const step1 = spawnFn(
     "git",
     ["rev-list", "--count", `${sprintBranch}..${storyBranch}`],
@@ -8106,9 +8318,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) {
@@ -8126,7 +8339,7 @@ function storyCompleteHandler(opts, cli) {
 
 // src/commands/state.ts
 init_cjs_shims();
-var path37 = __toESM(require("path"), 1);
+var path38 = __toESM(require("path"), 1);
 var import_node_child_process13 = require("child_process");
 function defaultExit3(code) {
   return process.exit(code);
@@ -8134,7 +8347,7 @@ function defaultExit3(code) {
 function resolveRunScript3(opts) {
   if (opts.runScriptPath) return opts.runScriptPath;
   const cwd = opts.cwd ?? process.cwd();
-  return path37.join(cwd, ".cleargate", "scripts", "run_script.sh");
+  return path38.join(cwd, ".cleargate", "scripts", "run_script.sh");
 }
 function stateUpdateHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
@@ -8151,9 +8364,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) {
@@ -8176,9 +8391,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) {
@@ -8192,20 +8409,20 @@ function stateValidateHandler(opts, cli) {
 // src/commands/stamp-tokens.ts
 init_cjs_shims();
 var fs37 = __toESM(require("fs"), 1);
-var path39 = __toESM(require("path"), 1);
+var path40 = __toESM(require("path"), 1);
 
 // src/lib/ledger-reader.ts
 init_cjs_shims();
 var fs36 = __toESM(require("fs"), 1);
-var path38 = __toESM(require("path"), 1);
+var path39 = __toESM(require("path"), 1);
 function findSprintRunsRoot(startDir) {
   let dir = startDir;
   while (true) {
-    const candidate = path38.join(dir, ".cleargate", "sprint-runs");
+    const candidate = path39.join(dir, ".cleargate", "sprint-runs");
     if (fs36.existsSync(candidate)) {
       return candidate;
     }
-    const parent = path38.dirname(dir);
+    const parent = path39.dirname(dir);
     if (parent === dir) {
       return null;
     }
@@ -8264,7 +8481,7 @@ function readLedgerForWorkItem(workItemId, opts = {}) {
   let ledgerFiles;
   try {
     const entries = fs36.readdirSync(sprintRunsRoot, { withFileTypes: true });
-    ledgerFiles = entries.filter((e) => e.isDirectory()).map((e) => path38.join(sprintRunsRoot, e.name, "token-ledger.jsonl")).filter((f) => fs36.existsSync(f));
+    ledgerFiles = entries.filter((e) => e.isDirectory()).map((e) => path39.join(sprintRunsRoot, e.name, "token-ledger.jsonl")).filter((f) => fs36.existsSync(f));
   } catch {
     return [];
   }
@@ -8323,7 +8540,7 @@ async function stampTokensHandler(file, opts, cli) {
   });
   const nowFn = cli?.now ?? (() => /* @__PURE__ */ new Date());
   const cwd = cli?.cwd ?? process.cwd();
-  const absPath = path39.isAbsolute(file) ? file : path39.resolve(cwd, file);
+  const absPath = path40.isAbsolute(file) ? file : path40.resolve(cwd, file);
   if (/\/\.cleargate\/delivery\/archive\//.test(absPath)) {
     stdoutFn(`[frozen] ${absPath}`);
     exitFn(0);
@@ -8413,21 +8630,21 @@ 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() !== "") {
       return val.trim();
     }
   }
-  const basename13 = path39.basename(absPath);
-  const match = basename13.match(/^(STORY|EPIC|PROPOSAL|CR|BUG)-\d+(-\d+)?/i);
+  const basename13 = path40.basename(absPath);
+  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();
     }
@@ -8527,7 +8744,7 @@ ${body}`;
 init_cjs_shims();
 var fs38 = __toESM(require("fs"), 1);
 var fsp = __toESM(require("fs/promises"), 1);
-var path40 = __toESM(require("path"), 1);
+var path41 = __toESM(require("path"), 1);
 
 // src/lib/changelog.ts
 init_cjs_shims();
@@ -8719,7 +8936,7 @@ async function writeAtomic2(filePath, content) {
   await fsp.rename(tmpPath, filePath);
 }
 async function updateSnapshotEntry(projectRoot, filePath, newSha) {
-  const snapshotPath = path40.join(projectRoot, ".cleargate", ".install-manifest.json");
+  const snapshotPath = path41.join(projectRoot, ".cleargate", ".install-manifest.json");
   let snapshot;
   try {
     const raw = await fsp.readFile(snapshotPath, "utf-8");
@@ -8736,17 +8953,17 @@ async function updateSnapshotEntry(projectRoot, filePath, newSha) {
   await writeAtomic2(snapshotPath, JSON.stringify(updated, null, 2) + "\n");
 }
 function isClaudeMd(filePath) {
-  return path40.basename(filePath) === "CLAUDE.md";
+  return path41.basename(filePath) === "CLAUDE.md";
 }
 function isSettingsJson(filePath) {
-  return path40.basename(filePath) === "settings.json" && filePath.includes(".claude");
+  return path41.basename(filePath) === "settings.json" && filePath.includes(".claude");
 }
 async function applyAlwaysOverwrite(entry, projectRoot, packageRoot, stdout) {
-  const targetPath = path40.join(projectRoot, entry.path);
-  const sourcePath = path40.join(packageRoot, entry.path);
+  const targetPath = path41.join(projectRoot, entry.path);
+  const sourcePath = path41.join(packageRoot, entry.path);
   try {
     const pkgContent = await fsp.readFile(sourcePath, "utf-8");
-    await fsp.mkdir(path40.dirname(targetPath), { recursive: true });
+    await fsp.mkdir(path41.dirname(targetPath), { recursive: true });
     await writeAtomic2(targetPath, pkgContent);
     await updateSnapshotEntry(projectRoot, entry.path, entry.sha256);
     stdout(`[always] overwritten: ${entry.path}`);
@@ -8756,8 +8973,8 @@ async function applyAlwaysOverwrite(entry, projectRoot, packageRoot, stdout) {
 }
 async function applyMerge3Way(entry, projectRoot, packageRoot, installSha, currentSha, flags, opts) {
   const { stdout, stderr, promptMergeChoiceFn, openInEditorFn, stdin } = opts;
-  const targetPath = path40.join(projectRoot, entry.path);
-  const sourcePath = path40.join(packageRoot, entry.path);
+  const targetPath = path41.join(projectRoot, entry.path);
+  const sourcePath = path41.join(packageRoot, entry.path);
   let ours = "";
   let theirs = "";
   try {
@@ -8820,7 +9037,7 @@ async function applyMerge3Way(entry, projectRoot, packageRoot, installSha, curre
         mergedContent = theirs;
       }
     }
-    await fsp.mkdir(path40.dirname(targetPath), { recursive: true });
+    await fsp.mkdir(path41.dirname(targetPath), { recursive: true });
     await writeAtomic2(targetPath, mergedContent);
     const newSha2 = hashNormalized(mergedContent);
     await updateSnapshotEntry(projectRoot, entry.path, newSha2);
@@ -8832,7 +9049,7 @@ async function applyMerge3Way(entry, projectRoot, packageRoot, installSha, curre
 ${ours}=======
 ${theirs}>>>>>>> theirs (upstream)
 `;
-  await fsp.mkdir(path40.dirname(mergeFilePath), { recursive: true });
+  await fsp.mkdir(path41.dirname(mergeFilePath), { recursive: true });
   await writeAtomic2(mergeFilePath, conflictContent);
   try {
     const result = await openInEditorFn(mergeFilePath);
@@ -8892,8 +9109,8 @@ async function upgradeHandler(flags, cli) {
     const installedVersion = installSnapshot?.cleargate_version ?? pkgManifest.cleargate_version;
     const targetVersion = pkgManifest.cleargate_version;
     if (installedVersion !== targetVersion) {
-      const pkgRoot = cli?.packageRoot ?? path40.join(path40.dirname(new URL(importMetaUrl).pathname), "..", "..");
-      const changelogPath = path40.join(pkgRoot, "CHANGELOG.md");
+      const pkgRoot = cli?.packageRoot ?? path41.join(path41.dirname(new URL(importMetaUrl).pathname), "..", "..");
+      const changelogPath = path41.join(pkgRoot, "CHANGELOG.md");
       try {
         const changelogContent = fs38.readFileSync(changelogPath, "utf-8");
         const sections = sliceChangelog(changelogContent, installedVersion, targetVersion);
@@ -8988,7 +9205,7 @@ async function upgradeHandler(flags, cli) {
 init_cjs_shims();
 var fs39 = __toESM(require("fs"), 1);
 var fsp2 = __toESM(require("fs/promises"), 1);
-var path41 = __toESM(require("path"), 1);
+var path42 = __toESM(require("path"), 1);
 var import_node_child_process15 = require("child_process");
 var USER_ARTIFACT_TIERS = ["user-artifact"];
 var FRAMEWORK_TIERS = ["protocol", "template", "agent", "hook", "skill", "cli-config", "derived"];
@@ -9014,7 +9231,7 @@ function shouldPreserve(entry, preserveSet, removeSet) {
   return false;
 }
 function resolveProjectName(target) {
-  const pkgPath = path41.join(target, "package.json");
+  const pkgPath = path42.join(target, "package.json");
   if (fs39.existsSync(pkgPath)) {
     try {
       const raw = fs39.readFileSync(pkgPath, "utf-8");
@@ -9025,7 +9242,7 @@ function resolveProjectName(target) {
     } catch {
     }
   }
-  return path41.basename(target);
+  return path42.basename(target);
 }
 function detectUncommittedChanges(target, manifestPaths, gitRunner) {
   const run = gitRunner ?? ((args) => {
@@ -9054,7 +9271,7 @@ function detectUncommittedChanges(target, manifestPaths, gitRunner) {
   return changedFiles.filter((f) => manifestSet.has(f));
 }
 async function removeFromPackageJson(target, dryRun) {
-  const pkgPath = path41.join(target, "package.json");
+  const pkgPath = path42.join(target, "package.json");
   if (!fs39.existsSync(pkgPath)) return false;
   let raw;
   try {
@@ -9116,10 +9333,10 @@ async function uninstallHandler(opts) {
     for (const t of FRAMEWORK_TIERS) removeSet.add(t);
     for (const u of USER_ARTIFACT_TIERS) removeSet.add(u);
   }
-  const target = opts.path ? path41.resolve(opts.path) : cwd;
-  const cleargateDir = path41.join(target, ".cleargate");
-  const manifestPath = path41.join(cleargateDir, ".install-manifest.json");
-  const uninstalledPath = path41.join(cleargateDir, ".uninstalled");
+  const target = opts.path ? path42.resolve(opts.path) : cwd;
+  const cleargateDir = path42.join(target, ".cleargate");
+  const manifestPath = path42.join(cleargateDir, ".install-manifest.json");
+  const uninstalledPath = path42.join(cleargateDir, ".uninstalled");
   if (!fs39.existsSync(manifestPath)) {
     if (fs39.existsSync(uninstalledPath)) {
       stdout("already uninstalled");
@@ -9152,7 +9369,7 @@ async function uninstallHandler(opts) {
       return;
     }
   }
-  const claudeMdPath = path41.join(target, "CLAUDE.md");
+  const claudeMdPath = path42.join(target, "CLAUDE.md");
   let claudeMdContent = null;
   if (fs39.existsSync(claudeMdPath)) {
     claudeMdContent = fs39.readFileSync(claudeMdPath, "utf-8");
@@ -9171,7 +9388,7 @@ async function uninstallHandler(opts) {
   const toPreserve = [];
   const toSkip = [];
   for (const entry of snapshot.files) {
-    const filePath = path41.join(target, entry.path);
+    const filePath = path42.join(target, entry.path);
     if (!fs39.existsSync(filePath)) {
       toSkip.push(entry);
       continue;
@@ -9229,7 +9446,7 @@ async function uninstallHandler(opts) {
   const removedPaths = [];
   const preservedPaths = [];
   for (const entry of toRemove) {
-    const filePath = path41.join(target, entry.path);
+    const filePath = path42.join(target, entry.path);
     await removeFile(filePath);
     removedPaths.push(entry.path);
   }
@@ -9245,7 +9462,7 @@ async function uninstallHandler(opts) {
       stderr(`Warning: could not strip CLAUDE.md block: ${err.message}`);
     }
   }
-  const settingsPath = path41.join(target, ".claude", "settings.json");
+  const settingsPath = path42.join(target, ".claude", "settings.json");
   if (fs39.existsSync(settingsPath)) {
     try {
       const raw = fs39.readFileSync(settingsPath, "utf-8");
@@ -9263,7 +9480,7 @@ async function uninstallHandler(opts) {
     stdout("Removed @cleargate/cli from package.json. Run `npm install` to update package-lock.json.");
   }
   await removeFile(manifestPath);
-  await removeFile(path41.join(cleargateDir, ".drift-state.json"));
+  await removeFile(path42.join(cleargateDir, ".drift-state.json"));
   const marker = {
     uninstalled_at: now().toISOString(),
     prior_version: snapshot.cleargate_version,
@@ -9288,16 +9505,16 @@ async function uninstallHandler(opts) {
 // src/commands/sync.ts
 init_cjs_shims();
 var fsPromises8 = __toESM(require("fs/promises"), 1);
-var path49 = __toESM(require("path"), 1);
+var path50 = __toESM(require("path"), 1);
 
 // src/lib/sync-log.ts
 init_cjs_shims();
 var fs40 = __toESM(require("fs"), 1);
 var fsPromises2 = __toESM(require("fs/promises"), 1);
-var path42 = __toESM(require("path"), 1);
+var path43 = __toESM(require("path"), 1);
 function resolveActiveSprintDir(projectRoot, _opts) {
-  const sprintRunsRoot = path42.join(projectRoot, ".cleargate", "sprint-runs");
-  const offSprint = path42.join(sprintRunsRoot, "_off-sprint");
+  const sprintRunsRoot = path43.join(projectRoot, ".cleargate", "sprint-runs");
+  const offSprint = path43.join(sprintRunsRoot, "_off-sprint");
   if (!fs40.existsSync(sprintRunsRoot)) {
     fs40.mkdirSync(sprintRunsRoot, { recursive: true });
     fs40.mkdirSync(offSprint, { recursive: true });
@@ -9305,7 +9522,7 @@ function resolveActiveSprintDir(projectRoot, _opts) {
   }
   const entries = fs40.readdirSync(sprintRunsRoot, { withFileTypes: true });
   const sprintDirs = entries.filter((e) => e.isDirectory() && e.name !== "_off-sprint").map((e) => {
-    const fullPath = path42.join(sprintRunsRoot, e.name);
+    const fullPath = path43.join(sprintRunsRoot, e.name);
     const stat = fs40.statSync(fullPath);
     return { name: e.name, fullPath, mtimeMs: stat.mtimeMs };
   }).sort((a, b) => b.mtimeMs - a.mtimeMs);
@@ -9322,7 +9539,7 @@ function redactDetail(detail) {
   return detail.replace(/eyJ[A-Za-z0-9._-]+/g, "[REDACTED]");
 }
 async function appendSyncLog(sprintRoot, entry) {
-  const logPath = path42.join(sprintRoot, "sync-log.jsonl");
+  const logPath = path43.join(sprintRoot, "sync-log.jsonl");
   await fsPromises2.mkdir(sprintRoot, { recursive: true });
   const safeEntry = {
     ...entry,
@@ -9332,7 +9549,7 @@ async function appendSyncLog(sprintRoot, entry) {
   await fsPromises2.appendFile(logPath, line, { encoding: "utf8" });
 }
 async function readSyncLog(sprintRoot, filters) {
-  const logPath = path42.join(sprintRoot, "sync-log.jsonl");
+  const logPath = path43.join(sprintRoot, "sync-log.jsonl");
   let raw;
   try {
     raw = await fsPromises2.readFile(logPath, "utf8");
@@ -9438,7 +9655,7 @@ function classify2(local, remote, since) {
 init_cjs_shims();
 var import_node_fs2 = require("fs");
 var os8 = __toESM(require("os"), 1);
-var path43 = __toESM(require("path"), 1);
+var path44 = __toESM(require("path"), 1);
 function promptFourChoice(opts) {
   const { stdin, stdout } = opts;
   stdout("[k]eep mine / [t]ake theirs / [e]dit in $EDITOR / [a]bort: ");
@@ -9508,7 +9725,7 @@ async function promptThreeWayMerge(opts) {
       case "a":
         return { resolution: "aborted", body: local };
       case "e": {
-        const tmpFile = path43.join(os8.tmpdir(), `cleargate-merge-${itemId}-${now()}.md`);
+        const tmpFile = path44.join(os8.tmpdir(), `cleargate-merge-${itemId}-${now()}.md`);
         const markerContent = `<<<<<<< local
 ${local}
 =======
@@ -9608,12 +9825,12 @@ init_config();
 // src/lib/intake.ts
 init_cjs_shims();
 var fsPromises4 = __toESM(require("fs/promises"), 1);
-var path45 = __toESM(require("path"), 1);
+var path46 = __toESM(require("path"), 1);
 
 // src/lib/slug.ts
 init_cjs_shims();
 var fsPromises3 = __toESM(require("fs/promises"), 1);
-var path44 = __toESM(require("path"), 1);
+var path45 = __toESM(require("path"), 1);
 function slugify(title, max = 40) {
   const normalized = title.normalize("NFKD").replace(new RegExp("\\p{M}", "gu"), "");
   const lowered = normalized.toLowerCase();
@@ -9628,8 +9845,8 @@ function slugify(title, max = 40) {
 var PROPOSAL_ID_RE = /^proposal_id:\s*"?PROP-(\d+)"?/m;
 async function nextProposalId(projectRoot) {
   const dirs = [
-    path44.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
-    path44.join(projectRoot, ".cleargate", "delivery", "archive")
+    path45.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
+    path45.join(projectRoot, ".cleargate", "delivery", "archive")
   ];
   let maxN = 0;
   for (const dir of dirs) {
@@ -9641,7 +9858,7 @@ async function nextProposalId(projectRoot) {
     }
     for (const entry of entries) {
       if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-      const fullPath = path44.join(dir, entry.name);
+      const fullPath = path45.join(dir, entry.name);
       try {
         const raw = await fsPromises3.readFile(fullPath, "utf8");
         const fmEnd = extractFrontmatterBlock(raw);
@@ -9659,8 +9876,8 @@ async function nextProposalId(projectRoot) {
 }
 async function findByRemoteId(projectRoot, remoteId) {
   const dirs = [
-    path44.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
-    path44.join(projectRoot, ".cleargate", "delivery", "archive")
+    path45.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
+    path45.join(projectRoot, ".cleargate", "delivery", "archive")
   ];
   const escaped = remoteId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const re = new RegExp(`^remote_id:\\s*"?${escaped}"?\\s*$`, "m");
@@ -9673,7 +9890,7 @@ async function findByRemoteId(projectRoot, remoteId) {
     }
     for (const entry of entries) {
       if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-      const fullPath = path44.join(dir, entry.name);
+      const fullPath = path45.join(dir, entry.name);
       try {
         const raw = await fsPromises3.readFile(fullPath, "utf8");
         const fm = extractFrontmatterBlock(raw);
@@ -9710,7 +9927,7 @@ async function runIntakeBranch(opts) {
     labelFilter = "cleargate:proposal",
     now = () => (/* @__PURE__ */ new Date()).toISOString()
   } = opts;
-  const pendingSyncDir = path45.join(projectRoot, ".cleargate", "delivery", "pending-sync");
+  const pendingSyncDir = path46.join(projectRoot, ".cleargate", "delivery", "pending-sync");
   let remoteItems = [];
   try {
     remoteItems = await mcp2.call(
@@ -9741,7 +9958,7 @@ async function runIntakeBranch(opts) {
       const slug2 = slugify(item.title ?? "untitled");
       const num2 = proposalId2.replace("PROP-", "");
       const filename2 = `PROPOSAL-${num2}-remote-${slug2}.md`;
-      const targetPath2 = path45.join(pendingSyncDir, filename2);
+      const targetPath2 = path46.join(pendingSyncDir, filename2);
       createdItems.push({
         proposalId: proposalId2,
         remoteId: item.remote_id,
@@ -9754,7 +9971,7 @@ async function runIntakeBranch(opts) {
     const num = proposalId.replace("PROP-", "");
     const slug = slugify(item.title ?? "untitled");
     const filename = `PROPOSAL-${num}-remote-${slug}.md`;
-    const targetPath = path45.join(pendingSyncDir, filename);
+    const targetPath = path46.join(pendingSyncDir, filename);
     const nowTs = now();
     const fm = {
       proposal_id: proposalId,
@@ -9846,8 +10063,8 @@ path/to/new/file.ext - {Explanation of purpose}
 }
 async function hasAnyRemoteAuthored(projectRoot) {
   const dirs = [
-    path45.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
-    path45.join(projectRoot, ".cleargate", "delivery", "archive")
+    path46.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
+    path46.join(projectRoot, ".cleargate", "delivery", "archive")
   ];
   for (const dir of dirs) {
     let entries;
@@ -9858,7 +10075,7 @@ async function hasAnyRemoteAuthored(projectRoot) {
     }
     for (const entry of entries) {
       if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-      const fullPath = path45.join(dir, entry.name);
+      const fullPath = path46.join(dir, entry.name);
       try {
         const raw = await fsPromises4.readFile(fullPath, "utf8");
         const fmEnd = raw.indexOf("\n---", 4);
@@ -9878,7 +10095,7 @@ async function hasAnyRemoteAuthored(projectRoot) {
 init_cjs_shims();
 var fs42 = __toESM(require("fs"), 1);
 var fsPromises5 = __toESM(require("fs/promises"), 1);
-var path46 = __toESM(require("path"), 1);
+var path47 = __toESM(require("path"), 1);
 async function resolveActiveItems(projectRoot, localItems, nowFn = () => (/* @__PURE__ */ new Date()).toISOString()) {
   const active = /* @__PURE__ */ new Set();
   const now = Date.parse(nowFn());
@@ -9903,7 +10120,7 @@ async function resolveInSprintIds(projectRoot) {
   const ids = /* @__PURE__ */ new Set();
   try {
     const sprintDir = resolveActiveSprintDir(projectRoot);
-    const sprintId = path46.basename(sprintDir);
+    const sprintId = path47.basename(sprintDir);
     if (sprintId === "_off-sprint") return ids;
     const sprintFile = await findSprintFile2(projectRoot, sprintId);
     if (!sprintFile) return ids;
@@ -9918,14 +10135,14 @@ async function resolveInSprintIds(projectRoot) {
   return ids;
 }
 async function findSprintFile2(projectRoot, sprintId) {
-  const pendingSync = path46.join(projectRoot, ".cleargate", "delivery", "pending-sync");
-  const archive = path46.join(projectRoot, ".cleargate", "delivery", "archive");
+  const pendingSync = path47.join(projectRoot, ".cleargate", "delivery", "pending-sync");
+  const archive = path47.join(projectRoot, ".cleargate", "delivery", "archive");
   for (const dir of [pendingSync, archive]) {
     try {
       const entries = fs42.readdirSync(dir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isFile() && entry.name.startsWith(sprintId) && entry.name.endsWith(".md")) {
-          return path46.join(dir, entry.name);
+          return path47.join(dir, entry.name);
         }
       }
     } catch {
@@ -9937,12 +10154,12 @@ async function findSprintFile2(projectRoot, sprintId) {
 // src/lib/comments-cache.ts
 init_cjs_shims();
 var fsPromises6 = __toESM(require("fs/promises"), 1);
-var path47 = __toESM(require("path"), 1);
+var path48 = __toESM(require("path"), 1);
 function cacheDir(projectRoot) {
-  return path47.join(projectRoot, ".cleargate", ".comments-cache");
+  return path48.join(projectRoot, ".cleargate", ".comments-cache");
 }
 function cachePath(projectRoot, remoteId) {
-  return path47.join(cacheDir(projectRoot), `${remoteId}.json`);
+  return path48.join(cacheDir(projectRoot), `${remoteId}.json`);
 }
 async function writeCommentCache(projectRoot, remoteId, comments) {
   const dir = cacheDir(projectRoot);
@@ -9957,7 +10174,7 @@ async function writeCommentCache(projectRoot, remoteId, comments) {
 // src/lib/wiki-comments-render.ts
 init_cjs_shims();
 var fsPromises7 = __toESM(require("fs/promises"), 1);
-var path48 = __toESM(require("path"), 1);
+var path49 = __toESM(require("path"), 1);
 var START = "<!-- cleargate:comments:start -->";
 var END = "<!-- cleargate:comments:end -->";
 function resolveBucket(fm) {
@@ -10002,7 +10219,7 @@ async function renderCommentsSection(opts) {
   const bucket = resolveBucket(localItem.fm);
   const primaryId = getPrimaryId(localItem.fm);
   if (!bucket || !primaryId) return;
-  const wikiPath = path48.join(
+  const wikiPath = path49.join(
     projectRoot,
     ".cleargate",
     "wiki",
@@ -10038,7 +10255,7 @@ async function renderCommentsSection(opts) {
   await writeAtomic4(wikiPath, updated);
 }
 async function writeAtomic4(filePath, content) {
-  await fsPromises7.mkdir(path48.dirname(filePath), { recursive: true });
+  await fsPromises7.mkdir(path49.dirname(filePath), { recursive: true });
   const tmpPath = `${filePath}.tmp.${Date.now()}`;
   await fsPromises7.writeFile(tmpPath, content, "utf8");
   await fsPromises7.rename(tmpPath, filePath);
@@ -10050,11 +10267,11 @@ async function syncCheckHandler(opts = {}) {
   const env = opts.env ?? process.env;
   const stdout = opts.stdout ?? ((s) => process.stdout.write(s));
   const nowFn = opts.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
-  const markerPath = path49.join(projectRoot, ".cleargate", ".sync-marker.json");
+  const markerPath = path50.join(projectRoot, ".cleargate", ".sync-marker.json");
   const updateMarker = async (nowIso2) => {
     try {
       const content = JSON.stringify({ last_check: nowIso2 });
-      await fsPromises8.mkdir(path49.dirname(markerPath), { recursive: true });
+      await fsPromises8.mkdir(path50.dirname(markerPath), { recursive: true });
       const tmpPath = `${markerPath}.tmp.${Date.now()}`;
       await fsPromises8.writeFile(tmpPath, content, "utf8");
       await fsPromises8.rename(tmpPath, markerPath);
@@ -10137,7 +10354,7 @@ async function syncHandler(opts = {}) {
   const nowFn = opts.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
   const identity = resolveIdentity(projectRoot);
   const sprintRoot = resolveActiveSprintDir(projectRoot);
-  const sprintId = path49.basename(sprintRoot);
+  const sprintId = path50.basename(sprintRoot);
   let mcp2;
   if (opts.mcp) {
     mcp2 = opts.mcp;
@@ -10198,7 +10415,7 @@ async function syncHandler(opts = {}) {
     exit(2);
     return;
   }
-  const wikiMetaPath = path49.join(projectRoot, ".cleargate", "wiki", "meta.json");
+  const wikiMetaPath = path50.join(projectRoot, ".cleargate", "wiki", "meta.json");
   let lastRemoteSync = "1970-01-01T00:00:00.000Z";
   try {
     const metaRaw = await fsPromises8.readFile(wikiMetaPath, "utf8");
@@ -10439,7 +10656,7 @@ async function syncHandler(opts = {}) {
     };
     await appendSyncLog(sprintRoot, entry);
   }
-  const conflictsFile = path49.join(projectRoot, ".cleargate", ".conflicts.json");
+  const conflictsFile = path50.join(projectRoot, ".cleargate", ".conflicts.json");
   const conflictsContent = {
     generated_at: nowFn(),
     sprint_id: sprintId,
@@ -10447,7 +10664,7 @@ async function syncHandler(opts = {}) {
   };
   await writeAtomic5(conflictsFile, JSON.stringify(conflictsContent, null, 2) + "\n");
   try {
-    await fsPromises8.mkdir(path49.dirname(wikiMetaPath), { recursive: true });
+    await fsPromises8.mkdir(path50.dirname(wikiMetaPath), { recursive: true });
     let meta = {};
     try {
       const raw = await fsPromises8.readFile(wikiMetaPath, "utf8");
@@ -10488,13 +10705,13 @@ async function applyPull(item, localPath, fm, actorEmail, nowFn) {
   await writeAtomic5(localPath, newContent);
 }
 async function writeAtomic5(filePath, content) {
-  await fsPromises8.mkdir(path49.dirname(filePath), { recursive: true });
+  await fsPromises8.mkdir(path50.dirname(filePath), { recursive: true });
   const tmpPath = `${filePath}.tmp.${Date.now()}`;
   await fsPromises8.writeFile(tmpPath, content, "utf8");
   await fsPromises8.rename(tmpPath, filePath);
 }
 async function scanLocalItems(projectRoot) {
-  const pendingSync = path49.join(projectRoot, ".cleargate", "delivery", "pending-sync");
+  const pendingSync = path50.join(projectRoot, ".cleargate", "delivery", "pending-sync");
   const results = [];
   let entries;
   try {
@@ -10504,7 +10721,7 @@ async function scanLocalItems(projectRoot) {
   }
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-    const fullPath = path49.join(pendingSync, entry.name);
+    const fullPath = path50.join(pendingSync, entry.name);
     try {
       const raw = await fsPromises8.readFile(fullPath, "utf8");
       const { fm, body } = parseFrontmatter(raw);
@@ -10532,7 +10749,7 @@ init_config();
 // src/lib/sync/work-items.ts
 init_cjs_shims();
 var fsPromises9 = __toESM(require("fs/promises"), 1);
-var path50 = __toESM(require("path"), 1);
+var path51 = __toESM(require("path"), 1);
 var import_node_crypto2 = require("crypto");
 var BATCH_SIZE = 100;
 var ATTRIBUTION_FIELDS = /* @__PURE__ */ new Set([
@@ -10580,8 +10797,8 @@ function getItemId2(fm) {
 }
 async function walkDeliveryDirs(projectRoot) {
   const dirs = [
-    path50.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
-    path50.join(projectRoot, ".cleargate", "delivery", "archive")
+    path51.join(projectRoot, ".cleargate", "delivery", "pending-sync"),
+    path51.join(projectRoot, ".cleargate", "delivery", "archive")
   ];
   const results = [];
   for (const dir of dirs) {
@@ -10593,7 +10810,7 @@ async function walkDeliveryDirs(projectRoot) {
     }
     for (const entry of entries) {
       if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-      const fullPath = path50.join(dir, entry.name);
+      const fullPath = path51.join(dir, entry.name);
       try {
         const raw = await fsPromises9.readFile(fullPath, "utf8");
         const { fm, body } = parseFrontmatter(raw);
@@ -10618,7 +10835,7 @@ async function walkDeliveryDirs(projectRoot) {
   return results;
 }
 async function writeAtomic6(filePath, content) {
-  await fsPromises9.mkdir(path50.dirname(filePath), { recursive: true });
+  await fsPromises9.mkdir(path51.dirname(filePath), { recursive: true });
   const tmpPath = `${filePath}.tmp.${Date.now()}`;
   await fsPromises9.writeFile(tmpPath, content, "utf8");
   await fsPromises9.rename(tmpPath, filePath);
@@ -10687,7 +10904,7 @@ async function syncWorkItems(opts) {
 init_cjs_shims();
 var fs43 = __toESM(require("fs"), 1);
 var os9 = __toESM(require("os"), 1);
-var path51 = __toESM(require("path"), 1);
+var path52 = __toESM(require("path"), 1);
 var DEFAULT_BASE = "https://admin.cleargate.soula.ge/";
 function adminUrl(urlPath, opts) {
   const env = opts?.env ?? process.env;
@@ -10710,7 +10927,7 @@ function adminUrl(urlPath, opts) {
 function readLocalConfig() {
   const home = os9.homedir();
   if (!home) return null;
-  const configPath = path51.join(home, ".cleargate", "config.json");
+  const configPath = path52.join(home, ".cleargate", "config.json");
   const raw = fs43.readFileSync(configPath, "utf8");
   return JSON.parse(raw);
 }
@@ -10826,7 +11043,7 @@ async function syncWorkItemsHandler(opts = {}) {
 // src/commands/pull.ts
 init_cjs_shims();
 var fsPromises10 = __toESM(require("fs/promises"), 1);
-var path52 = __toESM(require("path"), 1);
+var path53 = __toESM(require("path"), 1);
 init_acquire();
 init_config();
 async function pullHandler(idOrRemoteId, opts = {}) {
@@ -10941,7 +11158,7 @@ async function pullHandler(idOrRemoteId, opts = {}) {
     result: "ok"
   };
   await appendSyncLog(sprintRoot, entry);
-  stdout(`pull: ${remoteId} applied to ${path52.relative(projectRoot, localPath)}
+  stdout(`pull: ${remoteId} applied to ${path53.relative(projectRoot, localPath)}
 `);
   if (opts.comments) {
     const comments = await mcp2.call(
@@ -10964,7 +11181,7 @@ async function resolveRemoteId(idOrRemoteId, projectRoot) {
   if (/^[A-Z]+-\d+/.test(idOrRemoteId)) {
     return idOrRemoteId;
   }
-  const pendingSync = path52.join(projectRoot, ".cleargate", "delivery", "pending-sync");
+  const pendingSync = path53.join(projectRoot, ".cleargate", "delivery", "pending-sync");
   let entries;
   try {
     entries = await fsPromises10.readdir(pendingSync, { withFileTypes: true });
@@ -10974,7 +11191,7 @@ async function resolveRemoteId(idOrRemoteId, projectRoot) {
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
     try {
-      const raw = await fsPromises10.readFile(path52.join(pendingSync, entry.name), "utf8");
+      const raw = await fsPromises10.readFile(path53.join(pendingSync, entry.name), "utf8");
       const { fm } = parseFrontmatter(raw);
       for (const key of ["story_id", "epic_id", "proposal_id", "cr_id", "bug_id"]) {
         if (fm[key] === idOrRemoteId && typeof fm["remote_id"] === "string") {
@@ -10987,7 +11204,7 @@ async function resolveRemoteId(idOrRemoteId, projectRoot) {
   return null;
 }
 async function findLocalFile(remoteId, projectRoot) {
-  const pendingSync = path52.join(projectRoot, ".cleargate", "delivery", "pending-sync");
+  const pendingSync = path53.join(projectRoot, ".cleargate", "delivery", "pending-sync");
   let entries;
   try {
     entries = await fsPromises10.readdir(pendingSync, { withFileTypes: true });
@@ -10996,7 +11213,7 @@ async function findLocalFile(remoteId, projectRoot) {
   }
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-    const fullPath = path52.join(pendingSync, entry.name);
+    const fullPath = path53.join(pendingSync, entry.name);
     try {
       const raw = await fsPromises10.readFile(fullPath, "utf8");
       const { fm } = parseFrontmatter(raw);
@@ -11007,7 +11224,7 @@ async function findLocalFile(remoteId, projectRoot) {
   return null;
 }
 async function writeAtomic7(filePath, content) {
-  await fsPromises10.mkdir(path52.dirname(filePath), { recursive: true });
+  await fsPromises10.mkdir(path53.dirname(filePath), { recursive: true });
   const tmpPath = `${filePath}.tmp.${Date.now()}`;
   await fsPromises10.writeFile(tmpPath, content, "utf8");
   await fsPromises10.rename(tmpPath, filePath);
@@ -11023,7 +11240,7 @@ function getItemId3(fm) {
 // src/commands/push.ts
 init_cjs_shims();
 var fsPromises11 = __toESM(require("fs/promises"), 1);
-var path53 = __toESM(require("path"), 1);
+var path54 = __toESM(require("path"), 1);
 init_acquire();
 init_config();
 async function pushHandler(fileOrId, opts = {}) {
@@ -11099,7 +11316,7 @@ async function pushHandler(fileOrId, opts = {}) {
 }
 async function handlePush(filePath, ctx) {
   const { projectRoot, identity, sprintRoot, nowFn, resolveMcp, stdout, stderr, exit } = ctx;
-  const resolvedPath = path53.isAbsolute(filePath) ? filePath : path53.resolve(projectRoot, filePath);
+  const resolvedPath = path54.isAbsolute(filePath) ? filePath : path54.resolve(projectRoot, filePath);
   let rawContent;
   try {
     rawContent = await fsPromises11.readFile(resolvedPath, "utf8");
@@ -11225,8 +11442,8 @@ async function handleRevert(idOrRemoteId, ctx) {
   void localPath;
 }
 async function resolveLocalItem(idOrRemoteId, projectRoot) {
-  const pendingSync = path53.join(projectRoot, ".cleargate", "delivery", "pending-sync");
-  const archive = path53.join(projectRoot, ".cleargate", "delivery", "archive");
+  const pendingSync = path54.join(projectRoot, ".cleargate", "delivery", "pending-sync");
+  const archive = path54.join(projectRoot, ".cleargate", "delivery", "archive");
   for (const dir of [pendingSync, archive]) {
     let entries;
     try {
@@ -11236,7 +11453,7 @@ async function resolveLocalItem(idOrRemoteId, projectRoot) {
     }
     for (const entry of entries) {
       if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-      const fullPath = path53.join(dir, entry.name);
+      const fullPath = path54.join(dir, entry.name);
       try {
         const raw = await fsPromises11.readFile(fullPath, "utf8");
         const { fm } = parseFrontmatter(raw);
@@ -11255,7 +11472,7 @@ async function resolveLocalItem(idOrRemoteId, projectRoot) {
   return null;
 }
 async function writeAtomic8(filePath, content) {
-  await fsPromises11.mkdir(path53.dirname(filePath), { recursive: true });
+  await fsPromises11.mkdir(path54.dirname(filePath), { recursive: true });
   const tmpPath = `${filePath}.tmp.${Date.now()}`;
   await fsPromises11.writeFile(tmpPath, content, "utf8");
   await fsPromises11.rename(tmpPath, filePath);
@@ -11284,7 +11501,7 @@ function getItemType2(fm) {
 // src/commands/conflicts.ts
 init_cjs_shims();
 var fsPromises12 = __toESM(require("fs/promises"), 1);
-var path54 = __toESM(require("path"), 1);
+var path55 = __toESM(require("path"), 1);
 init_acquire();
 init_config();
 var RESOLUTION_HINTS = {
@@ -11322,7 +11539,7 @@ async function conflictsHandler(opts = {}) {
       }
     }
   }
-  const conflictsFile = path54.join(projectRoot, ".cleargate", ".conflicts.json");
+  const conflictsFile = path55.join(projectRoot, ".cleargate", ".conflicts.json");
   let data;
   try {
     const raw = await fsPromises12.readFile(conflictsFile, "utf8");
@@ -11411,7 +11628,7 @@ function formatEntry(entry) {
 // src/commands/admin-login.ts
 init_cjs_shims();
 var fs44 = __toESM(require("fs"), 1);
-var path55 = __toESM(require("path"), 1);
+var path56 = __toESM(require("path"), 1);
 var os10 = __toESM(require("os"), 1);
 var DEFAULT_MCP_URL = "http://localhost:3000";
 function resolveMcpUrl(mcpUrlFlag, env) {
@@ -11420,10 +11637,10 @@ function resolveMcpUrl(mcpUrlFlag, env) {
 function resolveAuthFilePath(opts) {
   if (opts.authFilePath) return opts.authFilePath;
   const homedirFn = opts.homedir ?? os10.homedir;
-  return path55.join(homedirFn(), ".cleargate", "admin-auth.json");
+  return path56.join(homedirFn(), ".cleargate", "admin-auth.json");
 }
 function writeAdminAuth(filePath, token) {
-  const dir = path55.dirname(filePath);
+  const dir = path56.dirname(filePath);
   fs44.mkdirSync(dir, { recursive: true });
   const payload = JSON.stringify({ version: 1, token }, null, 2);
   fs44.writeFileSync(filePath, payload, { encoding: "utf8", mode: 384 });
@@ -11538,7 +11755,7 @@ async function adminLoginHandler(opts = {}) {
 // src/commands/hotfix.ts
 init_cjs_shims();
 var fs45 = __toESM(require("fs"), 1);
-var path56 = __toESM(require("path"), 1);
+var path57 = __toESM(require("path"), 1);
 function defaultExit4(code) {
   return process.exit(code);
 }
@@ -11562,8 +11779,8 @@ function maxHotfixId(pendingDir) {
   return max;
 }
 function countActiveHotfixes(repoRoot) {
-  const pendingDir = path56.join(repoRoot, ".cleargate", "delivery", "pending-sync");
-  const archiveDir = path56.join(repoRoot, ".cleargate", "delivery", "archive");
+  const pendingDir = path57.join(repoRoot, ".cleargate", "delivery", "pending-sync");
+  const archiveDir = path57.join(repoRoot, ".cleargate", "delivery", "archive");
   const sevenDaysAgo = Date.now() - 7 * 24 * 60 * 60 * 1e3;
   let count = 0;
   let pendingEntries = [];
@@ -11582,7 +11799,7 @@ function countActiveHotfixes(repoRoot) {
   for (const entry of archiveEntries) {
     if (entry.startsWith("HOTFIX-") && entry.endsWith(".md")) {
       try {
-        const stat = fs45.statSync(path56.join(archiveDir, entry));
+        const stat = fs45.statSync(path57.join(archiveDir, entry));
         if (stat.mtimeMs >= sevenDaysAgo) count++;
       } catch {
       }
@@ -11591,7 +11808,7 @@ function countActiveHotfixes(repoRoot) {
   return count;
 }
 function resolveTemplatePath(repoRoot) {
-  return path56.join(repoRoot, ".cleargate", "templates", "hotfix.md");
+  return path57.join(repoRoot, ".cleargate", "templates", "hotfix.md");
 }
 function hotfixNewHandler(opts, cli) {
   const stdoutFn = cli?.stdout ?? ((s) => process.stdout.write(s + "\n"));
@@ -11610,7 +11827,7 @@ function hotfixNewHandler(opts, cli) {
     );
     return exitFn(1);
   }
-  const pendingDir = path56.join(repoRoot, ".cleargate", "delivery", "pending-sync");
+  const pendingDir = path57.join(repoRoot, ".cleargate", "delivery", "pending-sync");
   const maxId = maxHotfixId(pendingDir);
   const nextId = maxId + 1;
   const idStr = `HOTFIX-${String(nextId).padStart(3, "0")}`;
@@ -11625,7 +11842,7 @@ function hotfixNewHandler(opts, cli) {
   const content = templateContent.replace(/\{ID\}/g, idStr).replace(/\{SLUG\}/g, opts.slug).replace(/\{ISO\}/g, now);
   const fileSlug = opts.slug.replace(/-/g, "_");
   const fileName = `${idStr}_${fileSlug}.md`;
-  const outPath = path56.join(pendingDir, fileName);
+  const outPath = path57.join(pendingDir, fileName);
   try {
     fs45.mkdirSync(pendingDir, { recursive: true });
     fs45.writeFileSync(outPath, content, "utf8");