ucn 3.8.25 → 3.8.26

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

@@ -71,6 +71,8 @@ ucn trace generate_report --all      # all children at default depth
 
 Shows the entire pipeline — what `generate_report` calls, what those functions call, etc. — as an indented tree. No file reading needed. Invaluable for understanding orchestrator functions or entry points.
 
+**Prefer `trace` over chained `about` calls.** If you find yourself running `ucn about` 4–5 times in a row to follow a call chain (entry → leaves), one `ucn trace <fn> --depth=N` returns the same information in a single call. Use `--depth=N` to limit how deep the tree goes.
+
 ### 5. `fn` / `class` — Extract without reading the whole file
 
 Pull one or more functions out of a large file. Supports comma-separated names for bulk extraction.
@@ -161,7 +163,7 @@ ucn entrypoints --exclude-tests          # Hide test fixtures (JUnit @Test, pyte
 | Project complexity stats | `ucn stats` | File counts, symbol counts, lines by language. `--functions` for per-function line counts. `--hot --top=N` for the most-called functions (orientation primitive on a new repo) |
 | 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 (default) | `ucn search '\d+'` | Search supports regex by default (alternation, character classes, etc.) |
+| Regex search (default) | `ucn search '\d+'` | JavaScript regex (V8 engine). See "Regex notes" below for syntax — alternation is `a|b`, not grep-style |
 | Text search filtered | `ucn search term --exclude=test` | Search only in matching files |
 | Structural search (index) | `ucn search --type=function --param=Request` | Query the symbol table, not text. Finds functions by param, return type, decorator, etc. |
 | Find all db.* calls | `ucn search --type=call --receiver=db` | Search call sites by receiver — something grep can't do |
@@ -187,6 +189,16 @@ ucn entrypoints --exclude-tests          # Hide test fixtures (JUnit @Test, pyte
 | Pre-commit summary | `ucn check [--base=main]` | Changed funcs + signature drift + affected tests in one shot |
 | Find missing-await bugs | `ucn audit-async` | Lists async calls inside async functions that lack `await`. JS/TS/Python only. Filter with `--file`, `--exclude`, `--limit` |
 
+## Regex Notes (`search` command)
+
+`search` uses **JavaScript regex** (the V8 engine), not grep BRE/ERE. Common gotchas:
+
+- Alternation is `a|b`, **not** `a\|b`. `ucn search "flask|fastapi|django"` works; `ucn search "flask\|fastapi\|django"` matches the literal string.
+- `(`, `[`, `{` outside character classes do **not** need escaping for literal match in most cases — but normal JS regex semantics apply (you can still escape them for clarity).
+- Wrap the pattern in single quotes so the shell does not interpret special characters (`*`, `?`, `\`, `$`, etc.).
+- Default is case-insensitive; pass `--case-sensitive` to flip.
+- `--no-regex` forces literal-string search if you need to match regex metacharacters as text without escaping.
+
 ## Reading Call-Site Patterns
 
 `verify`, `impact`, and `about` annotate call sites with structural classification flags. Watch for these in summary lines (`Patterns: 4 in try, 4 in callback`) and per-call-site entries:

package/core/bridge.js

@@ -86,11 +86,6 @@ function joinRoutePath(prefix, sub) {
     return p + '/' + s;
 }
 
-/** True if `s` ends with the wildcard sentinel from a template literal. */
-function endsWithWildcard(s) {
-    return typeof s === 'string' && s.endsWith('*');
-}
-
 // ============================================================================
 // FRAMEWORK PATTERNS
 // ============================================================================
@@ -253,17 +248,6 @@ const PREFIX_ANNOTATIONS = new Set([
     'Path',           // JAX-RS class-level @Path("/api")
 ]);
 
-// Python decorator name patterns (e.g., 'app.route' or 'app.get')
-// Returns { method, isPrefix } when matched.
-function parsePythonDecorator(name) {
-    if (typeof name !== 'string') return null;
-    const m = name.match(/^[A-Za-z_][A-Za-z0-9_]*\.(route|get|post|put|delete|patch|options|head)/i);
-    if (!m) return null;
-    const verb = m[1].toLowerCase();
-    if (verb === 'route') return { method: 'ALL', isRoute: true };
-    return { method: verb.toUpperCase() };
-}
-
 // ============================================================================
 // EXTRACT SERVER ROUTES
 // ============================================================================

package/core/search.js

@@ -1402,48 +1402,6 @@ function _addTestCaseMatches(index, filePath, fileEntry, searchTerm, className,
     }
 }
 
-/**
- * Check if a test body references the target class (directly or via instance variable).
- * Looks at AST usages of className within the test function's line range.
- */
-function _testBodyReferencesClass(index, filePath, fileEntry, testLine, className, instanceTypeMap) {
-    // Find the enclosing test function to get its line range
-    const enclosing = index.findEnclosingFunction(filePath, testLine, true);
-    let startLine, endLine;
-    if (enclosing) {
-        startLine = enclosing.startLine;
-        endLine = enclosing.endLine;
-    } else {
-        // No enclosing function found (common for JS/TS it/test callbacks which
-        // aren't in the symbol table). Estimate range from file content.
-        startLine = testLine;
-        endLine = _estimateTestBlockEnd(index, filePath, testLine);
-    }
-
-    // Check if className appears as AST usage in the range
-    const classUsages = index._getCachedUsages(filePath, className);
-    if (classUsages) {
-        for (const u of classUsages) {
-            if (u.line >= startLine && u.line <= endLine) return true;
-        }
-    }
-
-    // Check if any instance variable bound to className is used in the range
-    if (instanceTypeMap) {
-        for (const [varName, cls] of instanceTypeMap) {
-            if (cls !== className) continue;
-            const varUsages = index._getCachedUsages(filePath, varName);
-            if (varUsages) {
-                for (const u of varUsages) {
-                    if (u.line >= startLine && u.line <= endLine) return true;
-                }
-            }
-        }
-    }
-
-    return false;
-}
-
 /**
  * Estimate the end line of a test block (it/test/describe callback) by tracking
  * brace nesting from the start line.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ucn",
-  "version": "3.8.25",
+  "version": "3.8.26",
   "mcpName": "io.github.mleoca/ucn",
   "description": "Code intelligence toolkit for AI agents — extract functions, trace call chains, find callers, detect dead code without reading entire files. Works as MCP server, CLI, or agent skill. Supports JS/TS, Python, Go, Rust, Java.",
   "main": "index.js",