@isaacriehm/cairn 0.1.0

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.
+ *
+ * Mirror of `compileGlob` from src/mirror/dirty-overlap.ts — unified here so
+ * both modules share the same matching semantics.
+ */
+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.
+ *
+ * Mirror of `compileGlob` from src/mirror/dirty-overlap.ts — unified here so
+ * both modules share the same matching semantics.
+ */
+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,14 @@
+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 { Audience, ProvenanceFrontmatter, ManifestEntry, Manifest, DecisionAssertion, DecisionFrontmatter, InvariantFrontmatter, DecisionLedgerEntry, InvariantLedgerEntry, QualityGrade, QualityGrades, DriftEvent, } from "./schemas.js";

package/dist/ground/index.js

@@ -0,0 +1,10 @@
+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 { 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,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(".harness/ground/decisions/"))
+        return "decision";
+    if (rel.startsWith(".harness/ground/invariants/"))
+        return "invariant";
+    if (rel.startsWith(".harness/config/"))
+        return "harness-config";
+    if (rel.startsWith(".harness/ground/"))
+        return "ground";
+    if (rel.startsWith(".harness/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
+ * harness-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
+ * harness-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",
+    ".harness/config/**/*",
+    ".harness/ground/**/*",
+    ".harness/tasks/active/**/*",
+];
+/** Paths excluded from canonical regardless of glob match. */
+export const CANONICAL_EXCLUDES = [
+    ".harness/ground/decisions/_inbox/**",
+    ".harness/ground/manifest.yaml",
+    ".harness/ground/decisions/decisions.ledger.yaml",
+    ".harness/ground/invariants/invariants.ledger.yaml",
+    ".harness/ground/quality-grades.yaml",
+];
+export function groundDir(repoRoot) {
+    return join(repoRoot, ".harness", "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, ".harness", "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, ".harness", "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,sBAAsB;IACtB,sBAAsB;IACtB,4BAA4B;CAC7B,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,qCAAqC;IACrC,+BAA+B;IAC/B,iDAAiD;IACjD,mDAAmD;IACnD,qCAAqC;CACtC,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC9C,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,UAAU,EAAE,WAAW,CAAC,CAAC;AACjD,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,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACxD,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;
+};

package/dist/ground/quality-grades.js

@@ -0,0 +1,98 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, 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 { qualityGradesPath, runsTerminalDir } from "./paths.js";
+const log = logger("ground.quality-grades");
+export function buildQualityGrades(opts) {
+    const dir = runsTerminalDir(opts.repoRoot);
+    const limit = opts.recentRunCount ?? 50;
+    const moduleAccum = new Map();
+    if (existsSync(dir)) {
+        const runIds = listRecentRuns(dir, limit);
+        for (const runId of runIds) {
+            const meta = readJsonIfExists(join(dir, runId, "meta.json"));
+            const sensors = readYamlIfExists(join(dir, runId, "sensor-results.yaml"));
+            const moduleKey = meta?.scoped_module ?? "unscoped";
+            const acc = moduleAccum.get(moduleKey) ?? {
+                passes: 0,
+                total: 0,
+                drifts: 0,
+                latest: "",
+            };
+            if (sensors) {
+                for (const s of sensors) {
+                    if (s.status === "skip")
+                        continue;
+                    acc.total += 1;
+                    if (s.status === "pass")
+                        acc.passes += 1;
+                }
+            }
+            if (meta?.finished_at && (!acc.latest || meta.finished_at > acc.latest)) {
+                acc.latest = meta.finished_at;
+            }
+            moduleAccum.set(moduleKey, acc);
+        }
+    }
+    const modules = [];
+    for (const [module, acc] of moduleAccum) {
+        const passRate = acc.total === 0 ? 1 : acc.passes / acc.total;
+        const score = Math.round(passRate * 100);
+        modules.push({
+            module,
+            score,
+            pass_rate: Number(passRate.toFixed(3)),
+            drift_count: acc.drifts,
+            last_updated: acc.latest || new Date().toISOString(),
+            recent_run_count: acc.total === 0 ? 0 : Math.ceil(acc.total / 10), // rough run count proxy
+        });
+    }
+    modules.sort((a, b) => a.score - b.score); // weakest first
+    return { version: 1, generated: new Date().toISOString(), modules };
+}
+export function writeQualityGrades(opts) {
+    const grades = buildQualityGrades(opts);
+    const path = qualityGradesPath(opts.repoRoot);
+    mkdirSync(resolve(path, ".."), { recursive: true });
+    writeFileSync(path, stringifyYaml(grades), "utf8");
+    log.debug({ path, modules: grades.modules.length }, "wrote quality grades");
+    return { grades, path };
+}
+function listRecentRuns(dir, limit) {
+    let dirents;
+    try {
+        dirents = readdirSync(dir, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return [];
+    }
+    const dirs = dirents.filter((d) => d.isDirectory()).map((d) => d.name);
+    dirs.sort((a, b) => {
+        const sa = statSync(join(dir, a)).mtimeMs;
+        const sb = statSync(join(dir, b)).mtimeMs;
+        return sb - sa;
+    });
+    return dirs.slice(0, limit);
+}
+function readJsonIfExists(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function readYamlIfExists(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return parseYaml(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=quality-grades.js.map

package/dist/ground/quality-grades.js.map

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