@warpgogol/forge 2.1.0 → 2.3.0

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

@@ -0,0 +1,140 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.live.validate handler — validates all living specs in docs/specs/live/
+with rules V-LS-01..05 (RFC-0711).</purpose>
+<non-goals>
+  <item>Do not merge or list — use spec.live.merge / spec.live.list.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0711: initial spec.live.validate handler with V-LS-01..05 rules.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { listRfcFiles, readAndParseRfc } from "../rfc/frontmatter-io.js";
+import { RFC_DIR } from "../rfc/types.js";
+const LIVE_SPECS_DIR = "docs/specs/live";
+const REQUIRED_FM_FIELDS = ["domain", "title", "lastMergedRfc", "updatedAt", "createdAt", "history"];
+export async function runSpecLiveValidate(_input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const liveSpecsDir = path.join(workspaceRoot, LIVE_SPECS_DIR);
+    const rfcDir = path.join(workspaceRoot, RFC_DIR);
+    const violations = [];
+    let specsChecked = 0;
+    const domains = new Set();
+    const archivedRfcIds = new Set();
+    const rfcFiles = await listRfcFiles(rfcDir);
+    for (const file of rfcFiles) {
+        const parsed = await readAndParseRfc(rfcDir, file);
+        if (parsed && 'parsed' in parsed) {
+            const id = String(parsed.parsed.frontmatter["id"] ?? "").trim();
+            const status = String(parsed.parsed.frontmatter["status"] ?? "").trim();
+            if (id && (status === "implemented" || status === "rejected" || status === "superseded")) {
+                archivedRfcIds.add(id);
+            }
+        }
+    }
+    if (!existsSync(liveSpecsDir)) {
+        const result = {
+            command: "spec.live.validate",
+            status: "pass",
+            violations: [],
+            specsChecked: 0,
+        };
+        if (outputFormat === "pretty") {
+            logger.info("spec.live.validate: no living specs directory — pass (empty)");
+        }
+        return {
+            data: result,
+            exitCode: 0,
+            summary: "spec.live.validate: 0 living specs — pass",
+        };
+    }
+    const files = await fs.readdir(liveSpecsDir);
+    const specFiles = files.filter((f) => f.endsWith(".md") && f !== "README.md");
+    for (const file of specFiles) {
+        specsChecked++;
+        const filePath = path.join(liveSpecsDir, file);
+        const content = await fs.readFile(filePath, "utf-8");
+        const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+        if (!match) {
+            violations.push({ rule: "V-LS-01", message: `${file}: no valid frontmatter block`, domain: file });
+            continue;
+        }
+        const fm = (YAML.parse(match[1]) ?? {});
+        const domain = String(fm["domain"] ?? "");
+        for (const field of REQUIRED_FM_FIELDS) {
+            if (!(field in fm) || fm[field] === undefined || fm[field] === null) {
+                violations.push({
+                    rule: "V-LS-01",
+                    message: `${file}: missing required field "${field}"`,
+                    domain,
+                });
+            }
+        }
+        if (domain && file !== `${domain}.md`) {
+            violations.push({
+                rule: "V-LS-02",
+                message: `${file}: domain "${domain}" does not match filename`,
+                domain,
+            });
+        }
+        const lastMergedRfc = String(fm["lastMergedRfc"] ?? "");
+        if (lastMergedRfc && !archivedRfcIds.has(lastMergedRfc)) {
+            violations.push({
+                rule: "V-LS-03",
+                message: `${file}: lastMergedRfc "${lastMergedRfc}" is not an archived RFC`,
+                domain,
+            });
+        }
+        const history = Array.isArray(fm["history"]) ? fm["history"] : [];
+        for (const entry of history) {
+            if (entry.rfc && !archivedRfcIds.has(entry.rfc)) {
+                violations.push({
+                    rule: "V-LS-04",
+                    message: `${file}: history entry "${entry.rfc}" is not an archived RFC`,
+                    domain,
+                });
+            }
+        }
+        if (domain) {
+            if (domains.has(domain)) {
+                violations.push({
+                    rule: "V-LS-05",
+                    message: `duplicate domain "${domain}" found in multiple files`,
+                    domain,
+                });
+            }
+            domains.add(domain);
+        }
+    }
+    const hasFailures = violations.length > 0;
+    const result = {
+        command: "spec.live.validate",
+        status: hasFailures ? "fail" : "pass",
+        violations,
+        specsChecked,
+    };
+    if (outputFormat === "pretty") {
+        if (hasFailures) {
+            logger.error(`spec.live.validate: ${violations.length} violation(s) across ${specsChecked} spec(s)`);
+            for (const v of violations) {
+                logger.error(`  ${v.rule}: ${v.message}`);
+            }
+        }
+        else {
+            logger.success(`spec.live.validate: all ${specsChecked} living spec(s) pass`);
+        }
+    }
+    return {
+        data: result,
+        exitCode: hasFailures ? 1 : 0,
+        summary: hasFailures
+            ? `spec.live.validate: ${violations.length} violation(s)`
+            : `spec.live.validate: ${specsChecked} spec(s) — pass`,
+    };
+}
+//# sourceMappingURL=live-spec-validate.js.map

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

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

package/dist/os/spec/spec-materialize.d.ts

@@ -0,0 +1,21 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+interface MaterializedNode {
+    node: string;
+    rfc: string;
+    file: string;
+}
+interface SkippedNode {
+    node: string;
+    reason: string;
+}
+interface SpecMaterializeResult {
+    command: "spec.materialize";
+    status: "pass" | "fail";
+    spec: string;
+    created: MaterializedNode[];
+    skipped: SkippedNode[];
+    front: string[];
+}
+export declare function runSpecMaterialize(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<SpecMaterializeResult>>;
+export {};
+//# sourceMappingURL=spec-materialize.d.ts.map

package/dist/os/spec/spec-materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-materialize.d.ts","sourceRoot":"","sources":["../../../os/spec/spec-materialize.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAe5B,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAuBD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAkTpD"}

package/dist/os/spec/spec-materialize.js

@@ -0,0 +1,336 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.materialize handler — scaffolds RFC files for front nodes of a spec roadmap (RFC-0396).</purpose>
+<non-goals>
+  <item>Do not fill RFC content — the agent fills sections during the fo pipeline.</item>
+  <item>Do not bulk-materialize past the front or above the --next cap.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0396: initial spec.materialize handler — front computation, scaffold via rfc.create, materializedAs write-back.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { toKebabCase } from "../../src/utils/string-utils.js";
+import { loadForgeConfig } from "../../src/config/forge-config.js";
+import { resolveRfcTemplate } from "../rfc/handlers/shared.js";
+import { forgeSpecSchema, specAmendmentSchema, resolveAmendedNode, } from "./spec-schema.js";
+import { listRfcFiles } from "../rfc/frontmatter-io.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function readYaml(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf8");
+        return parseYaml(content);
+    }
+    catch {
+        return null;
+    }
+}
+function toIsoDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export async function runSpecMaterialize(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const specId = input.flags["spec"];
+    if (!specId) {
+        return {
+            data: {
+                command: "spec.materialize",
+                status: "fail",
+                spec: "",
+                created: [],
+                skipped: [],
+                front: [],
+            },
+            exitCode: 1,
+            summary: "spec.materialize: --spec=<id> is required",
+        };
+    }
+    let specsDir = "docs/specs";
+    try {
+        const config = loadForgeConfig(workspaceRoot);
+        specsDir = config.paths.specsDir;
+    }
+    catch {
+        // Use default
+    }
+    const specDir = path.join(workspaceRoot, specsDir, specId);
+    const forgeSpecPath = path.join(specDir, "forge-spec.yaml");
+    const rawSpec = await readYaml(forgeSpecPath);
+    if (!rawSpec) {
+        return {
+            data: {
+                command: "spec.materialize",
+                status: "fail",
+                spec: specId,
+                created: [],
+                skipped: [],
+                front: [],
+            },
+            exitCode: 1,
+            summary: `spec.materialize: forge-spec.yaml not found for spec '${specId}'`,
+        };
+    }
+    const parsed = forgeSpecSchema.safeParse(rawSpec);
+    if (!parsed.success) {
+        return {
+            data: {
+                command: "spec.materialize",
+                status: "fail",
+                spec: specId,
+                created: [],
+                skipped: [],
+                front: [],
+            },
+            exitCode: 1,
+            summary: `spec.materialize: forge-spec.yaml schema violation for spec '${specId}'`,
+        };
+    }
+    const spec = parsed.data;
+    if (spec.status !== "accepted") {
+        return {
+            data: {
+                command: "spec.materialize",
+                status: "fail",
+                spec: specId,
+                created: [],
+                skipped: [],
+                front: [],
+            },
+            exitCode: 1,
+            summary: `spec.materialize: spec '${specId}' is not accepted (status: ${spec.status}). Run /fo-spec-ingest to complete acceptance.`,
+        };
+    }
+    // Load amendments (RFC-0397)
+    const amendmentsDir = path.join(specDir, "amendments");
+    const amendments = [];
+    if (existsSync(amendmentsDir)) {
+        const amdEntries = await fs.readdir(amendmentsDir);
+        for (const entry of amdEntries) {
+            if (!entry.endsWith(".md"))
+                continue;
+            try {
+                const content = await fs.readFile(path.join(amendmentsDir, entry), "utf8");
+                const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+                if (!fmMatch)
+                    continue;
+                const raw = parseYaml(fmMatch[1]);
+                const amdParsed = specAmendmentSchema.safeParse(raw);
+                if (amdParsed.success) {
+                    amendments.push(amdParsed.data);
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    const proposedAmendmentNodes = new Set();
+    for (const amendment of amendments) {
+        if (amendment.status === "proposed") {
+            for (const target of amendment.targets) {
+                if (target.kind === "node")
+                    proposedAmendmentNodes.add(target.id);
+            }
+        }
+    }
+    const rfcDir = path.join(workspaceRoot, "docs", "rfcs");
+    const rfcFiles = await listRfcFiles(rfcDir);
+    // Load RFC statuses
+    const rfcStatuses = new Map();
+    for (const file of rfcFiles) {
+        try {
+            const content = await fs.readFile(path.join(rfcDir, file), "utf8");
+            const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+            if (!fmMatch)
+                continue;
+            const fm = parseYaml(fmMatch[1]);
+            const id = String(fm["id"] ?? "");
+            const status = String(fm["status"] ?? "");
+            if (id && status)
+                rfcStatuses.set(id, status);
+        }
+        catch {
+            // skip
+        }
+    }
+    // Compute node states
+    const nodeState = new Map();
+    for (const node of spec.rfcs) {
+        if (node.materializedAs) {
+            const status = rfcStatuses.get(node.materializedAs);
+            nodeState.set(node.id, status === "implemented" ? "implemented" : "unmaterialized");
+        }
+        else {
+            nodeState.set(node.id, "unmaterialized");
+        }
+    }
+    // Compute front: unmaterialized nodes whose deps are all implemented
+    function isFront(node) {
+        if (node.materializedAs)
+            return false;
+        return node.dependsOn.every((dep) => nodeState.get(dep) === "implemented");
+    }
+    const frontNodes = spec.rfcs.filter(isFront);
+    // Determine which nodes to materialize
+    const explicitNodes = input.flags["nodes"];
+    let toMaterialize;
+    if (explicitNodes) {
+        const requested = explicitNodes.split(",").map((s) => s.trim()).filter(Boolean);
+        toMaterialize = [];
+        const skipped = [];
+        for (const nodeId of requested) {
+            const node = spec.rfcs.find((n) => n.id === nodeId);
+            if (!node) {
+                skipped.push({ node: nodeId, reason: "node not found in spec" });
+            }
+            else if (!isFront(node)) {
+                const blockers = node.dependsOn.filter((d) => nodeState.get(d) !== "implemented");
+                skipped.push({ node: nodeId, reason: `blocked by ${blockers.join(", ")}` });
+            }
+            else {
+                toMaterialize.push(node);
+            }
+        }
+        if (skipped.length > 0 && toMaterialize.length === 0) {
+            return {
+                data: {
+                    command: "spec.materialize",
+                    status: "fail",
+                    spec: specId,
+                    created: [],
+                    skipped,
+                    front: frontNodes.map((n) => n.id),
+                },
+                exitCode: 1,
+                summary: `spec.materialize: all requested nodes blocked or not found`,
+            };
+        }
+    }
+    else {
+        const nextStr = input.flags["next"];
+        let next = nextStr ? parseInt(nextStr, 10) : 8;
+        if (isNaN(next) || next < 1)
+            next = 8;
+        if (next > 12)
+            next = 12;
+        toMaterialize = frontNodes.slice(0, next);
+    }
+    // Find max RFC number
+    let maxId = 0;
+    for (const file of rfcFiles) {
+        const match = path.basename(file).match(/^rfc-(\d{4})/);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxId)
+                maxId = num;
+        }
+    }
+    // Load template via resolveRfcTemplate (project-level first, then forge package fallback)
+    const templatePath = resolveRfcTemplate(workspaceRoot);
+    let templateContent;
+    try {
+        templateContent = await fs.readFile(templatePath, "utf-8");
+    }
+    catch {
+        return {
+            data: {
+                command: "spec.materialize",
+                status: "fail",
+                spec: specId,
+                created: [],
+                skipped: [],
+                front: frontNodes.map((n) => n.id),
+            },
+            exitCode: 1,
+            summary: `spec.materialize: RFC template not found at ${templatePath}`,
+        };
+    }
+    const today = toIsoDate(new Date());
+    const created = [];
+    const skipped = [];
+    for (const node of toMaterialize) {
+        // Use amended node if amendments exist (RFC-0397)
+        const effectiveNode = resolveAmendedNode(spec, node.id, amendments);
+        const nextNum = maxId + 1;
+        const paddedNum = String(nextNum).padStart(4, "0");
+        const nextRfcId = `RFC-${paddedNum}`;
+        const kebabTitle = toKebabCase(effectiveNode.title);
+        const fileName = `rfc-${paddedNum}-${kebabTitle}.md`;
+        // Warn if node has a proposed amendment (RFC-0397)
+        if (proposedAmendmentNodes.has(node.id)) {
+            logger.warn(`Warning: node ${node.id} has a proposed amendment — node knowledge may be about to change`);
+        }
+        let content = templateContent;
+        content = content.replace(/^id: RFC-0000$/m, `id: ${nextRfcId}`);
+        content = content.replace(/^title: ".*"$/m, `title: "${effectiveNode.title}"`);
+        content = content.replace(/^status: draft$/m, `status: draft`);
+        content = content.replace(/^kind: \w+$/m, `kind: contract`);
+        content = content.replace(/^createdAt: YYYY-MM-DD$/m, `createdAt: ${today}`);
+        content = content.replace(/^updatedAt: YYYY-MM-DD$/m, `updatedAt: ${today}`);
+        content = content.replace(/^# specRef:$/m, `specRef: "${specId}/${node.id}"`);
+        content = content.replace(/^# RFC-0000: .+$/m, `# ${nextRfcId}: ${effectiveNode.title}`);
+        // Add normative source references in the body
+        const sourceRefs = effectiveNode.sources.length > 0
+            ? effectiveNode.sources.map((s) => `- ${s}`).join("\n")
+            : "(none)";
+        const designSection = `\n## Design\n\n**Normative source references:**\n${sourceRefs}\n\n_Fill in the implementation design for this repository. Reference vendored snapshot sections — do not copy model content._\n`;
+        content = content.replace(/^---\n\n# /m, `---\n${designSection}\n# `);
+        const targetPath = path.join(rfcDir, fileName);
+        await fs.writeFile(targetPath, content, "utf-8");
+        maxId = nextNum;
+        created.push({
+            node: node.id,
+            rfc: nextRfcId,
+            file: path.join("docs", "rfcs", fileName),
+        });
+    }
+    // Write back materializedAs into forge-spec.yaml
+    if (created.length > 0) {
+        const updatedSpec = {
+            ...spec,
+            rfcs: spec.rfcs.map((node) => {
+                const created_entry = created.find((c) => c.node === node.id);
+                return created_entry ? { ...node, materializedAs: created_entry.rfc } : node;
+            }),
+        };
+        const yamlContent = stringifyYaml(updatedSpec);
+        await fs.writeFile(forgeSpecPath, yamlContent, "utf-8");
+    }
+    // Report skipped front nodes (beyond the materialized batch)
+    const remainingFront = frontNodes
+        .filter((n) => !created.some((c) => c.node === n.id))
+        .map((n) => n.id);
+    if (outputFormat === "pretty") {
+        for (const c of created) {
+            logger.success(`Materialized ${c.node} → ${c.rfc} (${c.file})`);
+        }
+        for (const s of skipped) {
+            logger.warn(`Skipped ${s.node}: ${s.reason}`);
+        }
+        if (remainingFront.length > 0) {
+            logger.info(`Remaining front: ${remainingFront.join(", ")}`);
+        }
+    }
+    return {
+        data: {
+            command: "spec.materialize",
+            status: "pass",
+            spec: specId,
+            created,
+            skipped,
+            front: remainingFront,
+        },
+        exitCode: 0,
+        summary: `spec.materialize: created ${created.length} RFC(s) from spec '${specId}'`,
+    };
+}
+//# sourceMappingURL=spec-materialize.js.map

package/dist/os/spec/spec-materialize.js.map

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

package/dist/os/spec/spec-schema.d.ts

@@ -0,0 +1,126 @@
+import { z } from "zod";
+export declare const specDecisionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        accepted: "accepted";
+        rejected: "rejected";
+        amended: "amended";
+    }>;
+    rationale: z.ZodString;
+    promotedTo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SpecDecision = z.infer<typeof specDecisionSchema>;
+export declare const specRfcNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    wave: z.ZodNumber;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    materializedAs: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SpecRfcNode = z.infer<typeof specRfcNodeSchema>;
+export declare const specWaveSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    goal: z.ZodString;
+}, z.core.$strip>;
+export type SpecWave = z.infer<typeof specWaveSchema>;
+export declare const forgeSpecSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/spec@1">;
+    id: z.ZodString;
+    title: z.ZodString;
+    version: z.ZodString;
+    status: z.ZodEnum<{
+        superseded: "superseded";
+        accepted: "accepted";
+        vendored: "vendored";
+    }>;
+    reviewers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceNote: z.ZodString;
+    vendoredAt: z.ZodString;
+    documents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            accepted: "accepted";
+            rejected: "rejected";
+            amended: "amended";
+        }>;
+        rationale: z.ZodString;
+        promotedTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    rfcs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        wave: z.ZodNumber;
+        sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        materializedAs: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    waves: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        goal: z.ZodString;
+    }, z.core.$strip>>>;
+    supersedes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ForgeSpec = z.infer<typeof forgeSpecSchema>;
+export declare const specIntegritySchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/spec-integrity@1">;
+    files: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type SpecIntegrity = z.infer<typeof specIntegritySchema>;
+export interface SpecViolation {
+    rule: string;
+    message: string;
+}
+export interface SpecValidateResult {
+    command: "spec.validate";
+    status: "pass" | "fail";
+    specs: Array<{
+        id: string;
+        status: string;
+        violations: SpecViolation[];
+    }>;
+}
+export declare const specAmendmentTargetSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"section">;
+    document: z.ZodString;
+    anchor: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"decision">;
+    id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"node">;
+    id: z.ZodString;
+}, z.core.$strip>]>;
+export type SpecAmendmentTarget = z.infer<typeof specAmendmentTargetSchema>;
+export declare const specAmendmentSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/spec-amendment@1">;
+    id: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        accepted: "accepted";
+        rejected: "rejected";
+        proposed: "proposed";
+    }>;
+    createdAt: z.ZodString;
+    reviewers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    targets: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"section">;
+        document: z.ZodString;
+        anchor: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"decision">;
+        id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"node">;
+        id: z.ZodString;
+    }, z.core.$strip>]>>;
+    discoveredBy: z.ZodString;
+}, z.core.$strip>;
+export type SpecAmendment = z.infer<typeof specAmendmentSchema>;
+export declare function resolveAmendedNode(spec: ForgeSpec, nodeId: string, amendments: SpecAmendment[]): SpecRfcNode;
+//# sourceMappingURL=spec-schema.d.ts.map

package/dist/os/spec/spec-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-schema.d.ts","sourceRoot":"","sources":["../../../os/spec/spec-schema.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAM7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,eAAO,MAAM,iBAAiB;;;;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,cAAc;;;;iBAIzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,aAAa,EAAE,CAAC;KAC7B,CAAC,CAAC;CACJ;AAMD,eAAO,MAAM,yBAAyB;;;;;;;;;;mBAcpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;iBAS9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,aAAa,EAAE,GAC1B,WAAW,CAqBb"}