ucn 3.7.12 → 3.7.14

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

@@ -92,7 +92,7 @@ ucn deadcode --exclude=test         # Skip test files (most useful)
 | 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.) |
+| Regex search (default) | `ucn search '\d+'` | Search supports regex by default (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 |
@@ -127,7 +127,7 @@ 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 |
+| `--no-regex` | Force plain text search (regex is default) |
 | `--functions` | Show per-function line counts in `stats` (complexity audit) |
 
 ## Workflow Integration

package/.mcpregistry_github_token

@@ -1 +1 @@
-ghu_Jo1ldIUK4d6zLMSctdSV2Jx8UkoXa50x6epI
+ghu_k0bpQ4IVOHqywvBi3Q437S5YCpLbSA0Laxm6

package/.mcpregistry_registry_token

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

package/cli/index.js

@@ -83,8 +83,8 @@ const flags = {
     // Diff-impact options
     base: args.find(a => a.startsWith('--base='))?.split('=')[1] || null,
     staged: args.includes('--staged'),
-    // Regex search mode
-    regex: args.includes('--regex'),
+    // Regex search mode (default: ON; --no-regex to force plain text)
+    regex: args.includes('--no-regex') ? false : undefined,
     // Stats: per-function line counts
     functions: args.includes('--functions')
 };
@@ -106,7 +106,7 @@ const knownFlags = new Set([
     '--depth', '--direction', '--add-param', '--remove-param', '--rename-to',
     '--default', '--top', '--no-follow-symlinks',
     '--base', '--staged',
-    '--regex', '--functions'
+    '--regex', '--no-regex', '--functions'
 ]);
 
 // Handle help flag
@@ -1514,7 +1514,13 @@ function findInGlobFiles(files, name) {
 
 function searchGlobFiles(files, term) {
     const results = [];
-    const regex = flags.regex ? new RegExp(term, flags.caseSensitive ? '' : 'i') : new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
+    const useRegex = flags.regex !== false; // Default: regex ON
+    let regex;
+    if (useRegex) {
+        try { regex = new RegExp(term, flags.caseSensitive ? '' : 'i'); } catch (e) { regex = new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i'); }
+    } else {
+        regex = new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
+    }
 
     for (const file of files) {
         try {
@@ -1565,7 +1571,13 @@ function searchGlobFiles(files, term) {
 // ============================================================================
 
 function searchFile(filePath, lines, term) {
-    const regex = flags.regex ? new RegExp(term, flags.caseSensitive ? '' : 'i') : new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
+    const useRegex = flags.regex !== false;
+    let regex;
+    if (useRegex) {
+        try { regex = new RegExp(term, flags.caseSensitive ? '' : 'i'); } catch (e) { regex = new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i'); }
+    } else {
+        regex = new RegExp(escapeRegExp(term), flags.caseSensitive ? '' : 'i');
+    }
     const matches = [];
 
     lines.forEach((line, idx) => {
@@ -1694,7 +1706,7 @@ FIND CODE
   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 (--context=N, --exclude=, --in=, --regex)
+  search <term>       Text search (regex default, --context=N, --exclude=, --in=)
   tests <name>        Find test files for a function
 
 ═══════════════════════════════════════════════════════════════════════════════
@@ -1747,7 +1759,7 @@ 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
+  --no-regex          Force plain text search (regex is default)
   --functions         Show per-function line counts (stats command)
   --include-decorated Include decorated/annotated symbols in deadcode
   --exact             Exact name match only (find)
@@ -1908,7 +1920,7 @@ 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'),
+        regex: tokens.includes('--no-regex') ? false : undefined,
         functions: tokens.includes('--functions'),
     };
 }

package/core/output.js

@@ -1924,20 +1924,25 @@ function formatGraph(graph, options = {}) {
  * 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) {
-        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}". ${scope}${fallbackNote}`;
         }
-        return `No matches found for "${term}"`;
+        return `No matches found for "${term}"${fallbackNote}`;
     }
 
     const lines = [];
     lines.push(`Found ${totalMatches} matches for "${term}" in ${results.length} files:`);
+    if (fallbackNote) lines.push(fallbackNote.trim());
     lines.push('═'.repeat(60));
 
     for (const result of results) {

package/core/project.js

@@ -4442,7 +4442,20 @@ class ProjectIndex {
         let filesScanned = 0;
         let filesSkipped = 0;
         const regexFlags = options.caseSensitive ? 'g' : 'gi';
-        const regex = options.regex ? new RegExp(term, regexFlags) : new RegExp(escapeRegExp(term), regexFlags);
+        const useRegex = options.regex !== false; // Default: regex ON
+        let regex;
+        let regexFallback = false;
+        if (useRegex) {
+            try {
+                regex = new RegExp(term, regexFlags);
+            } catch (e) {
+                // Invalid regex — fall back to plain text
+                regex = new RegExp(escapeRegExp(term), regexFlags);
+                regexFallback = e.message;
+            }
+        } else {
+            regex = new RegExp(escapeRegExp(term), regexFlags);
+        }
 
         for (const [filePath, fileEntry] of this.files) {
             // Apply exclude/in filters
@@ -4465,7 +4478,7 @@ class ProjectIndex {
                         try {
                             const parser = getParser(language);
                             const { findMatchesWithASTFilter } = require('../languages/utils');
-                            const astMatches = findMatchesWithASTFilter(content, term, parser, { codeOnly: true, regex: options.regex });
+                            const astMatches = findMatchesWithASTFilter(content, term, parser, { codeOnly: true, regex: useRegex });
 
                             for (const m of astMatches) {
                                 const match = {
@@ -4545,7 +4558,7 @@ class ProjectIndex {
             }
         }
 
-        results.meta = { filesScanned, filesSkipped, totalFiles: this.files.size };
+        results.meta = { filesScanned, filesSkipped, totalFiles: this.files.size, regexFallback };
         return results;
         } finally { this._endOp(); }
     }

package/languages/utils.js

@@ -417,8 +417,13 @@ function findMatchesWithASTFilter(content, term, parser, options = {}) {
     const lines = content.split('\n');
     const matches = [];
 
-    // 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');
+    // Default: regex mode ON. Use raw pattern unless regex=false.
+    let regex;
+    if (options.regex !== false) {
+        try { regex = new RegExp(term, 'gi'); } catch (e) { regex = new RegExp(term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi'); }
+    } else {
+        regex = new RegExp(term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
+    }
 
     lines.forEach((line, idx) => {
         const lineNum = idx + 1;

package/mcp/server.js

@@ -196,7 +196,7 @@ FINDING CODE:
 - 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>: 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").
+- search <term>: Text search (like grep, respects .gitignore). Supports regex by default (e.g. "\\d+" or "foo|bar"). Supports context=N for surrounding lines, exclude/in for file filtering. Case-insensitive by default; set case_sensitive=true for exact case. Invalid regex auto-falls back to plain text.
 - 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.
 
@@ -256,8 +256,8 @@ 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 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)'),
+            term: z.string().optional().describe('Search term (regex by default; set regex=false to force plain text)'),
+            regex: z.boolean().optional().describe('Treat search term as a regex pattern (default: true). Set false to force plain text escaping.'),
             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)'),
@@ -434,7 +434,7 @@ server.registerTool(
                     caseSensitive: case_sensitive || false,
                     exclude: searchExclude,
                     in: inPath || undefined,
-                    regex: regex || false
+                    regex: regex
                 });
                 return toolResult(output.formatSearch(result, term));
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ucn",
-  "version": "3.7.12",
+  "version": "3.7.14",
   "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",