@isaacriehm/cairn-core 0.23.0 → 0.24.0

package/dist/tasks/spec-reader.js

@@ -0,0 +1,60 @@
+/**
+ * Shared `spec.tightened.md` frontmatter + `## Goal` reader.
+ *
+ * Factored out of `cairn_resume` (mcp/tools/resume.ts) so both the
+ * resume payload AND the UserPromptSubmit working-header (context
+ * engine, stage 1) read the spec the same way — one parse, no drift.
+ * The parse is verbatim from the original resume.ts implementation.
+ *
+ * Returns null when the task has no `spec.tightened.md` yet (e.g. a
+ * task still in `queued`/`tightening`). Malformed frontmatter degrades
+ * to defaults rather than throwing — callers run inside hooks that must
+ * never crash the agent loop.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * Read `<taskDir>/spec.tightened.md`'s frontmatter (`title`,
+ * `in_scope_decisions[]`, `in_scope_invariants[]`, `target_path_globs[]`)
+ * and the body's `## Goal` section. `taskDir` is the absolute task
+ * directory (active or done). Returns null when the spec file is absent.
+ */
+export function readTaskSpec(taskDir) {
+    const specPath = join(taskDir, "spec.tightened.md");
+    if (!existsSync(specPath))
+        return null;
+    let title = "";
+    let goal = "";
+    let inScopeDecisions = [];
+    let inScopeInvariants = [];
+    let targetPathGlobs = [];
+    const raw = readFileSync(specPath, "utf8");
+    const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\n---\r?\n([\s\S]*)$/);
+    if (fmMatch) {
+        try {
+            const fm = parseYaml(fmMatch[1] ?? "");
+            if (typeof fm.title === "string")
+                title = fm.title;
+            if (Array.isArray(fm.in_scope_decisions)) {
+                inScopeDecisions = fm.in_scope_decisions.filter((x) => typeof x === "string");
+            }
+            if (Array.isArray(fm.in_scope_invariants)) {
+                inScopeInvariants = fm.in_scope_invariants.filter((x) => typeof x === "string");
+            }
+            if (Array.isArray(fm.target_path_globs)) {
+                targetPathGlobs = fm.target_path_globs.filter((x) => typeof x === "string");
+            }
+        }
+        catch {
+            // malformed frontmatter — fall through with defaults
+        }
+        const body = fmMatch[2] ?? "";
+        const goalMatch = body.match(/##\s+Goal\s*\r?\n+([\s\S]*?)(?:\r?\n##\s+|$)/);
+        if (goalMatch && goalMatch[1] !== undefined) {
+            goal = goalMatch[1].trim();
+        }
+    }
+    return { title, goal, inScopeDecisions, inScopeInvariants, targetPathGlobs };
+}
+//# sourceMappingURL=spec-reader.js.map

package/dist/tasks/spec-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader.js","sourceRoot":"","sources":["../../src/tasks/spec-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAiB1C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,gBAAgB,GAAa,EAAE,CAAC;IACpC,IAAI,iBAAiB,GAAa,EAAE,CAAC;IACrC,IAAI,eAAe,GAAa,EAAE,CAAC;IAEnC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACrE,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAoB,CAAC;YAC1D,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ;gBAAE,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;YACnD,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACzC,gBAAgB,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAC1C,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBAC1C,iBAAiB,GAAG,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAC1C,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACxC,eAAe,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAC1C,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC7E,IAAI,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5C,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;AAC/E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isaacriehm/cairn-core",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Cairn core — state + context layer. Curated `.cairn/ground/` (decisions, §INV invariants, canonical-map, brand, quality-grades), MCP server, init wizard, hook runners, sensors, GC drift sweep.",
   "author": "Isaac Riehm",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "simple-git": "^3.36.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@isaacriehm/cairn-state": "0.23.0"
+    "@isaacriehm/cairn-state": "0.24.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",