cairn-ai 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cairn-ai",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Token-efficient agent harness with tool readiness for Codex, Claude Code, and Antigravity",
   "license": "MIT",
   "author": {

package/scripts/cairn-state.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
+import { isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 const memoryTemplate = `# MEMORY
@@ -58,10 +58,16 @@ This file is a short index of active and completed work plans.
 
 if (isCliEntry()) {
   const event = process.argv[2] ?? "manual";
-  console.log(await runState(event));
+  const result = await runStateResult(event);
+  console.log(result.message);
+  if (result.status !== 0) process.exitCode = result.status;
 }
 
 export async function runState(event = "manual", { root = process.env.HARNESS_REPO_ROOT ?? process.cwd(), locale = localeValue() } = {}) {
+  return (await runStateResult(event, { root, locale })).message;
+}
+
+export async function runStateResult(event = "manual", { root = process.env.HARNESS_REPO_ROOT ?? process.cwd(), locale = localeValue() } = {}) {
   const resolvedRoot = resolve(root);
   await mkdir(join(resolvedRoot, "docs", "memory"), { recursive: true });
   await mkdir(join(resolvedRoot, "docs", "plan"), { recursive: true });
@@ -70,23 +76,39 @@ export async function runState(event = "manual", { root = process.env.HARNESS_RE
 
   const ko = locale.toLowerCase().startsWith("ko");
   if (event === "session-start" || event === "user-prompt-submit") {
-    return ko
-      ? "Cairn 컨텍스트: 모든 에이전트는 작업 시작 시 도메인 지식과 정책 색인인 프로젝트 루트 MEMORY.md를 먼저 읽어야 합니다."
-      : "Cairn context: every agent must start by reading the project-root MEMORY.md for domain knowledge and repository policy.";
+    return {
+      status: 0,
+      message: ko
+        ? "Cairn 컨텍스트: 모든 에이전트는 작업 시작 시 도메인 지식과 정책 색인인 프로젝트 루트 MEMORY.md를 먼저 읽어야 합니다."
+        : "Cairn context: every agent must start by reading the project-root MEMORY.md for domain knowledge and repository policy.",
+    };
   }
   if (event === "post-tool-use") {
-    return ko
-      ? "Cairn 점검: 외부 상태 변경에는 dry-run/check 증거가 필요하고, 동작이 바뀌었다면 docs/plan 증거를 갱신하세요."
-      : "Cairn check: external-state changes need dry-run/check evidence; if behavior changed, update docs/plan evidence.";
+    return {
+      status: 0,
+      message: ko
+        ? "Cairn 점검: 외부 상태 변경에는 dry-run/check 증거가 필요하고, 동작이 바뀌었다면 docs/plan 증거를 갱신하세요."
+        : "Cairn check: external-state changes need dry-run/check evidence; if behavior changed, update docs/plan evidence.",
+    };
   }
   if (event === "stop" || event === "subagent-stop") {
+    const pending = await pendingActivePlanItems(resolvedRoot);
+    if (pending.length > 0) {
+      return {
+        status: 1,
+        message: stopBlockedMessage({ event, ko, pending }),
+      };
+    }
     return ko
-      ? "Cairn 종료 게이트: 완료에는 docs/plan의 dry-run/check, 모듈 수용, 표면 통합 증거가 필요합니다."
-      : "Cairn stop gate: completion requires dry-run/check, module acceptance, and surface integration evidence in docs/plan.";
+      ? { status: 0, message: "Cairn 종료 게이트: 완료에는 docs/plan의 dry-run/check, 모듈 수용, 표면 통합 증거가 필요합니다." }
+      : { status: 0, message: "Cairn stop gate: completion requires dry-run/check, module acceptance, and surface integration evidence in docs/plan." };
   }
-  return ko
-    ? "Cairn이 MEMORY.md, PLAN.md, docs/memory, docs/plan을 초기화했습니다."
-    : "Cairn initialized MEMORY.md, PLAN.md, docs/memory, and docs/plan.";
+  return {
+    status: 0,
+    message: ko
+      ? "Cairn이 MEMORY.md, PLAN.md, docs/memory, docs/plan을 초기화했습니다."
+      : "Cairn initialized MEMORY.md, PLAN.md, docs/memory, and docs/plan.",
+  };
 }
 
 async function writeIfMissing(path, content) {
@@ -97,6 +119,92 @@ async function writeIfMissing(path, content) {
   }
 }
 
+async function pendingActivePlanItems(root) {
+  const planPath = join(root, "PLAN.md");
+  const plan = await readFile(planPath, "utf8");
+  const activePlans = markdownLinksToPlanFiles(section(plan, "Active Plans"));
+  const pending = [];
+
+  for (const relativePath of activePlans) {
+    const path = resolve(root, relativePath);
+    const pathFromRoot = relative(root, path);
+    if (pathFromRoot.startsWith("..") || isAbsolute(pathFromRoot)) continue;
+    const text = await readPlanFile(path);
+    if (text === null) {
+      pending.push({ path: relativePath, unchecked: ["active plan file is missing"], emptyEvidence: [] });
+      continue;
+    }
+    const unchecked = [...text.matchAll(/^\s*-\s+\[\s\]\s+(.+)$/gm)].map((match) => match[1].trim());
+    const emptyEvidence = emptyEvidenceItems(text);
+    if (unchecked.length > 0 || emptyEvidence.length > 0) {
+      pending.push({ path: relativePath, unchecked, emptyEvidence });
+    }
+  }
+
+  return pending;
+}
+
+async function readPlanFile(path) {
+  try {
+    return await readFile(path, "utf8");
+  } catch (error) {
+    if (error?.code === "ENOENT") return null;
+    throw error;
+  }
+}
+
+function markdownLinksToPlanFiles(text) {
+  const paths = new Set();
+  const patterns = [
+    /\((docs\/plan\/[^)#\s]+\.md)\)/g,
+    /`(docs\/plan\/[^`]+\.md)`/g,
+    /\b(docs\/plan\/[^\s)`]+\.md)\b/g,
+  ];
+  for (const pattern of patterns) {
+    for (const match of text.matchAll(pattern)) {
+      const path = match[1].replace(/[.,;:]+$/, "");
+      if (!path.includes("<topic>")) paths.add(path);
+    }
+  }
+  return [...paths];
+}
+
+function emptyEvidenceItems(text) {
+  const evidence = section(text, "Evidence");
+  if (evidence.length === 0) return [];
+  const empty = [];
+  for (const match of evidence.matchAll(/^\s*-\s+([^:\n]+):\s*$/gm)) empty.push(match[1].trim());
+  return empty;
+}
+
+function section(text, title) {
+  const pattern = new RegExp(`^##\\s+${escapeRegExp(title)}\\s*$([\\s\\S]*?)(?=^##\\s+|(?![\\s\\S]))`, "m");
+  return text.match(pattern)?.[1]?.trim() ?? "";
+}
+
+function stopBlockedMessage({ event, ko, pending }) {
+  const itemText = pending.slice(0, 3).map(formatPendingItem).join("; ");
+  const suffix = pending.length > 3 ? `; +${pending.length - 3} more` : "";
+  if (ko) {
+    const subject = event === "subagent-stop" ? "서브에이전트 완료 신호" : "완료 신호";
+    return `Cairn 종료 게이트: ${subject}를 차단했습니다. 미완료 작업이 남아 있습니다. PLAN.md의 Active Plans를 다시 읽고 다음 미완료 slice를 계속 진행하세요: ${itemText}${suffix}`;
+  }
+  const subject = event === "subagent-stop" ? "subagent completion signal" : "completion signal";
+  return `Cairn stop gate: blocked ${subject}. Incomplete work remains. Re-read PLAN.md Active Plans and continue the next incomplete slice: ${itemText}${suffix}`;
+}
+
+function formatPendingItem(item) {
+  const reasons = [
+    ...item.unchecked.map((label) => `unchecked: ${label}`),
+    ...item.emptyEvidence.map((label) => `empty evidence: ${label}`),
+  ];
+  return `${item.path} (${reasons.slice(0, 3).join(", ")})`;
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 function localeValue() {
   return [process.env.LC_ALL, process.env.LC_MESSAGES, process.env.LANG]
     .find((value) => typeof value === "string" && value.length > 0) ?? Intl.DateTimeFormat().resolvedOptions().locale;