sigmap 6.0.3 → 6.2.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 — 21 minutes ago)
 ```
-src/extractors/typescript.js                  ~extractInterfaceMembers  ~extractClassMembers
+src/learning/weights.js                       +exportWeights  +importWeights  ~resetWeights
+packages/adapters/claude.js                   ~format
 packages/adapters/codex.js                    ~format
+packages/adapters/gemini.js                   ~format
+packages/adapters/copilot.js                  ~format
+packages/adapters/openai.js                   ~format
+packages/adapters/cursor.js                   ~format
+packages/adapters/windsurf.js                 ~format
 ```
 
 ## packages
@@ -44,6 +59,38 @@ function format(context, opts)
 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
+```
+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/claude.js
 ```
 module.exports = { name, format, outputPath, write }
@@ -53,30 +100,30 @@ function outputPath(cwd) → string
 function write(context, cwd, opts = {})
 ```
 
-### packages/adapters/copilot.js
+### 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,7 +134,7 @@ function outputPath(cwd) → string
 function _confidenceMeta(opts)
 ```
 
-### packages/adapters/windsurf.js
+### packages/adapters/cursor.js
 ```
 module.exports = { name, format, outputPath }
 function format(context, opts = {}) → string
@@ -95,54 +142,16 @@ function _confidenceMeta(opts)
 function outputPath(cwd) → string
 ```
 
-### 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
-```
-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
+### 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 }
@@ -662,3 +656,20 @@ function respondError(id, code, message)
 function dispatch(msg, cwd)
 function start(cwd)
 ```
+
+### 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)
+```

package/CHANGELOG.md

@@ -10,6 +10,22 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [6.2.0] — 2026-04-22
+
+### Added
+
+- **`--setup` MCP auto-wire for 4 new targets** — `sigmap --setup` now registers the MCP server in `.vscode/mcp.json` (GitHub Copilot in VS Code 1.99+), `opencode.json` and `~/.config/opencode/config.json` (OpenCode), `~/.gemini/settings.json` (Gemini CLI), and `~/.codex/config.yaml` (Codex CLI — YAML format). All 5 new targets are idempotent and only written if the file already exists. Total `--setup` targets: 5 → 10.
+
+---
+
+## [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.2.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.2.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -8808,34 +8862,67 @@ Output: .github/copilot-instructions.md (default)
 // ---------------------------------------------------------------------------
 // MCP auto-registration
 // ---------------------------------------------------------------------------
+function _displayPath(p, cwd) {
+  return p.startsWith(os.homedir()) ? '~' + p.slice(os.homedir().length) : path.relative(cwd, p);
+}
+
+function _registerMcpJson(filePath, serverEntry, cwd) {
+  if (!fs.existsSync(filePath)) return;
+  try {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const settings = JSON.parse(raw);
+    if (!settings.mcpServers) settings.mcpServers = {};
+    if (settings.mcpServers['sigmap']) return;
+    settings.mcpServers['sigmap'] = serverEntry;
+    fs.writeFileSync(filePath, JSON.stringify(settings, null, 2) + '\n');
+    console.warn(`[sigmap] registered MCP server in ${_displayPath(filePath, cwd)}`);
+  } catch (err) {
+    console.warn(`[sigmap] could not update ${_displayPath(filePath, cwd)}: ${err.message}`);
+  }
+}
+
+function _registerCodexYaml(filePath, scriptPath) {
+  if (!fs.existsSync(filePath)) return;
+  try {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    if (raw.includes('sigmap')) return; // already registered
+    const yamlBlock = [
+      '',
+      'mcpServers:',
+      '  sigmap:',
+      `    command: node`,
+      `    args:`,
+      `      - ${path.resolve(scriptPath)}`,
+      `      - --mcp`,
+    ].join('\n');
+    fs.writeFileSync(filePath, raw.trimEnd() + yamlBlock + '\n');
+    console.warn('[sigmap] registered MCP server in ~/.codex/config.yaml');
+  } catch (err) {
+    console.warn(`[sigmap] could not update ~/.codex/config.yaml: ${err.message}`);
+  }
+}
+
 function registerMcp(cwd, scriptPath) {
   const serverEntry = {
     command: 'node',
     args: [path.resolve(scriptPath), '--mcp'],
   };
 
-  // mcpServers shape: Claude (.claude/settings.json), Cursor (.cursor/mcp.json),
-  // Windsurf project (.windsurf/mcp.json) and global (~/.codeium/windsurf/mcp_config.json)
-  const targets = [
+  // JSON mcpServers targets: Claude, Cursor, Windsurf project, Windsurf global,
+  // VS Code (GitHub Copilot 1.99+), OpenCode project, OpenCode global, Gemini CLI
+  const jsonTargets = [
     path.join(cwd, '.claude', 'settings.json'),
     path.join(cwd, '.cursor', 'mcp.json'),
     path.join(cwd, '.windsurf', 'mcp.json'),
     path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+    path.join(cwd, '.vscode', 'mcp.json'),
+    path.join(cwd, 'opencode.json'),
+    path.join(os.homedir(), '.config', 'opencode', 'config.json'),
+    path.join(os.homedir(), '.gemini', 'settings.json'),
   ];
 
-  for (const settingsPath of targets) {
-    if (!fs.existsSync(settingsPath)) continue;
-    try {
-      const raw = fs.readFileSync(settingsPath, 'utf8');
-      const settings = JSON.parse(raw);
-      if (!settings.mcpServers) settings.mcpServers = {};
-      if (settings.mcpServers['sigmap']) continue; // already registered
-      settings.mcpServers['sigmap'] = serverEntry;
-      fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-      console.warn(`[sigmap] registered MCP server in ${settingsPath.startsWith(os.homedir()) ? '~' + settingsPath.slice(os.homedir().length) : path.relative(cwd, settingsPath)}`);
-    } catch (err) {
-      console.warn(`[sigmap] could not update ${path.relative(cwd, settingsPath)}: ${err.message}`);
-    }
+  for (const target of jsonTargets) {
+    _registerMcpJson(target, serverEntry, cwd);
   }
 
   // Zed uses context_servers (different shape from mcpServers)
@@ -8857,12 +8944,24 @@ function registerMcp(cwd, scriptPath) {
     }
   }
 
-  // Print manual snippets for all 4 tools
+  // Codex CLI uses YAML (~/.codex/config.yaml)
+  _registerCodexYaml(path.join(os.homedir(), '.codex', 'config.yaml'), scriptPath);
+
+  // Print manual snippets for all targets
   console.warn('[sigmap] MCP / context server config snippets:');
-  console.warn('  Claude / Cursor / Windsurf (.claude/settings.json | .cursor/mcp.json | .windsurf/mcp.json):');
+  console.warn('  Claude / Cursor / Windsurf / VS Code / OpenCode / Gemini CLI:');
   console.warn(JSON.stringify({ mcpServers: { sigmap: serverEntry } }, null, 2));
   console.warn('  Zed (~/.config/zed/settings.json):');
   console.warn(JSON.stringify({ context_servers: { sigmap: { command: { path: 'node', args: [path.resolve(scriptPath), '--mcp'] } } } }, null, 2));
+  console.warn('  Codex CLI (~/.codex/config.yaml):');
+  console.warn([
+    'mcpServers:',
+    '  sigmap:',
+    `    command: node`,
+    `    args:`,
+    `      - ${path.resolve(scriptPath)}`,
+    `      - --mcp`,
+  ].join('\n'));
 }
 
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap",
-  "version": "6.0.3",
+  "version": "6.2.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.2.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.2.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.2.0',
   description: 'SigMap MCP server — code signatures on demand',
 };