@warpgogol/forge 0.3.1

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

@@ -0,0 +1,219 @@
+/*
+<MODULE_CONTRACT>
+<purpose>ADR validation handler — frontmatter, section, and referential integrity checks.</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>
+</CHANGE_SUMMARY>
+*/
+import path from "node:path";
+import { listAdrFiles, readAndParseAdr } 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 = 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.args[0];
+    const allFiles = await listAdrFiles(adrDirPath);
+    const filesToValidate = targetId
+        ? allFiles.filter((f) => f.toLowerCase().startsWith(targetId.toLowerCase()))
+        : 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;
+        validateSingleAdr(fileName, result.parsed, allParsed, knownRfcIds, seenIds, knownKeys, 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`,
+    };
+}
+function validateSingleAdr(fileName, parsed, allParsed, knownRfcIds, seenIds, knownKeys, 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`);
+    }
+    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 supersededBy = fm["supersededBy"];
+    if (supersededBy && /^ADR-\d{4}$/.test(supersededBy) && !allParsed.has(supersededBy)) {
+        addViolation(adrId, relFile, "AV-09", `supersededBy "${supersededBy}" does not match any existing ADR`);
+    }
+    else if (supersededBy && /^RFC-\d{4}$/.test(supersededBy) && !knownRfcIds.has(supersededBy)) {
+        addViolation(adrId, relFile, "AV-09", `supersededBy "${supersededBy}" does not match any existing RFC`);
+    }
+    else if (supersededBy && !/^(ADR|RFC)-\d{4}$/.test(supersededBy)) {
+        addViolation(adrId, relFile, "AV-09", `supersededBy "${supersededBy}" is not a recognized ADR/RFC id`);
+    }
+    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");
+        }
+    }
+}
+//# 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,59 @@
+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[];
+//# 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":"AAoBA,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,WAAW,GACX,UAAU,GACV,aAAa,GACb,YAAY,GACZ,UAAU,CAAC;AAEf,eAAO,MAAM,YAAY,EAAE,SAAS,SAAS,EAOnC,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,WAAW,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAA6C,CAAC;AAExF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,OAAO,cAAc,CAAC;AACnC,eAAO,MAAM,iBAAiB,mCAAmC,CAAC;AAClE,eAAO,MAAM,cAAc,QAAgB,CAAC;AAE5C,eAAO,MAAM,qBAAqB,gFAMxB,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAclC,CAAC"}

package/dist/os/adr/types.js

@@ -0,0 +1,54 @@
+/*
+<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>
+</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;;;;;;;;;;;;;;;;;;EAkBE;AAUF,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,CA6B5E;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,73 @@
+/*
+<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

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

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

package/dist/os/audit/handlers/archive.d.ts

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

package/dist/os/audit/handlers/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../os/audit/handlers/archive.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CA4JjD"}