@warpgogol/forge 2.1.0 → 2.2.0

package/dist/os/adr/handlers/list-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-create.js","sourceRoot":"","sources":["../../../../os/adr/handlers/list-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAarE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnF,SAAS,SAAS,CAAC,CAAO;IACxB,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAwB,EACxB,OAA4B;IAE5B,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAuB,CAAC;IACjE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;IAC/D,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAuB,CAAC;IAEnE,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;QACrC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAc,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAa,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QAE5C,IAAI,YAAY,IAAI,MAAM,KAAK,YAAY;YAAE,SAAS;QACtD,IAAI,WAAW,IAAI,KAAK,KAAK,WAAW;YAAE,SAAS;QACnD,IAAI,aAAa,IAAI,OAAO,KAAK,aAAa;YAAE,SAAS;QAEzD,OAAO,CAAC,IAAI,CAAC;YACX,EAAE;YACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM;YACN,KAAK;YACL,OAAO;YACP,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,SAAS,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CACT,GAAG,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAC/G,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,UAAU;YACnB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,OAAO;SACR;QACD,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,eAAe;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB,EACxB,OAA4B;IAE5B,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAwB,IAAI,SAAS,CAAC;IACxE,MAAM,OAAO,GAAI,KAAK,CAAC,KAAK,CAAC,SAAS,CAAwB,IAAI,cAAc,CAAC;IACjF,MAAM,MAAM,GAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAwB,IAAI,UAAU,CAAC;IAC3E,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAuB,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAiB,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAmB,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,qBAAqB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC7C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,GAAG,GAAG,KAAK;gBAAE,KAAK,GAAG,GAAG,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,SAAS,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,SAAS,EAAE,CAAC;IAElC,MAAM,eAAe,GAAG,iBAAiB,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAC/D,IAAI,eAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,6BAA6B,eAAe,4CAA4C,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,UAAU,KAAK,CAAC;IAEhD,IAAI,OAAO,GAAG,eAAe,CAAC;IAC9B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,MAAM,EAAE,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,WAAW,YAAY,GAAG,CAAC,CAAC;IACxE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC;IACjE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;IAC9D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,YAAY,OAAO,EAAE,CAAC,CAAC;IACpE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,0BAA0B,EAAE,cAAc,KAAK,EAAE,CAAC,CAAC;IAC7E,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,0BAA0B,EAAE,cAAc,KAAK,EAAE,CAAC,CAAC;IAC7E,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,MAAM,KAAK,KAAK,EAAE,CAAC,CAAC;IAExE,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,UAAU;aACP,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,OAAO,CAAC,OAAO,CACvB,kCAAkC,EAClC,aAAa,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kCAAkC,EAAE,aAAa,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAEjD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAElD,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,WAAW,MAAM,KAAK,KAAK,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,WAAW,MAAM,6CAA6C,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,YAAY;YAClB,EAAE,EAAE,MAAM;SACX;QACD,OAAO,EAAE,WAAW,MAAM,KAAK,KAAK,EAAE;KACvC,CAAC;AACJ,CAAC"}

package/dist/os/adr/handlers/validate.d.ts

@@ -0,0 +1,4 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+import type { AdrValidationResult } from "../types.ts";
+export declare function runAdrValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<AdrValidationResult>>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/os/adr/handlers/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../os/adr/handlers/validate.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAA0B,mBAAmB,EAAuB,MAAM,aAAa,CAAC;AAuBpG,wBAAsB,cAAc,CAClC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAsGlD"}

package/dist/os/adr/handlers/validate.js

@@ -0,0 +1,265 @@
+/*
+<MODULE_CONTRACT>
+<purpose>ADR validation handler — frontmatter, section, referential integrity checks, implementation commit drift detection (AV-16), and directory structure convention (ADR-DIR-01).</purpose>
+<non-goals>
+  <item>Do not introduce app-specific runtime composition or deployment behavior.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0366: implement fail-hard ADR validation for the new adrModule.</item>
+  <item>Post-refactor hardening: allow ADRs to be superseded by existing RFC decisions.</item>
+  <item>RFC-0521: migrated from packages/os/site-kernel/src/adr/ to packages/forge/os/adr/.</item>
+  <item>RFC-0722: add ADR-DIR-01 directory structure warning rule for unsanctioned subdirectories.</item>
+</CHANGE_SUMMARY>
+*/
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { listAdrFiles, readAndParseAdr, adrFileMatchesId, } from "../frontmatter-io.js";
+import { listRfcFiles, readAndParseRfc } from "../../rfc/frontmatter-io.js";
+import { ADR_DIR, ADR_ID_PATTERN, ADR_KNOWN_KEYS, ADR_REQUIRED_SECTIONS, ADR_SCOPES, ADR_STATUSES, } from "../types.js";
+import { RFC_DIR } from "../../rfc/types.js";
+async function loadRfcIds(workspaceRoot) {
+    const rfcIds = new Set();
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const files = await listRfcFiles(rfcDirPath);
+    for (const fileName of files) {
+        const result = await readAndParseRfc(rfcDirPath, fileName);
+        const id = result && "parsed" in result ? String(result.parsed.frontmatter["id"] ?? "") : "";
+        if (id)
+            rfcIds.add(id);
+    }
+    return rfcIds;
+}
+export async function runAdrValidate(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const adrDirPath = path.join(workspaceRoot, ADR_DIR);
+    const targetId = input.flags["id"];
+    const allFiles = await listAdrFiles(adrDirPath);
+    const filesToValidate = targetId
+        ? allFiles.filter((f) => adrFileMatchesId(f, targetId))
+        : allFiles;
+    if (filesToValidate.length === 0) {
+        if (targetId) {
+            throw new Error(`No ADR file found for id ${targetId} in ${ADR_DIR}/`);
+        }
+        if (outputFormat === "pretty") {
+            logger.info("No ADR files found to validate.");
+        }
+        return {
+            data: { command: "adr.validate", status: "pass", count: 0, violations: [] },
+            summary: "No ADR files found to validate",
+        };
+    }
+    const allParsed = new Map();
+    const allParsedByFile = new Map();
+    for (const f of allFiles) {
+        const result = await readAndParseAdr(adrDirPath, f);
+        if (result) {
+            const id = String(result.parsed.frontmatter["id"] ?? "");
+            allParsed.set(id, result);
+            allParsedByFile.set(f, result);
+        }
+    }
+    const knownKeys = new Set(ADR_KNOWN_KEYS);
+    const knownRfcIds = await loadRfcIds(workspaceRoot);
+    const violations = [];
+    const seenIds = new Map();
+    function addViolation(adrId, file, rule, message, severity = "error") {
+        violations.push({ adrId, file, rule, message, severity });
+    }
+    for (const fileName of filesToValidate) {
+        const result = allParsedByFile.get(fileName);
+        if (!result)
+            continue;
+        await validateSingleAdr(fileName, result.parsed, allParsed, knownRfcIds, seenIds, knownKeys, workspaceRoot, addViolation);
+    }
+    const hasErrors = violations.some((v) => v.severity === "error");
+    const resultStatus = hasErrors ? "fail" : "pass";
+    if (outputFormat === "pretty") {
+        if (violations.length === 0) {
+            logger.success(`All ${filesToValidate.length} ADR(s) passed validation.`);
+        }
+        else {
+            logger.section(`ADR Validation (${filesToValidate.length} file(s))`);
+            for (const v of violations) {
+                const prefix = v.severity === "error" ? "ERROR" : "WARN";
+                logger[v.severity === "error" ? "error" : "warn"](`[${prefix}] ${v.adrId} ${v.rule}: ${v.message}`);
+            }
+            const errorCount = violations.filter((v) => v.severity === "error").length;
+            const warnCount = violations.filter((v) => v.severity === "warning").length;
+            if (errorCount > 0) {
+                logger.error(`${errorCount} error(s), ${warnCount} warning(s)`);
+            }
+            else {
+                logger.warn(`${warnCount} warning(s), 0 errors — passed`);
+            }
+        }
+    }
+    return {
+        data: {
+            command: "adr.validate",
+            status: resultStatus,
+            count: filesToValidate.length,
+            violations,
+        },
+        exitCode: hasErrors ? 1 : 0,
+        summary: hasErrors
+            ? `${violations.filter((v) => v.severity === "error").length} error(s) found`
+            : `All ${filesToValidate.length} ADR(s) passed validation`,
+    };
+}
+async function validateSingleAdr(fileName, parsed, allParsed, knownRfcIds, seenIds, knownKeys, workspaceRoot, addViolation) {
+    const fm = parsed.frontmatter;
+    const body = parsed.body;
+    const relFile = path.join(ADR_DIR, fileName);
+    const adrId = String(fm["id"] ?? "UNKNOWN");
+    if (!ADR_ID_PATTERN.test(adrId)) {
+        addViolation(adrId, relFile, "AV-01", `id "${adrId}" does not match format ADR-XXXX`);
+    }
+    // ADR-DIR-01: directory structure convention (RFC-0722)
+    // Warn when ADR files are found in subdirectories other than archive/
+    const slashIdx = fileName.indexOf("/");
+    if (slashIdx > 0) {
+        const subDir = fileName.slice(0, slashIdx);
+        if (subDir !== "archive") {
+            addViolation(adrId, relFile, "ADR-DIR-01", `${relFile} is in an unsanctioned subdirectory. Only archive/ is allowed. Move the file to docs/adrs/ root or write an ADR to formalize the subdirectory.`, "warning");
+        }
+    }
+    const prevFile = seenIds.get(adrId);
+    if (prevFile) {
+        addViolation(adrId, relFile, "AV-02", `Duplicate id "${adrId}" — also in ${prevFile}`);
+    }
+    else {
+        seenIds.set(adrId, relFile);
+    }
+    const status = String(fm["status"] ?? "");
+    if (!ADR_STATUSES.includes(status)) {
+        addViolation(adrId, relFile, "AV-03", `Invalid status "${status}". Must be one of: ${ADR_STATUSES.join(", ")}`);
+    }
+    const scope = String(fm["scope"] ?? "");
+    if (!ADR_SCOPES.includes(scope)) {
+        addViolation(adrId, relFile, "AV-04", `Invalid scope "${scope}". Must be one of: ${ADR_SCOPES.join(", ")}`);
+    }
+    const decider = String(fm["decider"] ?? "");
+    if (!decider) {
+        addViolation(adrId, relFile, "AV-05", "decider must be a non-empty string");
+    }
+    const createdAt = String(fm["createdAt"] ?? "");
+    const updatedAt = String(fm["updatedAt"] ?? "");
+    const datePattern = /^\d{4}-\d{2}-\d{2}$/;
+    if (!datePattern.test(createdAt)) {
+        addViolation(adrId, relFile, "AV-06", `createdAt "${createdAt}" is not a valid ISO 8601 date (YYYY-MM-DD)`);
+    }
+    if (!datePattern.test(updatedAt)) {
+        addViolation(adrId, relFile, "AV-06", `updatedAt "${updatedAt}" is not a valid ISO 8601 date (YYYY-MM-DD)`);
+    }
+    const supersedes = fm["supersedes"];
+    if (Array.isArray(supersedes)) {
+        for (const ref of supersedes) {
+            const refStr = String(ref);
+            if (!refStr)
+                continue;
+            if (!allParsed.has(refStr)) {
+                addViolation(adrId, relFile, "AV-07", `supersedes "${refStr}" does not match any existing ADR`);
+            }
+            else {
+                const otherBy = String(allParsed.get(refStr).parsed.frontmatter["supersededBy"] ?? "");
+                if (otherBy !== adrId) {
+                    addViolation(adrId, relFile, "AV-08", `${adrId}.supersedes includes ${refStr}, but ${refStr}.supersededBy is "${otherBy || "(empty)"}" (expected ${adrId})`, "warning");
+                }
+            }
+        }
+    }
+    const supersededByRaw = fm["supersededBy"];
+    const supersededByList = Array.isArray(supersededByRaw)
+        ? supersededByRaw.map((s) => String(s))
+        : supersededByRaw
+            ? [String(supersededByRaw)]
+            : [];
+    for (const supersededBy of supersededByList) {
+        if (/^ADR-\d{4}$/.test(supersededBy) && !allParsed.has(supersededBy)) {
+            addViolation(adrId, relFile, "AV-09", `supersededBy "${supersededBy}" does not match any existing ADR`);
+        }
+        else if (/^RFC-\d{4}$/.test(supersededBy) && !knownRfcIds.has(supersededBy)) {
+            addViolation(adrId, relFile, "AV-09", `supersededBy "${supersededBy}" does not match any existing RFC`);
+        }
+        else if (!/^(ADR|RFC)-\d{4}$/.test(supersededBy)) {
+            addViolation(adrId, relFile, "AV-09", `supersededBy "${supersededBy}" is not a recognized ADR/RFC id`);
+        }
+    }
+    const supersededBy = supersededByList[0];
+    if (status === "superseded" && !supersededBy) {
+        addViolation(adrId, relFile, "AV-10", `status is "superseded" but supersededBy is empty`);
+    }
+    const related = fm["related"];
+    if (Array.isArray(related)) {
+        for (const ref of related) {
+            const refStr = String(ref).trim();
+            if (!refStr)
+                continue;
+            if (/^ADR-\d{4}$/.test(refStr)) {
+                if (!allParsed.has(refStr)) {
+                    addViolation(adrId, relFile, "AV-11", `related "${refStr}" does not match any existing ADR`, "warning");
+                }
+            }
+            else if (!/^(RFC|DNA|AP)-\d+$/.test(refStr)) {
+                addViolation(adrId, relFile, "AV-11", `related "${refStr}" is not a recognized RFC/ADR/DNA/AP reference`, "warning");
+            }
+        }
+    }
+    const headings = [...body.matchAll(/^##\s+(.+)$/gm)].map((m) => m[1].trim());
+    for (const section of ADR_REQUIRED_SECTIONS) {
+        if (!headings.includes(section)) {
+            addViolation(adrId, relFile, "AV-12", `Missing required section "## ${section}"`);
+        }
+    }
+    const titleStr = String(fm["title"] ?? "");
+    const headingMatch = body.match(/^#\s+(?:ADR-\d{4}:\s*)?(.+)$/m);
+    if (headingMatch && titleStr) {
+        const headingTitle = headingMatch[1].trim();
+        if (headingTitle !== titleStr) {
+            addViolation(adrId, relFile, "AV-13", `Frontmatter title "${titleStr}" does not match body heading "${headingTitle}"`, "warning");
+        }
+    }
+    const lowerAdrId = adrId.toLowerCase();
+    const fileBasename = fileName.split("/").pop().split("\\").pop();
+    if (!fileBasename.startsWith(lowerAdrId)) {
+        addViolation(adrId, relFile, "AV-14", `Filename "${fileBasename}" must start with lowercase "${lowerAdrId}"`);
+    }
+    else if (!/^[a-z0-9-]+\.md$/.test(fileBasename)) {
+        addViolation(adrId, relFile, "AV-14", `Filename "${fileName}" is not lowercase kebab-case (only a-z, 0-9, hyphens allowed)`);
+    }
+    for (const key of Object.keys(fm)) {
+        if (!knownKeys.has(key)) {
+            addViolation(adrId, relFile, "AV-15", `unknown frontmatter key "${key}" (not in the ADR schema)`, "warning");
+        }
+    }
+    // AV-16: implementation commit drift detection (RFC-0625)
+    // Warns when implement: ADR-XXXX commits exist in git history since createdAt
+    // but the ADR status is not yet "implemented".
+    if (status !== "implemented") {
+        const datePattern = /^\d{4}-\d{2}-\d{2}$/;
+        if (datePattern.test(createdAt)) {
+            const log = await execGitLog(workspaceRoot, ["log", `--since=${createdAt}`, "--oneline"]);
+            if (log) {
+                const pattern = new RegExp(`implement:\\s+${adrId}\\b`, "i");
+                const matchingLines = log.split("\n").filter((line) => pattern.test(line.trim()));
+                if (matchingLines.length > 0) {
+                    addViolation(adrId, relFile, "AV-16", `${adrId} has ${matchingLines.length} implement: commit(s) in git history since ${createdAt} but status is still "${status}". Run: site-kernel run adr.implement.stamp --id ${adrId} --implementation-commit <sha> to transition to implemented.`, "warning");
+                }
+            }
+        }
+    }
+}
+function execGitLog(workspaceRoot, args) {
+    return new Promise((resolve) => {
+        execFile("git", args, { cwd: workspaceRoot, timeout: 10000 }, (err, stdout) => {
+            if (err) {
+                resolve("");
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/os/adr/handlers/validate.js.map

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

package/dist/os/adr/index.d.ts

@@ -0,0 +1,8 @@
+export { forgeAdrModule } from "./adr.module.ts";
+export { runAdrList, runAdrCreate } from "./handlers/list-create.ts";
+export { runAdrValidate } from "./handlers/validate.ts";
+export { runAdrArchive } from "./handlers/archive.ts";
+export type { AdrArchiveResult, ArchiveMove as AdrArchiveMove, ArchiveSkip as AdrArchiveSkip, } from "./handlers/archive.ts";
+export type { AdrStatus, AdrScope, AdrFrontmatter, AdrListEntry, AdrListResult, AdrCreateResult, AdrValidationViolation, AdrValidationResult, } from "./types.ts";
+export { ADR_STATUSES, ADR_SCOPES, ADR_DIR, ADR_TEMPLATE_FILE, ADR_ID_PATTERN } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/os/adr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/adr/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EACV,gBAAgB,EAChB,WAAW,IAAI,cAAc,EAC7B,WAAW,IAAI,cAAc,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/adr/index.js

@@ -0,0 +1,18 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the ADR domain — types, constants, module, and handlers.</purpose>
+<non-goals>
+  <item>Do not implement ADR logic here; delegate to handlers/ and adr.module.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0366: expose adrModule and ADR types from the ADR domain.</item>
+  <item>RFC-0521: migrated from packages/os/site-kernel/src/adr/ to packages/forge/os/adr/.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeAdrModule } from "./adr.module.js";
+export { runAdrList, runAdrCreate } from "./handlers/list-create.js";
+export { runAdrValidate } from "./handlers/validate.js";
+export { runAdrArchive } from "./handlers/archive.js";
+export { ADR_STATUSES, ADR_SCOPES, ADR_DIR, ADR_TEMPLATE_FILE, ADR_ID_PATTERN } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/os/adr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/adr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAgBtD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/adr/types.d.ts

@@ -0,0 +1,75 @@
+export type AdrStatus = "proposed" | "reviewing" | "accepted" | "implemented" | "superseded" | "rejected";
+export declare const ADR_STATUSES: readonly AdrStatus[];
+export type AdrScope = "package" | "app" | "workspace";
+export declare const ADR_SCOPES: readonly AdrScope[];
+export interface AdrFrontmatter {
+    id: string;
+    title: string;
+    status: AdrStatus;
+    scope: AdrScope;
+    decider: string;
+    createdAt: string;
+    updatedAt: string;
+    supersedes?: string[];
+    supersededBy?: string;
+    related?: string[];
+    implementedAt?: string;
+    closedAt?: string;
+    reviewers?: string[];
+}
+export interface AdrListEntry {
+    id: string;
+    title: string;
+    status: AdrStatus;
+    scope: AdrScope;
+    decider: string;
+    updatedAt: string;
+    file: string;
+}
+export interface AdrListResult {
+    command: "adr.list";
+    status: "ok";
+    count: number;
+    entries: AdrListEntry[];
+}
+export interface AdrValidationViolation {
+    adrId: string;
+    file: string;
+    rule: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface AdrValidationResult {
+    command: "adr.validate";
+    status: "pass" | "fail";
+    count: number;
+    violations: AdrValidationViolation[];
+}
+export interface AdrCreateResult {
+    command: "adr.create";
+    status: "ok";
+    file: string;
+    id: string;
+}
+export declare const ADR_DIR = "docs/adrs";
+export declare const ADR_TEMPLATE_FILE = "docs/adrs/adr-0000-template.md";
+export declare const ADR_ID_PATTERN: RegExp;
+export declare const ADR_REQUIRED_SECTIONS: readonly ["Context", "Decision", "Justification", "Consequences", "Evolution"];
+export declare const ADR_KNOWN_KEYS: readonly string[];
+export type AdrImplementStampRule = "ADR-IMP-01" | "ADR-IMP-03" | "ADR-IMP-04" | "ADR-IMP-05";
+export interface AdrImplementStampData {
+    adrId: string;
+    implementationCommit: string;
+    stampedAt: string;
+}
+export interface AdrImplementStampViolation {
+    rule: AdrImplementStampRule;
+    message: string;
+}
+export interface AdrImplementStampResult {
+    command: "adr.implement.stamp";
+    status: "pass" | "fail";
+    data?: AdrImplementStampData;
+    violations: AdrImplementStampViolation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/os/adr/types.d.ts.map

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

package/dist/os/adr/types.js

@@ -0,0 +1,55 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Defines types and constants for managing Architectural Decision Records (ADRs):
+statuses, scopes, frontmatter shape, validation results, and list output.
+</purpose>
+<non-goals>
+  <item>Do not implement ADR processing or validation logic here.</item>
+  <item>Do not handle user input or command execution related to ADRs.</item>
+  <item>Do not manage the storage or retrieval of ADR documents.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0366: introduce ADR types and constants mirroring the RFC domain contract.</item>
+  <item>RFC-0367: extend AdrStatus with reviewing and implemented; add implementedAt, closedAt, reviewers fields.</item>
+  <item>Post-refactor hardening: document that an ADR may be superseded by a broader RFC.</item>
+  <item>RFC-0521: migrated from packages/os/site-kernel/src/adr/ to packages/forge/os/adr/.</item>
+  <item>RFC-0727: add AdrImplementStamp types for atomic ADR status transition.</item>
+</CHANGE_SUMMARY>
+*/
+export const ADR_STATUSES = [
+    "proposed",
+    "reviewing",
+    "accepted",
+    "implemented",
+    "superseded",
+    "rejected",
+];
+export const ADR_SCOPES = ["package", "app", "workspace"];
+export const ADR_DIR = "docs/adrs";
+export const ADR_TEMPLATE_FILE = "docs/adrs/adr-0000-template.md";
+export const ADR_ID_PATTERN = /^ADR-\d{4}$/;
+export const ADR_REQUIRED_SECTIONS = [
+    "Context",
+    "Decision",
+    "Justification",
+    "Consequences",
+    "Evolution",
+];
+export const ADR_KNOWN_KEYS = [
+    "id",
+    "title",
+    "status",
+    "scope",
+    "decider",
+    "createdAt",
+    "updatedAt",
+    "supersedes",
+    "supersededBy",
+    "related",
+    "implementedAt",
+    "closedAt",
+    "reviewers",
+];
+//# sourceMappingURL=types.js.map

package/dist/os/adr/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/adr/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;EAmBE;AAKF,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,UAAU;IACV,WAAW;IACX,UAAU;IACV,aAAa;IACb,YAAY;IACZ,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,SAAS,EAAE,KAAK,EAAE,WAAW,CAAU,CAAC;AAyDxF,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,gCAAgC,CAAC;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,UAAU;IACV,eAAe;IACf,cAAc;IACd,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,OAAO;IACP,SAAS;IACT,WAAW;IACX,WAAW;IACX,YAAY;IACZ,cAAc;IACd,SAAS;IACT,eAAe;IACf,UAAU;IACV,WAAW;CACH,CAAC"}

package/dist/os/audit/audit.module.d.ts

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare const forgeAuditModule: ForgeModule;
+//# sourceMappingURL=audit.module.d.ts.map

package/dist/os/audit/audit.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.module.d.ts","sourceRoot":"","sources":["../../../os/audit/audit.module.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,gBAAgB,EAAE,WAiC9B,CAAC"}

package/dist/os/audit/audit.module.js

@@ -0,0 +1,44 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the audit archive command with the forge kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement handler logic here — delegate to handlers/archive.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: initial forgeAuditModule registering audit.archive command.</item>
+</CHANGE_SUMMARY>
+*/
+export const forgeAuditModule = {
+    name: "forge-audit",
+    version: "0.1.0",
+    async register(registry) {
+        const { runAuditArchive } = await import("./handlers/archive.js");
+        registry.registerCommand({
+            name: "audit.archive",
+            description: "Move audit files whose parent RFC has terminal status " +
+                "(implemented, rejected, superseded) into docs/audits/archive/<status>/ " +
+                "subdirectories. Bidirectional: moves non-terminal files found in " +
+                "subdirectories back to root. Use --dry-run to preview. " +
+                "Use --status to filter to a single terminal status. " +
+                "Prefer the docs.archive umbrella command unless you need to archive only audits.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/audits/*.md", "docs/audits/archive/**"],
+            reads: ["docs/audits/**/*.md", "docs/rfcs/**/*.md"],
+            cacheable: false,
+            flags: {
+                "dry-run": {
+                    kind: "boolean",
+                    description: "Preview what would be moved without touching the filesystem.",
+                },
+                status: {
+                    kind: "string",
+                    description: "Filter to a single terminal status (implemented, rejected, superseded).",
+                },
+            },
+            execute: runAuditArchive,
+        });
+    },
+};
+//# sourceMappingURL=audit.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.module.js","sourceRoot":"","sources":["../../../os/audit/audit.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,CAAC,MAAM,gBAAgB,GAAgB;IAC3C,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAElE,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,wDAAwD;gBACxD,yEAAyE;gBACzE,mEAAmE;gBACnE,yDAAyD;gBACzD,sDAAsD;gBACtD,kFAAkF;YACpF,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;YACtD,KAAK,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;YACnD,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,SAAS,EAAE;oBACT,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yEAAyE;iBACvF;aACF;YACD,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/os/audit/frontmatter-io.d.ts

@@ -0,0 +1,12 @@
+export interface ParsedAudit {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export declare function parseAuditFile(source: string): ParsedAudit;
+export declare function listAuditFiles(auditDirPath: string): Promise<string[]>;
+export declare function readAndParseAudit(auditDirPath: string, fileName: string): Promise<{
+    fileName: string;
+    parsed: ParsedAudit;
+} | undefined>;
+export declare function extractRfcIdFromAuditFile(fileName: string): string | undefined;
+//# sourceMappingURL=frontmatter-io.d.ts.map

package/dist/os/audit/frontmatter-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-io.d.ts","sourceRoot":"","sources":["../../../os/audit/frontmatter-io.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAS1D;AAED,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2B5E;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAAG,SAAS,CAAC,CAQhE;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9E"}

package/dist/os/audit/frontmatter-io.js

@@ -0,0 +1,71 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Audit frontmatter file I/O — recursive file discovery and YAML frontmatter
+parsing for audit files under docs/audits/. Only files matching the
+audit-rfc-XXXX-* pattern are candidates for archiving; standalone audits
+are silently excluded.
+</purpose>
+<non-goals>
+  <item>Do not validate audit content.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: initial audit frontmatter I/O.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { AUDIT_RFC_FILE_PATTERN } from "./types.js";
+export function parseAuditFile(source) {
+    const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, body: source };
+    }
+    return {
+        frontmatter: (YAML.parse(match[1]) ?? {}),
+        body: match[2] ?? "",
+    };
+}
+export async function listAuditFiles(auditDirPath) {
+    const results = [];
+    async function scanDir(dirPath, relativePrefix) {
+        try {
+            const entries = await fs.readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const relativePath = relativePrefix ? `${relativePrefix}/${entry.name}` : entry.name;
+                if (entry.isDirectory()) {
+                    await scanDir(path.join(dirPath, entry.name), relativePath);
+                }
+                else if (entry.isFile() &&
+                    entry.name.endsWith(".md") &&
+                    !entry.name.startsWith("audit-0000") &&
+                    entry.name !== "README.md" &&
+                    AUDIT_RFC_FILE_PATTERN.test(entry.name)) {
+                    results.push(relativePath);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or is unreadable — return empty
+        }
+    }
+    await scanDir(auditDirPath, "");
+    return results.sort();
+}
+export async function readAndParseAudit(auditDirPath, fileName) {
+    try {
+        const filePath = path.join(auditDirPath, fileName);
+        const content = await fs.readFile(filePath, "utf-8");
+        return { fileName, parsed: parseAuditFile(content) };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function extractRfcIdFromAuditFile(fileName) {
+    const match = path.basename(fileName).match(/^audit-(rfc-\d{4})-/i);
+    return match ? match[1].toUpperCase() : undefined;
+}
+//# sourceMappingURL=frontmatter-io.js.map