cleargate 0.12.0 → 0.13.0

package/dist/MANIFEST.json

@@ -1,6 +1,6 @@
 {
-  "cleargate_version": "0.12.0",
-  "generated_at": "2026-05-15T05:10:35.575Z",
+  "cleargate_version": "0.13.0",
+  "generated_at": "2026-05-18T17:11:10.027Z",
   "files": [
     {
       "path": ".claude/agents/architect.md",
@@ -25,7 +25,7 @@
     },
     {
       "path": ".claude/agents/cleargate-wiki-lint.md",
-      "sha256": "42067fd728e64ac1ff1ace5822b8f8c3ddf1ba70fd0fbddf0e8cb19d5d699e77",
+      "sha256": "2a9212d81df9a68e167ec7a18093a73c6da0208f13685c6887d5bd832b56fb3d",
       "tier": "agent",
       "overwrite_policy": "always",
       "preserve_on_uninstall": false
@@ -39,7 +39,7 @@
     },
     {
       "path": ".claude/agents/developer.md",
-      "sha256": "36f75fe9f8dc8412eb22706dfd021f5db5694c81d73e0c938e701a83c0149126",
+      "sha256": "db7963778d68654f2dc96658d60433fa79305a10eec937807f2f0ed0cd05ce89",
       "tier": "agent",
       "overwrite_policy": "always",
       "preserve_on_uninstall": false
@@ -74,7 +74,7 @@
     },
     {
       "path": ".claude/hooks/pre-commit-surface-gate.sh",
-      "sha256": "6741422cd8ca75b45e26bd0e9cb54126ad9e933f763c9094ceba6b84794b761a",
+      "sha256": "8dd817fbe75ee53753e2fe1fc2ccd2b6efdb2b3c0b6ad3191bebd9640afdd6f8",
       "tier": "hook",
       "overwrite_policy": "always",
       "preserve_on_uninstall": false
@@ -200,7 +200,7 @@
     },
     {
       "path": ".cleargate/scripts/close_sprint.mjs",
-      "sha256": "b42018973ec6f02fc5d0ddf2a7d302aa0ee6d127cb5140474a67cb1fb0af6b28",
+      "sha256": "b14b65f15c5ad57a845df89c069b5417195651b7d3aa7f7f5736416d0db0b868",
       "tier": "script",
       "overwrite_policy": "always",
       "preserve_on_uninstall": false
@@ -396,35 +396,35 @@
     },
     {
       "path": ".cleargate/templates/Bug.md",
-      "sha256": "570112e3a60856c891652837307fc6f296cc39acc20451f8bde62da0fe033026",
+      "sha256": "cebca344b6b820525c603444cf52626e120ebaa1ac28da099dc19c9cff39302c",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false
     },
     {
       "path": ".cleargate/templates/CR.md",
-      "sha256": "ab111792dc79fd5181b44a63c76ac696fa4e456161ac44e2c4d0dc609e8dd904",
+      "sha256": "ea5acf2087808e0d52806a87a6a7f1ced7473b591857f322fab5285adc80d25a",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false
     },
     {
       "path": ".cleargate/templates/epic.md",
-      "sha256": "fd3b54de89befe7c5bcef65e2fa5550fc7f371d55c8f15143ae73d84f3ae6d36",
+      "sha256": "f9cf44db19288f0756b76bc8b13a075d4089990324db6febd072f5cf93d59cd0",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false
     },
     {
       "path": ".cleargate/templates/hotfix.md",
-      "sha256": "b75dd154c156e68a44ae01b85eff7ec16f54050e4fe7eb71f59e17d87c03a298",
+      "sha256": "de788497b4d224500036773f854801c056d73b08c3c0d66fdb641f17a1610bca",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false
     },
     {
       "path": ".cleargate/templates/initiative.md",
-      "sha256": "28680917228e5d9887c8820193cc21bfecc6aad3bc0658e8a59087adf63551fd",
+      "sha256": "1170e595f5813c62f86212d6ca1955d84465f396c81aaf34498b8e2d4595d681",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false
@@ -445,14 +445,14 @@
     },
     {
       "path": ".cleargate/templates/sprint_report.md",
-      "sha256": "84e32e956eb1e8a9c97be1c346b695df316a9e47e17402f3d6581e3ffdbc4d2d",
+      "sha256": "5914d54080f6110be5a5e905e3312811f3d0f80978121b1e15707d5be05cc5b1",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false
     },
     {
       "path": ".cleargate/templates/story.md",
-      "sha256": "56d793983614d832e84193d99ee5318c061d2f3ea4f019cefb861c026513cb31",
+      "sha256": "0badf01a080bca552a06fb64becd9b8c88fbf104e30f32667263522c3ff81051",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false

package/dist/{chunk-HZPJ5QX4.js → chunk-EG6YGT2O.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/lib/lifecycle-reconcile.ts
-import * as fs from "fs";
-import * as path from "path";
+import * as fs2 from "fs";
+import * as path2 from "path";
 import { spawnSync } from "child_process";
 
 // src/wiki/parse-frontmatter.ts
@@ -44,25 +44,305 @@ function parseFrontmatter(raw) {
   return { fm: parsed, body };
 }
 
+// src/lib/parent-rollup.ts
+import * as fs from "fs";
+import * as path from "path";
+function readFm(filePath) {
+  try {
+    const raw = fs.readFileSync(filePath, "utf8");
+    const { fm } = parseFrontmatter(raw);
+    return fm;
+  } catch {
+    return null;
+  }
+}
+function extractId(fm, filePath) {
+  for (const key of [
+    "story_id",
+    "epic_id",
+    "sprint_id",
+    "bug_id",
+    "cr_id",
+    "initiative_id",
+    "hotfix_id"
+  ]) {
+    const val = fm[key];
+    if (typeof val === "string" && val.trim() !== "") return val.trim();
+  }
+  const stem = path.basename(filePath, ".md");
+  return stem.split("_")[0] ?? stem;
+}
+function enumerateChildren(parentId, deliveryRoot, archiveRoot, fmCache) {
+  const pendingSyncDir = path.join(deliveryRoot, "pending-sync");
+  const results = [];
+  const pools = [];
+  if (fs.existsSync(archiveRoot)) pools.push(archiveRoot);
+  if (fs.existsSync(pendingSyncDir)) pools.push(pendingSyncDir);
+  for (const dir of pools) {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir);
+    } catch {
+      entries = [];
+    }
+    for (const entry of entries) {
+      if (!entry.endsWith(".md")) continue;
+      const absPath = path.join(dir, entry);
+      let fm = fmCache.get(absPath);
+      if (fm === void 0) {
+        const parsed = readFm(absPath);
+        if (parsed === null) continue;
+        fm = parsed;
+        fmCache.set(absPath, fm);
+      }
+      const parentCleargateId = fm["parent_cleargate_id"];
+      const parentEpicRef = fm["parent_epic_ref"];
+      const isChild = typeof parentCleargateId === "string" && parentCleargateId.trim() === parentId || typeof parentEpicRef === "string" && parentEpicRef.trim() === parentId;
+      if (!isChild) continue;
+      const childId = extractId(fm, absPath);
+      const status = typeof fm["status"] === "string" ? fm["status"].trim() : "";
+      results.push({ id: childId, status });
+    }
+  }
+  return results;
+}
+async function rollUpParentStatusInternal(parentFilePath, opts, visited, fmCache) {
+  const { deliveryRoot, archiveRoot } = opts;
+  let fm = fmCache.get(parentFilePath);
+  if (fm === void 0) {
+    const raw = readFm(parentFilePath);
+    if (raw === null) {
+      throw new Error(`parent-rollup: cannot read frontmatter from ${parentFilePath}`);
+    }
+    fm = raw;
+    fmCache.set(parentFilePath, fm);
+  }
+  const parentId = extractId(fm, parentFilePath);
+  const currentStatus = typeof fm["status"] === "string" ? fm["status"].trim() : "";
+  if (ARTIFACT_TERMINAL_STATUSES.has(currentStatus)) {
+    return {
+      parent_id: parentId,
+      parent_path: parentFilePath,
+      current_status: currentStatus,
+      proposed_status: null,
+      coverage: "full",
+      terminal_children: [],
+      pending_children: [],
+      verdict: "no-op"
+    };
+  }
+  if (visited.has(parentId)) {
+    throw new Error(`parent-rollup: sub_epics cycle detected at ${parentId}`);
+  }
+  visited.add(parentId);
+  const subEpicsField = fm["sub_epics"];
+  const subEpics = Array.isArray(subEpicsField) && subEpicsField.length > 0 ? subEpicsField.filter((s) => typeof s === "string") : [];
+  if (subEpics.length > 0) {
+    const pendingSyncDir = path.join(deliveryRoot, "pending-sync");
+    const terminalSubEpics = [];
+    const pendingSubEpics = [];
+    for (const subEpicId of subEpics) {
+      let subEpicPath = null;
+      const candidateDirs = [pendingSyncDir, archiveRoot];
+      for (const dir of candidateDirs) {
+        if (!fs.existsSync(dir)) continue;
+        let entries;
+        try {
+          entries = fs.readdirSync(dir);
+        } catch {
+          entries = [];
+        }
+        for (const entry of entries) {
+          if (!entry.endsWith(".md")) continue;
+          const absPath = path.join(dir, entry);
+          let subFm2 = fmCache.get(absPath);
+          if (subFm2 === void 0) {
+            const parsed = readFm(absPath);
+            if (parsed === null) continue;
+            subFm2 = parsed;
+            fmCache.set(absPath, subFm2);
+          }
+          const entryId = extractId(subFm2, absPath);
+          if (entryId === subEpicId) {
+            subEpicPath = absPath;
+            break;
+          }
+        }
+        if (subEpicPath !== null) break;
+      }
+      if (subEpicPath === null) {
+        pendingSubEpics.push(subEpicId);
+        continue;
+      }
+      let subFm = fmCache.get(subEpicPath);
+      if (subFm === void 0) {
+        const parsed = readFm(subEpicPath);
+        if (parsed === null) {
+          pendingSubEpics.push(subEpicId);
+          continue;
+        }
+        subFm = parsed;
+        fmCache.set(subEpicPath, subFm);
+      }
+      const subStatus = typeof subFm["status"] === "string" ? subFm["status"].trim() : "";
+      if (subStatus === "DEFERRED") {
+        continue;
+      }
+      if (ARTIFACT_TERMINAL_STATUSES.has(subStatus)) {
+        terminalSubEpics.push(subEpicId);
+        continue;
+      }
+      const visitedSnapshot = new Set(visited);
+      const subResult = await rollUpParentStatusInternal(
+        subEpicPath,
+        opts,
+        visitedSnapshot,
+        fmCache
+      );
+      if (subResult.verdict === "auto-flip" || subResult.verdict === "no-op") {
+        terminalSubEpics.push(subEpicId);
+      } else {
+        pendingSubEpics.push(subEpicId);
+      }
+    }
+    visited.delete(parentId);
+    const total2 = terminalSubEpics.length + pendingSubEpics.length;
+    if (total2 === 0) {
+      return {
+        parent_id: parentId,
+        parent_path: parentFilePath,
+        current_status: currentStatus,
+        proposed_status: null,
+        coverage: "zero",
+        terminal_children: [],
+        pending_children: [],
+        verdict: "halt-zero-children",
+        halt_reason: `${parentId}: 0 children drafted; not reconcilable \u2014 decompose or abandon`
+      };
+    }
+    if (pendingSubEpics.length === 0) {
+      return {
+        parent_id: parentId,
+        parent_path: parentFilePath,
+        current_status: currentStatus,
+        proposed_status: "Completed",
+        coverage: "full",
+        terminal_children: terminalSubEpics,
+        pending_children: [],
+        verdict: "auto-flip"
+      };
+    }
+    return {
+      parent_id: parentId,
+      parent_path: parentFilePath,
+      current_status: currentStatus,
+      proposed_status: null,
+      coverage: "sub-epic-partial",
+      terminal_children: terminalSubEpics,
+      pending_children: pendingSubEpics,
+      verdict: "halt-partial",
+      halt_reason: `${parentId}: ${terminalSubEpics.length}/${total2} sub-epics terminal \u2014 pending: ${pendingSubEpics.join(", ")}`
+    };
+  }
+  const children = enumerateChildren(parentId, deliveryRoot, archiveRoot, fmCache);
+  visited.delete(parentId);
+  if (children.length === 0) {
+    return {
+      parent_id: parentId,
+      parent_path: parentFilePath,
+      current_status: currentStatus,
+      proposed_status: null,
+      coverage: "zero",
+      terminal_children: [],
+      pending_children: [],
+      verdict: "halt-zero-children",
+      halt_reason: `${parentId}: 0 children drafted; not reconcilable \u2014 decompose or abandon`
+    };
+  }
+  const terminalChildren = [];
+  const pendingChildren = [];
+  for (const child of children) {
+    if (ARTIFACT_TERMINAL_STATUSES.has(child.status)) {
+      terminalChildren.push(child.id);
+    } else {
+      pendingChildren.push(child.id);
+    }
+  }
+  const total = terminalChildren.length + pendingChildren.length;
+  if (pendingChildren.length === 0) {
+    return {
+      parent_id: parentId,
+      parent_path: parentFilePath,
+      current_status: currentStatus,
+      proposed_status: "Completed",
+      coverage: "full",
+      terminal_children: terminalChildren,
+      pending_children: [],
+      verdict: "auto-flip"
+    };
+  }
+  return {
+    parent_id: parentId,
+    parent_path: parentFilePath,
+    current_status: currentStatus,
+    proposed_status: null,
+    coverage: "partial",
+    terminal_children: terminalChildren,
+    pending_children: pendingChildren,
+    verdict: "halt-partial",
+    halt_reason: `${parentId}: ${terminalChildren.length}/${total} children terminal \u2014 pending: ${pendingChildren.join(", ")}`
+  };
+}
+async function rollUpParentStatus(parentFilePath, opts) {
+  const visited = /* @__PURE__ */ new Set();
+  const fmCache = /* @__PURE__ */ new Map();
+  return rollUpParentStatusInternal(parentFilePath, opts, visited, fmCache);
+}
+async function walkActiveParents(opts) {
+  const { deliveryRoot } = opts;
+  const pendingSyncDir = path.join(deliveryRoot, "pending-sync");
+  let entries;
+  try {
+    entries = fs.readdirSync(pendingSyncDir);
+  } catch {
+    return [];
+  }
+  const parentFiles = entries.filter(
+    (e) => e.endsWith(".md") && (e.startsWith("EPIC-") || e.startsWith("SPRINT-"))
+  );
+  const results = [];
+  const fmCache = /* @__PURE__ */ new Map();
+  for (const entry of parentFiles) {
+    const absPath = path.join(pendingSyncDir, entry);
+    try {
+      const visited = /* @__PURE__ */ new Set();
+      const result = await rollUpParentStatusInternal(absPath, opts, visited, fmCache);
+      results.push(result);
+    } catch (err) {
+      if (err instanceof Error && err.message.includes("sub_epics cycle detected")) {
+        throw err;
+      }
+    }
+  }
+  return results;
+}
+
 // src/lib/lifecycle-reconcile.ts
 var ARTIFACT_TERMINAL_STATUSES = /* @__PURE__ */ new Set([
-  "Done",
   "Completed",
-  "Verified",
   "Abandoned",
   "Closed",
-  "Resolved",
-  "Escalated",
-  "Parking Lot"
+  "Resolved"
 ]);
+var ARTIFACT_GATE_EXPECTED = ["Completed"];
 var VERB_STATUS_MAP = {
   feat: {
     types: ["STORY", "EPIC", "CR"],
-    expected: ["Done", "Completed"]
+    expected: [...ARTIFACT_GATE_EXPECTED]
   },
   fix: {
     types: ["BUG", "HOTFIX"],
-    expected: ["Verified", "Done", "Completed"]
+    expected: [...ARTIFACT_GATE_EXPECTED]
   }
 };
 var ID_PATTERN = /\b(STORY-\d{3}-\d{2}|(CR|BUG|EPIC|HOTFIX)-\d{3}|(PROPOSAL|PROP)-\d{3})\b/g;
@@ -113,10 +393,10 @@ function findArtifactFile(deliveryRoot, id) {
     { rel: "archive", inArchive: true }
   ];
   for (const { rel, inArchive } of dirs) {
-    const dir = path.join(deliveryRoot, rel);
+    const dir = path2.join(deliveryRoot, rel);
     let entries;
     try {
-      entries = fs.readdirSync(dir);
+      entries = fs2.readdirSync(dir);
     } catch {
       continue;
     }
@@ -124,7 +404,7 @@ function findArtifactFile(deliveryRoot, id) {
       (e) => (e.startsWith(prefix) || e === `${id}.md`) && e.endsWith(".md")
     );
     if (match) {
-      const absPath = path.join(dir, match);
+      const absPath = path2.join(dir, match);
       return { absPath, inArchive, relPath: `${rel}/${match}` };
     }
   }
@@ -133,7 +413,7 @@ function findArtifactFile(deliveryRoot, id) {
 function readArtifactStatus(absPath) {
   let raw;
   try {
-    raw = fs.readFileSync(absPath, "utf8");
+    raw = fs2.readFileSync(absPath, "utf8");
   } catch {
     return { status: null, carryOver: false };
   }
@@ -188,7 +468,7 @@ function reconcileLifecycle(opts) {
         if (carryOver) continue;
         let expectedStatuses;
         if (verb === "feat" && type === "BUG") {
-          expectedStatuses = ["Verified", "Done", "Completed"];
+          expectedStatuses = [...ARTIFACT_GATE_EXPECTED];
         } else if (!verbConfig.types.includes(type)) {
           continue;
         } else {
@@ -200,7 +480,7 @@ function reconcileLifecycle(opts) {
           cleanIds.add(id);
           idToItem.delete(id);
         } else if (!idToItem.has(id)) {
-          const expectedStr = expectedStatuses[0] ?? "Done";
+          const expectedStr = expectedStatuses[0] ?? "Completed";
           idToItem.set(id, {
             id,
             type,
@@ -231,13 +511,13 @@ function reconcileCrossSprintOrphans(opts) {
   const TERMINAL_STATE_JSON = /* @__PURE__ */ new Set(["Done", "Escalated", "Parking Lot"]);
   let activeSprintId = null;
   try {
-    activeSprintId = fs.readFileSync(path.join(sprintRunsRoot, ".active"), "utf8").trim();
+    activeSprintId = fs2.readFileSync(path2.join(sprintRunsRoot, ".active"), "utf8").trim();
   } catch {
   }
-  const pendingDir = path.join(deliveryRoot, "pending-sync");
+  const pendingDir = path2.join(deliveryRoot, "pending-sync");
   let pendingFiles;
   try {
-    pendingFiles = fs.readdirSync(pendingDir).filter(
+    pendingFiles = fs2.readdirSync(pendingDir).filter(
       (f) => f.endsWith(".md") && !f.startsWith(".")
     );
   } catch {
@@ -245,7 +525,7 @@ function reconcileCrossSprintOrphans(opts) {
   }
   const pendingMap = /* @__PURE__ */ new Map();
   for (const fileName of pendingFiles) {
-    const absPath = path.join(pendingDir, fileName);
+    const absPath = path2.join(pendingDir, fileName);
     const { status } = readArtifactStatus(absPath);
     if (status === null) continue;
     if (ARTIFACT_TERMINAL_STATUSES.has(status)) continue;
@@ -257,7 +537,7 @@ function reconcileCrossSprintOrphans(opts) {
     if (!type || type === "PROPOSAL") continue;
     pendingMap.set(id, {
       status,
-      filePath: path.join("pending-sync", fileName),
+      filePath: path2.join("pending-sync", fileName),
       type
     });
   }
@@ -266,10 +546,10 @@ function reconcileCrossSprintOrphans(opts) {
   }
   let sprintDirs;
   try {
-    sprintDirs = fs.readdirSync(sprintRunsRoot).filter((entry) => {
+    sprintDirs = fs2.readdirSync(sprintRunsRoot).filter((entry) => {
       if (entry.startsWith(".")) return false;
       try {
-        return fs.statSync(path.join(sprintRunsRoot, entry)).isDirectory();
+        return fs2.statSync(path2.join(sprintRunsRoot, entry)).isDirectory();
       } catch {
         return false;
       }
@@ -282,10 +562,10 @@ function reconcileCrossSprintOrphans(opts) {
   let clean = 0;
   for (const sprintDir of sprintDirs) {
     if (activeSprintId && sprintDir === activeSprintId) continue;
-    const stateFile = path.join(sprintRunsRoot, sprintDir, "state.json");
+    const stateFile = path2.join(sprintRunsRoot, sprintDir, "state.json");
     let stateJson;
     try {
-      const raw = fs.readFileSync(stateFile, "utf8");
+      const raw = fs2.readFileSync(stateFile, "utf8");
       stateJson = JSON.parse(raw);
     } catch {
       continue;
@@ -318,7 +598,7 @@ function reconcileDecomposition(opts) {
   const { sprintPlanPath, deliveryRoot } = opts;
   let raw;
   try {
-    raw = fs.readFileSync(sprintPlanPath, "utf8");
+    raw = fs2.readFileSync(sprintPlanPath, "utf8");
   } catch {
     return { missing: [], clean: 0 };
   }
@@ -330,11 +610,11 @@ 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 = path.join(deliveryRoot, "pending-sync");
-  const archiveDir = path.join(deliveryRoot, "archive");
+  const pendingDir = path2.join(deliveryRoot, "pending-sync");
+  const archiveDir = path2.join(deliveryRoot, "archive");
   function listMdFiles(dir) {
     try {
-      return fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
+      return fs2.readdirSync(dir).filter((f) => f.endsWith(".md"));
     } catch {
       return [];
     }
@@ -406,9 +686,9 @@ 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 = path.join(dir, f);
+      const absPath = path2.join(dir, f);
       try {
-        const raw = fs.readFileSync(absPath, "utf8");
+        const raw = fs2.readFileSync(absPath, "utf8");
         const { fm } = parseFrontmatter(raw);
         const parentRef = fm["parent_epic_ref"];
         if (parentRef === epicId) {
@@ -423,9 +703,9 @@ function findChildStories(epicId, pendingDir, pendingFiles, archiveDir, archiveF
 function findDecomposedEpic(proposalId, pendingDir, pendingFiles) {
   for (const f of pendingFiles) {
     if (!f.startsWith("EPIC-")) continue;
-    const absPath = path.join(pendingDir, f);
+    const absPath = path2.join(pendingDir, f);
     try {
-      const raw = fs.readFileSync(absPath, "utf8");
+      const raw = fs2.readFileSync(absPath, "utf8");
       const { fm } = parseFrontmatter(raw);
       const contextSource = fm["context_source"];
       if (typeof contextSource === "string" && contextSource.includes(proposalId)) {
@@ -448,6 +728,8 @@ function checkVerbMismatch(verb, type) {
 
 export {
   parseFrontmatter,
+  rollUpParentStatus,
+  walkActiveParents,
   ARTIFACT_TERMINAL_STATUSES,
   VERB_STATUS_MAP,
   parseCommitMessage,
@@ -456,4 +738,4 @@ export {
   reconcileDecomposition,
   checkVerbMismatch
 };
-//# sourceMappingURL=chunk-HZPJ5QX4.js.map
+//# sourceMappingURL=chunk-EG6YGT2O.js.map