@isaacriehm/cairn 0.1.0 → 0.1.4

package/dist/gc/stub-hits.js

@@ -1,125 +0,0 @@
-/**
- * GC pass 3 — stub-catalog hits (full-tree scan).
- *
- * Layer A in `harness/src/sensors/stub-catalog.ts` only flags genuinely-NEW
- * stubs (added lines per diff). That keeps per-task feedback tight and avoids
- * paying for pre-existing debt over and over.
- *
- * GC closes the loop on accumulated debt: walks the canonical zone and runs
- * the same regex catalog against every file's CURRENT content. Hits become
- * findings the operator can triage. Phase 12 v1 surfaces only — opening a
- * targeted refactor commit (per spec) requires generating a diff that actually
- * fixes the stub, which needs an agent. That belongs in Phase 14+.
- */
-import { readdirSync, readFileSync } from "node:fs";
-import { relative, resolve } from "node:path";
-import { loadStubCatalog } from "../sensors/catalog.js";
-import { detectLanguage } from "../sensors/stub-catalog.js";
-const PASS_ID = "stub-catalog-hits";
-/** Directories the scan never descends into. */
-const SKIP_DIRS = new Set([
-    ".git",
-    "node_modules",
-    ".pnpm-store",
-    "dist",
-    "build",
-    ".next",
-    ".turbo",
-    ".cache",
-    ".archive",
-    "coverage",
-]);
-export function runStubCatalogHits(opts) {
-    const findings = [];
-    const catalog = opts.catalog ?? loadStubCatalog(opts.repoRoot);
-    const allowedLangs = opts.languages;
-    const maxBytes = opts.maxFileBytes ?? 256 * 1024;
-    const files = walkSourceTree(opts.repoRoot);
-    for (const rel of files) {
-        const lang = detectLanguage(rel);
-        if (lang === undefined)
-            continue;
-        if (allowedLangs !== undefined && !allowedLangs.includes(lang))
-            continue;
-        const abs = resolve(opts.repoRoot, rel);
-        let content;
-        try {
-            const buf = readFileSync(abs);
-            if (buf.length > maxBytes)
-                continue;
-            content = buf.toString("utf8");
-        }
-        catch {
-            continue;
-        }
-        if (content.length === 0)
-            continue;
-        for (const pattern of catalog.patterns) {
-            if (!pattern.languages.includes(lang))
-                continue;
-            const re = new RegExp(pattern.regex, "gm");
-            let m;
-            while ((m = re.exec(content)) !== null) {
-                const lineIdx = lineOf(content, m.index);
-                const matched = m[0];
-                findings.push({
-                    pass: PASS_ID,
-                    kind: "stub_hit",
-                    path: rel,
-                    detail: `${rel}:${lineIdx} matches stub pattern \`${pattern.id}\` — ${pattern.description}`,
-                    severity: pattern.severity === "hard" ? "block" : "warn",
-                    pattern_id: pattern.id,
-                    line: lineIdx,
-                    matched_text: matched.length > 200 ? matched.slice(0, 200) + "…" : matched,
-                });
-                if (re.lastIndex === m.index)
-                    re.lastIndex += 1;
-            }
-        }
-    }
-    return { findings };
-}
-/**
- * Walk every file in repoRoot, yielding repo-relative paths. Skips the SKIP_DIRS
- * set eagerly. Returns a sorted list. Mirrors the strategy of walkCanonical
- * but without the canonical-zone glob filter — the stub catalog wants to
- * catch debt anywhere in the source tree, not just docs.
- */
-function walkSourceTree(repoRoot) {
-    const 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 (SKIP_DIRS.has(entry.name))
-                    continue;
-                stack.push(abs);
-            }
-            else if (entry.isFile()) {
-                out.push(relative(repoRoot, abs).replace(/\\/g, "/"));
-            }
-        }
-    }
-    out.sort();
-    return out;
-}
-function lineOf(text, charIndex) {
-    let line = 1;
-    for (let i = 0; i < charIndex && i < text.length; i++) {
-        if (text.charCodeAt(i) === 10 /* \n */)
-            line += 1;
-    }
-    return line;
-}
-//# sourceMappingURL=stub-hits.js.map

package/dist/gc/stub-hits.js.map

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

package/dist/gc/sweep.d.ts

@@ -1,56 +0,0 @@
-/**
- * Sweep + batch entry points for GC.
- *
- * `runGcSweep` composes all five passes against a repo root and returns the
- * aggregated `GcSweepResult` (findings + commit proposals). Callers decide
- * whether to apply.
- *
- * `runGcBatch` is the apply-side counterpart. Given a sweep result, it
- * (1) optionally re-classifies each proposal against project globs; (2)
- * applies proposals whose class is in `applyClasses`; (3) when more than one
- * proposal lands in the same batch AND `canary` is true, runs
- * `verifyBatchCanary` against the post-batch state; (4) on canary fail,
- * rolls back to the pre-batch SHA and returns the batch as `rolled_back`.
- */
-import type { Profile } from "../profiles/types.js";
-import type { ProjectGlobs, SensorLanguage } from "../sensors/types.js";
-import type { GcAutoMergeClass, GcSweepResult, GcBatchResult } from "./types.js";
-export interface RunGcSweepOptions {
-    repoRoot: string;
-    /** Override stack profile. Defaults to `selectProfile(repoRoot)`. */
-    profile?: Profile;
-    /** Project-extension globs (high_stakes_globs etc). */
-    projectGlobs?: ProjectGlobs;
-    /** Languages active for stub-catalog scan. Default ["typescript"]. */
-    languages?: readonly SensorLanguage[];
-    /** Frontmatter-pass options. */
-    frontmatter?: {
-        warnDays?: number;
-        blockDays?: number;
-        /** Inject for tests. */
-        now?: Date;
-        /**
-         * Phase 12 v1 surfaces stale frontmatter only. Setting this to true also
-         * proposes a verified-at bump as a safe-class commit; the smoke uses
-         * this to exercise the auto-merge end-to-end.
-         */
-        forceRefresh?: boolean;
-    };
-    /** Quality-grades pass options. */
-    qualityRecentRunCount?: number;
-    /** Doc-gardening orphan exception list. */
-    docOrphanExcludes?: readonly string[];
-}
-export declare function runGcSweep(opts: RunGcSweepOptions): Promise<GcSweepResult>;
-export interface RunGcBatchOptions extends RunGcSweepOptions {
-    /** Auto-merge classes that are allowed to apply. Default ["safe"]. */
-    applyClasses?: readonly GcAutoMergeClass[];
-    /** Re-run the canary after the batch lands. Default true. */
-    canary?: boolean;
-    /** Override the commit author. */
-    author?: {
-        name: string;
-        email: string;
-    };
-}
-export declare function runGcBatch(opts: RunGcBatchOptions): Promise<GcBatchResult>;

package/dist/gc/sweep.js

@@ -1,178 +0,0 @@
-/**
- * Sweep + batch entry points for GC.
- *
- * `runGcSweep` composes all five passes against a repo root and returns the
- * aggregated `GcSweepResult` (findings + commit proposals). Callers decide
- * whether to apply.
- *
- * `runGcBatch` is the apply-side counterpart. Given a sweep result, it
- * (1) optionally re-classifies each proposal against project globs; (2)
- * applies proposals whose class is in `applyClasses`; (3) when more than one
- * proposal lands in the same batch AND `canary` is true, runs
- * `verifyBatchCanary` against the post-batch state; (4) on canary fail,
- * rolls back to the pre-batch SHA and returns the batch as `rolled_back`.
- */
-import { simpleGit } from "simple-git";
-import { logger } from "../logger.js";
-import { selectProfile } from "../profiles/index.js";
-import { applyCommit } from "./apply.js";
-import { verifyBatchCanary } from "./canary.js";
-import { classifyAutoMerge } from "./classify.js";
-import { runDocGardening } from "./doc-gardening.js";
-import { runFrontmatterFreshness } from "./frontmatter.js";
-import { runGeneratorDrift } from "./generator-drift.js";
-import { runQualityGradesUpdate } from "./quality-update.js";
-import { runStubCatalogHits } from "./stub-hits.js";
-const log = logger("gc.sweep");
-export async function runGcSweep(opts) {
-    const startedAt = Date.now();
-    const profile = opts.profile ?? selectProfile(opts.repoRoot);
-    const findings = [];
-    const proposals = [];
-    const passDurations = {
-        "frontmatter-freshness": 0,
-        "generator-drift": 0,
-        "stub-catalog-hits": 0,
-        "doc-gardening": 0,
-        "quality-grades": 0,
-    };
-    // 1. Frontmatter freshness.
-    {
-        const t0 = Date.now();
-        const r = runFrontmatterFreshness({
-            repoRoot: opts.repoRoot,
-            ...(opts.frontmatter?.warnDays !== undefined ? { warnDays: opts.frontmatter.warnDays } : {}),
-            ...(opts.frontmatter?.blockDays !== undefined ? { blockDays: opts.frontmatter.blockDays } : {}),
-            ...(opts.frontmatter?.now !== undefined ? { now: opts.frontmatter.now } : {}),
-            ...(opts.frontmatter?.forceRefresh !== undefined ? { forceRefresh: opts.frontmatter.forceRefresh } : {}),
-        });
-        findings.push(...r.findings);
-        proposals.push(...r.proposals);
-        passDurations["frontmatter-freshness"] = Date.now() - t0;
-    }
-    // 2. Generator drift.
-    {
-        const t0 = Date.now();
-        const r = await runGeneratorDrift({ repoRoot: opts.repoRoot, profile });
-        findings.push(...r.findings);
-        proposals.push(...r.proposals);
-        passDurations["generator-drift"] = Date.now() - t0;
-    }
-    // 3. Stub catalog hits.
-    {
-        const t0 = Date.now();
-        const r = runStubCatalogHits({
-            repoRoot: opts.repoRoot,
-            ...(opts.languages !== undefined ? { languages: opts.languages } : {}),
-        });
-        findings.push(...r.findings);
-        passDurations["stub-catalog-hits"] = Date.now() - t0;
-    }
-    // 4. Doc gardening.
-    {
-        const t0 = Date.now();
-        const r = runDocGardening({
-            repoRoot: opts.repoRoot,
-            ...(opts.docOrphanExcludes !== undefined ? { orphanExcludes: opts.docOrphanExcludes } : {}),
-        });
-        findings.push(...r.findings);
-        passDurations["doc-gardening"] = Date.now() - t0;
-    }
-    // 5. Quality grades.
-    {
-        const t0 = Date.now();
-        const r = runQualityGradesUpdate({
-            repoRoot: opts.repoRoot,
-            ...(opts.qualityRecentRunCount !== undefined ? { recentRunCount: opts.qualityRecentRunCount } : {}),
-        });
-        findings.push(...r.findings);
-        proposals.push(...r.proposals);
-        passDurations["quality-grades"] = Date.now() - t0;
-    }
-    // Re-classify proposals against project globs (passes set defaults; this
-    // ensures high-stakes hits dominate when a stale-frontmatter doc happens to
-    // live under a high-stakes glob).
-    for (const p of proposals) {
-        p.class = classifyAutoMerge({
-            paths: p.paths,
-            ...(opts.projectGlobs !== undefined ? { projectGlobs: opts.projectGlobs } : {}),
-        });
-    }
-    const result = {
-        generated: new Date().toISOString(),
-        findings,
-        proposals,
-        pass_durations: passDurations,
-        duration_ms: Date.now() - startedAt,
-    };
-    log.info({
-        repo: opts.repoRoot,
-        profile: profile.id,
-        findings: findings.length,
-        proposals: proposals.length,
-        duration_ms: result.duration_ms,
-    }, "gc sweep complete");
-    return result;
-}
-export async function runGcBatch(opts) {
-    const applyClasses = opts.applyClasses ?? ["safe"];
-    const canaryEnabled = opts.canary ?? true;
-    const sweep = await runGcSweep(opts);
-    const git = simpleGit({ baseDir: opts.repoRoot });
-    const preBatchSha = (await git.revparse(["HEAD"])).trim();
-    const toApply = [];
-    const surfaced = [];
-    for (const p of sweep.proposals) {
-        if (applyClasses.includes(p.class)) {
-            toApply.push(p);
-        }
-        else {
-            surfaced.push(p);
-        }
-    }
-    const applied = [];
-    for (const p of toApply) {
-        const r = await applyCommit({
-            repoRoot: opts.repoRoot,
-            proposal: p,
-            ...(opts.author !== undefined ? { author: opts.author } : {}),
-        });
-        applied.push({
-            pass: p.pass,
-            class: p.class,
-            commit_sha: r.commit_sha,
-            commit_message: p.commit_message,
-            paths: p.paths,
-        });
-    }
-    let canaryResult;
-    let rolledBack = false;
-    if (canaryEnabled && applied.length >= 2) {
-        canaryResult = verifyBatchCanary({ repoRoot: opts.repoRoot });
-        if (!canaryResult.ok) {
-            // Roll back to pre-batch SHA — undoes every commit applied in this
-            // batch atomically.
-            await git.reset(["--hard", preBatchSha]);
-            rolledBack = true;
-            log.warn({
-                repo: opts.repoRoot,
-                pre_batch_sha: preBatchSha,
-                applied_count: applied.length,
-                failures: canaryResult.failures,
-            }, "gc batch rolled back — canary failed");
-        }
-    }
-    const postBatchSha = rolledBack
-        ? preBatchSha
-        : (await git.revparse(["HEAD"])).trim();
-    return {
-        applied: rolledBack ? [] : applied,
-        surfaced: rolledBack ? [...surfaced, ...toApply] : surfaced,
-        pre_batch_sha: preBatchSha,
-        post_batch_sha: postBatchSha,
-        canary_ok: canaryResult ? canaryResult.ok : true,
-        canary_failures: canaryResult?.failures ?? [],
-        rolled_back: rolledBack,
-    };
-}
-//# sourceMappingURL=sweep.js.map

package/dist/gc/sweep.js.map

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

package/dist/gc/types.d.ts

@@ -1,129 +0,0 @@
-/**
- * Phase 12 — garbage collection cadence.
- *
- * GC runs five passes (per PRIMER §12.1) against the canonical zone of an
- * adopted project's mirror checkout:
- *
- *   1. frontmatter-freshness — verified-at >30d warn, >60d block
- *   2. generator-drift       — re-run profile.extractors, diff against ground
- *   3. stub-catalog-hits     — full-tree scan against stub-patterns.yaml
- *   4. doc-gardening         — broken markdown links, orphan paths
- *   5. quality-grades        — rebuild .harness/ground/quality-grades.yaml
- *
- * Each pass returns `GcFinding[]` and may attach a `GcCommitProposal` when the
- * fix is mechanical (frontmatter refresh, generator regen, quality-grades
- * rebuild). The sweep composer produces a `GcSweepResult` that the CLI / cron
- * decides how to apply.
- *
- * Auto-merge classes per L16/L17/L18 (PRIMER §12.2):
- *   safe        — formatting, doc regen, frontmatter refresh, generated content,
- *                 archive moves, stub-catalog additions. Push, no UAT.
- *   code        — touches *.ts outside generator-managed files. Sensors +
- *                 reviewer + UAT 🟢 → push.
- *   high-stakes — touches projectGlobs.high_stakes_globs. Above + E2E + Layer E.
- */
-export type GcPassId = "frontmatter-freshness" | "generator-drift" | "stub-catalog-hits" | "doc-gardening" | "quality-grades";
-export type GcFindingKind = "frontmatter_stale" | "generator_drift" | "stub_hit" | "broken_link" | "orphan_path" | "quality_update";
-export type GcAutoMergeClass = "safe" | "code" | "high-stakes";
-export interface GcFinding {
-    pass: GcPassId;
-    kind: GcFindingKind;
-    /** Repo-relative path the finding applies to. */
-    path: string;
-    /** Human-readable, one-line summary. */
-    detail: string;
-    /** warn = surface; block = sensor-equivalent failure. info = neutral. */
-    severity: "warn" | "block" | "info";
-    /** Days since verified-at (frontmatter pass only). */
-    age_days?: number;
-    /** Stub-pattern id when kind = "stub_hit". */
-    pattern_id?: string;
-    /** Line number when relevant (1-based). */
-    line?: number;
-    /** Verbatim text that triggered the finding. */
-    matched_text?: string;
-}
-/**
- * A mechanical patch the pass can produce. The CLI / cron applies it as a
- * single `chore(gc): ...` commit when the proposal's class is enabled.
- * Patches are absolute file rewrites — keys are repo-relative paths, values
- * are the full new content. Empty-string content means "delete this file".
- */
-export interface GcCommitProposal {
-    pass: GcPassId;
-    class: GcAutoMergeClass;
-    /** Files this commit touches. */
-    paths: string[];
-    /** path → full new content. Empty value = delete. */
-    patch: Record<string, string>;
-    /** Conventional-commits-shaped subject + body. */
-    commit_message: string;
-    /** Findings this commit resolves (for audit log + Discord summary). */
-    findings: GcFinding[];
-}
-export interface GcSweepResult {
-    generated: string;
-    /** All findings across passes. Includes those covered by proposals. */
-    findings: GcFinding[];
-    /** Mechanical patches the passes produced. */
-    proposals: GcCommitProposal[];
-    /** Per-pass timing (ms). */
-    pass_durations: Record<GcPassId, number>;
-    duration_ms: number;
-}
-/**
- * Outcome of `runGcBatch` — one or more proposals applied, optional canary
- * verification, optional rollback on failure. The CLI uses this to print the
- * summary and (when configured) push the resulting commits.
- */
-export interface GcBatchResult {
-    /** Applied commits with their resulting SHA. */
-    applied: {
-        pass: GcPassId;
-        class: GcAutoMergeClass;
-        commit_sha: string;
-        commit_message: string;
-        paths: string[];
-    }[];
-    /** Proposals NOT applied (class not enabled, or canary failed). */
-    surfaced: GcCommitProposal[];
-    /** Pre-batch SHA — used for rollback. */
-    pre_batch_sha: string;
-    /** Post-batch SHA when canary passed; equal to pre_batch_sha when nothing applied or rolled back. */
-    post_batch_sha: string;
-    /** True when verifyBatchCanary passed (or wasn't run because <2 applied). */
-    canary_ok: boolean;
-    /** Canary failure details when canary_ok = false. */
-    canary_failures: string[];
-    /** True when batch was rolled back due to canary fail. */
-    rolled_back: boolean;
-}
-/**
- * Synthetic context used by verifyBatchCanary to render workflow.md against
- * a known-good fixture. The fixture mirrors the values the orchestrator would
- * inject for a real run — if any of these tokens fail to resolve, the batch
- * has broken the prompt template and must not be pushed.
- */
-export interface CanarySyntheticContext {
-    agent_role: string;
-    project_name: string;
-    run_id: string;
-    mirror_path: string;
-    sha_pin: string;
-    tightened_spec_body: string;
-    acceptance_criteria: string[];
-    in_scope_decisions: {
-        id: string;
-        title: string;
-        scope_summary: string;
-    }[];
-    in_scope_invariants: {
-        id: string;
-        title: string;
-    }[];
-    off_limits: string[];
-    scoped_sensors: {
-        id: string;
-        description: string;
-    }[];
-}

package/dist/gc/types.js

@@ -1,26 +0,0 @@
-/**
- * Phase 12 — garbage collection cadence.
- *
- * GC runs five passes (per PRIMER §12.1) against the canonical zone of an
- * adopted project's mirror checkout:
- *
- *   1. frontmatter-freshness — verified-at >30d warn, >60d block
- *   2. generator-drift       — re-run profile.extractors, diff against ground
- *   3. stub-catalog-hits     — full-tree scan against stub-patterns.yaml
- *   4. doc-gardening         — broken markdown links, orphan paths
- *   5. quality-grades        — rebuild .harness/ground/quality-grades.yaml
- *
- * Each pass returns `GcFinding[]` and may attach a `GcCommitProposal` when the
- * fix is mechanical (frontmatter refresh, generator regen, quality-grades
- * rebuild). The sweep composer produces a `GcSweepResult` that the CLI / cron
- * decides how to apply.
- *
- * Auto-merge classes per L16/L17/L18 (PRIMER §12.2):
- *   safe        — formatting, doc regen, frontmatter refresh, generated content,
- *                 archive moves, stub-catalog additions. Push, no UAT.
- *   code        — touches *.ts outside generator-managed files. Sensors +
- *                 reviewer + UAT 🟢 → push.
- *   high-stakes — touches projectGlobs.high_stakes_globs. Above + E2E + Layer E.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/gc/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gc/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/ground/drift.d.ts

@@ -1,8 +0,0 @@
-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

@@ -1,23 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,20 +0,0 @@
-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

@@ -1,49 +0,0 @@
-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

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