@warpgogol/forge 1.2.2 → 2.1.0

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

@@ -1,265 +0,0 @@
-/*
-<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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-/*
-<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

@@ -1 +0,0 @@
-{"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

@@ -1,75 +0,0 @@
-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

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

package/dist/os/adr/types.js

@@ -1,55 +0,0 @@
-/*
-<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

@@ -1 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,44 +0,0 @@
-/*
-<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

@@ -1 +0,0 @@
-{"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

@@ -1,12 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,71 +0,0 @@
-/*
-<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

@@ -1 +0,0 @@
-{"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

@@ -1,4 +0,0 @@
-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

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