devlens-mcp 0.3.0

package/dist/src/tools/ds-tools.js

@@ -0,0 +1,314 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dsToolSchemas = void 0;
+exports.createDsToolHandlers = createDsToolHandlers;
+const zod_1 = require("zod");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+// ─── Tool Schema ─────────────────────────────────────────────────────────────
+exports.dsToolSchemas = {
+    devlens_ds_context: {
+        description: "Get design system context: available DS3 components with their TypeScript prop interfaces, design token values (colors, spacing, typography), and usage patterns from the codebase. Use this before fixing code — it tells you exactly which components and tokens to use. Requires 'designSystem' to be configured in devlens.config.json (pointed to by DEVLENS_CONFIG env var).",
+        parameters: zod_1.z.object({
+            includeTokens: zod_1.z
+                .boolean()
+                .default(true)
+                .describe("Include design token values (colors, spacing, typography)"),
+            includeComponents: zod_1.z
+                .boolean()
+                .default(true)
+                .describe("Scan source files for DS component usage patterns and prop value combinations"),
+            includeInterfaces: zod_1.z
+                .boolean()
+                .default(true)
+                .describe("Include TypeScript prop interface definitions for each DS component"),
+        }),
+    },
+};
+// ─── Token Parsing ────────────────────────────────────────────────────────────
+/**
+ * Parse a TypeScript constants file for exported const objects.
+ * Handles patterns like:
+ *   export const FIGMA_COLORS = { KEY: '#hex', ... }
+ *   export const FIGMA_SPACING = { XS: 8, ... }
+ */
+async function parseTokensFile(absolutePath) {
+    const tokens = [];
+    let content;
+    try {
+        content = await (0, promises_1.readFile)(absolutePath, "utf-8");
+    }
+    catch {
+        return tokens;
+    }
+    const blockRegex = /export\s+const\s+(\w+)\s*=\s*\{([^}]+)\}/g;
+    let blockMatch;
+    while ((blockMatch = blockRegex.exec(content)) !== null) {
+        const blockName = blockMatch[1];
+        const blockBody = blockMatch[2];
+        const lower = blockName.toLowerCase();
+        const group = lower.includes("color") ? "colors"
+            : lower.includes("spacing") ? "spacing"
+                : lower.includes("typo") ? "typography"
+                    : lower.includes("shape") ? "shapes"
+                        : lower.includes("dimension") ? "dimensions"
+                            : "other";
+        const entryRegex = /['"]?(\w+)['"]?\s*:\s*([^,\n]+)/g;
+        let entryMatch;
+        while ((entryMatch = entryRegex.exec(blockBody)) !== null) {
+            const name = entryMatch[1].trim();
+            const raw = entryMatch[2]
+                .trim()
+                .replace(/\/\/.*$/, "") // strip trailing comments
+                .trim()
+                .replace(/,$/, "") // strip trailing comma
+                .trim()
+                .replace(/^['"]/, "") // strip leading quote
+                .replace(/['"]$/, "") // strip trailing quote
+                .replace(/\s+as\s+const$/, "") // strip "as const"
+                .trim();
+            if (name && raw) {
+                tokens.push({ name, value: raw, group });
+            }
+        }
+    }
+    return tokens;
+}
+// ─── Component Interface Reading ──────────────────────────────────────────────
+const SKIP_DIRS = new Set(["node_modules", ".git", "dist", "build", "__tests__", "__mocks__", ".expo"]);
+/** Recursively walk a directory and collect .ts/.tsx files */
+async function collectSourceFiles(dir) {
+    const files = [];
+    async function walk(current) {
+        let entries;
+        try {
+            entries = await (0, promises_1.readdir)(current);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (SKIP_DIRS.has(entry))
+                continue;
+            const fullPath = (0, path_1.join)(current, entry);
+            try {
+                const s = await (0, promises_1.stat)(fullPath);
+                if (s.isDirectory()) {
+                    await walk(fullPath);
+                }
+                else if (entry.endsWith(".tsx") || entry.endsWith(".ts")) {
+                    files.push(fullPath);
+                }
+            }
+            catch {
+                // ignore permission errors
+            }
+        }
+    }
+    await walk(dir);
+    return files;
+}
+/**
+ * Read component interface definitions from a DS components directory.
+ * Expects structure: componentsDir/<ComponentName>/generated/interface.ts
+ * Returns map of interface name → full TypeScript interface text.
+ */
+async function readComponentInterfaces(componentsDir) {
+    const interfaces = {};
+    let entries;
+    try {
+        entries = await (0, promises_1.readdir)(componentsDir);
+    }
+    catch {
+        return interfaces;
+    }
+    for (const entry of entries) {
+        // Try common paths for generated interfaces
+        const candidates = [
+            (0, path_1.join)(componentsDir, entry, "generated", "interface.ts"),
+            (0, path_1.join)(componentsDir, entry, "interface.ts"),
+            (0, path_1.join)(componentsDir, entry, "types.ts"),
+        ];
+        for (const interfacePath of candidates) {
+            try {
+                const content = await (0, promises_1.readFile)(interfacePath, "utf-8");
+                // Extract first interface name from "export interface FooProps {"
+                const nameMatch = content.match(/export\s+(?:interface|type)\s+(\w+)/);
+                if (nameMatch) {
+                    interfaces[nameMatch[1]] = content.trim();
+                    break; // found one for this component
+                }
+            }
+            catch {
+                // file not found — try next candidate
+            }
+        }
+    }
+    return interfaces;
+}
+// ─── Usage Pattern Scanning ───────────────────────────────────────────────────
+/**
+ * Scan TSX/TS source files for DS component usages and collect prop patterns.
+ * Detects: <JDS*> components and common React Native DS component names.
+ */
+async function scanComponentUsages(projectRoot) {
+    const files = await collectSourceFiles(projectRoot);
+    const usageMap = new Map();
+    // Matches JSX tags: <JDSText variant="..." /> or <Icon name="..." />
+    const componentTagRegex = /<(JDS\w+|DS3\w+|(?:Icon|Chip|Divider|JDSButton|JDSInput|JDSText)\b)\s([^>]{0,500})(?:\/?>|>)/g;
+    const propRegex = /(\w+)=["'{]([^"'}\n]{0,80})["'}]/g;
+    for (const filePath of files) {
+        let content;
+        try {
+            content = await (0, promises_1.readFile)(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        // Find import lines to identify where components come from
+        const importLines = content.match(/import[^;]+from\s+['"][^'"]+['"]/g) || [];
+        componentTagRegex.lastIndex = 0;
+        let tagMatch;
+        while ((tagMatch = componentTagRegex.exec(content)) !== null) {
+            const componentName = tagMatch[1];
+            const propsStr = tagMatch[2];
+            // Find import source for this component
+            const importedFrom = importLines
+                .find(line => line.includes(componentName))
+                ?.match(/from\s+['"]([^'"]+)['"]/)?.[1] ?? "unknown";
+            if (!usageMap.has(componentName)) {
+                usageMap.set(componentName, {
+                    componentName,
+                    importedFrom,
+                    usageCount: 0,
+                    sampleProps: {},
+                    sourceFiles: [],
+                });
+            }
+            const usage = usageMap.get(componentName);
+            usage.usageCount++;
+            if (!usage.sourceFiles.includes(filePath)) {
+                usage.sourceFiles.push(filePath);
+            }
+            propRegex.lastIndex = 0;
+            let propMatch;
+            while ((propMatch = propRegex.exec(propsStr)) !== null) {
+                const propName = propMatch[1];
+                const propValue = propMatch[2];
+                if (!usage.sampleProps[propName]) {
+                    usage.sampleProps[propName] = [];
+                }
+                if (!usage.sampleProps[propName].includes(propValue)) {
+                    usage.sampleProps[propName].push(propValue);
+                }
+            }
+        }
+    }
+    return Array.from(usageMap.values()).sort((a, b) => b.usageCount - a.usageCount);
+}
+// ─── Formatting ───────────────────────────────────────────────────────────────
+function formatOutput(dsName, tokens, componentInterfaces, components) {
+    const lines = [`=== Design System: ${dsName} ===`, ""];
+    // Tokens grouped by category
+    if (tokens.length > 0) {
+        const groups = new Map();
+        for (const t of tokens) {
+            if (!groups.has(t.group))
+                groups.set(t.group, []);
+            groups.get(t.group).push(t);
+        }
+        for (const [group, groupTokens] of groups) {
+            lines.push(`--- ${group.toUpperCase()} ---`);
+            for (const t of groupTokens) {
+                lines.push(`  ${t.name}: ${t.value}`);
+            }
+            lines.push("");
+        }
+    }
+    // Component TypeScript interfaces
+    if (Object.keys(componentInterfaces).length > 0) {
+        lines.push("--- COMPONENT INTERFACES ---");
+        for (const [, iface] of Object.entries(componentInterfaces)) {
+            lines.push("", iface);
+        }
+        lines.push("");
+    }
+    // Usage patterns
+    if (components.length > 0) {
+        lines.push("--- COMPONENT USAGE PATTERNS ---");
+        lines.push("(props and values observed in the codebase)");
+        for (const c of components.slice(0, 20)) {
+            lines.push(`\n${c.componentName}  (${c.usageCount} uses, from '${c.importedFrom}')`);
+            for (const [prop, values] of Object.entries(c.sampleProps)) {
+                lines.push(`  ${prop}: ${values.slice(0, 10).join(" | ")}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+// ─── Handler Factory ──────────────────────────────────────────────────────────
+function createDsToolHandlers(dsConfig) {
+    return {
+        devlens_ds_context: async (params) => {
+            if (!dsConfig) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                "No design system configured.",
+                                "",
+                                "To enable DS context, create devlens.config.json in your app root:",
+                                JSON.stringify({
+                                    designSystem: {
+                                        name: "jds3",
+                                        projectRoot: "/absolute/path/to/your-app",
+                                        tokensFile: "src/constants/figmaTokens.ts",
+                                        componentsDir: "src/jds-components",
+                                        componentsGlob: "src/**/*.tsx",
+                                    },
+                                }, null, 2),
+                                "",
+                                "Then point to it in your MCP config env block:",
+                                '  "DEVLENS_CONFIG": "/absolute/path/to/your-app/devlens.config.json"',
+                            ].join("\n"),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const absoluteProjectRoot = (0, path_1.resolve)(dsConfig.projectRoot);
+            const absoluteTokensFile = (0, path_1.join)(absoluteProjectRoot, dsConfig.tokensFile);
+            const absoluteComponentsDir = dsConfig.componentsDir
+                ? (0, path_1.join)(absoluteProjectRoot, dsConfig.componentsDir)
+                : null;
+            // Run all analyses in parallel
+            const [tokens, componentInterfaces, components] = await Promise.all([
+                params.includeTokens
+                    ? parseTokensFile(absoluteTokensFile)
+                    : Promise.resolve([]),
+                params.includeInterfaces && absoluteComponentsDir
+                    ? readComponentInterfaces(absoluteComponentsDir)
+                    : Promise.resolve({}),
+                params.includeComponents
+                    ? scanComponentUsages(absoluteProjectRoot)
+                    : Promise.resolve([]),
+            ]);
+            const summary = [
+                `${tokens.length} tokens`,
+                `${Object.keys(componentInterfaces).length} component interfaces`,
+                `${components.reduce((s, c) => s + c.usageCount, 0)} component usages across ${components.length} component types`,
+            ].join(", ");
+            console.error(`[devlens] DS context: ${summary}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatOutput(dsConfig.name, tokens, componentInterfaces, components),
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=ds-tools.js.map

package/dist/src/tools/ds-tools.js.map

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

package/dist/src/tools/interaction-tools.d.ts

@@ -0,0 +1,248 @@
+import { z } from "zod";
+import type { DeviceManager } from "../platform/device-manager.js";
+import { RefRegistry } from "../snapshot/ref-registry.js";
+export declare const interactionToolSchemas: {
+    devlens_tap: {
+        description: string;
+        parameters: z.ZodObject<{
+            ref: z.ZodString;
+            element: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            element: string;
+        }, {
+            ref: string;
+            element: string;
+        }>;
+    };
+    devlens_type: {
+        description: string;
+        parameters: z.ZodObject<{
+            ref: z.ZodString;
+            text: z.ZodString;
+            submit: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            ref: string;
+            submit: boolean;
+        }, {
+            text: string;
+            ref: string;
+            submit?: boolean | undefined;
+        }>;
+    };
+    devlens_swipe: {
+        description: string;
+        parameters: z.ZodObject<{
+            direction: z.ZodEnum<["up", "down", "left", "right"]>;
+            ref: z.ZodOptional<z.ZodString>;
+            distance: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            direction: "up" | "down" | "left" | "right";
+            distance: number;
+            ref?: string | undefined;
+        }, {
+            direction: "up" | "down" | "left" | "right";
+            ref?: string | undefined;
+            distance?: number | undefined;
+        }>;
+    };
+    devlens_scroll: {
+        description: string;
+        parameters: z.ZodObject<{
+            ref: z.ZodString;
+            direction: z.ZodEnum<["up", "down"]>;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            direction: "up" | "down";
+        }, {
+            ref: string;
+            direction: "up" | "down";
+        }>;
+    };
+    devlens_long_press: {
+        description: string;
+        parameters: z.ZodObject<{
+            ref: z.ZodString;
+            duration: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            duration: number;
+        }, {
+            ref: string;
+            duration?: number | undefined;
+        }>;
+    };
+    devlens_press_button: {
+        description: string;
+        parameters: z.ZodObject<{
+            button: z.ZodEnum<["home", "back", "enter"]>;
+        }, "strip", z.ZodTypeAny, {
+            button: "home" | "back" | "enter";
+        }, {
+            button: "home" | "back" | "enter";
+        }>;
+    };
+    devlens_fill_form: {
+        description: string;
+        parameters: z.ZodObject<{
+            fields: z.ZodArray<z.ZodObject<{
+                ref: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                ref: string;
+            }, {
+                value: string;
+                ref: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            fields: {
+                value: string;
+                ref: string;
+            }[];
+        }, {
+            fields: {
+                value: string;
+                ref: string;
+            }[];
+        }>;
+    };
+    devlens_capture_flow: {
+        description: string;
+        parameters: z.ZodObject<{
+            steps: z.ZodArray<z.ZodObject<{
+                action: z.ZodEnum<["tap", "screenshot", "go_back", "swipe", "wait", "press_button"]>;
+                ref: z.ZodOptional<z.ZodString>;
+                element: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+                direction: z.ZodOptional<z.ZodEnum<["up", "down", "left", "right"]>>;
+                button: z.ZodOptional<z.ZodEnum<["home", "back", "enter"]>>;
+                ms: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                action: "screenshot" | "tap" | "swipe" | "go_back" | "wait" | "press_button";
+                button?: "home" | "back" | "enter" | undefined;
+                label?: string | undefined;
+                ref?: string | undefined;
+                element?: string | undefined;
+                direction?: "up" | "down" | "left" | "right" | undefined;
+                ms?: number | undefined;
+            }, {
+                action: "screenshot" | "tap" | "swipe" | "go_back" | "wait" | "press_button";
+                button?: "home" | "back" | "enter" | undefined;
+                label?: string | undefined;
+                ref?: string | undefined;
+                element?: string | undefined;
+                direction?: "up" | "down" | "left" | "right" | undefined;
+                ms?: number | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            steps: {
+                action: "screenshot" | "tap" | "swipe" | "go_back" | "wait" | "press_button";
+                button?: "home" | "back" | "enter" | undefined;
+                label?: string | undefined;
+                ref?: string | undefined;
+                element?: string | undefined;
+                direction?: "up" | "down" | "left" | "right" | undefined;
+                ms?: number | undefined;
+            }[];
+        }, {
+            steps: {
+                action: "screenshot" | "tap" | "swipe" | "go_back" | "wait" | "press_button";
+                button?: "home" | "back" | "enter" | undefined;
+                label?: string | undefined;
+                ref?: string | undefined;
+                element?: string | undefined;
+                direction?: "up" | "down" | "left" | "right" | undefined;
+                ms?: number | undefined;
+            }[];
+        }>;
+    };
+};
+export declare function createInteractionToolHandlers(deviceManager: DeviceManager, refRegistry: RefRegistry, onNavigate?: () => void): {
+    devlens_tap: (params: {
+        ref: string;
+        element: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_type: (params: {
+        ref: string;
+        text: string;
+        submit: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_swipe: (params: {
+        direction: "up" | "down" | "left" | "right";
+        ref?: string;
+        distance: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_scroll: (params: {
+        ref: string;
+        direction: "up" | "down";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_long_press: (params: {
+        ref: string;
+        duration: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_press_button: (params: {
+        button: "home" | "back" | "enter";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_fill_form: (params: {
+        fields: Array<{
+            ref: string;
+            value: string;
+        }>;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_capture_flow: (params: {
+        steps: Array<{
+            action: "tap" | "screenshot" | "go_back" | "swipe" | "wait" | "press_button";
+            ref?: string;
+            element?: string;
+            label?: string;
+            direction?: "up" | "down" | "left" | "right";
+            button?: "home" | "back" | "enter";
+            ms?: number;
+        }>;
+    }) => Promise<{
+        content: {
+            type: "text" | "image";
+            text?: string;
+            data?: string;
+            mimeType?: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=interaction-tools.d.ts.map

package/dist/src/tools/interaction-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoIlC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,MAAM,IAAI;0BAwBO;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;2BAiB/B;QAC3B,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB;;;;;;4BA0B6B;QAC5B,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB;;;;;;6BAqC8B;QAC7B,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;KAC1B;;;;;;iCAsBkC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;;;;;;mCAgB/B;QACnC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;KACnC;;;;;;gCAgBiC;QAChC,MAAM,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/C;;;;;;mCAsBoC;QACnC,KAAK,EAAE,KAAK,CAAC;YACX,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,CAAC;YAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;YAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;YACnC,EAAE,CAAC,EAAE,MAAM,CAAC;SACb,CAAC,CAAC;KACJ;;kBAuF8B,MAAM,GAAG,OAAO;mBAAS,MAAM;mBAAS,MAAM;uBAAa,MAAM;;;EA2BnG"}