flowspec-mcp 5.4.0 → 5.5.1

package/dist/tools/captureScreen.js

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+import { uploadImageViaApi } from '../db.js';
+import { detectImageDimensions } from '../image/dimensions.js';
+export const captureScreenSchema = z.object({
+    url: z.string().describe('URL to screenshot (http:// or https://)'),
+    selector: z.string().optional().describe('CSS selector for specific element (full page if omitted)'),
+    viewport: z
+        .object({
+        width: z.number(),
+        height: z.number()
+    })
+        .optional()
+        .describe('Viewport size (default: 1920x1080)'),
+    waitFor: z
+        .string()
+        .optional()
+        .describe('CSS selector to wait for before screenshot, or timeout in ms (e.g., "3000")'),
+    fullPage: z.boolean().optional().default(false).describe('Capture full page height (default: false)')
+});
+export async function handleCaptureScreen(args) {
+    // Validate URL
+    if (!args.url.startsWith('http://') && !args.url.startsWith('https://')) {
+        return {
+            content: [{ type: 'text', text: `Invalid URL. Must start with http:// or https://` }],
+            isError: true
+        };
+    }
+    let browser;
+    try {
+        // Dynamically import playwright (cloud-only dependency)
+        const { chromium } = await import('playwright');
+        // Launch browser
+        browser = await chromium.launch({ headless: true });
+        const context = await browser.newContext({
+            viewport: args.viewport ?? { width: 1920, height: 1080 }
+        });
+        const page = await context.newPage();
+        // Navigate to URL
+        await page.goto(args.url, { waitUntil: 'networkidle' });
+        // Wait for selector or timeout if specified
+        if (args.waitFor) {
+            const timeoutMs = parseInt(args.waitFor, 10);
+            if (!isNaN(timeoutMs)) {
+                // Wait for timeout
+                await page.waitForTimeout(timeoutMs);
+            }
+            else {
+                // Wait for selector
+                try {
+                    await page.waitForSelector(args.waitFor, { timeout: 10000 });
+                }
+                catch (e) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Selector "${args.waitFor}" not found within 10s. Screenshot may be incomplete.`
+                            }
+                        ],
+                        isError: true
+                    };
+                }
+            }
+        }
+        // Take screenshot
+        let screenshotBuffer;
+        if (args.selector) {
+            // Screenshot specific element
+            const element = await page.$(args.selector);
+            if (!element) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Element not found: ${args.selector}`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            screenshotBuffer = await element.screenshot({ type: 'png' });
+        }
+        else {
+            // Screenshot full page or viewport
+            screenshotBuffer = await page.screenshot({
+                type: 'png',
+                fullPage: args.fullPage
+            });
+        }
+        await browser.close();
+        // Detect dimensions from screenshot
+        const detected = detectImageDimensions(new Uint8Array(screenshotBuffer));
+        const width = detected?.width ?? args.viewport?.width ?? 1920;
+        const height = detected?.height ?? args.viewport?.height ?? 1080;
+        // Upload to Vercel Blob (via API)
+        const base64Data = screenshotBuffer.toString('base64');
+        const filename = `screenshot_${Date.now()}.png`;
+        const result = await uploadImageViaApi(base64Data, filename, 'image/png');
+        if (!result) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to upload screenshot. In cloud mode, image upload is not yet supported.`
+                    }
+                ],
+                isError: true
+            };
+        }
+        // Return result in same format as uploadImage
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ url: result.url, width, height, filename }, null, 2)
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (browser) {
+            await browser.close();
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Screenshot capture failed: ${error.message}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+//# sourceMappingURL=captureScreen.js.map

package/dist/tools/captureScreen.js.map

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

package/dist/tools/createNode.d.ts

@@ -14,7 +14,7 @@ export declare const createNodeSchema: z.ZodObject<{
     }>;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
-    type: "datapoint" | "component" | "transform" | "table";
+    type: "datapoint" | "table" | "component" | "transform";
     position: {
         x: number;
         y: number;
@@ -22,7 +22,7 @@ export declare const createNodeSchema: z.ZodObject<{
     data: Record<string, unknown>;
     projectId: string;
 }, {
-    type: "datapoint" | "component" | "transform" | "table";
+    type: "datapoint" | "table" | "component" | "transform";
     position: {
         x: number;
         y: number;

package/dist/tools/createSubview.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const createSubviewSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    nodePositions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        nodeId: string;
+    }, {
+        x: number;
+        y: number;
+        nodeId: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    projectId: string;
+    description?: string | undefined;
+    nodePositions?: {
+        x: number;
+        y: number;
+        nodeId: string;
+    }[] | undefined;
+}, {
+    name: string;
+    projectId: string;
+    description?: string | undefined;
+    nodePositions?: {
+        x: number;
+        y: number;
+        nodeId: string;
+    }[] | undefined;
+}>;
+export declare function handleCreateSubview(args: z.infer<typeof createSubviewSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/tools/createSubview.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { createSubviewViaApi } from '../db.js';
+export const createSubviewSchema = z.object({
+    projectId: z.string().describe('UUID of the project'),
+    name: z.string().describe('Subview name'),
+    description: z.string().optional().describe('Optional subview description'),
+    nodePositions: z.array(z.object({
+        nodeId: z.string().describe('Node ID from the main canvas'),
+        x: z.number().describe('X position in subview canvas'),
+        y: z.number().describe('Y position in subview canvas'),
+    })).optional().describe('Initial nodes and their positions in the subview'),
+});
+export async function handleCreateSubview(args) {
+    const subview = await createSubviewViaApi(args.projectId, args.name, args.description, args.nodePositions ?? []);
+    if (!subview) {
+        return {
+            content: [{ type: 'text', text: `Failed to create subview — project not found: ${args.projectId}` }],
+            isError: true,
+        };
+    }
+    const nodeCount = args.nodePositions?.length ?? 0;
+    return {
+        content: [{
+                type: 'text',
+                text: `Created subview **${args.name}** (id: ${subview.id}) with ${nodeCount} node${nodeCount === 1 ? '' : 's'}`,
+            }],
+    };
+}
+//# sourceMappingURL=createSubview.js.map

package/dist/tools/createSubview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSubview.js","sourceRoot":"","sources":["../../src/tools/createSubview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC3E,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC3D,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACtD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KACvD,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAC5E,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAyC;IACjF,MAAM,OAAO,GAAG,MAAM,mBAAmB,CACvC,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,aAAa,IAAI,EAAE,CACzB,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iDAAiD,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAC7G,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAC;IAClD,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,qBAAqB,IAAI,CAAC,IAAI,WAAW,OAAO,CAAC,EAAE,UAAU,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;aACjH,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/deleteSubview.d.ts

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

package/dist/tools/deleteSubview.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { deleteSubviewViaApi } from '../db.js';
+export const deleteSubviewSchema = z.object({
+    projectId: z.string().describe('UUID of the project'),
+    subviewId: z.string().describe('UUID of the subview to delete'),
+});
+export async function handleDeleteSubview(args) {
+    const ok = await deleteSubviewViaApi(args.projectId, args.subviewId);
+    if (!ok) {
+        return {
+            content: [{ type: 'text', text: `Subview or project not found: ${args.subviewId}` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: 'text', text: `Deleted subview ${args.subviewId}` }],
+    };
+}
+//# sourceMappingURL=deleteSubview.js.map

package/dist/tools/deleteSubview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteSubview.js","sourceRoot":"","sources":["../../src/tools/deleteSubview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAChE,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAyC;IACjF,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAErE,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iCAAiC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAC7F,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,mBAAmB,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC"}

package/dist/tools/generateSpec.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const generateSpecSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+    sections: z.ZodOptional<z.ZodArray<z.ZodEnum<["db_schema", "api_contracts", "component_tree", "validation_rules", "all"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    format: "markdown" | "json";
+    sections?: ("db_schema" | "api_contracts" | "component_tree" | "validation_rules" | "all")[] | undefined;
+}, {
+    projectId: string;
+    format?: "markdown" | "json" | undefined;
+    sections?: ("db_schema" | "api_contracts" | "component_tree" | "validation_rules" | "all")[] | undefined;
+}>;
+export declare function handleGenerateSpec(args: z.infer<typeof generateSpecSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/generateSpec.js

@@ -0,0 +1,336 @@
+import { z } from 'zod';
+import { getProject } from '../db.js';
+import { handleGetYaml } from './getYaml.js';
+import YAML from 'yaml';
+export const generateSpecSchema = z.object({
+    projectId: z.string().describe('UUID of the project to generate spec for'),
+    format: z.enum(['markdown', 'json']).default('markdown').describe('Output format'),
+    sections: z
+        .array(z.enum(['db_schema', 'api_contracts', 'component_tree', 'validation_rules', 'all']))
+        .optional()
+        .describe('Sections to include (default: all)')
+});
+export async function handleGenerateSpec(args) {
+    const project = await getProject(args.projectId);
+    if (!project) {
+        return {
+            content: [{ type: 'text', text: `Project not found: ${args.projectId}` }],
+            isError: true
+        };
+    }
+    // Get YAML via existing tool
+    const yamlResult = await handleGetYaml({ projectId: args.projectId });
+    if (yamlResult.isError) {
+        return yamlResult;
+    }
+    const yamlContent = yamlResult.content[0].text;
+    const parsed = YAML.parse(yamlContent);
+    // Determine which sections to include
+    const sections = args.sections ?? ['all'];
+    const includeAll = sections.includes('all');
+    // Generate spec
+    const spec = args.format === 'markdown'
+        ? generateMarkdownSpec(project.name, parsed, {
+            db_schema: includeAll || sections.includes('db_schema'),
+            api_contracts: includeAll || sections.includes('api_contracts'),
+            component_tree: includeAll || sections.includes('component_tree'),
+            validation_rules: includeAll || sections.includes('validation_rules')
+        })
+        : generateJsonSpec(project.name, parsed);
+    return {
+        content: [{ type: 'text', text: spec }]
+    };
+}
+// ─── Markdown Spec Generation ───────────────────────────────────
+function generateMarkdownSpec(projectName, yaml, sections) {
+    const lines = [];
+    // Header
+    lines.push(`# ${projectName} - Technical Specification`);
+    lines.push(``);
+    lines.push(`**Generated:** ${new Date().toISOString().split('T')[0]}`);
+    lines.push(`**FlowSpec Version:** ${yaml.version || '1.2.0'}`);
+    lines.push(``);
+    lines.push(`---`);
+    lines.push(``);
+    // Overview
+    const dataPoints = yaml.dataPoints || [];
+    const components = yaml.components || [];
+    const transforms = yaml.transforms || [];
+    const tables = yaml.tables || [];
+    const screens = yaml.screens || [];
+    lines.push(`## Overview`);
+    lines.push(``);
+    lines.push(`This specification describes the data architecture for **${projectName}**.`);
+    lines.push(``);
+    lines.push(`- **DataPoints:** ${dataPoints.length} data elements`);
+    lines.push(`- **Components:** ${components.length} UI components`);
+    lines.push(`- **Transforms:** ${transforms.length} business logic functions`);
+    lines.push(`- **Tables:** ${tables.length} database tables/APIs`);
+    lines.push(`- **Screens:** ${screens.length} wireframe screens`);
+    lines.push(``);
+    lines.push(`---`);
+    lines.push(``);
+    // DataPoints
+    lines.push(`## DataPoints`);
+    lines.push(``);
+    if (dataPoints.length === 0) {
+        lines.push(`*No data points defined.*`);
+        lines.push(``);
+    }
+    else {
+        lines.push(`| Label | Type | Source | Constraints | Source Definition |`);
+        lines.push(`|-------|------|--------|-------------|-------------------|`);
+        for (const dp of dataPoints) {
+            const label = dp.label || dp.id;
+            const type = dp.type || 'string';
+            const source = dp.source || 'inferred';
+            const constraints = dp.constraints && dp.constraints.length > 0 ? dp.constraints.join(', ') : '-';
+            const sourceDef = (dp.sourceDefinition || '').replace(/\|/g, '\\|');
+            lines.push(`| ${label} | ${type} | ${source} | ${constraints} | ${sourceDef} |`);
+        }
+        lines.push(``);
+        // Group by source
+        const captured = dataPoints.filter((dp) => dp.source === 'captured');
+        const inferred = dataPoints.filter((dp) => dp.source === 'inferred');
+        lines.push(`**Captured DataPoints (${captured.length}):** User inputs, form fields`);
+        lines.push(`**Inferred DataPoints (${inferred.length}):** Computed values, API responses, database queries`);
+        lines.push(``);
+    }
+    lines.push(`---`);
+    lines.push(``);
+    // Components
+    lines.push(`## Components`);
+    lines.push(``);
+    if (components.length === 0) {
+        lines.push(`*No components defined.*`);
+        lines.push(``);
+    }
+    else {
+        lines.push(`| Label | Displays | Captures | Wireframe |`);
+        lines.push(`|-------|----------|----------|-----------|`);
+        for (const comp of components) {
+            const label = comp.label || comp.id;
+            const displays = comp.displays?.join(', ') || '-';
+            const captures = comp.captures?.join(', ') || '-';
+            const wireframe = comp.wireframeRef || '-';
+            lines.push(`| ${label} | ${displays} | ${captures} | ${wireframe} |`);
+        }
+        lines.push(``);
+    }
+    lines.push(`---`);
+    lines.push(``);
+    // Transforms
+    lines.push(`## Transforms`);
+    lines.push(``);
+    if (transforms.length === 0) {
+        lines.push(`*No transforms defined.*`);
+        lines.push(``);
+    }
+    else {
+        lines.push(`| Label | Type | Inputs | Outputs | Description |`);
+        lines.push(`|-------|------|--------|---------|-------------|`);
+        for (const tf of transforms) {
+            const label = tf.label || tf.id;
+            const type = tf.type || 'formula';
+            const inputs = tf.inputs?.join(', ') || '-';
+            const outputs = tf.outputs?.join(', ') || '-';
+            const description = (tf.description || '').replace(/\|/g, '\\|');
+            lines.push(`| ${label} | ${type} | ${inputs} | ${outputs} | ${description} |`);
+        }
+        lines.push(``);
+        // Group by type
+        const formulas = transforms.filter((tf) => tf.type === 'formula');
+        const validations = transforms.filter((tf) => tf.type === 'validation');
+        const workflows = transforms.filter((tf) => tf.type === 'workflow');
+        lines.push(`**Formula (${formulas.length}):** Calculations, aggregations`);
+        lines.push(`**Validation (${validations.length}):** Data checking, constraint enforcement`);
+        lines.push(`**Workflow (${workflows.length}):** Multi-step processes, integrations`);
+        lines.push(``);
+    }
+    lines.push(`---`);
+    lines.push(``);
+    // Database Schema (if requested)
+    if (sections.db_schema && tables.length > 0) {
+        lines.push(`## Database Schema`);
+        lines.push(``);
+        for (const table of tables) {
+            const label = table.label || table.id;
+            const sourceType = table.sourceType || 'database';
+            const endpoint = table.endpoint || '-';
+            lines.push(`### Table: \`${label}\``);
+            lines.push(``);
+            lines.push(`**Source:** ${sourceType} (${endpoint})`);
+            lines.push(``);
+            if (table.columns && table.columns.length > 0) {
+                lines.push(`| Column | Type |`);
+                lines.push(`|--------|------|`);
+                for (const col of table.columns) {
+                    lines.push(`| ${col.name} | ${col.type} |`);
+                }
+                lines.push(``);
+            }
+        }
+        lines.push(`---`);
+        lines.push(``);
+    }
+    // API Contracts (if requested)
+    if (sections.api_contracts) {
+        lines.push(`## API Contracts`);
+        lines.push(``);
+        // Infer API endpoints from inferred DataPoints
+        const apiDataPoints = dataPoints.filter((dp) => dp.source === 'inferred' && dp.sourceDefinition && dp.sourceDefinition.includes('API'));
+        if (apiDataPoints.length === 0) {
+            lines.push(`*No API endpoints identified.*`);
+            lines.push(``);
+        }
+        else {
+            lines.push(`Suggested API endpoints based on inferred DataPoints:`);
+            lines.push(``);
+            for (const dp of apiDataPoints) {
+                const label = dp.label || dp.id;
+                const method = dp.sourceDefinition.includes('POST') ? 'POST' : 'GET';
+                const endpoint = `/api/${label.toLowerCase().replace(/\s+/g, '-')}`;
+                lines.push(`### ${method} ${endpoint}`);
+                lines.push(``);
+                lines.push(`**Returns:** ${label} (${dp.type})`);
+                lines.push(`**Source:** ${dp.sourceDefinition}`);
+                lines.push(``);
+            }
+        }
+        lines.push(`---`);
+        lines.push(``);
+    }
+    // Component Tree (if requested)
+    if (sections.component_tree && components.length > 0) {
+        lines.push(`## Component Hierarchy`);
+        lines.push(``);
+        // Simple tree based on wireframe references
+        const screenGroups = new Map();
+        for (const comp of components) {
+            const screen = comp.wireframeRef || 'No Screen';
+            const group = screenGroups.get(screen) || [];
+            group.push(comp);
+            screenGroups.set(screen, group);
+        }
+        for (const [screen, comps] of screenGroups) {
+            lines.push(`### ${screen}`);
+            lines.push(``);
+            for (const comp of comps) {
+                const label = comp.label || comp.id;
+                lines.push(`- **${label}**`);
+                if (comp.displays && comp.displays.length > 0) {
+                    lines.push(`  - Displays: ${comp.displays.join(', ')}`);
+                }
+                if (comp.captures && comp.captures.length > 0) {
+                    lines.push(`  - Captures: ${comp.captures.join(', ')}`);
+                }
+            }
+            lines.push(``);
+        }
+        lines.push(`---`);
+        lines.push(``);
+    }
+    // Validation Rules (if requested)
+    if (sections.validation_rules) {
+        lines.push(`## Validation Rules`);
+        lines.push(``);
+        // Extract constraints from DataPoints
+        const constrainedDataPoints = dataPoints.filter((dp) => dp.constraints && dp.constraints.length > 0);
+        if (constrainedDataPoints.length === 0) {
+            lines.push(`*No validation rules defined.*`);
+            lines.push(``);
+        }
+        else {
+            lines.push(`| DataPoint | Constraints |`);
+            lines.push(`|-----------|-------------|`);
+            for (const dp of constrainedDataPoints) {
+                const label = dp.label || dp.id;
+                const constraints = dp.constraints.join(', ');
+                lines.push(`| ${label} | ${constraints} |`);
+            }
+            lines.push(``);
+        }
+        // Extract validation transforms
+        const validationTransforms = transforms.filter((tf) => tf.type === 'validation');
+        if (validationTransforms.length > 0) {
+            lines.push(`### Validation Transforms`);
+            lines.push(``);
+            for (const tf of validationTransforms) {
+                const label = tf.label || tf.id;
+                const inputs = tf.inputs?.join(', ') || '-';
+                const description = tf.description || 'No description';
+                lines.push(`- **${label}**`);
+                lines.push(`  - Validates: ${inputs}`);
+                lines.push(`  - Logic: ${description}`);
+                lines.push(``);
+            }
+        }
+        lines.push(`---`);
+        lines.push(``);
+    }
+    // Implementation Recommendations
+    lines.push(`## Implementation Recommendations`);
+    lines.push(``);
+    lines.push(`1. **Database Schema**`);
+    lines.push(`   - Create tables: ${tables.map((t) => t.label).join(', ')}`);
+    lines.push(`   - Set up migrations and seed data`);
+    lines.push(``);
+    lines.push(`2. **API Contracts**`);
+    lines.push(`   - Implement endpoints for inferred DataPoints (${dataPoints.filter((dp) => dp.source === 'inferred').length} endpoints)`);
+    lines.push(`   - Add authentication and authorization`);
+    lines.push(``);
+    lines.push(`3. **Component Structure**`);
+    lines.push(`   - Build ${components.length} UI components`);
+    lines.push(`   - Connect data flows (displays/captures)`);
+    lines.push(``);
+    lines.push(`4. **Validation Rules**`);
+    lines.push(`   - Apply constraints at both client and server`);
+    lines.push(`   - Implement ${transforms.filter((tf) => tf.type === 'validation').length} validation transforms`);
+    lines.push(``);
+    lines.push(`5. **Business Logic**`);
+    lines.push(`   - Implement ${transforms.length} transforms`);
+    lines.push(`   - Test all data flows and edge cases`);
+    lines.push(``);
+    lines.push(`---`);
+    lines.push(``);
+    // Quality Metrics (from project analysis)
+    const nodes = project.canvas_state?.nodes || [];
+    const edges = project.canvas_state?.edges || [];
+    lines.push(`## Quality Metrics`);
+    lines.push(``);
+    lines.push(`- **Total nodes:** ${nodes.length}`);
+    lines.push(`- **Total edges:** ${edges.length}`);
+    lines.push(`- **Screens:** ${screens.length}`);
+    lines.push(`- **Captured DataPoints:** ${dataPoints.filter((dp) => dp.source === 'captured').length}`);
+    lines.push(`- **Inferred DataPoints:** ${dataPoints.filter((dp) => dp.source === 'inferred').length}`);
+    lines.push(``);
+    lines.push(`✅ **Ready for implementation in Claude Code via \`/spec\` skill**`);
+    lines.push(``);
+    // Footer
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`*Generated by FlowSpec MCP Server v3.0.0*`);
+    return lines.join('\n');
+}
+// ─── JSON Spec Generation ───────────────────────────────────────
+function generateJsonSpec(projectName, yaml) {
+    const spec = {
+        projectName: projectName,
+        generated: new Date().toISOString(),
+        version: yaml.version || '1.2.0',
+        summary: {
+            dataPoints: yaml.dataPoints?.length || 0,
+            components: yaml.components?.length || 0,
+            transforms: yaml.transforms?.length || 0,
+            tables: yaml.tables?.length || 0,
+            screens: yaml.screens?.length || 0
+        },
+        dataPoints: yaml.dataPoints || [],
+        components: yaml.components || [],
+        transforms: yaml.transforms || [],
+        tables: yaml.tables || [],
+        screens: yaml.screens || []
+    };
+    return JSON.stringify(spec, null, 2);
+}
+//# sourceMappingURL=generateSpec.js.map