sigmap 6.0.3 → 6.1.0

package/AGENTS.md

@@ -13,10 +13,25 @@ Use this marker block for all appendable context files:
 <!-- Updated by gen-context.js -->
 # Code signatures
 
-## changes (last 5 commits — 3 minutes ago)
+## SigMap commands
+
+| When | Command |
+|------|---------|
+| Before answering a question | `sigmap ask "<your question>"` |
+| After code changes | `sigmap validate` |
+| To query by topic | `sigmap --query "<topic>"` |
+
+Always run `sigmap ask` or `sigmap --query` before searching for files relevant to a task.
+## changes (last 5 commits — 31 minutes ago)
 ```
-src/extractors/typescript.js                  ~extractInterfaceMembers  ~extractClassMembers
+src/learning/weights.js                       +exportWeights  +importWeights  ~resetWeights
 packages/adapters/codex.js                    ~format
+packages/adapters/gemini.js                   ~format
+packages/adapters/copilot.js                  ~format
+packages/adapters/openai.js                   ~format
+packages/adapters/claude.js                   ~format
+packages/adapters/cursor.js                   ~format
+packages/adapters/windsurf.js                 ~format
 ```
 
 ## packages
@@ -44,39 +59,62 @@ function format(context, opts)
 function write(context, cwd, opts)
 ```
 
-### packages/adapters/claude.js
+### packages/core/README.md
 ```
-module.exports = { name, format, outputPath, write }
-function format(context, opts = {}) → string
-function _confidenceMeta(opts)
-function outputPath(cwd) → string
-function write(context, cwd, opts = {})
+h1 sigmap-core
+h2 Installation
+h2 Quick start
+h2 API reference
+h3 `extract(src, language)` → `string[]`
+h3 `rank(query, sigIndex, opts?)` → `Result[]`
+h3 `buildSigIndex(cwd)` → `Map<string, string[]>`
+h3 `scan(sigs, filePath)` → `{ safe: string[], redacted: boolean }`
+h3 `score(cwd)` → `HealthResult`
+h2 Migration from v2.3 and earlier
+h2 v3.0 — Multi-Adapter Architecture (released)
+h2 Zero dependencies
+code-fence bash
+code-fence plain
+code-fence js
+code-fence ---
 ```
 
-### packages/adapters/copilot.js
+### packages/core/index.js
+```
+module.exports = { extract, rank, buildSigIndex, scan, score, adapt }
+function _resolveExtractor(language)
+function extract(src, language) → string[]
+function rank(query, sigIndex, opts) → { file: string, score: nu
+function buildSigIndex(cwd) → Map<string, string[]>
+function scan(sigs, filePath) → { safe: string[], redacte
+function score(cwd) → { * score: number, * grad
+function adapt(context, adapterName, opts = {}) → string
+```
+
+### packages/adapters/codex.js
 ```
 module.exports = { name, format, outputPath, write }
 function format(context, opts = {}) → string
-function _confidenceMeta(opts)
 function outputPath(cwd) → string
 function write(context, cwd, opts = {})
 ```
 
-### packages/adapters/cursor.js
+### packages/adapters/gemini.js
 ```
-module.exports = { name, format, outputPath }
+module.exports = { name, format, outputPath, write }
 function format(context, opts = {}) → string
-function _confidenceMeta(opts)
 function outputPath(cwd) → string
+function write(context, cwd, opts = {})
+function _confidenceMeta(opts)
 ```
 
-### packages/adapters/gemini.js
+### packages/adapters/copilot.js
 ```
 module.exports = { name, format, outputPath, write }
 function format(context, opts = {}) → string
+function _confidenceMeta(opts)
 function outputPath(cwd) → string
 function write(context, cwd, opts = {})
-function _confidenceMeta(opts)
 ```
 
 ### packages/adapters/openai.js
@@ -87,62 +125,33 @@ function outputPath(cwd) → string
 function _confidenceMeta(opts)
 ```
 
-### packages/adapters/windsurf.js
+### packages/adapters/claude.js
 ```
-module.exports = { name, format, outputPath }
+module.exports = { name, format, outputPath, write }
 function format(context, opts = {}) → string
 function _confidenceMeta(opts)
 function outputPath(cwd) → string
+function write(context, cwd, opts = {})
 ```
 
-### packages/core/README.md
-```
-h1 sigmap-core
-h2 Installation
-h2 Quick start
-h2 API reference
-h3 `extract(src, language)` → `string[]`
-h3 `rank(query, sigIndex, opts?)` → `Result[]`
-h3 `buildSigIndex(cwd)` → `Map<string, string[]>`
-h3 `scan(sigs, filePath)` → `{ safe: string[], redacted: boolean }`
-h3 `score(cwd)` → `HealthResult`
-h2 Migration from v2.3 and earlier
-h2 v3.0 — Multi-Adapter Architecture (released)
-h2 Zero dependencies
-code-fence bash
-code-fence plain
-code-fence js
-code-fence ---
-```
-
-### packages/core/index.js
+### packages/adapters/cursor.js
 ```
-module.exports = { extract, rank, buildSigIndex, scan, score, adapt }
-function _resolveExtractor(language)
-function extract(src, language) → string[]
-function rank(query, sigIndex, opts) → { file: string, score: nu
-function buildSigIndex(cwd) → Map<string, string[]>
-function scan(sigs, filePath) → { safe: string[], redacte
-function score(cwd) → { * score: number, * grad
-function adapt(context, adapterName, opts = {}) → string
+module.exports = { name, format, outputPath }
+function format(context, opts = {}) → string
+function _confidenceMeta(opts)
+function outputPath(cwd) → string
 ```
 
-### packages/adapters/codex.js
+### packages/adapters/windsurf.js
 ```
-module.exports = { name, format, outputPath, write }
+module.exports = { name, format, outputPath }
 function format(context, opts = {}) → string
+function _confidenceMeta(opts)
 function outputPath(cwd) → string
-function write(context, cwd, opts = {})
 ```
 
 ## src
 
-### src/routing/hints.js
-```
-module.exports = { TIERS, formatRoutingSection }
-function formatRoutingSection(groups) → string
-```
-
 ### src/security/patterns.js
 ```
 module.exports = { PATTERNS }
@@ -551,21 +560,6 @@ function extractContextFiles(context, cwd)
 function judge(response, context, opts = {})
 ```
 
-### src/learning/weights.js
-```
-module.exports = { BASELINE, DECAY, MAX_MULT, MIN_MULT, weightsPath, clampMultiplier, normalizeFile, loadWeights, saveWeights, updateWeights, boostFiles, penalizeFiles, resetWeights }
-function weightsPath(cwd)
-function clampMultiplier(value)
-function normalizeFile(cwd, filePath)
-function sanitizeWeights(cwd, weights)
-function loadWeights(cwd)
-function saveWeights(cwd, weights)
-function updateWeights(cwd, opts = {})
-function boostFiles(cwd, files, amount = 0.15)
-function penalizeFiles(cwd, files, amount = 0.10)
-function resetWeights(cwd)
-```
-
 ### src/format/benchmark-report.js
 ```
 module.exports = { loadBenchmarkReports, buildBenchmarkSummary, generateBenchmarkReportHtml, writeBenchmarkReport }
@@ -654,6 +648,23 @@ function extractClassMembers(block)
 function normalizeParams(params)
 ```
 
+### src/learning/weights.js
+```
+module.exports = { BASELINE, DECAY, MAX_MULT, MIN_MULT, weightsPath, clampMultiplier, normalizeFile, loadWeights, saveWeights, updateWeights, boostFiles, penalizeFiles, resetWeights, exportWeights, importWeights }
+function weightsPath(cwd)
+function clampMultiplier(value)
+function normalizeFile(cwd, filePath)
+function sanitizeWeights(cwd, weights)
+function loadWeights(cwd)
+function saveWeights(cwd, weights)
+function updateWeights(cwd, opts = {})
+function boostFiles(cwd, files, amount = 0.15)
+function penalizeFiles(cwd, files, amount = 0.10)
+function resetWeights(cwd)
+function exportWeights(cwd, outputPath)
+function importWeights(cwd, importPath, replace)
+```
+
 ### src/mcp/server.js
 ```
 module.exports = { start }

package/CHANGELOG.md

@@ -10,6 +10,14 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [6.1.0] — 2026-04-22
+
+### Added
+
+- **Tool instructions in every adapter (Level 1)** — each adapter's `format()` now embeds native-format SigMap command guidance: markdown table (copilot, codex), bullet list (claude), `#` comments (cursor, windsurf), instruction sentence (openai, gemini). Agents get `sigmap ask`, `sigmap validate`, and `sigmap judge` hints automatically in every generated context file.
+
+---
+
 ## [6.0.3] — 2026-04-21
 
 ### Added

package/README.md

@@ -76,14 +76,14 @@ Ask → Rank → Context → Validate → Judge → Learn
 ## Benchmark
 
 ```
-Benchmark : sigmap-v5.9-main
+Benchmark : sigmap-v6.0-main
 Date      : 2026-04-19
 
-Hit@5          : 80.0%   (baseline 13.6%  — 5.9× lift)
+Hit@5          : 80.0%   (baseline 13.6%  — 5.8× lift)
 Prompt reduction : 40.8%
 Task success   : 52.2%   (baseline 10%)
 Prompts / task : 1.68    (baseline 2.84)
-Token reduction: 40–98%  (avg 97.6% across 18 real repos)
+Token reduction: 40–98%  (avg 96.9% across 18 real repos)
 ```
 
 Measured on 90 coding tasks across 18 real public repos. No LLM API — fully reproducible.

package/gen-context.js

@@ -5387,7 +5387,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
   
   const SERVER_INFO = {
     name: 'sigmap',
-  version: '6.0.3',
+  version: '6.1.0',
     description: 'SigMap MCP server — code signatures on demand',
   };
   
@@ -6753,6 +6753,14 @@ __factories["./packages/adapters/copilot"] = function(module, exports) {
       `<!-- Updated: ${timestamp} -->`,
       `<!-- Do not edit below — regenerate with: node gen-context.js -->`,
       '',
+      '## SigMap commands',
+      '',
+      '| When | Command |',
+      '|------|---------|',
+      '| Before answering a question about code | `sigmap ask "<your question>"` |',
+      '| After changing config or source dirs | `sigmap validate` |',
+      '| To verify an AI answer is grounded | `sigmap judge --response <file>` |',
+      '',
       '# Code signatures',
       '',
       context,
@@ -6785,7 +6793,17 @@ __factories["./packages/adapters/claude"] = function(module, exports) {
     if (!context || typeof context !== 'string') return '';
     const version = (opts && opts.version) || 'unknown';
     const timestamp = new Date().toISOString();
-    return [`<!-- Generated by SigMap v${version} — ${timestamp} -->`, '', context].join('\n');
+    return [
+      '## SigMap',
+      '- Before searching for files, run `sigmap ask "<query>"` — ranks by TF-IDF relevance',
+      '- After config changes, run `sigmap validate` to confirm coverage',
+      '- To verify answer groundedness, run `sigmap judge --response <file> --context CLAUDE.md`',
+      '- For PR-scoped context, run `sigmap --diff`',
+      '',
+      `<!-- Generated by SigMap v${version} — ${timestamp} -->`,
+      '',
+      context,
+    ].join('\n');
   }
   function outputPath(cwd) { return path.join(cwd, 'CLAUDE.md'); }
   function write(context, cwd, opts = {}) {
@@ -6810,7 +6828,17 @@ __factories["./packages/adapters/cursor"] = function(module, exports) {
     if (!context || typeof context !== 'string') return '';
     const version = (opts && opts.version) || 'unknown';
     const timestamp = new Date().toISOString();
-    return [`# Code signatures — generated by SigMap v${version}`, `# Updated: ${timestamp}`, `# Regenerate: node gen-context.js`, '', context].join('\n');
+    return [
+      `# Code signatures — generated by SigMap v${version}`,
+      `# Updated: ${timestamp}`,
+      `# Regenerate: node gen-context.js`,
+      '#',
+      '# SigMap: before answering, run: sigmap ask "<query>" — finds relevant files',
+      '# SigMap: after config changes, run: sigmap validate',
+      '# SigMap: to verify answers, run: sigmap judge --response <file>',
+      '',
+      context,
+    ].join('\n');
   }
   function outputPath(cwd) { return path.join(cwd, '.cursorrules'); }
   module.exports = { name, format, outputPath };
@@ -6824,7 +6852,17 @@ __factories["./packages/adapters/windsurf"] = function(module, exports) {
     if (!context || typeof context !== 'string') return '';
     const version = (opts && opts.version) || 'unknown';
     const timestamp = new Date().toISOString();
-    return [`# Code signatures — generated by SigMap v${version}`, `# Updated: ${timestamp}`, `# Regenerate: node gen-context.js`, '', context].join('\n');
+    return [
+      `# Code signatures — generated by SigMap v${version}`,
+      `# Updated: ${timestamp}`,
+      `# Regenerate: node gen-context.js`,
+      '#',
+      '# SigMap: before answering, run: sigmap ask "<query>" — finds relevant files',
+      '# SigMap: after config changes, run: sigmap validate',
+      '# SigMap: to verify answers, run: sigmap judge --response <file>',
+      '',
+      context,
+    ].join('\n');
   }
   function outputPath(cwd) { return path.join(cwd, '.windsurfrules'); }
   module.exports = { name, format, outputPath };
@@ -6844,6 +6882,8 @@ __factories["./packages/adapters/openai"] = function(module, exports) {
       `Below are the code signatures extracted by SigMap v${version} on ${timestamp}.`,
       projectLine,
       `Use these signatures to answer questions about the code accurately.`,
+      `When the user asks about a specific file or function, refer to the signatures below.`,
+      `Before answering questions about specific code areas, prefer running \`sigmap ask "<query>"\` to get the most relevant files. After config changes, \`sigmap validate\` confirms coverage.`,
       ``,
       `## Code Signatures`,
       ``,
@@ -6870,6 +6910,8 @@ __factories["./packages/adapters/gemini"] = function(module, exports) {
       `The following code signatures were extracted by SigMap v${version} on ${timestamp}.`,
       projectLine,
       `These signatures represent every public function, class, and type in the project.`,
+      `Refer to them when answering questions about code structure, APIs, and implementation.`,
+      `Before answering questions about specific code areas, suggest running \`sigmap ask "<query>"\` to get the most relevant files. After config changes, \`sigmap validate\` confirms coverage.`,
       ``,
       `## Code Signatures`,
       ``,
@@ -6901,7 +6943,19 @@ __factories["./packages/adapters/codex"] = function(module, exports) {
   const CODEX_MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
   function format(context, opts = {}) {
     if (!context || typeof context !== 'string' || !context.trim()) return '';
-    return '# Code signatures\n\n' + context;
+    const toolBlock = [
+      '## SigMap commands',
+      '',
+      '| When | Command |',
+      '|------|---------|',
+      '| Before answering a question | `sigmap ask "<your question>"` |',
+      '| After code changes | `sigmap validate` |',
+      '| To query by topic | `sigmap --query "<topic>"` |',
+      '',
+      'Always run `sigmap ask` or `sigmap --query` before searching for files relevant to a task.',
+      '',
+    ].join('\n');
+    return '# Code signatures\n\n' + toolBlock + context;
   }
   function outputPath(cwd) { return path.join(cwd, 'AGENTS.md'); }
   function write(context, cwd, opts = {}) {
@@ -7105,7 +7159,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '6.0.3';
+const VERSION = '6.1.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap",
-  "version": "6.0.3",
+  "version": "6.1.0",
   "description": "Zero-dependency AI context engine — 97% token reduction. No npm install. Runs on Node 18+.",
   "main": "gen-context.js",
   "exports": {

package/packages/adapters/claude.js

@@ -30,6 +30,12 @@ function format(context, opts = {}) {
   const timestamp = new Date().toISOString();
   const meta      = _confidenceMeta(opts);
   return [
+    '## SigMap',
+    '- Before searching for files, run `sigmap ask "<query>"` — ranks by TF-IDF relevance',
+    '- After config changes, run `sigmap validate` to confirm coverage',
+    '- To verify answer groundedness, run `sigmap judge --response <file> --context CLAUDE.md`',
+    '- For PR-scoped context, run `sigmap --diff`',
+    '',
     `<!-- Generated by SigMap v${version} — ${timestamp} -->`,
     meta,
     '',

package/packages/adapters/codex.js

@@ -26,7 +26,19 @@ const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js
  */
 function format(context, opts = {}) {
   if (!context || typeof context !== 'string' || !context.trim()) return '';
-  return `# Code signatures\n\n${context}`;
+  const toolBlock = [
+    '## SigMap commands',
+    '',
+    '| When | Command |',
+    '|------|---------|',
+    '| Before answering a question | `sigmap ask "<your question>"` |',
+    '| After code changes | `sigmap validate` |',
+    '| To query by topic | `sigmap --query "<topic>"` |',
+    '',
+    'Always run `sigmap ask` or `sigmap --query` before searching for files relevant to a task.',
+    '',
+  ].join('\n');
+  return `# Code signatures\n\n${toolBlock}${context}`;
 }
 
 /**

package/packages/adapters/copilot.js

@@ -33,6 +33,14 @@ function format(context, opts = {}) {
     meta,
     `<!-- Do not edit below — regenerate with: node gen-context.js -->`,
     '',
+    '## SigMap commands',
+    '',
+    '| When | Command |',
+    '|------|---------|',
+    '| Before answering a question about code | `sigmap ask "<your question>"` |',
+    '| After changing config or source dirs | `sigmap validate` |',
+    '| To verify an AI answer is grounded | `sigmap judge --response <file>` |',
+    '',
     '# Code signatures',
     '',
   ].join('\n');

package/packages/adapters/cursor.js

@@ -30,6 +30,10 @@ function format(context, opts = {}) {
     `# Updated: ${timestamp}`,
     `# ${meta}`,
     `# Regenerate: node gen-context.js`,
+    '#',
+    '# SigMap: before answering, run: sigmap ask "<query>" — finds relevant files',
+    '# SigMap: after config changes, run: sigmap validate',
+    '# SigMap: to verify answers, run: sigmap judge --response <file>',
     '',
   ].join('\n');
   return header + context;

package/packages/adapters/gemini.js

@@ -44,6 +44,7 @@ function format(context, opts = {}) {
     projectLine,
     `These signatures represent every public function, class, and type in the project.`,
     `Refer to them when answering questions about code structure, APIs, and implementation.`,
+    `Before answering questions about specific code areas, suggest running \`sigmap ask "<query>"\` to get the most relevant files. After config changes, \`sigmap validate\` confirms coverage.`,
     ``,
     `## Code Signatures`,
     ``,

package/packages/adapters/openai.js

@@ -42,6 +42,7 @@ function format(context, opts = {}) {
     projectLine,
     `Use these signatures to answer questions about the code accurately.`,
     `When the user asks about a specific file or function, refer to the signatures below.`,
+    `Before answering questions about specific code areas, prefer running \`sigmap ask "<query>"\` to get the most relevant files. After config changes, \`sigmap validate\` confirms coverage.`,
     ``,
     `## Code Signatures`,
     ``,

package/packages/adapters/windsurf.js

@@ -30,6 +30,10 @@ function format(context, opts = {}) {
     `# Updated: ${timestamp}`,
     `# ${meta}`,
     `# Regenerate: node gen-context.js`,
+    '#',
+    '# SigMap: before answering, run: sigmap ask "<query>" — finds relevant files',
+    '# SigMap: after config changes, run: sigmap validate',
+    '# SigMap: to verify answers, run: sigmap judge --response <file>',
     '',
   ].join('\n');
   return header + context;

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-cli",
-  "version": "6.0.3",
+  "version": "6.1.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": "6.0.3",
+  "version": "6.1.0",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [

package/src/mcp/server.js

@@ -18,7 +18,7 @@ const { readContext, searchSignatures, getMap, createCheckpoint, getRouting, exp
 
 const SERVER_INFO = {
   name: 'sigmap',
-  version: '6.0.3',
+  version: '6.1.0',
   description: 'SigMap MCP server — code signatures on demand',
 };