@warpgogol/forge 2.16.0 → 2.17.0

package/dist/os/compass/compass.module.js

@@ -0,0 +1,183 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the forge Compass command family against the Site OS kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement compass handler logic — delegate to handlers/ inlined by RFC-0556.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial forgeCompassModule registering 12 compass commands.</item>
+  <item>RFC-0538: renamed compass.changesummary.tidy to compass.summary.trim, removed compass.annotate, compass.clear, compass.markup.migrate, compass.invariant.add.</item>
+  <item>RFC-0556: removed dynamic import of @warpgogol/site-kernel-checks, all handlers now inlined in forge/os/compass/handlers/.</item>
+</CHANGE_SUMMARY>
+*/
+import { runCompassInventory, runCompassValidation } from "./handlers/compass-inventory-handler.js";
+import { runCompassAuditPlan, runCompassAuditRecord, runCompassAuditBaseline, runCompassAuditValidate, } from "./handlers/compass-audit-handler.js";
+import { runCompassChangeSummaryValidate, runCompassSummaryTrim, } from "./handlers/compass-change-summary-handler.js";
+const compassScanFlags = {
+    packages: {
+        kind: "boolean",
+        description: "Scan packages/ instead of the inferred app or default workspace scope.",
+    },
+    package: {
+        kind: "string",
+        description: "With --packages, scan one package by directory/name.",
+    },
+    workpiece: {
+        kind: "string",
+        description: "Scan a mission workpiece directory (RFC-0617). Mutually exclusive with --packages and --site.",
+    },
+};
+export const forgeCompassModule = {
+    name: "forge-compass",
+    version: "0.1.0",
+    runtime: "autonomous",
+    async register(registry) {
+        registry.registerCommand({
+            name: "compass.inventory",
+            description: "Generate the repository-wide Compass source inventory XML report.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: { ...compassScanFlags },
+            reads: [
+                "packages/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "apps/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+            ],
+            execute: runCompassInventory,
+        });
+        registry.registerCommand({
+            name: "compass.validate",
+            description: "Validate authored source files against current Compass scaffolding requirements.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: { ...compassScanFlags },
+            reads: [
+                "packages/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "apps/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "docs/source-markup.xml",
+            ],
+            execute: runCompassValidation,
+        });
+        registry.registerCommand({
+            name: "compass.changesummary.validate",
+            description: "Validate CHANGE_SUMMARY blocks for boilerplate items and over-cap unprotected items (RFC-0349).",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: { ...compassScanFlags },
+            reads: [
+                "packages/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "apps/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+            ],
+            execute: runCompassChangeSummaryValidate,
+        });
+        registry.registerCommand({
+            name: "compass.summary.trim",
+            description: "Deterministically trim CHANGE_SUMMARY blocks: remove boilerplate, cap total items to 30, preserve protected items (RFC-0538).",
+            scope: "workspace",
+            mutatesState: true,
+            supportsAllSites: true,
+            writes: [
+                "apps/**/*.{astro,ts,tsx,js,mjs,css,cs,tscn,tres,gd,md}",
+                "packages/**/*.{astro,ts,tsx,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,js,mjs,css,cs,tscn,tres,gd,md}",
+            ],
+            reads: [
+                "packages/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "apps/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+            ],
+            cacheable: false,
+            flags: { ...compassScanFlags },
+            execute: runCompassSummaryTrim,
+        });
+        registry.registerCommand({
+            name: "compass.audit.plan",
+            description: "Emit a deterministic work-order of files whose revision has advanced past the threshold since their last Compass audit (RFC-0352). Read-only, no LLM.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: {
+                ...compassScanFlags,
+                threshold: {
+                    kind: "string",
+                    description: "Revision distance that makes a file audit-overdue.",
+                },
+            },
+            reads: [
+                "packages/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "apps/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "docs/compass-audit-ledger.generated.yaml",
+            ],
+            execute: runCompassAuditPlan,
+        });
+        registry.registerCommand({
+            name: "compass.audit.record",
+            description: "Stamp a file's audit verdict and current revision into the compass-audit ledger (RFC-0352). Mutating.",
+            scope: "workspace",
+            mutatesState: true,
+            supportsAllSites: true,
+            writes: ["docs/compass-audit-ledger.generated.yaml"],
+            reads: ["docs/compass-audit-ledger.generated.yaml"],
+            cacheable: false,
+            flags: {
+                file: { kind: "string", required: true, description: "Authored file path to stamp." },
+                verdict: {
+                    kind: "string",
+                    required: true,
+                    description: "Audit verdict: pass, repaired, or baseline.",
+                },
+                agent: { kind: "string", description: "Agent identity to record in the ledger." },
+            },
+            execute: runCompassAuditRecord,
+        });
+        registry.registerCommand({
+            name: "compass.audit.baseline",
+            description: "Seed the compass-audit ledger for every authored file at its current revision with verdict=baseline (RFC-0352). One-time bootstrap.",
+            scope: "workspace",
+            mutatesState: true,
+            supportsAllSites: true,
+            writes: ["docs/compass-audit-ledger.generated.yaml"],
+            reads: [
+                "packages/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "apps/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+            ],
+            cacheable: false,
+            flags: { ...compassScanFlags },
+            execute: runCompassAuditBaseline,
+        });
+        registry.registerCommand({
+            name: "compass.audit.validate",
+            description: "Validate that no authored file is audit-overdue per the revision threshold (RFC-0352). Warns by default, fails with --strict.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: {
+                ...compassScanFlags,
+                strict: {
+                    kind: "boolean",
+                    description: "Fail when audit-overdue authored files are found.",
+                },
+            },
+            reads: [
+                "packages/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "apps/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "services/**/*.{ts,tsx,astro,js,mjs,css,cs,tscn,tres,gd,md}",
+                "docs/compass-audit-ledger.generated.yaml",
+            ],
+            execute: runCompassAuditValidate,
+            gate: {
+                severity: "mixed",
+                phase: "author",
+                conditional: {
+                    kind: "flag",
+                    ref: "--strict",
+                    description: "Warns by default, fails with --strict",
+                },
+            },
+        });
+    },
+};
+//# sourceMappingURL=compass.module.js.map

package/dist/os/compass/compass.module.js.map

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

package/dist/os/compass/handlers/compass-audit-handler.d.ts

@@ -0,0 +1,36 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+interface CompassAuditWorkOrderItem {
+    path: string;
+    currentRevision: number;
+    auditedRevision: number | null;
+    reason: "never-audited" | "revision-threshold-crossed";
+    moduleContract: string;
+    changeSummary: string;
+}
+export declare function isAuditDue(current: number, audited: number | null, threshold: number): boolean;
+export declare function runCompassAuditPlan(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    threshold: number;
+    dueCount: number;
+    items: CompassAuditWorkOrderItem[];
+}>>;
+export declare function runCompassAuditRecord(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    path: string;
+    action: "recorded";
+}>>;
+export declare function runCompassAuditBaseline(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    seeded: number;
+    total: number;
+}>>;
+export declare function runCompassAuditValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    strict: boolean;
+    dueCount: number;
+    diagnostics: Array<{
+        ruleId: string;
+        severity: string;
+        file: string;
+        message: string;
+        fix: string;
+    }>;
+}>>;
+export {};
+//# sourceMappingURL=compass-audit-handler.d.ts.map

package/dist/os/compass/handlers/compass-audit-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-audit-handler.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-audit-handler.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AA8B/B,UAAU,yBAAyB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,eAAe,GAAG,4BAA4B,CAAC;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAG9F;AAuDD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC,CAAC,CACH,CA6DA;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC,CACH,CA6DA;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CACH,CA8CA;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACJ,CAAC,CACH,CA+DA"}

package/dist/os/compass/handlers/compass-audit-handler.js

@@ -0,0 +1,260 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Compass audit command handlers (plan, record, baseline, validate).
+Moved from @warpgogol/site-kernel-checks to @warpgogol/forge for full autonomous
+mode (RFC-0556). Drives per-file semantic-truth auditing on a revision cadence (RFC-0352).</purpose>
+<non-goals>
+  <item>Do not perform semantic comparison inside a command — commands are deterministic; the code-vs-prose judgment is the agent's.</item>
+  <item>Do not call an LLM or read any API key.</item>
+  <item>Do not replace compass.validate — this adds a heavy truth audit on top.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0352: initial implementation of compass.audit.plan, compass.audit.record, compass.audit.baseline, compass.audit.validate.</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-checks to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile } from "node:fs/promises";
+import { resolve, relative } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createCompassInventoryEntries } from "./compass-inventory.js";
+import { resolveCompassScanRoot } from "./resolve-scan-root.js";
+import { getRevisionByPath } from "./git-revision.js";
+import { writeFileAtomic } from "../../../src/utils/fs-atomic.js";
+import { buildGeneratedHeader } from "../../../src/utils/generated-marker.js";
+import { parse as yamlParse, stringify as yamlStringify } from "yaml";
+const execFileAsync = promisify(execFile);
+const LEDGER_PATH = "docs/compass-audit-ledger.generated.yaml";
+const DEFAULT_THRESHOLD = 30;
+function resolveRevisionThreshold(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const parsed = typeof value === "number" ? value : Number(String(value));
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+}
+export function isAuditDue(current, audited, threshold) {
+    if (audited === null)
+        return true;
+    return current - audited >= threshold;
+}
+const _LEDGER_ADVISORY = { ownerCommand: "compass.audit.record" };
+function withLedgerAdvisory(ledger) {
+    return {
+        revisionThreshold: ledger.revisionThreshold ?? DEFAULT_THRESHOLD,
+        entries: Array.isArray(ledger.entries) ? ledger.entries : [],
+    };
+}
+async function loadLedger(workspaceRoot) {
+    const abs = resolve(workspaceRoot, LEDGER_PATH);
+    try {
+        const content = await readFile(abs, "utf8");
+        return withLedgerAdvisory(yamlParse(content));
+    }
+    catch {
+        return withLedgerAdvisory({});
+    }
+}
+async function saveLedger(workspaceRoot, ledger) {
+    const normalized = withLedgerAdvisory(ledger);
+    normalized.entries.sort((a, b) => a.path.localeCompare(b.path));
+    const abs = resolve(workspaceRoot, LEDGER_PATH);
+    const header = buildGeneratedHeader({
+        ownerCommand: "compass.audit.record",
+        filePath: LEDGER_PATH,
+    });
+    const yaml = header + yamlStringify(normalized) + "\n";
+    await writeFileAtomic(abs, yaml);
+}
+function extractBlock(source, tagName) {
+    const match = source.match(new RegExp(`<${tagName}>[\\s\\S]*?<\\/${tagName}>`));
+    return match?.[0] ?? "";
+}
+async function getGitUser(workspaceRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["config", "user.name"], {
+            cwd: workspaceRoot,
+        });
+        return `human:${stdout.trim()}`;
+    }
+    catch {
+        return "human:unknown";
+    }
+}
+function getAuthoredEntries(entries) {
+    return entries.filter((e) => e.authoringStatus === "authored" && e.requiredScaffolding !== "none");
+}
+export async function runCompassAuditPlan(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const authored = getAuthoredEntries(entries);
+    const ledger = await loadLedger(context.workspaceRoot);
+    const threshold = resolveRevisionThreshold(input.flags["threshold"], ledger.revisionThreshold);
+    const ledgerMap = new Map();
+    for (const e of ledger.entries) {
+        ledgerMap.set(e.path, e);
+    }
+    const items = [];
+    for (const entry of authored) {
+        const ledgerEntry = ledgerMap.get(entry.path);
+        const auditedRevision = ledgerEntry?.auditedRevision ?? null;
+        const { revision: currentRevision } = await getRevisionByPath(context.workspaceRoot, entry.path);
+        if (!isAuditDue(currentRevision, auditedRevision, threshold)) {
+            continue;
+        }
+        const absPath = resolve(context.workspaceRoot, entry.path);
+        const source = await readFile(absPath, "utf8");
+        const moduleContract = extractBlock(source, "MODULE_CONTRACT");
+        const changeSummary = extractBlock(source, "CHANGE_SUMMARY");
+        items.push({
+            path: entry.path,
+            currentRevision,
+            auditedRevision,
+            reason: auditedRevision === null ? "never-audited" : "revision-threshold-crossed",
+            moduleContract,
+            changeSummary,
+        });
+    }
+    items.sort((a, b) => a.path.localeCompare(b.path));
+    context.logger.info(`[compass.audit.plan] threshold=${threshold}, due=${items.length}`);
+    return {
+        data: { threshold, dueCount: items.length, items },
+        exitCode: 0,
+        summary: `[compass.audit.plan] ${items.length} files due for audit (threshold=${threshold})`,
+        nextSteps: items.length > 0
+            ? [
+                {
+                    action: `Record an audit: pnpm exec forge run compass.audit.record --file <path> --verdict <verdict> --revision <rev>`,
+                    kind: "optional",
+                },
+            ]
+            : undefined,
+    };
+}
+export async function runCompassAuditRecord(input, context) {
+    const rawFilePath = input.flags["file"];
+    const verdict = input.flags["verdict"];
+    const agentFlag = input.flags["agent"];
+    if (!rawFilePath) {
+        context.logger.error("[compass.audit.record] --file is required");
+        return { exitCode: 1, data: { path: "", action: "recorded" } };
+    }
+    if (!verdict || !["pass", "repaired", "baseline"].includes(verdict)) {
+        context.logger.error("[compass.audit.record] --verdict must be pass|repaired|baseline");
+        return { exitCode: 1, data: { path: rawFilePath, action: "recorded" } };
+    }
+    const filePath = relative(context.workspaceRoot, resolve(process.cwd(), rawFilePath));
+    const { revision, entityId, contentHash } = await getRevisionByPath(context.workspaceRoot, filePath);
+    const agent = agentFlag ?? (await getGitUser(context.workspaceRoot));
+    const ledger = await loadLedger(context.workspaceRoot);
+    const existingIdx = ledger.entries.findIndex((e) => e.path === filePath);
+    const entry = {
+        path: filePath,
+        entityId: entityId ?? "",
+        auditedRevision: revision,
+        auditedHash: contentHash,
+        auditedAt: new Date().toISOString(),
+        verdict,
+        agent,
+    };
+    if (existingIdx >= 0) {
+        ledger.entries[existingIdx] = entry;
+    }
+    else {
+        ledger.entries.push(entry);
+    }
+    if (!context.dryRun) {
+        await saveLedger(context.workspaceRoot, ledger);
+    }
+    context.logger.info(`[compass.audit.record] ${filePath}: verdict=${verdict}, revision=${revision}, agent=${agent}`);
+    return {
+        data: { path: filePath, action: "recorded" },
+        exitCode: 0,
+        summary: `[compass.audit.record] ${filePath}: ${verdict} at revision ${revision}`,
+        nextSteps: [
+            {
+                action: `Validate audits: pnpm exec forge run compass.audit.validate`,
+                kind: "optional",
+            },
+        ],
+    };
+}
+export async function runCompassAuditBaseline(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const authored = getAuthoredEntries(entries);
+    const ledger = await loadLedger(context.workspaceRoot);
+    const existingPaths = new Set(ledger.entries.map((e) => e.path));
+    let seededCount = 0;
+    for (const entry of authored) {
+        if (existingPaths.has(entry.path)) {
+            continue;
+        }
+        const { revision, entityId, contentHash } = await getRevisionByPath(context.workspaceRoot, entry.path);
+        ledger.entries.push({
+            path: entry.path,
+            entityId: entityId ?? "",
+            auditedRevision: revision,
+            auditedHash: contentHash,
+            auditedAt: new Date().toISOString(),
+            verdict: "baseline",
+            agent: "system:baseline",
+        });
+        seededCount++;
+    }
+    ledger.entries.sort((a, b) => a.path.localeCompare(b.path));
+    if (!context.dryRun) {
+        await saveLedger(context.workspaceRoot, ledger);
+    }
+    context.logger.info(`[compass.audit.baseline] seeded=${seededCount}, total=${ledger.entries.length}`);
+    return {
+        data: { seeded: seededCount, total: ledger.entries.length },
+        exitCode: 0,
+        summary: `[compass.audit.baseline] seeded ${seededCount} entries (total: ${ledger.entries.length})`,
+    };
+}
+export async function runCompassAuditValidate(input, context) {
+    const strict = input.flags["strict"] === true;
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const authored = getAuthoredEntries(entries);
+    const ledger = await loadLedger(context.workspaceRoot);
+    const ledgerMap = new Map();
+    for (const e of ledger.entries) {
+        ledgerMap.set(e.path, e);
+    }
+    const diagnostics = [];
+    for (const entry of authored) {
+        const ledgerEntry = ledgerMap.get(entry.path);
+        const auditedRevision = ledgerEntry?.auditedRevision ?? null;
+        const { revision: currentRevision } = await getRevisionByPath(context.workspaceRoot, entry.path);
+        if (!isAuditDue(currentRevision, auditedRevision, ledger.revisionThreshold)) {
+            continue;
+        }
+        const severity = strict ? "error" : "warning";
+        context.logger[strict ? "error" : "warn"](`[compass.audit.validate] COMPASS-AUDIT-01: ${entry.path}: audit overdue (current=${currentRevision}, audited=${auditedRevision ?? "never"}, threshold=${ledger.revisionThreshold})`);
+        diagnostics.push({
+            ruleId: "COMPASS-AUDIT-01",
+            severity,
+            file: entry.path,
+            message: `Compass audit overdue: ${currentRevision - (auditedRevision ?? 0)} revisions since last audit (threshold=${ledger.revisionThreshold})`,
+            fix: "fix: run compass.audit.plan, reconcile the blocks with the code, then compass.audit.record",
+        });
+    }
+    const dueCount = diagnostics.length;
+    const hasErrors = strict && dueCount > 0;
+    return {
+        data: { strict, dueCount, diagnostics },
+        exitCode: hasErrors ? 1 : 0,
+        summary: dueCount > 0 ? undefined : `[compass.audit.validate] OK (0 files overdue)`,
+        nextSteps: dueCount > 0
+            ? [
+                {
+                    action: `Fix the ${dueCount} overdue file(s) above, then re-run: pnpm exec forge run compass.audit.validate`,
+                    kind: "required",
+                },
+            ]
+            : undefined,
+    };
+}
+//# sourceMappingURL=compass-audit-handler.js.map

package/dist/os/compass/handlers/compass-audit-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-audit-handler.js","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-audit-handler.ts"],"names":[],"mappings":"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"}

package/dist/os/compass/handlers/compass-change-summary-handler.d.ts

@@ -0,0 +1,19 @@
+import type { Diagnostic, ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export type ChangeSummaryItemClass = "protected" | "boilerplate" | "unprotected";
+export declare function classifyChangeSummaryItem(text: string): ChangeSummaryItemClass;
+export declare function runCompassChangeSummaryValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: string;
+    status: "pass" | "fail";
+    diagnostics: Diagnostic[];
+    checkedFiles: number;
+}>>;
+export declare function runCompassSummaryTrim(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: string;
+    status: "ok";
+    files: Array<{
+        path: string;
+        removed: string[];
+        kept: number;
+    }>;
+}>>;
+//# sourceMappingURL=compass-change-summary-handler.d.ts.map

package/dist/os/compass/handlers/compass-change-summary-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-change-summary-handler.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-change-summary-handler.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;AAEjF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAI9E;AA0CD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CACH,CA0EA;AAID,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC,CACH,CA4GA"}