@planu/cli 0.27.0 → 0.29.0

package/dist/engine/ai-cost-estimator/spec-loader.js

@@ -0,0 +1,102 @@
+// engine/ai-cost-estimator/spec-loader.ts — Loads spec content and counts acceptance criteria.
+// Extracted from core.ts to keep file sizes within limits.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Reads spec content from a sdd/specs directory.
+ * Tries to find the spec directory by matching specId prefix.
+ */
+export async function loadSpecContent(specId) {
+    // Try modern location first, fallback to legacy
+    let specsRoot = 'planu/specs';
+    try {
+        const { access: fsAccess } = await import('node:fs/promises');
+        await fsAccess(specsRoot);
+    }
+    catch {
+        specsRoot = 'docs/sdd/specs';
+    }
+    const { readdir } = await import('node:fs/promises');
+    let specDir = null;
+    try {
+        const topEntries = await readdir(specsRoot);
+        // Try flat layout first: planu/specs/SPEC-069-name/ or docs/sdd/specs/SPEC-069-name/
+        const flatMatch = topEntries.find((e) => e.startsWith(specId));
+        if (flatMatch) {
+            specDir = join(specsRoot, flatMatch);
+        }
+        else {
+            // Try nested layout: planu/specs/{feature}/SPEC-069-name/
+            for (const group of topEntries) {
+                try {
+                    const groupEntries = await readdir(join(specsRoot, group));
+                    const nestedMatch = groupEntries.find((e) => e.startsWith(specId));
+                    if (nestedMatch) {
+                        specDir = join(specsRoot, group, nestedMatch);
+                        break;
+                    }
+                }
+                catch {
+                    // Not a directory — skip
+                }
+            }
+        }
+    }
+    catch {
+        throw new Error(`Spec directory not found at "${specsRoot}". ` +
+            'Make sure you are running from the project root.');
+    }
+    if (!specDir) {
+        throw new Error(`Spec "${specId}" not found in "${specsRoot}". ` + 'Check that the spec directory exists.');
+    }
+    const parts = [];
+    // Try modern names first, fallback to legacy — only read one of each pair
+    for (const [modern, legacy] of [
+        ['spec.md', 'HU.md'],
+        ['technical.md', 'FICHA-TECNICA.md'],
+    ]) {
+        let found = false;
+        for (const filename of [modern, legacy]) {
+            if (found) {
+                break;
+            }
+            try {
+                const content = await readFile(join(specDir, filename), 'utf-8');
+                parts.push(content);
+                found = true;
+            }
+            catch {
+                // File not present — try next
+            }
+        }
+    }
+    if (parts.length === 0) {
+        throw new Error(`Spec "${specId}" has no spec files in "${specDir}". ` +
+            'Cannot estimate without spec content.');
+    }
+    return { content: parts.join('\n\n'), specDir };
+}
+/** Counts acceptance criteria (lines starting with "- [ ]" or "- [x]") in spec content. */
+export function countAcceptanceCriteria(specContent) {
+    const matches = specContent.match(/^- \[[ xX]\]/gm);
+    return matches?.length ?? 0;
+}
+/** Reads average tokens per call from usage.json if available. */
+export async function readUsageAvgTokensPerCall() {
+    try {
+        const { readFile: rf } = await import('node:fs/promises');
+        const raw = await rf('data/global/usage.json', 'utf-8');
+        /* v8 ignore start */
+        const log = JSON.parse(raw);
+        if (log.events.length === 0) {
+            return undefined;
+        }
+        // Usage events don't track token counts — return undefined to use defaults
+        return undefined;
+        /* v8 ignore stop */
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=spec-loader.js.map

package/dist/engine/ai-cost-estimator/spec-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.js","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/spec-loader.ts"],"names":[],"mappings":"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"}

package/dist/engine/code-transforms/transform-engine.d.ts

@@ -0,0 +1,7 @@
+import { type TransformRequest, type TransformResult } from '../../types/index.js';
+/**
+ * Execute a code transform based on the request intent.
+ * Returns a TransformResult with the transformed source, changes list, and timing.
+ */
+export declare function executeTransform(request: TransformRequest): TransformResult;
+//# sourceMappingURL=transform-engine.d.ts.map

package/dist/engine/code-transforms/transform-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-engine.d.ts","sourceRoot":"","sources":["../../../src/engine/code-transforms/transform-engine.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EASrB,MAAM,sBAAsB,CAAC;AAQ9B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAiC3E"}

package/dist/engine/code-transforms/transform-engine.js

@@ -0,0 +1,67 @@
+// engine/code-transforms/transform-engine.ts — Transform orchestrator (AC-01).
+// Validates intent, dispatches to the correct transform implementation, measures timing.
+import { TRANSFORM_INTENTS, } from '../../types/index.js';
+import { renameSymbol } from './typescript/rename-symbol.js';
+import { addTypes } from './typescript/add-types.js';
+import { addErrorHandling } from './typescript/add-error-handling.js';
+import { modernizeSyntax } from './typescript/modernize-syntax.js';
+import { extractInterface } from './typescript/extract-interface.js';
+import { addJSDoc } from './typescript/add-jsdoc.js';
+/**
+ * Execute a code transform based on the request intent.
+ * Returns a TransformResult with the transformed source, changes list, and timing.
+ */
+export function executeTransform(request) {
+    const start = performance.now();
+    const fileName = request.fileName ?? 'input.ts';
+    // Validate intent
+    if (!TRANSFORM_INTENTS.includes(request.intent)) {
+        return {
+            success: false,
+            transformed: request.source,
+            changes: [],
+            durationMs: performance.now() - start,
+            error: `Unknown transform intent: '${request.intent}'. Valid intents: ${TRANSFORM_INTENTS.join(', ')}`,
+        };
+    }
+    try {
+        const result = dispatch(request.intent, request.source, request.options, fileName);
+        return {
+            success: true,
+            transformed: result.transformed,
+            changes: result.changes,
+            durationMs: performance.now() - start,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            transformed: request.source,
+            changes: [],
+            durationMs: performance.now() - start,
+            error: message,
+        };
+    }
+}
+function dispatch(intent, source, options, fileName) {
+    switch (intent) {
+        case 'rename-symbol':
+            return renameSymbol(source, options, fileName);
+        case 'add-types':
+            return addTypes(source, options, fileName);
+        case 'add-error-handling':
+            return addErrorHandling(source, options, fileName);
+        case 'modernize-syntax':
+            return modernizeSyntax(source, options, fileName);
+        case 'extract-interface':
+            return extractInterface(source, options, fileName);
+        case 'add-jsdoc':
+            return addJSDoc(source, options, fileName);
+        /* v8 ignore next 4 -- exhaustive check: unreachable thanks to TRANSFORM_INTENTS validation */
+        default: {
+            throw new Error(`Unhandled transform intent: ${String(intent)}`);
+        }
+    }
+}
+//# sourceMappingURL=transform-engine.js.map

package/dist/engine/code-transforms/transform-engine.js.map

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

package/dist/engine/code-transforms/typescript/add-error-handling.d.ts

@@ -0,0 +1,6 @@
+import type { AddErrorHandlingOptions, ErrorHandlingResult } from '../../../types/index.js';
+/**
+ * Add try/catch error handling to async functions.
+ */
+export declare function addErrorHandling(source: string, options: AddErrorHandlingOptions, fileName: string): ErrorHandlingResult;
+//# sourceMappingURL=add-error-handling.d.ts.map

package/dist/engine/code-transforms/typescript/add-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-error-handling.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-error-handling.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EAGvB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAoDjC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,MAAM,GACf,mBAAmB,CAiDrB"}

package/dist/engine/code-transforms/typescript/add-error-handling.js

@@ -0,0 +1,92 @@
+// engine/code-transforms/typescript/add-error-handling.ts — (AC-04).
+// Wraps async function bodies with try/catch blocks.
+import { getTypeScript, parseSource, getLineNumber, createChange } from './ast-utils.js';
+function isAsyncFunction(ts, node) {
+    if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isArrowFunction(node)) {
+        const mods = ts.getModifiers(node);
+        return mods?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) === true;
+    }
+    return false;
+}
+function getNodeName(ts, node, sourceFile) {
+    if ((ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) && node.name) {
+        return node.name.getText(sourceFile);
+    }
+    return '<anonymous>';
+}
+function buildCatchBlock(style, fnName) {
+    switch (style) {
+        case 'return-null':
+            return [
+                `catch (error: unknown) {`,
+                `    console.error('Error in ${fnName}:', error);`,
+                `    return null;`,
+                `  }`,
+            ].join('\n');
+        case 'log-and-rethrow':
+            return [
+                `catch (error: unknown) {`,
+                `    console.error('Error in ${fnName}:', error);`,
+                `    throw error;`,
+                `  }`,
+            ].join('\n');
+        default: // 'rethrow'
+            return [`catch (error: unknown) {`, `    throw error;`, `  }`].join('\n');
+    }
+}
+function hasExistingTryCatch(ts, body) {
+    for (const stmt of body.statements) {
+        if (ts.isTryStatement(stmt)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Add try/catch error handling to async functions.
+ */
+export function addErrorHandling(source, options, fileName) {
+    const ts = getTypeScript();
+    const sourceFile = parseSource(source, fileName);
+    const style = options.style ?? 'rethrow';
+    const targets = [];
+    function visit(node) {
+        if (isAsyncFunction(ts, node)) {
+            let body;
+            if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) {
+                body = node.body;
+            }
+            else if (ts.isArrowFunction(node) && ts.isBlock(node.body)) {
+                body = node.body;
+            }
+            if (body && !hasExistingTryCatch(ts, body)) {
+                const name = getNodeName(ts, node, sourceFile);
+                targets.push({
+                    name,
+                    bodyStart: body.getStart(sourceFile) + 1,
+                    bodyEnd: body.getEnd() - 1,
+                    line: getLineNumber(sourceFile, node.getStart(sourceFile)),
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    if (targets.length === 0) {
+        return { transformed: source, changes: [] };
+    }
+    // Apply in reverse order
+    targets.sort((a, b) => b.bodyStart - a.bodyStart);
+    let result = source;
+    const changes = [];
+    for (const target of targets) {
+        const innerBody = result.slice(target.bodyStart, target.bodyEnd);
+        const catchBlock = buildCatchBlock(style, target.name);
+        const wrapped = `\n  try {${innerBody}} ${catchBlock}\n`;
+        result = result.slice(0, target.bodyStart) + wrapped + result.slice(target.bodyEnd);
+        changes.push(createChange(target.line, `Wrapped '${target.name}' with try/catch (${style})`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { transformed: result, changes };
+}
+//# sourceMappingURL=add-error-handling.js.map

package/dist/engine/code-transforms/typescript/add-error-handling.js.map

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

package/dist/engine/code-transforms/typescript/add-jsdoc.d.ts

@@ -0,0 +1,6 @@
+import type { AddJSDocOptions, AddJSDocResult } from '../../../types/index.js';
+/**
+ * Add JSDoc comments to functions and methods that don't have them.
+ */
+export declare function addJSDoc(source: string, options: AddJSDocOptions, fileName: string): AddJSDocResult;
+//# sourceMappingURL=add-jsdoc.d.ts.map

package/dist/engine/code-transforms/typescript/add-jsdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-jsdoc.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-jsdoc.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAGf,cAAc,EACf,MAAM,yBAAyB,CAAC;AAwDjC;;GAEG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,GACf,cAAc,CAwChB"}

package/dist/engine/code-transforms/typescript/add-jsdoc.js

@@ -0,0 +1,83 @@
+// engine/code-transforms/typescript/add-jsdoc.ts — Add JSDoc comments (AC-07).
+// Generates JSDoc stubs with @param, @returns, @throws for functions.
+import { getTypeScript, parseSource, getLineNumber, createChange } from './ast-utils.js';
+function hasJSDoc(source, nodeStart) {
+    // Check if there is already a JSDoc comment before this node
+    const before = source.slice(Math.max(0, nodeStart - 200), nodeStart);
+    return before.trimEnd().endsWith('*/');
+}
+function bodyHasThrow(ts, body) {
+    if (ts.isThrowStatement(body)) {
+        return true;
+    }
+    let found = false;
+    ts.forEachChild(body, (child) => {
+        if (bodyHasThrow(ts, child)) {
+            found = true;
+        }
+    });
+    return found;
+}
+function buildJSDoc(ts, node, sourceFile, options) {
+    const lines = ['/**'];
+    /* v8 ignore next 1 -- FunctionDeclaration without name is extremely rare in valid TS */
+    const name = node.name ? node.name.getText(sourceFile) : 'anonymous';
+    lines.push(` * ${name}`);
+    if (options.includeParams !== false) {
+        for (const param of node.parameters) {
+            const pName = param.name.getText(sourceFile);
+            const pType = param.type ? param.type.getText(sourceFile) : 'unknown';
+            lines.push(` * @param {${pType}} ${pName}`);
+        }
+    }
+    if (options.includeReturns !== false && node.type) {
+        const retType = node.type.getText(sourceFile);
+        if (retType !== 'void') {
+            lines.push(` * @returns {${retType}}`);
+        }
+    }
+    if (options.includeThrows !== false && node.body && bodyHasThrow(ts, node.body)) {
+        lines.push(` * @throws {Error}`);
+    }
+    lines.push(' */');
+    return lines.join('\n');
+}
+/**
+ * Add JSDoc comments to functions and methods that don't have them.
+ */
+export function addJSDoc(source, options, fileName) {
+    const ts = getTypeScript();
+    const sourceFile = parseSource(source, fileName);
+    const insertions = [];
+    function visit(node) {
+        if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) {
+            const start = node.getStart(sourceFile);
+            if (!hasJSDoc(source, start) && node.name) {
+                const name = node.name.getText(sourceFile);
+                const doc = buildJSDoc(ts, node, sourceFile, options);
+                insertions.push({
+                    position: start,
+                    text: doc + '\n',
+                    line: getLineNumber(sourceFile, start),
+                    name,
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    if (insertions.length === 0) {
+        return { transformed: source, changes: [] };
+    }
+    // Apply in reverse order
+    insertions.sort((a, b) => b.position - a.position);
+    let result = source;
+    const changes = [];
+    for (const ins of insertions) {
+        result = result.slice(0, ins.position) + ins.text + result.slice(ins.position);
+        changes.push(createChange(ins.line, `Added JSDoc to '${ins.name}'`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { transformed: result, changes };
+}
+//# sourceMappingURL=add-jsdoc.js.map

package/dist/engine/code-transforms/typescript/add-jsdoc.js.map

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

package/dist/engine/code-transforms/typescript/add-types.d.ts

@@ -0,0 +1,3 @@
+import type { AddTypesOptions, AddTypesResult } from '../../../types/index.js';
+export declare function addTypes(source: string, _options: AddTypesOptions, fileName: string): AddTypesResult;
+//# sourceMappingURL=add-types.d.ts.map

package/dist/engine/code-transforms/typescript/add-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-types.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAGf,cAAc,EACf,MAAM,yBAAyB,CAAC;AA0LjC,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,cAAc,CAwBhB"}

package/dist/engine/code-transforms/typescript/add-types.js

@@ -0,0 +1,182 @@
+// engine/code-transforms/typescript/add-types.ts — Add types transform (AC-03).
+// Infers types from initializers and adds type annotations.
+import { getTypeScript, parseSource, getLineNumber, createChange } from './ast-utils.js';
+// ---------------------------------------------------------------------------
+// Type inference from initializer
+// ---------------------------------------------------------------------------
+function inferTypeFromInit(ts, init) {
+    if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) {
+        return 'string';
+    }
+    if (ts.isNumericLiteral(init)) {
+        return 'number';
+    }
+    if (init.kind === ts.SyntaxKind.TrueKeyword || init.kind === ts.SyntaxKind.FalseKeyword) {
+        return 'boolean';
+    }
+    if (init.kind === ts.SyntaxKind.NullKeyword) {
+        return 'null';
+    }
+    /* v8 ignore start -- UndefinedKeyword is rarely emitted; TS parses `undefined` as Identifier */
+    if (init.kind === ts.SyntaxKind.UndefinedKeyword) {
+        return 'undefined';
+    }
+    /* v8 ignore stop */
+    if (ts.isArrayLiteralExpression(init)) {
+        return inferArrayType(ts, init);
+    }
+    if (ts.isObjectLiteralExpression(init)) {
+        return 'Record<string, unknown>';
+    }
+    return undefined;
+}
+function inferArrayType(ts, arr) {
+    if (arr.elements.length === 0) {
+        return 'unknown[]';
+    }
+    const first = arr.elements[0];
+    /* v8 ignore start -- defensive: elements[0] always exists when length > 0 */
+    if (!first) {
+        return 'unknown[]';
+    }
+    /* v8 ignore stop */
+    const elemType = inferTypeFromInit(ts, first);
+    return elemType ? `${elemType}[]` : 'unknown[]';
+}
+// ---------------------------------------------------------------------------
+// Collect replacements from variable declarations
+// ---------------------------------------------------------------------------
+function collectVariableTypes(ts, sourceFile, replacements) {
+    function visit(node) {
+        if (ts.isVariableDeclaration(node) && !node.type && node.initializer) {
+            const inferred = inferTypeFromInit(ts, node.initializer);
+            if (inferred) {
+                const nameEnd = node.name.getEnd();
+                replacements.push({
+                    position: nameEnd,
+                    length: 0,
+                    newText: `: ${inferred}`,
+                    line: getLineNumber(sourceFile, node.getStart(sourceFile)),
+                    description: `Added type annotation ': ${inferred}' to variable '${node.name.getText(sourceFile)}'`,
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+}
+// ---------------------------------------------------------------------------
+// Collect replacements from function return types
+// ---------------------------------------------------------------------------
+function inferReturnType(ts, body) {
+    let foundType;
+    for (const stmt of body.statements) {
+        if (ts.isReturnStatement(stmt) && stmt.expression) {
+            const t = inferTypeFromInit(ts, stmt.expression);
+            if (t && !foundType) {
+                foundType = t;
+            }
+            else if (t && foundType && t !== foundType) {
+                return undefined; // mixed return types
+            }
+        }
+    }
+    return foundType;
+}
+function findClosingParen(source, startPos) {
+    let depth = 0;
+    for (let i = startPos; i < source.length; i++) {
+        const ch = source[i];
+        if (ch === '(') {
+            depth++;
+        }
+        if (ch === ')') {
+            depth--;
+            if (depth === 0) {
+                return i;
+            }
+        }
+    }
+    /* v8 ignore next 1 */
+    return -1;
+}
+function collectFunctionReturnTypes(ts, sourceFile, source, replacements) {
+    function visit(node) {
+        if ((ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) &&
+            !node.type &&
+            node.body) {
+            const retType = inferReturnType(ts, node.body);
+            if (retType) {
+                const parenPos = findClosingParen(source, node.getStart(sourceFile));
+                /* v8 ignore start -- defensive: findClosingParen always succeeds for valid function decls */
+                if (parenPos > 0) {
+                    /* v8 ignore stop */
+                    const insertPos = parenPos + 1;
+                    /* v8 ignore start -- FunctionDeclaration without name is extremely rare */
+                    const name = node.name ? node.name.getText(sourceFile) : '<anonymous>';
+                    /* v8 ignore stop */
+                    replacements.push({
+                        position: insertPos,
+                        length: 0,
+                        newText: `: ${retType}`,
+                        line: getLineNumber(sourceFile, node.getStart(sourceFile)),
+                        description: `Added return type ': ${retType}' to function '${name}'`,
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+}
+// ---------------------------------------------------------------------------
+// Collect replacements from function parameters
+// ---------------------------------------------------------------------------
+function collectParameterTypes(ts, sourceFile, replacements) {
+    function visit(node) {
+        if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) {
+            for (const param of node.parameters) {
+                if (!param.type && param.initializer) {
+                    const inferred = inferTypeFromInit(ts, param.initializer);
+                    if (inferred) {
+                        const nameEnd = param.name.getEnd();
+                        replacements.push({
+                            position: nameEnd,
+                            length: 0,
+                            newText: `: ${inferred}`,
+                            line: getLineNumber(sourceFile, param.getStart(sourceFile)),
+                            description: `Added type ': ${inferred}' to parameter '${param.name.getText(sourceFile)}'`,
+                        });
+                    }
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+export function addTypes(source, _options, fileName) {
+    const ts = getTypeScript();
+    const sourceFile = parseSource(source, fileName);
+    const replacements = [];
+    collectVariableTypes(ts, sourceFile, replacements);
+    collectFunctionReturnTypes(ts, sourceFile, source, replacements);
+    collectParameterTypes(ts, sourceFile, replacements);
+    if (replacements.length === 0) {
+        return { transformed: source, changes: [] };
+    }
+    // Apply in reverse position order
+    replacements.sort((a, b) => b.position - a.position);
+    let result = source;
+    const changes = [];
+    for (const rep of replacements) {
+        result = result.slice(0, rep.position) + rep.newText + result.slice(rep.position + rep.length);
+        changes.push(createChange(rep.line, rep.description));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { transformed: result, changes };
+}
+//# sourceMappingURL=add-types.js.map

package/dist/engine/code-transforms/typescript/add-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-types.js","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/add-types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4DAA4D;AAS5D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzF,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,SAAS,iBAAiB,CAAC,EAAmB,EAAE,IAAyB;IACvE,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;QACxF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,gGAAgG;IAChG,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACjD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,oBAAoB;IACpB,IAAI,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,EAAmB,EAAE,GAAoC;IAC/E,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9B,6EAA6E;IAC7E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,oBAAoB;IACpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,SAAS,oBAAoB,CAC3B,EAAmB,EACnB,UAA+B,EAC/B,YAA+B;IAE/B,SAAS,KAAK,CAAC,IAAmB;QAChC,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YACzD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACnC,YAAY,CAAC,IAAI,CAAC;oBAChB,QAAQ,EAAE,OAAO;oBACjB,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,KAAK,QAAQ,EAAE;oBACxB,IAAI,EAAE,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;oBAC1D,WAAW,EAAE,4BAA4B,QAAQ,kBAAkB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG;iBACpG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,SAAS,eAAe,CAAC,EAAmB,EAAE,IAAoB;IAChE,IAAI,SAA6B,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,SAAS,GAAG,CAAC,CAAC;YAChB,CAAC;iBAAM,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7C,OAAO,SAAS,CAAC,CAAC,qBAAqB;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,QAAgB;IACxD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,KAAK,EAAE,CAAC;QACV,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;IACH,CAAC;IACD,sBAAsB;IACtB,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,SAAS,0BAA0B,CACjC,EAAmB,EACnB,UAA+B,EAC/B,MAAc,EACd,YAA+B;IAE/B,SAAS,KAAK,CAAC,IAAmB;QAChC,IACE,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAChE,CAAC,IAAI,CAAC,IAAI;YACV,IAAI,CAAC,IAAI,EACT,CAAC;YACD,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;gBACrE,6FAA6F;gBAC7F,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBACjB,oBAAoB;oBACpB,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,CAAC;oBAC/B,2EAA2E;oBAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;oBACvE,oBAAoB;oBACpB,YAAY,CAAC,IAAI,CAAC;wBAChB,QAAQ,EAAE,SAAS;wBACnB,MAAM,EAAE,CAAC;wBACT,OAAO,EAAE,KAAK,OAAO,EAAE;wBACvB,IAAI,EAAE,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;wBAC1D,WAAW,EAAE,wBAAwB,OAAO,kBAAkB,IAAI,GAAG;qBACtE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAS,qBAAqB,CAC5B,EAAmB,EACnB,UAA+B,EAC/B,YAA+B;IAE/B,SAAS,KAAK,CAAC,IAAmB;QAChC,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;oBACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;oBAC1D,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;wBACpC,YAAY,CAAC,IAAI,CAAC;4BAChB,QAAQ,EAAE,OAAO;4BACjB,MAAM,EAAE,CAAC;4BACT,OAAO,EAAE,KAAK,QAAQ,EAAE;4BACxB,IAAI,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;4BAC3D,WAAW,EAAE,iBAAiB,QAAQ,mBAAmB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG;yBAC3F,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,UAAU,QAAQ,CACtB,MAAc,EACd,QAAyB,EACzB,QAAgB;IAEhB,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,YAAY,GAAsB,EAAE,CAAC;IAE3C,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IACnD,0BAA0B,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACjE,qBAAqB,CAAC,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAEpD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,kCAAkC;IAClC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}