@isaacriehm/cairn-core 0.1.0

package/dist/gc/walk-source.js

@@ -0,0 +1,59 @@
+/**
+ * Shared file-tree walker for GC passes that need a flat repo-relative listing.
+ *
+ * Mirrors the strategy of `walkCanonical` but without the canonical-zone glob
+ * filter — used by passes that scan the entire source tree (stub-catalog hits,
+ * scope-coverage, etc.).
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { relative, resolve } from "node:path";
+/** Directories the scan never descends into. */
+export const SOURCE_TREE_SKIP_DIRS = new Set([
+    ".git",
+    ".cairn",
+    "node_modules",
+    ".pnpm-store",
+    "dist",
+    "build",
+    ".next",
+    ".turbo",
+    ".cache",
+    ".archive",
+    "coverage",
+]);
+/**
+ * Walk every file in repoRoot, yielding repo-relative paths sorted
+ * alphabetically. Returns an empty array if `repoRoot` does not exist.
+ */
+export function walkSourceTree(repoRoot) {
+    const out = [];
+    if (!existsSync(repoRoot))
+        return out;
+    const stack = [repoRoot];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        if (dir === undefined)
+            break;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true, encoding: "utf8" });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const abs = resolve(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SOURCE_TREE_SKIP_DIRS.has(entry.name))
+                    continue;
+                stack.push(abs);
+            }
+            else if (entry.isFile()) {
+                out.push(relative(repoRoot, abs).replace(/\\/g, "/"));
+            }
+        }
+    }
+    out.sort();
+    return out;
+}
+//# sourceMappingURL=walk-source.js.map

package/dist/gc/walk-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-source.js","sourceRoot":"","sources":["../../src/gc/walk-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAe,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IAC3C,MAAM;IACN,QAAQ;IACR,cAAc;IACd,aAAa;IACb,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,UAAU;CACX,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,CAAC;IACtC,MAAM,KAAK,GAAa,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM;QAC7B,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACpD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/ground/drift.d.ts

@@ -0,0 +1,8 @@
+import { DriftEvent } from "./schemas.js";
+export interface DriftSnapshot {
+    generated: string;
+    /** Open drift events at the time of the snapshot. */
+    events: DriftEvent[];
+}
+export declare function recordDriftEvent(repoRoot: string, event: DriftEvent): void;
+export declare function writeDriftSnapshot(repoRoot: string, events: DriftEvent[]): string;

package/dist/ground/drift.js

@@ -0,0 +1,23 @@
+import { appendFileSync, mkdirSync, writeFileSync } from "node:fs";
+import { logger } from "../logger.js";
+import { stalenessCurrentPath, stalenessDir, stalenessLogPath } from "./paths.js";
+import { DriftEvent } from "./schemas.js";
+const log = logger("ground.drift");
+export function recordDriftEvent(repoRoot, event) {
+    const validated = DriftEvent.parse(event);
+    mkdirSync(stalenessDir(repoRoot), { recursive: true });
+    const line = `${JSON.stringify(validated)}\n`;
+    appendFileSync(stalenessLogPath(repoRoot), line, "utf8");
+    log.info({ kind: validated.kind, path: validated.path, severity: validated.severity }, "drift");
+}
+export function writeDriftSnapshot(repoRoot, events) {
+    mkdirSync(stalenessDir(repoRoot), { recursive: true });
+    const snapshot = {
+        generated: new Date().toISOString(),
+        events,
+    };
+    const path = stalenessCurrentPath(repoRoot);
+    writeFileSync(path, JSON.stringify(snapshot, null, 2), "utf8");
+    return path;
+}
+//# sourceMappingURL=drift.js.map

package/dist/ground/drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.js","sourceRoot":"","sources":["../../src/ground/drift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAQnC,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,KAAiB;IAClE,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1C,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;IAC9C,cAAc,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACzD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,MAAoB;IACvE,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAkB;QAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM;KACP,CAAC;IACF,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ground/frontmatter.d.ts

@@ -0,0 +1,20 @@
+import { type ProvenanceFrontmatter as ProvenanceType } from "./schemas.js";
+export interface ParsedDocument {
+    frontmatter: ProvenanceType | null;
+    body: string;
+    /** Raw YAML block before parsing (empty if no frontmatter present). */
+    raw: string;
+    /** Number of lines the frontmatter (incl. fences) occupies. */
+    fenceLineCount: number;
+}
+export declare function parseFrontmatter(source: string): ParsedDocument;
+export declare function readFrontmatter(absPath: string): ParsedDocument;
+export interface FreshnessVerdict {
+    /** ISO timestamp from frontmatter, or null if missing/unparseable. */
+    verifiedAt: string | null;
+    /** Days since verifiedAt; null if verifiedAt is missing. */
+    ageDays: number | null;
+    /** "fresh" | "warn" | "block" | "unknown" — matches FILESYSTEM_LAYOUT §3. */
+    status: "fresh" | "warn" | "block" | "unknown";
+}
+export declare function evaluateFreshness(fm: ProvenanceType | null, warnDays?: number, blockDays?: number, now?: Date): FreshnessVerdict;

package/dist/ground/frontmatter.js

@@ -0,0 +1,49 @@
+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?/;
+export function parseFrontmatter(source) {
+    const match = source.match(FENCE_RE);
+    if (!match || match.index !== 0) {
+        return { frontmatter: null, body: source, raw: "", fenceLineCount: 0 };
+    }
+    const raw = match[1] ?? "";
+    const fence = match[0];
+    const body = source.slice(fence.length);
+    const fenceLineCount = fence.split(/\r?\n/).length - 1;
+    if (raw.trim().length === 0) {
+        return { frontmatter: null, body, raw, fenceLineCount };
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch {
+        return { frontmatter: null, body, raw, fenceLineCount };
+    }
+    const result = ProvenanceFrontmatter.safeParse(parsed);
+    return {
+        frontmatter: result.success ? result.data : null,
+        body,
+        raw,
+        fenceLineCount,
+    };
+}
+export function readFrontmatter(absPath) {
+    const source = readFileSync(absPath, "utf8");
+    return parseFrontmatter(source);
+}
+export function evaluateFreshness(fm, warnDays = 30, blockDays = 60, now = new Date()) {
+    if (!fm || !fm["verified-at"]) {
+        return { verifiedAt: null, ageDays: null, status: "unknown" };
+    }
+    const ts = Date.parse(fm["verified-at"]);
+    if (Number.isNaN(ts)) {
+        return { verifiedAt: fm["verified-at"], ageDays: null, status: "unknown" };
+    }
+    const ageMs = now.getTime() - ts;
+    const ageDays = Math.floor(ageMs / 86_400_000);
+    const status = ageDays >= blockDays ? "block" : ageDays >= warnDays ? "warn" : "fresh";
+    return { verifiedAt: fm["verified-at"], ageDays, status };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/ground/frontmatter.js.map

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

package/dist/ground/glob.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Minimal glob matcher (no external dep). Supports `**`, `*`, `?`, and literal
+ * segments. Patterns are POSIX-style; segments separator is forward slash.
+ *
+ * Single home for glob matching across the package — walker, GC sweep,
+ * sensors, mirror dirty-overlap, and MCP tools all import from here.
+ */
+export declare function matchGlob(path: string, glob: string): boolean;
+export declare function matchAnyGlob(path: string, globs: readonly string[]): boolean;
+export declare function compileGlob(glob: string): RegExp;

package/dist/ground/glob.js

@@ -0,0 +1,46 @@
+/**
+ * Minimal glob matcher (no external dep). Supports `**`, `*`, `?`, and literal
+ * segments. Patterns are POSIX-style; segments separator is forward slash.
+ *
+ * Single home for glob matching across the package — walker, GC sweep,
+ * sensors, mirror dirty-overlap, and MCP tools all import from here.
+ */
+export function matchGlob(path, glob) {
+    return compileGlob(glob).test(path);
+}
+export function matchAnyGlob(path, globs) {
+    return globs.some((g) => matchGlob(path, g));
+}
+export function compileGlob(glob) {
+    let re = "^";
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === "*") {
+            if (glob[i + 1] === "*") {
+                i += 1;
+                if (glob[i + 1] === "/") {
+                    i += 1;
+                    re += "(?:.*/)?";
+                }
+                else {
+                    re += ".*";
+                }
+            }
+            else {
+                re += "[^/]*";
+            }
+        }
+        else if (c === "?") {
+            re += "[^/]";
+        }
+        else if (c !== undefined && /[.+^${}()|[\]\\]/.test(c)) {
+            re += `\\${c}`;
+        }
+        else {
+            re += c ?? "";
+        }
+    }
+    re += "$";
+    return new RegExp(re);
+}
+//# sourceMappingURL=glob.js.map

package/dist/ground/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/ground/glob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY;IAClD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAwB;IACjE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,EAAE,GAAG,GAAG,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACxB,CAAC,IAAI,CAAC,CAAC;gBACP,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBACxB,CAAC,IAAI,CAAC,CAAC;oBACP,EAAE,IAAI,UAAU,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,EAAE,IAAI,IAAI,CAAC;gBACb,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,EAAE,IAAI,OAAO,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACrB,EAAE,IAAI,MAAM,CAAC;QACf,CAAC;aAAM,IAAI,CAAC,KAAK,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,EAAE,IAAI,GAAG,CAAC;IACV,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC"}

package/dist/ground/index.d.ts

@@ -0,0 +1,16 @@
+export { CANONICAL_GLOBS, CANONICAL_EXCLUDES, decisionsDir, decisionsLedgerPath, groundDir, invariantsDir, invariantsLedgerPath, manifestPath, qualityGradesPath, runsTerminalDir, stalenessCurrentPath, stalenessDir, stalenessLogPath, } from "./paths.js";
+export { matchGlob, matchAnyGlob, compileGlob } from "./glob.js";
+export { walkCanonical } from "./walk.js";
+export { parseFrontmatter, readFrontmatter, evaluateFreshness } from "./frontmatter.js";
+export type { ParsedDocument, FreshnessVerdict } from "./frontmatter.js";
+export { buildManifest, writeManifest } from "./manifest.js";
+export type { BuildManifestOptions } from "./manifest.js";
+export { buildDecisionsLedger, buildInvariantsLedger, writeDecisionsLedger, writeInvariantsLedger, } from "./ledgers.js";
+export type { LedgerOptions } from "./ledgers.js";
+export { recordDriftEvent, writeDriftSnapshot } from "./drift.js";
+export type { DriftSnapshot } from "./drift.js";
+export { buildQualityGrades, writeQualityGrades } from "./quality-grades.js";
+export type { QualityGradesOptions } from "./quality-grades.js";
+export { lookupScope, readScopeIndex, rebuildScopeIndex, scopeIndexPath, writeScopeIndex, } from "./scope-index.js";
+export type { RebuildScopeIndexOptions, RebuildScopeIndexResult, ScopeIndex, ScopeIndexEntry, } from "./scope-index.js";
+export { Audience, ProvenanceFrontmatter, ManifestEntry, Manifest, DecisionAssertion, DecisionFrontmatter, InvariantFrontmatter, DecisionLedgerEntry, InvariantLedgerEntry, QualityGrade, QualityGrades, DriftEvent, } from "./schemas.js";

package/dist/ground/index.js

@@ -0,0 +1,11 @@
+export { CANONICAL_GLOBS, CANONICAL_EXCLUDES, decisionsDir, decisionsLedgerPath, groundDir, invariantsDir, invariantsLedgerPath, manifestPath, qualityGradesPath, runsTerminalDir, stalenessCurrentPath, stalenessDir, stalenessLogPath, } from "./paths.js";
+export { matchGlob, matchAnyGlob, compileGlob } from "./glob.js";
+export { walkCanonical } from "./walk.js";
+export { parseFrontmatter, 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 { buildQualityGrades, writeQualityGrades } from "./quality-grades.js";
+export { lookupScope, readScopeIndex, rebuildScopeIndex, scopeIndexPath, writeScopeIndex, } from "./scope-index.js";
+export { Audience, ProvenanceFrontmatter, ManifestEntry, Manifest, DecisionAssertion, DecisionFrontmatter, InvariantFrontmatter, DecisionLedgerEntry, InvariantLedgerEntry, QualityGrade, QualityGrades, DriftEvent, } from "./schemas.js";
+//# sourceMappingURL=index.js.map

package/dist/ground/index.js.map

@@ -0,0 +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,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAO1B,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"}

package/dist/ground/ledgers.d.ts

@@ -0,0 +1,18 @@
+import { resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { type DecisionLedgerEntry, type InvariantLedgerEntry } from "./schemas.js";
+export interface LedgerOptions {
+    repoRoot: string;
+}
+export declare function buildDecisionsLedger(opts: LedgerOptions): DecisionLedgerEntry[];
+export declare function writeDecisionsLedger(opts: LedgerOptions): {
+    entries: DecisionLedgerEntry[];
+    path: string;
+};
+export declare function buildInvariantsLedger(opts: LedgerOptions): InvariantLedgerEntry[];
+export declare function writeInvariantsLedger(opts: LedgerOptions): {
+    entries: InvariantLedgerEntry[];
+    path: string;
+};
+export { parseYaml };
+export { resolve };

package/dist/ground/ledgers.js

@@ -0,0 +1,103 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { logger } from "../logger.js";
+import { parseFrontmatter } from "./frontmatter.js";
+import { decisionsDir, decisionsLedgerPath, invariantsDir, invariantsLedgerPath, } from "./paths.js";
+import { DecisionFrontmatter, InvariantFrontmatter, } from "./schemas.js";
+const log = logger("ground.ledgers");
+export function buildDecisionsLedger(opts) {
+    const dir = decisionsDir(opts.repoRoot);
+    if (!existsSync(dir))
+        return [];
+    const entries = [];
+    for (const file of listMarkdown(dir)) {
+        const abs = join(dir, file);
+        const fm = parseFrontmatter(readFileSync(abs, "utf8")).frontmatter;
+        const parsed = DecisionFrontmatter.safeParse(fm);
+        if (!parsed.success) {
+            log.warn({ path: abs, error: parsed.error.message }, "decision frontmatter invalid; skipping");
+            continue;
+        }
+        if (parsed.data.status !== "accepted")
+            continue;
+        if (parsed.data.superseded_by)
+            continue;
+        entries.push({
+            id: parsed.data.id,
+            title: parsed.data.title,
+            status: parsed.data.status,
+            ...(parsed.data.scope_globs !== undefined ? { scope_globs: parsed.data.scope_globs } : {}),
+            ...(parsed.data.supersedes !== undefined ? { supersedes: parsed.data.supersedes } : {}),
+            ...(parsed.data.superseded_by !== undefined
+                ? { superseded_by: parsed.data.superseded_by }
+                : {}),
+        });
+    }
+    entries.sort((a, b) => a.id.localeCompare(b.id));
+    return entries;
+}
+export function writeDecisionsLedger(opts) {
+    const entries = buildDecisionsLedger(opts);
+    const path = decisionsLedgerPath(opts.repoRoot);
+    mkdirSync(decisionsDir(opts.repoRoot), { recursive: true });
+    writeFileSync(path, stringifyYaml(entries), "utf8");
+    log.debug({ path, count: entries.length }, "wrote decisions ledger");
+    return { entries, path };
+}
+export function buildInvariantsLedger(opts) {
+    const dir = invariantsDir(opts.repoRoot);
+    if (!existsSync(dir))
+        return [];
+    const entries = [];
+    for (const file of listMarkdown(dir)) {
+        const abs = join(dir, file);
+        const fm = parseFrontmatter(readFileSync(abs, "utf8")).frontmatter;
+        const parsed = InvariantFrontmatter.safeParse(fm);
+        if (!parsed.success) {
+            log.warn({ path: abs, error: parsed.error.message }, "invariant frontmatter invalid; skipping");
+            continue;
+        }
+        const status = parsed.data.status ?? "active";
+        if (status !== "active")
+            continue;
+        entries.push({
+            id: parsed.data.id,
+            title: parsed.data.title,
+            status,
+            ...(parsed.data.source_decision !== undefined
+                ? { source_decision: parsed.data.source_decision }
+                : {}),
+            ...(parsed.data.superseded_by !== undefined
+                ? { superseded_by: parsed.data.superseded_by }
+                : {}),
+        });
+    }
+    entries.sort((a, b) => a.id.localeCompare(b.id));
+    return entries;
+}
+export function writeInvariantsLedger(opts) {
+    const entries = buildInvariantsLedger(opts);
+    const path = invariantsLedgerPath(opts.repoRoot);
+    mkdirSync(invariantsDir(opts.repoRoot), { recursive: true });
+    writeFileSync(path, stringifyYaml(entries), "utf8");
+    log.debug({ path, count: entries.length }, "wrote invariants ledger");
+    return { entries, path };
+}
+function listMarkdown(dir) {
+    let dirents;
+    try {
+        dirents = readdirSync(dir, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return [];
+    }
+    return dirents
+        .filter((d) => d.isFile() && d.name.endsWith(".md") && !d.name.startsWith("_"))
+        .map((d) => d.name)
+        .sort();
+}
+// Re-exports for tests / callers that want raw entries.
+export { parseYaml };
+export { resolve };
+//# sourceMappingURL=ledgers.js.map

package/dist/ground/ledgers.js.map

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

package/dist/ground/manifest.d.ts

@@ -0,0 +1,10 @@
+import type { Manifest } from "./schemas.js";
+export interface BuildManifestOptions {
+    repoRoot: string;
+    generator?: string;
+}
+export declare function buildManifest(opts: BuildManifestOptions): Manifest;
+export declare function writeManifest(opts: BuildManifestOptions): {
+    manifest: Manifest;
+    path: string;
+};

package/dist/ground/manifest.js

@@ -0,0 +1,88 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { logger } from "../logger.js";
+import { readFrontmatter } from "./frontmatter.js";
+import { groundDir, manifestPath } from "./paths.js";
+import { walkCanonical } from "./walk.js";
+const log = logger("ground.manifest");
+export function buildManifest(opts) {
+    const { repoRoot } = opts;
+    const files = walkCanonical(repoRoot);
+    const entries = files.map((rel) => makeEntry(repoRoot, rel));
+    return {
+        version: 1,
+        generated: new Date().toISOString(),
+        ...(opts.generator !== undefined ? { generator: opts.generator } : {}),
+        files: entries,
+    };
+}
+export function writeManifest(opts) {
+    const manifest = buildManifest(opts);
+    const path = manifestPath(opts.repoRoot);
+    mkdirSync(dirname(path), { recursive: true });
+    mkdirSync(groundDir(opts.repoRoot), { recursive: true });
+    writeFileSync(path, stringifyYaml(manifest), "utf8");
+    log.debug({ path, count: manifest.files.length }, "wrote manifest");
+    return { manifest, path };
+}
+function makeEntry(repoRoot, rel) {
+    const abs = resolve(repoRoot, rel);
+    const buf = readFileSync(abs);
+    const sha256 = createHash("sha256").update(buf).digest("hex");
+    const classification = classify(rel);
+    // For markdown, lift audience + verified_at + generator from frontmatter.
+    let audience;
+    let verifiedAt;
+    let generator;
+    let source;
+    if (rel.endsWith(".md")) {
+        const fm = readFrontmatter(abs).frontmatter;
+        if (fm) {
+            audience = fm.audience;
+            verifiedAt = fm["verified-at"];
+            const generatorValue = fm["generator"];
+            generator = typeof generatorValue === "string" ? generatorValue : undefined;
+            const sourceValue = fm["source"];
+            source = typeof sourceValue === "string" ? sourceValue : undefined;
+        }
+    }
+    return {
+        path: rel,
+        sha256,
+        classification,
+        ...(audience !== undefined ? { audience } : {}),
+        ...(verifiedAt !== undefined ? { verified_at: verifiedAt } : {}),
+        ...(generator !== undefined ? { generator } : {}),
+        ...(source !== undefined ? { source } : {}),
+    };
+}
+function classify(rel) {
+    if (rel === "AGENTS.md" || rel === "CLAUDE.md")
+        return "orientation";
+    if (rel.startsWith(".claude/rules/"))
+        return "rule";
+    if (rel.startsWith(".claude/agents/"))
+        return "agent-def";
+    if (rel.startsWith(".claude/skills/"))
+        return "skill";
+    if (rel === ".claude/settings.json")
+        return "config";
+    if (rel.startsWith(".cairn/ground/decisions/"))
+        return "decision";
+    if (rel.startsWith(".cairn/ground/invariants/"))
+        return "invariant";
+    if (rel.startsWith(".cairn/config/"))
+        return "cairn-config";
+    if (rel.startsWith(".cairn/ground/"))
+        return "ground";
+    if (rel.startsWith(".cairn/tasks/"))
+        return "task";
+    if (rel.startsWith("docs/decisions/"))
+        return "decision";
+    if (rel.startsWith("docs/"))
+        return "doc";
+    return "other";
+}
+//# sourceMappingURL=manifest.js.map

package/dist/ground/manifest.js.map

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

package/dist/ground/paths.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Canonical-zone glob roots, relative to the adopted project's repo root.
+ *
+ * Per FILESYSTEM_LAYOUT.md §2.1. These paths are project-agnostic (every
+ * cairn-adopted repo carries the same layout).
+ */
+export declare const CANONICAL_GLOBS: string[];
+/** Paths excluded from canonical regardless of glob match. */
+export declare const CANONICAL_EXCLUDES: string[];
+export declare function groundDir(repoRoot: string): string;
+export declare function manifestPath(repoRoot: string): string;
+export declare function decisionsDir(repoRoot: string): string;
+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 stalenessDir(repoRoot: string): string;
+export declare function stalenessLogPath(repoRoot: string): string;
+export declare function stalenessCurrentPath(repoRoot: string): string;
+export declare function runsTerminalDir(repoRoot: string): string;

package/dist/ground/paths.js

@@ -0,0 +1,61 @@
+import { join } from "node:path";
+/**
+ * Canonical-zone glob roots, relative to the adopted project's repo root.
+ *
+ * Per FILESYSTEM_LAYOUT.md §2.1. These paths are project-agnostic (every
+ * cairn-adopted repo carries the same layout).
+ */
+export const CANONICAL_GLOBS = [
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".claude/settings.json",
+    ".claude/agents/**/*.md",
+    ".claude/skills/**/*.md",
+    ".claude/rules/**/*.md",
+    "docs/**/*.md",
+    ".cairn/config/**/*",
+    ".cairn/ground/**/*",
+    ".cairn/tasks/active/**/*",
+];
+/** Paths excluded from canonical regardless of glob match. */
+export const CANONICAL_EXCLUDES = [
+    ".cairn/ground/decisions/_inbox/**",
+    ".cairn/ground/manifest.yaml",
+    ".cairn/ground/decisions/decisions.ledger.yaml",
+    ".cairn/ground/invariants/invariants.ledger.yaml",
+    ".cairn/ground/quality-grades.yaml",
+];
+export function groundDir(repoRoot) {
+    return join(repoRoot, ".cairn", "ground");
+}
+export function manifestPath(repoRoot) {
+    return join(groundDir(repoRoot), "manifest.yaml");
+}
+export function decisionsDir(repoRoot) {
+    return join(groundDir(repoRoot), "decisions");
+}
+export function invariantsDir(repoRoot) {
+    return join(groundDir(repoRoot), "invariants");
+}
+export function decisionsLedgerPath(repoRoot) {
+    return join(decisionsDir(repoRoot), "decisions.ledger.yaml");
+}
+export function invariantsLedgerPath(repoRoot) {
+    return join(invariantsDir(repoRoot), "invariants.ledger.yaml");
+}
+export function qualityGradesPath(repoRoot) {
+    return join(groundDir(repoRoot), "quality-grades.yaml");
+}
+export function stalenessDir(repoRoot) {
+    return join(repoRoot, ".cairn", "staleness");
+}
+export function stalenessLogPath(repoRoot) {
+    return join(stalenessDir(repoRoot), "log.jsonl");
+}
+export function stalenessCurrentPath(repoRoot) {
+    return join(stalenessDir(repoRoot), "current.json");
+}
+export function runsTerminalDir(repoRoot) {
+    return join(repoRoot, ".cairn", "runs", "terminal");
+}
+//# sourceMappingURL=paths.js.map

package/dist/ground/paths.js.map

@@ -0,0 +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,uBAAuB;IACvB,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"}

package/dist/ground/quality-grades.d.ts

@@ -0,0 +1,11 @@
+import { type QualityGrades } from "./schemas.js";
+export interface QualityGradesOptions {
+    repoRoot: string;
+    /** Number of most recent terminal runs to consider (default 50). */
+    recentRunCount?: number;
+}
+export declare function buildQualityGrades(opts: QualityGradesOptions): QualityGrades;
+export declare function writeQualityGrades(opts: QualityGradesOptions): {
+    grades: QualityGrades;
+    path: string;
+};