@warpgogol/forge 0.22.0 → 0.24.0

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

@@ -0,0 +1,345 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.live.merge handler — extracts deltas from an RFC's ## Design section,
+classifies them as ADDED/MODIFIED/REMOVED, applies to a living spec, handles conflicts
+with all-or-nothing semantics, and writes atomically (RFC-0711).</purpose>
+<non-goals>
+  <item>Do not handle docs.archive integration — that is in core.module.ts.</item>
+  <item>Do not validate living specs — that is spec.live.validate.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0711: initial spec.live.merge handler with delta extraction, classification, conflict detection, and atomic writes.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { writeFileIfChanged, buildGeneratedHeader } from "../../src/utils/index.js";
+import { parseRfcFile, listRfcFiles } from "../rfc/frontmatter-io.js";
+import { RFC_DIR } from "../rfc/types.js";
+const LIVE_SPECS_DIR = "docs/specs/live";
+function extractDesignSection(rfcBody) {
+    const designMatch = rfcBody.match(/^##\s+Design\s*$/m);
+    if (!designMatch)
+        return "";
+    const startIndex = designMatch.index + designMatch[0].length;
+    const nextH2Match = rfcBody.slice(startIndex).match(/^##\s+/m);
+    if (!nextH2Match) {
+        return rfcBody.slice(startIndex).trim();
+    }
+    return rfcBody.slice(startIndex, startIndex + nextH2Match.index).trim();
+}
+function parseHeadings(content) {
+    const lines = content.split("\n");
+    const headings = [];
+    let currentHeading = null;
+    let currentBody = [];
+    for (const line of lines) {
+        const headingMatch = 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;
+}
+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\//, "");
+        }
+        return null;
+    }
+    return null;
+}
+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] ?? "",
+    };
+}
+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}`;
+}
+function findHeadingInSpec(spec, headingText) {
+    const headings = parseHeadings(spec.body);
+    return headings.find((h) => h.text === headingText) ?? null;
+}
+function applyDeltasToSpecBody(specBody, deltas, operations) {
+    let body = specBody;
+    for (const delta of deltas) {
+        const op = operations.find((o) => o.heading === delta.text);
+        if (!op)
+            continue;
+        if (op.type === "added") {
+            body = `${body}\n\n${"#".repeat(delta.level)} ${delta.text}\n\n${delta.body}`;
+        }
+        else if (op.type === "modified") {
+            const headingRegex = new RegExp(`(${"#".repeat(delta.level)}\\s+${escapeRegex(delta.text)}\\s*\\n)([\\s\\S]*?)(?=#{3,}|$)`);
+            body = body.replace(headingRegex, `$1\n${delta.body}\n`);
+        }
+        else if (op.type === "removed") {
+            const headingRegex = new RegExp(`\\n*${"#".repeat(delta.level)}\\s+${escapeRegex(delta.text)}\\s*\\n[\\s\\S]*?(?=#{3,}|$)`);
+            body = body.replace(headingRegex, "\n");
+        }
+    }
+    return body.trim();
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+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;
+    })();
+}
+export async function runSpecLiveMerge(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcId = String(input.flags["id"] ?? "");
+    const dryRun = context.dryRun || input.flags["dry-run"] === true;
+    if (!rfcId) {
+        return {
+            data: {
+                command: "spec.live.merge",
+                domain: "",
+                operation: "modified",
+                deltas: [],
+                conflicts: [],
+                dryRun,
+            },
+            exitCode: 1,
+            summary: "spec.live.merge: --id flag is required",
+        };
+    }
+    const rfcDir = path.join(workspaceRoot, RFC_DIR);
+    const rfcFile = await findRfcFile(rfcDir, rfcId);
+    if (!rfcFile) {
+        return {
+            data: {
+                command: "spec.live.merge",
+                domain: "",
+                operation: "modified",
+                deltas: [],
+                conflicts: [],
+                dryRun,
+            },
+            exitCode: 1,
+            summary: `spec.live.merge: RFC ${rfcId} not found in ${RFC_DIR}`,
+        };
+    }
+    const rfcContent = await fs.readFile(path.join(rfcDir, rfcFile), "utf-8");
+    const parsed = parseRfcFile(rfcContent);
+    const fm = parsed.frontmatter;
+    const status = String(fm["status"] ?? "").trim();
+    if (status !== "implemented") {
+        return {
+            data: {
+                command: "spec.live.merge",
+                domain: "",
+                operation: "modified",
+                deltas: [],
+                conflicts: [],
+                dryRun,
+            },
+            exitCode: 1,
+            summary: `spec.live.merge: RFC ${rfcId} has status "${status}", must be "implemented"`,
+        };
+    }
+    const domain = deriveDomain(fm);
+    if (!domain) {
+        return {
+            data: {
+                command: "spec.live.merge",
+                domain: "",
+                operation: "modified",
+                deltas: [],
+                conflicts: [],
+                dryRun,
+            },
+            exitCode: 0,
+            summary: `spec.live.merge: RFC ${rfcId} has no liveSpec field — skipping (no-op)`,
+        };
+    }
+    const designSection = extractDesignSection(parsed.body);
+    if (!designSection) {
+        return {
+            data: {
+                command: "spec.live.merge",
+                domain,
+                operation: "modified",
+                deltas: [],
+                conflicts: [],
+                dryRun,
+            },
+            exitCode: 0,
+            summary: `spec.live.merge: RFC ${rfcId} has no ## Design section — skipping (no-op)`,
+        };
+    }
+    const rfcHeadings = parseHeadings(designSection);
+    const liveSpecsDir = path.join(workspaceRoot, LIVE_SPECS_DIR);
+    const specFilePath = path.join(liveSpecsDir, `${domain}.md`);
+    let existingSpec = null;
+    if (existsSync(specFilePath)) {
+        const specContent = await fs.readFile(specFilePath, "utf-8");
+        existingSpec = parseLivingSpec(specContent);
+    }
+    const operations = [];
+    const conflicts = [];
+    const today = new Date().toISOString().slice(0, 10);
+    if (!existingSpec) {
+        for (const heading of rfcHeadings) {
+            operations.push({ type: "added", heading: heading.text, rfc: rfcId });
+        }
+        const header = buildGeneratedHeader({
+            filePath: specFilePath,
+            ownerCommand: "spec.live.merge",
+            commandPrefix: "pnpm exec site-kernel run",
+        });
+        const newSpec = {
+            domain,
+            title: `Living Spec: ${domain}`,
+            lastMergedRfc: rfcId,
+            updatedAt: today,
+            createdAt: today,
+            history: [{ rfc: rfcId, mergedAt: today, operation: "created" }],
+            body: `${header}# Living Spec: ${domain}\n\n## Overview\n\n${designSection}`,
+        };
+        if (!dryRun) {
+            await fs.mkdir(liveSpecsDir, { recursive: true });
+            await writeFileIfChanged(specFilePath, serializeLivingSpec(newSpec));
+        }
+        const result = {
+            command: "spec.live.merge",
+            domain,
+            operation: "created",
+            deltas: operations,
+            conflicts: [],
+            dryRun,
+        };
+        if (outputFormat === "pretty") {
+            logger.success(`spec.live.merge: created living spec for domain "${domain}" from ${rfcId} (${operations.length} deltas)${dryRun ? " [dry-run]" : ""}`);
+        }
+        return { data: result, exitCode: 0, summary: `spec.live.merge: created ${domain} from ${rfcId}` };
+    }
+    for (const heading of rfcHeadings) {
+        const existing = findHeadingInSpec(existingSpec, heading.text);
+        if (existing) {
+            let lastRfc;
+            for (let i = existingSpec.history.length - 1; i >= 0; i--) {
+                const entry = existingSpec.history[i];
+                if (entry.operation !== "removed") {
+                    lastRfc = entry.rfc;
+                    break;
+                }
+            }
+            if (lastRfc && lastRfc !== rfcId) {
+                conflicts.push({
+                    heading: heading.text,
+                    existingRfc: lastRfc,
+                    newRfc: rfcId,
+                    resolution: "pending",
+                });
+            }
+            operations.push({ type: "modified", heading: heading.text, rfc: rfcId });
+        }
+        else {
+            operations.push({ type: "added", heading: heading.text, rfc: rfcId });
+        }
+    }
+    if (conflicts.length > 0) {
+        const result = {
+            command: "spec.live.merge",
+            domain,
+            operation: "modified",
+            deltas: operations,
+            conflicts,
+            dryRun,
+        };
+        if (outputFormat === "pretty") {
+            logger.error(`spec.live.merge: ${conflicts.length} conflict(s) detected — merge aborted (all-or-nothing)`);
+            for (const c of conflicts) {
+                logger.error(`  conflict: heading "${c.heading}" last modified by ${c.existingRfc}, now ${c.newRfc}`);
+            }
+        }
+        return {
+            data: result,
+            exitCode: 1,
+            summary: `spec.live.merge: ${conflicts.length} conflict(s) — merge aborted`,
+        };
+    }
+    const updatedBody = applyDeltasToSpecBody(existingSpec.body, rfcHeadings, operations);
+    const updatedSpec = {
+        ...existingSpec,
+        lastMergedRfc: rfcId,
+        updatedAt: today,
+        history: [
+            ...existingSpec.history,
+            { rfc: rfcId, mergedAt: today, operation: "modified" },
+        ],
+        body: updatedBody,
+    };
+    if (!dryRun) {
+        await writeFileIfChanged(specFilePath, serializeLivingSpec(updatedSpec));
+    }
+    const result = {
+        command: "spec.live.merge",
+        domain,
+        operation: "modified",
+        deltas: operations,
+        conflicts: [],
+        dryRun,
+    };
+    if (outputFormat === "pretty") {
+        logger.success(`spec.live.merge: modified living spec for domain "${domain}" from ${rfcId} (${operations.length} deltas)${dryRun ? " [dry-run]" : ""}`);
+    }
+    return { data: result, exitCode: 0, summary: `spec.live.merge: modified ${domain} from ${rfcId}` };
+}
+//# sourceMappingURL=live-spec-merge.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-spec-show.d.ts","sourceRoot":"","sources":["../../../os/spec/live-spec-show.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,sBAAsB,CAAC;AAIvF,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAwFjD"}

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

@@ -0,0 +1,99 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.live.show handler — reads and returns a single living spec by domain (RFC-0711).</purpose>
+<non-goals>
+  <item>Do not merge or validate — use spec.live.merge / spec.live.validate.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0711: initial spec.live.show handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+const LIVE_SPECS_DIR = "docs/specs/live";
+export async function runSpecLiveShow(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const domain = String(input.flags["domain"] ?? "");
+    if (!domain) {
+        return {
+            data: {
+                command: "spec.live.show",
+                status: "ok",
+                domain: "",
+                title: "",
+                lastMergedRfc: "",
+                updatedAt: "",
+                createdAt: "",
+                history: [],
+                body: "",
+            },
+            exitCode: 1,
+            summary: "spec.live.show: --domain flag is required",
+        };
+    }
+    const specFilePath = path.join(workspaceRoot, LIVE_SPECS_DIR, `${domain}.md`);
+    if (!existsSync(specFilePath)) {
+        return {
+            data: {
+                command: "spec.live.show",
+                status: "ok",
+                domain,
+                title: "",
+                lastMergedRfc: "",
+                updatedAt: "",
+                createdAt: "",
+                history: [],
+                body: "",
+            },
+            exitCode: 1,
+            summary: `spec.live.show: living spec "${domain}" not found at ${specFilePath}`,
+        };
+    }
+    const content = await fs.readFile(specFilePath, "utf-8");
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return {
+            data: {
+                command: "spec.live.show",
+                status: "ok",
+                domain,
+                title: "",
+                lastMergedRfc: "",
+                updatedAt: "",
+                createdAt: "",
+                history: [],
+                body: content,
+            },
+            exitCode: 1,
+            summary: `spec.live.show: living spec "${domain}" has invalid frontmatter`,
+        };
+    }
+    const fm = (YAML.parse(match[1]) ?? {});
+    const result = {
+        command: "spec.live.show",
+        status: "ok",
+        domain: String(fm["domain"] ?? 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] ?? "",
+    };
+    if (outputFormat === "pretty") {
+        logger.section(`Living Spec: ${result.domain}`);
+        logger.info(`Title: ${result.title}`);
+        logger.info(`Last merged RFC: ${result.lastMergedRfc}`);
+        logger.info(`Updated: ${result.updatedAt}`);
+        logger.info(`History entries: ${result.history.length}`);
+    }
+    return {
+        data: result,
+        exitCode: 0,
+        summary: `spec.live.show: ${domain}`,
+    };
+}
+//# sourceMappingURL=live-spec-show.js.map

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

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

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

@@ -0,0 +1,71 @@
+export interface LivingSpecHistoryEntry {
+    rfc: string;
+    mergedAt: string;
+    operation: "created" | "modified" | "removed";
+}
+export interface LivingSpec {
+    domain: string;
+    title: string;
+    lastMergedRfc: string;
+    updatedAt: string;
+    createdAt: string;
+    history: LivingSpecHistoryEntry[];
+    body: string;
+}
+export interface SpecLiveMergeInput {
+    id: string;
+}
+export interface DeltaOperation {
+    type: "added" | "modified" | "removed";
+    heading: string;
+    rfc: string;
+}
+export interface DeltaConflict {
+    heading: string;
+    existingRfc: string;
+    newRfc: string;
+    resolution: "pending" | "resolved";
+}
+export interface SpecLiveMergeResult {
+    command: "spec.live.merge";
+    domain: string;
+    operation: "created" | "modified";
+    deltas: DeltaOperation[];
+    conflicts: DeltaConflict[];
+    dryRun: boolean;
+}
+export interface SpecLiveListEntry {
+    domain: string;
+    title: string;
+    lastMergedRfc: string;
+    updatedAt: string;
+    historyCount: number;
+}
+export interface SpecLiveListResult {
+    command: "spec.live.list";
+    status: "ok";
+    livingSpecs: SpecLiveListEntry[];
+}
+export interface SpecLiveShowResult {
+    command: "spec.live.show";
+    status: "ok";
+    domain: string;
+    title: string;
+    lastMergedRfc: string;
+    updatedAt: string;
+    createdAt: string;
+    history: LivingSpecHistoryEntry[];
+    body: string;
+}
+export interface LivingSpecViolation {
+    rule: string;
+    message: string;
+    domain?: string;
+}
+export interface SpecLiveValidateResult {
+    command: "spec.live.validate";
+    status: "pass" | "fail";
+    violations: LivingSpecViolation[];
+    specsChecked: number;
+}
+//# sourceMappingURL=live-spec-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-spec-types.d.ts","sourceRoot":"","sources":["../../../os/spec/live-spec-types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB"}

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

@@ -0,0 +1,14 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Living feature spec types — contracts for living specs, delta operations,
+merge results, and validation (RFC-0711).</purpose>
+<non-goals>
+  <item>Do not implement merge/list/show/validate logic here — only type definitions.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0711: initial living spec types — LivingSpec, DeltaOperation, DeltaConflict, merge/list/show/validate result types.</item>
+</CHANGE_SUMMARY>
+*/
+export {};
+//# sourceMappingURL=live-spec-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-spec-types.js","sourceRoot":"","sources":["../../../os/spec/live-spec-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE"}

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

@@ -0,0 +1,4 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+import type { SpecLiveValidateResult } from "./live-spec-types.ts";
+export declare function runSpecLiveValidate(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<SpecLiveValidateResult>>;
+//# sourceMappingURL=live-spec-validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-spec-validate.d.ts","sourceRoot":"","sources":["../../../os/spec/live-spec-validate.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,sBAAsB,CAAC;AAM9B,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,CAoIrD"}