@warpgogol/forge 0.3.1

package/dist/os/rfc/handlers.js

@@ -0,0 +1,19 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Thin re-export shim for RFC handlers split into handlers/ (RFC-0303).</purpose>
+<non-goals>
+  <item>Do not implement command logic here; implementations live in handlers/*.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0153: remove the C:/Temp debug write + debug-keys leak; make V-12 bidirectional; add V-16 (status/date coupling), V-17 (strict supersededBy), V-18 (related referential integrity vs DNA/AP/RFC); rfc.check skips glob/placeholder/prose paths.</item>
+  <item>RFC-0303: split handlers.ts (1447 lines) into handlers/{shared,lifecycle,list-create,validate,check,index-graph}.ts.</item>
+</CHANGE_SUMMARY>
+*/
+export { runRfcList, runRfcCreate, runRfcNextId } from "./handlers/list-create.js";
+export { runRfcValidate } from "./handlers/validate.js";
+export { runRfcCommandLifecycleValidate } from "./handlers/lifecycle.js";
+export { runRfcCheck } from "./handlers/check.js";
+export { runRfcIndexGenerate, runRfcIndexValidate, runRfcGraph } from "./handlers/index-graph.js";
+export { runRfcImplementStamp } from "./handlers/implement-stamp.js";
+//# sourceMappingURL=handlers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../os/rfc/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}

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

@@ -0,0 +1,18 @@
+export { forgeRfcModule } from "./rfc.module.ts";
+export { listRfcFiles, parseRfcFile, readAndParseRfc, rfcFileMatchesId, getRfcStatusById, loadRfcStatusMap, type ParsedRfc, } from "./frontmatter-io.ts";
+export { runRfcList, runRfcCreate, runRfcValidate, runRfcCommandLifecycleValidate, runRfcCheck, } from "./handlers.ts";
+export { runRfcImplementStamp } from "./handlers/implement-stamp.ts";
+export { runRfcAcceptanceRun, runProbe, validateAcceptanceShape } from "./acceptance.ts";
+export { runRfcVerificationEmit, buildEvidenceEnvelope } from "./verification-evidence.ts";
+export { runRfcDnaTraceValidate, runRfcDnaTraceGenerate, buildDnaTrace } from "./dna-trace.ts";
+export type { DnaTraceEntry, DnaTraceResult } from "./dna-trace.ts";
+export { collectDecisionLog, scoreDecisions, runRfcDecisionLogGenerate } from "./decision-log.ts";
+export { runRfcSupersedePropose } from "./handlers/supersede-propose.ts";
+export { runRfcArchive } from "./handlers/archive.ts";
+export { evaluateAcceptanceCriteria, extractAcceptanceCriteriaSection, type AcceptanceCriteriaEvaluation, } from "./handlers/validate-rules.ts";
+export type { RfcArchiveResult, ArchiveMove as RfcArchiveMove, ArchiveSkip as RfcArchiveSkip, } from "./handlers/archive.ts";
+export type { DecisionLogEntry, DecisionLogEntryKind, DecisionLogResult, ConsultedDecision, RfcSupersedeProposeResult, } from "./types.ts";
+export type { RfcImplementStampData, RfcImplementStampRule, RfcImplementStampViolation, RfcImplementStampResult, } from "./types.ts";
+export type { RfcStatus, RfcKind, RfcScope, RfcCommands, RfcFrontmatter, RfcListEntry, RfcListResult, RfcCreateResult, RfcValidationViolation, RfcValidationResult, RfcCommandLifecycleViolation, RfcCommandLifecycleValidationResult, RfcCheckViolation, RfcCheckResult, AcceptanceProbe, ProbeResult, RfcAcceptanceRunResult, VerificationEvidence, VerificationEvidenceProbeRecord, RfcVerificationEmitResult, } from "./types.ts";
+export { RFC_STATUSES, RFC_KINDS, RFC_SCOPES, RFC_DIR, RFC_TEMPLATE_FILE, RFC_ID_PATTERN, RFC_FULL_REQUIRED_SECTIONS, RFC_METADATA_CUTOFF, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/rfc/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,8BAA8B,EAC9B,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,gBAAgB,EAChB,WAAW,IAAI,cAAc,EAC7B,WAAW,IAAI,cAAc,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,OAAO,EACP,QAAQ,EACR,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,4BAA4B,EAC5B,mCAAmC,EACnC,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/os/rfc/index.js

@@ -0,0 +1,24 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the rfc domain — types, constants, module, and handlers.</purpose>
+<non-goals>
+  <item>Do not implement RFC logic here; delegate to handlers.js and rfc.module.js.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Backfilled complete Compass header (MODULE_MAP, CHANGE_SUMMARY) for compliance.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeRfcModule } from "./rfc.module.js";
+export { listRfcFiles, parseRfcFile, readAndParseRfc, rfcFileMatchesId, getRfcStatusById, loadRfcStatusMap, } from "./frontmatter-io.js";
+export { runRfcList, runRfcCreate, runRfcValidate, runRfcCommandLifecycleValidate, runRfcCheck, } from "./handlers.js";
+export { runRfcImplementStamp } from "./handlers/implement-stamp.js";
+export { runRfcAcceptanceRun, runProbe, validateAcceptanceShape } from "./acceptance.js";
+export { runRfcVerificationEmit, buildEvidenceEnvelope } from "./verification-evidence.js";
+export { runRfcDnaTraceValidate, runRfcDnaTraceGenerate, buildDnaTrace } from "./dna-trace.js";
+export { collectDecisionLog, scoreDecisions, runRfcDecisionLogGenerate } from "./decision-log.js";
+export { runRfcSupersedePropose } from "./handlers/supersede-propose.js";
+export { runRfcArchive } from "./handlers/archive.js";
+export { evaluateAcceptanceCriteria, extractAcceptanceCriteriaSection, } from "./handlers/validate-rules.js";
+export { RFC_STATUSES, RFC_KINDS, RFC_SCOPES, RFC_DIR, RFC_TEMPLATE_FILE, RFC_ID_PATTERN, RFC_FULL_REQUIRED_SECTIONS, RFC_METADATA_CUTOFF, } from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/rfc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,8BAA8B,EAC9B,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/F,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,GAEjC,MAAM,8BAA8B,CAAC;AAyCtC,OAAO,EACL,YAAY,EACZ,SAAS,EACT,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

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

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

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

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

package/dist/os/rfc/rfc.module.js

@@ -0,0 +1,355 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Facilitates the registration and execution of commands related to RFC management within the workspace.</purpose>
+<non-goals>
+  <item>Do not manage RFC storage or persistence mechanisms.</item>
+  <item>Do not handle user interface concerns or command-line parsing.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0260: declare typed `flags` schemas for the whole rfc.* command family; unknown/malformed flags now fail with KERNEL-FLAG-01/02/03 instead of being silently ignored.</item>
+  <item>Post-refactor hardening: expose `rfc.create --satisfies` for explicit DNA trace scaffolding.</item>
+</CHANGE_SUMMARY>
+*/
+export const forgeRfcModule = {
+    name: "rfc",
+    version: "0.1.0",
+    async register(registry) {
+        const { runRfcList, runRfcCreate, runRfcNextId, runRfcValidate, runRfcCommandLifecycleValidate, runRfcCheck, runRfcIndexGenerate, runRfcIndexValidate, runRfcGraph, } = await import("./handlers.js");
+        const { runRfcAcceptanceRun } = await import("./acceptance.js");
+        const { runRfcVerificationEmit } = await import("./verification-evidence.js");
+        const { runRfcDnaTraceValidate, runRfcDnaTraceGenerate } = await import("./dna-trace.js");
+        const { runRfcDecisionLogGenerate } = await import("./decision-log.js");
+        const { runRfcSupersedePropose } = await import("./handlers/supersede-propose.js");
+        const { runRfcArchive } = await import("./handlers/archive.js");
+        const { runRfcPipelineStatus } = await import("./handlers/pipeline-status.js");
+        const { runRfcImplementStamp } = await import("./handlers/implement-stamp.js");
+        // ── rfc.list ─────────────────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.list",
+            description: "List all RFCs. Filter with --status, --kind, --owner flags. " +
+                "Use --json for machine-readable output. " +
+                "Parses frontmatter on the fly — no index file needed.",
+            scope: "workspace",
+            // RFC-0260: typed flag schema.
+            flags: {
+                status: {
+                    kind: "string",
+                    description: "Filter by RFC status (e.g. draft, accepted, implemented).",
+                },
+                kind: {
+                    kind: "string",
+                    description: "Filter by RFC kind (e.g. architecture, contract, command).",
+                },
+                owner: { kind: "string", description: "Filter by an owner string." },
+            },
+            reads: ["docs/rfcs/**/*.md"],
+            execute: runRfcList,
+        });
+        // ── rfc.create ───────────────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.create",
+            description: "Create a new RFC draft from the template. " +
+                'Pass --title "Short title" (required). ' +
+                "Optional: --kind, --scope, --satisfies DNA-N,DNA-M. " +
+                "Always creates status: draft. " +
+                "AI agents are allowed to use this command.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/rfcs/RFC-*.md"],
+            reads: ["docs/rfcs/**/*.md"],
+            cacheable: false,
+            // RFC-0260: typed flag schema.
+            flags: {
+                title: { kind: "string", required: true, description: "Short imperative RFC title." },
+                kind: {
+                    kind: "string",
+                    default: "architecture",
+                    description: "RFC kind: architecture | contract | command | policy | deprecation.",
+                },
+                scope: { kind: "string", default: "workspace", description: "RFC scope: app | workspace." },
+                satisfies: {
+                    kind: "string",
+                    description: "Comma-separated DNA ids this RFC satisfies. Required for architecture/contract RFCs.",
+                },
+            },
+            execute: runRfcCreate,
+        });
+        // ── rfc.next-id ───────────────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.next-id",
+            description: "Return the next free RFC number (max existing + 1) by scanning docs/rfcs/ recursively including archive/.",
+            scope: "workspace",
+            flags: {},
+            reads: ["docs/rfcs/**/*.md"],
+            execute: runRfcNextId,
+        });
+        // ── rfc.validate ─────────────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.validate",
+            description: "Validate RFC frontmatter schema, required markdown sections, " +
+                "referential integrity (supersedes/supersededBy), date consistency, " +
+                "and RFC command lifecycle metadata (RFC-CMD-*). " +
+                "Pass an RFC id to validate a single file, or run without arguments for all.",
+            scope: "workspace",
+            // RFC-0260: no command-specific flags — only the positional RFC id and universal flags.
+            flags: {},
+            reads: ["docs/rfcs/**/*.md"],
+            execute: runRfcValidate,
+        });
+        // ── rfc.command-lifecycle.validate ───────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.command-lifecycle.validate",
+            description: "Validate RFC commands.proposed/added/changed/removed lifecycle metadata " +
+                "against live registered commands. Emits RFC-CMD-* diagnostics.",
+            scope: "workspace",
+            // RFC-0260: no command-specific flags — only the positional RFC id and universal flags.
+            flags: {},
+            reads: ["docs/rfcs/**/*.md"],
+            cacheable: false,
+            execute: runRfcCommandLifecycleValidate,
+        });
+        // ── rfc.check ────────────────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.check",
+            description: "Validate that artifacts declared by accepted/implemented RFCs exist on disk. " +
+                "Checks files from 'File system responsibilities' tables and feature flag references. " +
+                "Use --status to override which RFC statuses to check.",
+            scope: "workspace",
+            // RFC-0260: typed flag schema.
+            flags: {
+                status: {
+                    kind: "string[]",
+                    description: "Override which RFC statuses to check (default: accepted, implemented).",
+                },
+            },
+            reads: ["docs/rfcs/**/*.md"],
+            execute: runRfcCheck,
+        });
+        // ── rfc.index.generate ───────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.index.generate",
+            description: "Emit a machine-readable relationship index of all RFCs (id, status, dates, " +
+                "supersedes/supersededBy/amends/amendedBy/related). Use --json, or --write to " +
+                "persist docs/rfcs/index.yaml.",
+            scope: "workspace",
+            // RFC-0260: typed flag schema.
+            flags: {
+                write: {
+                    kind: "boolean",
+                    description: "Persist the generated index to docs/rfcs/index.yaml.",
+                },
+            },
+            reads: ["docs/rfcs/**/*.md"],
+            cacheable: false,
+            execute: runRfcIndexGenerate,
+        });
+        // ── rfc.index.validate ───────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.index.validate",
+            description: "Validate that docs/rfcs/index.yaml exists, is parseable, and its entry count " +
+                "matches the number of RFC files on disk. Reports RFC-IDX-01 (missing), " +
+                "RFC-IDX-02 (unparseable), RFC-IDX-03 (count mismatch).",
+            scope: "workspace",
+            flags: {},
+            reads: ["docs/rfcs/**/*.md", "docs/rfcs/index.yaml"],
+            execute: runRfcIndexValidate,
+        });
+        // ── rfc.graph ────────────────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.graph",
+            description: "Print one RFC's relationship neighbours (supersedes/supersededBy/amends/" +
+                "amendedBy/related). Pass the id: rfc.graph RFC-0152.",
+            scope: "workspace",
+            // RFC-0260: no command-specific flags — only the positional RFC id and universal flags.
+            flags: {},
+            reads: ["docs/rfcs/**/*.md"],
+            execute: runRfcGraph,
+        });
+        // ── rfc.acceptance.run ───────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.acceptance.run",
+            description: "RFC-0268: execute the acceptance: probes declared in an RFC's frontmatter and report " +
+                "pass/fail per probe (RFC-ACC-01 failed probe, RFC-ACC-02 accepted/implemented RFC with " +
+                "zero probes). Requires --id <rfc-id> or --status <status>; never runs automatically inside " +
+                "build pipelines.",
+            scope: "workspace",
+            flags: {
+                id: { kind: "string", description: "Target a single RFC by id (e.g. rfc-0268)." },
+                status: {
+                    kind: "string",
+                    description: "Target every RFC with this status (e.g. accepted).",
+                },
+            },
+            reads: ["docs/rfcs/**/*.md"],
+            cacheable: false,
+            execute: runRfcAcceptanceRun,
+        });
+        // ── rfc.verification.emit ────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.verification.emit",
+            description: "RFC-0330: execute acceptance probes for target RFC(s) and write per-RFC verification " +
+                "evidence artifacts to docs/rfcs/verification/*.generated.yaml. Requires --id <rfc-id> " +
+                "or --status <status>. Reuses runProbe from RFC-0268. Writes via writeFileAtomic.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/rfcs/verification/*.generated.yaml"],
+            reads: ["docs/rfcs/**/*.md"],
+            cacheable: false,
+            flags: {
+                id: { kind: "string", description: "Target a single RFC by id (e.g. rfc-0330)." },
+                status: {
+                    kind: "string",
+                    description: "Target every RFC with this status (e.g. implemented).",
+                },
+            },
+            execute: runRfcVerificationEmit,
+        });
+        // ── rfc.dna.trace.validate ───────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.dna.trace.validate",
+            description: "RFC-0331: validate the bidirectional DNA-trace matrix — which RFCs satisfy each DNA " +
+                "invariant and which invariants each RFC claims to satisfy. Reports DNA-TRACE-01 " +
+                "(nonexistent id), DNA-TRACE-02 (uncovered invariant), DNA-TRACE-03 (rejected claim).",
+            scope: "workspace",
+            flags: {
+                dna: {
+                    kind: "string",
+                    description: "Filter output to a single DNA invariant (e.g. DNA-35).",
+                },
+            },
+            reads: ["docs/rfcs/**/*.md", "docs/architecture-dna.md"],
+            execute: runRfcDnaTraceValidate,
+        });
+        // ── rfc.dna.trace.generate ───────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.dna.trace.generate",
+            description: "RFC-0331: generate docs/rfcs/dna-trace.generated.yaml — the machine-readable " +
+                "requirements-traceability matrix of DNA invariants and satisfying RFCs.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/rfcs/dna-trace.generated.yaml"],
+            reads: ["docs/rfcs/**/*.md", "docs/architecture-dna.md"],
+            cacheable: false,
+            flags: {},
+            execute: runRfcDnaTraceGenerate,
+        });
+        // ── rfc.decision-log.generate ────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.decision-log.generate",
+            description: "RFC-0329: generate docs/rfcs/decision-log.generated.yaml and .md aggregating every " +
+                "rejected/superseded RFC and every non-empty Alternatives considered section. " +
+                "Use --check to verify projections are up to date without writing.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/rfcs/decision-log.generated.yaml", "docs/rfcs/decision-log.generated.md"],
+            reads: ["docs/rfcs/**/*.md"],
+            cacheable: false,
+            flags: {
+                check: {
+                    kind: "boolean",
+                    description: "Drift check only — no writes, exit 1 if projections differ.",
+                },
+            },
+            execute: runRfcDecisionLogGenerate,
+        });
+        // ── rfc.supersede.propose ─────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.supersede.propose",
+            description: "RFC-0334: escalate a blocked implementation by creating a draft superseding RFC " +
+                "with the conflict stated and TODO sections for the proposed alternative.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/rfcs/RFC-*.md"],
+            reads: ["docs/rfcs/**/*.md"],
+            cacheable: false,
+            flags: {
+                id: {
+                    kind: "string",
+                    description: "Target RFC id to supersede (e.g. RFC-0322).",
+                },
+                reason: {
+                    kind: "string",
+                    description: "Why the accepted design is unimplementable.",
+                },
+                invariant: {
+                    kind: "string",
+                    description: "Comma-separated invariant ids (DNA-N or RFC-XXXX) that conflict.",
+                },
+                title: {
+                    kind: "string",
+                    description: "Optional replacement title for the new draft.",
+                },
+            },
+            execute: runRfcSupersedePropose,
+        });
+        // ── rfc.archive ───────────────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.archive",
+            description: "Move terminal-status RFC files (implemented, rejected, superseded) into " +
+                "docs/rfcs/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 RFCs.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/rfcs/*.md", "docs/rfcs/archive/**"],
+            reads: ["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: runRfcArchive,
+        });
+        // ── rfc.pipeline.status ──────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.pipeline.status",
+            description: "Report the pipeline status of RFCs — which steps (audit, enhance, plan, implement) " +
+                "are complete or missing. Pass an RFC id to check a single file, or run without " +
+                "arguments for all. Read-only — does not mutate files. Skills keep their own " +
+                "prerequisite checks; this command is for agents and humans to inspect pipeline state.",
+            scope: "workspace",
+            flags: {},
+            reads: ["docs/rfcs/**/*.md"],
+            execute: runRfcPipelineStatus,
+        });
+        // ── rfc.implement.stamp ──────────────────────────────────────────────────
+        registry.registerCommand({
+            name: "rfc.implement.stamp",
+            description: "RFC-0476: the exclusive atomic path for accepted → implemented transitions. " +
+                "Verifies preconditions (accepted status, checked+evidenced criteria, clean tree, " +
+                "reachable RFC-referencing commit, passing probe evidence) then atomically sets " +
+                "status: implemented, implementedAt, and updatedAt. Use --dry-run to preview.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/rfcs/**/*.md"],
+            reads: ["docs/rfcs/**/*.md", "docs/rfcs/verification/*.generated.yaml"],
+            cacheable: false,
+            flags: {
+                id: {
+                    kind: "string",
+                    required: true,
+                    description: "Target RFC id to stamp (e.g. RFC-0476).",
+                },
+                "implementation-commit": {
+                    kind: "string",
+                    required: true,
+                    description: "SHA of the implementation commit (must be reachable from HEAD and reference the RFC id).",
+                },
+                "dry-run": {
+                    kind: "boolean",
+                    description: "Perform all checks without mutating the RFC file or emitting evidence.",
+                },
+            },
+            execute: runRfcImplementStamp,
+        });
+    },
+};
+//# sourceMappingURL=rfc.module.js.map

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

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