sigmap 7.2.1 → 7.3.0

package/llms-full.txt

@@ -9,7 +9,7 @@ the files relevant to the task — cutting tokens ~97% while keeping answers
 grounded. Deterministic, offline, no embeddings or vector database. Works with
 Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 
-# Version: 7.2.1 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.3.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
 # Source: auto-generated from package.json, version.json, src/mcp/tools.js, src/config/defaults.js
 # Regenerate: npm run generate:llms   |   Validate: npm run validate:llms
 
@@ -24,7 +24,7 @@ Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 | Task success proxy | 10% | 52.2% |
 | Prompts per task | 2.84 | 1.72 (39.4% fewer) |
 | Supported languages | — | 31 |
-| MCP tools | — | 11 |
+| MCP tools | — | 12 |
 | npm runtime dependencies | — | 0 |
 
 ---
@@ -114,7 +114,7 @@ sigmap --version                         Show version
 
 ---
 
-## MCP server — 11 tools
+## MCP server — 12 tools
 
 Start with `sigmap --mcp` (stdio JSON-RPC). Configure once:
 
@@ -210,6 +210,14 @@ Recall the project decision log — recent notes left by humans or agents across
 Input:  { limit?: number }
 ```
 
+### get_callee_signatures
+
+Return the EXACT current signature(s) of named symbols (functions, classes, methods) from the index — so an agent never guesses a callee's parameter types from training memory. Call this before writing code that uses a symbol. Unknown names get a closest-match suggestion.
+
+```
+Input:  { symbols: array }
+```
+
 ---
 
 ## Configuration (gen-context.config.json)

package/llms.txt

@@ -9,7 +9,7 @@ the files relevant to the task — cutting tokens ~97% while keeping answers
 grounded. Deterministic, offline, no embeddings or vector database. Works with
 Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 
-# Version: 7.2.1 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.3.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
 # Source: auto-generated from package.json, version.json, src/mcp/tools.js, src/config/defaults.js
 # Regenerate: npm run generate:llms   |   Validate: npm run validate:llms
 
@@ -27,7 +27,7 @@ Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 - Token reduction: 97.0% average across benchmark repos
 - Task success: 52.2% vs 10% without SigMap
 - Prompts per task: 1.72 vs 2.84 baseline (39.4% fewer)
-- Languages: 31 supported · MCP tools: 11
+- Languages: 31 supported · MCP tools: 12
 - Dependencies: zero npm runtime dependencies · fully offline
 
 ## Quick start

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap",
-  "version": "7.2.1",
+  "version": "7.3.0",
   "description": "97% token reduction for AI coding. Extracts function & class signatures with TF-IDF ranking to feed only the right files to Claude, Cursor, Copilot, Aider, Windsurf, local LLMs & MCP. Zero dependencies, runs offline via npx.",
   "main": "packages/core/index.js",
   "exports": {

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-cli",
-  "version": "7.2.1",
+  "version": "7.3.0",
   "description": "SigMap CLI wrapper — thin adapter for programmatic CLI invocation",
   "main": "index.js",
   "keywords": [

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-core",
-  "version": "7.2.1",
+  "version": "7.3.0",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [

package/src/mcp/handlers.js

@@ -543,4 +543,57 @@ function readMemory(args, cwd) {
   return out.join('\n');
 }
 
-module.exports = { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact, getLines, readMemory };
+/**
+ * get_callee_signatures — return the exact defining signature(s) of named
+ * symbols from the index, so an agent never guesses a callee's parameter types.
+ * Unknown names get a closest-match suggestion.
+ * @param {{symbols:string[]}} args
+ * @param {string} cwd
+ */
+function getCalleeSignatures(args, cwd) {
+  const symbols = args && Array.isArray(args.symbols)
+    ? args.symbols.map((s) => String(s).trim()).filter(Boolean)
+    : null;
+  if (!symbols || symbols.length === 0) {
+    return 'Missing required argument: symbols (non-empty string[])';
+  }
+
+  try {
+    const { buildSigIndex } = require('../retrieval/ranker');
+    const { buildSymbolCandidates, closestMatch, formatSuggestion } = require('../verify/closest-match');
+    const index = buildSigIndex(cwd);
+    if (index.size === 0) return 'No context file found. Run: node gen-context.js';
+
+    // Extract the defining symbol name from a signature line (same rules as
+    // buildSymbolCandidates) so we match definitions, not param occurrences.
+    const defName = (sig) => {
+      const cleaned = String(sig).replace(/\s*:\d+(?:-\d+)?\s*$/, '');
+      const m = cleaned.match(/\b(?:async\s+function|function|class|def|interface|type|enum|const|let|var)\s+([A-Za-z_$][\w$]*)/)
+        || cleaned.match(/([A-Za-z_$][\w$]*)\s*\(/);
+      return m ? m[1] : null;
+    };
+
+    const candidates = buildSymbolCandidates(index);
+    const blocks = [];
+    for (const symbol of symbols) {
+      const matches = [];
+      for (const [file, sigs] of index.entries()) {
+        for (const sig of sigs) {
+          if (defName(sig) === symbol) matches.push(`${sig}    (${file})`);
+        }
+      }
+      if (matches.length === 0) {
+        const cm = closestMatch(symbol, candidates);
+        const hint = cm ? ' — ' + formatSuggestion(cm) : '';
+        blocks.push(`### ${symbol}\n_not found in index${hint}_`);
+      } else {
+        blocks.push(`### ${symbol}\n${matches.join('\n')}`);
+      }
+    }
+    return blocks.join('\n\n');
+  } catch (err) {
+    return `_get_callee_signatures failed: ${err.message}_`;
+  }
+}
+
+module.exports = { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact, getLines, readMemory, getCalleeSignatures };

package/src/mcp/server.js

@@ -14,11 +14,11 @@
 
 const readline = require('readline');
 const { TOOLS } = require('./tools');
-const { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact, getLines, readMemory } = require('./handlers');
+const { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact, getLines, readMemory, getCalleeSignatures } = require('./handlers');
 
 const SERVER_INFO = {
   name: 'sigmap',
-  version: '7.2.1',
+  version: '7.3.0',
   description: 'SigMap MCP server — code signatures on demand',
 };
 
@@ -77,6 +77,7 @@ function dispatch(msg, cwd) {
       else if (name === 'get_impact') text = getImpact(args, cwd);
       else if (name === 'get_lines') text = getLines(args, cwd);
       else if (name === 'read_memory') text = readMemory(args, cwd);
+      else if (name === 'get_callee_signatures') text = getCalleeSignatures(args, cwd);
       else {
         respondError(id, -32601, `Unknown tool: ${name}`);
         return;

package/src/mcp/tools.js

@@ -1,9 +1,10 @@
 'use strict';
 
 /**
- * MCP tool definitions for SigMap (11 tools).
+ * MCP tool definitions for SigMap (12 tools).
  * read_context, search_signatures, get_map, create_checkpoint, get_routing,
- * explain_file, list_modules, query_context, get_impact, get_lines, read_memory.
+ * explain_file, list_modules, query_context, get_impact, get_lines, read_memory,
+ * get_callee_signatures.
  */
 
 const TOOLS = [
@@ -215,6 +216,25 @@ const TOOLS = [
       required: [],
     },
   },
+  {
+    name: 'get_callee_signatures',
+    description:
+      'Return the EXACT current signature(s) of named symbols (functions, classes, ' +
+      "methods) from the index — so an agent never guesses a callee's parameter types " +
+      'from training memory. Call this before writing code that uses a symbol. ' +
+      'Unknown names get a closest-match suggestion.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbols: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Symbol names to resolve (e.g. ["validateToken", "UserService"]).',
+        },
+      },
+      required: ['symbols'],
+    },
+  },
 ];
 
 module.exports = { TOOLS };