ucn 3.8.12 → 3.8.14

package/core/output.js

@@ -1,3300 +1,22 @@
 /**
- * core/output.js - Output formatting utilities
+ * core/output.js - Re-export facade
  *
- * KEY PRINCIPLE: Never truncate critical information.
- * Full expressions, full signatures, full context.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Format dynamic imports note with language-appropriate terminology.
- * Go doesn't have "dynamic imports" — uses "blank/dot imports" instead.
- */
-function dynamicImportsNote(count, meta) {
-    if (!count) return null;
-    if (meta?.projectLanguage === 'go') {
-        return `${count} blank/dot import(s)`;
-    }
-    return `${count} dynamic import(s)`;
-}
-
-const FILE_ERROR_MESSAGES = {
-    'file-not-found': 'File not found in project',
-    'file-ambiguous': 'Ambiguous file match'
-};
-
-function formatFileError(errorObj, fallbackPath) {
-    const msg = FILE_ERROR_MESSAGES[errorObj.error] || errorObj.error;
-    const file = errorObj.filePath || fallbackPath || '';
-    return `Error: ${msg}: ${file}`;
-}
-
-/**
- * Normalize parameters for display
- * Collapses multiline params to single line
- * @param {string} params - Raw params string
- * @returns {string} - Normalized params (NO truncation)
- */
-function normalizeParams(params) {
-    if (!params || params === '...') return params || '...';
-    // Collapse whitespace (newlines, tabs, multiple spaces) to single space
-    return params.replace(/\s+/g, ' ').trim();
-}
-
-/**
- * Format a line number for display
- * @param {number} line - 1-indexed line number
- * @param {number} width - Padding width
- * @returns {string}
- */
-function lineNum(line, width = 4) {
-    return String(line).padStart(width);
-}
-
-/**
- * Format a line range
- * @param {number} start - 1-indexed start line
- * @param {number} end - 1-indexed end line
- * @returns {string}
- */
-function lineRange(start, end) {
-    return `[${lineNum(start)}-${lineNum(end)}]`;
-}
-
-/**
- * Format a single line location
- * @param {number} line - 1-indexed line number
- * @returns {string}
- */
-function lineLoc(line) {
-    return `[${lineNum(line)}]`;
-}
-
-// ============================================================================
-// TEXT FORMATTERS
-// ============================================================================
-
-/**
- * Format function signature for TOC display
- * @param {object} fn - Function definition
- * @returns {string}
- */
-function formatFunctionSignature(fn) {
-    const prefix = [];
-
-    // Modifiers
-    if (fn.modifiers && fn.modifiers.length > 0) {
-        prefix.push(fn.modifiers.join(' '));
-    }
-
-    // Generator marker
-    if (fn.isGenerator) prefix.push('*');
-
-    // Name + generics + params (concatenated without spaces)
-    let sig = fn.name;
-    if (fn.generics) sig += fn.generics;
-    const params = normalizeParams(fn.params);
-    sig += `(${params})`;
-
-    // Return type
-    if (fn.returnType) sig += `: ${fn.returnType}`;
-
-    // Arrow indicator
-    if (fn.isArrow) sig += ' =>';
-
-    if (prefix.length > 0) {
-        return prefix.join(' ') + ' ' + sig;
-    }
-    return sig;
-}
-
-/**
- * Format class/type signature for TOC display
- */
-function formatClassSignature(cls) {
-    const parts = [cls.type, cls.name];
-
-    if (cls.generics) parts.push(cls.generics);
-    if (cls.extends) parts.push(`extends ${cls.extends}`);
-    if (cls.implements && cls.implements.length > 0) {
-        parts.push(`implements ${cls.implements.join(', ')}`);
-    }
-
-    return parts.join(' ');
-}
-
-/**
- * Format class member for TOC display
- */
-function formatMemberSignature(member) {
-    const parts = [];
-
-    // Member type (static, get, set, private, etc.)
-    if (member.memberType && member.memberType !== 'method') {
-        parts.push(member.memberType);
-    }
-
-    // Async
-    if (member.isAsync) parts.push('async');
-
-    // Generator
-    if (member.isGenerator) parts.push('*');
-
-    // Name + Parameters (no space between name and parens)
-    if (member.params !== undefined) {
-        const params = normalizeParams(member.params);
-        parts.push(`${member.name}(${params})`);
-    } else {
-        parts.push(member.name);
-    }
-
-    // Return type
-    if (member.returnType) parts.push(`: ${member.returnType}`);
-
-    return parts.join(' ').replace(/\s+/g, ' ').trim();
-}
-
-/**
- * Print section header
- */
-function header(title, char = '═') {
-    console.log(title);
-    console.log(char.repeat(60));
-}
-
-/**
- * Print subheader
- */
-function subheader(title) {
-    console.log(title);
-    console.log('─'.repeat(40));
-}
-
-/**
- * Print a usage/call site - FULL expression, never truncated
- * @param {object} usage - Usage object
- * @param {string} [relativePath] - Relative file path
- */
-function printUsage(usage, relativePath) {
-    const file = relativePath || usage.file;
-    // Context before the match
-    if (usage.before && usage.before.length > 0) {
-        for (const line of usage.before) {
-            console.log(`    ... ${line.trim()}`);
-        }
-    }
-    // FULL content - this is the key improvement
-    console.log(`  ${file}:${usage.line}`);
-    console.log(`    ${usage.content.trim()}`);
-    // Context after the match
-    if (usage.after && usage.after.length > 0) {
-        for (const line of usage.after) {
-            console.log(`    ... ${line.trim()}`);
-        }
-    }
-}
-
-/**
- * Print definition with full signature
- */
-function printDefinition(def, relativePath) {
-    const file = relativePath || def.file;
-    console.log(`  ${file}:${def.line}`);
-    if (def.signature) {
-        console.log(`    ${def.signature}`);
-    }
-}
-
-// ============================================================================
-// JSON FORMATTERS
-// ============================================================================
-
-/**
- * Format TOC data as JSON
- */
-function formatTocJson(data) {
-    const obj = {
-        meta: data.meta || { complete: true, skipped: 0, dynamicImports: 0, uncertain: 0 },
-        totals: data.totals,
-        summary: data.summary,
-        files: data.files
-    };
-    if (data.hiddenFiles > 0) obj.hiddenFiles = data.hiddenFiles;
-    return JSON.stringify(obj);
-}
-
-/**
- * Format symbol search results as JSON
- */
-function formatSymbolJson(symbols, query) {
-    return JSON.stringify({
-        meta: { complete: true, skipped: 0, dynamicImports: 0, uncertain: 0 },
-        data: {
-            query,
-            count: symbols.length,
-            results: symbols.map(s => ({
-                name: s.name,
-                type: s.type,
-                file: s.relativePath || s.file,
-                startLine: s.startLine,
-                endLine: s.endLine,
-                ...(s.params && { params: s.params }),  // FULL params
-                ...(s.paramsStructured && { paramsStructured: s.paramsStructured }),
-                ...(s.returnType && { returnType: s.returnType }),
-                ...(s.modifiers && { modifiers: s.modifiers }),
-                ...(s.usageCount !== undefined && { usageCount: s.usageCount }),
-                ...(s.usageCounts !== undefined && { usageCounts: s.usageCounts })
-            }))
-        }
-    });
-}
-
-/**
- * Format usages as JSON - FULL expressions, never truncated
- */
-function formatUsagesJson(usages, name) {
-    const definitions = usages.filter(u => u.isDefinition);
-    const refs = usages.filter(u => !u.isDefinition);
-
-    const calls = refs.filter(u => u.usageType === 'call');
-    const imports = refs.filter(u => u.usageType === 'import');
-    const references = refs.filter(u => u.usageType === 'reference');
-
-    const formatUsage = (u) => ({
-        file: u.relativePath || u.file,
-        line: u.line,
-        expression: u.content,  // FULL expression - key improvement
-        ...(u.args && { args: u.args }),  // Parsed arguments
-        ...(u.before && u.before.length > 0 && { before: u.before }),
-        ...(u.after && u.after.length > 0 && { after: u.after })
-    });
-
-    return JSON.stringify({
-        meta: { complete: true, skipped: 0, dynamicImports: 0, uncertain: 0 },
-        data: {
-            symbol: name,
-            definitionCount: definitions.length,
-            callCount: calls.length,
-            importCount: imports.length,
-            referenceCount: references.length,
-            totalUsages: refs.length,
-            definitions: definitions.map(d => ({
-                file: d.relativePath || d.file,
-                line: d.line,
-                signature: d.signature || null,  // FULL signature
-                type: d.type || null,
-                ...(d.returnType && { returnType: d.returnType }),
-                ...(d.before && d.before.length > 0 && { before: d.before }),
-                ...(d.after && d.after.length > 0 && { after: d.after })
-            })),
-            calls: calls.map(formatUsage),
-            imports: imports.map(formatUsage),
-            references: references.map(formatUsage)
-        }
-    });
-}
-
-/**
- * Format context (callers + callees) as JSON
- */
-function formatContextJson(context) {
-    const meta = context.meta || { complete: true, skipped: 0, dynamicImports: 0, uncertain: 0 };
-    // Handle struct/interface types differently
-    if (context.type && ['class', 'struct', 'interface', 'type'].includes(context.type)) {
-        const callers = context.callers || [];
-        const methods = context.methods || [];
-        return JSON.stringify({
-            meta,
-            data: {
-                type: context.type,
-                name: context.name,
-                file: context.file,
-                startLine: context.startLine,
-                endLine: context.endLine,
-                methodCount: methods.length,
-                usageCount: callers.length,
-                methods: methods.map(m => ({
-                    name: m.name,
-                    file: m.file,
-                    line: m.line,
-                    params: m.params,
-                    returnType: m.returnType,
-                    receiver: m.receiver
-                })),
-                usages: callers.map(c => ({
-                    file: c.relativePath || c.file,
-                    line: c.line,
-                    expression: c.content,
-                    callerName: c.callerName
-                })),
-                ...(context.warnings && { warnings: context.warnings })
-            }
-        });
-    }
-
-    // Standard function/method context
-    const callers = context.callers || [];
-    const callees = context.callees || [];
-    return JSON.stringify({
-        meta,
-        data: {
-            function: context.function,
-            file: context.file,
-            callerCount: callers.length,
-            calleeCount: callees.length,
-            callers: callers.map(c => ({
-                file: c.relativePath || c.file,
-                line: c.line,
-                expression: c.content,  // FULL expression
-                callerName: c.callerName,
-                ...(c.confidence != null && { confidence: c.confidence, resolution: c.resolution }),
-            })),
-            callees: callees.map(c => ({
-                name: c.name,
-                type: c.type,
-                file: c.relativePath || c.file,
-                line: c.startLine,
-                params: c.params,  // FULL params
-                weight: c.weight || 'normal',  // Dependency weight: core, setup, utility
-                ...(c.confidence != null && { confidence: c.confidence, resolution: c.resolution }),
-            })),
-            ...(context.warnings && { warnings: context.warnings })
-        }
-    });
-}
-
-/**
- * Format extracted function as JSON
- */
-function formatFunctionJson(fn, code) {
-    return JSON.stringify({
-        name: fn.name,
-        params: fn.params,  // FULL params
-        paramsStructured: fn.paramsStructured || [],
-        startLine: fn.startLine,
-        endLine: fn.endLine,
-        modifiers: fn.modifiers || [],
-        ...(fn.returnType && { returnType: fn.returnType }),
-        ...(fn.generics && { generics: fn.generics }),
-        ...(fn.docstring && { docstring: fn.docstring }),
-        ...(fn.isArrow && { isArrow: true }),
-        ...(fn.isGenerator && { isGenerator: true }),
-        code  // FULL code
-    }, null, 2);
-}
-
-/**
- * Format search results as JSON
- */
-function formatSearchJson(results, term) {
-    const meta = results.meta;
-    const obj = {
-        term,
-        totalMatches: (meta && meta.totalMatches != null) ? meta.totalMatches : results.reduce((sum, r) => sum + r.matches.length, 0),
-        files: results.map(r => ({
-            file: r.file,
-            matchCount: r.matches.length,
-            matches: r.matches.map(m => ({
-                line: m.line,
-                content: m.content  // FULL content
-            }))
-        }))
-    };
-    if (meta) {
-        obj.filesScanned = meta.filesScanned;
-        obj.filesSkipped = meta.filesSkipped;
-        obj.totalFiles = meta.totalFiles;
-        if (meta.regexFallback) obj.regexFallback = meta.regexFallback;
-        if (meta.truncatedMatches > 0) obj.truncatedMatches = meta.truncatedMatches;
-    }
-    return JSON.stringify(obj, null, 2);
-}
-
-/**
- * Format imports as JSON
- */
-function formatImportsJson(imports, filePath) {
-    if (imports?.error) return JSON.stringify({ found: false, error: imports.error, file: imports.filePath || filePath }, null, 2);
-    return JSON.stringify({
-        file: filePath,
-        importCount: imports.length,
-        imports: imports.map(i => ({
-            module: i.module,
-            names: i.names,
-            type: i.type,
-            resolved: i.resolved || null,
-            isDynamic: !!i.isDynamic
-        }))
-    }, null, 2);
-}
-
-/**
- * Format project stats as JSON
- */
-function formatStatsJson(stats) {
-    return JSON.stringify(stats, null, 2);
-}
-
-/**
- * Format dependency graph as JSON
- */
-function formatGraphJson(graph) {
-    if (graph?.error) return JSON.stringify({ found: false, error: graph.error, file: graph.filePath }, null, 2);
-    const result = {
-        root: graph.root,
-        direction: graph.direction,
-        nodes: graph.nodes,
-        edges: graph.edges
-    };
-    if (graph.imports) result.imports = graph.imports;
-    if (graph.importers) result.importers = graph.importers;
-    return JSON.stringify(result, null, 2);
-}
-
-/**
- * Format smart extraction result as JSON
- * Includes function + all dependencies
- */
-function formatSmartJson(result) {
-    if (!result) return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    const meta = result.meta || { complete: true, skipped: 0, dynamicImports: 0, uncertain: 0 };
-    return JSON.stringify({
-        meta,
-        data: {
-            target: {
-                name: result.target.name,
-                file: result.target.file,
-                startLine: result.target.startLine,
-                endLine: result.target.endLine,
-                params: result.target.params,
-                returnType: result.target.returnType,
-                code: result.target.code
-            },
-            dependencies: result.dependencies.map(d => ({
-                name: d.name,
-                type: d.type,
-                file: d.file,
-                startLine: d.startLine,
-                endLine: d.endLine,
-                params: d.params,
-                weight: d.weight,  // core, setup, utility
-                callCount: d.callCount,
-                code: d.code
-            })),
-            types: result.types || []
-        }
-    });
-}
-
-// ============================================================================
-// NEW FORMATTERS (v2 Migration)
-// ============================================================================
-
-/**
- * Format imports command output - text
- */
-function formatImports(imports, filePath) {
-    if (imports?.error) return formatFileError(imports, filePath);
-    const lines = [`Imports in ${filePath}:\n`];
-
-    const internal = imports.filter(i => !i.isExternal && !i.isDynamic);
-    const external = imports.filter(i => i.isExternal && !i.isDynamic);
-    const dynamic = imports.filter(i => i.isDynamic);
-
-    if (internal.length > 0) {
-        lines.push('INTERNAL:');
-        for (const imp of internal) {
-            lines.push(`  ${imp.module}`);
-            if (imp.resolved) {
-                lines.push(`    -> ${imp.resolved}`);
-            }
-            if (imp.names && imp.names.length > 0 && imp.names[0] !== '*') {
-                lines.push(`    ${imp.names.join(', ')}`);
-            }
-        }
-    }
-
-    if (external.length > 0) {
-        if (internal.length > 0) lines.push('');
-        lines.push('EXTERNAL:');
-        for (const imp of external) {
-            lines.push(`  ${imp.module}`);
-            if (imp.names && imp.names.length > 0) {
-                lines.push(`    ${imp.names.join(', ')}`);
-            }
-        }
-    }
-
-    if (dynamic.length > 0) {
-        if (internal.length > 0 || external.length > 0) lines.push('');
-        lines.push('DYNAMIC (unresolved):');
-        for (const imp of dynamic) {
-            lines.push(`  ${imp.module || '(variable)'}`);
-            if (imp.names && imp.names.length > 0) {
-                lines.push(`    ${imp.names.join(', ')}`);
-            }
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format exporters command output - text
- */
-function formatExporters(exporters, filePath) {
-    if (exporters?.error) return formatFileError(exporters, filePath);
-    const lines = [`Files that import ${filePath}:\n`];
-
-    if (exporters.length === 0) {
-        lines.push('  (none found)');
-    } else {
-        for (const exp of exporters) {
-            if (exp.importLine) {
-                lines.push(`  ${exp.file}:${exp.importLine}`);
-            } else {
-                lines.push(`  ${exp.file}`);
-            }
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format typedef command output - text
- */
-function formatTypedef(types, name) {
-    const lines = [`Type definitions for "${name}":\n`];
-
-    if (types.length === 0) {
-        lines.push('  (none found)');
-    } else {
-        for (const t of types) {
-            lines.push(`${t.relativePath}:${t.startLine}  ${t.type} ${t.name}`);
-            if (t.usageCount !== undefined) {
-                lines.push(`  (${t.usageCount} usages)`);
-            }
-            if (t.code) {
-                lines.push('');
-                lines.push('─── CODE ───');
-                lines.push(t.code);
-                lines.push('');
-            }
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format tests command output - text
- */
-function formatTests(tests, name) {
-    const lines = [`Tests for "${name}":\n`];
-
-    if (tests.length === 0) {
-        lines.push('  (no tests found)');
-    } else {
-        const totalMatches = tests.reduce((sum, t) => sum + t.matches.length, 0);
-        lines.push(`Found ${totalMatches} matches in ${tests.length} test file(s):\n`);
-
-        for (const testFile of tests) {
-            lines.push(testFile.file);
-            for (const match of testFile.matches) {
-                const typeLabel = match.matchType === 'test-case' ? '[test]' :
-                    match.matchType === 'import' ? '[import]' :
-                    match.matchType === 'call' ? '[call]' :
-                    match.matchType === 'string-ref' ? '[string]' : '[ref]';
-                lines.push(`  ${match.line}: ${typeLabel} ${match.content}`);
-            }
-            lines.push('');
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format api command output - text
- */
-function formatApi(symbols, filePath) {
-    const title = filePath
-        ? `Exports from ${filePath}:`
-        : 'Project API (exported symbols):';
-    const lines = [title + '\n'];
-
-    if (symbols.length === 0) {
-        lines.push('  (none found)');
-        if (filePath && filePath.endsWith('.py')) {
-            lines.push('');
-            lines.push('Note: Python requires __all__ for export detection. Use \'toc\' command to see all functions/classes.');
-        }
-    } else {
-        // Group by file
-        const byFile = new Map();
-        for (const sym of symbols) {
-            if (!byFile.has(sym.file)) {
-                byFile.set(sym.file, []);
-            }
-            byFile.get(sym.file).push(sym);
-        }
-
-        for (const [file, syms] of byFile) {
-            lines.push(file);
-            for (const s of syms) {
-                const sig = s.signature || `${s.type} ${s.name}`;
-                lines.push(`  ${lineRange(s.startLine, s.endLine)} ${sig}`);
-            }
-            lines.push('');
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format disambiguation prompt - text
- */
-function formatDisambiguation(matches, name, command) {
-    const lines = [`Multiple matches for "${name}":\n`];
-
-    for (const m of matches) {
-        const sig = m.params !== undefined
-            ? formatFunctionSignature(m)
-            : formatClassSignature(m);
-        lines.push(`  ${m.relativePath}:${m.startLine}  ${sig}`);
-        if (m.usageCount !== undefined) {
-            lines.push(`    (${m.usageCount} usages)`);
-        }
-    }
-
-    lines.push('');
-    lines.push(`Use: ucn . ${command} ${name} --file <pattern>`);
-
-    return lines.join('\n');
-}
-
-// ============================================================================
-// NEW JSON FORMATTERS
-// ============================================================================
-
-/**
- * Format exporters as JSON
- */
-function formatExportersJson(exporters, filePath) {
-    if (exporters?.error) return JSON.stringify({ found: false, error: exporters.error, file: exporters.filePath || filePath }, null, 2);
-    return JSON.stringify({
-        file: filePath,
-        importerCount: exporters.length,
-        importers: exporters
-    }, null, 2);
-}
-
-/**
- * Format typedef as JSON
- */
-function formatTypedefJson(types, name) {
-    return JSON.stringify({
-        query: name,
-        count: types.length,
-        types: types.map(t => ({
-            name: t.name,
-            type: t.type,
-            file: t.relativePath || t.file,
-            startLine: t.startLine,
-            endLine: t.endLine,
-            ...(t.usageCount !== undefined && { usageCount: t.usageCount }),
-            ...(t.code && { code: t.code })
-        }))
-    }, null, 2);
-}
-
-/**
- * Format tests as JSON
- */
-function formatTestsJson(tests, name) {
-    return JSON.stringify({
-        query: name,
-        testFileCount: tests.length,
-        totalMatches: tests.reduce((sum, t) => sum + t.matches.length, 0),
-        testFiles: tests
-    }, null, 2);
-}
-
-/**
- * Format api as JSON
- */
-function formatApiJson(symbols, filePath) {
-    return JSON.stringify({
-        ...(filePath && { file: filePath }),
-        exportCount: symbols.length,
-        exports: symbols.map(s => ({
-            name: s.name,
-            type: s.type,
-            file: s.file,
-            startLine: s.startLine,
-            endLine: s.endLine,
-            ...(s.params && { params: s.params }),
-            ...(s.returnType && { returnType: s.returnType }),
-            ...(s.signature && { signature: s.signature })
-        }))
-    }, null, 2);
-}
-
-/**
- * Format trace command output - text
- * Shows call tree visualization
- */
-function formatTrace(trace, options = {}) {
-    if (!trace) {
-        return 'Function not found.';
-    }
-
-    const lines = [];
-
-    // Header
-    lines.push(`Call tree for ${trace.root}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${trace.file}:${trace.line}`);
-    lines.push(`Direction: ${trace.direction}, Max depth: ${trace.maxDepth}`);
-
-    if (trace.warnings && trace.warnings.length > 0) {
-        for (const w of trace.warnings) {
-            lines.push(`Note: ${w.message}`);
-        }
-    }
-
-    lines.push('');
-
-    // Render tree
-    let hasTruncation = false;
-    const renderNode = (node, prefix = '', isLast = true) => {
-        const connector = isLast ? '└── ' : '├── ';
-        const extension = isLast ? '    ' : '│   ';
-
-        let label = node.name;
-        if (node.external) {
-            label += ' [external]';
-        } else if (node.file) {
-            label += ` (${node.file}:${node.line})`;
-        }
-        if (node.weight && node.weight !== 'normal') {
-            label += ` [${node.weight}]`;
-        }
-        if (node.callCount) {
-            label += ` ${node.callCount}x`;
-        }
-        if (node.alreadyShown) {
-            label += ' (see above)';
-        }
-
-        lines.push(prefix + connector + label);
-
-        if (node.children && !node.alreadyShown) {
-            const hasMore = node.truncatedChildren > 0;
-            for (let i = 0; i < node.children.length; i++) {
-                const isChildLast = !hasMore && i === node.children.length - 1;
-                renderNode(node.children[i], prefix + extension, isChildLast);
-            }
-            if (hasMore) {
-                hasTruncation = true;
-                lines.push(prefix + extension + `└── ... and ${node.truncatedChildren} more callees`);
-            }
-        }
-    };
-
-    // Root node
-    lines.push(trace.root);
-    if (trace.tree && trace.tree.children) {
-        const rootHasMore = trace.tree.truncatedChildren > 0;
-        for (let i = 0; i < trace.tree.children.length; i++) {
-            const isLast = !rootHasMore && i === trace.tree.children.length - 1;
-            renderNode(trace.tree.children[i], '', isLast);
-        }
-        if (rootHasMore) {
-            hasTruncation = true;
-            lines.push(`└── ... and ${trace.tree.truncatedChildren} more callees`);
-        }
-    }
-
-    // Callers section
-    if (trace.callers && trace.callers.length > 0) {
-        lines.push('');
-        lines.push('CALLED BY:');
-        for (const c of trace.callers) {
-            lines.push(`  ${c.name} - ${c.file}:${c.line}`);
-            lines.push(`    ${c.expression}`);
-        }
-        if (trace.truncatedCallers) {
-            hasTruncation = true;
-            lines.push(`  ... and ${trace.truncatedCallers} more callers`);
-        }
-    }
-
-    if (hasTruncation) {
-        const allHint = options.allHint || 'Use --all to show all.';
-        lines.push(`\nSome results truncated. ${allHint}`);
-    }
-
-    if (trace.includeMethods === false) {
-        const methodsHint = options.methodsHint || 'Note: obj.method() calls excluded — use --include-methods to include them';
-        lines.push(`\n${methodsHint}`);
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format trace command output - JSON
- */
-function formatTraceJson(trace) {
-    if (!trace) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    return JSON.stringify(trace, null, 2);
-}
-
-/**
- * Format blast command output - text
- * Shows transitive blast radius (callers of callers)
- */
-function formatBlast(blast, options = {}) {
-    if (!blast) {
-        return 'Function not found.';
-    }
-
-    const lines = [];
-
-    // Header
-    lines.push(`Blast radius for ${blast.root}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${blast.file}:${blast.line}`);
-    lines.push(`Depth: ${blast.maxDepth}`);
-
-    if (blast.warnings && blast.warnings.length > 0) {
-        for (const w of blast.warnings) {
-            lines.push(`Note: ${w.message}`);
-        }
-    }
-
-    lines.push('');
-
-    // Render tree (same structure as trace but showing callers)
-    let hasTruncation = false;
-    const renderNode = (node, prefix = '', isLast = true) => {
-        const connector = isLast ? '└── ' : '├── ';
-        const extension = isLast ? '    ' : '│   ';
-
-        let label = node.name;
-        if (node.file) {
-            label += ` (${node.file}:${node.line})`;
-        }
-        if (node.callSites && node.callSites > 1) {
-            label += ` ${node.callSites}x`;
-        }
-        if (node.alreadyShown) {
-            label += ' (see above)';
-        }
-
-        lines.push(prefix + connector + label);
-
-        if (node.children && !node.alreadyShown) {
-            const hasMore = node.truncatedChildren > 0;
-            for (let i = 0; i < node.children.length; i++) {
-                const isChildLast = !hasMore && i === node.children.length - 1;
-                renderNode(node.children[i], prefix + extension, isChildLast);
-            }
-            if (hasMore) {
-                hasTruncation = true;
-                lines.push(prefix + extension + `└── ... and ${node.truncatedChildren} more callers`);
-            }
-        }
-    };
-
-    // Root node
-    lines.push(blast.root);
-    if (blast.tree && blast.tree.children) {
-        const rootHasMore = blast.tree.truncatedChildren > 0;
-        for (let i = 0; i < blast.tree.children.length; i++) {
-            const isLast = !rootHasMore && i === blast.tree.children.length - 1;
-            renderNode(blast.tree.children[i], '', isLast);
-        }
-        if (rootHasMore) {
-            hasTruncation = true;
-            lines.push(`└── ... and ${blast.tree.truncatedChildren} more callers`);
-        }
-    }
-
-    // Summary
-    if (blast.summary) {
-        lines.push('');
-        const { totalAffected, totalFiles } = blast.summary;
-        if (totalAffected > 0) {
-            lines.push(`Summary: 1 function changed → ${totalAffected} function${totalAffected !== 1 ? 's' : ''} affected across ${totalFiles} file${totalFiles !== 1 ? 's' : ''}`);
-        } else {
-            lines.push('Summary: No callers found — this function is a root/entry point.');
-        }
-    }
-
-    if (hasTruncation) {
-        const allHint = options.allHint || 'Use --all to show all.';
-        lines.push(`\nSome results truncated. ${allHint}`);
-    }
-
-    if (blast.includeMethods === false) {
-        lines.push('\nNote: obj.method() calls excluded. Use --include-methods to include them.');
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format blast command output - JSON
- */
-function formatBlastJson(blast) {
-    if (!blast) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    return JSON.stringify(blast, null, 2);
-}
-
-/**
- * Format reverse-trace command output - text
- * Shows upward call chain to entry points
- */
-function formatReverseTrace(result, options = {}) {
-    if (!result) {
-        return 'Function not found.';
-    }
-
-    const lines = [];
-
-    // Header
-    lines.push(`Reverse trace for ${result.root}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${result.file}:${result.line}`);
-    lines.push(`Depth: ${result.maxDepth}`);
-
-    if (result.warnings && result.warnings.length > 0) {
-        for (const w of result.warnings) {
-            lines.push(`Note: ${w.message}`);
-        }
-    }
-
-    lines.push('');
-
-    // Render tree
-    let hasTruncation = false;
-    const renderNode = (node, prefix = '', isLast = true) => {
-        const connector = isLast ? '└── ' : '├── ';
-        const extension = isLast ? '    ' : '│   ';
-
-        let label = node.name;
-        if (node.file) {
-            label += ` (${node.file}:${node.line})`;
-        }
-        if (node.callSites && node.callSites > 1) {
-            label += ` ${node.callSites}x`;
-        }
-        if (node.entryPoint) {
-            label += ' ★ entry point';
-        }
-        if (node.alreadyShown) {
-            label += ' (see above)';
-        }
-
-        lines.push(prefix + connector + label);
-
-        if (node.children && !node.alreadyShown) {
-            const hasMore = node.truncatedChildren > 0;
-            for (let i = 0; i < node.children.length; i++) {
-                const isChildLast = !hasMore && i === node.children.length - 1;
-                renderNode(node.children[i], prefix + extension, isChildLast);
-            }
-            if (hasMore) {
-                hasTruncation = true;
-                lines.push(prefix + extension + `└── ... and ${node.truncatedChildren} more callers`);
-            }
-        }
-    };
-
-    // Root node
-    let rootLabel = result.root;
-    if (result.tree && result.tree.entryPoint) {
-        rootLabel += ' ★ entry point (no callers)';
-    }
-    lines.push(rootLabel);
-    if (result.tree && result.tree.children) {
-        const rootHasMore = result.tree.truncatedChildren > 0;
-        for (let i = 0; i < result.tree.children.length; i++) {
-            const isLast = !rootHasMore && i === result.tree.children.length - 1;
-            renderNode(result.tree.children[i], '', isLast);
-        }
-        if (rootHasMore) {
-            hasTruncation = true;
-            lines.push(`└── ... and ${result.tree.truncatedChildren} more callers`);
-        }
-    }
-
-    // Entry points summary
-    if (result.entryPoints && result.entryPoints.length > 0) {
-        lines.push('');
-        lines.push(`Entry points (${result.entryPoints.length}):`);
-        for (const ep of result.entryPoints) {
-            lines.push(`  ★ ${ep.name} (${ep.file}:${ep.line})`);
-        }
-    }
-
-    // Summary
-    if (result.summary) {
-        lines.push('');
-        const { totalEntryPoints, totalFunctions } = result.summary;
-        if (totalFunctions > 0) {
-            lines.push(`Summary: ${totalEntryPoints} entry point${totalEntryPoints !== 1 ? 's' : ''} reach${totalEntryPoints === 1 ? 'es' : ''} ${result.root} through ${totalFunctions} intermediate function${totalFunctions !== 1 ? 's' : ''}`);
-        } else {
-            lines.push('Summary: No callers found — this function is itself an entry point.');
-        }
-    }
-
-    if (hasTruncation) {
-        const allHint = options.allHint || 'Use --all to show all.';
-        lines.push(`\nSome results truncated. ${allHint}`);
-    }
-
-    if (result.includeMethods === false) {
-        lines.push('\nNote: obj.method() calls excluded. Use --include-methods to include them.');
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format reverse-trace command output - JSON
- */
-function formatReverseTraceJson(result) {
-    if (!result) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    return JSON.stringify(result, null, 2);
-}
-
-/**
- * Format affected-tests command output - text
- */
-function formatAffectedTests(result, options = {}) {
-    if (!result) return 'Function not found.';
-
-    const lines = [];
-    const { summary } = result;
-
-    lines.push(`affected-tests: ${result.root}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${result.file}:${result.line}`);
-    lines.push(`1 function changed → ${summary.totalAffected} functions affected (depth ${result.depth})`);
-    lines.push('');
-
-    if (result.testFiles.length === 0) {
-        lines.push('No test files found for any affected function.');
-    } else {
-        const MAX_TEST_FILES = options.all ? Infinity : 30;
-        const displayFiles = result.testFiles.slice(0, MAX_TEST_FILES);
-        const truncatedFiles = result.testFiles.length - displayFiles.length;
-        lines.push(`Test files to run (${summary.totalTestFiles}):`);
-        lines.push('');
-        for (const tf of displayFiles) {
-            lines.push(`  ${tf.file} (covers: ${tf.coveredFunctions.join(', ')})`);
-            // Show up to 5 key matches per file
-            const keyMatches = tf.matches
-                .filter(m => m.matchType === 'call' || m.matchType === 'test-case')
-                .slice(0, 5);
-            for (const m of keyMatches) {
-                lines.push(`    L${m.line}: ${m.content}  [${m.matchType}]`);
-            }
-        }
-        if (truncatedFiles > 0) {
-            lines.push(`\n  ... ${truncatedFiles} more test files (use file= and exclude= to narrow scope)`);
-        }
-    }
-
-    if (result.uncovered.length > 0) {
-        lines.push('');
-        lines.push(`Uncovered (${result.uncovered.length}): ${result.uncovered.join(', ')}`);
-        lines.push('  ⚠ These affected functions have no test references');
-    }
-
-    lines.push('');
-    const pct = summary.totalAffected > 0
-        ? Math.round(summary.coveredFunctions / summary.totalAffected * 100)
-        : 0;
-    lines.push(`Summary: ${summary.totalAffected} affected → ${summary.totalTestFiles} test files, ${summary.coveredFunctions}/${summary.totalAffected} functions covered (${pct}%)`);
-
-    if (result.warnings?.length > 0) {
-        lines.push('');
-        for (const w of result.warnings) lines.push(`Note: ${w.message}`);
-    }
-
-    return lines.join('\n');
-}
-
-function formatAffectedTestsJson(result) {
-    if (!result) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    return JSON.stringify(result, null, 2);
-}
-
-/**
- * Format related command output - text
- */
-function formatRelated(related, options = {}) {
-    if (!related) {
-        return 'Function not found.';
-    }
-
-    const lines = [];
-
-    // Header
-    lines.push(`Related to ${related.target.name}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${related.target.file}:${related.target.line}`);
-    lines.push('');
-
-    // Same file
-    let relatedTruncated = false;
-    if (related.sameFile.length > 0) {
-        const maxSameFile = options.top || (options.all ? Infinity : 8);
-        lines.push(`SAME FILE (${related.sameFile.length}):`);
-        for (const f of related.sameFile.slice(0, maxSameFile)) {
-            const params = f.params ? `(${f.params})` : '';
-            lines.push(`  :${f.line} ${f.name}${params}`);
-        }
-        if (related.sameFile.length > maxSameFile) {
-            relatedTruncated = true;
-            lines.push(`  ... and ${related.sameFile.length - maxSameFile} more`);
-        }
-        lines.push('');
-    }
-
-    // Similar names
-    if (related.similarNames.length > 0) {
-        lines.push(`SIMILAR NAMES (${related.similarNames.length}):`);
-        for (const s of related.similarNames) {
-            lines.push(`  ${s.name} - ${s.file}:${s.line}`);
-            lines.push(`    shared: ${s.sharedParts.join(', ')}`);
-        }
-        lines.push('');
-    }
-
-    // Shared callers
-    if (related.sharedCallers.length > 0) {
-        lines.push(`CALLED BY SAME FUNCTIONS (${related.sharedCallers.length}):`);
-        for (const s of related.sharedCallers) {
-            lines.push(`  ${s.name} - ${s.file}:${s.line} (${s.sharedCallerCount} shared callers)`);
-        }
-        lines.push('');
-    }
-
-    // Shared callees
-    if (related.sharedCallees.length > 0) {
-        lines.push(`CALLS SAME FUNCTIONS (${related.sharedCallees.length}):`);
-        for (const s of related.sharedCallees) {
-            lines.push(`  ${s.name} - ${s.file}:${s.line} (${s.sharedCalleeCount} shared callees)`);
-        }
-    }
-
-    if (relatedTruncated) {
-        const allHint = options.allHint || 'Use --all to show all.';
-        lines.push(`\nSome sections truncated. ${allHint}`);
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format related command output - JSON
- */
-function formatRelatedJson(related) {
-    if (!related) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    return JSON.stringify(related, null, 2);
-}
-
-/**
- * Format impact command output - text
- * Shows what would need updating if a function signature changes
- */
-function formatImpact(impact, options = {}) {
-    if (!impact) {
-        return 'Function not found.';
-    }
-
-    const lines = [];
-
-    // Header
-    lines.push(`Impact analysis for ${impact.function}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${impact.file}:${impact.startLine}`);
-    lines.push(impact.signature);
-    lines.push('');
-
-    // Summary
-    if (impact.shownCallSites !== undefined && impact.shownCallSites < impact.totalCallSites) {
-        lines.push(`CALL SITES: ${impact.shownCallSites} shown of ${impact.totalCallSites} total`);
-    } else {
-        lines.push(`CALL SITES: ${impact.totalCallSites}`);
-    }
-    lines.push(`  Files affected: ${impact.byFile.length}`);
-
-    // Patterns
-    const p = impact.patterns;
-    if (p) {
-        const patternParts = [];
-        if (p.constantArgs > 0) patternParts.push(`${p.constantArgs} with literals`);
-        if (p.variableArgs > 0) patternParts.push(`${p.variableArgs} with variables`);
-        if (p.awaitedCalls > 0) patternParts.push(`${p.awaitedCalls} awaited`);
-        if (p.chainedCalls > 0) patternParts.push(`${p.chainedCalls} chained`);
-        if (p.spreadCalls > 0) patternParts.push(`${p.spreadCalls} with spread`);
-        if (patternParts.length > 0) {
-            lines.push(`  Patterns: ${patternParts.join(', ')}`);
-        }
-    }
-
-    // Scope pollution warning
-    if (impact.scopeWarning) {
-        lines.push(`  Note: ${impact.scopeWarning.hint}`);
-    }
-
-    // By file
-    lines.push('');
-    lines.push('BY FILE:');
-    for (const fileGroup of impact.byFile) {
-        lines.push(`\n${fileGroup.file} (${fileGroup.count} calls)`);
-        for (const site of fileGroup.sites) {
-            const caller = site.callerName ? `[${site.callerName}]` : '';
-            lines.push(`  :${site.line} ${caller}`);
-            lines.push(`    ${site.expression}`);
-            if (site.args && site.args.length > 0) {
-                lines.push(`    args: ${site.args.join(', ')}`);
-            }
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format impact command output - JSON
- */
-function formatImpactJson(impact) {
-    if (!impact) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    return JSON.stringify(impact, null, 2);
-}
-
-/**
- * Format plan command output - text
- * Shows before/after signatures and all changes needed
- */
-function formatPlan(plan, options = {}) {
-    if (!plan) {
-        return 'Function not found.';
-    }
-    if (!plan.found) {
-        return `Function "${plan.function}" not found.`;
-    }
-    if (plan.error) {
-        return `Error: ${plan.error}\nCurrent parameters: ${plan.currentParams?.join(', ') || 'none'}`;
-    }
-
-    const lines = [];
-
-    // Header
-    lines.push(`Refactoring plan: ${plan.operation}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${plan.file}:${plan.startLine}`);
-    lines.push('');
-
-    // Before/After
-    lines.push('SIGNATURE CHANGE:');
-    lines.push(`  Before: ${plan.before.signature}`);
-    lines.push(`  After:  ${plan.after.signature}`);
-    lines.push('');
-
-    // Summary
-    lines.push(`CHANGES NEEDED: ${plan.totalChanges}`);
-    lines.push(`  Files affected: ${plan.filesAffected}`);
-    if (plan.scopeWarning) {
-        lines.push(`  Note: ${plan.scopeWarning.hint}`);
-    }
-    lines.push('');
-
-    // Group by file
-    const byFile = new Map();
-    for (const change of plan.changes) {
-        if (!byFile.has(change.file)) {
-            byFile.set(change.file, []);
-        }
-        byFile.get(change.file).push(change);
-    }
-
-    lines.push('BY FILE:');
-    for (const [file, changes] of byFile) {
-        lines.push(`\n${file} (${changes.length} changes)`);
-        for (const change of changes) {
-            lines.push(`  :${change.line}`);
-            lines.push(`    ${change.expression}`);
-            lines.push(`    → ${change.suggestion}`);
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format stack trace command output - text
- * Shows code context for each stack frame
- */
-function formatStackTrace(result) {
-    if (!result || result.frameCount === 0) {
-        return 'No stack frames found in input.';
-    }
-
-    const lines = [];
-    lines.push(`Stack trace: ${result.frameCount} frames`);
-    lines.push('═'.repeat(60));
-
-    for (let i = 0; i < result.frames.length; i++) {
-        const frame = result.frames[i];
-        lines.push('');
-        lines.push(`Frame ${i}: ${frame.function || '(anonymous)'}`);
-        lines.push('─'.repeat(40));
-
-        if (frame.found) {
-            lines.push(`  ${frame.resolvedFile}:${frame.line}`);
-
-            // Show code context
-            if (frame.context) {
-                lines.push('');
-                for (const ctx of frame.context) {
-                    const marker = ctx.isCurrent ? '→ ' : '  ';
-                    const lineNum = ctx.line.toString().padStart(4);
-                    lines.push(`  ${marker}${lineNum} │ ${ctx.code}`);
-                }
-            }
-
-            // Show function info if available
-            if (frame.functionInfo) {
-                lines.push('');
-                lines.push(`  In: ${frame.functionInfo.name}(${frame.functionInfo.params || ''})`);
-                lines.push(`  Range: ${frame.functionInfo.startLine}-${frame.functionInfo.endLine}`);
-            }
-        } else {
-            lines.push(`  ${frame.file}:${frame.line} (file not found in project)`);
-            lines.push(`  Raw: ${frame.raw}`);
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format verify command output - text
- * Shows call site validation results
- */
-function formatVerify(result, options = {}) {
-    if (!result) {
-        return 'Function not found.';
-    }
-    if (!result.found) {
-        return `Function "${result.function}" not found.`;
-    }
-
-    const lines = [];
-
-    // Header
-    lines.push(`Verification: ${result.function}`);
-    lines.push('═'.repeat(60));
-    lines.push(`${result.file}:${result.startLine}`);
-    lines.push(result.signature);
-    lines.push('');
-
-    // Expected args
-    const { min, max } = result.expectedArgs;
-    const expectedStr = min === max ? `${min}` : `${min}-${max}`;
-    lines.push(`Expected arguments: ${expectedStr}`);
-    lines.push('');
-
-    // Summary
-    const status = result.mismatches === 0 ? '✓ All calls valid' : '✗ Mismatches found';
-    lines.push(`STATUS: ${status}`);
-    lines.push(`  Total calls: ${result.totalCalls}`);
-    lines.push(`  Valid: ${result.valid}`);
-    lines.push(`  Mismatches: ${result.mismatches}`);
-    lines.push(`  Uncertain: ${result.uncertain}`);
-    if (result.scopeWarning) {
-        lines.push(`  Note: ${result.scopeWarning.hint}`);
-    }
-
-    // Show mismatches
-    if (result.mismatchDetails.length > 0) {
-        lines.push('');
-        lines.push('MISMATCHES:');
-        for (const m of result.mismatchDetails) {
-            lines.push(`  ${m.file}:${m.line}`);
-            lines.push(`    ${m.expression}`);
-            lines.push(`    Expected ${m.expected}, got ${m.actual}: [${m.args?.join(', ') || ''}]`);
-        }
-    }
-
-    // Show uncertain
-    if (result.uncertainDetails.length > 0) {
-        lines.push('');
-        lines.push('UNCERTAIN (manual check needed):');
-        for (const u of result.uncertainDetails) {
-            lines.push(`  ${u.file}:${u.line}`);
-            lines.push(`    ${u.expression}`);
-            lines.push(`    Reason: ${u.reason}`);
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format about command output - text
- * The "tell me everything" output for AI agents
- */
-function formatAbout(about, options = {}) {
-    if (!about) {
-        return 'Symbol not found.';
-    }
-    if (!about.found) {
-        const lines = ['Symbol not found.\n'];
-        if (about.suggestions && about.suggestions.length > 0) {
-            lines.push('Did you mean:');
-            for (const s of about.suggestions) {
-                lines.push(`  ${s.name} (${s.type}) - ${s.file}:${s.line}`);
-                lines.push(`    ${s.usageCount} usages`);
-            }
-        }
-        return lines.join('\n');
-    }
-
-    const lines = [];
-    const sym = about.symbol;
-    const { expand, root, depth } = options;
-
-    // Depth=0: location only
-    if (depth !== null && depth !== undefined && Number(depth) === 0) {
-        return `${sym.file}:${sym.startLine}`;
-    }
-
-    // Depth=1: location + signature + usage counts
-    if (depth !== null && depth !== undefined && Number(depth) === 1) {
-        lines.push(`${sym.file}:${sym.startLine}`);
-        if (sym.signature) {
-            lines.push(sym.signature);
-        }
-        lines.push(`(${about.totalUsages} usages: ${about.usages.calls} calls, ${about.usages.imports} imports, ${about.usages.references} refs)`);
-        return lines.join('\n');
-    }
-
-    // Header with signature
-    lines.push(`${sym.name} (${sym.type})`);
-    lines.push('═'.repeat(60));
-    lines.push(`${sym.file}:${sym.startLine}-${sym.endLine}`);
-    if (sym.signature) {
-        lines.push(sym.signature);
-    }
-    if (sym.docstring) {
-        lines.push(`"${sym.docstring}"`);
-    }
-
-    // Warnings (show early for visibility)
-    if (about.warnings && about.warnings.length > 0) {
-        for (const w of about.warnings) {
-            lines.push(`  Note: ${w.message}`);
-        }
-    }
-    if (about.confidenceFiltered) {
-        lines.push(`  Note: ${about.confidenceFiltered} edge(s) below confidence threshold hidden`);
-    }
-
-    // Usage summary
-    lines.push('');
-    lines.push(`USAGES: ${about.totalUsages} total`);
-    lines.push(`  ${about.usages.calls} calls, ${about.usages.imports} imports, ${about.usages.references} references`);
-
-    // Callers
-    const showConf = options.showConfidence || false;
-    let aboutTruncated = false;
-    if (about.callers.total > 0) {
-        lines.push('');
-        if (about.callers.total > about.callers.top.length) {
-            lines.push(`CALLERS (showing ${about.callers.top.length} of ${about.callers.total}):`);
-            aboutTruncated = true;
-        } else {
-            lines.push(`CALLERS (${about.callers.total}):`);
-        }
-        for (const c of about.callers.top) {
-            const caller = c.callerName ? `[${c.callerName}]` : '';
-            lines.push(`  ${c.file}:${c.line} ${caller}`);
-            lines.push(`    ${c.expression}`);
-            if (showConf && c.confidence != null) {
-                lines.push(`    confidence: ${c.confidence.toFixed(2)} (${c.resolution})`);
-            }
-        }
-    }
-
-    // Callees
-    if (about.callees.total > 0) {
-        lines.push('');
-        if (about.callees.total > about.callees.top.length) {
-            lines.push(`CALLEES (showing ${about.callees.top.length} of ${about.callees.total}):`);
-            aboutTruncated = true;
-        } else {
-            lines.push(`CALLEES (${about.callees.total}):`);
-        }
-        for (const c of about.callees.top) {
-            const weight = c.weight && c.weight !== 'normal' ? ` [${c.weight}]` : '';
-            lines.push(`  ${c.name}${weight} - ${c.file}:${c.line} (${c.callCount}x)`);
-            if (showConf && c.confidence != null) {
-                lines.push(`    confidence: ${c.confidence.toFixed(2)} (${c.resolution})`);
-            }
-
-            // Inline expansion: show first 3 lines of callee code
-            if (expand && root && c.file && c.startLine) {
-                try {
-                    const filePath = path.isAbsolute(c.file) ? c.file : path.join(root, c.file);
-                    const content = fs.readFileSync(filePath, 'utf-8');
-                    const fileLines = content.split('\n');
-                    const endLine = c.endLine || c.startLine + 5;
-                    const previewLines = Math.min(3, endLine - c.startLine + 1);
-                    for (let i = 0; i < previewLines && c.startLine - 1 + i < fileLines.length; i++) {
-                        const codeLine = fileLines[c.startLine - 1 + i];
-                        lines.push(`      │ ${codeLine}`);
-                    }
-                    if (endLine - c.startLine + 1 > 3) {
-                        lines.push(`      │ ... (${endLine - c.startLine - 2} more lines)`);
-                    }
-                } catch (e) {
-                    // Skip expansion on error
-                }
-            }
-        }
-    }
-
-    // Tests
-    if (about.tests.totalMatches > 0) {
-        lines.push('');
-        if (about.tests.fileCount > about.tests.files.length) {
-            lines.push(`TESTS: ${about.tests.totalMatches} matches in ${about.tests.fileCount} file(s), showing ${about.tests.files.length}:`);
-            aboutTruncated = true;
-        } else {
-            lines.push(`TESTS: ${about.tests.totalMatches} matches in ${about.tests.fileCount} file(s)`);
-        }
-        for (const f of about.tests.files) {
-            lines.push(`  ${f}`);
-        }
-    }
-
-    // Other definitions
-    if (about.otherDefinitions.length > 0) {
-        lines.push('');
-        lines.push(`OTHER DEFINITIONS (${about.otherDefinitions.length}):`);
-        for (const d of about.otherDefinitions) {
-            lines.push(`  ${d.file}:${d.line} (${d.usageCount} usages)`);
-        }
-    }
-
-    // Types
-    if (about.types && about.types.length > 0) {
-        lines.push('');
-        lines.push('TYPES:');
-        for (const t of about.types) {
-            lines.push(`  ${t.name} (${t.type}) - ${t.file}:${t.line}`);
-        }
-    }
-
-    // Completeness warnings (condensed single line)
-    if (about.completeness && about.completeness.warnings && about.completeness.warnings.length > 0) {
-        const parts = about.completeness.warnings.map(w => `${w.count} ${w.type.replace('_', ' ')}`);
-        lines.push('');
-        lines.push(`Note: Results may be incomplete (${parts.join(', ')} in project)`);
-    }
-
-    // Code
-    if (about.code) {
-        lines.push('');
-        lines.push('─── CODE ───');
-        lines.push(about.code);
-    }
-
-    if (aboutTruncated) {
-        const allHint = options.allHint || 'Use --all to show all.';
-        lines.push(`\nSome sections truncated. ${allHint}`);
-    }
-
-    if (about.includeMethods === false) {
-        const methodsHint = options.methodsHint || 'Note: obj.method() callers/callees excluded — use --include-methods to include them';
-        lines.push(`\n${methodsHint}`);
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format about command output - JSON
- */
-function formatAboutJson(about) {
-    if (!about) {
-        return JSON.stringify({ found: false, error: 'Symbol not found' }, null, 2);
-    }
-    return JSON.stringify(about, null, 2);
-}
-
-/**
- * Format example result as text
- */
-function formatExample(result, name) {
-    if (!result || !result.best) return `No call examples found for "${name}"`;
-
-    const best = result.best;
-    const lines = [];
-    lines.push(`Best example of "${name}":`);
-    lines.push('═'.repeat(60));
-    lines.push(`${best.relativePath}:${best.line}`);
-    lines.push('');
-
-    if (best.before) {
-        for (let i = 0; i < best.before.length; i++) {
-            const ln = best.line - best.before.length + i;
-            lines.push(`${ln.toString().padStart(4)}| ${best.before[i]}`);
-        }
-    }
-
-    lines.push(`${best.line.toString().padStart(4)}| ${best.content}  <--`);
-
-    if (best.after) {
-        for (let i = 0; i < best.after.length; i++) {
-            const ln = best.line + i + 1;
-            lines.push(`${ln.toString().padStart(4)}| ${best.after[i]}`);
-        }
-    }
-
-    lines.push('');
-    lines.push(`Score: ${best.score} (${result.totalCalls} total calls)`);
-    lines.push(`Why: ${best.reasons.length > 0 ? best.reasons.join(', ') : 'first available call'}`);
-
-    return lines.join('\n');
-}
-
-// ============================================================================
-// TEXT FORMATTERS (shared between CLI and MCP)
-// ============================================================================
-
-/**
- * Format toc command output
- * @param {object} toc - TOC data
- * @param {object} [options] - Formatting options
- * @param {string} [options.detailedHint] - Custom hint text for non-detailed mode
- * @param {string} [options.uncertainHint] - Custom hint text for uncertain references
- */
-function formatToc(toc, options = {}) {
-    const lines = [];
-    const t = toc.totals;
-    lines.push(`PROJECT: ${t.files} files, ${t.lines} lines`);
-    lines.push(`  ${t.functions} functions, ${t.classes} types (classes/interfaces/enums), ${t.state} state objects`);
-
-    const meta = toc.meta || {};
-    if (meta.filteredBy) {
-        lines.push(`  Filtered by: --file=${meta.filteredBy} (${meta.matchedFiles} files matched)`);
-        if (meta.emptyFiles) {
-            lines.push(`  Note: ${meta.emptyFiles} file(s) have no detected symbols (may be generated or data files)`);
-        }
-    }
-    const warnings = [];
-    if (meta.dynamicImports) { const dn = dynamicImportsNote(meta.dynamicImports, meta); if (dn) warnings.push(dn); }
-    if (meta.uncertain) warnings.push(`${meta.uncertain} uncertain reference(s)`);
-    if (warnings.length) {
-        const uncertainSuffix = meta.uncertain && options.uncertainHint ? ` — ${options.uncertainHint}` : '';
-        lines.push(`  Note: ${warnings.join(', ')}${uncertainSuffix}`);
-    }
-
-    if (toc.summary) {
-        if (toc.summary.topFunctionFiles?.length) {
-            const hint = toc.summary.topFunctionFiles.map(f => `${f.file} (${f.functions})`).join(', ');
-            lines.push(`  Most functions: ${hint}`);
-        }
-        if (toc.summary.topLineFiles?.length) {
-            const hint = toc.summary.topLineFiles.map(f => `${f.file} (${f.lines})`).join(', ');
-            lines.push(`  Largest files: ${hint}`);
-        }
-        if (toc.summary.entryFiles?.length) {
-            lines.push(`  Entry points: ${toc.summary.entryFiles.join(', ')}`);
-        }
-    }
-
-    lines.push('═'.repeat(60));
-    const hasDetail = toc.files.some(f => f.symbols);
-    for (const file of toc.files) {
-        const parts = [`${file.lines} lines`];
-        if (file.functions) parts.push(`${file.functions} fn`);
-        if (file.classes) parts.push(`${file.classes} types`);
-        if (file.state) parts.push(`${file.state} state`);
-
-        if (hasDetail) {
-            lines.push(`\n${file.file} (${parts.join(', ')})`);
-            if (file.symbols) {
-                for (const fn of file.symbols.functions) {
-                    lines.push(`  ${lineRange(fn.startLine, fn.endLine)} ${formatFunctionSignature(fn)}`);
-                }
-                for (const cls of file.symbols.classes) {
-                    lines.push(`  ${lineRange(cls.startLine, cls.endLine)} ${formatClassSignature(cls)}`);
-                }
-            }
-        } else {
-            lines.push(`  ${file.file} — ${parts.join(', ')}`);
-        }
-    }
-
-    if (!hasDetail) {
-        const hint = options.detailedHint || 'Use detailed=true to list all functions and classes.';
-        lines.push(`\n${hint}`);
-    }
-
-    if (toc.hiddenFiles > 0) {
-        const topHint = options.topHint || 'Use --top=N or --all to show more.';
-        lines.push(`\n... and ${toc.hiddenFiles} more files. ${topHint}`);
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format find command output
- */
-function formatFind(symbols, query, top) {
-    if (symbols.length === 0) {
-        return `No symbols found for "${query}"`;
-    }
-
-    const lines = [];
-    const limit = (top && top > 0) ? Math.min(symbols.length, top) : Math.min(symbols.length, 10);
-    const hidden = symbols.length - limit;
-
-    if (hidden > 0) {
-        lines.push(`Found ${symbols.length} match(es) for "${query}" (showing top ${limit}):`);
-    } else {
-        lines.push(`Found ${symbols.length} match(es) for "${query}":`);
-    }
-    lines.push('─'.repeat(60));
-
-    for (let i = 0; i < limit; i++) {
-        const s = symbols[i];
-        const sig = s.params !== undefined
-            ? formatFunctionSignature(s)
-            : formatClassSignature(s);
-        lines.push(`${s.relativePath}:${s.startLine}  ${sig}`);
-        if (s.usageCounts !== undefined) {
-            const c = s.usageCounts;
-            const parts = [];
-            if (c.calls > 0) parts.push(`${c.calls} calls`);
-            if (c.definitions > 0) parts.push(`${c.definitions} def`);
-            if (c.imports > 0) parts.push(`${c.imports} imports`);
-            if (c.references > 0) parts.push(`${c.references} refs`);
-            lines.push(parts.length > 0
-                ? `  (${c.total} usages: ${parts.join(', ')})`
-                : `  (${c.total} usages)`);
-        } else if (s.usageCount !== undefined) {
-            lines.push(`  (${s.usageCount} usages)`);
-        }
-    }
-
-    if (hidden > 0) {
-        lines.push(`... ${hidden} more result(s).`);
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format usages command output
- */
-function formatUsages(usages, name) {
-    const defs = usages.filter(u => u.isDefinition);
-    const calls = usages.filter(u => u.usageType === 'call');
-    const imports = usages.filter(u => u.usageType === 'import');
-    const refs = usages.filter(u => !u.isDefinition && u.usageType === 'reference');
-
-    const lines = [];
-    lines.push(`Usages of "${name}": ${defs.length} definitions, ${calls.length} calls, ${imports.length} imports, ${refs.length} references`);
-    lines.push('═'.repeat(60));
-
-    function renderContextLines(usage) {
-        if (usage.before && usage.before.length > 0) {
-            for (const line of usage.before) {
-                lines.push(`      ${line}`);
-            }
-        }
-    }
-
-    function renderAfterLines(usage) {
-        if (usage.after && usage.after.length > 0) {
-            for (const line of usage.after) {
-                lines.push(`      ${line}`);
-            }
-        }
-    }
-
-    if (defs.length > 0) {
-        lines.push('\nDEFINITIONS:');
-        for (const d of defs) {
-            lines.push(`  ${d.relativePath}:${d.line || d.startLine}`);
-            if (d.signature) lines.push(`    ${d.signature}`);
-        }
-    }
-
-    if (calls.length > 0) {
-        lines.push('\nCALLS:');
-        for (const c of calls) {
-            lines.push(`  ${c.relativePath}:${c.line}`);
-            renderContextLines(c);
-            lines.push(`    ${c.content.trim()}`);
-            renderAfterLines(c);
-        }
-    }
-
-    if (imports.length > 0) {
-        lines.push('\nIMPORTS:');
-        for (const i of imports) {
-            lines.push(`  ${i.relativePath}:${i.line}`);
-            lines.push(`    ${i.content.trim()}`);
-        }
-    }
-
-    if (refs.length > 0) {
-        lines.push('\nREFERENCES:');
-        for (const r of refs) {
-            lines.push(`  ${r.relativePath}:${r.line}`);
-            renderContextLines(r);
-            lines.push(`    ${r.content.trim()}`);
-            renderAfterLines(r);
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format context command output
- * Returns { text, expandable } where expandable is an array of items for expand
- * @param {object} ctx - Context data
- * @param {object} [options] - Formatting options
- * @param {string} [options.methodsHint] - Custom hint for excluded method calls
- * @param {string} [options.expandHint] - Custom hint for expand command
- * @param {string} [options.uncertainHint] - Custom hint for uncertain calls
- */
-function formatContext(ctx, options = {}) {
-    if (!ctx) return { text: 'Symbol not found.', expandable: [] };
-
-    const expandHint = options.expandHint || 'Use ucn_expand with item number to see code for any item.';
-    const methodsHint = options.methodsHint || 'Note: obj.method() calls excluded. Use include_methods=true to include them.';
-
-    const lines = [];
-    const expandable = [];
-    let itemNum = 1;
-
-    // Handle struct/interface types
-    if (ctx.type && ['class', 'struct', 'interface', 'type'].includes(ctx.type)) {
-        lines.push(`Context for ${ctx.type} ${ctx.name}:`);
-        lines.push('═'.repeat(60));
-
-        if (ctx.warnings && ctx.warnings.length > 0) {
-            for (const w of ctx.warnings) {
-                lines.push(`  Note: ${w.message}`);
-            }
-        }
-
-        const methods = ctx.methods || [];
-        lines.push(`\nMETHODS (${methods.length}):`);
-        for (const m of methods) {
-            const receiver = m.receiver ? `(${m.receiver}) ` : '';
-            const params = m.params || '...';
-            const returnType = m.returnType ? `: ${m.returnType}` : '';
-            lines.push(`  [${itemNum}] ${receiver}${m.name}(${params})${returnType}`);
-            lines.push(`    ${m.file}:${m.line}`);
-            expandable.push({
-                num: itemNum++,
-                type: 'method',
-                name: m.name,
-                file: null,
-                relativePath: m.file,
-                startLine: m.line,
-                endLine: m.endLine || m.line
-            });
-        }
-
-        const callers = ctx.callers || [];
-        lines.push(`\nCALLERS (${callers.length}):`);
-        for (const c of callers) {
-            const callerName = c.callerName ? ` [${c.callerName}]` : '';
-            lines.push(`  [${itemNum}] ${c.relativePath}:${c.line}${callerName}`);
-            lines.push(`    ${c.content.trim()}`);
-            expandable.push({
-                num: itemNum++,
-                type: 'caller',
-                name: c.callerName || '(module level)',
-                file: c.callerFile || c.file,
-                relativePath: c.relativePath,
-                line: c.line,
-                startLine: c.callerStartLine || c.line,
-                endLine: c.callerEndLine || c.line
-            });
-        }
-
-        if (expandable.length > 0) {
-            lines.push(`\n${expandHint}`);
-        }
-
-        return { text: lines.join('\n'), expandable };
-    }
-
-    // Standard function/method context
-    lines.push(`Context for ${ctx.function}:`);
-    lines.push('═'.repeat(60));
-
-    if (ctx.meta) {
-        const notes = [];
-        if (ctx.meta.dynamicImports) { const dn = dynamicImportsNote(ctx.meta.dynamicImports, ctx.meta); if (dn) notes.push(dn); }
-        if (ctx.meta.uncertain) notes.push(`${ctx.meta.uncertain} uncertain call(s) skipped`);
-        if (ctx.meta.confidenceFiltered) notes.push(`${ctx.meta.confidenceFiltered} edge(s) below confidence threshold hidden`);
-        if (notes.length) {
-            const uncertainSuffix = ctx.meta.uncertain && options.uncertainHint ? ` — ${options.uncertainHint}` : '';
-            lines.push(`  Note: ${notes.join(', ')}${uncertainSuffix}`);
-        }
-    }
-
-    if (ctx.meta && ctx.meta.includeMethods === false) {
-        lines.push(`  ${methodsHint}`);
-    }
-
-    if (ctx.warnings && ctx.warnings.length > 0) {
-        for (const w of ctx.warnings) {
-            lines.push(`  Note: ${w.message}`);
-        }
-    }
-
-    const showConf = options.showConfidence || false;
-    const callers = ctx.callers || [];
-    lines.push(`\nCALLERS (${callers.length}):`);
-    for (const c of callers) {
-        const callerName = c.callerName ? ` [${c.callerName}]` : '';
-        lines.push(`  [${itemNum}] ${c.relativePath}:${c.line}${callerName}`);
-        lines.push(`    ${c.content.trim()}`);
-        if (showConf && c.confidence != null) {
-            lines.push(`    confidence: ${c.confidence.toFixed(2)} (${c.resolution})`);
-        }
-        expandable.push({
-            num: itemNum++,
-            type: 'caller',
-            name: c.callerName || '(module level)',
-            file: c.callerFile || c.file,
-            relativePath: c.relativePath,
-            line: c.line,
-            startLine: c.callerStartLine || c.line,
-            endLine: c.callerEndLine || c.line
-        });
-    }
-
-    // Structural hint: class methods may have callers through constructed/injected instances
-    // that static analysis can't track. Only show when caller count is low (≤3) to avoid noise.
-    if (ctx.meta && (ctx.meta.isMethod || ctx.meta.className || ctx.meta.receiver) && callers.length <= 3) {
-        lines.push(`  Note: ${ctx.function} is a class/struct method — additional callers through constructed or injected instances are not tracked by static analysis.`);
-    }
-
-    const callees = ctx.callees || [];
-    lines.push(`\nCALLEES (${callees.length}):`);
-    for (const c of callees) {
-        const weight = c.weight && c.weight !== 'normal' ? ` [${c.weight}]` : '';
-        lines.push(`  [${itemNum}] ${c.name}${weight} - ${c.relativePath}:${c.startLine}`);
-        if (showConf && c.confidence != null) {
-            lines.push(`    confidence: ${c.confidence.toFixed(2)} (${c.resolution})`);
-        }
-        expandable.push({
-            num: itemNum++,
-            type: 'callee',
-            name: c.name,
-            file: c.file,
-            relativePath: c.relativePath,
-            startLine: c.startLine,
-            endLine: c.endLine
-        });
-    }
-
-    if (expandable.length > 0) {
-        lines.push(`\n${expandHint}`);
-    }
-
-    return { text: lines.join('\n'), expandable };
-}
-
-/**
- * Format smart command output
- * @param {object} smart - Smart extraction result
- * @param {object} [options] - Formatting options
- * @param {string} [options.uncertainHint] - Custom hint for uncertain calls
- */
-function formatSmart(smart, options = {}) {
-    if (!smart) return 'Function not found.';
-
-    const lines = [];
-    lines.push(`${smart.target.name} (${smart.target.file}:${smart.target.startLine})`);
-    lines.push('═'.repeat(60));
-
-    if (smart.meta) {
-        const notes = [];
-        if (smart.meta.dynamicImports) { const dn = dynamicImportsNote(smart.meta.dynamicImports, smart.meta); if (dn) notes.push(dn); }
-        if (smart.meta.uncertain) notes.push(`${smart.meta.uncertain} uncertain call(s) skipped`);
-        if (notes.length) {
-            const uncertainSuffix = smart.meta.uncertain && options.uncertainHint ? ` — ${options.uncertainHint}` : '';
-            lines.push(`  Note: ${notes.join(', ')}${uncertainSuffix}`);
-        }
-    }
-
-    lines.push(smart.target.code);
-
-    if (smart.dependencies.length > 0) {
-        lines.push('\n─── DEPENDENCIES ───');
-        for (const dep of smart.dependencies) {
-            const weight = dep.weight && dep.weight !== 'normal' ? ` [${dep.weight}]` : '';
-            lines.push(`\n// ${dep.name}${weight} (${dep.relativePath}:${dep.startLine})`);
-            lines.push(dep.code);
-        }
-    }
-
-    if (smart.types && smart.types.length > 0) {
-        lines.push('\n─── TYPES ───');
-        for (const t of smart.types) {
-            lines.push(`\n// ${t.name} (${t.relativePath}:${t.startLine})`);
-            lines.push(t.code);
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format deadcode command output
- * @param {Array} results - Dead code results
- * @param {object} [options] - Formatting options
- * @param {string} [options.exportedHint] - Hint about exported symbols exclusion
- */
-function formatDeadcode(results, options = {}) {
-    if (results.length === 0 && !results.excludedDecorated && !results.excludedExported) {
-        return 'No dead code found.';
-    }
-
-    const lines = [];
-    const top = options.top > 0 ? options.top : 0;
-    const showing = top > 0 ? results.slice(0, top) : results;
-    const hidden = results.length - showing.length;
-
-    if (results.length > 0) {
-        if (hidden > 0) {
-            lines.push(`Dead code: ${results.length} unused symbol(s) (showing ${showing.length})\n`);
-        } else {
-            lines.push(`Dead code: ${results.length} unused symbol(s)\n`);
-        }
-    }
-
-    let currentFile = null;
-    for (const item of showing) {
-        if (item.file !== currentFile) {
-            currentFile = item.file;
-            lines.push(item.file);
-        }
-        const exported = item.isExported ? ' [exported]' : '';
-        // Surface decorators/annotations — structural hint that a framework may invoke this
-        const hints = [];
-        if (item.decorators && item.decorators.length > 0) {
-            hints.push(...item.decorators.map(d => `@${d}`));
-        }
-        if (item.annotations && item.annotations.length > 0) {
-            hints.push(...item.annotations.map(a => `@${a}`));
-        }
-        const hintStr = hints.length > 0 ? ` [has ${hints.join(', ')}]` : '';
-        lines.push(`  ${lineRange(item.startLine, item.endLine)} ${item.name} (${item.type})${exported}${hintStr}`);
-    }
-
-    if (hidden > 0) {
-        lines.push(`\n${hidden} more result(s) not shown. Use --top=${results.length} or --all to see all.`);
-    }
-
-    // Show counts of excluded items with expansion hints
-    if (results.length === 0) {
-        lines.push('No dead code found.');
-    }
-    if (results.excludedDecorated > 0) {
-        const decoratedHint = options.decoratedHint || `${results.excludedDecorated} decorated/annotated symbol(s) hidden (framework-registered). Use --include-decorated to include them.`;
-        lines.push(`\n${decoratedHint}`);
-    }
-    if (results.excludedExported > 0) {
-        const exportedHint = options.exportedHint || `${results.excludedExported} exported symbol(s) excluded (all have callers). Use --include-exported to audit them.`;
-        lines.push(`\n${exportedHint}`);
-    }
-
-    if (lines.length === 0) {
-        return 'No dead code found.';
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format fn command output
- */
-function formatFn(match, fnCode) {
-    const lines = [];
-    lines.push(`${match.relativePath}:${match.startLine}`);
-    lines.push(`${lineRange(match.startLine, match.endLine)} ${formatFunctionSignature(match)}`);
-    lines.push('─'.repeat(60));
-    lines.push(fnCode);
-    return lines.join('\n');
-}
-
-/**
- * Format class command output
- */
-function formatClass(cls, clsCode) {
-    const lines = [];
-    lines.push(`${cls.relativePath || cls.file}:${cls.startLine}`);
-    lines.push(`${lineRange(cls.startLine, cls.endLine)} ${formatClassSignature(cls)}`);
-    lines.push('─'.repeat(60));
-    lines.push(clsCode);
-    return lines.join('\n');
-}
-
-/**
- * Format graph command output
- * @param {object} graph - Graph data
- * @param {object} [options] - Formatting options
- * @param {boolean} [options.showAll] - Show all children (no truncation)
- * @param {number} [options.maxDepth] - Maximum depth for tree traversal
- */
-function formatGraph(graph, options = {}) {
-    // Support legacy signature: formatGraph(graph, showAll)
-    if (typeof options === 'boolean') {
-        options = { showAll: options };
-    }
-    if (graph?.error) return formatFileError(graph);
-    if (graph.nodes.length === 0) {
-        const file = options.file || graph.root || '';
-        return file ? `File not found: ${file}` : 'File not found.';
-    }
-
-    const rootEntry = graph.nodes.find(n => n.file === graph.root);
-    const rootRelPath = rootEntry ? rootEntry.relativePath : graph.root;
-    const lines = [];
-
-    const showAll = options.showAll || false;
-    const maxChildren = showAll ? Infinity : 8;
-    const maxDepth = options.maxDepth !== undefined ? options.maxDepth : Infinity;
-
-    function printTree(nodes, edges, rootFile) {
-        const visited = new Set();     // all nodes ever printed (for diamond dep detection)
-        const ancestors = new Set();   // current path from root (for true circular detection)
-        let truncatedNodes = 0;
-        let depthLimited = false;
-
-        function printNode(file, indent = 0, isLast = true) {
-            const fileEntry = nodes.find(n => n.file === file);
-            const relPath = fileEntry ? fileEntry.relativePath : file;
-            const connector = isLast ? '└── ' : '├── ';
-            const prefix = indent === 0 ? '' : '  '.repeat(indent - 1) + connector;
-
-            if (ancestors.has(file)) {
-                lines.push(`${prefix}${relPath} (circular)`);
-                return;
-            }
-            if (visited.has(file)) {
-                lines.push(`${prefix}${relPath} (already shown)`);
-                return;
-            }
-            visited.add(file);
-
-            if (indent > maxDepth) {
-                depthLimited = true;
-                lines.push(`${prefix}${relPath} ...`);
-                return;
-            }
-
-            lines.push(`${prefix}${relPath}`);
-
-            ancestors.add(file);
-            const fileEdges = edges.filter(e => e.from === file);
-            const displayEdges = fileEdges.slice(0, maxChildren);
-            const hiddenCount = fileEdges.length - displayEdges.length;
-
-            for (let i = 0; i < displayEdges.length; i++) {
-                const childIsLast = i === displayEdges.length - 1 && hiddenCount === 0;
-                printNode(displayEdges[i].to, indent + 1, childIsLast);
-            }
-            ancestors.delete(file);
-
-            if (hiddenCount > 0) {
-                truncatedNodes += hiddenCount;
-                lines.push(`${'  '.repeat(indent)}└── ... and ${hiddenCount} more`);
-            }
-        }
-
-        printNode(rootFile);
-        return { truncatedNodes, depthLimited };
-    }
-
-    if (graph.direction === 'both' && graph.imports && graph.importers) {
-        const importCount = graph.imports.edges.filter(e => e.from === graph.root).length;
-        const importerCount = graph.importers.edges.filter(e => e.from === graph.root).length;
-
-        lines.push(`Dependency graph for ${rootRelPath}`);
-        lines.push('═'.repeat(60));
-
-        let totalTruncated = 0;
-        let anyDepthLimited = false;
-
-        lines.push(`\nIMPORTS (what this file depends on): ${importCount} files`);
-        if (importCount > 0) {
-            const r = printTree(graph.imports.nodes, graph.imports.edges, graph.root);
-            totalTruncated += r.truncatedNodes;
-            anyDepthLimited = anyDepthLimited || r.depthLimited;
-        } else {
-            lines.push('  (none)');
-        }
-
-        lines.push(`\nIMPORTERS (what depends on this file): ${importerCount} files`);
-        if (importerCount > 0) {
-            const r = printTree(graph.importers.nodes, graph.importers.edges, graph.root);
-            totalTruncated += r.truncatedNodes;
-            anyDepthLimited = anyDepthLimited || r.depthLimited;
-        } else {
-            lines.push('  (none)');
-        }
-
-        if (anyDepthLimited || totalTruncated > 0) {
-            lines.push('\n' + '─'.repeat(60));
-            if (anyDepthLimited) {
-                const depthHint = options.depthHint || `Use --depth=N for deeper graph.`;
-                lines.push(`Depth limited to ${maxDepth}. ${depthHint}`);
-            }
-            if (totalTruncated > 0) {
-                const allHint = options.allHint || 'Use --all to show all children.';
-                lines.push(`${totalTruncated} nodes hidden. ${allHint}`);
-            }
-        }
-    } else {
-        lines.push(`Dependency graph for ${rootRelPath}`);
-        lines.push('═'.repeat(60));
-
-        const { truncatedNodes, depthLimited } = printTree(graph.nodes, graph.edges, graph.root);
-
-        if (depthLimited || truncatedNodes > 0) {
-            lines.push('\n' + '─'.repeat(60));
-            if (depthLimited) {
-                const depthHint = options.depthHint || `Use --depth=N for deeper graph.`;
-                lines.push(`Depth limited to ${maxDepth}. ${depthHint}`);
-            }
-            if (truncatedNodes > 0) {
-                const allHint = options.allHint || 'Use --all to show all children.';
-                lines.push(`${truncatedNodes} nodes hidden. ${allHint} Graph has ${graph.nodes.length} total files.`);
-            }
-        }
-    }
-
-    return lines.join('\n');
-}
-
-function formatCircularDeps(result) {
-    if (!result) return 'No results.';
-    const lines = [];
-
-    lines.push('Circular dependencies');
-    lines.push('═'.repeat(60));
-
-    if (result.fileFilter) {
-        lines.push(`Filtered to cycles involving: ${result.fileFilter}`);
-    }
-
-    const scannedCount = result.filesWithImports != null ? result.filesWithImports : result.totalFiles;
-
-    if (result.cycles.length === 0) {
-        lines.push('');
-        lines.push('No circular dependencies found.');
-        lines.push(`Scanned ${scannedCount} files with import relationships.`);
-        return lines.join('\n');
-    }
-
-    for (let i = 0; i < result.cycles.length; i++) {
-        const cycle = result.cycles[i];
-        lines.push('');
-        lines.push(`Cycle ${i + 1} (${cycle.length} files):`);
-        lines.push(`  ${cycle.files.join(' → ')} → ${cycle.files[0]}`);
-    }
-
-    lines.push('');
-    const { totalCycles, filesInCycles } = result.summary;
-    lines.push(`Summary: ${totalCycles} circular dependency chain${totalCycles !== 1 ? 's' : ''} involving ${filesInCycles} file${filesInCycles !== 1 ? 's' : ''} (${scannedCount} files with imports scanned).`);
-
-    return lines.join('\n');
-}
-
-function formatCircularDepsJson(result) {
-    if (!result) return JSON.stringify({ error: 'No results' }, null, 2);
-    return JSON.stringify(result, null, 2);
-}
-
-/**
- * Detect common double-escaping patterns in regex search terms.
- * When MCP/JSON transport is involved, agents often write \\.  when they mean \. (literal dot).
- * Returns a hint string if double-escaping is suspected, empty string otherwise.
- */
-function detectDoubleEscaping(term) {
-    // Look for \\. \\d \\w \\s \\b \\D \\W \\S \\B \\( \\) \\[ \\] — common double-escaped sequences
-    const doubleEscaped = term.match(/\\\\[.dDwWsSbB()\[\]*+?^${}|]/g);
-    if (!doubleEscaped) return '';
-    const examples = [...new Set(doubleEscaped)].slice(0, 3);
-    const fixed = examples.map(e => e.slice(1)); // remove one backslash
-    return `\nHint: Pattern contains ${examples.join(', ')} which matches literal backslash(es). If you meant ${fixed.join(', ')}, use a single backslash (MCP/JSON parameters are already raw strings).`;
-}
-
-/**
- * Format search command output
- */
-function formatSearch(results, term) {
-    const meta = results.meta;
-    const fallbackNote = meta && meta.regexFallback
-        ? `\nNote: Invalid regex (${meta.regexFallback}). Fell back to plain text search.`
-        : '';
-
-    const totalMatches = results.reduce((sum, r) => sum + r.matches.length, 0);
-    if (totalMatches === 0) {
-        if (meta) {
-            const scope = meta.filesSkipped > 0
-                ? `Searched ${meta.filesScanned} of ${meta.totalFiles} file${meta.totalFiles === 1 ? '' : 's'} (${meta.filesSkipped} excluded by filters).`
-                : `Searched ${meta.filesScanned} file${meta.filesScanned === 1 ? '' : 's'}.`;
-            const escapingHint = detectDoubleEscaping(term);
-            return `No matches found for "${term}". ${scope}${fallbackNote}${escapingHint}`;
-        }
-        return `No matches found for "${term}"${fallbackNote}`;
-    }
-
-    const lines = [];
-    const fileWord = results.length === 1 ? 'file' : 'files';
-    lines.push(`Found ${totalMatches} match${totalMatches === 1 ? '' : 'es'} for "${term}" in ${results.length} ${fileWord}:`);
-    if (fallbackNote) lines.push(fallbackNote.trim());
-    lines.push('═'.repeat(60));
-
-    for (const result of results) {
-        lines.push(`\n${result.file}`);
-        for (const m of result.matches) {
-            if (m.before && m.before.length > 0) {
-                for (const line of m.before) {
-                    lines.push(`      ... ${line.trim()}`);
-                }
-            }
-            lines.push(`  ${m.line}: ${m.content.trim()}`);
-            if (m.after && m.after.length > 0) {
-                for (const line of m.after) {
-                    lines.push(`      ... ${line.trim()}`);
-                }
-            }
-        }
-    }
-
-    if (meta && meta.truncatedMatches > 0) {
-        lines.push(`\n${results.reduce((s, r) => s + r.matches.length, 0)} shown of ${meta.totalMatches} total matches. Use top= to see more.`);
-    }
-
-    if (meta && meta.testsExcluded && meta.filesSkipped > 0) {
-        lines.push(`\nNote: ${meta.filesSkipped} test file${meta.filesSkipped === 1 ? '' : 's'} hidden by default (use include_tests=true to include).`);
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format structural search results (index-based queries)
- */
-function formatStructuralSearch(result) {
-    const { results, meta } = result;
-    const lines = [];
-
-    // Build query description
-    const parts = [];
-    if (meta.query.type) parts.push(`type=${meta.query.type}`);
-    if (meta.query.term) parts.push(`name="${meta.query.term}"`);
-    if (meta.query.param) parts.push(`param="${meta.query.param}"`);
-    if (meta.query.receiver) parts.push(`receiver="${meta.query.receiver}"`);
-    if (meta.query.returns) parts.push(`returns="${meta.query.returns}"`);
-    if (meta.query.decorator) parts.push(`decorator="${meta.query.decorator}"`);
-    if (meta.query.exported) parts.push('exported');
-    if (meta.query.unused) parts.push('unused');
-    const queryStr = parts.join(', ');
-
-    lines.push(`Structural search: ${queryStr}`);
-    lines.push('═'.repeat(60));
-
-    if (results.length === 0) {
-        lines.push('No matches found.');
-        return lines.join('\n');
-    }
-
-    lines.push(`Found ${meta.totalMatched} match${meta.totalMatched === 1 ? '' : 'es'}${meta.shown < meta.totalMatched ? ` (showing ${meta.shown})` : ''}:`);
-    lines.push('');
-
-    // Group by file
-    let currentFile = null;
-    for (const r of results) {
-        if (r.file !== currentFile) {
-            currentFile = r.file;
-            lines.push(`${r.file}`);
-        }
-
-        if (r.kind === 'call') {
-            lines.push(`  ${r.line}: ${r.name}()${r.isMethod ? ' [method]' : ''}`);
-        } else {
-            let sig = `  ${r.line}: ${r.kind} ${r.name}`;
-            if (r.params) sig += `(${r.params})`;
-            if (r.returnType) sig += ` → ${r.returnType}`;
-            if (r.className) sig += ` [${r.className}]`;
-            if (r.decorators) sig += ` @${r.decorators.join(', @')}`;
-            lines.push(sig);
-        }
-    }
-
-    if (meta.shown < meta.totalMatched) {
-        lines.push(`\n${meta.shown} of ${meta.totalMatched} shown. Use top= to see more.`);
-    }
-
-    return lines.join('\n');
-}
-
-function formatStructuralSearchJson(result) {
-    return JSON.stringify(result, null, 2);
-}
-
-/**
- * Format file-exports command output
- */
-function formatFileExports(exports, filePath) {
-    if (exports?.error) return formatFileError(exports, filePath);
-    if (exports.length === 0) return `No exports found in ${filePath}`;
-
-    const lines = [];
-    lines.push(`Exports from ${filePath}:\n`);
-    for (const exp of exports) {
-        lines.push(`  ${lineRange(exp.startLine, exp.endLine)} ${exp.signature || exp.name}`);
-    }
-    return lines.join('\n');
-}
-
-/**
- * Format stats command output
- */
-function formatStats(stats, options = {}) {
-    const lines = [];
-    lines.push('PROJECT STATISTICS');
-    lines.push('═'.repeat(60));
-    lines.push(`Root: ${stats.root}`);
-    if (stats.truncated) {
-        lines.push(`Files: ${stats.files} (truncated at ${stats.truncated.maxFiles} — use --max-files to increase)`);
-    } else {
-        lines.push(`Files: ${stats.files}`);
-    }
-    lines.push(`Symbols: ${stats.symbols}`);
-    lines.push(`Build time: ${stats.buildTime}ms`);
-
-    lines.push('\nBy Language:');
-    for (const [lang, info] of Object.entries(stats.byLanguage)) {
-        lines.push(`  ${lang}: ${info.files} files, ${info.lines} lines, ${info.symbols} symbols`);
-    }
-
-    lines.push('\nBy Type:');
-    for (const [type, count] of Object.entries(stats.byType)) {
-        lines.push(`  ${type}: ${count}`);
-    }
-
-    if (stats.functions) {
-        const top = options.top || 30;
-        const shown = stats.functions.slice(0, top);
-        lines.push(`\nFunctions by line count (top ${shown.length} of ${stats.functions.length}):`);
-        for (const fn of shown) {
-            const loc = `${fn.file}:${fn.startLine}`;
-            lines.push(`  ${String(fn.lines).padStart(5)} lines  ${fn.name}  (${loc})`);
-        }
-        if (stats.functions.length > top) {
-            lines.push(`  ... ${stats.functions.length - top} more (use --top=N to show more)`);
-        }
-    }
-
-    return lines.join('\n');
-}
-
-// ============================================================================
-// DIFF IMPACT
-// ============================================================================
-
-function formatDiffImpact(result, options = {}) {
-    if (!result) return 'No diff data.';
-
-    const lines = [];
-    const MAX_CALLERS_PER_FN = options.all ? Infinity : 30;
-
-    lines.push(`Diff Impact Analysis (vs ${result.base})`);
-    lines.push('═'.repeat(60));
-
-    const s = result.summary || {};
-    const parts = [];
-    if (s.modifiedFunctions > 0) parts.push(`${s.modifiedFunctions} modified`);
-    if (s.deletedFunctions > 0) parts.push(`${s.deletedFunctions} deleted`);
-    if (s.newFunctions > 0) parts.push(`${s.newFunctions} new`);
-    parts.push(`${s.totalCallSites || 0} call sites across ${s.affectedFiles || 0} files`);
-    lines.push(parts.join(', '));
-    lines.push('');
-
-    // Modified functions
-    if (result.functions.length > 0) {
-        lines.push('MODIFIED FUNCTIONS:');
-        for (const fn of result.functions) {
-            lines.push(`\n  ${fn.name}`);
-            lines.push(`  ${fn.relativePath}:${fn.startLine}`);
-            lines.push(`  ${fn.signature}`);
-            if (fn.addedLines.length > 0) {
-                lines.push(`  Lines added: ${formatLineRanges(fn.addedLines)}`);
-            }
-            if (fn.deletedLines.length > 0) {
-                lines.push(`  Lines deleted: ${formatLineRanges(fn.deletedLines)}`);
-            }
-
-            if (fn.callers.length > 0) {
-                const displayCallers = fn.callers.slice(0, MAX_CALLERS_PER_FN);
-                const truncated = fn.callers.length - displayCallers.length;
-                lines.push(`  Callers (${fn.callers.length}):`);
-                for (const c of displayCallers) {
-                    const caller = c.callerName ? `[${c.callerName}]` : '';
-                    lines.push(`    ${c.relativePath}:${c.line} ${caller}`);
-                    lines.push(`      ${c.content}`);
-                }
-                if (truncated > 0) {
-                    lines.push(`    ... ${truncated} more callers (use file= to scope diff to specific files, or use impact with class_name= for type-filtered results)`);
-                }
-            } else {
-                lines.push('  Callers: none found');
-            }
-        }
-    }
-
-    // New functions
-    if (result.newFunctions.length > 0) {
-        lines.push('\nNEW FUNCTIONS:');
-        for (const fn of result.newFunctions) {
-            lines.push(`  ${fn.name} — ${fn.relativePath}:${fn.startLine}`);
-            lines.push(`  ${fn.signature}`);
-        }
-    }
-
-    // Deleted functions
-    if (result.deletedFunctions.length > 0) {
-        lines.push('\nDELETED FUNCTIONS:');
-        for (const fn of result.deletedFunctions) {
-            lines.push(`  ${fn.name} — ${fn.relativePath}:${fn.startLine}`);
-        }
-    }
-
-    // Module-level changes
-    if (result.moduleLevelChanges.length > 0) {
-        lines.push('\nMODULE-LEVEL CHANGES:');
-        for (const m of result.moduleLevelChanges) {
-            const changeParts = [];
-            if (m.addedLines.length > 0) changeParts.push(`+${m.addedLines.length} lines`);
-            if (m.deletedLines.length > 0) changeParts.push(`-${m.deletedLines.length} lines`);
-            lines.push(`  ${m.relativePath}: ${changeParts.join(', ')}`);
-        }
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Compact display of line numbers, collapsing consecutive ranges
- */
-function formatLineRanges(lineNums) {
-    if (lineNums.length === 0) return '';
-    const sorted = [...lineNums].sort((a, b) => a - b);
-    const ranges = [];
-    let start = sorted[0], end = sorted[0];
-    for (let i = 1; i < sorted.length; i++) {
-        if (sorted[i] === end + 1) {
-            end = sorted[i];
-        } else {
-            ranges.push(start === end ? `${start}` : `${start}-${end}`);
-            start = end = sorted[i];
-        }
-    }
-    ranges.push(start === end ? `${start}` : `${start}-${end}`);
-    return ranges.join(', ');
-}
-
-/**
- * Format plan command output - JSON
- */
-function formatPlanJson(plan) {
-    if (!plan) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    if (!plan.found) {
-        return JSON.stringify({
-            found: false,
-            error: plan.error || `Function "${plan.function}" not found.`,
-            ...(plan.currentParams && { currentParams: plan.currentParams })
-        }, null, 2);
-    }
-    if (plan.error) {
-        return JSON.stringify({
-            found: true,
-            error: plan.error,
-            ...(plan.currentParams && { currentParams: plan.currentParams })
-        }, null, 2);
-    }
-
-    return JSON.stringify({
-        found: true,
-        function: plan.function,
-        file: plan.file,
-        startLine: plan.startLine,
-        operation: plan.operation,
-        before: { signature: plan.before.signature },
-        after: { signature: plan.after.signature },
-        totalChanges: plan.totalChanges,
-        filesAffected: plan.filesAffected,
-        changes: plan.changes.map(c => ({
-            file: c.file,
-            line: c.line,
-            expression: c.expression,
-            suggestion: c.suggestion
-        }))
-    }, null, 2);
-}
-
-/**
- * Format stack trace command output - JSON
- */
-function formatStackTraceJson(result) {
-    if (!result || result.frameCount === 0) {
-        return JSON.stringify({ frameCount: 0, frames: [] }, null, 2);
-    }
-
-    return JSON.stringify({
-        frameCount: result.frameCount,
-        frames: result.frames.map(f => ({
-            function: f.function || null,
-            file: f.file,
-            line: f.line,
-            found: !!f.found,
-            ...(f.resolvedFile && { resolvedFile: f.resolvedFile }),
-            ...(f.context && { context: f.context.map(c => ({
-                line: c.line,
-                code: c.code,
-                isCurrent: !!c.isCurrent
-            })) }),
-            ...(f.functionInfo && { functionInfo: {
-                name: f.functionInfo.name,
-                params: f.functionInfo.params || null,
-                startLine: f.functionInfo.startLine,
-                endLine: f.functionInfo.endLine
-            } }),
-            ...(f.raw && { raw: f.raw })
-        }))
-    }, null, 2);
-}
-
-/**
- * Format verify command output - JSON
- */
-function formatVerifyJson(result) {
-    if (!result) {
-        return JSON.stringify({ found: false, error: 'Function not found' }, null, 2);
-    }
-    if (!result.found) {
-        return JSON.stringify({ found: false, error: `Function "${result.function}" not found.` }, null, 2);
-    }
-
-    return JSON.stringify({
-        found: true,
-        function: result.function,
-        file: result.file,
-        startLine: result.startLine,
-        signature: result.signature,
-        expectedArgs: result.expectedArgs,
-        totalCalls: result.totalCalls,
-        valid: result.valid,
-        mismatches: result.mismatches,
-        uncertain: result.uncertain,
-        mismatchDetails: result.mismatchDetails.map(m => ({
-            file: m.file,
-            line: m.line,
-            expression: m.expression,
-            expected: m.expected,
-            actual: m.actual,
-            args: m.args || []
-        })),
-        uncertainDetails: result.uncertainDetails.map(u => ({
-            file: u.file,
-            line: u.line,
-            expression: u.expression,
-            reason: u.reason
-        }))
-    }, null, 2);
-}
-
-/**
- * Format example command output - JSON
- */
-function formatExampleJson(result, name) {
-    if (!result || !result.best) {
-        return JSON.stringify({ found: false, query: name, error: `No call examples found for "${name}"` }, null, 2);
-    }
-
-    const best = result.best;
-    return JSON.stringify({
-        found: true,
-        query: name,
-        totalCalls: result.totalCalls,
-        best: {
-            file: best.relativePath || best.file,
-            line: best.line,
-            content: best.content,
-            score: best.score,
-            reasons: best.reasons || [],
-            ...(best.before && best.before.length > 0 && { before: best.before }),
-            ...(best.after && best.after.length > 0 && { after: best.after })
-        }
-    }, null, 2);
-}
-
-/**
- * Format deadcode command output - JSON
- */
-function formatDeadcodeJson(results) {
-    return JSON.stringify({
-        count: results.length,
-        ...(results.excludedExported > 0 && { excludedExported: results.excludedExported }),
-        ...(results.excludedDecorated > 0 && { excludedDecorated: results.excludedDecorated }),
-        symbols: results.map(item => ({
-            name: item.name,
-            type: item.type,
-            file: item.file,
-            startLine: item.startLine,
-            endLine: item.endLine,
-            ...(item.isExported && { isExported: true }),
-            ...(item.decorators && item.decorators.length > 0 && { decorators: item.decorators }),
-            ...(item.annotations && item.annotations.length > 0 && { annotations: item.annotations })
-        }))
-    }, null, 2);
-}
-
-function formatDiffImpactJson(result) {
-    return JSON.stringify(result, null, 2);
-}
-
-// ============================================================================
-// Extraction command formatters (fn, class, lines)
-// ============================================================================
-
-/**
- * Format fn handler result (from execute.js).
- * Notes are NOT included — surfaces render those separately (e.g. stderr for CLI).
- * @param {{ entries: Array<{match, code}>, notes: string[] }} result
- */
-function formatFnResult(result) {
-    const parts = [];
-    for (const { match, code } of result.entries) {
-        parts.push(formatFn(match, code));
-    }
-    const separator = result.entries.length > 1 ? '\n\n' + '═'.repeat(60) + '\n\n' : '';
-    return parts.join(separator);
-}
-
-/**
- * Format fn handler result as JSON.
- */
-function formatFnResultJson(result) {
-    if (result.entries.length === 1) {
-        return formatFunctionJson(result.entries[0].match, result.entries[0].code);
-    }
-    const arr = result.entries.map(({ match, code }) => ({
-        name: match.name,
-        params: match.params,
-        paramsStructured: match.paramsStructured || [],
-        startLine: match.startLine,
-        endLine: match.endLine,
-        modifiers: match.modifiers || [],
-        ...(match.returnType && { returnType: match.returnType }),
-        ...(match.generics && { generics: match.generics }),
-        ...(match.docstring && { docstring: match.docstring }),
-        ...(match.isArrow && { isArrow: true }),
-        ...(match.isGenerator && { isGenerator: true }),
-        file: match.relativePath || match.file,
-        code,
-    }));
-    return JSON.stringify(arr, null, 2);
-}
-
-/**
- * Format class handler result (from execute.js).
- * @param {{ entries: Array<{match, code, methods?, summaryMode, truncated, totalLines, maxLines?}>, notes: string[] }} result
- */
-function formatClassResult(result) {
-    const parts = [];
-    for (const entry of result.entries) {
-        if (entry.summaryMode) {
-            // Large class summary
-            const lines = [];
-            lines.push(`${entry.match.relativePath}:${entry.match.startLine}`);
-            lines.push(`${lineRange(entry.match.startLine, entry.match.endLine)} ${formatClassSignature(entry.match)}`);
-            lines.push('\u2500'.repeat(60));
-            if (entry.methods && entry.methods.length > 0) {
-                lines.push(`\nMethods (${entry.methods.length}):`);
-                for (const m of entry.methods) {
-                    lines.push(`  ${formatFunctionSignature(m)}  [line ${m.startLine}]`);
-                }
-            }
-            lines.push(`\nClass is ${entry.totalLines} lines. Use --max-lines=N to see source, or "fn <method>" for individual methods.`);
-            parts.push(lines.join('\n'));
-        } else if (entry.truncated) {
-            parts.push(formatClass(entry.match, entry.code) + `\n\n... showing ${entry.maxLines} of ${entry.totalLines} lines`);
-        } else {
-            parts.push(formatClass(entry.match, entry.code));
-        }
-    }
-
-    return parts.join('\n\n');
-}
-
-/**
- * Format class handler result as JSON.
- */
-function formatClassResultJson(result) {
-    if (result.entries.length === 1) {
-        const entry = result.entries[0];
-        return JSON.stringify({
-            ...entry.match,
-            code: entry.code,
-            ...(entry.summaryMode && { summaryMode: true }),
-            ...(entry.methods && { methods: entry.methods }),
-            ...(entry.truncated && { truncated: true }),
-            totalLines: entry.totalLines,
-        }, null, 2);
-    }
-    const arr = result.entries.map(entry => ({
-        ...entry.match,
-        code: entry.code,
-        ...(entry.summaryMode && { summaryMode: true }),
-        ...(entry.methods && { methods: entry.methods }),
-        ...(entry.truncated && { truncated: true }),
-        totalLines: entry.totalLines,
-    }));
-    return JSON.stringify(arr, null, 2);
-}
-
-/**
- * Format lines handler result (from execute.js).
- * @param {{ relativePath: string, lines: string[], startLine: number, endLine: number }} result
- */
-function formatLines(result) {
-    const lines = [];
-    lines.push(`${result.relativePath}:${result.startLine}-${result.endLine}`);
-    lines.push('\u2500'.repeat(60));
-    for (let i = 0; i < result.lines.length; i++) {
-        lines.push(`${lineNum(result.startLine + i)} \u2502 ${result.lines[i]}`);
-    }
-    return lines.join('\n');
-}
-
-// ============================================================================
-// FIND DETAILED (moved from CLI — depth/confidence features)
-// ============================================================================
-
-/**
- * Count depth of nested generic brackets.
- */
-function countNestedGenerics(str) {
-    let maxDepth = 0;
-    let depth = 0;
-    for (const char of str) {
-        if (char === '<') {
-            depth++;
-            maxDepth = Math.max(maxDepth, depth);
-        } else if (char === '>') {
-            depth--;
-        }
-    }
-    return maxDepth;
-}
-
-/**
- * Compute confidence level for a symbol match.
- * @returns {{ level: 'high'|'medium'|'low', reasons: string[] }}
- */
-function computeConfidence(symbol) {
-    const reasons = [];
-    let score = 100;
-
-    const span = (symbol.endLine || symbol.startLine) - symbol.startLine;
-    if (span > 500) {
-        score -= 30;
-        reasons.push('very long function (>500 lines)');
-    } else if (span > 200) {
-        score -= 15;
-        reasons.push('long function (>200 lines)');
-    }
-
-    const params = Array.isArray(symbol.params) ? symbol.params : [];
-    const signature = params.map(p => p.type || '').join(' ') + (symbol.returnType || '');
-    const genericDepth = countNestedGenerics(signature);
-    if (genericDepth > 3) {
-        score -= 20;
-        reasons.push('complex nested generics');
-    } else if (genericDepth > 2) {
-        score -= 10;
-        reasons.push('nested generics');
-    }
-
-    if (symbol.file) {
-        try {
-            const stats = fs.statSync(symbol.file);
-            const sizeKB = stats.size / 1024;
-            if (sizeKB > 500) {
-                score -= 20;
-                reasons.push('very large file (>500KB)');
-            } else if (sizeKB > 200) {
-                score -= 10;
-                reasons.push('large file (>200KB)');
-            }
-        } catch (e) {
-            // Skip file size check on error
-        }
-    }
-
-    let level = 'high';
-    if (score < 50) level = 'low';
-    else if (score < 80) level = 'medium';
-
-    return { level, reasons };
-}
-
-/**
- * Format find results with depth/confidence features (detailed view).
- * Returns a string. Used by CLI and interactive mode.
+ * All formatters are split into domain files under core/output/.
+ * This file re-exports everything so consumers don't need to change.
  *
- * @param {Array} symbols - Find result array
- * @param {string} query - Original search query
- * @param {object} options - { depth, top, all }
- */
-function formatFindDetailed(symbols, query, options = {}) {
-    const { depth, top, all } = options;
-    const DEFAULT_LIMIT = 5;
-
-    if (symbols.length === 0) {
-        return `No symbols found for "${query}"`;
-    }
-
-    const lines = [];
-    const limit = all ? symbols.length : (top > 0 ? top : DEFAULT_LIMIT);
-    const showing = Math.min(limit, symbols.length);
-    const hidden = symbols.length - showing;
-
-    if (hidden > 0) {
-        lines.push(`Found ${symbols.length} match(es) for "${query}" (showing top ${showing}):`);
-    } else {
-        lines.push(`Found ${symbols.length} match(es) for "${query}":`);
-    }
-    lines.push('─'.repeat(60));
-
-    for (let i = 0; i < showing; i++) {
-        const s = symbols[i];
-        // Depth 0: just location
-        if (depth === '0') {
-            lines.push(`${s.relativePath}:${s.startLine}`);
-            continue;
-        }
-
-        // Depth 1 (default): location + signature
-        const sig = s.params !== undefined
-            ? formatFunctionSignature(s)
-            : formatClassSignature(s);
-
-        const confidence = computeConfidence(s);
-        const confStr = confidence.level !== 'high' ? ` [${confidence.level}]` : '';
-
-        lines.push(`${s.relativePath}:${s.startLine}  ${sig}${confStr}`);
-        if (s.usageCounts !== undefined) {
-            const c = s.usageCounts;
-            const parts = [];
-            if (c.calls > 0) parts.push(`${c.calls} calls`);
-            if (c.definitions > 0) parts.push(`${c.definitions} def`);
-            if (c.imports > 0) parts.push(`${c.imports} imports`);
-            if (c.references > 0) parts.push(`${c.references} refs`);
-            lines.push(`  (${c.total} usages: ${parts.join(', ')})`);
-        } else if (s.usageCount !== undefined) {
-            lines.push(`  (${s.usageCount} usages)`);
-        }
-
-        if (confidence.level !== 'high' && confidence.reasons.length > 0) {
-            lines.push(`  ⚠ ${confidence.reasons.join(', ')}`);
-        }
-
-        // Depth 2: + first 10 lines of code
-        if (depth === '2' || depth === 'full') {
-            try {
-                const content = fs.readFileSync(s.file, 'utf-8');
-                const fileLines = content.split('\n');
-                const maxLines = depth === 'full' ? (s.endLine - s.startLine + 1) : 10;
-                const endLine = Math.min(s.startLine + maxLines - 1, s.endLine);
-                lines.push('  ───');
-                for (let j = s.startLine - 1; j < endLine; j++) {
-                    lines.push(`  ${fileLines[j]}`);
-                }
-                if (depth === '2' && s.endLine > endLine) {
-                    lines.push(`  ... (${s.endLine - endLine} more lines)`);
-                }
-            } catch (e) {
-                // Skip code extraction on error
-            }
-        }
-        lines.push('');
-    }
-
-    if (hidden > 0) {
-        lines.push(`... ${hidden} more result(s). Use --all to see all, or --top=N to see more.`);
-    }
-
-    return lines.join('\n');
-}
-
-/**
- * Format lines handler result as JSON.
- */
-function formatLinesJson(result) {
-    return JSON.stringify({
-        file: result.relativePath,
-        startLine: result.startLine,
-        endLine: result.endLine,
-        lines: result.lines,
-    }, null, 2);
-}
-
-// ============================================================================
-// Entrypoints command formatters
-// ============================================================================
-
-/**
- * Format entrypoints command output (text)
- */
-function formatEntrypoints(results, options = {}) {
-    if (!results || results.length === 0) {
-        return 'No framework entry points detected.';
-    }
-
-    const lines = [];
-    lines.push(`Framework Entry Points: ${results.length} detected\n`);
-
-    // Group by type
-    const byType = new Map();
-    for (const ep of results) {
-        if (!byType.has(ep.type)) byType.set(ep.type, []);
-        byType.get(ep.type).push(ep);
-    }
-
-    const typeLabels = {
-        http: 'HTTP Routes',
-        cli: 'CLI Handlers',
-        di: 'Dependency Injection',
-        jobs: 'Job Schedulers',
-        test: 'Test Fixtures',
-        runtime: 'Runtime Entry Points',
-        ui: 'UI Handlers',
-        events: 'Event Handlers',
-    };
-
-    let itemNum = 0;
-    for (const [type, entries] of byType) {
-        const label = typeLabels[type] || type;
-        lines.push(`${label} (${entries.length}):`);
-
-        let currentFile = null;
-        for (const ep of entries) {
-            if (ep.file !== currentFile) {
-                currentFile = ep.file;
-                lines.push(`  ${ep.file}`);
-            }
-            itemNum++;
-            const evidence = ep.evidence.join(', ');
-            lines.push(`    [${itemNum}] ${ep.name} (${ep.framework}) — ${evidence}${' '.repeat(Math.max(0, 40 - ep.name.length - ep.framework.length - evidence.length))}:${ep.line}`);
-        }
-        lines.push('');
-    }
-
-    return lines.join('\n').trimEnd();
-}
-
-/**
- * Format entrypoints command output (JSON)
+ * KEY PRINCIPLE: Never truncate critical information.
+ * Full expressions, full signatures, full context.
  */
-function formatEntrypointsJson(results) {
-    return JSON.stringify({
-        meta: { total: results.length },
-        data: {
-            entrypoints: results.map(ep => ({
-                name: ep.name,
-                file: ep.file,
-                line: ep.line,
-                type: ep.type,
-                framework: ep.framework,
-                patternId: ep.patternId,
-                evidence: ep.evidence,
-                confidence: ep.confidence,
-            }))
-        }
-    }, null, 2);
-}
 
 module.exports = {
-    // Utilities
-    normalizeParams,
-    lineNum,
-    lineRange,
-    lineLoc,
-    formatFunctionSignature,
-    formatClassSignature,
-    formatMemberSignature,
-
-    // Text output
-    header,
-    subheader,
-    printUsage,
-    printDefinition,
-
-    // JSON formatters
-    formatTocJson,
-    formatSymbolJson,
-    formatUsagesJson,
-    formatContextJson,
-    formatFunctionJson,
-    formatSearchJson,
-    formatImportsJson,
-    formatStatsJson,
-    formatGraphJson,
-    formatSmartJson,
-
-    // New formatters (v2 migration)
-    formatImports,
-    formatExporters,
-    formatTypedef,
-    formatTests,
-    formatApi,
-    formatDisambiguation,
-    formatExportersJson,
-    formatTypedefJson,
-    formatTestsJson,
-    formatApiJson,
-
-    // About command
-    formatAbout,
-    formatAboutJson,
-
-    // Impact command
-    formatImpact,
-    formatImpactJson,
-
-    // Plan command
-    formatPlan,
-    formatPlanJson,
-
-    // Stack trace command
-    formatStackTrace,
-    formatStackTraceJson,
-
-    // Verify command
-    formatVerify,
-    formatVerifyJson,
-
-    // Trace command
-    formatTrace,
-    formatTraceJson,
-
-    // Blast command
-    formatBlast,
-    formatBlastJson,
-
-    // Reverse trace command
-    formatReverseTrace,
-    formatReverseTraceJson,
-
-    // Affected tests command
-    formatAffectedTests,
-    formatAffectedTestsJson,
-
-    // Related command
-    formatRelated,
-    formatRelatedJson,
-
-    // Example command
-    formatExample,
-    formatExampleJson,
-
-    // Deadcode command
-    formatDeadcodeJson,
-
-    // Shared text formatters (CLI + MCP)
-    formatToc,
-    formatFind,
-    formatUsages,
-    formatContext,
-    formatSmart,
-    formatDeadcode,
-    formatFn,
-    formatClass,
-    formatGraph,
-    formatCircularDeps,
-    formatCircularDepsJson,
-    formatSearch,
-    formatStructuralSearch,
-    formatStructuralSearchJson,
-    detectDoubleEscaping,
-    formatFileExports,
-    formatStats,
-
-    // Diff impact command
-    formatDiffImpact,
-    formatDiffImpactJson,
-
-    // Find detailed (depth/confidence)
-    formatFindDetailed,
-
-    // Extraction commands (fn, class, lines)
-    formatFnResult,
-    formatFnResultJson,
-    formatClassResult,
-    formatClassResultJson,
-    formatLines,
-    formatLinesJson,
-
-    // Entrypoints command
-    formatEntrypoints,
-    formatEntrypointsJson,
+    ...require('./output/shared'),
+    ...require('./output/tracing'),
+    ...require('./output/analysis'),
+    ...require('./output/analysis-ext'),
+    ...require('./output/find'),
+    ...require('./output/search'),
+    ...require('./output/graph'),
+    ...require('./output/extraction'),
+    ...require('./output/reporting'),
+    ...require('./output/refactoring'),
 };