smart-context-mcp 1.14.0 → 1.16.0

package/README.md

@@ -56,7 +56,7 @@ Restart your AI client. Done.
 # Check installed version
 npm list -g smart-context-mcp
 
-# Should show: smart-context-mcp@1.14.0 (or later)
+# Should show: smart-context-mcp@1.16.0 (or later)
 
 # Update to latest version
 npm update -g smart-context-mcp

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "smart-context-mcp",
   "mcpName": "io.github.Arrayo/smart-context-mcp",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "description": "MCP server that reduces agent token usage by 90% with intelligent context compression, task checkpoint persistence, and workflow-aware agent guidance.",
   "author": "Francisco Caballero Portero <fcp1978@hotmail.com>",
   "type": "module",
@@ -69,6 +69,8 @@
     "eval:context": "node ./evals/harness.js --tool=context",
     "eval:both": "node ./evals/harness.js --tool=both",
     "eval:self": "node ./evals/harness.js --root=../.. --corpus=./evals/corpus/self-tasks.json",
+    "eval:realworld": "node ./evals/realworld-eval.js",
+    "eval:realworld:json": "node ./evals/realworld-eval.js --json",
     "eval:report": "node ./evals/report.js",
     "report:metrics": "node ./scripts/report-metrics.js",
     "report:workflows": "node ./scripts/report-workflow-metrics.js",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/Arrayo/smart-context-mcp",
     "source": "github"
   },
-  "version": "1.14.0",
+  "version": "1.16.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "smart-context-mcp",
-      "version": "1.14.0",
+      "version": "1.16.0",
       "transport": {
         "type": "stdio"
       },

package/src/server.js

@@ -158,7 +158,7 @@ export const createDevctxServer = () => {
 
   server.tool(
     'smart_context',
-    'PREFERRED for multi-file tasks. Gets curated context in one call — replaces the manual search → read → read cycle. Combines search + graph expansion + selective reading. Returns relevant files with symbols and content, optimized for tokens. Options: intent, maxTokens (budget), diff (true for HEAD or branch name), detail (minimal/balanced/deep), include (content/graph/hints/symbolDetail), prefetch (true for predictive loading). Call this FIRST before individual smart_read/smart_search calls.',
+    'PREFERRED for multi-file tasks. Gets curated context in one call — replaces the manual search → read → read cycle. Combines search + graph expansion + selective reading. Primary files always include content (signatures) in balanced mode — reduces follow-up smart_read calls. Options: intent, maxTokens (budget, default 12000), diff (true for HEAD or branch name), detail (minimal/balanced/deep), include (content/graph/hints/symbolDetail), prefetch (true for predictive loading). Call this FIRST before individual smart_read/smart_search calls.',
     {
       task: z.string(),
       intent: z.enum(['implementation', 'debug', 'tests', 'config', 'docs', 'explore']).optional(),

package/src/tools/smart-context.js

@@ -196,9 +196,7 @@ export const allocateReads = (files, maxTokens, intent, detailMode = 'balanced')
 
     const mode = detailMode === 'deep'
       ? 'full'
-      : best.role === 'primary' && !tightBudget
-        ? 'outline'
-        : 'signatures';
+      : 'signatures';
 
     roleLimits[best.role]--;
     selected.push(best);
@@ -269,8 +267,7 @@ const shouldReadContentForItem = (item, payload, detailMode, includeSet, intent)
   const strongIndexSignal = hasStrongIndexSignal(payload);
 
   if (item.role === 'primary') {
-    if ((item.matchedSymbols?.length ?? 0) > 0) return false;
-    return !strongIndexSignal;
+    return true;
   }
 
   if (item.role === 'test' && intent === 'tests') {
@@ -278,6 +275,7 @@ const shouldReadContentForItem = (item, payload, detailMode, includeSet, intent)
   }
 
   if (item.role === 'dependency') {
+    if ((item.matchedSymbols?.length ?? 0) > 0) return true;
     return !strongIndexSignal && (payload.symbols?.length ?? 0) === 0;
   }
 
@@ -353,7 +351,7 @@ const DEFAULT_INCLUDE = ['content', 'graph', 'hints', 'symbolDetail'];
 export const smartContext = async ({
   task,
   intent,
-  maxTokens = 8000,
+  maxTokens = 12000,
   entryFile,
   diff,
   detail = 'balanced',
@@ -518,7 +516,7 @@ export const smartContext = async ({
           primarySeeds.unshift({ rel, absPath: abs, evidence: [{ type: 'entryFile' }] });
         }
       }
-    } catch { /* invalid path — skip */ }
+    } catch (err) { process.stderr.write(`[devctx] smart_context: entryFile "${entryFile}" skipped: ${err.message}\n`); }
   }
 
   await ensureIndexReady({ root });
@@ -549,7 +547,7 @@ export const smartContext = async ({
                 });
               }
             }
-          } catch {}
+          } catch (err) { process.stderr.write(`[devctx] smart_context: prefetch path "${predicted.path}" skipped: ${err.message}\n`); }
         }
       }
     } catch (error) {
@@ -759,7 +757,7 @@ export const smartContext = async ({
           order: idx
         }))
       });
-    } catch {}
+    } catch (err) { process.stderr.write(`[devctx] smart_context: recordContextAccess failed: ${err.message}\n`); }
   }
 
   const COVERAGE_RANK = { full: 2, partial: 1, none: 0 };

package/src/tools/smart-read/code.js

@@ -114,6 +114,18 @@ const getFunctionSignature = (statement, sourceFile) => {
   return sig.length > 120 ? `${sig.slice(0, 120)}...` : sig;
 };
 
+const getVariableFunctionSignature = (declaration, sourceFile) => {
+  const init = declaration.initializer;
+  if (!init) return null;
+  if (!ts.isArrowFunction(init) && !ts.isFunctionExpression(init)) return null;
+  const body = init.body;
+  if (!body) return null;
+  const fullText = declaration.getText(sourceFile);
+  const bodyOffset = body.getStart(sourceFile) - declaration.getStart(sourceFile);
+  const sig = fullText.slice(0, bodyOffset).replace(/\s+$/, '');
+  return sig.length > 120 ? `${sig.slice(0, 120)}...` : sig;
+};
+
 const formatTopLevelStatement = (statement, sourceFile, mode = 'outline') => {
   const exported = statement.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword) ?? false;
   const prefix = exported ? 'export ' : '';
@@ -149,6 +161,12 @@ const formatTopLevelStatement = (statement, sourceFile, mode = 'outline') => {
       : statement.declarationList.flags & ts.NodeFlags.Let
         ? 'let'
         : 'var';
+
+    if (mode === 'signatures' && statement.declarationList.declarations.length === 1) {
+      const sig = getVariableFunctionSignature(statement.declarationList.declarations[0], sourceFile);
+      if (sig) return `${prefix}${declarationKind} ${sig}`;
+    }
+
     return `${prefix}${declarationKind} ${collectVariableNames(statement.declarationList).join(', ')}`;
   }
 

package/src/tools/smart-search.js

@@ -533,7 +533,8 @@ export const smartSearch = async ({ query, cwd = '.', intent, maxFiles, _testFor
     ...(validIntent ? { intent: validIntent } : {}),
     ...(indexHits ? { indexBoosted: indexHits.size } : {}),
     totalMatches: dedupedMatches.length,
-    matchedFiles: groups.length,
+    matchedFiles: cappedGroups.length,
+    ...(groups.length > cappedGroups.length ? { totalFiles: groups.length } : {}),
     topFiles: cappedGroups.slice(0, 10).map((group) => ({ file: group.file, count: group.count, score: group.score })),
     matches: compressedText,
   };

package/src/utils/context-scoring.js

@@ -277,6 +277,7 @@ export const scorePrimarySeed = (seed, task, intent) => {
   let score = 0;
 
   for (const evidence of seed.evidence ?? []) {
+    if (evidence.type === 'entryFile') { score += 100; continue; }
     if (evidence.type !== 'searchHit') continue;
     score += Math.max(0, 40 - ((evidence.rank ?? 1) - 1) * 8);
     if (!evidence.query) continue;