patchwork-os 0.2.0-alpha.0

package/dist/tools/formatDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDocument.js","sourceRoot":"","sources":["../../src/tools/formatDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAEL,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,KAAK,EACL,QAAQ,EACR,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAQpB,MAAM,aAAa,GAAsB;IACvC,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;IACnE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;CACxE,CAAC;AAEF,MAAM,aAAa,GAAsB;IACvC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;IAClD,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;CAC3D,CAAC;AAEF,MAAM,aAAa,GAAsB;IACvC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;CACzD,CAAC;AAEF,MAAM,aAAa,GAAsB;IACvC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;CACvD,CAAC;AAEF,MAAM,cAAc,GAAsC;IACxD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,aAAa;CACrB,CAAC;AAEF,MAAM,UAAU,wBAAwB,CACtC,SAAiB,EACjB,MAAoB,EACpB,eAAgC;IAEhC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,yFAAyF;YAC3F,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;YAC5D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4CAA4C;qBAC1D;iBACF;gBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;gBACtB,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACjC,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBACrC;gBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;aACxB;SACF;QACD,OAAO,EAAE,KAAK,EACZ,IAA6B,EAC7B,MAAoB,EACpB,QAAqB,EACrB,EAAE;YACF,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACnB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtE,sCAAsC;YACtC,IAAI,aAAqB,CAAC;YAC1B,IAAI,CAAC;gBACH,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC,EAAE,KAAK,EAAE,mBAAmB,OAAO,EAAE,EAAE,CAAC,CAAC;YACxD,CAAC;YAED,sBAAsB;YACtB,IAAI,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;oBAC9D,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;wBACpB,qCAAqC;wBACrC,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;wBACxD,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;4BACnC,OAAO,iBAAiB,CAAC;gCACvB,SAAS,EAAE,IAAI;gCACf,MAAM,EAAE,WAAW;gCACnB,OAAO,EAAE,MAAM;6BAChB,CAAC,CAAC;wBACL,CAAC;wBACD,OAAO,iBAAiB,CAAC;4BACvB,SAAS,EAAE,IAAI;4BACf,MAAM,EAAE,WAAW;4BACnB,OAAO,EAAE,UAAU;4BACnB,gBAAgB,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;4BAClD,eAAe,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;yBACjD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,CAAC,GAAG,YAAY,qBAAqB,CAAC;wBAAE,MAAM,GAAG,CAAC;oBACvD,yCAAyC;gBAC3C,CAAC;YACH,CAAC;YAED,eAAe;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3C,OAAO,KAAK,CAAC;oBACX,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,KAAK;oBACb,KAAK,EAAE,0CAA0C,GAAG,GAAG;iBACxD,CAAC,CAAC;YACL,CAAC;YAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtD,OAAO,KAAK,CAAC;oBACX,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,KAAK;oBACb,KAAK,EAAE,wCAAwC,KAAK,EAAE;iBACvD,CAAC,CAAC;YACL,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBACrE,GAAG,EAAE,SAAS;gBACd,OAAO,EAAE,MAAM;gBACf,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAC;oBACX,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,KAAK;oBACb,aAAa,EAAE,SAAS,CAAC,GAAG;oBAC5B,KAAK,EAAE,MAAM,CAAC,MAAM;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxD,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrB,OAAO,iBAAiB,CAAC;gBACvB,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,SAAS,CAAC,GAAG;gBAC5B,OAAO,EAAE,aAAa,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;gBAC7D,gBAAgB,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;gBAClD,eAAe,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;aACjD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/generateAPIDocumentation.d.ts

@@ -0,0 +1,62 @@
+import { successStructured } from "./utils.js";
+export declare function createGenerateAPIDocumentationTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                files: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                format: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                includePrivate: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                files: {
+                    type: "array";
+                    items: {
+                        type: "object";
+                        properties: {
+                            file: {
+                                type: "string";
+                            };
+                            symbols: {
+                                type: "integer";
+                            };
+                            documentation: {
+                                type: "string";
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                totalSymbols: {
+                    type: "integer";
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>): Promise<ReturnType<typeof successStructured>>;
+};

package/dist/tools/generateAPIDocumentation.js

@@ -0,0 +1,249 @@
+import fs from "node:fs";
+import path from "node:path";
+import { optionalBool, optionalString, requireArray, resolveFilePath, successStructured, } from "./utils.js";
+const MAX_FILE_SIZE = 1024 * 1024; // 1MB
+const MAX_FILES = 20;
+export function createGenerateAPIDocumentationTool(workspace) {
+    return {
+        schema: {
+            name: "generateAPIDocumentation",
+            description: "Generate API docs (markdown/JSON) for TS/JS exported symbols. Extracts fns, classes, interfaces, JSDoc.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    files: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Relative file paths to document (required)",
+                    },
+                    format: {
+                        type: "string",
+                        enum: ["markdown", "json"],
+                        description: "Output format (default: markdown)",
+                    },
+                    includePrivate: {
+                        type: "boolean",
+                        description: "Include non-exported symbols (default: false)",
+                    },
+                },
+                required: ["files"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    files: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                file: { type: "string" },
+                                symbols: { type: "integer" },
+                                documentation: { type: "string" },
+                            },
+                            required: ["file", "symbols", "documentation"],
+                        },
+                    },
+                    totalSymbols: { type: "integer" },
+                },
+                required: ["files", "totalSymbols"],
+            },
+        },
+        timeoutMs: 30_000,
+        async handler(args) {
+            const rawFiles = requireArray(args, "files");
+            const format = optionalString(args, "format") ?? "markdown";
+            const includePrivate = optionalBool(args, "includePrivate") ?? false;
+            const filePaths = rawFiles.slice(0, MAX_FILES).map((f) => String(f));
+            const docs = [];
+            let totalSymbols = 0;
+            for (const filePath of filePaths) {
+                let absPath;
+                try {
+                    absPath = resolveFilePath(filePath, workspace);
+                }
+                catch {
+                    docs.push({
+                        file: filePath,
+                        symbols: 0,
+                        documentation: `Error: path "${filePath}" is outside workspace`,
+                    });
+                    continue;
+                }
+                let content;
+                try {
+                    const stat = fs.statSync(absPath);
+                    if (stat.size > MAX_FILE_SIZE) {
+                        docs.push({
+                            file: filePath,
+                            symbols: 0,
+                            documentation: "Error: file exceeds 1MB limit",
+                        });
+                        continue;
+                    }
+                    content = fs.readFileSync(absPath, "utf-8");
+                }
+                catch (err) {
+                    docs.push({
+                        file: filePath,
+                        symbols: 0,
+                        documentation: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    });
+                    continue;
+                }
+                const symbols = extractSymbols(content, includePrivate);
+                totalSymbols += symbols.length;
+                const documentation = format === "json"
+                    ? JSON.stringify(symbols, null, 2)
+                    : renderMarkdown(filePath, symbols);
+                docs.push({ file: filePath, symbols: symbols.length, documentation });
+            }
+            return successStructured({ files: docs, totalSymbols });
+        },
+    };
+}
+function extractJsDoc(content, pos) {
+    // Scan backwards from pos for a JSDoc comment using lastIndexOf —
+    // avoids O(N²) string allocation from content.slice(0, pos) on each call.
+    const closeIdx = content.lastIndexOf("*/", pos);
+    if (closeIdx === -1)
+        return undefined;
+    const openIdx = content.lastIndexOf("/**", closeIdx);
+    if (openIdx === -1)
+        return undefined;
+    // Ensure only whitespace exists between */ and pos (no code in between)
+    if (content.slice(closeIdx + 2, pos).trim() !== "")
+        return undefined;
+    const docBody = content.slice(openIdx + 3, closeIdx);
+    // Clean up the JSDoc text
+    return docBody
+        .split("\n")
+        .map((l) => l.replace(/^\s*\*\s?/, "").trim())
+        .filter(Boolean)
+        .join(" ");
+}
+function extractSymbols(content, includePrivate) {
+    const symbols = [];
+    // Export prefix pattern
+    const exportPrefix = includePrivate ? "(?:export\\s+)?" : "export\\s+";
+    // Functions: export function name(...): ReturnType
+    // Note: parameter content is capped at 200 chars to prevent catastrophic backtracking
+    // on adversarial input with deeply nested parentheses.
+    const funcRe = new RegExp(`${exportPrefix}(?:async\\s+)?function\\s+(\\w+)\\s*(\\([^)]{0,200}\\))(?:\\s*:\\s*([^{;\\n]{0,100}))?`, "g");
+    let m;
+    while ((m = funcRe.exec(content)) !== null) {
+        const name = m[1] ?? "";
+        const params = m[2] ?? "()";
+        const ret = m[3]?.trim() ?? "";
+        const sig = ret
+            ? `function ${name}${params}: ${ret}`
+            : `function ${name}${params}`;
+        symbols.push({
+            name,
+            kind: "function",
+            signature: sig,
+            jsDoc: extractJsDoc(content, m.index),
+        });
+    }
+    // Classes: export class Name
+    const classRe = new RegExp(`${exportPrefix}(?:abstract\\s+)?class\\s+(\\w+)(?:\\s+extends\\s+[\\w<>, ]+)?(?:\\s+implements\\s+[\\w<>, ]+)?`, "g");
+    while ((m = classRe.exec(content)) !== null) {
+        const name = m[1] ?? "";
+        const members = extractClassMembers(content, m.index);
+        symbols.push({
+            name,
+            kind: "class",
+            signature: `class ${name}`,
+            jsDoc: extractJsDoc(content, m.index),
+            members,
+        });
+    }
+    // Interfaces: export interface Name
+    const ifaceRe = new RegExp(`${exportPrefix}interface\\s+(\\w+)(?:\\s+extends\\s+[\\w<>, ]+)?`, "g");
+    while ((m = ifaceRe.exec(content)) !== null) {
+        const name = m[1] ?? "";
+        symbols.push({
+            name,
+            kind: "interface",
+            signature: `interface ${name}`,
+            jsDoc: extractJsDoc(content, m.index),
+        });
+    }
+    // Types: export type Name = ...
+    const typeRe = new RegExp(`${exportPrefix}type\\s+(\\w+)(?:<[^>]*>)?\\s*=\\s*([^;\\n]{0,80})`, "g");
+    while ((m = typeRe.exec(content)) !== null) {
+        const name = m[1] ?? "";
+        const body = m[2]?.trim() ?? "";
+        symbols.push({
+            name,
+            kind: "type",
+            signature: `type ${name} = ${body}`,
+            jsDoc: extractJsDoc(content, m.index),
+        });
+    }
+    // Consts: export const name: Type = ...
+    const constRe = new RegExp(`${exportPrefix}const\\s+(\\w+)(?:\\s*:\\s*([^=\\n]{0,60}))?\\s*=`, "g");
+    while ((m = constRe.exec(content)) !== null) {
+        const name = m[1] ?? "";
+        const typeAnnotation = m[2]?.trim();
+        const sig = typeAnnotation
+            ? `const ${name}: ${typeAnnotation}`
+            : `const ${name}`;
+        symbols.push({
+            name,
+            kind: "const",
+            signature: sig,
+            jsDoc: extractJsDoc(content, m.index),
+        });
+    }
+    return symbols;
+}
+function extractClassMembers(content, classPos) {
+    // Find the opening brace of the class body
+    const after = content.slice(classPos);
+    const braceIdx = after.indexOf("{");
+    if (braceIdx === -1)
+        return [];
+    // Extract up to 2000 chars of class body
+    const body = after.slice(braceIdx + 1, braceIdx + 2000);
+    const members = [];
+    // constructor (param content capped at 200 chars to prevent catastrophic backtracking)
+    const ctorMatch = body.match(/constructor\s*(\([^)]{0,200}\))/);
+    if (ctorMatch)
+        members.push(`constructor${ctorMatch[1] ?? "()"}`);
+    // public/protected methods (not private)
+    const methodRe = /(?:public|protected|static|async|override|\s)+(\w+)\s*(\([^)]{0,200}\))(?:\s*:\s*([^{;\n]{0,80}))?/g;
+    let m;
+    while ((m = methodRe.exec(body)) !== null) {
+        const name = m[1] ?? "";
+        if (name === "constructor")
+            continue;
+        const params = m[2] ?? "()";
+        const ret = m[3]?.trim();
+        members.push(ret ? `${name}${params}: ${ret}` : `${name}${params}`);
+        if (members.length >= 20)
+            break;
+    }
+    return members;
+}
+function renderMarkdown(filePath, symbols) {
+    if (symbols.length === 0)
+        return `# ${path.basename(filePath)}\n\nNo exported symbols found.\n`;
+    const lines = [`# ${path.basename(filePath)}\n`];
+    for (const sym of symbols) {
+        lines.push(`## \`${sym.signature}\``);
+        if (sym.jsDoc) {
+            lines.push(`\n${sym.jsDoc}`);
+        }
+        if (sym.members && sym.members.length > 0) {
+            lines.push("\n**Members:**");
+            for (const member of sym.members) {
+                lines.push(`- \`${member}\``);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=generateAPIDocumentation.js.map

package/dist/tools/generateAPIDocumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAPIDocumentation.js","sourceRoot":"","sources":["../../src/tools/generateAPIDocumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;AACzC,MAAM,SAAS,GAAG,EAAE,CAAC;AAgBrB,MAAM,UAAU,kCAAkC,CAAC,SAAiB;IAClE,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,yGAAyG;YAC3G,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,4CAA4C;qBAC1D;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;wBAC1B,WAAW,EAAE,mCAAmC;qBACjD;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,+CAA+C;qBAC7D;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;gBACnB,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,OAAgB;wBACtB,KAAK,EAAE;4BACL,IAAI,EAAE,QAAiB;4BACvB,UAAU,EAAE;gCACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;gCACjC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;gCACrC,aAAa,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;6BAC3C;4BACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC;yBAC/C;qBACF;oBACD,YAAY,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;iBAC3C;gBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC;aACpC;SACF;QACD,SAAS,EAAE,MAAM;QAEjB,KAAK,CAAC,OAAO,CACX,IAA6B;YAE7B,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,UAAU,CAAC;YAC5D,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,KAAK,CAAC;YAErE,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAErE,MAAM,IAAI,GAAc,EAAE,CAAC;YAC3B,IAAI,YAAY,GAAG,CAAC,CAAC;YAErB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,OAAe,CAAC;gBACpB,IAAI,CAAC;oBACH,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;gBACjD,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,CAAC,IAAI,CAAC;wBACR,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,aAAa,EAAE,gBAAgB,QAAQ,wBAAwB;qBAChE,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBAED,IAAI,OAAe,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAClC,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;wBAC9B,IAAI,CAAC,IAAI,CAAC;4BACR,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,CAAC;4BACV,aAAa,EAAE,+BAA+B;yBAC/C,CAAC,CAAC;wBACH,SAAS;oBACX,CAAC;oBACD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,IAAI,CAAC;wBACR,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,aAAa,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBAC5E,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBAED,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBACxD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;gBAE/B,MAAM,aAAa,GACjB,MAAM,KAAK,MAAM;oBACf,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAExC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;YACxE,CAAC;YAED,OAAO,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,GAAW;IAChD,kEAAkE;IAClE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,wEAAwE;IACxE,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACrE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrD,0BAA0B;IAC1B,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAC7C,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,cAAuB;IAC9D,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,wBAAwB;IACxB,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC;IAEvE,mDAAmD;IACnD,sFAAsF;IACtF,uDAAuD;IACvD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,GAAG,YAAY,wFAAwF,EACvG,GAAG,CACJ,CAAC;IACF,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,GAAG;YACb,CAAC,CAAC,YAAY,IAAI,GAAG,MAAM,KAAK,GAAG,EAAE;YACrC,CAAC,CAAC,YAAY,IAAI,GAAG,MAAM,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,GAAG,YAAY,iGAAiG,EAChH,GAAG,CACJ,CAAC;IACF,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,SAAS,IAAI,EAAE;YAC1B,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;YACrC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,GAAG,YAAY,mDAAmD,EAClE,GAAG,CACJ,CAAC;IACF,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,aAAa,IAAI,EAAE;YAC9B,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,GAAG,YAAY,oDAAoD,EACnE,GAAG,CACJ,CAAC;IACF,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,QAAQ,IAAI,MAAM,IAAI,EAAE;YACnC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,GAAG,YAAY,mDAAmD,EAClE,GAAG,CACJ,CAAC;IACF,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,cAAc;YACxB,CAAC,CAAC,SAAS,IAAI,KAAK,cAAc,EAAE;YACpC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe,EAAE,QAAgB;IAC5D,2CAA2C;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/B,yCAAyC;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAExD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,uFAAuF;IACvF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAChE,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAElE,yCAAyC;IACzC,MAAM,QAAQ,GACZ,qGAAqG,CAAC;IACxG,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,KAAK,aAAa;YAAE,SAAS;QACrC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC;QACpE,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE;YAAE,MAAM;IAClC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,OAAoB;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QACtB,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAExE,MAAM,KAAK,GAAa,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE3D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC7B,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/generateTests.d.ts

@@ -0,0 +1,75 @@
+export declare function createGenerateTestsTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                file: {
+                    type: string;
+                    description: string;
+                };
+                framework: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                outputFile: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                file: {
+                    type: string;
+                    description: string;
+                };
+                outputFile: {
+                    type: string;
+                    description: string;
+                };
+                framework: {
+                    type: string;
+                    description: string;
+                };
+                exports: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+                exportCount: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, _signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/generateTests.js

@@ -0,0 +1,226 @@
+import { existsSync, promises as fsPromises, readFileSync } from "node:fs";
+import path from "node:path";
+import { error, optionalString, requireString, successStructured, } from "./utils.js";
+function extractTsJsExports(content) {
+    const exports = [];
+    const patterns = [
+        /export\s+(?:async\s+)?function\s+(\w+)/g,
+        /export\s+class\s+(\w+)/g,
+        /export\s+const\s+(\w+)\s*=/g,
+    ];
+    for (const re of patterns) {
+        let m;
+        while ((m = re.exec(content)) !== null) {
+            if (m[1] && !exports.includes(m[1]))
+                exports.push(m[1]);
+        }
+    }
+    if (/export\s+default/.test(content) && !exports.includes("default")) {
+        exports.push("default");
+    }
+    return exports;
+}
+function extractPythonExports(content) {
+    const exports = [];
+    const re = /^(?:def|class)\s+(\w+)/gm;
+    let m;
+    while ((m = re.exec(content)) !== null) {
+        if (m[1] && !exports.includes(m[1]))
+            exports.push(m[1]);
+    }
+    return exports;
+}
+function detectFramework(framework, filePath, workspace) {
+    if (framework !== "auto")
+        return framework;
+    const ext = path.extname(filePath).toLowerCase();
+    if (ext === ".py")
+        return "pytest";
+    if (existsSync(path.join(workspace, "vitest.config.ts")) ||
+        existsSync(path.join(workspace, "vitest.config.js"))) {
+        return "vitest";
+    }
+    if (existsSync(path.join(workspace, "jest.config.js")) ||
+        existsSync(path.join(workspace, "jest.config.ts"))) {
+        return "jest";
+    }
+    // Check package.json for jest
+    try {
+        const pkg = JSON.parse(readFileSync(path.join(workspace, "package.json"), "utf-8"));
+        if (pkg.jest !== undefined ||
+            pkg.devDependencies?.jest) {
+            return "jest";
+        }
+    }
+    catch {
+        // ignore
+    }
+    return "vitest";
+}
+function deriveOutputFile(filePath, framework) {
+    const ext = path.extname(filePath);
+    const basename = path.basename(filePath, ext);
+    const dir = path.dirname(filePath);
+    if (framework === "pytest") {
+        return path.join(dir, `test_${basename}.py`);
+    }
+    // TS/JS: replace first src/ with src/__tests__/
+    const srcIndex = filePath.indexOf(`${path.sep}src${path.sep}`);
+    if (srcIndex !== -1) {
+        const beforeSrc = filePath.slice(0, srcIndex);
+        const afterSrc = filePath.slice(srcIndex + 1 + "src".length + 1); // skip /src/
+        return path.join(beforeSrc, "src", "__tests__", afterSrc.replace(ext, ".test.ts"));
+    }
+    return filePath.replace(ext, ".test.ts");
+}
+function generateVitestScaffold(filePath, exports, isJest) {
+    const relImport = `./${path.basename(filePath, path.extname(filePath))}.js`;
+    const namedExports = exports.filter((e) => e !== "default");
+    const hasDefault = exports.includes("default");
+    const importParts = [];
+    if (namedExports.length > 0)
+        importParts.push(`{ ${namedExports.join(", ")} }`);
+    if (hasDefault)
+        importParts.push("defaultExport");
+    const importLine = importParts.length > 0
+        ? `import ${importParts.join(", ")} from "${relImport}";`
+        : `// No named exports detected — update import as needed\nimport * as mod from "${relImport}";`;
+    const frameworkImport = isJest
+        ? `import { describe, it, expect, jest } from "@jest/globals";`
+        : `import { describe, it, expect, vi } from "vitest";`;
+    const blocks = exports.map((name) => {
+        const testName = name === "default" ? "defaultExport" : name;
+        return `  describe("${testName}", () => {\n    it("should work correctly", () => {\n      expect(${testName}).toBeDefined();\n    });\n  });`;
+    });
+    const moduleName = path.basename(filePath, path.extname(filePath));
+    return [
+        frameworkImport,
+        importLine,
+        "",
+        `describe("${moduleName}", () => {`,
+        blocks.join("\n\n"),
+        "});",
+        "",
+    ].join("\n");
+}
+function generatePytestScaffold(filePath, exports) {
+    const moduleName = path.basename(filePath, ".py");
+    const importLine = exports.length > 0
+        ? `from ${moduleName} import ${exports.join(", ")}`
+        : `import ${moduleName}`;
+    const testFns = exports.map((name) => {
+        return `def test_${name}():\n    pass`;
+    });
+    return ["import pytest", importLine, "", "", testFns.join("\n\n"), ""].join("\n");
+}
+export function createGenerateTestsTool(workspace) {
+    const frameworkCache = new Map();
+    return {
+        schema: {
+            name: "generateTests",
+            description: "Generate test scaffold from exported fns/classes. Returns describe/it content; does not write file.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    file: {
+                        type: "string",
+                        description: "Path to the source file",
+                    },
+                    framework: {
+                        type: "string",
+                        enum: ["vitest", "jest", "pytest", "auto"],
+                        description: "Test framework (default: auto-detect)",
+                    },
+                    outputFile: {
+                        type: "string",
+                        description: "Suggested output path (default: auto-derived)",
+                    },
+                },
+                required: ["file"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    file: { type: "string", description: "Absolute path to source file" },
+                    outputFile: {
+                        type: "string",
+                        description: "Suggested output path for the test file",
+                    },
+                    framework: {
+                        type: "string",
+                        description: "Detected test framework (vitest, jest, pytest)",
+                    },
+                    exports: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Exported names extracted from the source file",
+                    },
+                    content: {
+                        type: "string",
+                        description: "Generated test scaffold ready to write to outputFile",
+                    },
+                    exportCount: {
+                        type: "integer",
+                        description: "Number of exports detected",
+                    },
+                },
+                required: [
+                    "file",
+                    "outputFile",
+                    "framework",
+                    "exports",
+                    "content",
+                    "exportCount",
+                ],
+            },
+        },
+        handler: async (args, _signal) => {
+            const fileArg = requireString(args, "file");
+            const frameworkArg = optionalString(args, "framework") ?? "auto";
+            const outputFileArg = optionalString(args, "outputFile");
+            const filePath = path.isAbsolute(fileArg)
+                ? fileArg
+                : path.resolve(workspace, fileArg);
+            let content;
+            try {
+                content = await fsPromises.readFile(filePath, "utf-8");
+            }
+            catch {
+                return error(`Cannot read file: ${filePath}`);
+            }
+            const ext = path.extname(filePath).toLowerCase();
+            const isPython = ext === ".py";
+            const exports = isPython
+                ? extractPythonExports(content)
+                : extractTsJsExports(content);
+            const cacheKey = `${workspace}:${frameworkArg}`;
+            const cached = frameworkCache.get(cacheKey);
+            const framework = cached !== undefined
+                ? cached
+                : (() => {
+                    const result = detectFramework(frameworkArg, filePath, workspace);
+                    frameworkCache.set(cacheKey, result);
+                    return result;
+                })();
+            const outputFile = outputFileArg ?? deriveOutputFile(filePath, framework);
+            let scaffold;
+            if (framework === "pytest") {
+                scaffold = generatePytestScaffold(filePath, exports);
+            }
+            else {
+                scaffold = generateVitestScaffold(filePath, exports, framework === "jest");
+            }
+            return successStructured({
+                file: filePath,
+                outputFile,
+                framework,
+                exports,
+                content: scaffold,
+                exportCount: exports.length,
+            });
+        },
+    };
+}
+//# sourceMappingURL=generateTests.js.map

package/dist/tools/generateTests.js.map

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