ucn 3.7.9 → 3.7.11

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,9 @@ 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 |
+| 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 |

package/.mcpregistry_github_token

@@ -0,0 +1 @@
+ghu_gwrBjpCa3Gl8WuJxABQ8XOgRdbPfFf36TmIA

package/.mcpregistry_registry_token

@@ -0,0 +1 @@
+{"token":"eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJtY3AtcmVnaXN0cnkiLCJleHAiOjE3NzE3ODU4MTAsIm5iZiI6MTc3MTc4NTUxMCwiaWF0IjoxNzcxNzg1NTEwLCJhdXRoX21ldGhvZCI6ImdpdGh1Yi1hdCIsImF1dGhfbWV0aG9kX3N1YiI6Im1sZW9jYSIsInBlcm1pc3Npb25zIjpbeyJhY3Rpb24iOiJwdWJsaXNoIiwicmVzb3VyY2UiOiJpby5naXRodWIubWxlb2NhLyoifV19.DW2gbu6Lnoc43CqRsxlhrIy3CQaMxAlLykOfYP3lY08d0FHVmXhg9gUt6qt2G6ihn-G99tA6oOf8tGvxUteeBQ","expires_at":1771785810}

package/cli/index.js

@@ -901,7 +901,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('');
+                    extractFunctionFromProject(index, fnNames[i]);
+                }
+            } else {
+                extractFunctionFromProject(index, arg);
+            }
             break;
         }
 
@@ -1006,7 +1015,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 });
             printOutput(searchResults,
                 r => output.formatSearchJson(r, arg),
                 r => output.formatSearch(r, arg)
@@ -1673,16 +1683,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=)
   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
@@ -1789,7 +1799,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 +1809,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 +1817,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
@@ -1994,10 +2004,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('');
+                    extractFunctionFromProject(index, fnNames[i], iflags);
+                }
+            } else {
+                extractFunctionFromProject(index, arg, iflags);
+            }
             break;
         }
 
@@ -2085,7 +2104,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 });
             console.log(output.formatSearch(results, arg));
             break;
         }

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,7 +4433,7 @@ 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();
@@ -4422,6 +4444,12 @@ class ProjectIndex {
         const regex = 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 })) {
+                    continue;
+                }
+            }
             try {
                 const content = this._readFile(filePath);
                 const lines = content.split('\n');

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>: Plain 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.
 - 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.
@@ -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)'),
@@ -425,10 +425,13 @@ 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
                 });
                 return toolResult(output.formatSearch(result, term));
             }
@@ -465,26 +468,34 @@ 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));
+                return toolResult(parts.join('\n\n'));
             }
 
             case 'class': {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "ucn",
-  "version": "3.7.9",
+  "version": "3.7.11",
+  "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",
   "bin": {