@isaacriehm/cairn-core 0.4.3 → 0.6.0

package/dist/hooks/sot-align-common.js

@@ -0,0 +1,152 @@
+/**
+ * Shared SoT-alignment helpers used by both Layer A (PostToolUse hook,
+ * `hooks/post-tool-use/sot-align.ts`) and Layer B (git pre-commit
+ * hook, `hooks/pre-commit/sot-align-precommit.ts`). The Tier 1
+ * deterministic match (Jaccard ≥ 0.85, 3-shingle ≥ 0.6, length ratio
+ * 0.5–2.0) and the Jaccard top-K candidate pre-filter live here so
+ * both layers compare against the same calibrated thresholds.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { jaccard } from "../text/jaccard.js";
+import { walkSourceComments } from "../init/source-comments/index.js";
+import { decisionsDir, invariantsDir } from "../ground/index.js";
+/* -------------------------------------------------------------------------- */
+/* Tunables — shared between Layer A and Layer B                              */
+/* -------------------------------------------------------------------------- */
+// Tier 1 deterministic floors — internal to `tier1PickWithBody`.
+const TIER1_JACCARD_FLOOR = 0.85;
+const TIER1_SHINGLE_FLOOR = 0.6;
+const TIER1_LENGTH_RATIO_MIN = 0.5;
+const TIER1_LENGTH_RATIO_MAX = 2.0;
+// Jaccard pre-filter floors — exposed because Layer A and Layer B
+// both pass them into `topKCandidates`.
+export const TIER2_JACCARD_FLOOR = 0.3;
+export const TOP_K_CANDIDATES = 5;
+/* -------------------------------------------------------------------------- */
+/* File-type guard                                                            */
+/* -------------------------------------------------------------------------- */
+export function isMarkdownPath(filePath) {
+    return filePath.endsWith(".md") || filePath.endsWith(".mdx");
+}
+/* -------------------------------------------------------------------------- */
+/* Block extraction — wraps phase 7b's walker                                 */
+/* -------------------------------------------------------------------------- */
+/**
+ * Extract prose blocks from the given file. License headers are
+ * filtered out — they are operator-supplied legal text and never the
+ * subject of a decision/invariant cite.
+ */
+export function extractBlocks(repoRoot, filePath) {
+    const walk = walkSourceComments({
+        repoRoot,
+        onlyFiles: [filePath],
+    });
+    return walk.blocks.filter((b) => b.kind !== "license");
+}
+export function topKCandidates(blockTokens, entries, threshold, topK) {
+    const scored = [];
+    for (const e of entries) {
+        const candidateTokens = new Set(e.tokens);
+        const score = jaccard(blockTokens, candidateTokens);
+        if (score < threshold)
+            continue;
+        scored.push({
+            id: e.dec_id,
+            similarity: score,
+            body_hash: e.body_hash,
+            sot_path: e.sot_path,
+        });
+    }
+    scored.sort((a, b) => b.similarity - a.similarity);
+    return scored.slice(0, topK);
+}
+/* -------------------------------------------------------------------------- */
+/* Tier 1 deterministic match                                                 */
+/* -------------------------------------------------------------------------- */
+function shingleSet(text, n) {
+    const cleaned = text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    const tokens = cleaned.split(" ").filter((w) => w.length > 0);
+    if (tokens.length < n)
+        return new Set([cleaned]);
+    const out = new Set();
+    for (let i = 0; i <= tokens.length - n; i += 1) {
+        out.add(tokens.slice(i, i + n).join(" "));
+    }
+    return out;
+}
+function shingleOverlap(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let inter = 0;
+    for (const s of a)
+        if (b.has(s))
+            inter += 1;
+    // Symmetric Jaccard — `min(|a|,|b|)` would let a short fragment of a
+    // long DEC pass Tier 1 even though the bodies aren't really verbatim
+    // duplicates. The length-ratio bound (0.5-2.0) constrains this, but
+    // Jaccard makes the threshold mean the same thing in both directions.
+    const union = a.size + b.size - inter;
+    return union === 0 ? 0 : inter / union;
+}
+function lengthRatio(a, b) {
+    if (b.length === 0)
+        return Number.POSITIVE_INFINITY;
+    return a.length / b.length;
+}
+/**
+ * Walk the top-K candidates and return the first one whose body
+ * passes all Tier 1 floors against the block prose. Returns null when
+ * no candidate qualifies. Reads the candidate body from the live
+ * ledger via `readEntityBody`.
+ */
+export function tier1PickWithBody(repoRoot, block, candidates) {
+    if (candidates.length === 0)
+        return null;
+    const blockShingles = shingleSet(block.prose, 3);
+    for (const cand of candidates) {
+        if (cand.similarity < TIER1_JACCARD_FLOOR)
+            continue;
+        const candBody = readEntityBody(repoRoot, cand.id);
+        if (candBody === null)
+            continue;
+        const overlap = shingleOverlap(blockShingles, shingleSet(candBody, 3));
+        if (overlap < TIER1_SHINGLE_FLOOR)
+            continue;
+        const ratio = lengthRatio(block.prose, candBody);
+        if (ratio < TIER1_LENGTH_RATIO_MIN || ratio > TIER1_LENGTH_RATIO_MAX)
+            continue;
+        return cand;
+    }
+    return null;
+}
+/* -------------------------------------------------------------------------- */
+/* Ledger body reader                                                         */
+/* -------------------------------------------------------------------------- */
+/**
+ * Read the body (post-frontmatter) of a DEC/INV by id. Returns null
+ * when the entity file is missing or unreadable. Strips the leading
+ * `---\n…\n---\n?` frontmatter block when present.
+ */
+export function readEntityBody(repoRoot, id) {
+    if (repoRoot.length === 0)
+        return null;
+    const dir = id.startsWith("INV-") ? invariantsDir(repoRoot) : decisionsDir(repoRoot);
+    const abs = join(dir, `${id}.md`);
+    if (!existsSync(abs))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(abs, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const m = raw.match(/^---\n[\s\S]*?\n---\n?/);
+    return m === null ? raw.trim() : raw.slice(m[0].length).trim();
+}
+//# sourceMappingURL=sot-align-common.js.map

package/dist/hooks/sot-align-common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sot-align-common.js","sourceRoot":"","sources":["../../src/hooks/sot-align-common.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAqB,MAAM,kCAAkC,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AAErF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,iEAAiE;AACjE,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,kEAAkE;AAClE,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAgB;IAC9D,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,QAAQ;QACR,SAAS,EAAE,CAAC,QAAQ,CAAC;KACtB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACzD,CAAC;AAaD,MAAM,UAAU,cAAc,CAC5B,WAAwB,EACxB,OAAwB,EACxB,SAAiB,EACjB,IAAY;IAEZ,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,SAAS;YAAE,SAAS;QAChC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,CAAC,CAAC,MAAM;YACZ,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,SAAS,UAAU,CAAC,IAAY,EAAE,CAAS;IACzC,MAAM,OAAO,GAAG,IAAI;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACV,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,CAAc,EAAE,CAAc;IACpD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IAC5C,qEAAqE;IACrE,qEAAqE;IACrE,oEAAoE;IACpE,sEAAsE;IACtE,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;IACtC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IACpD,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,KAAmB,EACnB,UAAuB;IAEvB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,UAAU,GAAG,mBAAmB;YAAE,SAAS;QACpD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,IAAI,QAAQ,KAAK,IAAI;YAAE,SAAS;QAChC,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,OAAO,GAAG,mBAAmB;YAAE,SAAS;QAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,KAAK,GAAG,sBAAsB,IAAI,KAAK,GAAG,sBAAsB;YAAE,SAAS;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,EAAU;IACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -16,7 +16,11 @@ export * from "./gc/index.js";
 export * from "./ground/index.js";
 export { clearDeferState, deferStatePath, isDeferActive, readDeferState, writeDeferState, } from "./hooks/defer.js";
 export type { DeferKind, DeferState } from "./hooks/defer.js";
+export * from "./align-undo/index.js";
+export * from "./drain/index.js";
+export * from "./fix-align/index.js";
 export * from "./hooks/post-tool-use/index.js";
+export * from "./hooks/pre-commit/index.js";
 export * from "./init/index.js";
 export * from "./join/index.js";
 export * from "./mcp/index.js";
@@ -29,3 +33,4 @@ export * from "./session/index.js";
 export * from "./session-start/index.js";
 export * from "./status-line/index.js";
 export { appendTrace, nowEvent, traceDir, traceFilePath, type TraceEvent, type TraceSource, } from "./trace/index.js";
+export { jaccard, tokenize } from "./text/jaccard.js";

package/dist/index.js

@@ -30,7 +30,11 @@ export * from "./doctor/index.js";
 export * from "./gc/index.js";
 export * from "./ground/index.js";
 export { clearDeferState, deferStatePath, isDeferActive, readDeferState, writeDeferState, } from "./hooks/defer.js";
+export * from "./align-undo/index.js";
+export * from "./drain/index.js";
+export * from "./fix-align/index.js";
 export * from "./hooks/post-tool-use/index.js";
+export * from "./hooks/pre-commit/index.js";
 export * from "./init/index.js";
 export * from "./join/index.js";
 export * from "./mcp/index.js";
@@ -43,4 +47,5 @@ export * from "./session/index.js";
 export * from "./session-start/index.js";
 export * from "./status-line/index.js";
 export { appendTrace, nowEvent, traceDir, traceFilePath, } from "./trace/index.js";
+export { jaccard, tokenize } from "./text/jaccard.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,oDAAoD;AACpD,SAAS,WAAW;IAClB,IAAI,OAAO,iBAAiB,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AACD,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,GAGd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,oDAAoD;AACpD,SAAS,WAAW;IAClB,IAAI,OAAO,iBAAiB,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AACD,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,GAGd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/init/index.d.ts

@@ -34,5 +34,7 @@ export { buildRepoSummary } from "./walker.js";
 export type { BuildRepoSummaryOptions, ManifestPreview, RepoSummary, } from "./walker.js";
 export { updateWorkflowSlugBlock } from "./workflow-block.js";
 export type { UpdateResult as WorkflowSlugUpdateResult, WorkflowSlugBlockUpdate, } from "./workflow-block.js";
-export { PHASE_IDS, INIT_STATE_PATH, phaseStateAbsPath, readPhaseState, writePhaseState, clearPhaseState, freshPhaseState, resumePhases, nextPhaseAfter, advancePhase, MAPPER_OUTPUT_PATH, mapperOutputAbsPath, readMapperOutputFile, writeMapperOutputFile, toMapperResultPersisted, runPhase1Detect, runPhase2Walker, runPhase3Mapper, runPhase3bSeed, runPhase4Pilot, runPhase5Brand, runPhase6DocsIngest, runPhase7bSourceComments, runPhase7cRulesMerge, runPhase8Baseline, runPhase10Strip, runPhase12Multidev, runPhases678Parallel, SOURCE_COMMENTS_WALK_PATH, sourceCommentsWalkAbsPath, readSourceCommentsWalkFile, writeSourceCommentsWalkFile, to7bResultPersisted, } from "./phases/index.js";
-export type { PhaseId, PhaseState, PhaseOutputs, PhaseResult, PhaseQuestion, PhaseOption, PhaseError, ResumeReport, MapperResultPersisted, IngestSourceCommentsResultPersisted, } from "./phases/index.js";
+export { PHASE_IDS, INIT_STATE_PATH, phaseStateAbsPath, readPhaseState, writePhaseState, clearPhaseState, freshPhaseState, resumePhases, nextPhaseAfter, advancePhase, MAPPER_OUTPUT_PATH, mapperOutputAbsPath, readMapperOutputFile, writeMapperOutputFile, toMapperResultPersisted, runPhase1Detect, runPhase2Walker, runPhase3Mapper, runPhase3bSeed, runPhase4Pilot, runPhase5Brand, runPhase5bTopicIndex, runPhase6DocsIngest, runPhase7bSourceComments, runPhase7cRulesMerge, runPhase8Baseline, runPhase10Strip, runPhase12Multidev, runPhases678Parallel, SOURCE_COMMENTS_WALK_PATH, sourceCommentsWalkAbsPath, readSourceCommentsWalkFile, writeSourceCommentsWalkFile, to7bResultPersisted, } from "./phases/index.js";
+export type { PhaseId, PhaseState, PhaseOutputs, PhaseResult, PhaseQuestion, PhaseOption, PhaseError, ResumeReport, MapperResultPersisted, IngestSourceCommentsResultPersisted, TopicIndexPhaseOutput, } from "./phases/index.js";
+export { buildTopicIndex, walkProseBlocks, resolveTopics, makeHaikuJudge, } from "./topic-index/index.js";
+export type { BuildTopicIndexArgs, BuildTopicIndexResult, ProseBlock, ProseBlockKind, ResolveOptions, ResolveResult, SemanticJudge, SemanticVerdict, JudgeOptions, } from "./topic-index/index.js";

package/dist/init/index.js

@@ -18,5 +18,6 @@ export { seedCairnLayout, templatesRoot } from "./seed.js";
 export { editYaml, freeTextWithDefault, squareIntoSquareHole, yesNo, } from "./prompts.js";
 export { buildRepoSummary } from "./walker.js";
 export { updateWorkflowSlugBlock } from "./workflow-block.js";
-export { PHASE_IDS, INIT_STATE_PATH, phaseStateAbsPath, readPhaseState, writePhaseState, clearPhaseState, freshPhaseState, resumePhases, nextPhaseAfter, advancePhase, MAPPER_OUTPUT_PATH, mapperOutputAbsPath, readMapperOutputFile, writeMapperOutputFile, toMapperResultPersisted, runPhase1Detect, runPhase2Walker, runPhase3Mapper, runPhase3bSeed, runPhase4Pilot, runPhase5Brand, runPhase6DocsIngest, runPhase7bSourceComments, runPhase7cRulesMerge, runPhase8Baseline, runPhase10Strip, runPhase12Multidev, runPhases678Parallel, SOURCE_COMMENTS_WALK_PATH, sourceCommentsWalkAbsPath, readSourceCommentsWalkFile, writeSourceCommentsWalkFile, to7bResultPersisted, } from "./phases/index.js";
+export { PHASE_IDS, INIT_STATE_PATH, phaseStateAbsPath, readPhaseState, writePhaseState, clearPhaseState, freshPhaseState, resumePhases, nextPhaseAfter, advancePhase, MAPPER_OUTPUT_PATH, mapperOutputAbsPath, readMapperOutputFile, writeMapperOutputFile, toMapperResultPersisted, runPhase1Detect, runPhase2Walker, runPhase3Mapper, runPhase3bSeed, runPhase4Pilot, runPhase5Brand, runPhase5bTopicIndex, runPhase6DocsIngest, runPhase7bSourceComments, runPhase7cRulesMerge, runPhase8Baseline, runPhase10Strip, runPhase12Multidev, runPhases678Parallel, SOURCE_COMMENTS_WALK_PATH, sourceCommentsWalkAbsPath, readSourceCommentsWalkFile, writeSourceCommentsWalkFile, to7bResultPersisted, } from "./phases/index.js";
+export { buildTopicIndex, walkProseBlocks, resolveTopics, makeHaikuJudge, } from "./topic-index/index.js";
 //# sourceMappingURL=index.js.map

package/dist/init/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKpE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,SAAS,IAAI,wBAAwB,EACrC,iBAAiB,EACjB,cAAc,EACd,UAAU,IAAI,uBAAuB,EACrC,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AA6C9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,GAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK1D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,GAKN,MAAM,cAAc,CAAC;AAStB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAK9D,OAAO,EACL,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKpE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,SAAS,IAAI,wBAAwB,EACrC,iBAAiB,EACjB,cAAc,EACd,UAAU,IAAI,uBAAuB,EACrC,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AA6C9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,GAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK1D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,GAKN,MAAM,cAAc,CAAC;AAStB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAK9D,OAAO,EACL,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAe3B,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,wBAAwB,CAAC"}

package/dist/init/ingest-docs.d.ts

@@ -1,81 +1,64 @@
 /**
- * Phase 6 — docs ingestion sweep.
+ * Phase 6 — docs ingestion (v0.5.0 SoT model).
  *
- * Scans the adopted repo for existing documentation, classifies each file
- * via a Haiku call, and:
- *   - decision / domain-rule  → DEC draft in decisions/_inbox/
- *   - voice-guidelines        → brand/voice.md (only when current is empty placeholder)
- *   - api-docs / other        → canonical-map topics.yaml entry (when topicSlug present)
+ * Reads the topic-index built by phase 5b, filters to entries whose SoT
+ * source lives under `docs/*`, and emits verbatim DEC files under
+ * `.cairn/ground/decisions/`. Auto-promoted to `status: accepted`. No
+ * draft inbox, no LLM paraphrase — the doc paragraph itself IS the
+ * canonical body, recorded with `sot_kind: path` so the lens renders
+ * the live source on every read.
  *
- * Cap 20 docs total — largest by byte count first. One Haiku call per doc.
- * Concurrency cap of 4 in-flight to avoid rate limits.
+ * Per-entry Haiku call decides `kind` only (decision / domain-rule /
+ * voice-guidelines / api-docs / other). The first two emit a DEC; the
+ * rest are skipped at this layer (voice + canonical-topic flows are
+ * handled by other tooling now — they were file-level concerns under
+ * the v0.4.x model and have no clean paragraph-level analogue).
  */
+import { type TopicIndexEntry } from "../ground/index.js";
 export interface DocCandidate {
-    /** Repo-relative path. */
     path: string;
-    /** Byte count for largest-first ordering. */
     size: number;
-    /** Bucket reported on the per-folder progress display. */
     group: string;
 }
 export type DocClassificationKind = "decision" | "domain-rule" | "voice-guidelines" | "api-docs" | "other";
 export interface DocClassification {
     kind: DocClassificationKind;
     proposedTitle: string;
-    proposedRationale: string;
-    topicSlug: string;
 }
 export interface ClassifiedDoc {
     candidate: DocCandidate;
     classification: DocClassification;
-    /** Set when the Haiku call failed; the doc is skipped downstream. */
     failed: boolean;
     errorMessage?: string;
 }
 export interface IngestionResult {
-    /** Per-doc classification outcomes. */
-    classifications: ClassifiedDoc[];
-    /** DEC drafts written to decisions/_inbox/. */
-    decDraftsWritten: {
+    /** Verbatim DEC files written under `.cairn/ground/decisions/`. */
+    decsWritten: {
         id: string;
         path: string;
         sourceFile: string;
+        slug: string;
     }[];
-    /** Canonical-map topic entries appended to topics.yaml. */
-    canonicalTopicsAdded: {
-        topic: string;
-        canonicalPath: string;
-    }[];
-    /** brand/voice.md was rewritten from the placeholder. */
-    voiceUpdated: boolean;
-    /** Group → progress row text shown during ingestion. */
-    groupCounts: {
-        group: string;
-        drafts: number;
-        total: number;
+    /** Topic-index entries that were not emitted, with reasons. */
+    skipped: {
+        slug: string;
+        reason: string;
     }[];
+    /** Number of topic-index entries considered (sot_source under docs/). */
+    scannedEntries: number;
 }
 export interface RunDocsIngestionArgs {
     repoRoot: string;
-    /** Called with one row per group as it finishes. */
-    onGroupProgress?: (row: {
-        group: string;
-        drafts: number;
+    /** Smoke override — feed canned classifications keyed by slug. */
+    mockClassify?: (entry: TopicIndexEntry, body: string) => DocClassification;
+    /** Caller-supplied id collision Set (parallel pipeline). */
+    existingDecIds?: Set<string>;
+    /** Progress callback fired once per emitted entry. */
+    onEntryProgress?: (row: {
+        slug: string;
+        emitted: boolean;
         total: number;
-        ok: boolean;
     }) => void;
-    /**
-     * Skip the LLM round-trip — used by smokes. When set, every candidate is
-     * classified as "other" with empty fields; nothing is written.
-     */
-    mockClassify?: (candidate: DocCandidate, body: string) => DocClassification;
-    /**
-     * Caller-supplied DEC id Set. When provided, skips the local
-     * `scanExistingDecisionIds` and mutates the supplied Set as ids are
-     * allocated. The parallel pipeline orchestrator passes one Set across
-     * all 3 phases so concurrent allocations don't collide on disk.
-     */
-    existingDecIds?: Set<string>;
 }
 export declare function discoverDocs(repoRoot: string): DocCandidate[];
 export declare function runDocsIngestion(args: RunDocsIngestionArgs): Promise<IngestionResult>;