cleargate 0.12.0 → 0.13.0

package/dist/cli.js

@@ -3,8 +3,9 @@ import {
   checkVerbMismatch,
   parseFrontmatter,
   reconcileDecomposition,
-  reconcileLifecycle
-} from "./chunk-HZPJ5QX4.js";
+  reconcileLifecycle,
+  walkActiveParents
+} from "./chunk-EG6YGT2O.js";
 import {
   AcquireError,
   acquireAccessToken,
@@ -22,7 +23,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "cleargate",
-  version: "0.12.0",
+  version: "0.13.0",
   private: false,
   type: "module",
   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.",
@@ -69,12 +70,11 @@ var package_default = {
     build: "tsup",
     dev: "tsup --watch",
     typecheck: "tsc --noEmit",
-    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"
+    test: "tsx --test --test-concurrency=1 --experimental-test-module-mocks --test-reporter=spec 'test/**/*.node.test.ts' '!test/fixtures/**'",
+    "test:file": "tsx --test --test-concurrency=1 --experimental-test-module-mocks --test-reporter=spec",
+    "test:node": "tsx --test --test-concurrency=1 --experimental-test-module-mocks --test-reporter=spec 'test/**/*.node.test.ts' '!test/fixtures/**'",
+    "test:node:file": "tsx --test --test-concurrency=1 --experimental-test-module-mocks --test-reporter=spec",
+    "check:no-vitest": `node -e "const r=require('child_process').execSync('grep -rE \\"\\\\b(vitest|vi\\\\.fn|vi\\\\.mock|vi\\\\.spyOn|vi\\\\.stubGlobal|vi\\\\.useFakeTimers|vi\\\\.useRealTimers|vi\\\\.advanceTimersByTime|vi\\\\.hoisted)\\\\b\\" --include=\\"*.ts\\" --include=\\"*.js\\" --include=\\"*.mjs\\" --exclude-dir=test/fixtures . 2>/dev/null || true', {encoding:'utf8'}); if(r.trim()){console.error('vitest residue detected:\\\\n'+r); process.exit(1)} console.log('no vitest residue')"`
   },
   dependencies: {
     "@napi-rs/keyring": "^1.2.0",
@@ -89,10 +89,10 @@ var package_default = {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.0.0",
     "@types/pg": "^8.11.10",
+    "ts-morph": "28.0.0",
     tsup: "^8",
     tsx: "^4.21.0",
-    typescript: "^5.8.0",
-    vitest: "^2.1.0"
+    typescript: "^5.8.0"
   }
 };
 
@@ -6463,22 +6463,50 @@ function reconcileLifecycleCliHandler(opts, cli) {
     });
     if (result.drift.length === 0) {
       stdoutFn(`lifecycle: clean (${result.clean} artifacts reconciled)`);
-      return exitFn(0);
-    }
-    stderrFn(`lifecycle: DRIFT detected (${result.drift.length} unreconciled artifacts):`);
-    for (const item of result.drift) {
-      stderrFn(
-        `  DRIFT: ${item.id} status=${item.actual_status ?? "missing"} in ${item.in_archive ? "archive" : "pending-sync"}, expected ${item.expected_status} (commit ${item.commit_shas[0] ?? "unknown"})`
-      );
-      stderrFn(
-        `    Remediation: git mv .cleargate/delivery/pending-sync/${item.file_path?.replace("pending-sync/", "") ?? item.id + "_*.md"} .cleargate/delivery/archive/ && update status: ${item.expected_status}`
-      );
+    } else {
+      stderrFn(`lifecycle: DRIFT detected (${result.drift.length} unreconciled artifacts):`);
+      for (const item of result.drift) {
+        stderrFn(
+          `  DRIFT: ${item.id} status=${item.actual_status ?? "missing"} in ${item.in_archive ? "archive" : "pending-sync"}, expected ${item.expected_status} (commit ${item.commit_shas[0] ?? "unknown"})`
+        );
+        stderrFn(
+          `    Remediation: git mv .cleargate/delivery/pending-sync/${item.file_path?.replace("pending-sync/", "") ?? item.id + "_*.md"} .cleargate/delivery/archive/ && update status: ${item.expected_status}`
+        );
+      }
+      if (!opts.parents) {
+        return exitFn(1);
+      }
     }
-    return exitFn(1);
   } catch (err) {
     stderrFn(`lifecycle reconciliation error: ${err instanceof Error ? err.message : String(err)}`);
-    return exitFn(1);
+    if (!opts.parents) {
+      return exitFn(1);
+    }
+  }
+  if (opts.parents) {
+    const archiveRoot = path31.join(deliveryRoot, "archive");
+    walkActiveParents({ deliveryRoot, archiveRoot }).then((results) => {
+      stdoutFn("Parent rollup audit (--parents):");
+      for (const r of results) {
+        if (r.verdict === "auto-flip") {
+          stdoutFn(
+            `  ${r.parent_id}  \u2713 proposed: Completed (${r.terminal_children.length}/${r.terminal_children.length} children Completed)`
+          );
+        } else if (r.verdict === "halt-partial" || r.verdict === "halt-zero-children") {
+          stdoutFn(`  ${r.parent_id}  \u2717 ${r.verdict}: ${r.halt_reason ?? "no details"}`);
+        } else if (r.verdict === "no-op") {
+        } else {
+          stdoutFn(`  ${r.parent_id}  ~ ${r.verdict}`);
+        }
+      }
+      exitFn(0);
+    }).catch((err) => {
+      stderrFn(`--parents audit error: ${err instanceof Error ? err.message : String(err)}`);
+      exitFn(0);
+    });
+    return;
   }
+  return exitFn(0);
 }
 function parseFileFrontmatter(raw) {
   const lines = raw.split("\n");
@@ -10346,6 +10374,7 @@ function getItemId3(fm) {
 }
 
 // src/commands/push.ts
+import * as fs40 from "fs";
 import * as fsPromises11 from "fs/promises";
 import * as path49 from "path";
 async function pushHandler(fileOrId, opts = {}) {
@@ -10355,6 +10384,13 @@ async function pushHandler(fileOrId, opts = {}) {
   const stderr = opts.stderr ?? ((s) => process.stderr.write(s));
   const exit = opts.exit ?? ((c) => process.exit(c));
   const nowFn = opts.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
+  const migrationLockPath = path49.join(projectRoot, ".cleargate", ".migration-lock");
+  if (fs40.existsSync(migrationLockPath)) {
+    stderr(`Error: CR-067 migration in progress (.migration-lock held); retry in 30s
+`);
+    exit(75);
+    return;
+  }
   const identity = resolveIdentity(projectRoot);
   const sprintRoot = resolveActiveSprintDir(projectRoot);
   async function resolveMcp() {
@@ -10750,7 +10786,7 @@ function formatEntry(entry) {
 }
 
 // src/commands/admin-login.ts
-import * as fs40 from "fs";
+import * as fs41 from "fs";
 import * as path51 from "path";
 import * as os7 from "os";
 var DEFAULT_MCP_URL = "http://localhost:3000";
@@ -10764,10 +10800,10 @@ function resolveAuthFilePath(opts) {
 }
 function writeAdminAuth(filePath, token) {
   const dir = path51.dirname(filePath);
-  fs40.mkdirSync(dir, { recursive: true });
+  fs41.mkdirSync(dir, { recursive: true });
   const payload = JSON.stringify({ version: 1, token }, null, 2);
-  fs40.writeFileSync(filePath, payload, { encoding: "utf8", mode: 384 });
-  fs40.chmodSync(filePath, 384);
+  fs41.writeFileSync(filePath, payload, { encoding: "utf8", mode: 384 });
+  fs41.chmodSync(filePath, 384);
 }
 async function adminLoginHandler(opts = {}) {
   const fetchFn = opts.fetch ?? globalThis.fetch;
@@ -10876,7 +10912,7 @@ async function adminLoginHandler(opts = {}) {
 }
 
 // src/commands/hotfix.ts
-import * as fs41 from "fs";
+import * as fs42 from "fs";
 import * as path52 from "path";
 function defaultExit4(code) {
   return process.exit(code);
@@ -10887,7 +10923,7 @@ function maxHotfixId(pendingDir) {
   let max = 0;
   let entries;
   try {
-    entries = fs41.readdirSync(pendingDir);
+    entries = fs42.readdirSync(pendingDir);
   } catch {
     return 0;
   }
@@ -10907,7 +10943,7 @@ function countActiveHotfixes(repoRoot) {
   let count = 0;
   let pendingEntries = [];
   try {
-    pendingEntries = fs41.readdirSync(pendingDir);
+    pendingEntries = fs42.readdirSync(pendingDir);
   } catch {
   }
   for (const entry of pendingEntries) {
@@ -10915,13 +10951,13 @@ function countActiveHotfixes(repoRoot) {
   }
   let archiveEntries = [];
   try {
-    archiveEntries = fs41.readdirSync(archiveDir);
+    archiveEntries = fs42.readdirSync(archiveDir);
   } catch {
   }
   for (const entry of archiveEntries) {
     if (entry.startsWith("HOTFIX-") && entry.endsWith(".md")) {
       try {
-        const stat = fs41.statSync(path52.join(archiveDir, entry));
+        const stat = fs42.statSync(path52.join(archiveDir, entry));
         if (stat.mtimeMs >= sevenDaysAgo) count++;
       } catch {
       }
@@ -10956,7 +10992,7 @@ function hotfixNewHandler(opts, cli) {
   const templatePath = resolveTemplatePath(repoRoot);
   let templateContent;
   try {
-    templateContent = fs41.readFileSync(templatePath, "utf8");
+    templateContent = fs42.readFileSync(templatePath, "utf8");
   } catch {
     stderrFn(`[cleargate hotfix new] template not found: ${templatePath}`);
     return exitFn(2);
@@ -10966,8 +11002,8 @@ function hotfixNewHandler(opts, cli) {
   const fileName = `${idStr}_${fileSlug}.md`;
   const outPath = path52.join(pendingDir, fileName);
   try {
-    fs41.mkdirSync(pendingDir, { recursive: true });
-    fs41.writeFileSync(outPath, content, "utf8");
+    fs42.mkdirSync(pendingDir, { recursive: true });
+    fs42.writeFileSync(outPath, content, "utf8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     stderrFn(`[cleargate hotfix new] write failed: ${msg}`);
@@ -11394,8 +11430,8 @@ sprint.command("close <sprint-id>").description("close a sprint \u2014 validates
   }
   sprintCloseHandler(handlerOpts);
 });
-sprint.command("reconcile-lifecycle <sprint-id>").description("CR-017: check lifecycle status of artifacts referenced in this sprint's commits (exits 1 on drift)").option("--since <iso-date>", "start of git log range (default: sprint start_date or 90 days ago)").option("--until <iso-date>", "end of git log range (default: now)").action((sprintId, opts) => {
-  reconcileLifecycleCliHandler({ sprintId, since: opts.since, until: opts.until });
+sprint.command("reconcile-lifecycle <sprint-id>").description("CR-017: check lifecycle status of artifacts referenced in this sprint's commits (exits 1 on drift)").option("--since <iso-date>", "start of git log range (default: sprint start_date or 90 days ago)").option("--until <iso-date>", "end of git log range (default: now)").option("--parents", "audit parent (Epic/Sprint) rollup statuses; read-only (CR-066)").action((sprintId, opts) => {
+  reconcileLifecycleCliHandler({ sprintId, since: opts.since, until: opts.until, parents: opts.parents });
 });
 sprint.command("archive <sprint-id>").description("archive a completed sprint \u2014 move pending-sync files, clear .active, merge + delete sprint branch").option("--dry-run", "print the archive plan without making any changes").option("--allow-wiki-lint-debt", "CR-022 M5: waive wiki-lint findings during archive (mirrors --allow-drift pattern)").action(async (sprintId, opts) => {
   const handlerOpts = { sprintId };