@warpgogol/forge 4.1.5 → 4.2.1

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

@@ -0,0 +1,260 @@
+/*
+<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 filterBatch = input.flags["batch"];
+    const files = await listRfcFiles(rfcDirPath);
+    const entries = [];
+    for (const fileName of files) {
+        const result = await readAndParseRfc(rfcDirPath, fileName);
+        if (!result || "error" in result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const 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;
+        if (filterBatch && String(fm["batch"] ?? "") !== filterBatch)
+            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),
+            batch: fm["batch"] ? String(fm["batch"]) : undefined,
+            dependsOn: Array.isArray(fm["dependsOn"]) ? fm["dependsOn"] : undefined,
+        });
+    }
+    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`,
+        nextSteps: entries.length === 0
+            ? [
+                {
+                    action: `Create a new RFC: pnpm exec forge run rfc.create --title "..."`,
+                    kind: "optional",
+                },
+            ]
+            : undefined,
+    };
+}
+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}`,
+        nextSteps: [
+            {
+                action: `Validate the RFC: pnpm exec forge run rfc.validate --file ${relativeFile}`,
+                kind: "optional",
+            },
+        ],
+    };
+}
+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}`,
+        nextSteps: [
+            {
+                action: `Create the RFC: pnpm exec forge run rfc.create --title "..."`,
+                kind: "optional",
+            },
+        ],
+    };
+}
+//# 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":"AAkBA,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.flags["id"];
+    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 || "error" in 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;AAQ1B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA4BhE"}

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

@@ -0,0 +1,105 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Shared helpers for RFC handler commands — date utils, invariant ID loading, FS path checks, command bucket parsing.</purpose>
+<non-goals>
+  <item>Do not implement command handlers; those live in sibling files.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0303: extracted shared helpers from handlers.ts into handlers/shared.ts.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveForgeRoot } from "../../../src/config/forge-config.js";
+import { RFC_TEMPLATE_FILE, RFC_TEMPLATE_FALLBACK_FILE } from "../types.js";
+export function toIsoDate(date) {
+    return date.toISOString().split("T")[0];
+}
+const DNA_DOC = "docs/architecture-dna.md";
+const AP_DOC = "packages/os/site-kernel/docs/anti-patterns.md";
+export const DNA_DOCS = [DNA_DOC];
+export const AP_DOCS = [AP_DOC];
+/** Parse `## <PREFIX>-N` headings from the given docs and return the set of N. */
+export async function loadInvariantIds(workspaceRoot, relPaths, prefix) {
+    const ids = new Set();
+    const re = new RegExp(`^##\\s+${prefix}-(\\d+)\\b`, "gm");
+    for (const rel of relPaths) {
+        try {
+            const src = await fs.readFile(path.join(workspaceRoot, rel), "utf-8");
+            for (const m of src.matchAll(re))
+                ids.add(parseInt(m[1], 10));
+        }
+        catch {
+            // Doc not present at this path — try the next candidate.
+        }
+    }
+    return ids;
+}
+/**
+ * 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 function isLiteralFsPath(p) {
+    if (/[*<>{}]/.test(p))
+        return false; // globs / placeholders
+    if (/\s/.test(p))
+        return false; // prose ("Every generator module")
+    if (!p.includes("/") && !p.includes("."))
+        return false; // bare words
+    return true;
+}
+export function stringArray(value) {
+    return Array.isArray(value) ? value.map(String).filter(Boolean) : [];
+}
+export function commandBuckets(fm) {
+    const commands = fm["commands"];
+    if (!commands || typeof commands !== "object" || Array.isArray(commands)) {
+        return { proposed: [], added: [], changed: [], removed: [] };
+    }
+    const record = commands;
+    return {
+        proposed: stringArray(record["proposed"]),
+        added: stringArray(record["added"]),
+        changed: stringArray(record["changed"]),
+        removed: stringArray(record["removed"]),
+    };
+}
+// ---------------------------------------------------------------------------
+// RFC template resolver — finds rfc-0000-template.md from project docs/rfcs/
+// first (canonical location, mirroring ADR pattern), then falls back to the
+// forge package copy (npm consumers without a project-level template).
+// ---------------------------------------------------------------------------
+export function resolveRfcTemplate(workspaceRoot) {
+    // 1. Try project-level docs/rfcs/rfc-0000-template.md (canonical, like ADR)
+    const projectPath = path.join(workspaceRoot, RFC_TEMPLATE_FILE);
+    if (existsSync(projectPath))
+        return projectPath;
+    // 2. Try forge root (monorepo or npm-installed) — fallback copy
+    try {
+        const forgeRoot = resolveForgeRoot(workspaceRoot);
+        const p = path.join(forgeRoot, RFC_TEMPLATE_FALLBACK_FILE);
+        if (existsSync(p))
+            return p;
+    }
+    catch {
+        // forge root not resolvable — fall through to module-relative search
+    }
+    // 3. Fallback: walk up from this module's location to find os/rfc/rfc-0000-template.md
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    let dir = here;
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.join(dir, "os", "rfc", "rfc-0000-template.md");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`RFC template not found. Tried ${RFC_TEMPLATE_FILE} relative to ${workspaceRoot}, forge root, and module-relative search from ${here}.`);
+}
+//# sourceMappingURL=shared.js.map

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

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

package/dist/os/rfc/handlers/supersede-propose.d.ts

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

package/dist/os/rfc/handlers/supersede-propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede-propose.d.ts","sourceRoot":"","sources":["../../../../os/rfc/handlers/supersede-propose.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAqB,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AA8B/B,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,CAAC,CAgLxD"}