smart-context-mcp 1.15.0 → 1.16.1

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.15.0 (or later)
+# Should show: smart-context-mcp@1.16.1 (or later)
 
 # Update to latest version
 npm update -g smart-context-mcp
@@ -66,7 +66,18 @@ npm uninstall -g smart-context-mcp
 npm install -g smart-context-mcp
 ```
 
-**After updating:** Restart your AI client to load the new version.
+**After updating:** The binary is updated globally, but agent rules (`.cursorrules`, `CLAUDE.md`, `AGENTS.md`) in each project are generated from the installed version and are **not updated automatically**.
+
+Re-run init after each update to get the latest rules:
+
+```bash
+# Re-apply rules to a project after updating
+npx smart-context-init --target /path/to/your/project --clients cursor
+# or for all clients
+npx smart-context-init --target /path/to/your/project --clients all
+```
+
+Then restart your AI client to load the new version.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "smart-context-mcp",
   "mcpName": "io.github.Arrayo/smart-context-mcp",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "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/scripts/init-clients.js

@@ -414,6 +414,12 @@ Prefer devctx MCP for non-trivial tasks:
 - smart_shell instead of Shell for safe diagnostics
 - smart_turn(end, event=milestone) after meaningful progress
 
+Tool substitution rules (use devctx INSTEAD of native tools):
+- smart_search OVER Grep/SemanticSearch for any codebase exploration or "how does X work" queries
+- smart_read/smart_read_batch OVER Read when reading multiple files or large files (>200 lines) for context
+- smart_shell OVER Shell for build/test/lint/git checks
+- smart_turn(end, event=milestone) after EVERY significant code change, not just at session end
+
 If devctx MCP is installed and enabled, default to devctx on every non-trivial multi-file or multi-step task. Skip it only for genuinely trivial work, and then state why it was skipped.
 
 Client contract:

package/server.json

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

package/src/tools/smart-context.js

@@ -275,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;
   }
 

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,
   };