@warpgogol/forge 2.1.0 → 2.2.0

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

@@ -0,0 +1,118 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Zod schemas and TypeScript types for the forge spec vendoring contract (RFC-0394).</purpose>
+<non-goals>
+  <item>Do not implement validation logic — that lives in spec-validate.ts.</item>
+  <item>Do not implement materialization or status logic — that is RFC-0396.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0394: initial spec schema — forge/spec@1, integrity manifest, decision/rfc/wave types.</item>
+</CHANGE_SUMMARY>
+*/
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Spec decision
+// ---------------------------------------------------------------------------
+export const specDecisionSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    status: z.enum(["accepted", "amended", "rejected"]),
+    rationale: z.string().min(1),
+    promotedTo: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Spec RFC node
+// ---------------------------------------------------------------------------
+export const specRfcNodeSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    dependsOn: z.array(z.string()).default([]),
+    wave: z.number().int().min(1),
+    sources: z.array(z.string()).default([]),
+    materializedAs: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Spec wave
+// ---------------------------------------------------------------------------
+export const specWaveSchema = z.object({
+    id: z.number().int().min(1),
+    name: z.string().min(1),
+    goal: z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// Forge spec (forge/spec@1)
+// ---------------------------------------------------------------------------
+export const forgeSpecSchema = z.object({
+    schema: z.literal("forge/spec@1"),
+    id: z.string().min(1),
+    title: z.string().min(1),
+    version: z.string().min(1),
+    status: z.enum(["vendored", "accepted", "superseded"]),
+    reviewers: z.array(z.string()).default([]),
+    sourceNote: z.string().min(1),
+    vendoredAt: z.string().min(1),
+    documents: z.record(z.string(), z.string()).default({}),
+    decisions: z.array(specDecisionSchema).default([]),
+    rfcs: z.array(specRfcNodeSchema).default([]),
+    waves: z.array(specWaveSchema).default([]),
+    /** Set when this spec supersedes an older version (RFC-0397). */
+    supersedes: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Integrity manifest (forge/spec-integrity@1)
+// ---------------------------------------------------------------------------
+export const specIntegritySchema = z.object({
+    schema: z.literal("forge/spec-integrity@1"),
+    files: z.record(z.string(), z.string()).default({}),
+});
+// ---------------------------------------------------------------------------
+// Spec amendment (RFC-0397)
+// ---------------------------------------------------------------------------
+export const specAmendmentTargetSchema = z.union([
+    z.object({
+        kind: z.literal("section"),
+        document: z.string().min(1),
+        anchor: z.string().min(1),
+    }),
+    z.object({
+        kind: z.literal("decision"),
+        id: z.string().min(1),
+    }),
+    z.object({
+        kind: z.literal("node"),
+        id: z.string().min(1),
+    }),
+]);
+export const specAmendmentSchema = z.object({
+    schema: z.literal("forge/spec-amendment@1"),
+    id: z.string().min(1),
+    title: z.string().min(1),
+    status: z.enum(["proposed", "accepted", "rejected"]),
+    createdAt: z.string().min(1),
+    reviewers: z.array(z.string()).default([]),
+    targets: z.array(specAmendmentTargetSchema).min(1),
+    discoveredBy: z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// resolveAmendedNode — apply accepted amendments to a roadmap node
+// ---------------------------------------------------------------------------
+export function resolveAmendedNode(spec, nodeId, amendments) {
+    const node = spec.rfcs.find((n) => n.id === nodeId);
+    if (!node)
+        throw new Error(`Node not found: ${nodeId}`);
+    const acceptedAmendments = amendments.filter((a) => a.status === "accepted" && a.targets.some((t) => t.kind === "node" && t.id === nodeId));
+    if (acceptedAmendments.length === 0)
+        return node;
+    // Apply amendments — later amendments override earlier ones
+    let resolved = { ...node };
+    for (const amendment of acceptedAmendments) {
+        // Amendments compose at read time; the node's title gets an annotation
+        resolved = {
+            ...resolved,
+            title: `${resolved.title} (as amended by ${amendment.id})`,
+        };
+    }
+    return resolved;
+}
+//# sourceMappingURL=spec-schema.js.map

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

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

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

@@ -0,0 +1,33 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+interface SpecNodeStatus {
+    id: string;
+    state: "unmaterialized" | "draft" | "accepted" | "implemented";
+    materializedAs?: string;
+    wave: number;
+    blockedBy: string[];
+}
+interface SpecProgress {
+    implemented: number;
+    total: number;
+}
+interface SpecStatusEntry {
+    id: string;
+    status: string;
+    nodes: SpecNodeStatus[];
+    front: string[];
+    progress: SpecProgress;
+    amendments?: {
+        proposed: number;
+        accepted: number;
+        rejected: number;
+    };
+    amendedNodes?: string[];
+    amendedDecisions?: string[];
+}
+interface SpecStatusResult {
+    command: "spec.status";
+    specs: SpecStatusEntry[];
+}
+export declare function runSpecStatus(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<SpecStatusResult>>;
+export {};
+//# sourceMappingURL=spec-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-status.d.ts","sourceRoot":"","sources":["../../../os/spec/spec-status.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAY5B,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAuFD,wBAAsB,aAAa,CACjC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAiI/C"}

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

@@ -0,0 +1,222 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.status handler — read-only roadmap progress projection (RFC-0396).</purpose>
+<non-goals>
+  <item>Do not mutate any files — status is read-only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0396: initial spec.status handler — per-node states, blockers, front, progress.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { loadForgeConfig } from "../../src/config/forge-config.js";
+import { forgeSpecSchema, specAmendmentSchema, } from "./spec-schema.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function readYaml(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf8");
+        return parseYaml(content);
+    }
+    catch {
+        return null;
+    }
+}
+async function listSpecDirs(specsDir) {
+    if (!existsSync(specsDir))
+        return [];
+    const entries = await fs.readdir(specsDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+}
+async function loadRfcStatuses(rfcDir) {
+    const statuses = new Map();
+    if (!existsSync(rfcDir))
+        return statuses;
+    const files = await fs.readdir(rfcDir);
+    for (const file of files) {
+        if (!file.endsWith(".md") || file.startsWith("rfc-0000"))
+            continue;
+        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)
+                statuses.set(id, status);
+        }
+        catch {
+            // skip
+        }
+    }
+    return statuses;
+}
+async function loadAmendments(specDir) {
+    const amendmentsDir = path.join(specDir, "amendments");
+    if (!existsSync(amendmentsDir))
+        return [];
+    const entries = await fs.readdir(amendmentsDir);
+    const amendments = [];
+    for (const entry of entries) {
+        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 parsed = specAmendmentSchema.safeParse(raw);
+            if (parsed.success) {
+                amendments.push(parsed.data);
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    return amendments;
+}
+function computeFront(nodes, nodeMap) {
+    return nodes
+        .filter((n) => n.state === "unmaterialized")
+        .filter((n) => n.blockedBy.every((dep) => {
+        const depNode = nodeMap.get(dep);
+        return depNode?.state === "implemented";
+    }))
+        .map((n) => n.id);
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export async function runSpecStatus(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    let specsDir = "docs/specs";
+    try {
+        const config = loadForgeConfig(workspaceRoot);
+        specsDir = config.paths.specsDir;
+    }
+    catch {
+        // Use default
+    }
+    const specsRoot = path.join(workspaceRoot, specsDir);
+    const rfcDir = path.join(workspaceRoot, "docs", "rfcs");
+    const filterSpec = input.flags["spec"];
+    let specDirs = await listSpecDirs(specsRoot);
+    if (filterSpec) {
+        specDirs = specDirs.filter((d) => d === filterSpec);
+    }
+    const rfcStatuses = await loadRfcStatuses(rfcDir);
+    const results = [];
+    for (const specId of specDirs) {
+        const specDir = path.join(specsRoot, specId);
+        const forgeSpecPath = path.join(specDir, "forge-spec.yaml");
+        const rawSpec = await readYaml(forgeSpecPath);
+        if (!rawSpec)
+            continue;
+        const parsed = forgeSpecSchema.safeParse(rawSpec);
+        if (!parsed.success)
+            continue;
+        const spec = parsed.data;
+        const nodeMap = new Map();
+        const nodes = [];
+        for (const node of spec.rfcs) {
+            let state = "unmaterialized";
+            if (node.materializedAs) {
+                const rfcStatus = rfcStatuses.get(node.materializedAs);
+                if (rfcStatus === "implemented")
+                    state = "implemented";
+                else if (rfcStatus === "accepted")
+                    state = "accepted";
+                else if (rfcStatus)
+                    state = "draft";
+                else
+                    state = "draft";
+            }
+            const blockedBy = node.dependsOn.filter((dep) => {
+                const depNode = spec.rfcs.find((n) => n.id === dep);
+                if (!depNode)
+                    return false;
+                if (!depNode.materializedAs)
+                    return true;
+                const depStatus = rfcStatuses.get(depNode.materializedAs);
+                return depStatus !== "implemented";
+            });
+            const nodeStatus = {
+                id: node.id,
+                state,
+                materializedAs: node.materializedAs,
+                wave: node.wave,
+                blockedBy,
+            };
+            nodes.push(nodeStatus);
+            nodeMap.set(node.id, nodeStatus);
+        }
+        const front = computeFront(nodes, nodeMap);
+        const progress = {
+            implemented: nodes.filter((n) => n.state === "implemented").length,
+            total: nodes.length,
+        };
+        // Load amendments (RFC-0397)
+        const amendments = await loadAmendments(specDir);
+        const acceptedAmendments = amendments.filter((a) => a.status === "accepted");
+        const amendedNodes = new Set();
+        const amendedDecisions = new Set();
+        for (const amendment of acceptedAmendments) {
+            for (const target of amendment.targets) {
+                if (target.kind === "node")
+                    amendedNodes.add(target.id);
+                else if (target.kind === "decision")
+                    amendedDecisions.add(target.id);
+            }
+        }
+        results.push({
+            id: spec.id,
+            status: spec.status,
+            nodes,
+            front,
+            progress,
+            amendments: {
+                proposed: amendments.filter((a) => a.status === "proposed").length,
+                accepted: acceptedAmendments.length,
+                rejected: amendments.filter((a) => a.status === "rejected").length,
+            },
+            amendedNodes: [...amendedNodes],
+            amendedDecisions: [...amendedDecisions],
+        });
+    }
+    if (outputFormat === "pretty") {
+        if (results.length === 0) {
+            logger.info("No vendored specs found.");
+        }
+        else {
+            for (const entry of results) {
+                logger.section(`Spec: ${entry.id} (${entry.status})`);
+                logger.info(`Progress: ${entry.progress.implemented}/${entry.progress.total} implemented`);
+                logger.info(`Front: ${entry.front.join(", ") || "(none)"}`);
+                for (const node of entry.nodes) {
+                    const blocked = node.blockedBy.length > 0
+                        ? ` [blocked by ${node.blockedBy.join(", ")}]`
+                        : "";
+                    logger.info(`  ${node.id}  ${node.state.padEnd(14)} wave ${node.wave}${blocked}`);
+                }
+            }
+        }
+    }
+    return {
+        data: {
+            command: "spec.status",
+            specs: results,
+        },
+        exitCode: 0,
+        summary: `spec.status: ${results.length} spec(s)`,
+    };
+}
+//# sourceMappingURL=spec-status.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validate.d.ts","sourceRoot":"","sources":["../../../os/spec/spec-validate.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAQL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAsW1B,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAoHjD"}