@warpgogol/forge 0.3.1

package/dist/os/rfc/handlers/lifecycle.js

@@ -0,0 +1,150 @@
+/*
+<MODULE_CONTRACT>
+<purpose>RFC command lifecycle validation — collects and reports RFC-CMD-* violations.</purpose>
+<non-goals>
+  <item>Do not introduce app-specific runtime composition or deployment behavior into this reusable package source file.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0303: extracted lifecycle logic from handlers.ts into handlers/lifecycle.ts.</item>
+  <item>Post-refactor hardening: targeted lifecycle validation resolves RFC ids inside archive subdirectories.</item>
+  <item>RFC-0465: added RFC_METADATA_CUTOFF check to RFC-CMD-02 and RFC-CMD-03 rules — pre-cutoff RFCs are exempt from command registration checks.</item>
+  <item>RFC-0465 fix: added manifest-based fallback in getLiveCommands — reads docs/command-manifest.generated.yaml when commandRegistry returns empty (site-kernel mode).</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as yamlParse } from "yaml";
+import { listRfcFiles, readAndParseRfc, rfcFileMatchesId, } from "../frontmatter-io.js";
+import { RFC_DIR, RFC_METADATA_CUTOFF } from "../types.js";
+import { commandBuckets } from "./shared.js";
+async function loadManifestCommandNames(workspaceRoot) {
+    const manifestPath = path.join(workspaceRoot, "docs", "command-manifest.generated.yaml");
+    try {
+        const raw = await readFile(manifestPath, "utf-8");
+        const manifest = yamlParse(raw);
+        return new Set((manifest.commands ?? []).map((c) => c.name));
+    }
+    catch {
+        return new Set();
+    }
+}
+export async function collectRfcCommandLifecycleViolations(workspaceRoot, filesToValidate, preParsed, commandRegistry) {
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const files = filesToValidate ?? (await listRfcFiles(rfcDirPath));
+    let liveCommandsPromise;
+    async function getLiveCommands() {
+        if (!liveCommandsPromise) {
+            const cmds = commandRegistry?.listCommands() ?? [];
+            let names = new Set(cmds.map((c) => c.name));
+            if (names.size === 0) {
+                names = await loadManifestCommandNames(workspaceRoot);
+            }
+            liveCommandsPromise = Promise.resolve(names);
+        }
+        return liveCommandsPromise;
+    }
+    const violations = [];
+    const addViolation = (rfcId, file, rule, message, severity, data) => {
+        violations.push({ rfcId, file, rule, message, severity, data });
+    };
+    let checkedCount = 0;
+    for (const fileName of files) {
+        const result = preParsed?.get(fileName) ?? (await readAndParseRfc(rfcDirPath, fileName));
+        if (!result)
+            continue;
+        checkedCount += 1;
+        const fm = result.parsed.frontmatter;
+        const rfcId = String(fm["id"] ?? "UNKNOWN");
+        const status = String(fm["status"] ?? "");
+        const relFile = path.join(RFC_DIR, fileName);
+        const buckets = commandBuckets(fm);
+        const removed = new Set(buckets.removed);
+        const createdAt = String(fm["createdAt"] ?? "");
+        const isPostCutoff = createdAt >= RFC_METADATA_CUTOFF;
+        for (const command of buckets.proposed) {
+            if (status === "implemented" &&
+                (await getLiveCommands()).has(command) &&
+                !buckets.added.includes(command)) {
+                addViolation(rfcId, relFile, "RFC-CMD-01", `implemented RFC lists live command "${command}" under commands.proposed but not commands.added`, "error", { rfcId, command, status, bucket: "proposed" });
+            }
+        }
+        for (const command of buckets.added) {
+            if (isPostCutoff &&
+                status === "implemented" &&
+                !(await getLiveCommands()).has(command) &&
+                !removed.has(command)) {
+                addViolation(rfcId, relFile, "RFC-CMD-02", `implemented RFC lists "${command}" under commands.added, but no live command is registered`, "error", { rfcId, command, status, bucket: "added" });
+            }
+            if ((status === "draft" || status === "reviewing") && !result.parsed.body.includes(command)) {
+                addViolation(rfcId, relFile, "RFC-CMD-04", `non-accepted RFC lists "${command}" under commands.added without body rationale`, "warning", { rfcId, command, status, bucket: "added" });
+            }
+        }
+        for (const command of buckets.changed) {
+            if (isPostCutoff &&
+                status === "implemented" &&
+                !(await getLiveCommands()).has(command) &&
+                !removed.has(command)) {
+                addViolation(rfcId, relFile, "RFC-CMD-03", `implemented RFC lists "${command}" under commands.changed, but no live command is registered`, "error", { rfcId, command, status, bucket: "changed" });
+            }
+        }
+        for (const command of new Set([...buckets.added, ...buckets.changed])) {
+            if (removed.has(command))
+                continue;
+            const bucketCount = Number(buckets.added.includes(command)) + Number(buckets.changed.includes(command));
+            if (bucketCount > 1) {
+                addViolation(rfcId, relFile, "RFC-CMD-05", `command "${command}" appears in conflicting lifecycle buckets without commands.removed transition`, "warning", { rfcId, command, status, bucket: buckets.added.includes(command) ? "added" : "changed" });
+            }
+        }
+    }
+    return { checkedCount, violations };
+}
+export async function runRfcCommandLifecycleValidate(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const targetId = input.args[0];
+    const allFiles = await listRfcFiles(rfcDirPath);
+    const filesToValidate = targetId
+        ? allFiles.filter((f) => rfcFileMatchesId(f, targetId))
+        : allFiles;
+    if (filesToValidate.length === 0) {
+        if (targetId) {
+            throw new Error(`No RFC file found for id ${targetId} in ${RFC_DIR}/`);
+        }
+        return {
+            data: {
+                command: "rfc.command-lifecycle.validate",
+                status: "pass",
+                count: 0,
+                violations: [],
+            },
+            summary: "No RFC files found to validate",
+        };
+    }
+    const { checkedCount, violations } = await collectRfcCommandLifecycleViolations(workspaceRoot, filesToValidate, undefined, context.commandRegistry);
+    const hasErrors = violations.some((v) => v.severity === "error");
+    if (outputFormat === "pretty") {
+        if (violations.length === 0) {
+            logger.success(`All ${checkedCount} RFC(s) passed command lifecycle validation.`);
+        }
+        else {
+            logger.section(`RFC Command Lifecycle Validation (${checkedCount} file(s))`);
+            for (const v of violations) {
+                logger[v.severity === "error" ? "error" : "warn"](`[${v.severity === "error" ? "ERROR" : "WARN"}] ${v.rfcId} ${v.rule}: ${v.message}`);
+            }
+        }
+    }
+    return {
+        data: {
+            command: "rfc.command-lifecycle.validate",
+            status: hasErrors ? "fail" : "pass",
+            count: checkedCount,
+            violations,
+        },
+        exitCode: hasErrors ? 1 : 0,
+        summary: hasErrors
+            ? `${violations.filter((v) => v.severity === "error").length} command lifecycle error(s) found`
+            : `All ${checkedCount} RFC(s) passed command lifecycle validation`,
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/os/rfc/handlers/lifecycle.js.map

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

package/dist/os/rfc/handlers/list-create.d.ts

@@ -0,0 +1,6 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+import type { RfcListResult, RfcCreateResult, RfcNextIdResult } from "../types.ts";
+export declare function runRfcList(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcListResult>>;
+export declare function runRfcCreate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcCreateResult>>;
+export declare function runRfcNextId(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcNextIdResult>>;
+//# sourceMappingURL=list-create.d.ts.map

package/dist/os/rfc/handlers/list-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-create.d.ts","sourceRoot":"","sources":["../../../../os/rfc/handlers/list-create.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,aAAa,EACb,eAAe,EACf,eAAe,EAIhB,MAAM,aAAa,CAAC;AAmCrB,wBAAsB,UAAU,CAC9B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CA8D5C;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAqH9C;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAkC9C"}

package/dist/os/rfc/handlers/list-create.js

@@ -0,0 +1,235 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Maintains packages/os/site-kernel/src/rfc/handlers/list-create.ts as an authored site-kernel authored module so agents can evolve it without rediscovering local boundaries.</purpose>
+<non-goals>
+  <item>Do not introduce app-specific runtime composition or deployment behavior into this reusable package source file.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0303: extracted list and create handlers from handlers.ts into handlers/list-create.ts.</item>
+  <item>Post-refactor hardening: require explicit satisfies DNA traces for new architecture/contract RFC drafts.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import { toKebabCase } from "../../../src/utils/string-utils.js";
+import { listRfcFiles, readAndParseRfc } from "../frontmatter-io.js";
+import { RFC_DIR, RFC_KINDS, RFC_SCOPES, RFC_METADATA_CUTOFF } from "../types.js";
+import { DNA_DOCS, loadInvariantIds, toIsoDate, resolveRfcTemplate } from "./shared.js";
+import { collectDecisionLog, scoreDecisions } from "../decision-log.js";
+function parseSatisfiesFlag(value) {
+    if (typeof value !== "string")
+        return [];
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+async function assertSatisfiesIdsExist(workspaceRoot, satisfies) {
+    if (satisfies.length === 0)
+        return;
+    const validDnaIds = await loadInvariantIds(workspaceRoot, DNA_DOCS, "DNA");
+    const errors = [];
+    for (const id of satisfies) {
+        if (!/^DNA-\d+$/.test(id)) {
+            errors.push(`Malformed satisfies entry: "${id}". Must match DNA-N.`);
+            continue;
+        }
+        if (!validDnaIds.has(parseInt(id.slice(4), 10))) {
+            errors.push(`Unknown DNA invariant: ${id} (not found in ${DNA_DOCS.join(", ")}).`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(errors.join(" "));
+    }
+}
+export async function runRfcList(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const filterStatus = input.flags["status"];
+    const filterKind = input.flags["kind"];
+    const filterOwner = input.flags["owner"];
+    const files = await listRfcFiles(rfcDirPath);
+    const entries = [];
+    for (const fileName of files) {
+        const result = await readAndParseRfc(rfcDirPath, fileName);
+        if (!result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const id = String(fm["id"] ?? "");
+        const status = String(fm["status"] ?? "");
+        const kind = String(fm["kind"] ?? "");
+        const scope = String(fm["scope"] ?? "");
+        const owners = Array.isArray(fm["owners"]) ? fm["owners"] : [];
+        if (filterStatus && status !== filterStatus)
+            continue;
+        if (filterKind && kind !== filterKind)
+            continue;
+        if (filterOwner && !owners.includes(filterOwner))
+            continue;
+        entries.push({
+            id,
+            title: String(fm["title"] ?? ""),
+            status,
+            kind,
+            scope,
+            owners,
+            createdAt: String(fm["createdAt"] ?? ""),
+            updatedAt: String(fm["updatedAt"] ?? ""),
+            file: path.join(RFC_DIR, fileName),
+        });
+    }
+    if (outputFormat === "pretty") {
+        if (entries.length === 0) {
+            logger.info("No RFCs found matching the given filters.");
+        }
+        else {
+            logger.section(`RFCs (${entries.length})`);
+            for (const entry of entries) {
+                const ownerStr = entry.owners.join(", ");
+                logger.info(`${entry.id}  ${entry.status.padEnd(12)} ${entry.kind.padEnd(14)} ${entry.title}  [${ownerStr}]`);
+            }
+        }
+    }
+    return {
+        data: {
+            command: "rfc.list",
+            status: "ok",
+            count: entries.length,
+            entries,
+        },
+        summary: `${entries.length} RFC(s) found`,
+    };
+}
+export async function runRfcCreate(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const title = input.flags["title"];
+    if (!title) {
+        throw new Error('rfc.create requires --title flag, e.g. --title "Add structure.validate command"');
+    }
+    const kind = input.flags["kind"] ?? "architecture";
+    const scope = input.flags["scope"] ?? "workspace";
+    const satisfies = parseSatisfiesFlag(input.flags["satisfies"]);
+    if (!RFC_KINDS.includes(kind)) {
+        throw new Error(`Invalid kind: ${kind}. Must be one of: ${RFC_KINDS.join(", ")}`);
+    }
+    if (!RFC_SCOPES.includes(scope)) {
+        throw new Error(`Invalid scope: ${scope}. Must be one of: ${RFC_SCOPES.join(", ")}`);
+    }
+    const today = toIsoDate(new Date());
+    const requiresSatisfies = today >= RFC_METADATA_CUTOFF && (kind === "architecture" || kind === "contract");
+    if (requiresSatisfies && satisfies.length === 0) {
+        throw new Error(`rfc.create requires --satisfies DNA-N for ${kind} RFCs created on or after ${RFC_METADATA_CUTOFF} (RFC-0331).`);
+    }
+    await assertSatisfiesIdsExist(workspaceRoot, satisfies);
+    const files = await listRfcFiles(rfcDirPath);
+    let maxId = 0;
+    for (const f of files) {
+        const basename = path.basename(f);
+        const match = basename.match(/^rfc-(\d{4})/);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxId)
+                maxId = num;
+        }
+    }
+    const nextNum = maxId + 1;
+    const paddedNum = String(nextNum).padStart(4, "0");
+    const nextSlug = `rfc-${paddedNum}`;
+    const nextId = `RFC-${paddedNum}`;
+    const templatePath = resolveRfcTemplate(workspaceRoot);
+    let templateContent;
+    try {
+        templateContent = await fs.readFile(templatePath, "utf-8");
+    }
+    catch {
+        throw new Error(`RFC template not found at ${templatePath}.`);
+    }
+    const kebabTitle = toKebabCase(title);
+    const fileName = `${nextSlug}-${kebabTitle}.md`;
+    // RFC-0329: consult decision log before scaffolding
+    let consultedDecisions = [];
+    try {
+        const logEntries = await collectDecisionLog(rfcDirPath);
+        consultedDecisions = scoreDecisions(title, logEntries);
+    }
+    catch {
+        // graceful degradation — never block creation
+    }
+    if (outputFormat === "pretty") {
+        if (consultedDecisions.length > 0) {
+            logger.info("Prior decisions to consult:");
+            for (const d of consultedDecisions) {
+                logger.info(`  ${d.rfcId} [${d.kind}] (score ${d.score}): ${d.title}`);
+            }
+        }
+        else {
+            logger.info("No related prior decisions found.");
+        }
+    }
+    let content = templateContent;
+    content = content.replace(/^id: RFC-0000$/m, `id: ${nextId}`);
+    content = content.replace(/^title: ".*"$/m, `title: "${title}"`);
+    content = content.replace(/^kind: \w+$/m, `kind: ${kind}`);
+    content = content.replace(/^scope: \w+$/m, `scope: ${scope}`);
+    content = content.replace(/^createdAt: YYYY-MM-DD$/m, `createdAt: ${today}`);
+    content = content.replace(/^updatedAt: YYYY-MM-DD$/m, `updatedAt: ${today}`);
+    if (satisfies.length > 0) {
+        content = content.replace(/^satisfies: \[\]$/m, `satisfies:\n${satisfies.map((id) => `  - ${id}`).join("\n")}`);
+    }
+    content = content.replace(/^# RFC-0000: .+$/m, `# ${nextId}: ${title}`);
+    const targetPath = path.join(rfcDirPath, fileName);
+    await fs.writeFile(targetPath, content, "utf-8");
+    const relativeFile = path.join(RFC_DIR, fileName);
+    if (outputFormat === "pretty") {
+        logger.success(`Created ${nextId}: ${title}`);
+        logger.info(`File: ${relativeFile}`);
+        logger.info(`Template: full`);
+        logger.info("Status: draft (only a human with role 'architecture' may change status)");
+    }
+    return {
+        data: {
+            command: "rfc.create",
+            status: "ok",
+            file: relativeFile,
+            id: nextId,
+            satisfies,
+            consultedDecisions,
+        },
+        summary: `Created ${nextId}: ${title}`,
+    };
+}
+export async function runRfcNextId(_input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const files = await listRfcFiles(rfcDirPath);
+    let maxId = 0;
+    for (const f of files) {
+        const basename = path.basename(f);
+        const match = basename.match(/^rfc-(\d{4})/);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxId)
+                maxId = num;
+        }
+    }
+    const nextNumber = maxId + 1;
+    const paddedNum = String(nextNumber).padStart(4, "0");
+    const nextId = `RFC-${paddedNum}`;
+    const maxExistingId = maxId > 0 ? `RFC-${String(maxId).padStart(4, "0")}` : "none";
+    if (outputFormat === "pretty") {
+        logger.info(`Next free RFC number: ${nextId} (scanned ${files.length} files)`);
+    }
+    return {
+        data: {
+            command: "rfc.next-id",
+            nextId,
+            nextNumber,
+            maxExistingId,
+            scannedFiles: files.length,
+        },
+        summary: `Next RFC number: ${nextId}`,
+    };
+}
+//# sourceMappingURL=list-create.js.map

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

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

package/dist/os/rfc/handlers/pipeline-status.d.ts

@@ -0,0 +1,26 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+import type { RfcStatus } from "../types.ts";
+export type PipelineStage = "audit" | "enhance" | "plan" | "implement";
+export interface RfcPipelineStageInfo {
+    stage: PipelineStage;
+    done: boolean;
+    /** File or marker that confirms completion, when applicable. */
+    evidence?: string;
+}
+export interface RfcPipelineEntry {
+    id: string;
+    title: string;
+    status: RfcStatus;
+    file: string;
+    stages: RfcPipelineStageInfo[];
+    /** The immediate next missing step, or null if all are done. */
+    nextStep: PipelineStage | null;
+}
+export interface RfcPipelineStatusResult {
+    command: "rfc.pipeline.status";
+    status: "ok";
+    count: number;
+    entries: RfcPipelineEntry[];
+}
+export declare function runRfcPipelineStatus(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcPipelineStatusResult>>;
+//# sourceMappingURL=pipeline-status.d.ts.map

package/dist/os/rfc/handlers/pipeline-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-status.d.ts","sourceRoot":"","sources":["../../../../os/rfc/handlers/pipeline-status.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AA4BD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CA2FtD"}

package/dist/os/rfc/handlers/pipeline-status.js

@@ -0,0 +1,124 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Reports the pipeline status of RFCs — which steps (audit, enhance, plan, implement) are complete or missing.</purpose>
+<non-goals>
+  <item>Does not validate RFC content — use rfc.validate for that.</item>
+  <item>Does not mutate any files.</item>
+  <item>Does not gate skill execution — skills keep their own prerequisite checks.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Add rfc.pipeline.status command for agents and humans to inspect where an RFC stands in the create → audit → enhance → plan → implement pipeline.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import { listRfcFiles, readAndParseRfc } from "../frontmatter-io.js";
+import { RFC_DIR } from "../types.js";
+const TERMINAL_STATUSES = new Set(["implemented", "rejected", "superseded"]);
+async function findAuditFile(workspaceRoot, rfcId) {
+    const auditsDir = path.join(workspaceRoot, "docs/audits");
+    try {
+        const entries = await fs.readdir(auditsDir);
+        const prefix = `audit-${rfcId.toLowerCase()}`;
+        const match = entries.find((e) => e.toLowerCase().startsWith(prefix) && e.endsWith(".md"));
+        return match ? path.join("docs/audits", match) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function findPlanFile(workspaceRoot, rfcId) {
+    const plansDir = path.join(workspaceRoot, "docs/plans");
+    try {
+        const entries = await fs.readdir(plansDir);
+        const prefix = `plan-${rfcId.toLowerCase()}`;
+        const match = entries.find((e) => e.toLowerCase().startsWith(prefix) && e.endsWith(".md"));
+        return match ? path.join("docs/plans", match) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function runRfcPipelineStatus(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const targetId = input.args[0];
+    let files = await listRfcFiles(rfcDirPath);
+    if (targetId) {
+        const lower = targetId.toLowerCase();
+        files = files.filter((f) => path.basename(f).toLowerCase().startsWith(lower));
+        if (files.length === 0) {
+            throw new Error(`No RFC file found for id ${targetId} in ${RFC_DIR}/`);
+        }
+    }
+    const entries = [];
+    for (const fileName of files) {
+        const result = await readAndParseRfc(rfcDirPath, fileName);
+        if (!result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const id = String(fm["id"] ?? "");
+        const title = String(fm["title"] ?? "");
+        const status = String(fm["status"] ?? "");
+        const enhancedAt = fm["enhancedAt"] ? String(fm["enhancedAt"]) : undefined;
+        const implementedAt = fm["implementedAt"] ? String(fm["implementedAt"]) : undefined;
+        const isTerminal = TERMINAL_STATUSES.has(status);
+        const auditFile = await findAuditFile(workspaceRoot, id);
+        const planFile = await findPlanFile(workspaceRoot, id);
+        const stages = [
+            {
+                stage: "audit",
+                done: !!auditFile,
+                evidence: auditFile,
+            },
+            {
+                stage: "enhance",
+                done: !!enhancedAt,
+                evidence: enhancedAt ? `enhancedAt: ${enhancedAt}` : undefined,
+            },
+            {
+                stage: "plan",
+                done: !!planFile,
+                evidence: planFile,
+            },
+            {
+                stage: "implement",
+                done: status === "implemented" || !!implementedAt,
+                evidence: implementedAt ? `implementedAt: ${implementedAt}` : undefined,
+            },
+        ];
+        let nextStep = null;
+        if (!isTerminal) {
+            for (const s of stages) {
+                if (!s.done) {
+                    nextStep = s.stage;
+                    break;
+                }
+            }
+        }
+        entries.push({
+            id,
+            title,
+            status,
+            file: path.join(RFC_DIR, fileName),
+            stages,
+            nextStep,
+        });
+    }
+    entries.sort((a, b) => a.id.localeCompare(b.id));
+    if (outputFormat === "pretty") {
+        logger.section(`RFC pipeline status (${entries.length} RFC(s))`);
+        for (const entry of entries) {
+            const stageStr = entry.stages.map((s) => `${s.stage}:${s.done ? "✓" : "—"}`).join("  ");
+            const next = entry.nextStep ? ` → next: ${entry.nextStep}` : "";
+            const terminal = TERMINAL_STATUSES.has(entry.status) ? " (terminal)" : "";
+            logger.info(`${entry.id} [${entry.status}${terminal}]  ${stageStr}${next}`);
+        }
+    }
+    return {
+        data: { command: "rfc.pipeline.status", status: "ok", count: entries.length, entries },
+        summary: `Pipeline status for ${entries.length} RFC(s)`,
+    };
+}
+//# sourceMappingURL=pipeline-status.js.map

package/dist/os/rfc/handlers/pipeline-status.js.map

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

package/dist/os/rfc/handlers/shared.d.ts

@@ -0,0 +1,22 @@
+import type { ParsedRfc } from "../frontmatter-io.ts";
+export declare function toIsoDate(date: Date): string;
+export declare const DNA_DOCS: string[];
+export declare const AP_DOCS: string[];
+/** Parse `## <PREFIX>-N` headings from the given docs and return the set of N. */
+export declare function loadInvariantIds(workspaceRoot: string, relPaths: string[], prefix: string): Promise<Set<number>>;
+/**
+ * Whether a "File system responsibilities" path is a concrete, checkable file.
+ * Skips glob/placeholder/prose entries that rfc.check must not `fs.access` verbatim:
+ * `apps/*`, `apps/<app>/…`, `{lang}`, `**`, or descriptive phrases with spaces.
+ */
+export declare function isLiteralFsPath(p: string): boolean;
+export declare function stringArray(value: unknown): string[];
+export declare function commandBuckets(fm: Record<string, unknown>): {
+    proposed: string[];
+    added: string[];
+    changed: string[];
+    removed: string[];
+};
+export type { ParsedRfc };
+export declare function resolveRfcTemplate(workspaceRoot: string): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/os/rfc/handlers/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../os/rfc/handlers/shared.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE5C;AAID,eAAO,MAAM,QAAQ,UAAY,CAAC;AAClC,eAAO,MAAM,OAAO,UAAW,CAAC;AAEhC,kFAAkF;AAClF,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAYtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAKlD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAEpD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAYA;AAED,YAAY,EAAE,SAAS,EAAE,CAAC;AAM1B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAwBhE"}