@isaacriehm/cairn-core 0.4.3 → 0.6.0

package/dist/ground/alignment-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alignment-pending.js","sourceRoot":"","sources":["../../src/ground/alignment-pending.ts"],"names":[],"mappings":"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"}

package/dist/ground/anchor-map.d.ts

@@ -0,0 +1,14 @@
+import { AnchorMap, type AnchorMapEntry } from "./schemas.js";
+/**
+ * Anchor-map is the external slug → location index for sot_kind=path
+ * DECs. Operator's docs stay pristine: no `<!-- cairn-anchor: … -->`
+ * comments are injected. When the operator renames a heading or moves a
+ * paragraph, the anchor-map updates and §DEC-<hash> tokens stay valid
+ * because they resolve through this map, not the literal heading slug.
+ */
+export declare function emptyAnchorMap(): AnchorMap;
+export declare function readAnchorMap(repoRoot: string): AnchorMap;
+export declare function writeAnchorMap(repoRoot: string, map: AnchorMap): string;
+export declare function setAnchor(map: AnchorMap, slug: string, entry: AnchorMapEntry): AnchorMap;
+export declare function getAnchor(map: AnchorMap, slug: string): AnchorMapEntry | null;
+export declare function deleteAnchor(map: AnchorMap, slug: string): AnchorMap;

package/dist/ground/anchor-map.js

@@ -0,0 +1,56 @@
+import { existsSync, readFileSync } from "node:fs";
+import { writeFileSafe } from "../fs.js";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { logger } from "../logger.js";
+import { anchorMapPath } from "./paths.js";
+import { AnchorMap } from "./schemas.js";
+const log = logger("ground.anchor-map");
+/**
+ * Anchor-map is the external slug → location index for sot_kind=path
+ * DECs. Operator's docs stay pristine: no `<!-- cairn-anchor: … -->`
+ * comments are injected. When the operator renames a heading or moves a
+ * paragraph, the anchor-map updates and §DEC-<hash> tokens stay valid
+ * because they resolve through this map, not the literal heading slug.
+ */
+export function emptyAnchorMap() {
+    return { version: 1, generated: new Date().toISOString(), anchors: {} };
+}
+export function readAnchorMap(repoRoot) {
+    const path = anchorMapPath(repoRoot);
+    if (!existsSync(path))
+        return emptyAnchorMap();
+    try {
+        const raw = readFileSync(path, "utf8");
+        const parsed = AnchorMap.safeParse(parseYaml(raw));
+        if (!parsed.success) {
+            log.warn({ path, error: parsed.error.message }, "anchor-map invalid; treating as empty");
+            return emptyAnchorMap();
+        }
+        return parsed.data;
+    }
+    catch (err) {
+        log.warn({ path, err }, "anchor-map read failed; treating as empty");
+        return emptyAnchorMap();
+    }
+}
+export function writeAnchorMap(repoRoot, map) {
+    const path = anchorMapPath(repoRoot);
+    const next = { ...map, generated: new Date().toISOString() };
+    writeFileSafe(path, stringifyYaml(next));
+    log.debug({ path, anchors: Object.keys(next.anchors).length }, "wrote anchor-map");
+    return path;
+}
+export function setAnchor(map, slug, entry) {
+    return { ...map, anchors: { ...map.anchors, [slug]: entry } };
+}
+export function getAnchor(map, slug) {
+    return map.anchors[slug] ?? null;
+}
+export function deleteAnchor(map, slug) {
+    if (map.anchors[slug] === undefined)
+        return map;
+    const anchors = { ...map.anchors };
+    delete anchors[slug];
+    return { ...map, anchors };
+}
+//# sourceMappingURL=anchor-map.js.map

package/dist/ground/anchor-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-map.js","sourceRoot":"","sources":["../../src/ground/anchor-map.ts"],"names":[],"mappings":"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"}

package/dist/ground/frontmatter.d.ts

@@ -7,6 +7,18 @@ export interface ParsedDocument {
     /** Number of lines the frontmatter (incl. fences) occupies. */
     fenceLineCount: number;
 }
+/**
+ * Extract frontmatter from `source` and return it as an unvalidated
+ * `Record<string, unknown>` alongside the remaining body. Returns
+ * `{ fm: {}, body: source }` on any parse failure or absent frontmatter.
+ *
+ * Use this instead of an inline `.match(/^---…/)` when callers need
+ * arbitrary field access without a Zod schema.
+ */
+export declare function parseFrontmatterRecord(source: string): {
+    fm: Record<string, unknown>;
+    body: string;
+};
 export declare function parseFrontmatter(source: string): ParsedDocument;
 export declare function readFrontmatter(absPath: string): ParsedDocument;
 export interface FreshnessVerdict {

package/dist/ground/frontmatter.js

@@ -2,6 +2,34 @@ import { readFileSync } from "node:fs";
 import { parse as parseYaml } from "yaml";
 import { ProvenanceFrontmatter } from "./schemas.js";
 const FENCE_RE = /^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n?/;
+/**
+ * Extract frontmatter from `source` and return it as an unvalidated
+ * `Record<string, unknown>` alongside the remaining body. Returns
+ * `{ fm: {}, body: source }` on any parse failure or absent frontmatter.
+ *
+ * Use this instead of an inline `.match(/^---…/)` when callers need
+ * arbitrary field access without a Zod schema.
+ */
+export function parseFrontmatterRecord(source) {
+    const match = source.match(FENCE_RE);
+    if (match === null || match.index !== 0) {
+        return { fm: {}, body: source };
+    }
+    const raw = match[1] ?? "";
+    const body = source.slice(match[0].length);
+    if (raw.trim().length === 0)
+        return { fm: {}, body };
+    try {
+        const parsed = parseYaml(raw);
+        if (typeof parsed === "object" && parsed !== null) {
+            return { fm: parsed, body };
+        }
+    }
+    catch {
+        /* ignore — malformed YAML */
+    }
+    return { fm: {}, body };
+}
 export function parseFrontmatter(source) {
     const match = source.match(FENCE_RE);
     if (!match || match.index !== 0) {

package/dist/ground/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/ground/frontmatter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/ground/frontmatter.ts"],"names":[],"mappings":"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"}

package/dist/ground/index.d.ts

@@ -1,7 +1,7 @@
-export { CANONICAL_GLOBS, CANONICAL_EXCLUDES, decisionsDir, decisionsLedgerPath, groundDir, invariantsDir, invariantsLedgerPath, manifestPath, qualityGradesPath, runsTerminalDir, stalenessCurrentPath, stalenessDir, stalenessLogPath, } from "./paths.js";
+export { CANONICAL_GLOBS, CANONICAL_EXCLUDES, alignmentPendingDir, anchorMapPath, archivedConflictsDir, conflictsDir, decisionsDir, decisionsLedgerPath, groundDir, haikuCacheDir, invariantsDir, invariantsLedgerPath, manifestPath, qualityGradesPath, runsTerminalDir, sotBindingsPath, sotCachePath, sotRenderedCacheDir, layerADeferredLogPath, preCommitDeferredLogPath, stalenessCurrentPath, stalenessDir, stalenessLogPath, topicIndexPath, } from "./paths.js";
 export { matchGlob, matchAnyGlob, compileGlob } from "./glob.js";
 export { walkCanonical } from "./walk.js";
-export { parseFrontmatter, readFrontmatter, evaluateFreshness } from "./frontmatter.js";
+export { parseFrontmatter, parseFrontmatterRecord, readFrontmatter, evaluateFreshness } from "./frontmatter.js";
 export type { ParsedDocument, FreshnessVerdict } from "./frontmatter.js";
 export { buildManifest, writeManifest } from "./manifest.js";
 export type { BuildManifestOptions } from "./manifest.js";
@@ -9,8 +9,15 @@ export { buildDecisionsLedger, buildInvariantsLedger, writeDecisionsLedger, writ
 export type { LedgerOptions } from "./ledgers.js";
 export { recordDriftEvent, writeDriftSnapshot } from "./drift.js";
 export type { DriftSnapshot } from "./drift.js";
+export { writeAlignmentPending } from "./alignment-pending.js";
+export type { AlignmentPendingKind, WriteAlignmentPendingArgs, } from "./alignment-pending.js";
 export { buildQualityGrades, writeQualityGrades } from "./quality-grades.js";
 export type { QualityGradesOptions } from "./quality-grades.js";
 export { coerceDecisionIds, coerceInvariantIds, lookupScope, readScopeIndex, rebuildScopeIndex, rescanScopeIndex, scopeIndexPath, writeScopeIndex, } from "./scope-index.js";
 export type { RebuildScopeIndexOptions, RebuildScopeIndexResult, RescanScopeIndexResult, ScopeIndex, ScopeIndexEntry, } from "./scope-index.js";
-export { Audience, ProvenanceFrontmatter, ManifestEntry, Manifest, DecisionAssertion, DecisionFrontmatter, InvariantFrontmatter, DecisionLedgerEntry, InvariantLedgerEntry, QualityGrade, QualityGrades, DriftEvent, } from "./schemas.js";
+export { AnchorMap, AnchorMapEntry, Audience, ProvenanceFrontmatter, ManifestEntry, Manifest, DecisionAssertion, DecisionFrontmatter, InvariantFrontmatter, DecisionLedgerEntry, InvariantLedgerEntry, QualityGrade, QualityGrades, DriftEvent, PreCommitDriftCandidate, PreCommitDriftLogEntry, SotBindings, SotCache, SotCacheEntry, SotKind, TopicIndex, TopicIndexEntry, } from "./schemas.js";
+export { bindDec, decsForPath, emptySotBindings, pathForDec, readSotBindings, unbindDec, writeSotBindings, } from "./sot-bindings.js";
+export { clearDecFromTopicIndex, emptyTopicIndex, getTopic, readTopicIndex, setTopic, writeTopicIndex, } from "./topic-index.js";
+export { deleteEntry as deleteSotCacheEntry, emptySotCache, entries as sotCacheEntries, getEntry as getSotCacheEntry, readSotCache, setEntry as setSotCacheEntry, writeSotCache, } from "./sot-cache.js";
+export { deleteAnchor, emptyAnchorMap, getAnchor, readAnchorMap, setAnchor, writeAnchorMap, } from "./anchor-map.js";
+export { bodyContentHash, deriveDecId, deriveInvId, deriveLedgerDecId, deriveLedgerInvId, normalizeBlock, topicSlug, } from "./slug.js";

package/dist/ground/index.js

@@ -1,11 +1,17 @@
-export { CANONICAL_GLOBS, CANONICAL_EXCLUDES, decisionsDir, decisionsLedgerPath, groundDir, invariantsDir, invariantsLedgerPath, manifestPath, qualityGradesPath, runsTerminalDir, stalenessCurrentPath, stalenessDir, stalenessLogPath, } from "./paths.js";
+export { CANONICAL_GLOBS, CANONICAL_EXCLUDES, alignmentPendingDir, anchorMapPath, archivedConflictsDir, conflictsDir, decisionsDir, decisionsLedgerPath, groundDir, haikuCacheDir, invariantsDir, invariantsLedgerPath, manifestPath, qualityGradesPath, runsTerminalDir, sotBindingsPath, sotCachePath, sotRenderedCacheDir, layerADeferredLogPath, preCommitDeferredLogPath, stalenessCurrentPath, stalenessDir, stalenessLogPath, topicIndexPath, } from "./paths.js";
 export { matchGlob, matchAnyGlob, compileGlob } from "./glob.js";
 export { walkCanonical } from "./walk.js";
-export { parseFrontmatter, readFrontmatter, evaluateFreshness } from "./frontmatter.js";
+export { parseFrontmatter, parseFrontmatterRecord, readFrontmatter, evaluateFreshness } from "./frontmatter.js";
 export { buildManifest, writeManifest } from "./manifest.js";
 export { buildDecisionsLedger, buildInvariantsLedger, writeDecisionsLedger, writeInvariantsLedger, } from "./ledgers.js";
 export { recordDriftEvent, writeDriftSnapshot } from "./drift.js";
+export { writeAlignmentPending } from "./alignment-pending.js";
 export { buildQualityGrades, writeQualityGrades } from "./quality-grades.js";
 export { coerceDecisionIds, coerceInvariantIds, lookupScope, readScopeIndex, rebuildScopeIndex, rescanScopeIndex, scopeIndexPath, writeScopeIndex, } from "./scope-index.js";
-export { Audience, ProvenanceFrontmatter, ManifestEntry, Manifest, DecisionAssertion, DecisionFrontmatter, InvariantFrontmatter, DecisionLedgerEntry, InvariantLedgerEntry, QualityGrade, QualityGrades, DriftEvent, } from "./schemas.js";
+export { AnchorMap, AnchorMapEntry, Audience, ProvenanceFrontmatter, ManifestEntry, Manifest, DecisionAssertion, DecisionFrontmatter, InvariantFrontmatter, DecisionLedgerEntry, InvariantLedgerEntry, QualityGrade, QualityGrades, DriftEvent, PreCommitDriftCandidate, PreCommitDriftLogEntry, SotBindings, SotCache, SotCacheEntry, SotKind, TopicIndex, TopicIndexEntry, } from "./schemas.js";
+export { bindDec, decsForPath, emptySotBindings, pathForDec, readSotBindings, unbindDec, writeSotBindings, } from "./sot-bindings.js";
+export { clearDecFromTopicIndex, emptyTopicIndex, getTopic, readTopicIndex, setTopic, writeTopicIndex, } from "./topic-index.js";
+export { deleteEntry as deleteSotCacheEntry, emptySotCache, entries as sotCacheEntries, getEntry as getSotCacheEntry, readSotCache, setEntry as setSotCacheEntry, writeSotCache, } from "./sot-cache.js";
+export { deleteAnchor, emptyAnchorMap, getAnchor, readAnchorMap, setAnchor, writeAnchorMap, } from "./anchor-map.js";
+export { bodyContentHash, deriveDecId, deriveInvId, deriveLedgerDecId, deriveLedgerInvId, normalizeBlock, topicSlug, } from "./slug.js";
 //# sourceMappingURL=index.js.map

package/dist/ground/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ground/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ground/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEhH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAK/D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EACL,SAAS,EACT,cAAc,EACd,QAAQ,EACR,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,uBAAuB,EACvB,sBAAsB,EACtB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,OAAO,EACP,UAAU,EACV,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,SAAS,EACT,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,IAAI,mBAAmB,EAClC,aAAa,EACb,OAAO,IAAI,eAAe,EAC1B,QAAQ,IAAI,gBAAgB,EAC5B,YAAY,EACZ,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,SAAS,EACT,aAAa,EACb,SAAS,EACT,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC"}

package/dist/ground/paths.d.ts

@@ -14,7 +14,28 @@ export declare function invariantsDir(repoRoot: string): string;
 export declare function decisionsLedgerPath(repoRoot: string): string;
 export declare function invariantsLedgerPath(repoRoot: string): string;
 export declare function qualityGradesPath(repoRoot: string): string;
+export declare function topicIndexPath(repoRoot: string): string;
+export declare function sotBindingsPath(repoRoot: string): string;
+export declare function sotCachePath(repoRoot: string): string;
+export declare function anchorMapPath(repoRoot: string): string;
+export declare function conflictsDir(repoRoot: string): string;
+export declare function archivedConflictsDir(repoRoot: string): string;
+export declare function alignmentPendingDir(repoRoot: string): string;
+export declare function sotRenderedCacheDir(repoRoot: string): string;
+export declare function haikuCacheDir(repoRoot: string): string;
 export declare function stalenessDir(repoRoot: string): string;
 export declare function stalenessLogPath(repoRoot: string): string;
 export declare function stalenessCurrentPath(repoRoot: string): string;
+/**
+ * Layer A live-hook deferred-block log. PostToolUse Write/Edit appends
+ * one rich record per block when the per-Write Haiku cap is exceeded
+ * or Pass-2-still-ambiguous fires. Drained by Layer C at SessionStart.
+ */
+export declare function layerADeferredLogPath(repoRoot: string): string;
+/**
+ * Layer B pre-commit-drift rich log. Git pre-commit hook appends one
+ * record per prose block discovered in staged content. Drained by
+ * Layer C at SessionStart.
+ */
+export declare function preCommitDeferredLogPath(repoRoot: string): string;
 export declare function runsTerminalDir(repoRoot: string): string;

package/dist/ground/paths.js

@@ -45,6 +45,33 @@ export function invariantsLedgerPath(repoRoot) {
 export function qualityGradesPath(repoRoot) {
     return join(groundDir(repoRoot), "quality-grades.yaml");
 }
+export function topicIndexPath(repoRoot) {
+    return join(groundDir(repoRoot), "topic-index.yaml");
+}
+export function sotBindingsPath(repoRoot) {
+    return join(groundDir(repoRoot), "sot-bindings.yaml");
+}
+export function sotCachePath(repoRoot) {
+    return join(groundDir(repoRoot), "sot-cache.yaml");
+}
+export function anchorMapPath(repoRoot) {
+    return join(groundDir(repoRoot), "anchor-map.yaml");
+}
+export function conflictsDir(repoRoot) {
+    return join(groundDir(repoRoot), "conflicts");
+}
+export function archivedConflictsDir(repoRoot) {
+    return join(conflictsDir(repoRoot), "_archived");
+}
+export function alignmentPendingDir(repoRoot) {
+    return join(groundDir(repoRoot), "alignment-pending");
+}
+export function sotRenderedCacheDir(repoRoot) {
+    return join(repoRoot, ".cairn", "cache", "sot-rendered");
+}
+export function haikuCacheDir(repoRoot) {
+    return join(repoRoot, ".cairn", "cache", "haiku");
+}
 export function stalenessDir(repoRoot) {
     return join(repoRoot, ".cairn", "staleness");
 }
@@ -54,6 +81,22 @@ export function stalenessLogPath(repoRoot) {
 export function stalenessCurrentPath(repoRoot) {
     return join(stalenessDir(repoRoot), "current.json");
 }
+/**
+ * Layer A live-hook deferred-block log. PostToolUse Write/Edit appends
+ * one rich record per block when the per-Write Haiku cap is exceeded
+ * or Pass-2-still-ambiguous fires. Drained by Layer C at SessionStart.
+ */
+export function layerADeferredLogPath(repoRoot) {
+    return join(stalenessDir(repoRoot), "layer-a-deferred.jsonl");
+}
+/**
+ * Layer B pre-commit-drift rich log. Git pre-commit hook appends one
+ * record per prose block discovered in staged content. Drained by
+ * Layer C at SessionStart.
+ */
+export function preCommitDeferredLogPath(repoRoot) {
+    return join(stalenessDir(repoRoot), "pre-commit-deferred.jsonl");
+}
 export function runsTerminalDir(repoRoot) {
     return join(repoRoot, ".cairn", "runs", "terminal");
 }

package/dist/ground/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/ground/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,WAAW;IACX,WAAW;IACX,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;IACvB,cAAc;IACd,oBAAoB;IACpB,oBAAoB;IACpB,0BAA0B;CAC3B,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,mCAAmC;IACnC,6BAA6B;IAC7B,+CAA+C;IAC/C,iDAAiD;IACjD,mCAAmC;CACpC,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/ground/paths.ts"],"names":[],"mappings":"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"}

package/dist/ground/schemas.d.ts

@@ -122,6 +122,18 @@ export declare const DecisionAssertion: z.ZodDiscriminatedUnion<[z.ZodObject<{
     description: z.ZodString;
 }, z.core.$strip>], "kind">;
 export type DecisionAssertion = z.infer<typeof DecisionAssertion>;
+/**
+ * sot_kind = where the canonical prose lives for this DEC.
+ *   "ledger" — body in this DEC file is canonical (source-comment essay,
+ *              operator-recorded). Lens renders body verbatim.
+ *   "path"   — sot_path points at the canonical location (doc paragraph,
+ *              CLAUDE.md section). Lens renders live content from there.
+ */
+export declare const SotKind: z.ZodEnum<{
+    path: "path";
+    ledger: "ledger";
+}>;
+export type SotKind = z.infer<typeof SotKind>;
 export declare const DecisionFrontmatter: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
@@ -217,6 +229,14 @@ export declare const DecisionFrontmatter: z.ZodObject<{
     }, z.core.$strip>], "kind">>>;
     human_review_hint: z.ZodOptional<z.ZodString>;
     related_invariants: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sot_kind: z.ZodEnum<{
+        path: "path";
+        ledger: "ledger";
+    }>;
+    sot_path: z.ZodString;
+    sot_content_hash: z.ZodString;
+    related: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    derived_from: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$loose>;
 export type DecisionFrontmatter = z.infer<typeof DecisionFrontmatter>;
 export declare const InvariantFrontmatter: z.ZodObject<{
@@ -225,6 +245,7 @@ export declare const InvariantFrontmatter: z.ZodObject<{
     type: z.ZodOptional<z.ZodLiteral<"invariant">>;
     status: z.ZodOptional<z.ZodEnum<{
         superseded: "superseded";
+        archived: "archived";
         active: "active";
     }>>;
     audience: z.ZodOptional<z.ZodEnum<{
@@ -241,6 +262,14 @@ export declare const InvariantFrontmatter: z.ZodObject<{
     e2e: z.ZodOptional<z.ZodString>;
     naming_convention: z.ZodOptional<z.ZodString>;
     superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sot_kind: z.ZodEnum<{
+        path: "path";
+        ledger: "ledger";
+    }>;
+    sot_path: z.ZodString;
+    sot_content_hash: z.ZodString;
+    related: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    derived_from: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$loose>;
 export type InvariantFrontmatter = z.infer<typeof InvariantFrontmatter>;
 export declare const DecisionLedgerEntry: z.ZodObject<{
@@ -282,6 +311,132 @@ export declare const QualityGrades: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type QualityGrades = z.infer<typeof QualityGrades>;
+/**
+ * Topic-index entry — one row per content-fingerprint slug across all
+ * scanned sources. `sot_source` is the canonical source path picked by
+ * priority order (docs/* > CLAUDE.md > AGENTS.md > source comments).
+ * `candidates` lists every place the same prose appears (one becomes the
+ * SoT, the rest become §DEC-<id> cites).
+ */
+export declare const TopicIndexEntry: z.ZodObject<{
+    slug: z.ZodString;
+    dec_id: z.ZodOptional<z.ZodString>;
+    sot_source: z.ZodString;
+    candidates: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        kind: z.ZodEnum<{
+            doc: "doc";
+            claudemd: "claudemd";
+            agentsmd: "agentsmd";
+            rule: "rule";
+            "source-comment": "source-comment";
+        }>;
+        anchor: z.ZodOptional<z.ZodString>;
+        line_range: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strip>>;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export type TopicIndexEntry = z.infer<typeof TopicIndexEntry>;
+export declare const TopicIndex: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    generated: z.ZodString;
+    topics: z.ZodRecord<z.ZodString, z.ZodObject<{
+        slug: z.ZodString;
+        dec_id: z.ZodOptional<z.ZodString>;
+        sot_source: z.ZodString;
+        candidates: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            kind: z.ZodEnum<{
+                doc: "doc";
+                claudemd: "claudemd";
+                agentsmd: "agentsmd";
+                rule: "rule";
+                "source-comment": "source-comment";
+            }>;
+            anchor: z.ZodOptional<z.ZodString>;
+            line_range: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strip>>;
+        created_at: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TopicIndex = z.infer<typeof TopicIndex>;
+/**
+ * SoT bindings — bidirectional map between DEC ids and their canonical
+ * source paths. Forward index is one-to-one. Reverse index is one-to-many
+ * because supersedes chains keep the same sot_path across multiple DEC
+ * ids.
+ */
+export declare const SotBindings: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    generated: z.ZodString;
+    forward: z.ZodRecord<z.ZodString, z.ZodString>;
+    reverse: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type SotBindings = z.infer<typeof SotBindings>;
+/**
+ * Sot-cache — tokenized DEC body shingles for Jaccard pre-filter in the
+ * Layer A alignment hook. Mtime-keyed so the cache rebuilds incrementally
+ * on PostToolUse Write events.
+ */
+export declare const SotCacheEntry: z.ZodObject<{
+    dec_id: z.ZodString;
+    sot_path: z.ZodString;
+    body_hash: z.ZodString;
+    tokens: z.ZodArray<z.ZodString>;
+    shingles: z.ZodArray<z.ZodString>;
+    mtime_ms: z.ZodNumber;
+}, z.core.$strip>;
+export type SotCacheEntry = z.infer<typeof SotCacheEntry>;
+export declare const SotCache: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    generated: z.ZodString;
+    entries: z.ZodRecord<z.ZodString, z.ZodObject<{
+        dec_id: z.ZodString;
+        sot_path: z.ZodString;
+        body_hash: z.ZodString;
+        tokens: z.ZodArray<z.ZodString>;
+        shingles: z.ZodArray<z.ZodString>;
+        mtime_ms: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SotCache = z.infer<typeof SotCache>;
+/**
+ * Anchor-map — external map from topic slug to its current location in
+ * source. Allows operator's docs to stay pristine (no `<!-- cairn-anchor -->`
+ * injected) while drift detection reconciles via content_hash.
+ */
+export declare const AnchorMapEntry: z.ZodObject<{
+    file: z.ZodString;
+    current_anchor: z.ZodOptional<z.ZodString>;
+    content_hash: z.ZodString;
+    line_range: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    kind: z.ZodEnum<{
+        doc: "doc";
+        claudemd: "claudemd";
+        agentsmd: "agentsmd";
+        rule: "rule";
+        "source-comment": "source-comment";
+    }>;
+}, z.core.$strip>;
+export type AnchorMapEntry = z.infer<typeof AnchorMapEntry>;
+export declare const AnchorMap: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    generated: z.ZodString;
+    anchors: z.ZodRecord<z.ZodString, z.ZodObject<{
+        file: z.ZodString;
+        current_anchor: z.ZodOptional<z.ZodString>;
+        content_hash: z.ZodString;
+        line_range: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        kind: z.ZodEnum<{
+            doc: "doc";
+            claudemd: "claudemd";
+            agentsmd: "agentsmd";
+            rule: "rule";
+            "source-comment": "source-comment";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AnchorMap = z.infer<typeof AnchorMap>;
 export declare const DriftEvent: z.ZodObject<{
     ts: z.ZodString;
     kind: z.ZodEnum<{
@@ -290,6 +445,9 @@ export declare const DriftEvent: z.ZodObject<{
         broken_link: "broken_link";
         orphan_path: "orphan_path";
         manifest_hash_changed: "manifest_hash_changed";
+        "doc-drift": "doc-drift";
+        "paragraph-deleted": "paragraph-deleted";
+        "pre-commit-drift": "pre-commit-drift";
     }>;
     path: z.ZodString;
     detail: z.ZodOptional<z.ZodString>;
@@ -297,5 +455,48 @@ export declare const DriftEvent: z.ZodObject<{
         soft: "soft";
         hard: "hard";
     }>>;
+    dec_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type DriftEvent = z.infer<typeof DriftEvent>;
+/**
+ * Layer B pre-commit-drift log entry written by the git pre-commit
+ * hook (`cairn hook pre-commit-align`). Layer C SessionStart drain
+ * consumes this file, re-checks each entry against the (possibly
+ * changed) source location, and runs the Haiku judge for ambiguous
+ * candidates.
+ *
+ * Path: `.cairn/staleness/pre-commit-deferred.jsonl`.
+ *
+ * `tier: tier1` — deterministic match passed (Jaccard ≥ 0.85, shingle
+ * ≥ 0.6, length ratio 0.5–2.0). Layer C can auto-cite without Haiku
+ * if the block survives.
+ *
+ * `tier: tier2-3` — Jaccard pre-filter survivors only; Tier 1 didn't
+ * fire. Layer C invokes Haiku dedup judge.
+ */
+export declare const PreCommitDriftCandidate: z.ZodObject<{
+    id: z.ZodString;
+    similarity: z.ZodNumber;
+    body_hash: z.ZodString;
+    sot_path: z.ZodString;
+}, z.core.$strip>;
+export type PreCommitDriftCandidate = z.infer<typeof PreCommitDriftCandidate>;
+export declare const PreCommitDriftLogEntry: z.ZodObject<{
+    ts: z.ZodString;
+    file: z.ZodString;
+    block_start_line: z.ZodNumber;
+    block_end_line: z.ZodNumber;
+    block_content_hash: z.ZodString;
+    block_prose: z.ZodString;
+    tier: z.ZodEnum<{
+        tier1: "tier1";
+        "tier2-3": "tier2-3";
+    }>;
+    candidates: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        similarity: z.ZodNumber;
+        body_hash: z.ZodString;
+        sot_path: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PreCommitDriftLogEntry = z.infer<typeof PreCommitDriftLogEntry>;