ucn 3.8.9 → 3.8.11

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

@@ -184,7 +184,7 @@ ucn [target] <command> [name] [--flags]
 | `--case-sensitive` | Case-sensitive text search (default: case-insensitive) |
 | `--exact` | Exact name match only in `find`/`typedef` (no substring) |
 | `--include-uncertain` | Include ambiguous/uncertain matches in `context`/`smart`/`about` |
-| `--show-confidence` | Show confidence scores (0.0–1.0) per caller/callee edge in `context`/`about` |
+| `--no-confidence` | Hide confidence scores (shown by default) in `context`/`about` |
 | `--min-confidence=N` | Filter edges below confidence threshold (e.g., `--min-confidence=0.7` keeps only high-confidence edges) |
 | `--calls-only` | Only show call/test-case matches in `tests` (skip file-level results) |
 | `--add-param=<name>` | Add a parameter (`plan` command). Combine with `--default=<value>` |

package/cli/index.js

@@ -112,7 +112,7 @@ function parseFlags(tokens) {
         decorator: getValueFlag('--decorator'),
         exported: tokens.includes('--exported'),
         unused: tokens.includes('--unused'),
-        showConfidence: tokens.includes('--show-confidence'),
+        showConfidence: !tokens.includes('--no-confidence'),
         minConfidence: parseFloat(getValueFlag('--min-confidence') || '0') || 0,
         framework: getValueFlag('--framework'),
     };
@@ -141,7 +141,7 @@ const knownFlags = new Set([
     '--regex', '--no-regex', '--functions',
     '--max-lines', '--class-name', '--limit', '--max-files',
     '--type', '--param', '--receiver', '--returns', '--decorator', '--exported', '--unused',
-    '--show-confidence', '--min-confidence',
+    '--show-confidence', '--no-confidence', '--min-confidence',
     '--framework'
 ]);
 
@@ -1127,7 +1127,7 @@ Common Flags:
   --class-name=X      Scope to specific class (e.g., --class-name=Repository)
   --include-methods   Include method calls (obj.fn) in caller/callee analysis
   --include-uncertain Include ambiguous/uncertain matches
-  --show-confidence   Show confidence scores per caller/callee edge
+  --no-confidence     Hide confidence scores (shown by default)
   --min-confidence=N  Filter edges below confidence threshold (0.0-1.0)
   --include-exported  Include exported symbols in deadcode
   --no-regex          Force plain text search (regex is default)

package/mcp/server.js

@@ -114,12 +114,17 @@ const server = new McpServer({
 // TOOL HELPERS
 // ============================================================================
 
-const DEFAULT_OUTPUT_CHARS = 30000;  // ~7.5K tokens — safe default for AI context
+const DEFAULT_OUTPUT_CHARS = 10000;  // ~2.5K tokens — targeted commands (about, context, smart, etc.)
+const BROAD_OUTPUT_CHARS = 3000;     // ~750 tokens — broad commands where truncated listings are useless
 const MAX_OUTPUT_CHARS = 100000;     // hard ceiling even with max_chars override
 
+// Broad commands: output is project-wide, truncation means you need a filter, not more text
+const BROAD_COMMANDS = new Set(['toc', 'entrypoints', 'diff_impact', 'affected_tests', 'deadcode', 'usages']);
+
 function toolResult(text, command, maxChars) {
     if (!text) return { content: [{ type: 'text', text: '(no output)' }] };
-    const limit = Math.min(maxChars || DEFAULT_OUTPUT_CHARS, MAX_OUTPUT_CHARS);
+    const defaultLimit = BROAD_COMMANDS.has(command) ? BROAD_OUTPUT_CHARS : DEFAULT_OUTPUT_CHARS;
+    const limit = Math.min(maxChars || defaultLimit, MAX_OUTPUT_CHARS);
     if (text.length > limit) {
         const fullSize = text.length;
         const fullTokens = Math.round(fullSize / 4);
@@ -128,14 +133,15 @@ function toolResult(text, command, maxChars) {
         const lastNewline = truncated.lastIndexOf('\n');
         const cleanCut = lastNewline > limit * 0.8 ? truncated.substring(0, lastNewline) : truncated;
         // Command-specific narrowing hints
-        let narrow = 'Use file=/in=/exclude= to narrow scope.';
-        if (command === 'toc') {
-            narrow = 'Use in= to scope to a subdirectory, or detailed=false for compact view.';
-        } else if (command === 'diff_impact') {
-            narrow = 'Use file= to scope to specific files/directories.';
-        } else if (command === 'affected_tests') {
-            narrow = 'Use file= to scope, exclude= to skip patterns.';
-        }
+        const hints = {
+            toc: 'Use in= to scope to a subdirectory, or detailed=false for compact view.',
+            entrypoints: 'Use framework= to filter by framework, exclude= to skip patterns.',
+            diff_impact: 'Use file= to scope to specific files/directories.',
+            affected_tests: 'Use file= to scope, exclude= to skip patterns.',
+            deadcode: 'Use file= to scope, exclude= to skip patterns.',
+            usages: 'Use file= to scope to specific files.',
+        };
+        const narrow = hints[command] || 'Use file=/in=/exclude= to narrow scope.';
         return { content: [{ type: 'text', text: cleanCut + `\n\n... OUTPUT TRUNCATED: showing ${limit} of ${fullSize} chars. Full output would be ~${fullTokens} tokens. ${narrow} Or use all=true to see everything (warning: ~${fullTokens} tokens).` }] };
     }
     return { content: [{ type: 'text', text }] };
@@ -253,7 +259,7 @@ server.registerTool(
             include_methods: z.boolean().optional().describe('Include obj.method() calls (default: true for about/trace)'),
             include_uncertain: z.boolean().optional().describe('Include uncertain/ambiguous matches'),
             min_confidence: z.number().optional().describe('Minimum confidence threshold (0.0-1.0) to filter caller/callee edges'),
-            show_confidence: z.boolean().optional().describe('Show confidence scores and resolution evidence per edge'),
+            show_confidence: z.boolean().optional().describe('Show confidence scores per edge (default: true). Set false to hide.'),
             with_types: z.boolean().optional().describe('Include related type definitions in output'),
             detailed: z.boolean().optional().describe('Show full symbol listing per file'),
             exact: z.boolean().optional().describe('Exact name match only (no substring matching)'),
@@ -285,7 +291,7 @@ server.registerTool(
             class_name: z.string().optional().describe('Class name to scope method analysis (e.g. "MarketDataFetcher" for close)'),
             limit: z.number().optional().describe('Max results to return (default: 500). Caps find, usages, search, deadcode, api, toc --detailed.'),
             max_files: z.number().optional().describe('Max files to index (default: 10000). Use for very large codebases.'),
-            max_chars: z.number().optional().describe('Max output chars before truncation (default: 30000 ~7.5K tokens, max: 100000 ~25K tokens). Use all=true to bypass all caps, or set this for fine-grained control. Truncation message shows full size.'),
+            max_chars: z.number().optional().describe('Max output chars before truncation. Targeted commands (about, context, smart, etc.): 10K default. Broad commands (toc, entrypoints, deadcode, etc.): 3K default. Max: 100K. Use all=true to bypass all caps.'),
             // Structural search flags (search command)
             type: z.string().optional().describe('Symbol type filter for structural search: function, class, call, method, type. Triggers index-based search.'),
             param: z.string().optional().describe('Filter by parameter name or type (structural search). E.g. "Request", "ctx".'),
@@ -308,8 +314,8 @@ server.registerTool(
         // all=true bypasses both formatter caps AND char truncation (parity with CLI --all)
         const maxChars = ep.all ? MAX_OUTPUT_CHARS : ep.maxChars;
 
-        // Wrap toolResult to auto-inject maxChars from this request
-        const tr = (text, cmd) => toolResult(text, cmd, maxChars);
+        // Wrap toolResult to auto-inject command + maxChars from this request
+        const tr = (text) => toolResult(text, command, maxChars);
 
         try {
             switch (command) {
@@ -327,7 +333,7 @@ server.registerTool(
                 return tr(output.formatAbout(result, {
                     allHint: 'Repeat with all=true to show all.',
                     methodsHint: 'Note: obj.method() callers/callees excluded. Use include_methods=true to include them.',
-                    showConfidence: ep.showConfidence,
+                    showConfidence: ep.showConfidence !== false,
                 }));
             }
 
@@ -337,7 +343,7 @@ server.registerTool(
                 if (!ok) return tr(error); // context uses soft error (not toolError)
                 const { text, expandable } = output.formatContext(ctx, {
                     expandHint: 'Use expand command with item number to see code for any item.',
-                    showConfidence: ep.showConfidence,
+                    showConfidence: ep.showConfidence !== false,
                 });
                 expandCacheInstance.save(index.root, ep.name, ep.file, expandable);
                 return tr(text);
@@ -432,7 +438,7 @@ server.registerTool(
                     topHint: 'Set top=N or use detailed=false for compact view.'
                 });
                 if (note) text += '\n\n' + note;
-                return tr(text, 'toc');
+                return tr(text);
             }
 
             case 'search': {
@@ -456,7 +462,7 @@ server.registerTool(
                 const index = getIndex(project_dir, ep);
                 const { ok, result, error } = execute(index, 'affectedTests', ep);
                 if (!ok) return tr(error);
-                return tr(output.formatAffectedTests(result, { all: ep.all }), 'affected_tests');
+                return tr(output.formatAffectedTests(result, { all: ep.all }));
             }
 
             case 'deadcode': {
@@ -542,7 +548,7 @@ server.registerTool(
                 const index = getIndex(project_dir, ep);
                 const { ok, result, error } = execute(index, 'diffImpact', ep);
                 if (!ok) return tr(error); // soft error — e.g. "not a git repo"
-                return tr(output.formatDiffImpact(result, { all: ep.all }), 'diff_impact');
+                return tr(output.formatDiffImpact(result, { all: ep.all }));
             }
 
             // ── Other ───────────────────────────────────────────────────

package/package.json

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