flowspec-mcp 4.2.2 → 5.0.0

package/dist/export/jsonExporter.d.ts

@@ -0,0 +1,6 @@
+import type { CanvasNode, CanvasEdge, Screen } from '../types.js';
+/**
+ * Exports canvas state to JSON specification optimised for Claude Code.
+ * Adapted from web app — uses plain interfaces instead of @xyflow/svelte types.
+ */
+export declare function exportToJson(nodes: CanvasNode[], edges: CanvasEdge[], projectName?: string, screens?: Screen[]): string;

package/dist/export/jsonExporter.js

@@ -0,0 +1,151 @@
+/**
+ * Exports canvas state to JSON specification optimised for Claude Code.
+ * Adapted from web app — uses plain interfaces instead of @xyflow/svelte types.
+ */
+export function exportToJson(nodes, edges, projectName = 'Untitled Project', screens = []) {
+    const exportableNodes = nodes.filter((n) => n.type !== 'image' && n.type !== 'screen');
+    const dataPointNodes = exportableNodes.filter((n) => n.type === 'datapoint');
+    const componentNodes = exportableNodes.filter((n) => n.type === 'component');
+    const transformNodes = exportableNodes.filter((n) => n.type === 'transform');
+    const tableNodes = exportableNodes.filter((n) => n.type === 'table');
+    const locationMap = buildLocationMap(dataPointNodes, componentNodes, edges);
+    // Build node label lookup for screen region export
+    const nodeLabelMap = new Map();
+    for (const n of exportableNodes) {
+        const label = n.data.label ?? 'Untitled';
+        nodeLabelMap.set(n.id, { label, type: n.type ?? 'unknown' });
+    }
+    const spec = {
+        version: '1.2.0',
+        metadata: {
+            projectName,
+            exportedAt: new Date().toISOString(),
+            nodeCount: exportableNodes.length,
+            edgeCount: edges.length,
+        },
+        dataPoints: dataPointNodes.map((node) => {
+            const data = node.data;
+            return {
+                id: node.id,
+                label: data.label,
+                type: data.type,
+                source: data.source,
+                sourceDefinition: data.sourceDefinition,
+                constraints: data.constraints,
+                locations: locationMap.get(node.id) ?? [],
+            };
+        }),
+        components: componentNodes.map((node) => {
+            const data = node.data;
+            const result = {
+                id: node.id,
+                label: data.label,
+                displays: data.displays,
+                captures: data.captures,
+            };
+            if (data.wireframeRef) {
+                result.wireframeRef = data.wireframeRef;
+            }
+            return result;
+        }),
+        transforms: transformNodes.map((node) => {
+            const data = node.data;
+            return {
+                id: node.id,
+                type: data.type,
+                description: data.description,
+                inputs: data.inputs,
+                outputs: data.outputs,
+                logic: data.logic,
+            };
+        }),
+        dataFlow: edges.filter((e) => {
+            return e.data?.edgeType !== 'contains';
+        }).map((edge) => {
+            const result = {
+                from: edge.source,
+                to: edge.target,
+                edgeType: edge.data?.edgeType ?? 'flows-to',
+            };
+            if (edge.data?.label) {
+                result.label = edge.data.label;
+            }
+            return result;
+        }),
+    };
+    // Add tables section if table nodes exist
+    if (tableNodes.length > 0) {
+        spec.tables = tableNodes.map((node) => {
+            const data = node.data;
+            const result = {
+                id: node.id,
+                label: data.label,
+                sourceType: data.sourceType,
+                columns: (data.columns ?? []).map((c) => ({ name: c.name, type: c.type })),
+            };
+            if (data.endpoint) {
+                result.endpoint = data.endpoint;
+            }
+            return result;
+        });
+    }
+    // Add screens section if screens exist
+    if (screens.length > 0) {
+        spec.screens = screens.map((sc) => ({
+            id: sc.id,
+            name: sc.name,
+            imageFilename: sc.imageFilename,
+            regions: sc.regions.map((r) => {
+                const region = {
+                    id: r.id,
+                    label: r.label,
+                    position: {
+                        x: Math.round(r.position.x * 10) / 10,
+                        y: Math.round(r.position.y * 10) / 10,
+                    },
+                    size: {
+                        width: Math.round(r.size.width * 10) / 10,
+                        height: Math.round(r.size.height * 10) / 10,
+                    },
+                    elements: r.elementIds.map((eid) => {
+                        const info = nodeLabelMap.get(eid);
+                        return {
+                            nodeId: eid,
+                            nodeLabel: info?.label ?? 'Missing element',
+                            nodeType: info?.type ?? 'unknown',
+                        };
+                    }),
+                };
+                if (r.componentNodeId) {
+                    region.componentNodeId = r.componentNodeId;
+                }
+                return region;
+            }),
+        }));
+    }
+    return JSON.stringify(spec, null, 2);
+}
+function buildLocationMap(dataPoints, components, edges) {
+    const map = new Map();
+    for (const dp of dataPoints) {
+        map.set(dp.id, []);
+    }
+    for (const edge of edges) {
+        const sourceIsDataPoint = dataPoints.some((n) => n.id === edge.source);
+        const targetIsComponent = components.some((n) => n.id === edge.target);
+        if (sourceIsDataPoint && targetIsComponent) {
+            const locations = map.get(edge.source) ?? [];
+            locations.push({ component: edge.target, role: 'output' });
+            map.set(edge.source, locations);
+        }
+        const sourceIsComponent = components.some((n) => n.id === edge.source);
+        const targetIsDataPoint = dataPoints.some((n) => n.id === edge.target);
+        if (sourceIsComponent && targetIsDataPoint) {
+            const locations = map.get(edge.target) ?? [];
+            locations.push({ component: edge.source, role: 'input' });
+            map.set(edge.target, locations);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=jsonExporter.js.map

package/dist/export/jsonExporter.js.map

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

package/dist/import/jsonImporter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Converts a validated JSON spec back into FlowSpec canvas nodes and edges.
+ * Ported from src/lib/import/yamlImporter.ts — uses MCP types, no @xyflow deps.
+ * Lenient: uses sensible defaults for missing fields, skips broken edges.
+ */
+import type { CanvasNode, CanvasEdge, Screen } from '../types.js';
+export interface ImportResult {
+    nodes: CanvasNode[];
+    edges: CanvasEdge[];
+    screens: Screen[];
+    projectName: string;
+    stats: {
+        dataPoints: number;
+        components: number;
+        transforms: number;
+        tables: number;
+        edges: number;
+        skippedEdges: number;
+        skippedNodes: number;
+    };
+}
+export declare function importFromJson(spec: Record<string, unknown>): ImportResult;

package/dist/import/jsonImporter.js

@@ -0,0 +1,227 @@
+export function importFromJson(spec) {
+    const metadata = (spec.metadata ?? {});
+    const projectName = metadata.projectName ?? 'Imported Project';
+    const rawDataPoints = spec.dataPoints ?? [];
+    const rawComponents = spec.components ?? [];
+    const rawTransforms = spec.transforms ?? [];
+    const rawDataFlow = spec.dataFlow ?? [];
+    const rawTables = spec.tables ?? [];
+    const nodes = [];
+    const seenIds = new Set();
+    let skippedNodes = 0;
+    // --- DataPoints ---
+    for (const dp of rawDataPoints) {
+        const id = dp.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        nodes.push({
+            id,
+            type: 'datapoint',
+            position: { x: 0, y: 0 },
+            data: {
+                label: dp.label ?? 'Untitled',
+                type: validDataType(dp.type),
+                source: validSource(dp.source),
+                sourceDefinition: dp.sourceDefinition ?? '',
+                constraints: Array.isArray(dp.constraints) ? dp.constraints : []
+            }
+        });
+    }
+    // --- Components ---
+    for (const comp of rawComponents) {
+        const id = comp.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        const data = {
+            label: comp.label ?? 'Untitled Component',
+            displays: Array.isArray(comp.displays) ? comp.displays : [],
+            captures: Array.isArray(comp.captures) ? comp.captures : []
+        };
+        if (comp.wireframeRef) {
+            data.wireframeRef = comp.wireframeRef;
+        }
+        nodes.push({ id, type: 'component', position: { x: 0, y: 0 }, data });
+    }
+    // --- Transforms ---
+    for (const tx of rawTransforms) {
+        const id = tx.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        const description = tx.description ?? '';
+        const rawLogic = (tx.logic ?? {});
+        nodes.push({
+            id,
+            type: 'transform',
+            position: { x: 0, y: 0 },
+            data: {
+                label: description || 'Untitled Transform',
+                type: validLogicType(tx.type),
+                description,
+                inputs: Array.isArray(tx.inputs) ? tx.inputs : [],
+                outputs: Array.isArray(tx.outputs) ? tx.outputs : [],
+                logic: {
+                    type: validLogicContentType(rawLogic.type),
+                    content: rawLogic.content ?? ''
+                }
+            }
+        });
+    }
+    // --- Tables ---
+    for (const tbl of rawTables) {
+        const id = tbl.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        const rawColumns = Array.isArray(tbl.columns) ? tbl.columns : [];
+        const columns = rawColumns.map((c) => ({
+            name: c.name ?? '',
+            type: validDataType(c.type)
+        }));
+        nodes.push({
+            id,
+            type: 'table',
+            position: { x: 0, y: 0 },
+            data: {
+                label: tbl.label ?? 'Untitled Table',
+                sourceType: validTableSourceType(tbl.sourceType),
+                columns,
+                endpoint: tbl.endpoint ?? ''
+            }
+        });
+    }
+    // --- Edges (no markerEnd — visual-only, not needed in canvas_state) ---
+    const edges = [];
+    let skippedEdges = 0;
+    for (const flow of rawDataFlow) {
+        const from = flow.from;
+        const to = flow.to;
+        if (!from || !to || !seenIds.has(from) || !seenIds.has(to)) {
+            skippedEdges++;
+            continue;
+        }
+        const edgeData = {
+            edgeType: validEdgeType(flow.edgeType)
+        };
+        if (flow.label) {
+            edgeData.label = flow.label;
+        }
+        edges.push({
+            id: crypto.randomUUID(),
+            source: from,
+            target: to,
+            type: 'typed',
+            data: edgeData
+        });
+    }
+    // --- Screens (import metadata + auto-create screen nodes) ---
+    const screens = [];
+    const rawScreens = spec.screens ?? [];
+    let screenOffsetY = 50;
+    for (const rawSc of rawScreens) {
+        const screenId = rawSc.id ?? crypto.randomUUID();
+        const rawRegions = Array.isArray(rawSc.regions) ? rawSc.regions : [];
+        const regions = rawRegions.map((r) => {
+            const rawElements = Array.isArray(r.elements) ? r.elements : [];
+            return {
+                id: r.id ?? crypto.randomUUID(),
+                label: r.label,
+                position: {
+                    x: (r.position?.x ?? 10),
+                    y: (r.position?.y ?? 10)
+                },
+                size: {
+                    width: (r.size?.width ?? 20),
+                    height: (r.size?.height ?? 15)
+                },
+                elementIds: rawElements
+                    .map((el) => el.nodeId)
+                    .filter((eid) => seenIds.has(eid)),
+                componentNodeId: r.componentNodeId || undefined
+            };
+        });
+        const elementCount = regions.reduce((sum, r) => sum + r.elementIds.length, 0);
+        screens.push({
+            id: screenId,
+            name: rawSc.name ?? 'Imported Screen',
+            imageUrl: '',
+            imageWidth: 1920,
+            imageHeight: 1080,
+            imageFilename: rawSc.imageFilename,
+            regions
+        });
+        // Auto-create screen node on canvas
+        const screenNodeId = crypto.randomUUID();
+        nodes.push({
+            id: screenNodeId,
+            type: 'screen',
+            position: { x: 50, y: screenOffsetY },
+            data: {
+                label: rawSc.name ?? 'Imported Screen',
+                screenId,
+                regionCount: regions.length,
+                elementCount
+            }
+        });
+        screenOffsetY += 160;
+    }
+    return {
+        nodes,
+        edges,
+        screens,
+        projectName,
+        stats: {
+            dataPoints: nodes.filter((n) => n.type === 'datapoint').length,
+            components: nodes.filter((n) => n.type === 'component').length,
+            transforms: nodes.filter((n) => n.type === 'transform').length,
+            tables: nodes.filter((n) => n.type === 'table').length,
+            edges: edges.length,
+            skippedEdges,
+            skippedNodes
+        }
+    };
+}
+// --- Validation helpers with defaults ---
+const VALID_DATA_TYPES = new Set(['string', 'number', 'boolean', 'object', 'array']);
+function validDataType(t) {
+    return t && VALID_DATA_TYPES.has(t) ? t : 'string';
+}
+const VALID_SOURCES = new Set(['captured', 'inferred']);
+function validSource(s) {
+    return s && VALID_SOURCES.has(s) ? s : 'captured';
+}
+const VALID_LOGIC_TYPES = new Set(['formula', 'validation', 'workflow']);
+function validLogicType(t) {
+    return t && VALID_LOGIC_TYPES.has(t) ? t : 'formula';
+}
+const VALID_LOGIC_CONTENT_TYPES = new Set(['formula', 'decision_table', 'steps']);
+function validLogicContentType(t) {
+    return t && VALID_LOGIC_CONTENT_TYPES.has(t)
+        ? t
+        : 'formula';
+}
+const VALID_TABLE_SOURCE_TYPES = new Set(['database', 'api', 'file', 'manual']);
+function validTableSourceType(t) {
+    return t && VALID_TABLE_SOURCE_TYPES.has(t) ? t : 'database';
+}
+const VALID_EDGE_TYPES = new Set([
+    'flows-to',
+    'derives-from',
+    'transforms',
+    'validates',
+    'contains'
+]);
+function validEdgeType(t) {
+    return t && VALID_EDGE_TYPES.has(t) ? t : 'flows-to';
+}
+//# sourceMappingURL=jsonImporter.js.map

package/dist/import/jsonImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonImporter.js","sourceRoot":"","sources":["../../src/import/jsonImporter.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,cAAc,CAAC,IAA6B;IAC3D,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAA4B,CAAC;IAClE,MAAM,WAAW,GAAI,QAAQ,CAAC,WAAsB,IAAI,kBAAkB,CAAC;IAE3E,MAAM,aAAa,GAAI,IAAI,CAAC,UAAwC,IAAI,EAAE,CAAC;IAC3E,MAAM,aAAa,GAAI,IAAI,CAAC,UAAwC,IAAI,EAAE,CAAC;IAC3E,MAAM,aAAa,GAAI,IAAI,CAAC,UAAwC,IAAI,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAI,IAAI,CAAC,QAAsC,IAAI,EAAE,CAAC;IACvE,MAAM,SAAS,GAAI,IAAI,CAAC,MAAoC,IAAI,EAAE,CAAC;IAEnE,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,qBAAqB;IACrB,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAwB,CAAC;QACvC,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,YAAY,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,KAAK,CAAC,IAAI,CAAC;YACV,EAAE;YACF,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YACxB,IAAI,EAAE;gBACL,KAAK,EAAG,EAAE,CAAC,KAAgB,IAAI,UAAU;gBACzC,IAAI,EAAE,aAAa,CAAC,EAAE,CAAC,IAAc,CAAC;gBACtC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,MAAgB,CAAC;gBACxC,gBAAgB,EAAG,EAAE,CAAC,gBAA2B,IAAI,EAAE;gBACvD,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,WAAwB,CAAC,CAAC,CAAC,EAAE;aAC9E;SACD,CAAC,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAwB,CAAC;QACzC,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,YAAY,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,IAAI,GAA4B;YACrC,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,oBAAoB;YACrD,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,QAAqB,CAAC,CAAC,CAAC,EAAE;YACzE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,QAAqB,CAAC,CAAC,CAAC,EAAE;SACzE,CAAC;QACF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAsB,CAAC;QACjD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,qBAAqB;IACrB,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAwB,CAAC;QACvC,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,YAAY,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,WAAW,GAAI,EAAE,CAAC,WAAsB,IAAI,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;QAE7D,KAAK,CAAC,IAAI,CAAC;YACV,EAAE;YACF,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YACxB,IAAI,EAAE;gBACL,KAAK,EAAE,WAAW,IAAI,oBAAoB;gBAC1C,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,IAAc,CAAC;gBACvC,WAAW;gBACX,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,MAAmB,CAAC,CAAC,CAAC,EAAE;gBAC/D,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,OAAoB,CAAC,CAAC,CAAC,EAAE;gBAClE,KAAK,EAAE;oBACN,IAAI,EAAE,qBAAqB,CAAC,QAAQ,CAAC,IAAc,CAAC;oBACpD,OAAO,EAAG,QAAQ,CAAC,OAA4C,IAAI,EAAE;iBACrE;aACD;SACD,CAAC,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,GAAG,CAAC,EAAwB,CAAC;QACxC,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,YAAY,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,OAAqC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAG,CAAC,CAAC,IAAe,IAAI,EAAE;YAC9B,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,IAAc,CAAC;SACrC,CAAC,CAAC,CAAC;QAEJ,KAAK,CAAC,IAAI,CAAC;YACV,EAAE;YACF,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YACxB,IAAI,EAAE;gBACL,KAAK,EAAG,GAAG,CAAC,KAAgB,IAAI,gBAAgB;gBAChD,UAAU,EAAE,oBAAoB,CAAC,GAAG,CAAC,UAAoB,CAAC;gBAC1D,OAAO;gBACP,QAAQ,EAAG,GAAG,CAAC,QAAmB,IAAI,EAAE;aACxC;SACD,CAAC,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAA0B,CAAC;QAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAwB,CAAC;QAEzC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5D,YAAY,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QAED,MAAM,QAAQ,GAA4B;YACzC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,QAAkB,CAAC;SAChD,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;SACd,CAAC,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAI,IAAI,CAAC,OAAqC,IAAI,EAAE,CAAC;IACrE,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAI,KAAK,CAAC,EAAa,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC7D,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,OAAqC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpG,MAAM,OAAO,GAAmB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,QAAsC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/F,OAAO;gBACN,EAAE,EAAG,CAAC,CAAC,EAAa,IAAI,MAAM,CAAC,UAAU,EAAE;gBAC3C,KAAK,EAAE,CAAC,CAAC,KAA2B;gBACpC,QAAQ,EAAE;oBACT,CAAC,EAAE,CAAE,CAAC,CAAC,QAA2B,EAAE,CAAC,IAAI,EAAE,CAAC;oBAC5C,CAAC,EAAE,CAAE,CAAC,CAAC,QAA2B,EAAE,CAAC,IAAI,EAAE,CAAC;iBAC5C;gBACD,IAAI,EAAE;oBACL,KAAK,EAAE,CAAE,CAAC,CAAC,IAA2B,EAAE,KAAK,IAAI,EAAE,CAAC;oBACpD,MAAM,EAAE,CAAE,CAAC,CAAC,IAA4B,EAAE,MAAM,IAAI,EAAE,CAAC;iBACvD;gBACD,UAAU,EAAE,WAAW;qBACrB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAgB,CAAC;qBAChC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACnC,eAAe,EAAG,CAAC,CAAC,eAA0B,IAAI,SAAS;aAC3D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE9E,OAAO,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAG,KAAK,CAAC,IAAe,IAAI,iBAAiB;YACjD,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,KAAK,CAAC,aAAmC;YACxD,OAAO;SACP,CAAC,CAAC;QAEH,oCAAoC;QACpC,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,aAAa,EAAE;YACrC,IAAI,EAAE;gBACL,KAAK,EAAG,KAAK,CAAC,IAAe,IAAI,iBAAiB;gBAClD,QAAQ;gBACR,WAAW,EAAE,OAAO,CAAC,MAAM;gBAC3B,YAAY;aACZ;SACD,CAAC,CAAC;QACH,aAAa,IAAI,GAAG,CAAC;IACtB,CAAC;IAED,OAAO;QACN,KAAK;QACL,KAAK;QACL,OAAO;QACP,WAAW;QACX,KAAK,EAAE;YACN,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,MAAM;YAC9D,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,MAAM;YAC9D,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,MAAM;YAC9D,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM;YACtD,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,YAAY;YACZ,YAAY;SACZ;KACD,CAAC;AACH,CAAC;AAED,2CAA2C;AAE3C,MAAM,gBAAgB,GAAgB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAClG,SAAS,aAAa,CAAC,CAAqB;IAC3C,OAAO,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC;AAED,MAAM,aAAa,GAAgB,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AACrE,SAAS,WAAW,CAAC,CAAqB;IACzC,OAAO,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAgB,CAAC,CAAC,CAAC,UAAU,CAAC;AACnE,CAAC;AAED,MAAM,iBAAiB,GAAgB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;AACtF,SAAS,cAAc,CAAC,CAAqB;IAC5C,OAAO,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAe,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,MAAM,yBAAyB,GAAgB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/F,SAAS,qBAAqB,CAAC,CAAqB;IACnD,OAAO,CAAC,IAAI,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAE,CAA4C;QAC/C,CAAC,CAAC,SAAS,CAAC;AACd,CAAC;AAED,MAAM,wBAAwB,GAAgB,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC7F,SAAS,oBAAoB,CAAC,CAAqB;IAClD,OAAO,CAAC,IAAI,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAqB,CAAC,CAAC,CAAC,UAAU,CAAC;AACnF,CAAC;AAED,MAAM,gBAAgB,GAAgB,IAAI,GAAG,CAAC;IAC7C,UAAU;IACV,cAAc;IACd,YAAY;IACZ,WAAW;IACX,UAAU;CACV,CAAC,CAAC;AACH,SAAS,aAAa,CAAC,CAAqB;IAC3C,OAAO,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,UAAU,CAAC;AACpE,CAAC"}

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { listProjectsSchema, handleListProjects } from './tools/listProjects.js';
-import { getYamlSchema, handleGetYaml } from './tools/getYaml.js';
+import { getJsonSchema, handleGetJson } from './tools/getJson.js';
 import { getProjectSchema, handleGetProject } from './tools/getProject.js';
 import { searchNodesSchema, handleSearchNodes } from './tools/searchNodes.js';
 import { getScreenContextSchema, handleGetScreenContext } from './tools/getScreenContext.js';
@@ -14,8 +14,9 @@ import { deleteNodeSchema, handleDeleteNode } from './tools/deleteNode.js';
 import { createEdgeSchema, handleCreateEdge } from './tools/createEdge.js';
 import { deleteEdgeSchema, handleDeleteEdge } from './tools/deleteEdge.js';
 import { analyseProjectSchema, handleAnalyseProject } from './tools/analyseProject.js';
+import { validateProjectSchema, handleValidateProject } from './tools/validateProject.js';
 // v3 write tools
-import { importYamlSchema, handleImportYaml } from './tools/importYaml.js';
+import { importJsonSchema, handleImportJson } from './tools/importJson.js';
 import { autoLayoutSchema, handleAutoLayout } from './tools/autoLayout.js';
 import { uploadImageSchema, handleUploadImage } from './tools/uploadImage.js';
 import { createScreenSchema, handleCreateScreen } from './tools/createScreen.js';
@@ -30,14 +31,14 @@ import { MODE } from './config.js';
 export function createServer() {
     const server = new McpServer({
         name: 'flowspec',
-        version: '4.2.2',
+        version: '5.0.0',
     });
     // ─── Read tools ──────────────────────────────────────────────────
     server.tool('flowspec_list_projects', 'List all FlowSpec projects with names and dates', listProjectsSchema.shape, handleListProjects);
-    server.tool('flowspec_get_yaml', 'Get the full YAML spec for a FlowSpec project (optimised for Claude Code consumption)', getYamlSchema.shape, handleGetYaml);
+    server.tool('flowspec_get_json', 'Get the full JSON spec for a FlowSpec project (optimised for Claude Code consumption)', getJsonSchema.shape, handleGetJson);
     server.tool('flowspec_get_project', 'Get project data (nodes, edges, screens) for a FlowSpec project', getProjectSchema.shape, handleGetProject);
     server.tool('flowspec_search_nodes', 'Search for nodes by label across all projects, optionally filtered by type', searchNodesSchema.shape, handleSearchNodes);
-    server.tool('flowspec_get_screen_context', 'Get screen/region/element structure for a FlowSpec project (lightweight alternative to full YAML)', getScreenContextSchema.shape, handleGetScreenContext);
+    server.tool('flowspec_get_screen_context', 'Get screen/region/element structure for a FlowSpec project (lightweight alternative to full JSON)', getScreenContextSchema.shape, handleGetScreenContext);
     // ─── Write tools (v2) ────────────────────────────────────────────
     server.tool('flowspec_create_project', 'Create a new FlowSpec project. Before building from a codebase, scan source files for @flowspec annotations (left by the codebase-indexer skill) to avoid re-discovering already-indexed elements.', createProjectSchema.shape, handleCreateProject);
     server.tool('flowspec_update_project', 'Update a project name or replace its entire canvas state', updateProjectSchema.shape, handleUpdateProject);
@@ -48,8 +49,9 @@ export function createServer() {
     server.tool('flowspec_create_edge', 'Connect two nodes with an edge type (flows-to, derives-from, transforms, validates, contains)', createEdgeSchema.shape, handleCreateEdge);
     server.tool('flowspec_delete_edge', 'Remove an edge from a project', deleteEdgeSchema.shape, handleDeleteEdge);
     server.tool('flowspec_analyse_project', 'Run orphan node and duplicate label analysis on a project', analyseProjectSchema.shape, handleAnalyseProject);
+    server.tool('flowspec_validate_project', 'Validate data flow semantics: DataPoint sources, Transform I/O, Component references, type matching, and circular dependencies', validateProjectSchema.shape, handleValidateProject);
     // ─── Write tools (v3) ────────────────────────────────────────────
-    server.tool('flowspec_import_yaml', 'Import specification to create/merge nodes, edges, and screens. If the codebase has @flowspec annotations, incorporate them into the spec before importing to avoid duplicating pre-indexed elements.', importYamlSchema.shape, handleImportYaml);
+    server.tool('flowspec_import_json', 'Import JSON specification to create/merge nodes, edges, and screens. If the codebase has @flowspec annotations, incorporate them into the spec before importing to avoid duplicating pre-indexed elements.', importJsonSchema.shape, handleImportJson);
     server.tool('flowspec_auto_layout', 'Apply automatic hierarchical layout (Dagre) to organize nodes', autoLayoutSchema.shape, handleAutoLayout);
     server.tool('flowspec_upload_image', 'Upload an image and get its URL with auto-detected dimensions', uploadImageSchema.shape, handleUploadImage);
     server.tool('flowspec_create_screen', 'Create a new wireframe screen with optional image', createScreenSchema.shape, handleCreateScreen);
@@ -60,7 +62,7 @@ export function createServer() {
     server.tool('flowspec_remove_region', 'Remove a region from a screen', removeRegionSchema.shape, handleRemoveRegion);
     server.tool('flowspec_update_edge', 'Update edge type, label, or handle positions', updateEdgeSchema.shape, handleUpdateEdge);
     server.tool('flowspec_clone_project', 'Clone a project for backup or branching', cloneProjectSchema.shape, handleCloneProject);
-    console.error(`FlowSpec MCP v4.2.0 — mode: ${MODE}`);
+    console.error(`FlowSpec MCP v5.0.0 — mode: ${MODE}`);
     return server;
 }
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/getJson.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const getJsonSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export declare function handleGetJson(args: z.infer<typeof getJsonSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/tools/getJson.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { getProject } from '../db.js';
+import { exportToJson } from '../export/jsonExporter.js';
+export const getJsonSchema = z.object({
+    projectId: z.string().describe('UUID of the FlowSpec project'),
+});
+export async function handleGetJson(args) {
+    const project = await getProject(args.projectId);
+    if (!project) {
+        return {
+            content: [{ type: 'text', text: `Project not found: ${args.projectId}` }],
+            isError: true,
+        };
+    }
+    const nodes = project.canvas_state?.nodes ?? [];
+    const edges = project.canvas_state?.edges ?? [];
+    const screens = project.canvas_state?.screens ?? [];
+    const json = exportToJson(nodes, edges, project.name, screens);
+    return {
+        content: [{ type: 'text', text: json }],
+    };
+}
+//# sourceMappingURL=getJson.js.map

package/dist/tools/getJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getJson.js","sourceRoot":"","sources":["../../src/tools/getJson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAmC;IACrE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAClF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,OAAO,IAAI,EAAE,CAAC;IAEpD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE/D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/tools/importJson.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const importJsonSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    json: z.ZodString;
+    autoLayout: z.ZodOptional<z.ZodBoolean>;
+    layoutDirection: z.ZodOptional<z.ZodEnum<["TB", "BT", "LR", "RL"]>>;
+    merge: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    json: string;
+    autoLayout?: boolean | undefined;
+    layoutDirection?: "TB" | "BT" | "LR" | "RL" | undefined;
+    merge?: boolean | undefined;
+}, {
+    projectId: string;
+    json: string;
+    autoLayout?: boolean | undefined;
+    layoutDirection?: "TB" | "BT" | "LR" | "RL" | undefined;
+    merge?: boolean | undefined;
+}>;
+export declare function handleImportJson(args: z.infer<typeof importJsonSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/tools/importJson.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { getProject, updateProjectViaApi } from '../db.js';
+import { importFromJson } from '../import/jsonImporter.js';
+import { computeAutoLayout } from '../layout/autoLayout.js';
+export const importJsonSchema = z.object({
+    projectId: z.string().describe('UUID of the target project'),
+    json: z.string().describe('JSON spec string (FlowSpec v1.2.0 format)'),
+    autoLayout: z.boolean().optional().describe('Run dagre auto-layout after import (default: true)'),
+    layoutDirection: z.enum(['TB', 'BT', 'LR', 'RL']).optional().describe('Layout direction (default: TB)'),
+    merge: z.boolean().optional().describe('true = add to existing canvas, false = replace (default: false)'),
+});
+export async function handleImportJson(args) {
+    // Parse JSON string
+    let spec;
+    try {
+        spec = JSON.parse(args.json);
+    }
+    catch (e) {
+        return {
+            content: [{ type: 'text', text: `JSON parse error: ${e.message}` }],
+            isError: true,
+        };
+    }
+    if (!spec || typeof spec !== 'object') {
+        return {
+            content: [{ type: 'text', text: 'Invalid JSON: expected an object at the top level' }],
+            isError: true,
+        };
+    }
+    // Import JSON → nodes/edges/screens
+    const result = importFromJson(spec);
+    // Apply auto-layout if requested (default: true)
+    const shouldLayout = args.autoLayout !== false;
+    if (shouldLayout && result.nodes.length > 0) {
+        const direction = args.layoutDirection ?? 'TB';
+        const positions = computeAutoLayout(result.nodes, result.edges, { rankdir: direction, pinnedNodeIds: new Set() });
+        for (const node of result.nodes) {
+            const pos = positions.get(node.id);
+            if (pos)
+                node.position = pos;
+        }
+    }
+    // Build canvas state
+    let nodes;
+    let edges;
+    let screens = result.screens;
+    if (args.merge) {
+        // Merge mode: add imported nodes/edges/screens to existing
+        const project = await getProject(args.projectId);
+        if (!project) {
+            return {
+                content: [{ type: 'text', text: `Project not found: ${args.projectId}` }],
+                isError: true,
+            };
+        }
+        const existing = project.canvas_state;
+        nodes = [...(existing.nodes ?? []), ...result.nodes];
+        edges = [...(existing.edges ?? []), ...result.edges];
+        screens = [...(existing.screens ?? []), ...result.screens];
+    }
+    else {
+        // Replace mode: imported data replaces existing canvas
+        nodes = result.nodes;
+        edges = result.edges;
+    }
+    const canvasState = { nodes, edges, screens };
+    const updated = await updateProjectViaApi(args.projectId, { canvas_state: canvasState });
+    if (!updated) {
+        return {
+            content: [{ type: 'text', text: `Failed to update project — not found: ${args.projectId}` }],
+            isError: true,
+        };
+    }
+    const { stats } = result;
+    const lines = [
+        `Imported JSON into project **${updated.name}**`,
+        '',
+        `| Metric | Count |`,
+        `|--------|-------|`,
+        `| Data points | ${stats.dataPoints} |`,
+        `| Components | ${stats.components} |`,
+        `| Transforms | ${stats.transforms} |`,
+        `| Tables | ${stats.tables} |`,
+        `| Edges | ${stats.edges} |`,
+        `| Screens | ${result.screens.length} |`,
+        `| Skipped nodes | ${stats.skippedNodes} |`,
+        `| Skipped edges | ${stats.skippedEdges} |`,
+        '',
+        `Mode: ${args.merge ? 'merge (added to existing)' : 'replace'}`,
+        shouldLayout ? `Layout: ${args.layoutDirection ?? 'TB'}` : 'Layout: skipped',
+    ];
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=importJson.js.map

package/dist/tools/importJson.js.map

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

package/dist/tools/validateProject.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const validateProjectSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export declare function handleValidateProject(args: z.infer<typeof validateProjectSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/tools/validateProject.js

@@ -0,0 +1,299 @@
+import { z } from 'zod';
+import { getProject } from '../db.js';
+export const validateProjectSchema = z.object({
+    projectId: z.string().describe('UUID of the project to validate'),
+});
+// ─── Validation Functions ────────────────────────────────────────
+function validateDataPointSources(nodes, edges) {
+    const issues = [];
+    const dataPoints = nodes.filter((n) => n.type === 'datapoint');
+    for (const dp of dataPoints) {
+        const source = dp.data?.source ?? 'captured';
+        const label = dp.data?.label ?? 'Untitled';
+        const incomingEdges = edges.filter((e) => e.target === dp.id);
+        const sourceNodeTypes = incomingEdges
+            .map((e) => {
+            const sourceNode = nodes.find((n) => n.id === e.source);
+            return sourceNode?.type ?? 'unknown';
+        })
+            .filter((t) => t !== 'unknown');
+        let expectedTypes = [];
+        switch (source) {
+            case 'captured':
+                expectedTypes = ['screen', 'component'];
+                break;
+            case 'retrieved':
+                expectedTypes = ['table', 'transform', 'component'];
+                break;
+            case 'inferred':
+                expectedTypes = ['transform'];
+                break;
+        }
+        if (incomingEdges.length === 0) {
+            issues.push({
+                violation: 'missing-source',
+                nodeId: dp.id,
+                label,
+                source,
+                expectedSourceTypes: expectedTypes,
+                actualSourceTypes: [],
+            });
+            continue;
+        }
+        if (incomingEdges.length > 1) {
+            issues.push({
+                violation: 'multiple-sources',
+                nodeId: dp.id,
+                label,
+                source,
+                expectedSourceTypes: expectedTypes,
+                actualSourceTypes: sourceNodeTypes,
+            });
+            continue;
+        }
+        const actualType = sourceNodeTypes[0];
+        if (!expectedTypes.includes(actualType)) {
+            issues.push({
+                violation: 'wrong-source-type',
+                nodeId: dp.id,
+                label,
+                source,
+                expectedSourceTypes: expectedTypes,
+                actualSourceTypes: [actualType],
+            });
+        }
+    }
+    return issues;
+}
+function validateTransforms(nodes, edges) {
+    const issues = [];
+    const transforms = nodes.filter((n) => n.type === 'transform');
+    for (const transform of transforms) {
+        const label = transform.data?.label ?? 'Untitled';
+        const transformType = transform.data?.type ?? 'formula';
+        const incomingEdges = edges.filter((e) => e.target === transform.id);
+        const outgoingEdges = edges.filter((e) => e.source === transform.id);
+        if (incomingEdges.length === 0) {
+            issues.push({
+                violation: 'no-inputs',
+                nodeId: transform.id,
+                label,
+                transformType,
+            });
+        }
+        if (outgoingEdges.length === 0) {
+            issues.push({
+                violation: 'no-outputs',
+                nodeId: transform.id,
+                label,
+                transformType,
+            });
+        }
+    }
+    return issues;
+}
+function validateComponentReferences(nodes) {
+    const issues = [];
+    const components = nodes.filter((n) => n.type === 'component');
+    const nodeIdSet = new Set(nodes.map((n) => n.id));
+    for (const component of components) {
+        const label = component.data?.label ?? 'Untitled';
+        const captures = component.data?.captures ?? [];
+        const displays = component.data?.displays ?? [];
+        const invalidCaptures = captures.filter((id) => !nodeIdSet.has(id));
+        if (invalidCaptures.length > 0) {
+            issues.push({
+                violation: 'invalid-capture-reference',
+                nodeId: component.id,
+                label,
+                invalidRefs: invalidCaptures,
+            });
+        }
+        const invalidDisplays = displays.filter((id) => !nodeIdSet.has(id));
+        if (invalidDisplays.length > 0) {
+            issues.push({
+                violation: 'invalid-display-reference',
+                nodeId: component.id,
+                label,
+                invalidRefs: invalidDisplays,
+            });
+        }
+    }
+    return issues;
+}
+function validateTableDataPointTypes(nodes, edges) {
+    const issues = [];
+    const dataPoints = nodes.filter((n) => n.type === 'datapoint');
+    const tables = nodes.filter((n) => n.type === 'table');
+    for (const dp of dataPoints) {
+        if (dp.data?.source !== 'retrieved')
+            continue;
+        const tableEdges = edges.filter((e) => {
+            if (e.target !== dp.id)
+                return false;
+            const sourceNode = nodes.find((n) => n.id === e.source);
+            return sourceNode?.type === 'table';
+        });
+        for (const edge of tableEdges) {
+            const table = tables.find((t) => t.id === edge.source);
+            if (!table)
+                continue;
+            const dpLabel = (dp.data?.label ?? '').toLowerCase().trim();
+            const matchingColumn = (table.data?.columns ?? []).find((col) => col.name.toLowerCase().trim() === dpLabel);
+            if (matchingColumn && matchingColumn.type !== dp.data?.type) {
+                issues.push({
+                    violation: 'type-mismatch',
+                    dataPointId: dp.id,
+                    dataPointLabel: dp.data?.label ?? 'Untitled',
+                    dataPointType: dp.data?.type ?? 'unknown',
+                    tableId: table.id,
+                    tableLabel: table.data?.label ?? 'Untitled',
+                    columnName: matchingColumn.name,
+                    columnType: matchingColumn.type,
+                });
+            }
+        }
+    }
+    return issues;
+}
+function detectCircularDependencies(nodes, edges) {
+    const issues = [];
+    const adjacency = new Map();
+    for (const node of nodes) {
+        adjacency.set(node.id, []);
+    }
+    for (const edge of edges) {
+        const edgeType = edge.data?.edgeType;
+        if (edgeType === 'derives-from' || edgeType === 'transforms') {
+            const targets = adjacency.get(edge.source) ?? [];
+            targets.push(edge.target);
+            adjacency.set(edge.source, targets);
+        }
+    }
+    const visited = new Set();
+    const recStack = new Set();
+    const cycles = [];
+    function dfs(nodeId, path) {
+        visited.add(nodeId);
+        recStack.add(nodeId);
+        path.push(nodeId);
+        const neighbors = adjacency.get(nodeId) ?? [];
+        for (const neighbor of neighbors) {
+            if (!visited.has(neighbor)) {
+                dfs(neighbor, [...path]);
+            }
+            else if (recStack.has(neighbor)) {
+                const cycleStart = path.indexOf(neighbor);
+                const cycle = path.slice(cycleStart);
+                cycles.push([...cycle, neighbor]);
+            }
+        }
+        recStack.delete(nodeId);
+    }
+    for (const node of nodes) {
+        if (!visited.has(node.id)) {
+            dfs(node.id, []);
+        }
+    }
+    const seenCycles = new Set();
+    for (const cycle of cycles) {
+        const normalized = [...cycle].sort().join('->');
+        if (seenCycles.has(normalized))
+            continue;
+        seenCycles.add(normalized);
+        const labels = cycle.map((id) => {
+            const node = nodes.find((n) => n.id === id);
+            return node?.data?.label ?? 'Unknown';
+        });
+        issues.push({
+            violation: 'circular-dependency',
+            cycle,
+            labels,
+        });
+    }
+    return issues;
+}
+// ─── Main Handler ────────────────────────────────────────────────
+export async function handleValidateProject(args) {
+    const project = await getProject(args.projectId);
+    if (!project) {
+        return {
+            content: [{ type: 'text', text: `Project not found: ${args.projectId}` }],
+            isError: true,
+        };
+    }
+    const nodes = project.canvas_state?.nodes ?? [];
+    const edges = project.canvas_state?.edges ?? [];
+    // Run all validators
+    const dataPointSourceIssues = validateDataPointSources(nodes, edges);
+    const transformIssues = validateTransforms(nodes, edges);
+    const componentReferenceIssues = validateComponentReferences(nodes);
+    const tableDataPointMismatches = validateTableDataPointTypes(nodes, edges);
+    const circularDependencies = detectCircularDependencies(nodes, edges);
+    const totalIssues = dataPointSourceIssues.length +
+        transformIssues.length +
+        componentReferenceIssues.length +
+        tableDataPointMismatches.length +
+        circularDependencies.length;
+    // Format output
+    const lines = [];
+    lines.push(`## Data Flow Validation for ${project.name}`);
+    if (totalIssues === 0) {
+        lines.push('');
+        lines.push('✅ **All data flow rules passed!**');
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    }
+    lines.push('');
+    lines.push(`⚠️ **${totalIssues} issue${totalIssues !== 1 ? 's' : ''} found** (all warnings)`);
+    // DataPoint Source Issues
+    if (dataPointSourceIssues.length > 0) {
+        lines.push('');
+        lines.push(`### DataPoint Source Issues (${dataPointSourceIssues.length})`);
+        for (const issue of dataPointSourceIssues) {
+            lines.push(`- **${issue.label}** (${issue.source}): ${issue.violation.replace(/-/g, ' ')}`);
+            lines.push(`  - Expected: ${issue.expectedSourceTypes.join(', ')}`);
+            if (issue.actualSourceTypes.length > 0) {
+                lines.push(`  - Actual: ${issue.actualSourceTypes.join(', ')}`);
+            }
+        }
+    }
+    // Transform Issues
+    if (transformIssues.length > 0) {
+        lines.push('');
+        lines.push(`### Transform Issues (${transformIssues.length})`);
+        for (const issue of transformIssues) {
+            lines.push(`- **${issue.label}** (${issue.transformType}): ${issue.violation.replace(/-/g, ' ')}`);
+        }
+    }
+    // Component Reference Issues
+    if (componentReferenceIssues.length > 0) {
+        lines.push('');
+        lines.push(`### Component Reference Issues (${componentReferenceIssues.length})`);
+        for (const issue of componentReferenceIssues) {
+            lines.push(`- **${issue.label}**: ${issue.violation.replace(/-/g, ' ')}`);
+            lines.push(`  - Invalid IDs: ${issue.invalidRefs.join(', ')}`);
+        }
+    }
+    // Table/DataPoint Type Mismatches
+    if (tableDataPointMismatches.length > 0) {
+        lines.push('');
+        lines.push(`### Type Mismatches (${tableDataPointMismatches.length})`);
+        for (const issue of tableDataPointMismatches) {
+            lines.push(`- **${issue.dataPointLabel}** (${issue.dataPointType}) ← **${issue.tableLabel}.${issue.columnName}** (${issue.columnType})`);
+        }
+    }
+    // Circular Dependencies
+    if (circularDependencies.length > 0) {
+        lines.push('');
+        lines.push(`### Circular Dependencies (${circularDependencies.length})`);
+        for (const issue of circularDependencies) {
+            lines.push(`- Cycle: ${issue.labels.join(' → ')}`);
+        }
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=validateProject.js.map

package/dist/tools/validateProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateProject.js","sourceRoot":"","sources":["../../src/tools/validateProject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAClE,CAAC,CAAC;AA4CH,oEAAoE;AAEpE,SAAS,wBAAwB,CAAC,KAAY,EAAE,KAAY;IAC1D,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAE/D,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,UAAU,CAAC;QAC7C,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC;QAE3C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,eAAe,GAAG,aAAa;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;YACxD,OAAO,UAAU,EAAE,IAAI,IAAI,SAAS,CAAC;QACvC,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAElC,IAAI,aAAa,GAAa,EAAE,CAAC;QACjC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,UAAU;gBACb,aAAa,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;gBACxC,MAAM;YACR,KAAK,WAAW;gBACd,aAAa,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;gBACpD,MAAM;YACR,KAAK,UAAU;gBACb,aAAa,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC9B,MAAM;QACV,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,gBAAgB;gBAC3B,MAAM,EAAE,EAAE,CAAC,EAAE;gBACb,KAAK;gBACL,MAAM;gBACN,mBAAmB,EAAE,aAAa;gBAClC,iBAAiB,EAAE,EAAE;aACtB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,kBAAkB;gBAC7B,MAAM,EAAE,EAAE,CAAC,EAAE;gBACb,KAAK;gBACL,MAAM;gBACN,mBAAmB,EAAE,aAAa;gBAClC,iBAAiB,EAAE,eAAe;aACnC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,mBAAmB;gBAC9B,MAAM,EAAE,EAAE,CAAC,EAAE;gBACb,KAAK;gBACL,MAAM;gBACN,mBAAmB,EAAE,aAAa;gBAClC,iBAAiB,EAAE,CAAC,UAAU,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAY,EAAE,KAAY;IACpD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAE/D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC;QAClD,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,CAAC;QAExD,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC;QACrE,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC;QAErE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,WAAW;gBACtB,MAAM,EAAE,SAAS,CAAC,EAAE;gBACpB,KAAK;gBACL,aAAa;aACd,CAAC,CAAC;QACL,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,YAAY;gBACvB,MAAM,EAAE,SAAS,CAAC,EAAE;gBACpB,KAAK;gBACL,aAAa;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAY;IAC/C,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAElD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC;QAClD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QAEhD,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,2BAA2B;gBACtC,MAAM,EAAE,SAAS,CAAC,EAAE;gBACpB,KAAK;gBACL,WAAW,EAAE,eAAe;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,2BAA2B;gBACtC,MAAM,EAAE,SAAS,CAAC,EAAE;gBACpB,KAAK;gBACL,WAAW,EAAE,eAAe;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAY,EAAE,KAAY;IAC7D,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAEvD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW;YAAE,SAAS;QAE9C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,EAAE;gBAAE,OAAO,KAAK,CAAC;YACrC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;YACxD,OAAO,UAAU,EAAE,IAAI,KAAK,OAAO,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5D,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CACrD,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,OAAO,CACxD,CAAC;YAEF,IAAI,cAAc,IAAI,cAAc,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC5D,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS,EAAE,eAAe;oBAC1B,WAAW,EAAE,EAAE,CAAC,EAAE;oBAClB,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU;oBAC5C,aAAa,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS;oBACzC,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU;oBAC3C,UAAU,EAAE,cAAc,CAAC,IAAI;oBAC/B,UAAU,EAAE,cAAc,CAAC,IAAI;iBAChC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAY,EAAE,KAAY;IAC5D,MAAM,MAAM,GAAyB,EAAE,CAAC;IAExC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;QACrC,IAAI,QAAQ,KAAK,cAAc,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,SAAS,GAAG,CAAC,MAAc,EAAE,IAAc;QACzC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElB,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACzC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,OAAO,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,SAAS,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,qBAAqB;YAChC,KAAK;YACL,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oEAAoE;AAEpE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAA2C;IACrF,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAClF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;IAEhD,qBAAqB;IACrB,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3E,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEtE,MAAM,WAAW,GACf,qBAAqB,CAAC,MAAM;QAC5B,eAAe,CAAC,MAAM;QACtB,wBAAwB,CAAC,MAAM;QAC/B,wBAAwB,CAAC,MAAM;QAC/B,oBAAoB,CAAC,MAAM,CAAC;IAE9B,gBAAgB;IAChB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,+BAA+B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE1D,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,QAAQ,WAAW,SAAS,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAE9F,0BAA0B;IAC1B,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gCAAgC,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5E,KAAK,MAAM,KAAK,IAAI,qBAAqB,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5F,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpE,IAAI,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/D,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,aAAa,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,wBAAwB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mCAAmC,wBAAwB,CAAC,MAAM,GAAG,CAAC,CAAC;QAClF,KAAK,MAAM,KAAK,IAAI,wBAAwB,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1E,KAAK,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,wBAAwB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,wBAAwB,CAAC,MAAM,GAAG,CAAC,CAAC;QACvE,KAAK,MAAM,KAAK,IAAI,wBAAwB,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CACR,OAAO,KAAK,CAAC,cAAc,OAAO,KAAK,CAAC,aAAa,SAAS,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,OAAO,KAAK,CAAC,UAAU,GAAG,CAC7H,CAAC;QACJ,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC;QACzE,KAAK,MAAM,KAAK,IAAI,oBAAoB,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowspec-mcp",
-  "version": "4.2.2",
+  "version": "5.0.0",
   "type": "module",
   "description": "MCP server for FlowSpec — exposes project specs to Claude Code",
   "bin": {
@@ -29,13 +29,13 @@
     "flowspec",
     "claude",
     "model-context-protocol",
-    "data-architecture"
+    "data-architecture",
+    "json"
   ],
   "dependencies": {
     "@dagrejs/dagre": "^1.1.4",
     "@modelcontextprotocol/sdk": "1.12.1",
     "@neondatabase/serverless": "^1.0.2",
-    "yaml": "^2.8.2",
     "zod": "^3.24.4"
   },
   "devDependencies": {