snipara-companion 3.0.0 → 3.0.1

package/dist/index.d.ts

@@ -3628,6 +3628,7 @@ interface OrchestratorHandoffOptions {
     rootDir?: string;
     changedFiles?: string[];
     contextRefs?: string[];
+    decisionIds?: string[];
     resumeSummary?: string;
     featureTitle?: string;
     workstreams?: string[];

package/dist/index.js

@@ -2899,6 +2899,7 @@ var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Map([
 var DEFAULT_MAX_FILES = 2e3;
 var DEFAULT_MAX_FILE_BYTES = 1024 * 1024;
 var DEFAULT_HOSTED_OVERLAY_TTL_HOURS = 48;
+var MAX_HOSTED_OVERLAY_TTL_HOURS = 168;
 var DEFAULT_HOOK_REINDEX_DELAY_SECONDS = 5;
 var CACHE_RELATIVE_PATH = import_path.default.join(".snipara", "code-overlay", "latest.json");
 var PROMOTION_RELATIVE_PATH = import_path.default.join(".snipara", "code-overlay", "promotion.json");
@@ -2961,8 +2962,14 @@ function ensureTrailingNewline2(content) {
   return content.endsWith("\n") ? content : `${content}
 `;
 }
-function positiveInteger2(value, fallback) {
-  return Number.isFinite(value) && value !== void 0 && value > 0 ? Math.floor(value) : fallback;
+function positiveInteger2(value, fallback, label = "value") {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (Number.isFinite(value) && value > 0) {
+    return Math.floor(value);
+  }
+  throw new Error(`${label} must be a positive integer.`);
 }
 function nonNegativeInteger(value, fallback) {
   return Number.isFinite(value) && value !== void 0 && value >= 0 ? Math.floor(value) : fallback;
@@ -3344,8 +3351,12 @@ function buildLocalCodeOverlay(options = {}) {
   const repoRoot = resolveRepoRoot2(options.cwd ?? process.cwd());
   const mode = options.mode ?? "working_tree";
   const commit = mode === "local_commit" ? options.commit ?? "HEAD" : options.commit ?? "HEAD";
-  const maxFiles = positiveInteger2(options.maxFiles, DEFAULT_MAX_FILES);
-  const maxFileBytes = positiveInteger2(options.maxFileBytes, DEFAULT_MAX_FILE_BYTES);
+  const maxFiles = positiveInteger2(options.maxFiles, DEFAULT_MAX_FILES, "--max-files");
+  const maxFileBytes = positiveInteger2(
+    options.maxFileBytes,
+    DEFAULT_MAX_FILE_BYTES,
+    "--max-file-bytes"
+  );
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const branch = readBranch(repoRoot);
   const localHeadSha = readHeadSha(repoRoot);
@@ -4193,7 +4204,14 @@ function buildHostedCodeOverlayUploadPayload(options = {}) {
     maxFiles: options.maxFiles
   });
   const cachePath = writeLocalCodeOverlayCache(manifest);
-  const ttlHours = positiveInteger2(options.ttlHours, DEFAULT_HOSTED_OVERLAY_TTL_HOURS);
+  const ttlHours = positiveInteger2(
+    options.ttlHours,
+    DEFAULT_HOSTED_OVERLAY_TTL_HOURS,
+    "--ttl-hours"
+  );
+  if (ttlHours > MAX_HOSTED_OVERLAY_TTL_HOURS) {
+    throw new Error(`--ttl-hours must be less than or equal to ${MAX_HOSTED_OVERLAY_TTL_HOURS}.`);
+  }
   return {
     manifest,
     cachePath,
@@ -10119,6 +10137,12 @@ function buildOrchestratorHandoff(options) {
   const changedFiles = normalizeStringList(
     options.changedFiles ?? (Array.isArray(workflowState?.currentPhase?.files) ? workflowState.currentPhase.files : [])
   );
+  const contextRefs = normalizeStringList(options.contextRefs);
+  const decisionIds = normalizeDecisionIds([
+    ...normalizeStringList(workflowState?.decisionIds),
+    ...normalizeStringList(options.decisionIds),
+    ...extractDecisionIdsFromRefs(contextRefs)
+  ]);
   const requiresProofGate = options.recommendation.reasons.includes("proof_gate_intent") || options.recommendation.reasons.includes("team_sync_collision");
   const requiresDriftCheck = options.recommendation.reasons.includes("production_validation_intent") || options.recommendation.reasons.includes("workflow_mode_orchestrate");
   return {
@@ -10187,8 +10211,8 @@ function buildOrchestratorHandoff(options) {
       ] : []
     },
     memory: {
-      decisionIds: ["DEC-002"],
-      contextRefs: normalizeStringList(options.contextRefs),
+      decisionIds,
+      contextRefs,
       resumeSummary: options.resumeSummary ?? null
     }
   };
@@ -10424,6 +10448,22 @@ function normalizeEndpointTypes(values) {
     )
   ).sort();
 }
+function normalizeDecisionIds(values) {
+  return Array.from(
+    new Set(
+      normalizeStringList(values).map((value) => value.toUpperCase()).filter((value) => /^DEC-[A-Z0-9._-]+$/.test(value))
+    )
+  ).sort();
+}
+function extractDecisionIdsFromRefs(contextRefs) {
+  const matches = [];
+  for (const ref of contextRefs) {
+    for (const match of ref.matchAll(/\bDEC-[A-Za-z0-9._-]+\b/g)) {
+      matches.push(match[0]);
+    }
+  }
+  return matches;
+}
 function compactObject2(value) {
   return Object.fromEntries(
     Object.entries(value).filter(
@@ -10481,9 +10521,20 @@ function readWorkflowState(rootDir) {
     currentPhaseId: parsed.currentPhaseId,
     currentPhase,
     phases,
-    runtimeSandboxPhases
+    runtimeSandboxPhases,
+    decisionIds: extractWorkflowDecisionIds(parsed)
   };
 }
+function extractWorkflowDecisionIds(parsed) {
+  const fromTopLevel = normalizeStringList(parsed.decisionIds);
+  const fromDecisions = Array.isArray(parsed.decisions) ? parsed.decisions.map((decision) => {
+    if (typeof decision === "string") {
+      return decision;
+    }
+    return isRecord4(decision) ? stringValue2(decision.decisionId) : void 0;
+  }).filter((decisionId) => Boolean(decisionId)) : [];
+  return normalizeDecisionIds([...fromTopLevel, ...fromDecisions]);
+}
 function normalizeContextPackIds(value) {
   if (!Array.isArray(value)) {
     return [];
@@ -17907,6 +17958,18 @@ async function taskCommitCommand(options) {
 var SNAPSHOT_RELATIVE_PATH = import_path2.default.join(".snipara", "source", "latest.json");
 var DEFAULT_MAX_FILES2 = 5e3;
 var DEFAULT_MAX_FILE_BYTES2 = 5 * 1024 * 1024;
+var LOCAL_SOURCE_FILE_KINDS = /* @__PURE__ */ new Set([
+  "DOC",
+  "BINARY",
+  "CODE",
+  "CONFIG",
+  "OTHER"
+]);
+var LOCAL_SOURCE_SKIPPED_REASONS = /* @__PURE__ */ new Set([
+  "ignored",
+  "too_large",
+  "read_error"
+]);
 var DOCUMENT_FORMATS = /* @__PURE__ */ new Map([
   [".adoc", { kind: "DOC", format: "adoc" }],
   [".markdown", { kind: "DOC", format: "markdown" }],
@@ -17979,12 +18042,27 @@ var DEFAULT_IGNORED_DIRS = /* @__PURE__ */ new Set([
   "target",
   "venv"
 ]);
-function positiveInteger3(value, fallback) {
-  return Number.isFinite(value) && value !== void 0 && value > 0 ? Math.floor(value) : fallback;
+function positiveInteger3(value, fallback, label = "value") {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (Number.isFinite(value) && value > 0) {
+    return Math.floor(value);
+  }
+  throw new Error(`${label} must be a positive integer.`);
 }
 function normalizeRepoPath2(value) {
   return value.split(import_path2.default.sep).join("/").replace(/^\/+/, "");
 }
+function comparePaths(left, right) {
+  if (left < right) {
+    return -1;
+  }
+  if (left > right) {
+    return 1;
+  }
+  return 0;
+}
 function sha2564(value) {
   return import_crypto2.default.createHash("sha256").update(value).digest("hex");
 }
@@ -18070,8 +18148,12 @@ function getLocalSourceSnapshotPath(cwd = process.cwd()) {
 function buildLocalSourceSnapshot(options = {}) {
   const root = resolveSourceRoot(options.dir);
   const recursive = options.recursive ?? true;
-  const maxFiles = positiveInteger3(options.maxFiles, DEFAULT_MAX_FILES2);
-  const maxFileBytes = positiveInteger3(options.maxFileBytes, DEFAULT_MAX_FILE_BYTES2);
+  const maxFiles = positiveInteger3(options.maxFiles, DEFAULT_MAX_FILES2, "--max-files");
+  const maxFileBytes = positiveInteger3(
+    options.maxFileBytes,
+    DEFAULT_MAX_FILE_BYTES2,
+    "--max-file-bytes"
+  );
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const sniparaIgnore = readSniparaIgnore2(root);
   const files = [];
@@ -18150,6 +18232,8 @@ function buildLocalSourceSnapshot(options = {}) {
   if (files.length >= maxFiles) {
     warnings.push(`Stopped after ${maxFiles} files. Increase --max-files for larger folders.`);
   }
+  files.sort((left, right) => comparePaths(left.path, right.path));
+  skippedSamples.sort((left, right) => comparePaths(left.path, right.path));
   const byKind = emptyKindCounts();
   let totalBytes = 0;
   for (const file of files) {
@@ -18204,11 +18288,51 @@ function readLocalSourceSnapshot(cwd = process.cwd()) {
   }
   try {
     const parsed = JSON.parse(import_fs2.default.readFileSync(snapshotPath, "utf8"));
-    return parsed?.version === "snipara.local_source_snapshot.v1" ? parsed : null;
+    return isLocalSourceSnapshot(parsed) ? parsed : null;
   } catch {
     return null;
   }
 }
+function isRecord6(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isLocalSourceFile(value) {
+  if (!isRecord6(value)) {
+    return false;
+  }
+  return typeof value.path === "string" && LOCAL_SOURCE_FILE_KINDS.has(value.kind) && (typeof value.format === "string" || value.format === null) && typeof value.sizeBytes === "number" && Number.isFinite(value.sizeBytes) && typeof value.modifiedAt === "string" && typeof value.sha256 === "string";
+}
+function isSkippedFile(value) {
+  if (!isRecord6(value)) {
+    return false;
+  }
+  return typeof value.path === "string" && LOCAL_SOURCE_SKIPPED_REASONS.has(value.reason) && (value.sizeBytes === void 0 || typeof value.sizeBytes === "number" && Number.isFinite(value.sizeBytes));
+}
+function hasKindCounts(value) {
+  if (!isRecord6(value)) {
+    return false;
+  }
+  return Array.from(LOCAL_SOURCE_FILE_KINDS).every(
+    (kind) => typeof value[kind] === "number" && Number.isFinite(value[kind])
+  );
+}
+function hasSkippedCounts(value) {
+  if (!isRecord6(value)) {
+    return false;
+  }
+  return Array.from(LOCAL_SOURCE_SKIPPED_REASONS).every(
+    (reason) => typeof value[reason] === "number" && Number.isFinite(value[reason])
+  );
+}
+function isLocalSourceSnapshot(value) {
+  if (!isRecord6(value) || value.version !== "snipara.local_source_snapshot.v1") {
+    return false;
+  }
+  if (!isRecord6(value.summary) || !isRecord6(value.skipped)) {
+    return false;
+  }
+  return typeof value.generatedAt === "string" && typeof value.root === "string" && value.provider === "local_folder" && typeof value.revision === "string" && typeof value.recursive === "boolean" && typeof value.maxFiles === "number" && typeof value.maxFileBytes === "number" && typeof value.summary.totalFiles === "number" && typeof value.summary.totalBytes === "number" && hasKindCounts(value.summary.byKind) && typeof value.summary.skipped === "number" && Array.isArray(value.files) && value.files.every(isLocalSourceFile) && typeof value.skipped.total === "number" && hasSkippedCounts(value.skipped.byReason) && Array.isArray(value.skipped.samples) && value.skipped.samples.every(isSkippedFile) && Array.isArray(value.warnings) && value.warnings.every((warning) => typeof warning === "string");
+}
 function compareLocalSourceSnapshots(previous, current) {
   if (!previous) {
     return {
@@ -18406,14 +18530,48 @@ async function sourceSyncCommand(options = {}) {
   printSyncResult(result);
 }
 async function sourceWatchCommand(options = {}) {
-  const intervalMs = positiveInteger3(options.intervalMs, 5e3);
+  const intervalMs = positiveInteger3(options.intervalMs, 5e3, "--interval-ms");
   if (options.once) {
     await sourceSyncCommand(options);
     return;
   }
-  while (true) {
-    await sourceSyncCommand(options);
-    await new Promise((resolve17) => setTimeout(resolve17, intervalMs));
+  let stopping = false;
+  let activeTimer = null;
+  let resolveWait = null;
+  const stop = () => {
+    stopping = true;
+    if (activeTimer) {
+      clearTimeout(activeTimer);
+      activeTimer = null;
+    }
+    if (resolveWait) {
+      resolveWait();
+      resolveWait = null;
+    }
+  };
+  const signals = ["SIGINT", "SIGTERM"];
+  for (const signal of signals) {
+    process.once(signal, stop);
+  }
+  try {
+    while (!stopping) {
+      await sourceSyncCommand(options);
+      if (stopping) {
+        break;
+      }
+      await new Promise((resolve17) => {
+        resolveWait = resolve17;
+        activeTimer = setTimeout(() => {
+          activeTimer = null;
+          resolveWait = null;
+          resolve17();
+        }, intervalMs);
+      });
+    }
+  } finally {
+    for (const signal of signals) {
+      process.removeListener(signal, stop);
+    }
   }
 }
 
@@ -18467,19 +18625,19 @@ function normalizeTask(task) {
   const normalized = task?.trim();
   return normalized ? normalized : void 0;
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringValue4(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
 function recordList(value) {
-  return Array.isArray(value) ? value.filter(isRecord6) : [];
+  return Array.isArray(value) ? value.filter(isRecord7) : [];
 }
 function safeReadJson(filePath) {
   try {
     const parsed = JSON.parse(fs19.readFileSync(filePath, "utf8"));
-    return isRecord6(parsed) ? parsed : void 0;
+    return isRecord7(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
@@ -18964,11 +19122,11 @@ function unique3(values) {
     )
   ];
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function recordList2(value) {
-  return Array.isArray(value) ? value.filter(isRecord7) : [];
+  return Array.isArray(value) ? value.filter(isRecord8) : [];
 }
 function stringValue5(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
@@ -19520,7 +19678,7 @@ function buildLocalEngineeringLeadPlan(input) {
   };
 }
 function normalizeWorkerRecommendation(value, index) {
-  const contract = isRecord7(value.contract) ? value.contract : {};
+  const contract = isRecord8(value.contract) ? value.contract : {};
   const role = cockpitEnumValue(
     "worker_role",
     ENGINEERING_LEAD_WORKER_ROLES,
@@ -19738,7 +19896,7 @@ function summarizeSupervisionFromWorkPackages(workPackages) {
   };
 }
 function normalizeSupervision(value, workPackages) {
-  if (!isRecord7(value)) {
+  if (!isRecord8(value)) {
     return summarizeSupervisionFromWorkPackages(workPackages);
   }
   const fallback = summarizeSupervisionFromWorkPackages(workPackages);
@@ -19790,7 +19948,7 @@ function normalizeSupervision(value, workPackages) {
   };
 }
 function normalizeCockpitPlan(cockpit) {
-  const rawPlan = isRecord7(cockpit.engineeringLeadPlan) ? cockpit.engineeringLeadPlan : cockpit;
+  const rawPlan = isRecord8(cockpit.engineeringLeadPlan) ? cockpit.engineeringLeadPlan : cockpit;
   const score = Math.round(numberValue3(rawPlan.score, 0));
   const workerRecommendations = recordList2(rawPlan.workerRecommendations).map(
     normalizeWorkerRecommendation
@@ -19990,7 +20148,7 @@ function applyReconciliationToPlan(plan, reconciliation) {
 }
 function readJsonFile3(filePath) {
   const parsed = JSON.parse(fs20.readFileSync(path19.resolve(filePath), "utf8"));
-  if (!isRecord7(parsed)) {
+  if (!isRecord8(parsed)) {
     throw new Error(`${filePath} must contain a JSON object`);
   }
   return parsed;
@@ -20195,7 +20353,7 @@ var import_node_child_process6 = require("child_process");
 var import_chalk8 = __toESM(require("chalk"));
 
 // src/commands/judgment-card.ts
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function numberValue4(value) {
@@ -20213,12 +20371,12 @@ function stringListValue(value) {
 function nestedRecord(root, keys) {
   let current = root;
   for (const key of keys) {
-    if (!isRecord8(current) || !isRecord8(current[key])) {
+    if (!isRecord9(current) || !isRecord9(current[key])) {
       return {};
     }
     current = current[key];
   }
-  return isRecord8(current) ? current : {};
+  return isRecord9(current) ? current : {};
 }
 function nestedArray(root, keys) {
   if (keys.length === 0) {
@@ -20304,7 +20462,7 @@ function advisorRecommendationsFromInput(input) {
   return recommendations;
 }
 function advisorRecommendationFromUnknown(value, index) {
-  if (!isRecord8(value)) {
+  if (!isRecord9(value)) {
     return null;
   }
   const title = stringValue6(value.title);
@@ -20327,7 +20485,7 @@ function advisorRecommendationFromUnknown(value, index) {
   };
 }
 function codeImpactRisk(impact) {
-  const risk = isRecord8(impact?.risk) ? impact?.risk : {};
+  const risk = isRecord9(impact?.risk) ? impact?.risk : {};
   return {
     level: stringValue6(risk.level),
     score: numberValue4(risk.score)
@@ -20361,19 +20519,19 @@ function collectVerificationChecks(plan) {
   };
 }
 function gapCode(gap) {
-  return isRecord8(gap) ? stringValue6(gap.code) ?? "verification_gap" : "verification_gap";
+  return isRecord9(gap) ? stringValue6(gap.code) ?? "verification_gap" : "verification_gap";
 }
 function gapMessage(gap) {
-  if (!isRecord8(gap)) {
+  if (!isRecord9(gap)) {
     return String(gap);
   }
   return stringValue6(gap.message) ?? stringValue6(gap.reason) ?? stringValue6(gap.title) ?? "Verification gap";
 }
 function checkCommand(check2) {
-  return isRecord8(check2) ? stringValue6(check2.command) : void 0;
+  return isRecord9(check2) ? stringValue6(check2.command) : void 0;
 }
 function checkTitle(check2) {
-  if (!isRecord8(check2)) {
+  if (!isRecord9(check2)) {
     return String(check2);
   }
   return stringValue6(check2.title) ?? stringValue6(check2.command) ?? stringValue6(check2.file) ?? "verification check";
@@ -20453,7 +20611,7 @@ function buildProjectJudgmentCard(input) {
       "Code impact was degraded; local reads and broader checks should override confidence."
     );
   }
-  const freshness = isRecord8(input.codeImpact?.index_freshness) ? input.codeImpact?.index_freshness : {};
+  const freshness = isRecord9(input.codeImpact?.index_freshness) ? input.codeImpact?.index_freshness : {};
   if (freshness.is_stale === true || freshness.commit_match === false) {
     addReason(reasons, {
       code: "code_graph_stale",
@@ -20476,12 +20634,12 @@ function buildProjectJudgmentCard(input) {
       type: "run_check",
       title: checkTitle(check2),
       command: checkCommand(check2),
-      reason: isRecord8(check2) ? stringValue6(check2.reason) : void 0,
+      reason: isRecord9(check2) ? stringValue6(check2.reason) : void 0,
       severity: "medium"
     });
   }
   for (const gap of missingChecks) {
-    const severity = normalizeSeverity(isRecord8(gap) ? gap.severity : void 0);
+    const severity = normalizeSeverity(isRecord9(gap) ? gap.severity : void 0);
     const code2 = gapCode(gap);
     addReason(reasons, {
       code: code2,
@@ -20785,7 +20943,7 @@ function formatProjectJudgmentCard(card) {
 var import_fs3 = __toESM(require("fs"));
 var import_path3 = __toESM(require("path"));
 var import_chalk7 = __toESM(require("chalk"));
-function isRecord9(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringValue7(value) {
@@ -20802,7 +20960,7 @@ function stringList2(value) {
     if (typeof item === "string") {
       return [item];
     }
-    if (!isRecord9(item)) {
+    if (!isRecord10(item)) {
       return [];
     }
     return [
@@ -20858,7 +21016,7 @@ function collectActionChecks(impact) {
       const kind2 = checkKindFromText(item);
       return kind2 === "command" || kind2 === "inspection" ? [] : [{ kind: kind2, title: item, source: "code-impact" }];
     }
-    if (!isRecord9(item)) {
+    if (!isRecord10(item)) {
       return [];
     }
     const title = actionTitle(item);
@@ -20886,7 +21044,7 @@ function collectDirectTestChecks(impact) {
     impact.related_tests,
     impact.relatedTests,
     impact.tests,
-    isRecord9(impact.impact) ? impact.impact.tests : void 0
+    isRecord10(impact.impact) ? impact.impact.tests : void 0
   ];
   return candidates.flatMap((candidate) => {
     if (!Array.isArray(candidate)) {
@@ -20904,7 +21062,7 @@ function collectDirectTestChecks(impact) {
           }
         ];
       }
-      if (!isRecord9(item)) {
+      if (!isRecord10(item)) {
         return [];
       }
       const command = stringValue7(item.command);
@@ -20947,7 +21105,7 @@ function findPackageJson(startPath, cwd) {
 function readPackageInfo(packageJsonPath) {
   try {
     const parsed = JSON.parse(import_fs3.default.readFileSync(packageJsonPath, "utf8"));
-    const scripts = isRecord9(parsed.scripts) ? Object.fromEntries(
+    const scripts = isRecord10(parsed.scripts) ? Object.fromEntries(
       Object.entries(parsed.scripts).filter((entry) => {
         return typeof entry[1] === "string";
       })
@@ -21004,12 +21162,12 @@ function collectImpactedFiles(impact, changedFiles, filePath) {
     ...stringList2(impact?.impacted_files),
     ...stringList2(impact?.impactedFiles),
     ...stringList2(impact?.matched_targets),
-    ...stringList2(isRecord9(impact?.impact) ? impact?.impact.files : void 0)
+    ...stringList2(isRecord10(impact?.impact) ? impact?.impact.files : void 0)
   ];
   return unique4(files);
 }
 function buildRisk(impact) {
-  const risk = impact && isRecord9(impact.risk) ? impact.risk : {};
+  const risk = impact && isRecord10(impact.risk) ? impact.risk : {};
   return {
     level: stringValue7(risk.level) ?? "unknown",
     ...numberValue5(risk.score) !== void 0 ? { score: numberValue5(risk.score) } : {},
@@ -21021,7 +21179,7 @@ function collectCoverageGaps(impact) {
     return [];
   }
   return impact.coverage_gaps.map((gap) => {
-    if (!isRecord9(gap)) {
+    if (!isRecord10(gap)) {
       return {
         code: "coverage_gap",
         severity: "medium",
@@ -21045,7 +21203,7 @@ function collectCaveats(impact, errors) {
       "Code impact returned degraded results; prefer conservative checks and local reads."
     );
   }
-  const freshness = impact && isRecord9(impact.index_freshness) ? impact.index_freshness : {};
+  const freshness = impact && isRecord10(impact.index_freshness) ? impact.index_freshness : {};
   if (freshness.commit_match === false || freshness.is_stale === true) {
     caveats.push(
       "Code graph freshness does not fully match the local working tree; verify exact files locally."
@@ -21053,7 +21211,7 @@ function collectCaveats(impact, errors) {
   }
   const warnings = Array.isArray(freshness.warnings) ? freshness.warnings : [];
   for (const warning of warnings.slice(0, 3)) {
-    if (isRecord9(warning) && warning.message) {
+    if (isRecord10(warning) && warning.message) {
       caveats.push(preview2(warning.message, 220));
     }
   }
@@ -21258,7 +21416,7 @@ async function verifyCommand(options) {
 }
 
 // src/commands/intelligence.ts
-function isRecord10(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function numberValue6(value) {
@@ -21291,7 +21449,7 @@ function nestedRecord2(root, keys) {
   let current = root;
   for (const key of keys) {
     const next = current[key];
-    if (!isRecord10(next)) {
+    if (!isRecord11(next)) {
       return {};
     }
     current = next;
@@ -21312,7 +21470,7 @@ function actionList(value) {
     if (typeof item === "string") {
       return item;
     }
-    if (!isRecord10(item)) {
+    if (!isRecord11(item)) {
       return preview3(item);
     }
     const title = item.action ?? item.title ?? item.name ?? item.recommendedAction ?? "action";
@@ -21430,7 +21588,7 @@ function printResumeContext(result) {
     console.log(import_chalk8.default.yellow("Unavailable"));
     return;
   }
-  const resumeContext = isRecord10(result.resumeContext) ? result.resumeContext : result;
+  const resumeContext = isRecord11(result.resumeContext) ? result.resumeContext : result;
   const focus = nestedRecord2(resumeContext, ["focus"]);
   const scope = nestedRecord2(resumeContext, ["scope"]);
   if (scope.branch) {
@@ -21469,7 +21627,7 @@ function printMemoryHealth2(result) {
   if (score !== void 0) {
     console.log(`Memory Health: ${formatPercentScore(score)}`);
   }
-  const metrics = isRecord10(result.metrics) ? result.metrics : nestedRecord2(result, ["summary", "metrics"]);
+  const metrics = isRecord11(result.metrics) ? result.metrics : nestedRecord2(result, ["summary", "metrics"]);
   const metricEntries = Object.entries(metrics).filter(([, value]) => value !== void 0);
   if (metricEntries.length > 0) {
     console.log(
@@ -21484,11 +21642,11 @@ function printCodeImpact(result) {
     console.log(import_chalk8.default.yellow("Skipped or unavailable"));
     return;
   }
-  const risk = isRecord10(result.risk) ? result.risk : {};
+  const risk = isRecord11(result.risk) ? result.risk : {};
   if (risk.level || risk.score !== void 0) {
     console.log(`Risk: ${preview3(risk.level ?? "unknown")} (${preview3(risk.score ?? "n/a")})`);
   }
-  const evidence = isRecord10(result.evidence_summary) ? result.evidence_summary : {};
+  const evidence = isRecord11(result.evidence_summary) ? result.evidence_summary : {};
   if (evidence.matched_target_count !== void 0) {
     console.log(`Matched targets: ${preview3(evidence.matched_target_count)}`);
   }
@@ -22006,7 +22164,7 @@ var REGISTRY_VERSION = "project-intelligence.policy-gates.registry.v1";
 function normalizeChangedFiles(changedFiles) {
   return [...new Set((changedFiles ?? []).map((file) => file.trim()).filter(Boolean))];
 }
-function isRecord11(value) {
+function isRecord12(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringValue8(value) {
@@ -22015,12 +22173,12 @@ function stringValue8(value) {
 function nestedRecord3(root, keys) {
   let current = root;
   for (const key of keys) {
-    if (!isRecord11(current) || !isRecord11(current[key])) {
+    if (!isRecord12(current) || !isRecord12(current[key])) {
       return {};
     }
     current = current[key];
   }
-  return isRecord11(current) ? current : {};
+  return isRecord12(current) ? current : {};
 }
 function combinedText(input) {
   return [input.task, input.diffSummary, ...input.changedFiles ?? []].filter(Boolean).join("\n").toLowerCase();
@@ -22392,7 +22550,7 @@ var ADVISOR_RECEIPT_WRITE_LIMIT = 6;
 function normalizeStringList3(values) {
   return [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))];
 }
-function isRecord12(value) {
+function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function guardPayload(guard) {
@@ -22415,7 +22573,7 @@ function servedJudgmentIdFromUnknown(value, depth = 0) {
   if (depth > 5 || value === null || value === void 0) {
     return void 0;
   }
-  if (!isRecord12(value)) {
+  if (!isRecord13(value)) {
     if (Array.isArray(value)) {
       for (const item of value.slice(0, 12)) {
         const found = servedJudgmentIdFromUnknown(item, depth + 1);
@@ -22772,7 +22930,7 @@ function runGuard(options, changedFiles) {
   let payload;
   try {
     const parsed = JSON.parse(result.stdout);
-    if (isRecord12(parsed)) {
+    if (isRecord13(parsed)) {
       payload = parsed;
     }
   } catch {
@@ -22934,10 +23092,10 @@ async function projectIntelligenceRunCommand(options) {
     if (result.guard) {
       console.log(import_chalk10.default.bold("Guard"));
       console.log(`Status: ${result.guard.status}`);
-      const actionCards = isRecord12(result.guard.payload) ? result.guard.payload.actionCards : [];
+      const actionCards = isRecord13(result.guard.payload) ? result.guard.payload.actionCards : [];
       if (Array.isArray(actionCards) && actionCards.length > 0) {
         for (const card of actionCards.slice(0, 6)) {
-          if (!isRecord12(card)) continue;
+          if (!isRecord13(card)) continue;
           console.log(`- ${card.kind}: ${card.title ?? card.reason ?? "guard action"}`);
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Local-first CLI that asks your repo what breaks before an AI coding agent edits it.",
   "main": "dist/index.js",
   "bin": {