ucn 3.7.10 → 3.7.12

package/.claude/skills/ucn/SKILL.md

@@ -63,10 +63,11 @@ Shows the entire pipeline — what `generate_report` calls, what those functions
 
 ### 4. `fn` / `class` — Extract without reading the whole file
 
-Pull one function or class out of a large file. Saves hundreds of lines of context window.
+Pull one or more functions out of a large file. Supports comma-separated names for bulk extraction.
 
 ```bash
 ucn fn handle_request --file=api    # --file disambiguates when name exists in multiple files
+ucn fn parse,format,validate        # Extract multiple functions in one call
 ucn class MarketDataFetcher
 ```
 
@@ -89,6 +90,10 @@ ucn deadcode --exclude=test         # Skip test files (most useful)
 | Understanding a file's role in the project | `ucn imports <file>` | What it depends on |
 | Understanding who depends on a file | `ucn exporters <file>` | Which files import it |
 | Quick project overview | `ucn toc` | Every file with function/class counts and line counts |
+| Find by glob pattern | `ucn find "handle*"` | Locate definitions matching a glob (supports * and ?) |
+| Text search with context | `ucn search term --context=3` | Like grep -C 3, shows surrounding lines |
+| Regex search | `ucn search '\d+' --regex` | Search with regex patterns (alternation, character classes, etc.) |
+| Text search filtered | `ucn search term --exclude=test` | Search only in matching files |
 | Finding all usages (not just calls) | `ucn usages <name>` | Groups into: definitions, calls, imports, type references |
 | Finding sibling/related functions | `ucn related <name>` | Name-based + structural matching (same file, shared deps). Not semantic — best for parse/format pairs |
 | Preview a rename or param change | `ucn plan <name> --rename-to=new_name` | Shows what would change without doing it |
@@ -122,6 +127,8 @@ ucn [target] <command> [name] [--flags]
 | `--staged` | Analyze staged changes (diff-impact) |
 | `--no-cache` | Force re-index after editing files |
 | `--context=N` | Lines of surrounding context in `usages`/`search` output |
+| `--regex` | Use search term as a regex pattern |
+| `--functions` | Show per-function line counts in `stats` (complexity audit) |
 
 ## Workflow Integration
 

package/.mcpregistry_github_token

@@ -0,0 +1 @@
+ghu_Jo1ldIUK4d6zLMSctdSV2Jx8UkoXa50x6epI

package/.mcpregistry_registry_token

@@ -0,0 +1 @@
+{"token":"eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJtY3AtcmVnaXN0cnkiLCJleHAiOjE3NzE5NjQ2MjMsIm5iZiI6MTc3MTk2NDMyMywiaWF0IjoxNzcxOTY0MzIzLCJhdXRoX21ldGhvZCI6ImdpdGh1Yi1hdCIsImF1dGhfbWV0aG9kX3N1YiI6Im1sZW9jYSIsInBlcm1pc3Npb25zIjpbeyJhY3Rpb24iOiJwdWJsaXNoIiwicmVzb3VyY2UiOiJpby5naXRodWIubWxlb2NhLyoifV19.weq7KLw5cAAB7qZpxtU45meX0nLUU1vTiHlzFB5Ecf9OTFtKM63-JSwYBXrr410pdt-7CgW6pV6aGruoIpiIBw","expires_at":1771964623}

package/cli/index.js

@@ -82,7 +82,11 @@ const flags = {
     followSymlinks: !args.includes('--no-follow-symlinks'),
     // Diff-impact options
     base: args.find(a => a.startsWith('--base='))?.split('=')[1] || null,
-    staged: args.includes('--staged')
+    staged: args.includes('--staged'),
+    // Regex search mode
+    regex: args.includes('--regex'),
+    // Stats: per-function line counts
+    functions: args.includes('--functions')
 };
 
 // Handle --file flag with space
@@ -101,7 +105,8 @@ const knownFlags = new Set([
     '--file', '--context', '--exclude', '--not', '--in',
     '--depth', '--direction', '--add-param', '--remove-param', '--rename-to',
     '--default', '--top', '--no-follow-symlinks',
-    '--base', '--staged'
+    '--base', '--staged',
+    '--regex', '--functions'
 ]);
 
 // Handle help flag
@@ -901,7 +906,16 @@ function runProjectCommand(rootDir, command, arg) {
 
         case 'fn': {
             requireArg(arg, 'Usage: ucn . fn <name>');
-            extractFunctionFromProject(index, arg);
+            // Support comma-separated names for bulk extraction
+            if (arg.includes(',')) {
+                const fnNames = arg.split(',').map(n => n.trim()).filter(Boolean);
+                for (let i = 0; i < fnNames.length; i++) {
+                    if (i > 0) console.log('\n' + '═'.repeat(60) + '\n');
+                    extractFunctionFromProject(index, fnNames[i]);
+                }
+            } else {
+                extractFunctionFromProject(index, arg);
+            }
             break;
         }
 
@@ -1006,7 +1020,8 @@ function runProjectCommand(rootDir, command, arg) {
 
         case 'search': {
             requireArg(arg, 'Usage: ucn . search <term>');
-            const searchResults = index.search(arg, { codeOnly: flags.codeOnly, context: flags.context, caseSensitive: flags.caseSensitive });
+            const searchExclude = flags.includeTests ? flags.exclude : addTestExclusions(flags.exclude);
+            const searchResults = index.search(arg, { codeOnly: flags.codeOnly, context: flags.context, caseSensitive: flags.caseSensitive, exclude: searchExclude, in: flags.in, regex: flags.regex });
             printOutput(searchResults,
                 r => output.formatSearchJson(r, arg),
                 r => output.formatSearch(r, arg)
@@ -1030,8 +1045,11 @@ function runProjectCommand(rootDir, command, arg) {
         }
 
         case 'stats': {
-            const stats = index.getStats();
-            printOutput(stats, output.formatStatsJson, output.formatStats);
+            const stats = index.getStats({ functions: flags.functions });
+            printOutput(stats,
+                output.formatStatsJson,
+                r => output.formatStats(r, { top: flags.top })
+            );
             break;
         }
 
@@ -1496,7 +1514,7 @@ function findInGlobFiles(files, name) {
 
 function searchGlobFiles(files, term) {
     const results = [];
-    const regex = new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
+    const regex = flags.regex ? new RegExp(term, flags.caseSensitive ? '' : 'i') : new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
 
     for (const file of files) {
         try {
@@ -1547,7 +1565,7 @@ function searchGlobFiles(files, term) {
 // ============================================================================
 
 function searchFile(filePath, lines, term) {
-    const regex = new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
+    const regex = flags.regex ? new RegExp(term, flags.caseSensitive ? '' : 'i') : new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
     const matches = [];
 
     lines.forEach((line, idx) => {
@@ -1673,16 +1691,16 @@ UNDERSTAND CODE (UCN's strength - semantic analysis)
 ═══════════════════════════════════════════════════════════════════════════════
 FIND CODE
 ═══════════════════════════════════════════════════════════════════════════════
-  find <name>         Find symbol definitions (top 5 by usage count)
+  find <name>         Find symbol definitions (supports glob: find "handle*")
   usages <name>       All usages grouped: definitions, calls, imports, references
   toc                 Table of contents (compact; --detailed lists all symbols)
-  search <term>       Text search (for simple patterns, consider grep instead)
+  search <term>       Text search (--context=N, --exclude=, --in=, --regex)
   tests <name>        Find test files for a function
 
 ═══════════════════════════════════════════════════════════════════════════════
 EXTRACT CODE
 ═══════════════════════════════════════════════════════════════════════════════
-  fn <name>           Extract function (--file to disambiguate)
+  fn <name>[,n2,...]  Extract function(s) (comma-separated for bulk, --file)
   class <name>        Extract class
   lines <range>       Extract line range (e.g., lines 50-100)
   expand <N>          Show code for item N from context output
@@ -1709,7 +1727,7 @@ OTHER
 ═══════════════════════════════════════════════════════════════════════════════
   api                 Show exported/public symbols
   typedef <name>      Find type definitions
-  stats               Project statistics
+  stats               Project statistics (--functions for per-function line counts)
   stacktrace <text>   Parse stack trace, show code at each frame (alias: stack)
   example <name>      Best usage example with context
 
@@ -1729,6 +1747,8 @@ Common Flags:
   --include-methods   Include method calls (obj.fn) in caller/callee analysis
   --include-uncertain Include ambiguous/uncertain matches
   --include-exported  Include exported symbols in deadcode
+  --regex             Use search term as a regex pattern
+  --functions         Show per-function line counts (stats command)
   --include-decorated Include decorated/annotated symbols in deadcode
   --exact             Exact name match only (find)
   --calls-only        Only show call/test-case matches (tests)
@@ -1789,7 +1809,7 @@ function runInteractive(rootDir) {
             console.log(`
 Commands:
   toc                    Project overview (--detailed)
-  find <name>            Find symbol (--exact, --file=)
+  find <name>            Find symbol (--exact, glob: "handle*")
   about <name>           Everything about a symbol
   usages <name>          All usages grouped by type
   context <name>         Callers + callees
@@ -1799,7 +1819,7 @@ Commands:
   trace <name>           Call tree (--depth=N)
   example <name>         Best usage example
   related <name>         Sibling functions
-  fn <name>              Extract function code (--file=)
+  fn <name>[,n2,...]     Extract function(s) (--file=)
   class <name>           Extract class code (--file=)
   lines <range>          Extract lines (--file= required)
   graph <file>           File dependency tree (--direction=, --depth=)
@@ -1807,7 +1827,7 @@ Commands:
   imports <file>         What file imports
   exporters <file>       Who imports file
   tests <name>           Find tests (--calls-only)
-  search <term>          Text search (--code-only, --case-sensitive)
+  search <term>          Text search (--context=N, --exclude=, --in=)
   typedef <name>         Find type definitions
   deadcode               Find unused functions/classes
   verify <name>          Check call sites match signature
@@ -1888,6 +1908,8 @@ function parseInteractiveFlags(tokens) {
         base: tokens.find(a => a.startsWith('--base='))?.split('=')[1] || null,
         staged: tokens.includes('--staged'),
         maxLines: parseInt(tokens.find(a => a.startsWith('--max-lines='))?.split('=')[1] || '0') || null,
+        regex: tokens.includes('--regex'),
+        functions: tokens.includes('--functions'),
     };
 }
 
@@ -1994,10 +2016,19 @@ function executeInteractiveCommand(index, command, arg, iflags = {}) {
 
         case 'fn': {
             if (!arg) {
-                console.log('Usage: fn <name> [--file=<pattern>]');
+                console.log('Usage: fn <name>[,name2,...] [--file=<pattern>]');
                 return;
             }
-            extractFunctionFromProject(index, arg, iflags);
+            // Support comma-separated names for bulk extraction
+            if (arg.includes(',')) {
+                const fnNames = arg.split(',').map(n => n.trim()).filter(Boolean);
+                for (let i = 0; i < fnNames.length; i++) {
+                    if (i > 0) console.log('\n' + '═'.repeat(60) + '\n');
+                    extractFunctionFromProject(index, fnNames[i], iflags);
+                }
+            } else {
+                extractFunctionFromProject(index, arg, iflags);
+            }
             break;
         }
 
@@ -2085,7 +2116,7 @@ function executeInteractiveCommand(index, command, arg, iflags = {}) {
                 console.log('Usage: search <term>');
                 return;
             }
-            const results = index.search(arg, { codeOnly: iflags.codeOnly, caseSensitive: iflags.caseSensitive, context: iflags.context });
+            const results = index.search(arg, { codeOnly: iflags.codeOnly, caseSensitive: iflags.caseSensitive, context: iflags.context, exclude: iflags.exclude, in: iflags.in, regex: iflags.regex });
             console.log(output.formatSearch(results, arg));
             break;
         }
@@ -2117,8 +2148,8 @@ function executeInteractiveCommand(index, command, arg, iflags = {}) {
         }
 
         case 'stats': {
-            const stats = index.getStats();
-            console.log(output.formatStats(stats));
+            const stats = index.getStats({ functions: iflags.functions });
+            console.log(output.formatStats(stats, { top: iflags.top }));
             break;
         }
 

package/core/output.js

@@ -1925,7 +1925,16 @@ function formatGraph(graph, options = {}) {
  */
 function formatSearch(results, term) {
     const totalMatches = results.reduce((sum, r) => sum + r.matches.length, 0);
-    if (totalMatches === 0) return `No matches found for "${term}"`;
+    if (totalMatches === 0) {
+        const meta = results.meta;
+        if (meta) {
+            const scope = meta.filesSkipped > 0
+                ? `Searched ${meta.filesScanned} of ${meta.totalFiles} files (${meta.filesSkipped} excluded by filters).`
+                : `Searched ${meta.filesScanned} files.`;
+            return `No matches found for "${term}". ${scope}`;
+        }
+        return `No matches found for "${term}"`;
+    }
 
     const lines = [];
     lines.push(`Found ${totalMatches} matches for "${term}" in ${results.length} files:`);
@@ -1969,7 +1978,7 @@ function formatFileExports(exports, filePath) {
 /**
  * Format stats command output
  */
-function formatStats(stats) {
+function formatStats(stats, options = {}) {
     const lines = [];
     lines.push('PROJECT STATISTICS');
     lines.push('═'.repeat(60));
@@ -1988,6 +1997,19 @@ function formatStats(stats) {
         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');
 }
 

package/core/project.js

@@ -687,6 +687,22 @@ class ProjectIndex {
     }
 
     find(name, options = {}) {
+        // Glob pattern matching (e.g., _update*, handle*Request, get?ata)
+        const isGlob = name.includes('*') || name.includes('?');
+        if (isGlob && !options.exact) {
+            const globRegex = new RegExp('^' + name.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*').replace(/\?/g, '.') + '$', 'i');
+            const matches = [];
+            for (const [symName, symbols] of this.symbols) {
+                if (globRegex.test(symName)) {
+                    for (const sym of symbols) {
+                        matches.push({ ...sym, _fuzzyScore: 800 });
+                    }
+                }
+            }
+            matches.sort((a, b) => (a.name || '').localeCompare(b.name || ''));
+            return this._applyFindFilters(matches, options);
+        }
+
         const matches = this.symbols.get(name) || [];
 
         if (matches.length === 0 && !options.exact) {
@@ -705,7 +721,13 @@ class ProjectIndex {
             matches.push(...candidates);
         }
 
-        // Apply filters
+        return this._applyFindFilters(matches, options);
+    }
+
+    /**
+     * Apply file/exclude/in filters and usage counts to find results
+     */
+    _applyFindFilters(matches, options) {
         let filtered = matches;
 
         // Filter by file pattern
@@ -4411,17 +4433,26 @@ class ProjectIndex {
     /**
      * Search for text across the project
      * @param {string} term - Search term
-     * @param {object} options - { codeOnly, context }
+     * @param {object} options - { codeOnly, context, caseSensitive, exclude, in }
      */
     search(term, options = {}) {
         this._beginOp();
         try {
         const results = [];
-        // Escape the term to handle special regex characters
+        let filesScanned = 0;
+        let filesSkipped = 0;
         const regexFlags = options.caseSensitive ? 'g' : 'gi';
-        const regex = new RegExp(escapeRegExp(term), regexFlags);
+        const regex = options.regex ? new RegExp(term, regexFlags) : new RegExp(escapeRegExp(term), regexFlags);
 
         for (const [filePath, fileEntry] of this.files) {
+            // Apply exclude/in filters
+            if ((options.exclude && options.exclude.length > 0) || options.in) {
+                if (!this.matchesFilters(fileEntry.relativePath, { exclude: options.exclude, in: options.in })) {
+                    filesSkipped++;
+                    continue;
+                }
+            }
+            filesScanned++;
             try {
                 const content = this._readFile(filePath);
                 const lines = content.split('\n');
@@ -4434,7 +4465,7 @@ class ProjectIndex {
                         try {
                             const parser = getParser(language);
                             const { findMatchesWithASTFilter } = require('../languages/utils');
-                            const astMatches = findMatchesWithASTFilter(content, term, parser, { codeOnly: true });
+                            const astMatches = findMatchesWithASTFilter(content, term, parser, { codeOnly: true, regex: options.regex });
 
                             for (const m of astMatches) {
                                 const match = {
@@ -4514,6 +4545,7 @@ class ProjectIndex {
             }
         }
 
+        results.meta = { filesScanned, filesSkipped, totalFiles: this.files.size };
         return results;
         } finally { this._endOp(); }
     }
@@ -4525,7 +4557,7 @@ class ProjectIndex {
     /**
      * Get project statistics
      */
-    getStats() {
+    getStats(options = {}) {
         // Count total symbols (not just unique names)
         let totalSymbols = 0;
         for (const [name, symbols] of this.symbols) {
@@ -4560,6 +4592,27 @@ class ProjectIndex {
             }
         }
 
+        // Per-function line counts for complexity audits
+        if (options.functions) {
+            const functions = [];
+            for (const [name, symbols] of this.symbols) {
+                for (const sym of symbols) {
+                    if (sym.type === 'function' || sym.params !== undefined) {
+                        const lineCount = sym.endLine - sym.startLine + 1;
+                        const relativePath = sym.relativePath || (sym.file ? path.relative(this.root, sym.file) : '');
+                        functions.push({
+                            name: sym.className ? `${sym.className}.${sym.name}` : sym.name,
+                            file: relativePath,
+                            startLine: sym.startLine,
+                            lines: lineCount
+                        });
+                    }
+                }
+            }
+            functions.sort((a, b) => b.lines - a.lines);
+            stats.functions = functions;
+        }
+
         return stats;
     }
 

package/languages/utils.js

@@ -417,9 +417,8 @@ function findMatchesWithASTFilter(content, term, parser, options = {}) {
     const lines = content.split('\n');
     const matches = [];
 
-    // Escape special regex characters and create pattern
-    const escapedTerm = term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const regex = new RegExp(escapedTerm, 'gi');
+    // Create search pattern — use raw regex when regex mode is enabled
+    const regex = options.regex ? new RegExp(term, 'gi') : new RegExp(term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
 
     lines.forEach((line, idx) => {
         const lineNum = idx + 1;

package/mcp/server.js

@@ -193,15 +193,15 @@ UNDERSTANDING CODE:
 - related <name>: Sibling functions: same file, similar names, or shared callers/callees. Find companions to update together (e.g., serialize when you're changing deserialize). Name-based, not semantic.
 
 FINDING CODE:
-- find <name>: Locate definitions ranked by usage count. Use when you know the name but not the file.
+- find <name>: Locate definitions ranked by usage count. Supports glob patterns (e.g. find "handle*" or "_update*"). Use when you know the name but not the file.
 - usages <name>: See every usage organized by type: definitions, calls, imports, references. Complete picture of how something is used. Use code_only=true to skip comments/strings.
 - toc: Get a quick overview of a project you haven't seen before — file counts, line counts, function/class counts, entry points. Use detailed=true for full symbol listing.
-- search <term>: Plain text search (like grep, respects .gitignore). For TODOs, error messages, config keys. Search is case-insensitive by default; set case_sensitive=true for exact case.
+- search <term>: Text search (like grep, respects .gitignore). Supports context=N for surrounding lines, exclude/in for file filtering. Case-insensitive by default; set case_sensitive=true for exact case. Set regex=true to use the term as a regex pattern (e.g. "\\d+" or "foo|bar").
 - tests <name>: Find test files covering a function, test case names, and how it's called in tests. Use before modifying or to find test patterns to follow.
 - deadcode: Find dead code: functions/classes with zero callers. Use during cleanup to identify safely deletable code. Excludes exported, decorated, and test symbols by default — use include_exported/include_decorated/include_tests to expand.
 
 EXTRACTING CODE (use instead of reading entire files):
-- fn <name>: Extract one function's source. Use file to disambiguate (e.g. file="parser" for parser.js).
+- fn <name>: Extract one or more functions. Comma-separated for bulk extraction (e.g. "parse,format,validate"). Use file to disambiguate.
 - class <name>: Extract a class/struct/interface with all its methods. Handles all supported types: JS/TS, Python, Go, Rust, Java. Large classes (>200 lines) show summary; use max_lines for truncated source.
 - lines: Extract specific lines (e.g. range="10-20" or just "15"). Requires file and range. Use when you know the exact line range you need.
 - expand <item>: Drill into a numbered item from the last context result (requires running context first in the same session). Context returns numbered callers/callees — use this to see their full source code.
@@ -221,7 +221,7 @@ OTHER:
 - typedef <name>: Find type definitions matching a name: interfaces, enums, structs, traits, type aliases. See field shapes, required methods, or enum values.
 - stacktrace: Parse a stack trace, show source context per frame. Requires stack param. Handles JS, Python, Go, Rust, Java formats.
 - api: Public API surface of project or file: all exported/public symbols with signatures. Use to understand what a library exposes. Pass file to scope to one file. Python needs __all__; use toc instead.
-- stats: Quick project stats: file counts, symbol counts, lines of code by language and symbol type.`;
+- stats: Quick project stats: file counts, symbol counts, lines of code by language and symbol type. Use functions=true for per-function line counts sorted by size (complexity audit).`;
 
 server.registerTool(
     'ucn',
@@ -237,7 +237,7 @@ server.registerTool(
                 'api', 'stats', 'diff_impact', 'stacktrace'
             ]),
             project_dir: z.string().describe('Absolute or relative path to the project root directory'),
-            name: z.string().optional().describe('Symbol name to analyze (function, class, method, etc.)'),
+            name: z.string().optional().describe('Symbol name to analyze. For fn: comma-separated for bulk (e.g. "parse,format"). For find: supports glob patterns (e.g. "handle*").'),
             file: z.string().optional().describe('File path (imports/exporters/graph/file_exports/lines/api/diff_impact) or filter pattern for disambiguation (e.g. "parser", "src/core")'),
             exclude: z.string().optional().describe('Comma-separated patterns to exclude (e.g. "test,mock,vendor")'),
             include_tests: z.boolean().optional().describe('Include test files in results (excluded by default)'),
@@ -256,7 +256,9 @@ server.registerTool(
             calls_only: z.boolean().optional().describe('Only direct calls and test-case matches (tests command)'),
             max_lines: z.number().optional().describe('Max source lines for class (large classes show summary by default)'),
             direction: z.enum(['imports', 'importers', 'both']).optional().describe('Graph direction: imports (what this file uses), importers (who uses this file), both (default: both)'),
-            term: z.string().optional().describe('Search term (plain text, not regex)'),
+            term: z.string().optional().describe('Search term (plain text by default; set regex=true to use as regex pattern)'),
+            regex: z.boolean().optional().describe('Treat search term as a regex pattern (default: false, plain text)'),
+            functions: z.boolean().optional().describe('Include per-function line counts in stats output, sorted by size (complexity audit)'),
             add_param: z.string().optional().describe('Parameter name to add (plan command)'),
             remove_param: z.string().optional().describe('Parameter name to remove (plan command)'),
             rename_to: z.string().optional().describe('New function name (plan command)'),
@@ -276,7 +278,7 @@ server.registerTool(
                 include_exported, include_decorated, calls_only, max_lines,
                 direction, term, add_param, remove_param, rename_to,
                 default_value, stack, item, range, base, staged,
-                case_sensitive } = args;
+                case_sensitive, regex, functions } = args;
 
         try {
             switch (command) {
@@ -425,10 +427,14 @@ server.registerTool(
                     return toolError('Search term is required.');
                 }
                 const index = getIndex(project_dir);
+                const searchExclude = include_tests ? parseExclude(exclude) : addTestExclusions(parseExclude(exclude));
                 const result = index.search(term, {
                     codeOnly: code_only || false,
                     context: ctxLines || 0,
-                    caseSensitive: case_sensitive || false
+                    caseSensitive: case_sensitive || false,
+                    exclude: searchExclude,
+                    in: inPath || undefined,
+                    regex: regex || false
                 });
                 return toolResult(output.formatSearch(result, term));
             }
@@ -465,26 +471,35 @@ server.registerTool(
                 const err = requireName(name);
                 if (err) return err;
                 const index = getIndex(project_dir);
-                const matches = index.find(name, { file }).filter(m => m.type === 'function' || m.params !== undefined);
 
-                if (matches.length === 0) {
-                    return toolResult(`Function "${name}" not found.`);
-                }
+                // Support comma-separated names for bulk extraction
+                const fnNames = name.includes(',') ? name.split(',').map(n => n.trim()).filter(Boolean) : [name];
+                const parts = [];
 
-                const match = matches.length > 1 ? pickBestDefinition(matches) : matches[0];
-                // Validate file is within project root
-                const fnPathCheck = resolveAndValidatePath(index, match.relativePath || path.relative(index.root, match.file));
-                if (typeof fnPathCheck !== 'string') return fnPathCheck;
-                const code = fs.readFileSync(match.file, 'utf-8');
-                const codeLines = code.split('\n');
-                const fnCode = codeLines.slice(match.startLine - 1, match.endLine).join('\n');
+                for (const fnName of fnNames) {
+                    const matches = index.find(fnName, { file }).filter(m => m.type === 'function' || m.params !== undefined);
 
-                let note = '';
-                if (matches.length > 1 && !file) {
-                    note = `Note: Found ${matches.length} definitions for "${name}". Showing ${match.relativePath}:${match.startLine}. Use file parameter to disambiguate.\n\n`;
+                    if (matches.length === 0) {
+                        parts.push(`Function "${fnName}" not found.`);
+                        continue;
+                    }
+
+                    const match = matches.length > 1 ? pickBestDefinition(matches) : matches[0];
+                    const fnPathCheck = resolveAndValidatePath(index, match.relativePath || path.relative(index.root, match.file));
+                    if (typeof fnPathCheck !== 'string') return fnPathCheck;
+                    const code = fs.readFileSync(match.file, 'utf-8');
+                    const codeLines = code.split('\n');
+                    const fnCode = codeLines.slice(match.startLine - 1, match.endLine).join('\n');
+
+                    let note = '';
+                    if (matches.length > 1 && !file) {
+                        note = `Note: Found ${matches.length} definitions for "${fnName}". Showing ${match.relativePath}:${match.startLine}. Use file parameter to disambiguate.\n`;
+                    }
+                    parts.push(note + output.formatFn(match, fnCode));
                 }
 
-                return toolResult(note + output.formatFn(match, fnCode));
+                const separator = fnNames.length > 1 ? '\n\n' + '═'.repeat(60) + '\n\n' : '\n\n';
+                return toolResult(parts.join(separator));
             }
 
             case 'class': {
@@ -794,8 +809,8 @@ server.registerTool(
 
             case 'stats': {
                 const index = getIndex(project_dir);
-                const stats = index.getStats();
-                return toolResult(output.formatStats(stats));
+                const stats = index.getStats({ functions: functions || false });
+                return toolResult(output.formatStats(stats, { top: top || 30 }));
             }
 
             default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ucn",
-  "version": "3.7.10",
+  "version": "3.7.12",
   "mcpName": "io.github.mleoca/ucn",
   "description": "Universal Code Navigator — AST-based call graph analysis for AI agents. Find callers, trace impact, detect dead code across JS/TS, Python, Go, Rust, Java, and HTML. CLI, MCP server, and agent skill.",
   "main": "index.js",