@warpgogol/forge 2.1.0 → 2.2.0

package/dist/os/rfc/acceptance.d.ts

@@ -0,0 +1,15 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext, CommandRegistry } from "../../src/types.ts";
+import type { AcceptanceProbe, ProbeResult, RfcAcceptanceRunResult } from "./types.ts";
+export interface AcceptanceShapeIssue {
+    index: number;
+    message: string;
+}
+/**
+ * Pure shape validator for a raw `acceptance:` frontmatter value. Returns an
+ * empty array when the value is absent (acceptance is optional) or well-formed.
+ */
+export declare function validateAcceptanceShape(value: unknown): AcceptanceShapeIssue[];
+/** Executes a single probe. Pure aside from its declared filesystem/process/registry effects. */
+export declare function runProbe(probe: AcceptanceProbe, workspaceRoot: string, commandRegistry?: CommandRegistry): Promise<ProbeResult>;
+export declare function runRfcAcceptanceRun(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcAcceptanceRunResult>>;
+//# sourceMappingURL=acceptance.d.ts.map

package/dist/os/rfc/acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.d.ts","sourceRoot":"","sources":["../../../os/rfc/acceptance.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAkBvF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,EAAE,CA4F9E;AA0CD,iGAAiG;AACjG,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,WAAW,CAAC,CAsDtB;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,CAwFrD"}

package/dist/os/rfc/acceptance.js

@@ -0,0 +1,310 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-0268: makes RFC acceptance criteria machine-checkable. RFCs may declare a
+typed `acceptance:` list of probes in frontmatter; rfc.acceptance.run executes
+them and reports pass/fail per probe, so an implementation claim is
+reproducible by anyone with one command instead of trusting the implementer's
+prose checklist.
+</purpose>
+<non-goals>
+  <item>Do not run automatically inside rfc.validate — probes may run builds; on-demand only.</item>
+  <item>Do not allow arbitrary shell in `run` probes — the command string must start with "werkstatt ".</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0268: initial implementation.</item>
+</CHANGE_SUMMARY>
+*/
+import { spawn } from "node:child_process";
+import { stat, readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as yamlParse } from "yaml";
+import { RFC_DIR } from "./types.js";
+import { listRfcFiles, readAndParseRfc } from "./frontmatter-io.js";
+const RUN_PROBE_ALLOWED_PREFIX = "werkstatt ";
+async function loadManifestCommandNames(workspaceRoot) {
+    const manifestPath = path.join(workspaceRoot, "docs", "command-manifest.generated.yaml");
+    try {
+        const raw = await readFile(manifestPath, "utf-8");
+        const manifest = yamlParse(raw);
+        return new Set((manifest.commands ?? []).map((c) => c.name));
+    }
+    catch {
+        return new Set();
+    }
+}
+const RUN_PROBE_TIMEOUT_MS = 120_000;
+/**
+ * Pure shape validator for a raw `acceptance:` frontmatter value. Returns an
+ * empty array when the value is absent (acceptance is optional) or well-formed.
+ */
+export function validateAcceptanceShape(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        return [{ index: -1, message: "acceptance must be a list of probe objects" }];
+    }
+    const issues = [];
+    value.forEach((entry, index) => {
+        if (!entry || typeof entry !== "object") {
+            issues.push({ index, message: "probe entry must be an object" });
+            return;
+        }
+        const probe = entry["probe"];
+        switch (probe) {
+            case "run": {
+                const command = entry["command"];
+                const expect = entry["expect"];
+                if (typeof command !== "string" || !command.startsWith(RUN_PROBE_ALLOWED_PREFIX)) {
+                    issues.push({
+                        index,
+                        message: `probe "run" command must be a string starting with "${RUN_PROBE_ALLOWED_PREFIX}"`,
+                    });
+                }
+                if (!expect ||
+                    typeof expect !== "object" ||
+                    typeof expect["exitCode"] !== "number") {
+                    issues.push({ index, message: 'probe "run" requires expect: { exitCode: <number> }' });
+                }
+                break;
+            }
+            case "file-exists": {
+                if (typeof entry["path"] !== "string") {
+                    issues.push({ index, message: 'probe "file-exists" requires a string "path"' });
+                }
+                break;
+            }
+            case "file-contains": {
+                const p = entry["path"];
+                const pattern = entry["pattern"];
+                if (typeof p !== "string")
+                    issues.push({ index, message: 'probe "file-contains" requires a string "path"' });
+                if (typeof pattern !== "string") {
+                    issues.push({ index, message: 'probe "file-contains" requires a string "pattern"' });
+                }
+                break;
+            }
+            case "command-registered": {
+                if (typeof entry["name"] !== "string") {
+                    issues.push({ index, message: 'probe "command-registered" requires a string "name"' });
+                }
+                break;
+            }
+            case "page": {
+                const p = entry["path"];
+                if (typeof p !== "string" || !p.startsWith("/")) {
+                    issues.push({
+                        index,
+                        message: 'probe "page" requires a string "path" starting with "/"',
+                    });
+                }
+                const expectStatus = entry["expectStatus"];
+                if (expectStatus !== undefined && typeof expectStatus !== "number") {
+                    issues.push({ index, message: 'probe "page" expectStatus must be a number if present' });
+                }
+                const selector = entry["selector"];
+                if (selector !== undefined && typeof selector !== "string") {
+                    issues.push({ index, message: 'probe "page" selector must be a string if present' });
+                }
+                const textPattern = entry["textPattern"];
+                if (textPattern !== undefined && typeof textPattern !== "string") {
+                    issues.push({ index, message: 'probe "page" textPattern must be a string if present' });
+                }
+                const allowConsoleErrors = entry["allowConsoleErrors"];
+                if (allowConsoleErrors !== undefined && typeof allowConsoleErrors !== "boolean") {
+                    issues.push({
+                        index,
+                        message: 'probe "page" allowConsoleErrors must be a boolean if present',
+                    });
+                }
+                break;
+            }
+            default:
+                issues.push({
+                    index,
+                    message: `unknown probe kind "${String(probe)}" — expected one of: run, file-exists, file-contains, command-registered, page`,
+                });
+        }
+    });
+    return issues;
+}
+async function spawnSiteKernel(workspaceRoot, commandLine) {
+    const args = commandLine
+        .slice(RUN_PROBE_ALLOWED_PREFIX.length)
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    const binPath = path.join(workspaceRoot, "packages", "werkstatt", "bin", "werkstatt.mjs");
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, [binPath, ...args], {
+            cwd: workspaceRoot,
+            stdio: "ignore",
+        });
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill();
+            resolve({ exitCode: null, timedOut: true });
+        }, RUN_PROBE_TIMEOUT_MS);
+        timer.unref?.();
+        child.on("close", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ exitCode: code, timedOut: false });
+        });
+        child.on("error", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ exitCode: null, timedOut: false });
+        });
+    });
+}
+/** Executes a single probe. Pure aside from its declared filesystem/process/registry effects. */
+export async function runProbe(probe, workspaceRoot, commandRegistry) {
+    switch (probe.probe) {
+        case "run": {
+            if (!probe.command.startsWith(RUN_PROBE_ALLOWED_PREFIX)) {
+                return {
+                    probe,
+                    ok: false,
+                    detail: `rejected: command must start with "${RUN_PROBE_ALLOWED_PREFIX}"`,
+                };
+            }
+            const { exitCode, timedOut } = await spawnSiteKernel(workspaceRoot, probe.command);
+            if (timedOut) {
+                return { probe, ok: false, detail: `timed out after ${RUN_PROBE_TIMEOUT_MS}ms` };
+            }
+            const ok = exitCode === probe.expect.exitCode;
+            return { probe, ok, detail: `exitCode=${exitCode} (expected ${probe.expect.exitCode})` };
+        }
+        case "file-exists": {
+            try {
+                await stat(path.join(workspaceRoot, probe.path));
+                return { probe, ok: true, detail: "exists" };
+            }
+            catch {
+                return { probe, ok: false, detail: "does not exist" };
+            }
+        }
+        case "file-contains": {
+            try {
+                const content = await readFile(path.join(workspaceRoot, probe.path), "utf8");
+                const re = new RegExp(probe.pattern, "m");
+                const ok = re.test(content);
+                return { probe, ok, detail: ok ? "pattern found" : "pattern not found" };
+            }
+            catch {
+                return { probe, ok: false, detail: "file could not be read" };
+            }
+        }
+        case "command-registered": {
+            const registryNames = new Set((commandRegistry?.listCommands() ?? []).map((c) => c.name));
+            if (!registryNames.has(probe.name)) {
+                const manifestNames = await loadManifestCommandNames(workspaceRoot);
+                for (const name of manifestNames) {
+                    registryNames.add(name);
+                }
+            }
+            const ok = registryNames.has(probe.name);
+            return { probe, ok, detail: ok ? "registered" : "not registered" };
+        }
+        case "page": {
+            return {
+                probe,
+                ok: true,
+                detail: "page probe skipped — run qa.independent.run against a built dist",
+            };
+        }
+    }
+}
+export async function runRfcAcceptanceRun(input, context) {
+    const { workspaceRoot } = context;
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const targetId = input.flags["id"];
+    const targetStatus = input.flags["status"];
+    if (!targetId && !targetStatus) {
+        return {
+            data: { command: "rfc.acceptance.run", status: "pass", diagnostics: [], results: [] },
+            exitCode: 0,
+            summary: "rfc.acceptance.run: pass --id <rfc-id> or --status <status> to select target RFC(s)",
+        };
+    }
+    const allFiles = await listRfcFiles(rfcDirPath);
+    const results = [];
+    const diagnostics = [];
+    for (const fileName of allFiles) {
+        const parsedFile = await readAndParseRfc(rfcDirPath, fileName);
+        if (!parsedFile)
+            continue;
+        if ("error" in parsedFile)
+            continue;
+        const fm = parsedFile.parsed.frontmatter;
+        const rfcId = String(fm["id"] ?? "");
+        if (targetId && rfcId.toLowerCase() !== targetId.toLowerCase())
+            continue;
+        if (targetStatus && String(fm["status"] ?? "") !== targetStatus)
+            continue;
+        const acceptance = fm["acceptance"];
+        const relFile = path.join(RFC_DIR, fileName);
+        const status = String(fm["status"] ?? "");
+        if (!Array.isArray(acceptance) || acceptance.length === 0) {
+            if (status === "accepted" || status === "implemented") {
+                diagnostics.push({
+                    ruleId: "RFC-ACC-02",
+                    severity: "info",
+                    file: relFile,
+                    message: `${rfcId} (${status}) declares no acceptance probes.`,
+                });
+            }
+            results.push({ rfcId, probeResults: [] });
+            continue;
+        }
+        const probeResults = [];
+        let pageProbeCount = 0;
+        for (const raw of acceptance) {
+            if (raw.probe === "page") {
+                pageProbeCount++;
+                probeResults.push({
+                    probe: raw,
+                    ok: true,
+                    detail: "page probe skipped — run qa.independent.run against a built dist",
+                });
+                continue;
+            }
+            const result = await runProbe(raw, workspaceRoot, context.commandRegistry);
+            probeResults.push(result);
+            if (!result.ok) {
+                diagnostics.push({
+                    ruleId: "RFC-ACC-01",
+                    severity: "error",
+                    file: relFile,
+                    message: `${rfcId}: probe "${raw.probe}" failed — ${result.detail}.`,
+                });
+            }
+        }
+        if (pageProbeCount > 0) {
+            diagnostics.push({
+                ruleId: "RFC-ACC-03",
+                severity: "info",
+                file: relFile,
+                message: `${pageProbeCount} page probe(s) skipped — run \`qa.independent.run --site <app>\` against a built dist.`,
+            });
+        }
+        results.push({ rfcId, probeResults });
+    }
+    const failedCount = diagnostics.filter((d) => d.severity === "error").length;
+    const status = failedCount > 0 ? "fail" : "pass";
+    return {
+        data: { command: "rfc.acceptance.run", status, diagnostics, results },
+        exitCode: failedCount > 0 ? 1 : 0,
+        summary: `rfc.acceptance.run: ${results.length} RFC(s), ${failedCount} failed probe(s)`,
+    };
+}
+//# sourceMappingURL=acceptance.js.map

package/dist/os/rfc/acceptance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.js","sourceRoot":"","sources":["../../../os/rfc/acceptance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;EAiBE;AAEF,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAS1C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAE9C,KAAK,UAAU,wBAAwB,CAAC,aAAqB;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,iCAAiC,CAAC,CAAC;IACzF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAA2C,CAAC;QAC1E,OAAO,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AACD,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAOrC;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAI,KAAiC,CAAC,OAAO,CAAC,CAAC;QAC1D,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,OAAO,GAAI,KAAiC,CAAC,SAAS,CAAC,CAAC;gBAC9D,MAAM,MAAM,GAAI,KAAiC,CAAC,QAAQ,CAAC,CAAC;gBAC5D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,CAAC;oBACjF,MAAM,CAAC,IAAI,CAAC;wBACV,KAAK;wBACL,OAAO,EAAE,uDAAuD,wBAAwB,GAAG;qBAC5F,CAAC,CAAC;gBACL,CAAC;gBACD,IACE,CAAC,MAAM;oBACP,OAAO,MAAM,KAAK,QAAQ;oBAC1B,OAAQ,MAAkC,CAAC,UAAU,CAAC,KAAK,QAAQ,EACnE,CAAC;oBACD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC,CAAC;gBACzF,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,IAAI,OAAQ,KAAiC,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACnE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC,CAAC;gBAClF,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,CAAC,GAAI,KAAiC,CAAC,MAAM,CAAC,CAAC;gBACrD,MAAM,OAAO,GAAI,KAAiC,CAAC,SAAS,CAAC,CAAC;gBAC9D,IAAI,OAAO,CAAC,KAAK,QAAQ;oBACvB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC,CAAC;gBACpF,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC,CAAC;gBACvF,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,IAAI,OAAQ,KAAiC,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACnE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC,CAAC;gBACzF,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,GAAI,KAAiC,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChD,MAAM,CAAC,IAAI,CAAC;wBACV,KAAK;wBACL,OAAO,EAAE,yDAAyD;qBACnE,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,YAAY,GAAI,KAAiC,CAAC,cAAc,CAAC,CAAC;gBACxE,IAAI,YAAY,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;oBACnE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAAC;gBAC3F,CAAC;gBACD,MAAM,QAAQ,GAAI,KAAiC,CAAC,UAAU,CAAC,CAAC;gBAChE,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAC3D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC,CAAC;gBACvF,CAAC;gBACD,MAAM,WAAW,GAAI,KAAiC,CAAC,aAAa,CAAC,CAAC;gBACtE,IAAI,WAAW,KAAK,SAAS,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;oBACjE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,sDAAsD,EAAE,CAAC,CAAC;gBAC1F,CAAC;gBACD,MAAM,kBAAkB,GAAI,KAAiC,CAAC,oBAAoB,CAAC,CAAC;gBACpF,IAAI,kBAAkB,KAAK,SAAS,IAAI,OAAO,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBAChF,MAAM,CAAC,IAAI,CAAC;wBACV,KAAK;wBACL,OAAO,EAAE,8DAA8D;qBACxE,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;YACD;gBACE,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK;oBACL,OAAO,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,gFAAgF;iBAC9H,CAAC,CAAC;QACP,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,aAAqB,EACrB,WAAmB;IAEnB,MAAM,IAAI,GAAG,WAAW;SACrB,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC;SACtC,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;IAE1F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE;YACxD,GAAG,EAAE,aAAa;YAClB,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC,EAAE,oBAAoB,CAAC,CAAC;QACzB,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAEhB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAsB,EACtB,aAAqB,EACrB,eAAiC;IAEjC,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,CAAC;gBACxD,OAAO;oBACL,KAAK;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,sCAAsC,wBAAwB,GAAG;iBAC1E,CAAC;YACJ,CAAC;YACD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACnF,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,oBAAoB,IAAI,EAAE,CAAC;YACnF,CAAC;YACD,MAAM,EAAE,GAAG,QAAQ,KAAK,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,QAAQ,cAAc,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;QAC3F,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;YACxD,CAAC;QACH,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC7E,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC1C,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;YAChE,CAAC;QACH,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1F,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,aAAa,GAAG,MAAM,wBAAwB,CAAC,aAAa,CAAC,CAAC;gBACpE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;oBACjC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACrE,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,OAAO;gBACL,KAAK;gBACL,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,kEAAkE;aAC3E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAwB,EACxB,OAA4B;IAE5B,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;IACzD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAuB,CAAC;IAEjE,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACrF,QAAQ,EAAE,CAAC;YACX,OAAO,EACL,qFAAqF;SACxF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,OAAO,GAAsC,EAAE,CAAC;IACtD,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,IAAI,OAAO,IAAI,UAAU;YAAE,SAAS;QACpC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAErC,IAAI,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE;YAAE,SAAS;QACzE,IAAI,YAAY,IAAI,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,YAAY;YAAE,SAAS;QAE1E,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;gBACtD,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,YAAY;oBACpB,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,GAAG,KAAK,KAAK,MAAM,kCAAkC;iBAC/D,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAkB,EAAE,CAAC;QACvC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,UAA+B,EAAE,CAAC;YAClD,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBACzB,cAAc,EAAE,CAAC;gBACjB,YAAY,CAAC,IAAI,CAAC;oBAChB,KAAK,EAAE,GAAG;oBACV,EAAE,EAAE,IAAI;oBACR,MAAM,EAAE,kEAAkE;iBAC3E,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;YAC3E,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,YAAY;oBACpB,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,GAAG,KAAK,YAAY,GAAG,CAAC,KAAK,cAAc,MAAM,CAAC,MAAM,GAAG;iBACrE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YACvB,WAAW,CAAC,IAAI,CAAC;gBACf,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,GAAG,cAAc,wFAAwF;aACnH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,MAAM,GAAqC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAEnF,OAAO;QACL,IAAI,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE;QACrE,QAAQ,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,EAAE,uBAAuB,OAAO,CAAC,MAAM,YAAY,WAAW,kBAAkB;KACxF,CAAC;AACJ,CAAC"}

package/dist/os/rfc/decision-log.d.ts

@@ -0,0 +1,6 @@
+import type { DecisionLogEntry, DecisionLogResult, ConsultedDecision } from "./types.ts";
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+export declare function collectDecisionLog(rfcDirPath: string): Promise<DecisionLogEntry[]>;
+export declare function scoreDecisions(title: string, entries: DecisionLogEntry[], limit?: number): ConsultedDecision[];
+export declare function runRfcDecisionLogGenerate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<DecisionLogResult>>;
+//# sourceMappingURL=decision-log.d.ts.map

package/dist/os/rfc/decision-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-log.d.ts","sourceRoot":"","sources":["../../../os/rfc/decision-log.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AA4B5B,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA2DxF;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,EAAE,EAC3B,KAAK,SAAI,GACR,iBAAiB,EAAE,CAgCrB;AA6CD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAmGhD"}

package/dist/os/rfc/decision-log.js

@@ -0,0 +1,269 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-0329: collect decision log entries from all RFCs, score against
+keywords for rfc.create consultation, and generate/validate projections.
+</purpose>
+<non-goals>
+  <item>Do not use LLM/embeddings for matching — keyword scoring only.</item>
+  <item>Do not block rfc.create when matches are found — consultation is informative.</item>
+  <item>Do not wire generation into build pipelines — on-demand only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0329: initial implementation.</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { writeFileAtomic } from "../../src/utils/fs-atomic.js";
+import { buildGeneratedHeader } from "../../src/utils/generated-marker.js";
+import { stringify as yamlStringify } from "yaml";
+import { listRfcFiles, readAndParseRfc } from "./frontmatter-io.js";
+import { RFC_DIR } from "./types.js";
+const STOPWORDS = new Set(["the", "and", "for", "add", "into", "with", "from", "that"]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length >= 3 && !STOPWORDS.has(t));
+}
+function extractSection(body, heading) {
+    const re = new RegExp(`^##\\s+${heading}\\s*$`, "im");
+    const match = re.exec(body);
+    if (!match)
+        return null;
+    const start = match.index + match[0].length;
+    const nextHeading = body.indexOf("\n## ", start);
+    const sectionText = nextHeading === -1 ? body.slice(start).trim() : body.slice(start, nextHeading).trim();
+    return sectionText || null;
+}
+function firstParagraph(text) {
+    const trimmed = text.trim();
+    const firstBreak = trimmed.indexOf("\n\n");
+    return firstBreak === -1 ? trimmed : trimmed.slice(0, firstBreak).trim();
+}
+export async function collectDecisionLog(rfcDirPath) {
+    const files = await listRfcFiles(rfcDirPath);
+    const entries = [];
+    for (const fileName of files) {
+        const result = await readAndParseRfc(rfcDirPath, fileName);
+        if (!result || "error" in result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const body = result.parsed.body;
+        const rfcId = String(fm["id"] ?? "");
+        const title = String(fm["title"] ?? "");
+        const status = String(fm["status"] ?? "");
+        const file = join(RFC_DIR, fileName);
+        if (status === "rejected") {
+            const decisionSection = extractSection(body, "Decision");
+            entries.push({
+                kind: "rejected-rfc",
+                rfcId,
+                title,
+                status,
+                closedAt: String(fm["closedAt"] ?? "") || undefined,
+                decisionSummary: decisionSection ? firstParagraph(decisionSection) : undefined,
+                alternativesText: extractSection(body, "Alternatives considered") ?? undefined,
+                file,
+            });
+        }
+        else if (status === "superseded") {
+            const decisionSection = extractSection(body, "Decision");
+            const supersededBy = fm["supersededBy"];
+            entries.push({
+                kind: "superseded-rfc",
+                rfcId,
+                title,
+                status,
+                closedAt: String(fm["closedAt"] ?? "") || undefined,
+                supersededBy: Array.isArray(supersededBy) && supersededBy.length > 0
+                    ? String(supersededBy[0])
+                    : undefined,
+                decisionSummary: decisionSection ? firstParagraph(decisionSection) : undefined,
+                file,
+            });
+        }
+        const alternativesText = extractSection(body, "Alternatives considered");
+        if (alternativesText) {
+            entries.push({
+                kind: "rejected-alternative",
+                rfcId,
+                title,
+                status,
+                alternativesText,
+                file,
+            });
+        }
+    }
+    entries.sort((a, b) => a.rfcId.localeCompare(b.rfcId));
+    return entries;
+}
+export function scoreDecisions(title, entries, limit = 5) {
+    const titleTokens = tokenize(title);
+    if (titleTokens.length === 0)
+        return [];
+    const scored = [];
+    for (const entry of entries) {
+        const entryTitleTokens = tokenize(entry.title);
+        const entryTextTokens = new Set([
+            ...entryTitleTokens,
+            ...tokenize(entry.decisionSummary ?? ""),
+            ...tokenize(entry.alternativesText ?? ""),
+        ]);
+        let score = 0;
+        for (const token of titleTokens) {
+            if (entryTitleTokens.includes(token))
+                score += 3;
+            if (entryTextTokens.has(token))
+                score += 1;
+        }
+        if (score > 0) {
+            scored.push({
+                rfcId: entry.rfcId,
+                kind: entry.kind,
+                title: entry.title,
+                score,
+                file: entry.file,
+            });
+        }
+    }
+    scored.sort((a, b) => b.score - a.score || a.rfcId.localeCompare(b.rfcId));
+    return scored.slice(0, limit);
+}
+function renderMarkdown(entries) {
+    const lines = [
+        buildGeneratedHeader({
+            ownerCommand: "rfc.decision-log.generate",
+            filePath: "docs/rfcs/decision-log.generated.md",
+        }).trimEnd(),
+        "",
+    ];
+    const groups = {
+        "rejected-rfc": [],
+        "superseded-rfc": [],
+        "rejected-alternative": [],
+    };
+    for (const e of entries)
+        groups[e.kind].push(e);
+    lines.push("# RFC Decision Log", "");
+    lines.push(`> Generated projection of all rejected/superseded RFCs and rejected alternatives.`);
+    lines.push(`> Do not edit — run \`site-kernel run rfc.decision-log.generate\` to regenerate.`, "");
+    for (const kind of Object.keys(groups)) {
+        const groupEntries = groups[kind];
+        if (groupEntries.length === 0)
+            continue;
+        lines.push(`## ${kind} (${groupEntries.length})`, "");
+        for (const e of groupEntries) {
+            lines.push(`### ${e.rfcId}: ${e.title}`, "");
+            lines.push(`- **Status:** ${e.status}`);
+            if (e.closedAt)
+                lines.push(`- **Closed:** ${e.closedAt}`);
+            if (e.supersededBy)
+                lines.push(`- **Superseded by:** ${e.supersededBy}`);
+            if (e.decisionSummary)
+                lines.push(`- **Decision:** ${e.decisionSummary}`);
+            if (e.alternativesText) {
+                lines.push("- **Alternatives considered:**", "");
+                lines.push(e.alternativesText);
+            }
+            lines.push("");
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+export async function runRfcDecisionLogGenerate(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const checkMode = Boolean(input.flags["check"]);
+    const rfcDirPath = join(workspaceRoot, RFC_DIR);
+    const entries = await collectDecisionLog(rfcDirPath);
+    const jsonRelPath = join(RFC_DIR, "decision-log.generated.yaml");
+    const mdRelPath = join(RFC_DIR, "decision-log.generated.md");
+    if (checkMode) {
+        const diagnostics = [];
+        let drift = false;
+        try {
+            const existingJson = await readFile(join(workspaceRoot, jsonRelPath), "utf-8");
+            const expectedJson = `${buildGeneratedHeader({ filePath: jsonRelPath, ownerCommand: "rfc.decision-log.generate" })}${yamlStringify({ command: "rfc.decision-log.generate", status: "ok", count: entries.length, entries })}\n`;
+            if (existingJson !== expectedJson) {
+                drift = true;
+                diagnostics.push({
+                    ruleId: "DECISION-LOG-DRIFT",
+                    severity: "error",
+                    file: jsonRelPath,
+                    message: "JSON projection drifts from recomputed content.",
+                });
+            }
+        }
+        catch {
+            drift = true;
+            diagnostics.push({
+                ruleId: "DECISION-LOG-MISSING",
+                severity: "error",
+                file: jsonRelPath,
+                message: `${jsonRelPath} does not exist — run without --check first.`,
+            });
+        }
+        try {
+            const existingMd = await readFile(join(workspaceRoot, mdRelPath), "utf-8");
+            const expectedMd = renderMarkdown(entries);
+            if (existingMd !== expectedMd) {
+                drift = true;
+                diagnostics.push({
+                    ruleId: "DECISION-LOG-DRIFT",
+                    severity: "error",
+                    file: mdRelPath,
+                    message: "Markdown projection drifts from recomputed content.",
+                });
+            }
+        }
+        catch {
+            drift = true;
+            diagnostics.push({
+                ruleId: "DECISION-LOG-MISSING",
+                severity: "error",
+                file: mdRelPath,
+                message: `${mdRelPath} does not exist — run without --check first.`,
+            });
+        }
+        if (outputFormat === "pretty") {
+            if (drift) {
+                for (const d of diagnostics)
+                    logger.error(`[${d.ruleId}] ${d.message}`);
+            }
+            else {
+                logger.success("Decision log projections are up to date.");
+            }
+        }
+        return {
+            data: {
+                command: "rfc.decision-log.generate",
+                status: drift ? "drift" : "ok",
+                count: entries.length,
+                entries,
+            },
+            exitCode: drift ? 1 : 0,
+            summary: `rfc.decision-log.generate --check: ${drift ? "drift detected" : "up to date"} (${entries.length} entries)`,
+        };
+    }
+    const jsonContent = `${buildGeneratedHeader({ filePath: jsonRelPath, ownerCommand: "rfc.decision-log.generate" })}${yamlStringify({ command: "rfc.decision-log.generate", status: "ok", count: entries.length, entries })}\n`;
+    const mdContent = renderMarkdown(entries);
+    await writeFileAtomic(join(workspaceRoot, jsonRelPath), jsonContent);
+    await writeFileAtomic(join(workspaceRoot, mdRelPath), mdContent);
+    if (outputFormat === "pretty") {
+        logger.success(`Wrote ${jsonRelPath} and ${mdRelPath} (${entries.length} entries)`);
+    }
+    return {
+        data: {
+            command: "rfc.decision-log.generate",
+            status: "ok",
+            count: entries.length,
+            entries,
+            written: [jsonRelPath, mdRelPath],
+        },
+        exitCode: 0,
+        summary: `rfc.decision-log.generate: wrote ${entries.length} entries to JSON + Markdown`,
+    };
+}
+//# sourceMappingURL=decision-log.js.map

package/dist/os/rfc/decision-log.js.map

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