loom-spec 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,293 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { listDiagrams, readDiagram, writeDiagram, readNodeTypes, } from "../server/fileOps.js";
+import { validateDiagram } from "../validate.js";
+import { runDriftCheck } from "../server/drift.js";
+const STATUSES = ["planned", "implemented", "stale", "deprecated"];
+const EDGE_KINDS = [
+    "request",
+    "event",
+    "data-read",
+    "data-write",
+    "signal",
+    "dependency",
+    "control",
+];
+const codeRefSchema = z.object({
+    path: z.string(),
+    symbol: z.string().optional(),
+    lines: z.string().optional(),
+});
+function uniqueNodeId(d, prefix) {
+    const ids = new Set(d.nodes.map((n) => n.id));
+    let i = 1;
+    while (ids.has(`${prefix}-${i}`))
+        i++;
+    return `${prefix}-${i}`;
+}
+function uniqueEdgeId(d) {
+    const ids = new Set(d.edges.map((e) => e.id));
+    let i = d.edges.length + 1;
+    while (ids.has(`e${i}`))
+        i++;
+    return `e${i}`;
+}
+function jsonText(obj) {
+    return { content: [{ type: "text", text: JSON.stringify(obj, null, 2) }] };
+}
+function errorText(msg, details) {
+    const text = details && details.length ? `${msg}\n  - ${details.join("\n  - ")}` : msg;
+    return { content: [{ type: "text", text }], isError: true };
+}
+async function readDiagramOrError(loomPath, id) {
+    try {
+        return { ok: true, diagram: await readDiagram(loomPath, id) };
+    }
+    catch (e) {
+        const code = e.code;
+        if (code === "ENOENT") {
+            return { ok: false, error: errorText(`diagram '${id}' not found`) };
+        }
+        return { ok: false, error: errorText(`read failed: ${e.message}`) };
+    }
+}
+async function persist(loomPath, id, d) {
+    const result = await validateDiagram(d);
+    if (!result.ok) {
+        return errorText("Validation failed:", result.errors);
+    }
+    await writeDiagram(loomPath, id, d);
+    return null;
+}
+export function createMcpServer(loomRoot) {
+    const server = new McpServer({ name: "loom-spec", version: "0.0.1" }, { instructions: `Use these tools to maintain the architecture spec in ${loomRoot.loomPath}. Prefer them over editing the JSON files directly — they validate against the schema before writing.` });
+    server.registerTool("loom_list_diagrams", {
+        title: "List diagrams",
+        description: "List all diagrams in the spec with title and node/edge counts.",
+        inputSchema: {},
+    }, async () => {
+        const summaries = await listDiagrams(loomRoot.loomPath);
+        return jsonText(summaries);
+    });
+    server.registerTool("loom_read_diagram", {
+        title: "Read diagram",
+        description: "Read a specific diagram's full JSON by id.",
+        inputSchema: { id: z.string().describe("Diagram id (e.g. 'overview')") },
+    }, async ({ id }) => {
+        const r = await readDiagramOrError(loomRoot.loomPath, id);
+        if (!r.ok)
+            return r.error;
+        return jsonText(r.diagram);
+    });
+    server.registerTool("loom_read_node_types", {
+        title: "Read node types",
+        description: "Read the project's node-types.json (available node-type vocabulary).",
+        inputSchema: {},
+    }, async () => {
+        const nt = await readNodeTypes(loomRoot.loomPath);
+        return jsonText(nt);
+    });
+    server.registerTool("loom_add_node", {
+        title: "Add node",
+        description: "Append a new node to a diagram. Returns the auto-generated id. The new node defaults to status='planned'. Position defaults to {200, 200}; the user can re-arrange in the UI.",
+        inputSchema: {
+            diagram: z.string().describe("Diagram id to add the node to"),
+            type: z.string().describe("Node type key (must exist in node-types.json)"),
+            label: z.string().describe("Display label"),
+            description: z.string().optional(),
+            position: z.object({ x: z.number(), y: z.number() }).optional(),
+            status: z.enum(STATUSES).default("planned"),
+            code_refs: z.array(codeRefSchema).optional(),
+            properties: z.record(z.string(), z.unknown()).optional(),
+            tags: z.array(z.string()).optional(),
+            id: z
+                .string()
+                .optional()
+                .describe("Optional explicit id (lowercase kebab). If omitted, generated as <type>-<n>."),
+        },
+    }, async ({ diagram, type, label, description, position, status, code_refs, properties, tags, id }) => {
+        const r = await readDiagramOrError(loomRoot.loomPath, diagram);
+        if (!r.ok)
+            return r.error;
+        const d = r.diagram;
+        const newId = id ?? uniqueNodeId(d, type);
+        if (d.nodes.some((n) => n.id === newId)) {
+            return errorText(`node with id '${newId}' already exists`);
+        }
+        const node = {
+            id: newId,
+            type,
+            label,
+            description,
+            position: position ?? { x: 200, y: 200 },
+            status,
+            code_refs: code_refs ?? [],
+            properties: properties ?? {},
+            tags,
+        };
+        d.nodes.push(node);
+        const err = await persist(loomRoot.loomPath, diagram, d);
+        if (err)
+            return err;
+        return jsonText({ ok: true, id: newId });
+    });
+    server.registerTool("loom_update_node", {
+        title: "Update node",
+        description: "Patch fields on an existing node. Only the fields you pass are changed. Use 'loom_mark_stale' as a shortcut for setting status='stale'.",
+        inputSchema: {
+            diagram: z.string(),
+            id: z.string().describe("Node id"),
+            patch: z
+                .object({
+                label: z.string().optional(),
+                description: z.string().nullable().optional(),
+                status: z.enum(STATUSES).optional(),
+                position: z.object({ x: z.number(), y: z.number() }).optional(),
+                code_refs: z.array(codeRefSchema).optional(),
+                properties: z.record(z.string(), z.unknown()).optional(),
+                tags: z.array(z.string()).optional(),
+                drill_down: z.string().nullable().optional(),
+            })
+                .describe("Fields to merge"),
+        },
+    }, async ({ diagram, id, patch }) => {
+        const r = await readDiagramOrError(loomRoot.loomPath, diagram);
+        if (!r.ok)
+            return r.error;
+        const d = r.diagram;
+        const idx = d.nodes.findIndex((n) => n.id === id);
+        if (idx < 0)
+            return errorText(`node '${id}' not found`);
+        const cleaned = {};
+        for (const [k, v] of Object.entries(patch)) {
+            if (v === null)
+                continue; // explicit null = clear; handled below
+            if (v !== undefined)
+                cleaned[k] = v;
+        }
+        // Honor explicit nulls as field clears
+        if (patch.description === null)
+            cleaned["description"] = undefined;
+        if (patch.drill_down === null)
+            cleaned["drill_down"] = undefined;
+        d.nodes[idx] = { ...d.nodes[idx], ...cleaned };
+        const err = await persist(loomRoot.loomPath, diagram, d);
+        if (err)
+            return err;
+        return jsonText({ ok: true });
+    });
+    server.registerTool("loom_mark_stale", {
+        title: "Mark node stale",
+        description: "Shortcut for setting a node's status to 'stale' (use when the underlying code no longer exists or has been replaced; humans review staleness rather than auto-delete).",
+        inputSchema: {
+            diagram: z.string(),
+            id: z.string(),
+        },
+    }, async ({ diagram, id }) => {
+        const r = await readDiagramOrError(loomRoot.loomPath, diagram);
+        if (!r.ok)
+            return r.error;
+        const d = r.diagram;
+        const idx = d.nodes.findIndex((n) => n.id === id);
+        if (idx < 0)
+            return errorText(`node '${id}' not found`);
+        d.nodes[idx] = { ...d.nodes[idx], status: "stale" };
+        const err = await persist(loomRoot.loomPath, diagram, d);
+        if (err)
+            return err;
+        return jsonText({ ok: true });
+    });
+    server.registerTool("loom_delete_node", {
+        title: "Delete node",
+        description: "Hard-delete a node and all edges that touch it. Prefer 'loom_mark_stale' for nodes whose code went away — deletion loses architectural history.",
+        inputSchema: {
+            diagram: z.string(),
+            id: z.string(),
+        },
+    }, async ({ diagram, id }) => {
+        const r = await readDiagramOrError(loomRoot.loomPath, diagram);
+        if (!r.ok)
+            return r.error;
+        const d = r.diagram;
+        const before = d.nodes.length;
+        d.nodes = d.nodes.filter((n) => n.id !== id);
+        if (d.nodes.length === before)
+            return errorText(`node '${id}' not found`);
+        d.edges = d.edges.filter((e) => {
+            const f = e.from.split(":")[0];
+            const t = e.to.split(":")[0];
+            return f !== id && t !== id;
+        });
+        const err = await persist(loomRoot.loomPath, diagram, d);
+        if (err)
+            return err;
+        return jsonText({ ok: true });
+    });
+    server.registerTool("loom_add_edge", {
+        title: "Add edge",
+        description: "Connect two nodes. Use 'node-id:port-name' syntax for typed ports.",
+        inputSchema: {
+            diagram: z.string(),
+            from: z.string().describe("Source node id (or 'node-id:port-name')"),
+            to: z.string().describe("Target node id (or 'node-id:port-name')"),
+            kind: z.enum(EDGE_KINDS),
+            label: z.string().optional(),
+            description: z.string().optional(),
+        },
+    }, async ({ diagram, from, to, kind, label, description }) => {
+        const r = await readDiagramOrError(loomRoot.loomPath, diagram);
+        if (!r.ok)
+            return r.error;
+        const d = r.diagram;
+        const edge = {
+            id: uniqueEdgeId(d),
+            from,
+            to,
+            kind,
+            label,
+            description,
+        };
+        d.edges.push(edge);
+        const err = await persist(loomRoot.loomPath, diagram, d);
+        if (err)
+            return err;
+        return jsonText({ ok: true, id: edge.id });
+    });
+    server.registerTool("loom_delete_edge", {
+        title: "Delete edge",
+        description: "Remove an edge by id.",
+        inputSchema: {
+            diagram: z.string(),
+            id: z.string(),
+        },
+    }, async ({ diagram, id }) => {
+        const r = await readDiagramOrError(loomRoot.loomPath, diagram);
+        if (!r.ok)
+            return r.error;
+        const d = r.diagram;
+        const before = d.edges.length;
+        d.edges = d.edges.filter((e) => e.id !== id);
+        if (d.edges.length === before)
+            return errorText(`edge '${id}' not found`);
+        const err = await persist(loomRoot.loomPath, diagram, d);
+        if (err)
+            return err;
+        return jsonText({ ok: true });
+    });
+    server.registerTool("loom_validate", {
+        title: "Validate spec",
+        description: "Run the full drift + schema check on every diagram. Reports schema errors, missing code-ref files, and missing symbols.",
+        inputSchema: {},
+    }, async () => {
+        const report = await runDriftCheck(loomRoot.rootPath, loomRoot.loomPath);
+        return jsonText(report);
+    });
+    return server;
+}
+export async function startMcpServer(loomRoot) {
+    const server = createMcpServer(loomRoot);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/server/app.d.ts

@@ -0,0 +1,9 @@
+import { Hono } from "hono";
+import type { LoomRoot } from "./findLoomRoot.js";
+import type { LoomWatcher } from "./watch.js";
+export interface AppOptions {
+    loomRoot: LoomRoot;
+    watcher: LoomWatcher;
+    serveSpaFrom?: string;
+}
+export declare function createApp({ loomRoot, watcher, serveSpaFrom }: AppOptions): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/server/app.js

@@ -0,0 +1,135 @@
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { streamSSE } from "hono/streaming";
+import { serveStatic } from "@hono/node-server/serve-static";
+import { listDiagrams, readDiagram, writeDiagram, readNodeTypes, } from "./fileOps.js";
+import { validateDiagram, validateNodeTypes } from "../validate.js";
+export function createApp({ loomRoot, watcher, serveSpaFrom }) {
+    const app = new Hono();
+    app.use("/api/*", cors());
+    app.get("/api/root", (c) => c.json({ rootPath: loomRoot.rootPath, loomPath: loomRoot.loomPath }));
+    app.get("/api/node-types", async (c) => {
+        try {
+            const data = await readNodeTypes(loomRoot.loomPath);
+            return c.json(data);
+        }
+        catch (e) {
+            return c.json({ error: e.message }, 500);
+        }
+    });
+    app.get("/api/diagrams", async (c) => {
+        try {
+            const summaries = await listDiagrams(loomRoot.loomPath);
+            return c.json(summaries);
+        }
+        catch (e) {
+            return c.json({ error: e.message }, 500);
+        }
+    });
+    app.get("/api/diagrams/:id", async (c) => {
+        const id = c.req.param("id");
+        try {
+            const data = await readDiagram(loomRoot.loomPath, id);
+            return c.json(data);
+        }
+        catch (e) {
+            const code = e.code;
+            if (code === "ENOENT")
+                return c.json({ error: "not found" }, 404);
+            return c.json({ error: e.message }, 500);
+        }
+    });
+    app.put("/api/diagrams/:id", async (c) => {
+        const id = c.req.param("id");
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "invalid JSON" }, 400);
+        }
+        const result = await validateDiagram(body);
+        if (!result.ok) {
+            return c.json({ error: "validation failed", details: result.errors }, 422);
+        }
+        const diagram = body;
+        if (diagram.id !== id) {
+            return c.json({ error: `body id "${diagram.id}" does not match URL id "${id}"` }, 400);
+        }
+        try {
+            await writeDiagram(loomRoot.loomPath, id, body, (path) => watcher.markSelfWrite(path));
+            return c.json({ ok: true });
+        }
+        catch (e) {
+            return c.json({ error: e.message }, 500);
+        }
+    });
+    app.put("/api/node-types", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "invalid JSON" }, 400);
+        }
+        const result = await validateNodeTypes(body);
+        if (!result.ok) {
+            return c.json({ error: "validation failed", details: result.errors }, 422);
+        }
+        return c.json({ error: "node-types editing is not enabled yet" }, 501);
+    });
+    // Server-Sent Events: live updates when files change externally
+    app.get("/api/events", (c) => streamSSE(c, async (stream) => {
+        let notify = null;
+        const queue = [];
+        const onChange = (event) => {
+            queue.push(event);
+            notify?.();
+        };
+        watcher.on("change", onChange);
+        // Initial "hello" so the client knows the stream is alive
+        await stream.writeSSE({ data: JSON.stringify({ type: "connected" }) });
+        // Heartbeat so proxies don't close the stream
+        const heartbeat = setInterval(() => {
+            stream
+                .writeSSE({ data: JSON.stringify({ type: "ping" }) })
+                .catch(() => { });
+        }, 25000);
+        stream.onAbort(() => {
+            watcher.off("change", onChange);
+            clearInterval(heartbeat);
+            notify?.();
+        });
+        try {
+            while (!stream.aborted) {
+                if (queue.length > 0) {
+                    const event = queue.shift();
+                    await stream.writeSSE({
+                        event: "change",
+                        data: JSON.stringify(event),
+                    });
+                }
+                else {
+                    await new Promise((resolve) => {
+                        notify = () => {
+                            notify = null;
+                            resolve();
+                        };
+                    });
+                }
+            }
+        }
+        finally {
+            watcher.off("change", onChange);
+            clearInterval(heartbeat);
+        }
+    }));
+    if (serveSpaFrom) {
+        app.use("/*", serveStatic({
+            root: serveSpaFrom,
+            rewriteRequestPath: (path) => (path === "/" ? "/index.html" : path),
+        }));
+    }
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/server/app.js.map

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

package/dist/server/drift.d.ts

@@ -0,0 +1,29 @@
+import type { CodeRef } from "../types/diagram.js";
+export interface DriftFinding {
+    diagramId: string;
+    nodeId: string;
+    refIndex: number;
+    ref: CodeRef;
+    issue: "missing-file" | "missing-symbol" | "lines-out-of-range" | "invalid-lines";
+    detail?: string;
+}
+export interface SchemaFinding {
+    diagramId: string;
+    errors: string[];
+}
+export interface DiagramReport {
+    diagramId: string;
+    title: string;
+    nodeCount: number;
+    edgeCount: number;
+    refsChecked: number;
+    staleNodes: number;
+    drift: DriftFinding[];
+    schemaErrors: string[];
+}
+export interface DriftReport {
+    perDiagram: DiagramReport[];
+    totalDrift: number;
+    totalSchemaErrors: number;
+}
+export declare function runDriftCheck(rootPath: string, loomPath: string): Promise<DriftReport>;

package/dist/server/drift.js

@@ -0,0 +1,128 @@
+import { readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { listDiagrams, readDiagram } from "./fileOps.js";
+import { validateDiagram } from "../validate.js";
+const LINES_RE = /^(\d+)(?:-(\d+))?(?:,(\d+)(?:-(\d+))?)*$/;
+function parseLineRange(spec) {
+    if (!LINES_RE.test(spec))
+        return null;
+    const ranges = [];
+    for (const part of spec.split(",")) {
+        const dash = part.indexOf("-");
+        if (dash === -1) {
+            const n = Number(part);
+            ranges.push([n, n]);
+        }
+        else {
+            ranges.push([Number(part.slice(0, dash)), Number(part.slice(dash + 1))]);
+        }
+    }
+    return ranges;
+}
+async function checkRef(rootPath, ref) {
+    const abs = resolve(rootPath, ref.path);
+    // Path exists?
+    let contents;
+    try {
+        await stat(abs);
+        contents = await readFile(abs, "utf8");
+    }
+    catch {
+        return { issue: "missing-file" };
+    }
+    // If symbol is set, grep for it.
+    if (ref.symbol) {
+        // Match as whole word; tolerate def/class/function/const prefixes implicitly
+        // by just looking for the identifier surrounded by non-word characters.
+        const symRe = new RegExp(`(?:^|[^\\w])${ref.symbol.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\$&")}(?:[^\\w]|$)`, "m");
+        if (!symRe.test(contents)) {
+            return {
+                issue: "missing-symbol",
+                detail: `'${ref.symbol}' not found in ${ref.path}`,
+            };
+        }
+    }
+    // If lines is set, validate
+    if (ref.lines) {
+        const ranges = parseLineRange(ref.lines);
+        if (!ranges) {
+            return { issue: "invalid-lines", detail: `bad format: '${ref.lines}'` };
+        }
+        const totalLines = contents.split("\n").length;
+        for (const [from, to] of ranges) {
+            if (from < 1 || to < from || to > totalLines) {
+                return {
+                    issue: "lines-out-of-range",
+                    detail: `${from}-${to} (file has ${totalLines} lines)`,
+                };
+            }
+        }
+    }
+    return null;
+}
+export async function runDriftCheck(rootPath, loomPath) {
+    const summaries = await listDiagrams(loomPath);
+    const perDiagram = [];
+    let totalDrift = 0;
+    let totalSchemaErrors = 0;
+    for (const s of summaries) {
+        let diagram;
+        try {
+            diagram = await readDiagram(loomPath, s.id);
+        }
+        catch (e) {
+            perDiagram.push({
+                diagramId: s.id,
+                title: s.title,
+                nodeCount: 0,
+                edgeCount: 0,
+                refsChecked: 0,
+                staleNodes: 0,
+                drift: [],
+                schemaErrors: [`failed to read: ${e.message}`],
+            });
+            totalSchemaErrors++;
+            continue;
+        }
+        const schemaResult = await validateDiagram(diagram);
+        const schemaErrors = schemaResult.ok ? [] : schemaResult.errors;
+        totalSchemaErrors += schemaErrors.length;
+        const drift = [];
+        let refsChecked = 0;
+        let staleNodes = 0;
+        for (const node of diagram.nodes) {
+            if (node.status === "stale")
+                staleNodes++;
+            // Skip drift checking on nodes that are explicitly planned or deprecated;
+            // their code may legitimately not exist yet, or have moved on.
+            if (node.status === "planned" || node.status === "deprecated")
+                continue;
+            for (const [i, ref] of (node.code_refs ?? []).entries()) {
+                refsChecked++;
+                const finding = await checkRef(rootPath, ref);
+                if (finding) {
+                    drift.push({
+                        diagramId: s.id,
+                        nodeId: node.id,
+                        refIndex: i,
+                        ref,
+                        ...finding,
+                    });
+                }
+            }
+        }
+        totalDrift += drift.length;
+        perDiagram.push({
+            diagramId: s.id,
+            title: s.title,
+            nodeCount: diagram.nodes.length,
+            edgeCount: diagram.edges.length,
+            refsChecked,
+            staleNodes,
+            drift,
+            schemaErrors,
+        });
+    }
+    return { perDiagram, totalDrift, totalSchemaErrors };
+}
+//# sourceMappingURL=drift.js.map

package/dist/server/drift.js.map

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

package/dist/server/fileOps.d.ts

@@ -0,0 +1,13 @@
+import type { LoomDiagram } from "../types/diagram.js";
+import type { LoomNodeTypes } from "../types/node-types.js";
+export interface DiagramSummary {
+    id: string;
+    title: string;
+    description?: string;
+    nodeCount: number;
+    edgeCount: number;
+}
+export declare function listDiagrams(loomPath: string): Promise<DiagramSummary[]>;
+export declare function readDiagram(loomPath: string, id: string): Promise<LoomDiagram>;
+export declare function writeDiagram(loomPath: string, id: string, data: LoomDiagram, onWritten?: (path: string) => void): Promise<void>;
+export declare function readNodeTypes(loomPath: string): Promise<LoomNodeTypes>;