@agentuity/migrate 3.0.0-alpha.0 → 3.0.0-alpha.1

package/dist/report.js

@@ -156,4 +156,68 @@ export function printChangeSummary(allChanges) {
     }
     console.log();
 }
+// ---------------------------------------------------------------------------
+// V3 report functions
+// ---------------------------------------------------------------------------
+function renderV3Finding(f, index) {
+    const label = SEVERITY_LABEL[f.severity];
+    const icon = SEVERITY_ICON[f.severity];
+    const num = dim(`${String(index + 1).padStart(2, ' ')}.`);
+    const file = f.file ? dim(` [${f.file}]`) : '';
+    const hint = f.hint ? `\n       ${dim('↳ ' + f.hint.replace(/\n/g, '\n         '))}` : '';
+    return `  ${num} [${label}] ${icon} ${f.message}${file}${hint}`;
+}
+export function printV3Report(detection) {
+    const { findings } = detection;
+    const autoFindings = findings.filter((f) => f.severity === 'auto');
+    const guidedFindings = findings.filter((f) => f.severity === 'guided');
+    const manualFindings = findings.filter((f) => f.severity === 'manual');
+    console.log(`\n${bold('━━━ Agentuity v2 → v3 Migration Report ━━━')}`);
+    console.log(dim(`Project: ${detection.projectDir}`));
+    if (findings.length === 0) {
+        console.log(`\n${green('✓')} ${bold('No v2 patterns detected!')} ` +
+            `This project may already be on v3.\n`);
+        return;
+    }
+    // Summary counts
+    console.log(`\n${bold('Summary:')} ` +
+        `${green(String(autoFindings.length))} auto-fixable, ` +
+        `${yellow(String(guidedFindings.length))} guided, ` +
+        `${red(String(manualFindings.length))} manual`);
+    // Info about v3
+    console.log(`\n${dim('v3 is framework-agnostic: bring your own framework, use @agentuity/hono')}\n` +
+        `${dim('middleware for services, and dedicated packages for each service.')}`);
+    if (autoFindings.length > 0) {
+        console.log(heading('Auto-fixable (will be applied automatically)'));
+        autoFindings.forEach((f, i) => console.log(renderV3Finding(f, i)));
+    }
+    if (guidedFindings.length > 0) {
+        console.log(heading('Guided (applied with your review)'));
+        guidedFindings.forEach((f, i) => console.log(renderV3Finding(f, i)));
+    }
+    if (manualFindings.length > 0) {
+        console.log(heading('Manual (requires human action — tool will not touch these)'));
+        manualFindings.forEach((f, i) => console.log(renderV3Finding(f, i)));
+    }
+    console.log(`\n${hr()}`);
+    console.log(`${dim('Legend:')}  ` +
+        `[${green('  auto  ')}] fully automated  ` +
+        `[${yellow(' guided ')}] applied + verify  ` +
+        `[${red(' manual ')}] instructions only`);
+    console.log();
+}
+export function printManualSummaryV3(detection) {
+    const manualFindings = detection.findings.filter((f) => f.severity === 'manual');
+    if (manualFindings.length === 0)
+        return;
+    console.log(`\n${bold('━━━ Remaining Manual Steps ━━━')}\n`);
+    manualFindings.forEach((f, i) => {
+        console.log(`  ${dim(`${i + 1}.`)} ${red('✗')} ${f.message}`);
+        if (f.file)
+            console.log(`     ${dim(`File: ${f.file}`)}`);
+        if (f.hint) {
+            console.log(`\n     ${f.hint.split('\n').join('\n     ')}\n`);
+        }
+    });
+}
 //# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/transforms/v3/agents.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Transform: createAgent() → plain exported functions
+ *
+ * For "simple" agents (handler + optional schema only), we:
+ *   1. Remove the createAgent() wrapper
+ *   2. Extract the handler as a named exported async function
+ *   3. Preserve schema validation if present
+ *   4. Replace ctx.* service access with imports from services module
+ *
+ * For "complex" agents, we add a prominent migration comment and leave
+ * the code untouched for manual review.
+ *
+ * We use a combination of regex and AST analysis — regex for the mechanical
+ * transforms (preserving formatting), AST for detection (already done in detect-v3).
+ */
+import type { AgentFile } from '../../detect-v3';
+export interface AgentTransformResult {
+    /** The transformed source, or null if skipped */
+    source: string | null;
+    /** What was changed */
+    changes: string[];
+    /** If the agent is too complex for auto-migration */
+    manualRequired?: boolean;
+}
+/**
+ * Service access patterns to rewrite.
+ * Maps ctx.serviceName → serviceName (import from services module).
+ */
+/**
+ * Transform a simple agent file into a plain exported function.
+ */
+export declare function transformAgentFile(source: string, agentInfo: AgentFile, servicesRelativePath: string): AgentTransformResult;
+//# sourceMappingURL=agents.d.ts.map

package/dist/transforms/v3/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/transforms/v3/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACpC,iDAAiD;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAOD;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,MAAM,GAC1B,oBAAoB,CAuEtB"}

package/dist/transforms/v3/agents.js

@@ -0,0 +1,335 @@
+/**
+ * Transform: createAgent() → plain exported functions
+ *
+ * For "simple" agents (handler + optional schema only), we:
+ *   1. Remove the createAgent() wrapper
+ *   2. Extract the handler as a named exported async function
+ *   3. Preserve schema validation if present
+ *   4. Replace ctx.* service access with imports from services module
+ *
+ * For "complex" agents, we add a prominent migration comment and leave
+ * the code untouched for manual review.
+ *
+ * We use a combination of regex and AST analysis — regex for the mechanical
+ * transforms (preserving formatting), AST for detection (already done in detect-v3).
+ */
+import ts from 'typescript';
+/**
+ * Names we use for the context parameter that should be removed.
+ */
+const CTX_PARAM_NAMES = ['ctx', 'context', 'c', '_ctx', '_context', '_c'];
+/**
+ * Service access patterns to rewrite.
+ * Maps ctx.serviceName → serviceName (import from services module).
+ */
+/**
+ * Transform a simple agent file into a plain exported function.
+ */
+export function transformAgentFile(source, agentInfo, servicesRelativePath) {
+    if (agentInfo.complexity === 'complex') {
+        return addManualMigrationComment(source, agentInfo);
+    }
+    const changes = [];
+    const sourceFile = ts.createSourceFile(agentInfo.path, source, ts.ScriptTarget.ESNext, true);
+    // Find the createAgent() call and extract the handler
+    const extracted = extractHandlerFromCreateAgent(sourceFile, source);
+    if (!extracted) {
+        return {
+            source: null,
+            changes: ['Could not extract handler from createAgent() — manual review needed'],
+            manualRequired: true,
+        };
+    }
+    let output = source;
+    // Step 1: Remove the createAgent import
+    output = removeCreateAgentImport(output);
+    changes.push('Removed createAgent import from @agentuity/runtime');
+    // Step 2: Add services import if needed
+    if (agentInfo.ctxServices.length > 0) {
+        const serviceImports = agentInfo.ctxServices.filter((s) => s !== 'logger');
+        const needsLogger = agentInfo.ctxServices.includes('logger');
+        const importLines = [];
+        if (serviceImports.length > 0) {
+            importLines.push(`import { ${serviceImports.join(', ')} } from '${servicesRelativePath}';`);
+        }
+        if (needsLogger) {
+            importLines.push(`import { ${serviceImports.length > 0 ? '' : ''}logger } from '${servicesRelativePath}';`);
+        }
+        // Consolidate into one import if both
+        if (serviceImports.length > 0 || needsLogger) {
+            const allImports = [...agentInfo.ctxServices];
+            const importLine = `import { ${allImports.join(', ')} } from '${servicesRelativePath}';`;
+            // Insert after last import line
+            output = insertAfterImports(output, importLine);
+            changes.push(`Added services import: ${allImports.join(', ')}`);
+        }
+    }
+    // Step 3: Replace the entire createAgent() export with a plain function
+    output = replaceCreateAgentWithFunction(output, agentInfo, extracted);
+    changes.push(`Converted agent "${agentInfo.name}" to plain exported async function`);
+    // Step 4: Replace ctx.service with direct service references
+    for (const service of agentInfo.ctxServices) {
+        for (const ctxName of CTX_PARAM_NAMES) {
+            const pattern = new RegExp(`${ctxName}\\.${service}\\b`, 'g');
+            if (pattern.test(output)) {
+                output = output.replace(pattern, service);
+                changes.push(`Replaced ${ctxName}.${service} → ${service}`);
+            }
+        }
+    }
+    // Step 5: Clean up — remove ctx/context parameter references that are now unused
+    // (Don't do this automatically — leave for the user to clean up)
+    return { source: output, changes };
+}
+/**
+ * For complex agents, add a migration comment block.
+ */
+function addManualMigrationComment(source, agentInfo) {
+    const comment = `// ⚠️  MIGRATION REQUIRED — createAgent() removed in v3\n` +
+        `//\n` +
+        `// This agent ("${agentInfo.name}") requires manual migration because:\n` +
+        `//   ${agentInfo.complexityReason}\n` +
+        `//\n` +
+        `// To migrate:\n` +
+        `//   1. Extract the handler into a plain exported async function\n` +
+        `//   2. Move setup() logic to module-level initialization\n` +
+        `//   3. Replace ctx.kv/ctx.vector/etc. with imports from '../services'\n` +
+        `//   4. Replace ctx.config with direct configuration\n` +
+        `//   5. Remove event listeners (use your own event patterns)\n` +
+        `//   6. Remove the createAgent() import and wrapper\n` +
+        `//\n` +
+        `// Example after migration:\n` +
+        `//   import { kv } from '../services';\n` +
+        `//\n` +
+        `//   export async function ${toFunctionName(agentInfo.name)}(input: YourInputType) {\n` +
+        `//     const data = await kv.get('namespace', 'key');\n` +
+        `//     return { result: data };\n` +
+        `//   }\n`;
+    return {
+        source: comment + '\n' + source,
+        changes: [`Added migration comment for complex agent "${agentInfo.name}"`],
+        manualRequired: true,
+    };
+}
+/**
+ * Extract the handler function body and parameters from createAgent().
+ */
+function extractHandlerFromCreateAgent(sourceFile, _source) {
+    let result = null;
+    function visit(node) {
+        if (result)
+            return;
+        if (ts.isCallExpression(node) &&
+            ts.isIdentifier(node.expression) &&
+            node.expression.text === 'createAgent') {
+            const configArg = node.arguments[1];
+            if (!configArg || !ts.isObjectLiteralExpression(configArg))
+                return;
+            let handlerNode;
+            let schemaNode;
+            for (const prop of configArg.properties) {
+                if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name)) {
+                    if (prop.name.text === 'handler') {
+                        handlerNode = prop.initializer;
+                    }
+                    if (prop.name.text === 'schema') {
+                        schemaNode = prop.initializer;
+                    }
+                }
+                if (ts.isMethodDeclaration(prop) && ts.isIdentifier(prop.name)) {
+                    if (prop.name.text === 'handler') {
+                        handlerNode = prop;
+                    }
+                }
+            }
+            if (!handlerNode)
+                return;
+            // Extract handler params and body
+            let params;
+            let body;
+            if (ts.isArrowFunction(handlerNode) || ts.isFunctionExpression(handlerNode)) {
+                params = handlerNode.parameters;
+                body = handlerNode.body;
+            }
+            else if (ts.isMethodDeclaration(handlerNode)) {
+                params = handlerNode.parameters;
+                body = handlerNode.body;
+            }
+            if (!body)
+                return;
+            // Get parameter text (skip ctx/context parameter, keep input)
+            const paramTexts = [];
+            if (params) {
+                for (let i = 0; i < params.length; i++) {
+                    const param = params[i];
+                    if (!param)
+                        continue;
+                    const paramName = param.name.getText(sourceFile);
+                    // Skip the first param if it's ctx/context (agent context)
+                    if (i === 0 && CTX_PARAM_NAMES.includes(paramName))
+                        continue;
+                    paramTexts.push(param.getText(sourceFile));
+                }
+            }
+            // Get body text
+            const bodyText = body.getText(sourceFile);
+            // Get schema text if present
+            const schemaText = schemaNode?.getText(sourceFile);
+            result = {
+                handlerParams: paramTexts.join(', '),
+                handlerBody: bodyText,
+                hasSchema: !!schemaNode,
+                schemaText,
+            };
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return result;
+}
+/**
+ * Remove `import { createAgent } from '@agentuity/runtime'` (and any other
+ * named imports from that module).
+ */
+function removeCreateAgentImport(source) {
+    // Remove the entire @agentuity/runtime import line
+    // (there shouldn't be other useful imports from runtime in v3)
+    return source.replace(/import\s*\{[^}]*\}\s*from\s*['"]@agentuity\/runtime['"]\s*;?\s*\n?/g, '');
+}
+/**
+ * Insert an import line after the last existing import declaration.
+ * Uses AST to correctly handle multi-line imports.
+ */
+function insertAfterImports(source, importLine) {
+    const sf = ts.createSourceFile('temp.ts', source, ts.ScriptTarget.ESNext, true);
+    let lastImportEnd = -1;
+    for (const stmt of sf.statements) {
+        if (ts.isImportDeclaration(stmt)) {
+            lastImportEnd = stmt.getEnd();
+        }
+    }
+    if (lastImportEnd >= 0) {
+        return (source.substring(0, lastImportEnd) + '\n' + importLine + source.substring(lastImportEnd));
+    }
+    // No imports — add at the top
+    return importLine + '\n' + source;
+}
+/**
+ * Replace the createAgent() call with a plain exported async function.
+ *
+ * Uses AST node positions for precise replacement instead of regex
+ * (which can't handle nested braces in the config object).
+ */
+function replaceCreateAgentWithFunction(source, agentInfo, extracted) {
+    const funcName = toFunctionName(agentInfo.name);
+    // Build the function signature
+    const funcSignature = `export async function ${funcName}(${extracted.handlerParams})`;
+    // Build the body
+    let bodyText = extracted.handlerBody;
+    // If the body is already a block { ... }, use it directly
+    // If it's a single expression (arrow function body), wrap it
+    if (!bodyText.trimStart().startsWith('{')) {
+        bodyText = `{\n\treturn ${bodyText};\n}`;
+    }
+    // Add schema validation at the top of the function body if schema was present
+    let schemaComment = '';
+    if (extracted.hasSchema && extracted.schemaText) {
+        schemaComment =
+            '\n// TODO: Schema validation was previously handled by createAgent().\n' +
+                '// The original schema definition was:\n' +
+                `//   schema: ${extracted.schemaText.split('\n').join('\n//   ')}\n` +
+                '// Consider using zod or @agentuity/schema for input validation.\n';
+    }
+    const replacement = schemaComment + funcSignature + ' ' + bodyText;
+    // Use AST to find the exact range of the createAgent() statement
+    const sourceFile = ts.createSourceFile(agentInfo.path, source, ts.ScriptTarget.ESNext, true);
+    let createAgentStart = -1;
+    let createAgentEnd = -1;
+    let exportDefaultVarName = null;
+    let isDirectExportDefault = false;
+    for (const stmt of sourceFile.statements) {
+        // Pattern 1: export default createAgent('name', { ... })
+        if (ts.isExportAssignment(stmt) && !stmt.isExportEquals) {
+            const expr = stmt.expression;
+            if (ts.isCallExpression(expr) &&
+                ts.isIdentifier(expr.expression) &&
+                expr.expression.text === 'createAgent') {
+                createAgentStart = stmt.getStart(sourceFile);
+                createAgentEnd = stmt.getEnd();
+                isDirectExportDefault = true;
+                break;
+            }
+        }
+        // Pattern 2: const agent = createAgent('name', { ... })
+        if (ts.isVariableStatement(stmt)) {
+            const declarations = stmt.declarationList.declarations;
+            if (declarations.length === 1) {
+                const decl = declarations[0];
+                if (decl?.initializer) {
+                    let callExpr;
+                    if (ts.isCallExpression(decl.initializer) &&
+                        ts.isIdentifier(decl.initializer.expression) &&
+                        decl.initializer.expression.text === 'createAgent') {
+                        callExpr = decl.initializer;
+                    }
+                    else if (ts.isAwaitExpression(decl.initializer) &&
+                        ts.isCallExpression(decl.initializer.expression) &&
+                        ts.isIdentifier(decl.initializer.expression.expression) &&
+                        decl.initializer.expression.expression.text === 'createAgent') {
+                        callExpr = decl.initializer.expression;
+                    }
+                    if (callExpr && ts.isIdentifier(decl.name)) {
+                        exportDefaultVarName = decl.name.text;
+                        createAgentStart = stmt.getStart(sourceFile);
+                        createAgentEnd = stmt.getEnd();
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    if (createAgentStart === -1) {
+        // Couldn't find the createAgent statement — return source unchanged
+        return source;
+    }
+    // Replace the createAgent statement with the function
+    let result = source.substring(0, createAgentStart) + replacement + source.substring(createAgentEnd);
+    // Handle the export default
+    if (isDirectExportDefault) {
+        // The export default was part of the statement we replaced,
+        // so add a separate export default
+        result += `\n\nexport default ${funcName};\n`;
+    }
+    else if (exportDefaultVarName) {
+        // Replace `export default varName` with `export default funcName`
+        result = result.replace(new RegExp(`export\\s+default\\s+${exportDefaultVarName}\\s*;?`), `export default ${funcName};`);
+    }
+    return result;
+}
+/**
+ * Convert kebab-case or snake_case agent name to camelCase function name.
+ */
+/** Service names that could clash with function names */
+const RESERVED_SERVICE_NAMES = new Set([
+    'kv',
+    'vector',
+    'stream',
+    'queue',
+    'email',
+    'task',
+    'schedule',
+    'sandbox',
+    'logger',
+]);
+/**
+ * Convert agent name to a valid, non-clashing function name.
+ * Appends 'Handler' suffix if the name would clash with a service import.
+ */
+function toFunctionName(name) {
+    const camel = name.replace(/[-_]([a-z])/g, (_, c) => c.toUpperCase());
+    if (RESERVED_SERVICE_NAMES.has(camel)) {
+        return camel + 'Handler';
+    }
+    return camel;
+}
+//# sourceMappingURL=agents.js.map

package/dist/transforms/v3/agents.js.map

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

package/dist/transforms/v3/dev-setup.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Transform: dev setup for Hono + SPA projects.
+ *
+ * When a project has both a Hono backend (src/index.ts) and a Vite SPA
+ * (src/web/), we need to set up a dev workflow that runs both:
+ *
+ *   1. Add a Vite proxy config so /api requests go to the Hono backend
+ *   2. Set up dev scripts to run both servers concurrently
+ *
+ * In production, the buildpack handles this (static server + Hono backend).
+ * In dev, we use Vite's built-in proxy to keep it a single-port experience.
+ */
+export interface DevSetupResult {
+    /** Patched vite.config.ts content, or null if no changes */
+    viteConfig: string | null;
+    /** Changes made to vite.config.ts */
+    viteChanges: string[];
+    /** dev script value for package.json */
+    devScript: string;
+    /** server:api script value for package.json */
+    serverScript: string;
+}
+/**
+ * Generate dev setup for a Hono + Vite SPA project.
+ */
+export declare function generateDevSetup(viteConfigSource: string | null): DevSetupResult;
+//# sourceMappingURL=dev-setup.d.ts.map

package/dist/transforms/v3/dev-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-setup.d.ts","sourceRoot":"","sources":["../../../src/transforms/v3/dev-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,cAAc;IAC9B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAiChF"}

package/dist/transforms/v3/dev-setup.js

@@ -0,0 +1,103 @@
+/**
+ * Transform: dev setup for Hono + SPA projects.
+ *
+ * When a project has both a Hono backend (src/index.ts) and a Vite SPA
+ * (src/web/), we need to set up a dev workflow that runs both:
+ *
+ *   1. Add a Vite proxy config so /api requests go to the Hono backend
+ *   2. Set up dev scripts to run both servers concurrently
+ *
+ * In production, the buildpack handles this (static server + Hono backend).
+ * In dev, we use Vite's built-in proxy to keep it a single-port experience.
+ */
+import ts from 'typescript';
+const API_PORT = 3001;
+/**
+ * Generate dev setup for a Hono + Vite SPA project.
+ */
+export function generateDevSetup(viteConfigSource) {
+    const serverScript = `PORT=${API_PORT} bun --hot src/index.ts`;
+    const devScript = `bun run server:api & vite dev`;
+    if (!viteConfigSource) {
+        // No vite.config.ts — just return scripts, no vite changes
+        return {
+            viteConfig: null,
+            viteChanges: [],
+            devScript: serverScript, // No SPA, just run the server
+            serverScript,
+        };
+    }
+    // Check if proxy is already configured
+    if (viteConfigSource.includes('proxy')) {
+        return {
+            viteConfig: null,
+            viteChanges: ['Vite proxy already configured — skipped'],
+            devScript,
+            serverScript,
+        };
+    }
+    // Add server.proxy to vite.config.ts using AST to find the right insertion point
+    const patched = addViteProxy(viteConfigSource);
+    return {
+        viteConfig: patched.source,
+        viteChanges: patched.changes,
+        devScript,
+        serverScript,
+    };
+}
+/**
+ * Add server.proxy configuration to vite.config.ts.
+ *
+ * Finds the defineConfig() call and injects a `server` property with proxy config.
+ */
+function addViteProxy(source) {
+    const changes = [];
+    const proxyConfig = `\tserver: {\n` +
+        `\t\tproxy: {\n` +
+        `\t\t\t'/api': {\n` +
+        `\t\t\t\ttarget: 'http://localhost:${API_PORT}',\n` +
+        `\t\t\t\tchangeOrigin: true,\n` +
+        `\t\t\t},\n` +
+        `\t\t},\n` +
+        `\t},`;
+    const sf = ts.createSourceFile('vite.config.ts', source, ts.ScriptTarget.ESNext, true);
+    // Find the defineConfig() call's object literal argument
+    let configObjectEnd = -1;
+    function visit(node) {
+        if (configObjectEnd >= 0)
+            return;
+        if (ts.isCallExpression(node) &&
+            ts.isIdentifier(node.expression) &&
+            node.expression.text === 'defineConfig') {
+            const arg = node.arguments[0];
+            if (arg && ts.isObjectLiteralExpression(arg)) {
+                // Insert before the closing brace of the config object
+                configObjectEnd = arg.getEnd() - 1; // Position of `}`
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    if (configObjectEnd >= 0) {
+        // Insert the proxy config before the closing `}` of defineConfig({...})
+        const before = source.substring(0, configObjectEnd);
+        const after = source.substring(configObjectEnd);
+        // Check if there's already content (need a comma)
+        const trimmedBefore = before.trimEnd();
+        const needsComma = trimmedBefore.endsWith(',') || trimmedBefore.endsWith('{') ? '' : ',';
+        const result = `${before}${needsComma}\n${proxyConfig}\n${after}`;
+        changes.push(`Added server.proxy config: /api → http://localhost:${API_PORT}`);
+        return { source: result, changes };
+    }
+    // Fallback: couldn't find defineConfig — append a comment
+    const fallback = source +
+        '\n\n// TODO: Add Vite proxy for dev mode:\n' +
+        '// server: {\n' +
+        '//   proxy: {\n' +
+        `//     '/api': { target: 'http://localhost:${API_PORT}', changeOrigin: true },\n` +
+        '//   },\n' +
+        '// },\n';
+    changes.push('Could not auto-patch vite.config.ts — added proxy config as comment');
+    return { source: fallback, changes };
+}
+//# sourceMappingURL=dev-setup.js.map

package/dist/transforms/v3/dev-setup.js.map

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