@claude-flow/cli 3.10.9 → 3.10.11

package/dist/src/ruvector/codemods/engine.js

@@ -0,0 +1,291 @@
+/**
+ * Deterministic Codemod Engine (ADR-143)
+ *
+ * Truly $0, no-LLM Tier-1 code transforms. Uses the TypeScript compiler API to
+ * locate exact AST nodes, then applies formatting-preserving text-range edits to
+ * the original source string (we never re-print the whole file, so comments and
+ * formatting survive).
+ *
+ * Only intents that can be transformed *deterministically and safely* live here.
+ * Intents that need inference or judgement (add-types, add-error-handling,
+ * async-await) are intentionally NOT codemods — they route to a model. See
+ * ADR-143 for the rationale.
+ *
+ * @module ruvector/codemods/engine
+ */
+import ts from 'typescript';
+import { buildReassignmentResolver } from './scope-analysis.js';
+/** Intents this engine can apply deterministically with $0 cost. */
+export const DETERMINISTIC_CODEMOD_INTENTS = [
+    'var-to-const',
+    'remove-console',
+    'add-logging',
+];
+/** Intents recognised by the router but NOT safe as deterministic codemods. */
+export const MODEL_ROUTED_INTENTS = [
+    'add-types',
+    'add-error-handling',
+    'async-await',
+];
+export function isDeterministicCodemod(intent) {
+    return DETERMINISTIC_CODEMOD_INTENTS.includes(intent);
+}
+// ============================================================================
+// Parsing & edit application
+// ============================================================================
+function scriptKind(language) {
+    switch (language) {
+        case 'typescript':
+            return ts.ScriptKind.TS;
+        case 'tsx':
+            return ts.ScriptKind.TSX;
+        case 'jsx':
+            return ts.ScriptKind.JSX;
+        default:
+            return ts.ScriptKind.JS;
+    }
+}
+function parse(code, language) {
+    return ts.createSourceFile(`codemod-input.${language}`, code, ts.ScriptTarget.Latest, 
+    /* setParentNodes */ true, scriptKind(language));
+}
+function parseDiagnosticCount(sf) {
+    // parseDiagnostics is internal but stable; guard so a missing field never throws.
+    return sf.parseDiagnostics?.length ?? 0;
+}
+/** Apply edits to the original source, right-to-left so offsets stay valid. */
+function applyEdits(code, edits) {
+    const sorted = [...edits].sort((a, b) => b.start - a.start);
+    let out = code;
+    for (const e of sorted) {
+        out = out.slice(0, e.start) + e.replacement + out.slice(e.end);
+    }
+    return out;
+}
+function lineStartOffset(code, pos) {
+    let i = pos;
+    while (i > 0 && code[i - 1] !== '\n')
+        i--;
+    return i;
+}
+function leadingIndent(code, lineStart) {
+    let i = lineStart;
+    while (i < code.length && (code[i] === ' ' || code[i] === '\t'))
+        i++;
+    return code.slice(lineStart, i);
+}
+// ============================================================================
+// var-to-const  (scope-aware reassignment analysis — see scope-analysis.ts)
+// ============================================================================
+function isVarList(list) {
+    return !(list.flags & (ts.NodeFlags.Let | ts.NodeFlags.Const));
+}
+function collectBindingNames(name, out) {
+    if (ts.isIdentifier(name)) {
+        out.add(name.text);
+        return;
+    }
+    for (const el of name.elements) {
+        if (ts.isBindingElement(el))
+            collectBindingNames(el.name, out);
+    }
+}
+function varToConstEdits(code, sf) {
+    const resolver = buildReassignmentResolver(sf);
+    const edits = [];
+    const visit = (node) => {
+        if (ts.isVariableDeclarationList(node) && isVarList(node)) {
+            const names = new Set();
+            for (const decl of node.declarations)
+                collectBindingNames(decl.name, names);
+            // `const` only when no declared binding is reassigned *within its own scope*.
+            const anyReassigned = [...names].some((n) => resolver.isReassigned(n, node));
+            const keyword = anyReassigned ? 'let' : 'const';
+            // The `var` keyword is the first token of the declaration list.
+            const start = node.getStart(sf);
+            // Only rewrite when the literal text really is `var` (guards against odd trivia).
+            if (code.slice(start, start + 3) === 'var') {
+                edits.push({ start, end: start + 3, replacement: keyword });
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return edits;
+}
+// ============================================================================
+// remove-console
+// ============================================================================
+function rootIdentifier(expr) {
+    let cur = expr;
+    while (ts.isPropertyAccessExpression(cur) || ts.isElementAccessExpression(cur)) {
+        cur = cur.expression;
+    }
+    return ts.isIdentifier(cur) ? cur : undefined;
+}
+function isConsoleCallStatement(stmt) {
+    if (!ts.isExpressionStatement(stmt))
+        return false;
+    let expr = stmt.expression;
+    // unwrap `void console.log(x)` and awaited/comma forms defensively
+    if (ts.isCallExpression(expr)) {
+        const root = rootIdentifier(expr.expression);
+        return !!root && root.text === 'console';
+    }
+    return false;
+}
+function removeConsoleEdits(code, sf) {
+    const edits = [];
+    const visit = (node) => {
+        if (isConsoleCallStatement(node)) {
+            const stmt = node;
+            const start = stmt.getStart(sf);
+            const end = stmt.getEnd();
+            const ls = lineStartOffset(code, start);
+            const beforeIsBlank = code.slice(ls, start).trim() === '';
+            // Is the rest of the line after the statement only whitespace?
+            let lineEnd = end;
+            while (lineEnd < code.length && code[lineEnd] !== '\n')
+                lineEnd++;
+            const afterIsBlank = code.slice(end, lineEnd).trim() === '';
+            if (beforeIsBlank && afterIsBlank) {
+                // Statement owns its line(s): drop the whole line incl. trailing newline.
+                const dropEnd = lineEnd < code.length ? lineEnd + 1 : lineEnd;
+                edits.push({ start: ls, end: dropEnd, replacement: '' });
+            }
+            else {
+                // Inline with other code: remove just the statement, tidy one trailing space.
+                let e = end;
+                if (code[e] === ' ')
+                    e++;
+                edits.push({ start, end: e, replacement: '' });
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return edits;
+}
+function isFunctionLikeWithBlock(node) {
+    return ((ts.isFunctionDeclaration(node) ||
+        ts.isFunctionExpression(node) ||
+        ts.isArrowFunction(node) ||
+        ts.isMethodDeclaration(node) ||
+        ts.isConstructorDeclaration(node) ||
+        ts.isGetAccessor(node) ||
+        ts.isSetAccessor(node)) &&
+        !!node.body &&
+        ts.isBlock(node.body));
+}
+function functionName(node) {
+    if (ts.isConstructorDeclaration(node))
+        return 'constructor';
+    if ((ts.isFunctionDeclaration(node) ||
+        ts.isFunctionExpression(node) ||
+        ts.isMethodDeclaration(node) ||
+        ts.isGetAccessor(node) ||
+        ts.isSetAccessor(node)) &&
+        node.name &&
+        (ts.isIdentifier(node.name) || ts.isStringLiteral(node.name))) {
+        return node.name.text;
+    }
+    // function expression / arrow assigned to a variable or property
+    const parent = node.parent;
+    if (parent && ts.isVariableDeclaration(parent) && ts.isIdentifier(parent.name))
+        return parent.name.text;
+    if (parent && ts.isPropertyAssignment(parent) && ts.isIdentifier(parent.name))
+        return parent.name.text;
+    return 'anonymous';
+}
+function alreadyLogsEntry(body, name) {
+    const first = body.statements[0];
+    if (!first || !isConsoleCallStatement(first))
+        return false;
+    const text = first.getText();
+    return text.includes(`'${name} called'`) || text.includes(`"${name} called"`);
+}
+function addLoggingEdits(code, sf) {
+    const edits = [];
+    const visit = (node) => {
+        if (isFunctionLikeWithBlock(node)) {
+            const body = node.body;
+            const name = functionName(node);
+            if (!alreadyLogsEntry(body, name)) {
+                const braceOffset = body.getStart(sf); // position of '{'
+                const headerLineStart = lineStartOffset(code, node.getStart(sf));
+                const indent = leadingIndent(code, headerLineStart);
+                const bodyIndent = indent + '  ';
+                const insertion = `\n${bodyIndent}console.log(${JSON.stringify(`${name} called`)});`;
+                edits.push({ start: braceOffset + 1, end: braceOffset + 1, replacement: insertion });
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return edits;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+const TRANSFORMS = {
+    'var-to-const': varToConstEdits,
+    'remove-console': removeConsoleEdits,
+    'add-logging': addLoggingEdits,
+};
+/**
+ * Apply a deterministic codemod to a source string.
+ *
+ * Returns the transformed source plus metadata. Never throws on malformed input
+ * — it reports `success: false` with a reason instead. Guarantees the output
+ * does not introduce new parse errors (otherwise it returns the input unchanged).
+ */
+export function applyCodemod(intent, code, opts = {}) {
+    const language = opts.language ?? 'typescript';
+    if (!isDeterministicCodemod(intent)) {
+        return {
+            intent: intent,
+            success: false,
+            changed: false,
+            output: code,
+            edits: 0,
+            language,
+            reason: `"${intent}" is not a deterministic codemod — route it to a model (Tier 2/3).`,
+        };
+    }
+    let sf;
+    try {
+        sf = parse(code, language);
+    }
+    catch (err) {
+        return {
+            intent,
+            success: false,
+            changed: false,
+            output: code,
+            edits: 0,
+            language,
+            reason: `parse failed: ${err.message}`,
+        };
+    }
+    const beforeDiagnostics = parseDiagnosticCount(sf);
+    const edits = TRANSFORMS[intent](code, sf);
+    if (edits.length === 0) {
+        return { intent, success: true, changed: false, output: code, edits: 0, language };
+    }
+    const output = applyEdits(code, edits);
+    // Safety net: never hand back source that parses worse than the input.
+    const afterDiagnostics = parseDiagnosticCount(parse(output, language));
+    if (afterDiagnostics > beforeDiagnostics) {
+        return {
+            intent,
+            success: false,
+            changed: false,
+            output: code,
+            edits: 0,
+            language,
+            reason: 'transform would introduce parse errors — aborted (input returned unchanged).',
+        };
+    }
+    return { intent, success: true, changed: true, output, edits: edits.length, language };
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/ruvector/codemods/engine.js.map

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

package/dist/src/ruvector/codemods/scope-analysis.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Scope-aware reassignment analysis for the `var-to-const` codemod (ADR-143).
+ *
+ * The naive version marks a `var` as reassigned if its name is assigned to
+ * *anywhere* in the file. That is correct but over-conservative: a `var x` in
+ * one function is forced to `let` just because an unrelated function also has
+ * an `x = …`. This module resolves each assignment to the binding it actually
+ * mutates (function-scope hoisting semantics), so a `var` becomes `const`
+ * unless *its own* binding is reassigned.
+ *
+ * Soundness: resolution only ever attributes a reassignment to a scope that
+ * actually hoists the name (i.e. genuinely declares that binding). It therefore
+ * never marks a truly-reassigned binding as un-reassigned — so a `var` is only
+ * promoted to `const` when it is provably never reassigned. Block-scoped
+ * shadowing (let/const) is ignored for resolution, which can only make us *more*
+ * conservative (fall back to `let`), never wrong.
+ *
+ * @module ruvector/codemods/scope-analysis
+ */
+import ts from 'typescript';
+export interface ReassignmentResolver {
+    /** True if the `var` binding declared by `declarationList` (for `name`) is reassigned within its scope. */
+    isReassigned(name: string, declarationList: ts.VariableDeclarationList): boolean;
+}
+/**
+ * Build a scope-aware resolver: which `var` bindings are actually reassigned.
+ */
+export declare function buildReassignmentResolver(sf: ts.SourceFile): ReassignmentResolver;
+//# sourceMappingURL=scope-analysis.d.ts.map

package/dist/src/ruvector/codemods/scope-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-analysis.d.ts","sourceRoot":"","sources":["../../../../src/ruvector/codemods/scope-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAuD5B,MAAM,WAAW,oBAAoB;IACnC,2GAA2G;IAC3G,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,uBAAuB,GAAG,OAAO,CAAC;CAClF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,GAAG,oBAAoB,CAoFjF"}

package/dist/src/ruvector/codemods/scope-analysis.js

@@ -0,0 +1,162 @@
+/**
+ * Scope-aware reassignment analysis for the `var-to-const` codemod (ADR-143).
+ *
+ * The naive version marks a `var` as reassigned if its name is assigned to
+ * *anywhere* in the file. That is correct but over-conservative: a `var x` in
+ * one function is forced to `let` just because an unrelated function also has
+ * an `x = …`. This module resolves each assignment to the binding it actually
+ * mutates (function-scope hoisting semantics), so a `var` becomes `const`
+ * unless *its own* binding is reassigned.
+ *
+ * Soundness: resolution only ever attributes a reassignment to a scope that
+ * actually hoists the name (i.e. genuinely declares that binding). It therefore
+ * never marks a truly-reassigned binding as un-reassigned — so a `var` is only
+ * promoted to `const` when it is provably never reassigned. Block-scoped
+ * shadowing (let/const) is ignored for resolution, which can only make us *more*
+ * conservative (fall back to `let`), never wrong.
+ *
+ * @module ruvector/codemods/scope-analysis
+ */
+import ts from 'typescript';
+/** A scope is a function-like node or the SourceFile (the var-hoist boundaries). */
+function isScopeNode(node) {
+    return (ts.isSourceFile(node) ||
+        ts.isFunctionDeclaration(node) ||
+        ts.isFunctionExpression(node) ||
+        ts.isArrowFunction(node) ||
+        ts.isMethodDeclaration(node) ||
+        ts.isConstructorDeclaration(node) ||
+        ts.isGetAccessorDeclaration(node) ||
+        ts.isSetAccessorDeclaration(node));
+}
+function enclosingScope(node) {
+    let cur = node.parent;
+    while (cur && !isScopeNode(cur))
+        cur = cur.parent;
+    return cur ?? node.getSourceFile();
+}
+function parentScope(scope) {
+    if (ts.isSourceFile(scope))
+        return undefined;
+    return enclosingScope(scope);
+}
+function collectIdentifierNames(target, out) {
+    if (ts.isIdentifier(target)) {
+        out(target.text);
+        return;
+    }
+    // Destructuring assignment target (object/array literal on the LHS of `=`).
+    ts.forEachChild(target, (child) => collectIdentifierNames(child, out));
+}
+const ASSIGNMENT_OPERATORS = new Set([
+    ts.SyntaxKind.EqualsToken,
+    ts.SyntaxKind.PlusEqualsToken,
+    ts.SyntaxKind.MinusEqualsToken,
+    ts.SyntaxKind.AsteriskEqualsToken,
+    ts.SyntaxKind.AsteriskAsteriskEqualsToken,
+    ts.SyntaxKind.SlashEqualsToken,
+    ts.SyntaxKind.PercentEqualsToken,
+    ts.SyntaxKind.LessThanLessThanEqualsToken,
+    ts.SyntaxKind.GreaterThanGreaterThanEqualsToken,
+    ts.SyntaxKind.GreaterThanGreaterThanGreaterThanEqualsToken,
+    ts.SyntaxKind.AmpersandEqualsToken,
+    ts.SyntaxKind.BarEqualsToken,
+    ts.SyntaxKind.CaretEqualsToken,
+    ts.SyntaxKind.BarBarEqualsToken,
+    ts.SyntaxKind.AmpersandAmpersandEqualsToken,
+    ts.SyntaxKind.QuestionQuestionEqualsToken,
+]);
+/**
+ * Build a scope-aware resolver: which `var` bindings are actually reassigned.
+ */
+export function buildReassignmentResolver(sf) {
+    // Names hoisted into each scope: var-declared names, function declarations,
+    // and parameters. (Collected per scope, not crossing nested function scopes.)
+    const hoisted = new Map();
+    const ensure = (scope) => {
+        let s = hoisted.get(scope);
+        if (!s) {
+            s = new Set();
+            hoisted.set(scope, s);
+        }
+        return s;
+    };
+    ensure(sf);
+    const addBinding = (name, scope) => {
+        if (ts.isIdentifier(name)) {
+            ensure(scope).add(name.text);
+        }
+        else {
+            for (const el of name.elements) {
+                if (ts.isBindingElement(el))
+                    addBinding(el.name, scope);
+            }
+        }
+    };
+    // Pass 1 — record hoisted names per scope.
+    const collectHoisted = (node) => {
+        if (isScopeNode(node) && !ts.isSourceFile(node)) {
+            ensure(node);
+            // Parameters belong to the function's own scope.
+            const params = node.parameters;
+            if (params)
+                for (const p of params)
+                    addBinding(p.name, node);
+        }
+        if (ts.isVariableDeclarationList(node) && !(node.flags & (ts.NodeFlags.Let | ts.NodeFlags.Const))) {
+            const scope = enclosingScope(node); // var hoists to the nearest function/source scope
+            for (const decl of node.declarations)
+                addBinding(decl.name, scope);
+        }
+        if (ts.isFunctionDeclaration(node) && node.name) {
+            ensure(enclosingScope(node)).add(node.name.text);
+        }
+        ts.forEachChild(node, collectHoisted);
+    };
+    collectHoisted(sf);
+    const resolveScope = (name, from) => {
+        let scope = from;
+        while (scope) {
+            if (hoisted.get(scope)?.has(name))
+                return scope;
+            scope = parentScope(scope);
+        }
+        return undefined;
+    };
+    // Pass 2 — attribute each reassignment to the binding (scope) it mutates.
+    const reassigned = new Set(); // key: `${scopeId}::${name}`
+    const scopeIds = new Map();
+    let nextId = 0;
+    const scopeId = (scope) => {
+        let id = scopeIds.get(scope);
+        if (id === undefined) {
+            id = nextId++;
+            scopeIds.set(scope, id);
+        }
+        return id;
+    };
+    const markReassigned = (name, at) => {
+        const declScope = resolveScope(name, enclosingScope(at));
+        if (declScope)
+            reassigned.add(`${scopeId(declScope)}::${name}`);
+    };
+    const collectReassignments = (node) => {
+        if (ts.isBinaryExpression(node) && ASSIGNMENT_OPERATORS.has(node.operatorToken.kind)) {
+            collectIdentifierNames(node.left, (n) => markReassigned(n, node));
+        }
+        else if ((ts.isPostfixUnaryExpression(node) || ts.isPrefixUnaryExpression(node)) &&
+            (node.operator === ts.SyntaxKind.PlusPlusToken || node.operator === ts.SyntaxKind.MinusMinusToken) &&
+            ts.isIdentifier(node.operand)) {
+            markReassigned(node.operand.text, node);
+        }
+        ts.forEachChild(node, collectReassignments);
+    };
+    collectReassignments(sf);
+    return {
+        isReassigned(name, declarationList) {
+            const declScope = enclosingScope(declarationList);
+            return reassigned.has(`${scopeId(declScope)}::${name}`);
+        },
+    };
+}
+//# sourceMappingURL=scope-analysis.js.map

package/dist/src/ruvector/codemods/scope-analysis.js.map

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

package/dist/src/ruvector/enhanced-model-router.d.ts

@@ -28,12 +28,20 @@ export interface EditIntent {
  */
 export interface EnhancedRouteResult {
     tier: 1 | 2 | 3;
-    handler: 'agent-booster' | 'haiku' | 'sonnet' | 'opus';
+    handler: 'codemod' | 'agent-booster' | 'haiku' | 'sonnet' | 'opus';
     model?: ClaudeModel;
     confidence: number;
     complexity?: number;
     reasoning: string;
+    /** The detected edit intent (Tier 1 only). */
+    codemodIntent?: EditIntent;
+    /**
+     * Back-compat alias for {@link codemodIntent}. Older callers read this field.
+     * @deprecated use {@link codemodIntent}
+     */
     agentBoosterIntent?: EditIntent;
+    /** true when a deterministic, $0 codemod can fully apply this edit (no LLM). */
+    deterministic?: boolean;
     canSkipLLM?: boolean;
     estimatedLatencyMs: number;
     estimatedCost: number;
@@ -93,8 +101,11 @@ export declare class EnhancedModelRouter {
      */
     private analyzeASTComplexity;
     /**
-     * Execute task using the appropriate tier
-     * Returns the result and routing information
+     * Execute task using the appropriate tier.
+     *
+     * For Tier-1 deterministic intents this applies the codemod directly (writing
+     * the file back when a path is given) — $0, no LLM. Otherwise it returns the
+     * routing result and the caller invokes the recommended model.
      */
     execute(task: string, context?: {
         filePath?: string;
@@ -102,14 +113,19 @@ export declare class EnhancedModelRouter {
     }): Promise<{
         result: string | {
             applied: boolean;
-            confidence: number;
+            changed: boolean;
+            edits: number;
         };
         routeResult: EnhancedRouteResult;
     }>;
     /**
-     * Try to apply edit using Agent Booster
+     * Apply a deterministic codemod to the intent's target file.
+     *
+     * This is the real Tier-1 execution path (ADR-143). It uses the in-process
+     * TypeScript-compiler codemod engine — no `agent-booster` import, no subprocess,
+     * no LLM. Writes the transformed source back to disk when it changes.
      */
-    private tryAgentBooster;
+    private tryCodemod;
     /**
      * Get router statistics
      */
@@ -137,10 +153,15 @@ export declare function enhancedRouteToModel(task: string, context?: {
     filePath?: string;
 }): Promise<EnhancedRouteResult>;
 /**
- * Detect if a task can be handled by Agent Booster
+ * Detect if a task can be applied by a deterministic, $0 codemod (ADR-143).
+ * Only the deterministic intents qualify — others need a model.
  */
-export declare function canUseAgentBooster(task: string): {
+export declare function canUseCodemod(task: string): {
     canUse: boolean;
     intent?: EditIntent;
 };
+/**
+ * @deprecated Agent Booster never performed these transforms. Use {@link canUseCodemod}.
+ */
+export declare const canUseAgentBooster: typeof canUseCodemod;
 //# sourceMappingURL=enhanced-model-router.d.ts.map

package/dist/src/ruvector/enhanced-model-router.d.ts.map

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