@warpgogol/forge 5.3.4 → 6.2.0

package/dist/os/spec/live-spec-rebuild.js

@@ -0,0 +1,272 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.live.rebuild handler — regenerates a living spec by deterministic
+replay of its deduplicated history[] (RFC-1230). The repair path for duplicated
+namespaced sections and duplicate history entries produced before spec.live.merge
+became idempotent. Replaying each unique RFC's current ## Design in first-occurrence
+order yields the canonical spec; hand-applied edits are dropped by design.</purpose>
+<non-goals>
+  <item>Do not merge new RFCs — that is spec.live.merge.</item>
+  <item>Do not validate — spec.live.validate reports what rebuild must repair.</item>
+  <item>Do not delete spec files — empty-history or missing specs are skipped, never removed.</item>
+</non-goals>
+<CHANGE_SUMMARY>
+  <item>RFC-1230: initial spec.live.rebuild handler — dedupe history, single RFC scan, replay via shared section mechanics, unchanged-detection modulo updatedAt.</item>
+  <item>RFC-1230: review findings — scoped droppedSections to namespaced headings, warn on unreadable spec, fail-fast merge on corrupt frontmatter, CHANGE_SUMMARY dedupe</item>
+  <item>RFC-1231: step 1 — rename supportsAllSites to acceptsAllFlag
+
+Mechanical sweep: the field only ever gated --all argv acceptance; fan-out
+follows the parsed selector. Guard renamed assertAllSitesAllowed ->
+assertAllFlagAccepted, message updated. 417 declaration sites + type
+surfaces (KernelCommandMetadata, ForgeCommandMetadata) in one atomic pass.</item>
+  <item>RFC-1234: extracted projectLiveSpec — the pure projection core (dedupe history, replay Design sections, serialize modulo updatedAt) — consumable without writes or logging; spec.live.validate V-LS-09 reuses it so the validator sees exactly what rebuild would write.</item>
+</CHANGE_SUMMARY>
+*/
+import { ambientIo as fs } from "../../src/utils/io.js";
+import { existsSync } from "../../src/utils/sync-fs.js";
+import path from "node:path";
+import { writeFileIfChanged, buildGeneratedHeader } from "../../src/utils/index.js";
+import { listRfcFiles, readAndParseRfc, rfcFileMatchesId } from "../rfc/frontmatter-io.js";
+import { RFC_DIR } from "../rfc/types.js";
+import { LIVE_SPECS_DIR, extractDesignSection, parseHeadings, parseLivingSpec, serializeLivingSpec, applyDeltasToSpecBody, namespaceHeadings, seedSpecPrefix, } from "./live-spec-shared.js";
+export async function projectLiveSpec(specFilePath, domain, rfcFiles, rfcDirPath) {
+    const content = await fs.readFile(specFilePath).catch(() => null);
+    if (content === null)
+        return { kind: "unreadable" };
+    const spec = parseLivingSpec(content);
+    if (!spec)
+        return { kind: "invalid-frontmatter" };
+    if (spec.history.length === 0)
+        return { kind: "empty-history" };
+    const uniqueIds = [];
+    const normalizedHistory = [];
+    for (const entry of spec.history) {
+        if (!entry?.rfc || uniqueIds.includes(entry.rfc))
+            continue;
+        uniqueIds.push(entry.rfc);
+        normalizedHistory.push(entry);
+    }
+    // Count only namespaced duplicates — the metric is "duplicate (RFC-XXXX)
+    // sections removed"; non-namespaced heading repeats are out of contract.
+    const existingHeadings = parseHeadings(spec.body);
+    const seenTexts = new Set();
+    let droppedSections = 0;
+    for (const h of existingHeadings) {
+        if (!/\(RFC-\d{4}\)$/.test(h.text))
+            continue;
+        if (seenTexts.has(h.text))
+            droppedSections++;
+        else
+            seenTexts.add(h.text);
+    }
+    const header = buildGeneratedHeader({
+        filePath: specFilePath,
+        ownerCommand: "spec.live.merge",
+        commandPrefix: "pnpm exec werkstatt run",
+    });
+    // trimEnd so applyDeltas' own "\n\n" separator reproduces the creation path's
+    // `seed + designSection` layout exactly — otherwise rebuild inserts an extra
+    // blank line after "## Overview" and unchanged-detection never fires.
+    let body = seedSpecPrefix(domain, header).trimEnd();
+    const unreadableRfcs = [];
+    for (const rfcId of uniqueIds) {
+        const file = rfcFiles.find((f) => rfcFileMatchesId(f, rfcId));
+        const parsedResult = file
+            ? await readAndParseRfc(rfcDirPath, file)
+            : undefined;
+        const fm = parsedResult && "parsed" in parsedResult ? parsedResult.parsed.frontmatter : undefined;
+        const status = fm ? String(fm["status"] ?? "").trim() : "";
+        const design = parsedResult && "parsed" in parsedResult
+            ? extractDesignSection(parsedResult.parsed.body)
+            : "";
+        if (!fm || status !== "implemented" || !design) {
+            unreadableRfcs.push(rfcId);
+            continue;
+        }
+        const namespaced = namespaceHeadings(design, rfcId);
+        const headings = parseHeadings(namespaced);
+        const ops = headings.map((h) => ({
+            type: "added",
+            heading: h.text,
+            rfc: rfcId,
+        }));
+        body = applyDeltasToSpecBody(body, headings, ops);
+    }
+    const regenerated = {
+        ...spec,
+        lastMergedRfc: uniqueIds[uniqueIds.length - 1],
+        history: normalizedHistory,
+        body: body.trim(),
+    };
+    // Compare modulo updatedAt — a clean spec rebuilt on another day must still
+    // report unchanged, otherwise every rebuild produces a one-line date diff.
+    const projection = serializeLivingSpec({ ...regenerated, updatedAt: spec.updatedAt });
+    return {
+        kind: "projected",
+        spec,
+        content,
+        projection,
+        regenerated,
+        uniqueIds,
+        unreadableRfcs,
+        droppedSections,
+    };
+}
+async function rebuildOneSpec(specFilePath, domain, rfcFiles, rfcDirPath, today, dryRun, context) {
+    const { logger } = context;
+    const base = {
+        command: "spec.live.rebuild",
+        domain,
+        operation: "skipped",
+        uniqueRfcs: 0,
+        droppedHistoryEntries: 0,
+        droppedSections: 0,
+        unreadableRfcs: [],
+        dryRun,
+    };
+    const proj = await projectLiveSpec(specFilePath, domain, rfcFiles, rfcDirPath);
+    if (proj.kind === "unreadable") {
+        logger.warn(`spec.live.rebuild: ${domain} unreadable at ${specFilePath} — skipping`);
+        return { result: base, exitCode: 1 };
+    }
+    if (proj.kind === "invalid-frontmatter") {
+        logger.warn(`spec.live.rebuild: ${domain} has no valid frontmatter — skipping`);
+        return { result: base, exitCode: 1 };
+    }
+    if (proj.kind === "empty-history") {
+        return { result: base, exitCode: 0 };
+    }
+    for (const rfcId of proj.unreadableRfcs) {
+        logger.warn(`spec.live.rebuild: ${rfcId} unreadable, not implemented, or lacks ## Design — skipping`);
+    }
+    const replayed = proj.uniqueIds.length - proj.unreadableRfcs.length;
+    if (replayed === 0) {
+        return {
+            result: {
+                ...base,
+                operation: "skipped",
+                uniqueRfcs: proj.uniqueIds.length,
+                unreadableRfcs: proj.unreadableRfcs,
+            },
+            exitCode: 2,
+        };
+    }
+    const droppedHistoryEntries = proj.spec.history.length - proj.regenerated.history.length;
+    if (proj.projection === proj.content) {
+        return {
+            result: {
+                ...base,
+                operation: "unchanged",
+                uniqueRfcs: proj.uniqueIds.length,
+                droppedHistoryEntries,
+                droppedSections: proj.droppedSections,
+                unreadableRfcs: proj.unreadableRfcs,
+            },
+            exitCode: 0,
+        };
+    }
+    const finalSpec = serializeLivingSpec({ ...proj.regenerated, updatedAt: today });
+    if (!dryRun) {
+        await writeFileIfChanged(specFilePath, finalSpec);
+    }
+    return {
+        result: {
+            ...base,
+            operation: "rebuilt",
+            uniqueRfcs: proj.uniqueIds.length,
+            droppedHistoryEntries,
+            droppedSections: proj.droppedSections,
+            unreadableRfcs: proj.unreadableRfcs,
+        },
+        exitCode: 0,
+    };
+}
+export async function runSpecLiveRebuild(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const domain = String(input.flags["domain"] ?? "");
+    const dryRun = context.dryRun || input.flags["dry-run"] === true;
+    // The kernel consumes `--all` as its own site-selector before argv reaches
+    // the command (acceptsAllFlag: true lets it through). Under `werkstatt run`
+    // the flag never lands in input.flags — so "no --domain" IS the kernel-level
+    // --all signal. The explicit flag still works via the standalone forge CLI.
+    const explicitAll = input.flags["all"] === true;
+    if (domain && explicitAll) {
+        return {
+            data: {
+                command: "spec.live.rebuild",
+                domains: [],
+                dryRun,
+            },
+            exitCode: 1,
+            summary: "spec.live.rebuild: --domain and --all are mutually exclusive",
+        };
+    }
+    const all = explicitAll || !domain;
+    const liveSpecsDir = path.join(workspaceRoot, LIVE_SPECS_DIR);
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const today = new Date().toISOString().slice(0, 10);
+    const specPaths = [];
+    if (all) {
+        if (existsSync(liveSpecsDir)) {
+            const files = (await fs.readdir(liveSpecsDir)).map((e) => e.name);
+            for (const f of files.filter((f) => f.endsWith(".md") && f !== "README.md").sort()) {
+                specPaths.push({ domain: f.slice(0, -3), filePath: path.join(liveSpecsDir, f) });
+            }
+        }
+    }
+    else {
+        const filePath = path.join(liveSpecsDir, `${domain}.md`);
+        if (!existsSync(filePath)) {
+            return {
+                data: {
+                    command: "spec.live.rebuild",
+                    domains: [],
+                    dryRun,
+                },
+                exitCode: 1,
+                summary: `spec.live.rebuild: living spec not found for domain "${domain}" (${LIVE_SPECS_DIR}/${domain}.md)`,
+            };
+        }
+        specPaths.push({ domain, filePath });
+    }
+    if (specPaths.length === 0) {
+        return {
+            data: { command: "spec.live.rebuild", domains: [], dryRun },
+            exitCode: 0,
+            summary: "spec.live.rebuild: no living specs found",
+        };
+    }
+    // Single recursive RFC scan reused for every spec — a corrupted spec can carry
+    // ~170 history entries, and a per-id listRfcFiles rescan is O(n²).
+    const rfcFiles = await listRfcFiles(rfcDirPath);
+    const results = [];
+    let worstExit = 0;
+    for (const { domain: d, filePath } of specPaths) {
+        const { result, exitCode } = await rebuildOneSpec(filePath, d, rfcFiles, rfcDirPath, today, dryRun, context);
+        results.push(result);
+        if (exitCode > worstExit)
+            worstExit = exitCode;
+        if (outputFormat === "pretty") {
+            const suffix = dryRun ? " [dry-run]" : "";
+            if (result.operation === "rebuilt") {
+                logger.success(`spec.live.rebuild: ${d} rebuilt — ${result.uniqueRfcs} unique RFC(s), dropped ${result.droppedHistoryEntries} history entr(ies), ${result.droppedSections} duplicate section(s)${suffix}`);
+            }
+            else {
+                logger.info(`spec.live.rebuild: ${d} — ${result.operation}${suffix}`);
+            }
+        }
+    }
+    if (!all) {
+        return {
+            data: results[0],
+            exitCode: worstExit,
+            summary: `spec.live.rebuild: ${domain} — ${results[0].operation}`,
+        };
+    }
+    return {
+        data: { command: "spec.live.rebuild", domains: results, dryRun },
+        exitCode: worstExit,
+        summary: `spec.live.rebuild: ${results.length} spec(s) processed${dryRun ? " [dry-run]" : ""}`,
+    };
+}
+//# sourceMappingURL=live-spec-rebuild.js.map

package/dist/os/spec/live-spec-rebuild.js.map

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

package/dist/os/spec/live-spec-shared.d.ts

@@ -0,0 +1,62 @@
+import type { LivingSpec, DeltaOperation } from "./live-spec-types.ts";
+export declare const LIVE_SPECS_DIR = "docs/specs/live";
+export interface ParsedHeading {
+    level: number;
+    text: string;
+    body: string;
+}
+export declare function extractDesignSection(rfcBody: string): string;
+export declare function parseHeadings(content: string): ParsedHeading[];
+export declare function deriveDomain(frontmatter: Record<string, unknown>): string | null;
+export declare function parseLivingSpec(content: string): LivingSpec | null;
+export declare function serializeLivingSpec(spec: LivingSpec): string;
+export declare function findHeadingInSpec(spec: LivingSpec, headingText: string): ParsedHeading | null;
+export declare function applyDeltasToSpecBody(specBody: string, deltas: ParsedHeading[], operations: DeltaOperation[]): string;
+export declare function escapeRegex(str: string): string;
+export declare function namespaceHeadings(content: string, rfcId: string): string;
+export declare function removeNamespacedSections(body: string, rfcId: string): string;
+export declare function findRfcFile(rfcDir: string, rfcId: string): Promise<string | null>;
+export declare function seedSpecPrefix(domain: string, generatedHeader: string): string;
+export interface LiveMergeTargetSelection {
+    candidates: string[];
+    rejected: string[];
+}
+export declare function collectLiveMergeTargets(moved: ReadonlyArray<{
+    id: string;
+    status: string;
+    direction: string;
+}>): LiveMergeTargetSelection;
+export interface LiveMergeEntry {
+    id: string;
+    domain: string;
+    operation: string;
+    conflicts: number;
+}
+export interface LiveMergeFailure {
+    id: string;
+    exitCode?: number;
+    error: string;
+}
+export type LiveMergeOutcome = {
+    kind: "merged";
+    entry: LiveMergeEntry;
+} | {
+    kind: "failed";
+    entry: LiveMergeFailure;
+};
+export declare function classifyLiveMergeOutcome(rfcId: string, result: {
+    exitCode?: number;
+    data?: unknown;
+    summary?: string;
+}): LiveMergeOutcome;
+export declare function liveMergeFailureEntry(rfcId: string, error: unknown): LiveMergeFailure;
+export declare function formatLiveMergeFailure(entry: LiveMergeFailure): string;
+/** Emission gate + block assembly for results["spec.live.merge"] — undefined
+ * when nothing was attempted, so an all-failed run still surfaces. */
+export declare function buildLiveMergeBlock(merged: LiveMergeEntry[], failed: LiveMergeFailure[], skipped: number, dryRun: boolean): {
+    merged: LiveMergeEntry[];
+    failed: LiveMergeFailure[];
+    skipped: number;
+    dryRun: boolean;
+} | undefined;
+//# sourceMappingURL=live-spec-shared.d.ts.map

package/dist/os/spec/live-spec-shared.d.ts.map

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

package/dist/os/spec/live-spec-shared.js

@@ -0,0 +1,315 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Shared pure helpers for living feature specs — heading parsing, RFC-namespaced
+section mechanics, spec (de)serialization, domain derivation, and the docs.archive
+this-run merge-target selection (RFC-0711, RFC-0957, RFC-1230).</purpose>
+<non-goals>
+  <item>Do not implement command handlers — spec.live.merge/validate/rebuild handlers live in their own files.</item>
+  <item>Do not touch the filesystem — these helpers are pure; IO stays in handlers.</item>
+</non-goals>
+<CHANGE_SUMMARY>
+  <item>RFC-1230: extracted shared helpers from live-spec-merge.ts; added removeNamespacedSections, seedSpecPrefix, and collectLiveMergeTargets for the idempotent-merge + rebuild design.</item>
+  <item>RFC-1230: review findings — scoped droppedSections to namespaced headings, warn on unreadable spec, fail-fast merge on corrupt frontmatter, CHANGE_SUMMARY dedupe</item>
+  <item>RFC-1232: fence-aware heading mechanics — private fencedLineIndexes (CommonMark-subset ``` / ~~~ map) consumed by parseHeadings, extractDesignSection, namespaceHeadings, removeNamespacedSections, and applyDeltasToSpecBody (regex lookaheads replaced with line-slice boundaries).</item>
+  <item>RFC-1235: extracted docs.archive merge-outcome accounting — classifyLiveMergeOutcome, liveMergeFailureEntry, formatLiveMergeFailure, buildLiveMergeBlock — so exit-nonzero merges record to failed[] instead of merged[].</item>
+</CHANGE_SUMMARY>
+*/
+import path from "node:path";
+import YAML from "yaml";
+import { listRfcFiles } from "../rfc/frontmatter-io.js";
+export const LIVE_SPECS_DIR = "docs/specs/live";
+// RFC-1232: CommonMark-subset fence map — line indexes inside fenced code
+// blocks. A run of ` or ~ of length >=3 with <=3 leading spaces opens a fence;
+// the same-or-longer run of the same character closes it. Opener and closer
+// lines count as interior. An unterminated fence makes the rest of the input
+// interior (CommonMark behavior). Indented code blocks are out of scope.
+const FENCE_OPEN_REGEX = /^ {0,3}(`{3,}|~{3,})/;
+// CommonMark: a closing fence carries no info string — only trailing
+// whitespace. A same-char run followed by text is interior content, so the
+// map over-masks rather than exposing a would-be heading (safe direction).
+// CRLF note: `[ \t]*$` deliberately excludes \r, so a CRLF closer never
+// matches and the tail stays interior — over-masking is the safe direction
+// and repo content is LF-normalized.
+const FENCE_CLOSE_REGEX = /^ {0,3}(`{3,}|~{3,})[ \t]*$/;
+function fencedLineIndexes(lines) {
+    const inside = new Set();
+    let fenceChar = null;
+    let fenceLength = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const match = lines[i].match(FENCE_OPEN_REGEX);
+        if (fenceChar === null) {
+            if (match) {
+                fenceChar = match[1][0];
+                fenceLength = match[1].length;
+                inside.add(i);
+            }
+            continue;
+        }
+        inside.add(i);
+        const closeMatch = lines[i].match(FENCE_CLOSE_REGEX);
+        if (closeMatch && closeMatch[1][0] === fenceChar && closeMatch[1].length >= fenceLength) {
+            fenceChar = null;
+            fenceLength = 0;
+        }
+    }
+    return inside;
+}
+export function extractDesignSection(rfcBody) {
+    const lines = rfcBody.split("\n");
+    const fenced = fencedLineIndexes(lines);
+    let startLine = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (!fenced.has(i) && /^##\s+Design\s*$/.test(lines[i])) {
+            startLine = i;
+            break;
+        }
+    }
+    if (startLine === -1)
+        return "";
+    let endLine = lines.length;
+    for (let i = startLine + 1; i < lines.length; i++) {
+        if (!fenced.has(i) && /^##\s/.test(lines[i])) {
+            endLine = i;
+            break;
+        }
+    }
+    return lines.slice(startLine + 1, endLine).join("\n").trim();
+}
+export function parseHeadings(content) {
+    const lines = content.split("\n");
+    const fenced = fencedLineIndexes(lines);
+    const headings = [];
+    let currentHeading = null;
+    let currentBody = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const headingMatch = fenced.has(i) ? null : line.match(/^(#{3,})\s+(.+)$/);
+        if (headingMatch) {
+            if (currentHeading) {
+                currentHeading.body = currentBody.join("\n").trim();
+                headings.push(currentHeading);
+            }
+            currentHeading = {
+                level: headingMatch[1].length,
+                text: headingMatch[2].trim(),
+                body: "",
+            };
+            currentBody = [];
+        }
+        else if (currentHeading) {
+            currentBody.push(line);
+        }
+    }
+    if (currentHeading) {
+        currentHeading.body = currentBody.join("\n").trim();
+        headings.push(currentHeading);
+    }
+    return headings;
+}
+export function deriveDomain(frontmatter) {
+    const liveSpec = frontmatter["liveSpec"];
+    if (typeof liveSpec === "string" && liveSpec.length > 0) {
+        return liveSpec;
+    }
+    if (liveSpec === true) {
+        const packagesImpacted = frontmatter["packagesImpacted"];
+        if (Array.isArray(packagesImpacted) && packagesImpacted.length > 0) {
+            const firstPkg = String(packagesImpacted[0]);
+            return firstPkg.replace(/^packages\//, "").replace(/^@[^/]+\//, "");
+        }
+        return null;
+    }
+    return null;
+}
+export function parseLivingSpec(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return null;
+    const fm = (YAML.parse(match[1]) ?? {});
+    return {
+        domain: String(fm["domain"] ?? ""),
+        title: String(fm["title"] ?? ""),
+        lastMergedRfc: String(fm["lastMergedRfc"] ?? ""),
+        updatedAt: String(fm["updatedAt"] ?? ""),
+        createdAt: String(fm["createdAt"] ?? ""),
+        history: (Array.isArray(fm["history"]) ? fm["history"] : []),
+        body: match[2] ?? "",
+    };
+}
+export function serializeLivingSpec(spec) {
+    const fm = {
+        domain: spec.domain,
+        title: spec.title,
+        lastMergedRfc: spec.lastMergedRfc,
+        updatedAt: spec.updatedAt,
+        createdAt: spec.createdAt,
+        history: spec.history,
+    };
+    const fmStr = YAML.stringify(fm).trimEnd();
+    return `---\n${fmStr}\n---\n\n${spec.body}`;
+}
+export function findHeadingInSpec(spec, headingText) {
+    const headings = parseHeadings(spec.body);
+    return headings.find((h) => h.text === headingText) ?? null;
+}
+export function applyDeltasToSpecBody(specBody, deltas, operations) {
+    const lines = specBody.split("\n");
+    for (const delta of deltas) {
+        const op = operations.find((o) => o.heading === delta.text);
+        if (!op)
+            continue;
+        if (op.type === "added") {
+            lines.push("", `${"#".repeat(delta.level)} ${delta.text}`, "", ...delta.body.split("\n"));
+            continue;
+        }
+        // RFC-1232: line-slice boundaries instead of `(?=#{3,}|$)` regex lookaheads —
+        // those were unanchored and matched `###` inside fenced code blocks.
+        const fenced = fencedLineIndexes(lines);
+        let start = -1;
+        let next = lines.length;
+        for (let i = 0; i < lines.length; i++) {
+            if (fenced.has(i))
+                continue;
+            const m = lines[i].match(/^(#{3,})\s+(.+)$/);
+            if (!m)
+                continue;
+            if (start === -1) {
+                if (m[1].length === delta.level && m[2].trim() === delta.text)
+                    start = i;
+            }
+            else {
+                next = i;
+                break;
+            }
+        }
+        if (start === -1)
+            continue;
+        if (op.type === "modified") {
+            lines.splice(start + 1, next - start - 1, "", ...delta.body.split("\n"));
+        }
+        else {
+            // removed — absorb the blank lines separating the heading from the
+            // preceding content (old `\n*` regex prefix), then collapse the section
+            // to a single empty line.
+            let removeFrom = start;
+            while (removeFrom > 0 && lines[removeFrom - 1].trim() === "")
+                removeFrom--;
+            lines.splice(removeFrom, next - removeFrom, "");
+        }
+    }
+    return lines.join("\n").trim();
+}
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function namespaceHeadings(content, rfcId) {
+    const lines = content.split("\n");
+    const fenced = fencedLineIndexes(lines);
+    return lines
+        .map((line, i) => {
+        if (fenced.has(i))
+            return line;
+        const m = line.match(/^(#{3,})\s+(.+)$/);
+        if (!m)
+            return line;
+        // parseHeadings trims heading text — normalize here too so a heading like
+        // "### Foo " round-trips to "### Foo (RFC-XXXX)", not "### Foo  (RFC-XXXX)".
+        const normalized = m[2].trim();
+        if (/\(RFC-\d{4}\)$/.test(normalized))
+            return `${m[1]} ${normalized}`;
+        return `${m[1]} ${normalized} (${rfcId})`;
+    })
+        .join("\n");
+}
+// RFC-1230: strip every ###+ section whose heading carries the ` (RFC-XXXX)`
+// marker. Line-based and byte-preserving for kept sections — parseHeadings is
+// lossy on whitespace, so surgical replacement filters lines instead.
+export function removeNamespacedSections(body, rfcId) {
+    const suffix = ` (${rfcId})`;
+    const lines = body.split("\n");
+    const fenced = fencedLineIndexes(lines);
+    const out = [];
+    let skipping = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const headingMatch = fenced.has(i) ? null : line.match(/^(#{3,})\s+(.+)$/);
+        if (headingMatch) {
+            skipping = headingMatch[2].trim().endsWith(suffix);
+        }
+        if (!skipping)
+            out.push(line);
+    }
+    return out.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+export function findRfcFile(rfcDir, rfcId) {
+    return (async () => {
+        const files = await listRfcFiles(rfcDir);
+        for (const file of files) {
+            const basename = path.basename(file);
+            if (basename.toLowerCase().startsWith(rfcId.toLowerCase())) {
+                return file;
+            }
+        }
+        return null;
+    })();
+}
+// Canonical spec seed — identical to what the spec.live.merge creation path
+// emits, so rebuild and first-merge produce the same skeleton.
+export function seedSpecPrefix(domain, generatedHeader) {
+    return `${generatedHeader}# Living Spec: ${domain}\n\n## Overview\n\n`;
+}
+// RFC-1230: the docs.archive post-loop merges only RFCs moved this run — the
+// selection derives from rfc.archive's `moved` result, not a rescan of the
+// whole docs/rfcs tree (which is what caused the duplicate-merge corruption).
+export function collectLiveMergeTargets(moved) {
+    const candidates = [];
+    const rejected = [];
+    for (const m of moved) {
+        if (m.direction !== "into-archive")
+            continue;
+        if (m.status === "implemented")
+            candidates.push(m.id);
+        else if (m.status === "rejected")
+            rejected.push(m.id);
+    }
+    return { candidates, rejected };
+}
+export function classifyLiveMergeOutcome(rfcId, result) {
+    const data = result.data;
+    if (result.exitCode === 0 && data) {
+        return {
+            kind: "merged",
+            entry: {
+                id: rfcId,
+                domain: String(data.domain ?? ""),
+                operation: String(data.operation ?? ""),
+                conflicts: Array.isArray(data.conflicts) ? data.conflicts.length : 0,
+            },
+        };
+    }
+    return {
+        kind: "failed",
+        entry: {
+            id: rfcId,
+            exitCode: result.exitCode,
+            error: result.summary ??
+                (result.exitCode === undefined
+                    ? "spec.live.merge returned no exit code"
+                    : `spec.live.merge exited ${result.exitCode}`),
+        },
+    };
+}
+export function liveMergeFailureEntry(rfcId, error) {
+    return { id: rfcId, error: String(error instanceof Error ? error.message : error) };
+}
+export function formatLiveMergeFailure(entry) {
+    return `spec.live.merge: failed for ${entry.id}: ${entry.error}`;
+}
+/** Emission gate + block assembly for results["spec.live.merge"] — undefined
+ * when nothing was attempted, so an all-failed run still surfaces. */
+export function buildLiveMergeBlock(merged, failed, skipped, dryRun) {
+    if (merged.length === 0 && failed.length === 0 && skipped === 0)
+        return undefined;
+    return { merged, failed, skipped, dryRun };
+}
+//# sourceMappingURL=live-spec-shared.js.map