sigmap 6.0.0 → 6.0.2

package/AGENTS.md

@@ -11,21 +11,12 @@ Use this marker block for all appendable context files:
 ```
 ## Auto-generated signatures
 <!-- Updated by gen-context.js -->
-You are a coding assistant with full knowledge of this codebase.
-Below are the code signatures extracted by SigMap v5.7.0 on 2026-04-17T21:17:18.905Z.
-
-Use these signatures to answer questions about the code accurately.
-
-## Code Signatures
-
-<!-- Generated by SigMap gen-context.js v5.7.0 -->
-<!-- DO NOT EDIT below the marker line — run gen-context.js to regenerate -->
-
 # Code signatures
 
-## changes (last 5 commits — 7 minutes ago)
+## changes (last 5 commits — 3 minutes ago)
 ```
-src/analysis/coverage-score.js                ~coverageScore  ~_walk
+src/extractors/typescript.js                  ~extractInterfaceMembers  ~extractClassMembers
+packages/adapters/codex.js                    ~format
 ```
 
 ## packages
@@ -36,14 +27,6 @@ module.exports = { CLI_ENTRY, run }
 function run(argv, cwd) → void
 ```
 
-### packages/adapters/codex.js
-```
-module.exports = { name, format, outputPath, write }
-function format(context, opts = {}) → string
-function outputPath(cwd) → string
-function write(context, cwd, opts = {})
-```
-
 ### packages/adapters/index.js
 ```
 module.exports = { getAdapter, listAdapters, adapt, outputsToAdapters }
@@ -144,21 +127,15 @@ function score(cwd) → { * score: number, * grad
 function adapt(context, adapterName, opts = {}) → string
 ```
 
-## src
-
-### src/map/route-table.js
+### packages/adapters/codex.js
 ```
-module.exports = { analyze }
-function shouldSkipFile(rel)
-function analyze(files, cwd)
+module.exports = { name, format, outputPath, write }
+function format(context, opts = {}) → string
+function outputPath(cwd) → string
+function write(context, cwd, opts = {})
 ```
 
-### src/routing/classifier.js
-```
-module.exports = { classify, classifyAll }
-function classify(filePath, sigs) → 'fast'|'balanced'|'powerf
-function classifyAll(fileEntries, cwd) → { fast: string[], balance
-```
+## src
 
 ### src/routing/hints.js
 ```
@@ -177,14 +154,6 @@ module.exports = { scan }
 function scan(signatures, filePath) → { safe: string[], redacte
 ```
 
-### src/tracking/logger.js
-```
-module.exports = { logRun, readLog, summarize }
-function logRun(entry, cwd)
-function readLog(cwd) → object[]
-function summarize(entries) → object
-```
-
 ### src/extractors/cpp.js
 ```
 module.exports = { extract }
@@ -344,16 +313,6 @@ module.exports = { extractTodos }
 function extractTodos(src) → {line:number, tag:string,
 ```
 
-### src/extractors/typescript.js
-```
-module.exports = { extract }
-function extract(src) → string[]
-function extractBlock(src, startIndex)
-function extractInterfaceMembers(block)
-function extractClassMembers(block)
-function normalizeParams(params)
-```
-
 ### src/extractors/vue.js
 ```
 module.exports = { extract }
@@ -607,32 +566,6 @@ function penalizeFiles(cwd, files, amount = 0.10)
 function resetWeights(cwd)
 ```
 
-### src/mcp/handlers.js
-```
-module.exports = { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact }
-function readContext(args, cwd)
-function searchSignatures(args, cwd)
-function getMap(args, cwd)
-function createCheckpoint(args, cwd)
-function getRouting(args, cwd)
-function explainFile(args, cwd)
-function listModules(args, cwd)
-function queryContext(args, cwd)
-function getImpact(args, cwd)
-```
-
-### src/retrieval/ranker.js
-```
-module.exports = { rank, buildSigIndex, scoreFile, formatRankTable, formatRankJSON, DEFAULT_WEIGHTS, detectIntent }
-function scoreFile(filePath, sigs, queryTokens, weights) → number
-function rank(query, sigIndex, opts) → { file: string, score: nu
-function _parseContextFile(contextPath) → Map<string, string[]>
-function buildSigIndex(cwd, opts) → Map<string, string[]>
-function formatRankTable(results, query) → string
-function formatRankJSON(results, query) → object
-function detectIntent(query)
-```
-
 ### src/format/benchmark-report.js
 ```
 module.exports = { loadBenchmarkReports, buildBenchmarkSummary, generateBenchmarkReportHtml, writeBenchmarkReport }
@@ -667,6 +600,60 @@ function coverageScore(cwd, fileEntries, config)
 function _walk(dir, excludeSet, out)
 ```
 
+### src/cache/sig-cache.js
+```
+module.exports = { loadCache, saveCache, getChangedFiles, updateCacheEntries }
+function cachePath(cwd)
+function loadCache(cwd, currentVersion) → Map<string, { mtime: numb
+function saveCache(cwd, currentVersion, cache)
+function getChangedFiles(files, cache) → { changed: string[], unch
+function updateCacheEntries(cache, extracted)
+```
+
+### src/mcp/handlers.js
+```
+module.exports = { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact }
+function readContext(args, cwd)
+function searchSignatures(args, cwd)
+function getMap(args, cwd)
+function createCheckpoint(args, cwd)
+function getRouting(args, cwd)
+function explainFile(args, cwd)
+function listModules(args, cwd)
+function queryContext(args, cwd)
+function getImpact(args, cwd)
+```
+
+### src/retrieval/ranker.js
+```
+module.exports = { rank, buildSigIndex, scoreFile, formatRankTable, formatRankJSON, DEFAULT_WEIGHTS, detectIntent }
+function scoreFile(filePath, sigs, queryTokens, weights) → number
+function rank(query, sigIndex, opts) → { file: string, score: nu
+function _parseContextFile(contextPath) → Map<string, string[]>
+function buildSigIndex(cwd, opts) → Map<string, string[]>
+function formatRankTable(results, query) → string
+function formatRankJSON(results, query) → object
+function detectIntent(query)
+```
+
+### src/tracking/logger.js
+```
+module.exports = { logRun, readLog, summarize }
+function logRun(entry, cwd)
+function readLog(cwd) → object[]
+function summarize(entries) → object
+```
+
+### src/extractors/typescript.js
+```
+module.exports = { extract }
+function extract(src) → string[]
+function extractBlock(src, startIndex)
+function extractInterfaceMembers(block)
+function extractClassMembers(block)
+function normalizeParams(params)
+```
+
 ### src/mcp/server.js
 ```
 module.exports = { start }

package/CHANGELOG.md

@@ -10,6 +10,24 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [6.0.2] — 2026-04-21
+
+### Fixed
+
+- **Duplicate adapter headers (#104, #96)** — `writeOutputs()` now strips the `formatOutput()` preamble (`<!-- Generated... -->` + `# Code signatures`) before passing content to adapters, preventing double headers on every run. Introduces `stripFormatHeader()` helper applied to all adapter paths including `writeClaude()`.
+- **Bundled codex factory (#96)** — the inline `__factories["./packages/adapters/codex"]` in `gen-context.js` was still delegating to `openai.format()` after the source-file fix in v6.0.1. Now uses clean `# Code signatures\n\n` + context, matching the source adapter.
+
+---
+
+## [6.0.1] — 2026-04-21
+
+### Fixed
+
+- **TypeScript extractor guard clauses (#97)** — `extractClassMembers` now skips control-flow keywords (`if`, `for`, `while`, `switch`, `do`, `try`, `catch`, `finally`, `else`) that were incorrectly emitted as method signatures when they appeared inside class bodies.
+- **Codex/AGENTS.md adapter preamble (#96)** — `packages/adapters/codex.js` no longer delegates to the OpenAI adapter. Output is now clean `# Code signatures\n\n<context>` markdown with no "You are a coding assistant…" preamble, no HTML comment metadata block, and no duplicate headers.
+
+---
+
 ## [6.0.0] — 2026-04-19
 
 ### Added

package/README.md

@@ -157,9 +157,11 @@ sigmap --adapter cursor
 
 **IDE extensions:**
 
-- [VS Code extension](https://marketplace.visualstudio.com/items?itemName=manojmallick.sigmap) — status bar health grade, stale alerts, one-click regen
-- [JetBrains plugin](https://plugins.jetbrains.com/plugin/31109-sigmap--ai-context-engine/) — IntelliJ IDEA, WebStorm, PyCharm, GoLand
-- [Neovim plugin](https://github.com/manojmallick/sigmap.nvim) — `:SigMap`, `:SigMapQuery`, statusline widget
+| IDE | Install | Source | Features |
+|-----|---------|--------|----------|
+| **VS Code** | [Marketplace](https://marketplace.visualstudio.com/items?itemName=manojmallick.sigmap) · [Open VSX](https://open-vsx.org/extension/manojmallick/sigmap) | [github.com/manojmallick/sigmap-vscode](https://github.com/manojmallick/sigmap-vscode) | Status bar health grade, stale context alerts, one-click regen |
+| **JetBrains** | [Marketplace](https://plugins.jetbrains.com/plugin/31109-sigmap--ai-context-engine/) | [github.com/manojmallick/sigmap-jetbrains](https://github.com/manojmallick/sigmap-jetbrains) | IntelliJ IDEA, WebStorm, PyCharm, GoLand — tool window + actions |
+| **Neovim** | lazy.nvim / packer / vim-plug | [github.com/manojmallick/sigmap.nvim](https://github.com/manojmallick/sigmap.nvim) | `:SigMap`, `:SigMapQuery` float window, statusline widget |
 
 **MCP server** — 9 on-demand tools for Claude Code and Cursor:
 

package/gen-context.js

@@ -4520,6 +4520,71 @@ __factories["./src/map/route-table"] = function(module, exports) {
   
 };
 
+// ── ./src/cache/sig-cache ──
+__factories["./src/cache/sig-cache"] = function(module, exports) {
+  'use strict';
+
+  const fs   = require('fs');
+  const path = require('path');
+
+  const CACHE_FILE = '.sigmap-cache.json';
+
+  function cachePath(cwd) {
+    return path.join(cwd, CACHE_FILE);
+  }
+
+  function loadCache(cwd, currentVersion) {
+    try {
+      const raw = fs.readFileSync(cachePath(cwd), 'utf8');
+      const data = JSON.parse(raw);
+      if (data.sigmapVersion !== currentVersion) return new Map();
+      return new Map(Object.entries(data.entries || {}));
+    } catch (_) {
+      return new Map();
+    }
+  }
+
+  function saveCache(cwd, currentVersion, cache) {
+    try {
+      const data = {
+        sigmapVersion: currentVersion,
+        entries: Object.fromEntries(cache),
+      };
+      fs.writeFileSync(cachePath(cwd), JSON.stringify(data), 'utf8');
+    } catch (_) {}
+  }
+
+  function getChangedFiles(files, cache) {
+    const changed = [];
+    const unchanged = [];
+    for (const f of files) {
+      try {
+        const mtime = fs.statSync(f).mtimeMs;
+        const cached = cache.get(f);
+        if (!cached || cached.mtime !== mtime) {
+          changed.push(f);
+        } else {
+          unchanged.push(f);
+        }
+      } catch (_) {
+        changed.push(f);
+      }
+    }
+    return { changed, unchanged };
+  }
+
+  function updateCacheEntries(cache, extracted) {
+    for (const { file, sigs } of extracted) {
+      try {
+        const mtime = fs.statSync(file).mtimeMs;
+        cache.set(file, { mtime, sigs });
+      } catch (_) {}
+    }
+  }
+
+  module.exports = { loadCache, saveCache, getChangedFiles, updateCacheEntries };
+};
+
 // ── ./src/graph/builder ──
 __factories["./src/graph/builder"] = function(module, exports) {
   'use strict';
@@ -5291,7 +5356,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
   
   const SERVER_INFO = {
     name: 'sigmap',
-  version: '6.0.0',
+  version: '6.0.2',
     description: 'SigMap MCP server — code signatures on demand',
   };
   
@@ -6801,11 +6866,11 @@ __factories["./packages/adapters/gemini"] = function(module, exports) {
 __factories["./packages/adapters/codex"] = function(module, exports) {
   const path = require('path');
   const fs = require('fs');
-  const openai = __require('./packages/adapters/openai');
   const name = 'codex';
   const CODEX_MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
   function format(context, opts = {}) {
-    return openai.format(context, opts);
+    if (!context || typeof context !== 'string' || !context.trim()) return '';
+    return '# Code signatures\n\n' + context;
   }
   function outputPath(cwd) { return path.join(cwd, 'AGENTS.md'); }
   function write(context, cwd, opts = {}) {
@@ -7009,7 +7074,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '6.0.0';
+const VERSION = '6.0.2';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -7697,13 +7762,17 @@ function writeOutputs(content, targets, cwd, config) {
     if (ADAPTER_TARGETS.has(target)) {
       try {
         const adapterMod = __require('./packages/adapters/' + target);
+        // Adapters add their own header via format() — strip the formatOutput() header
+        // so the content body (## src, ## deps, etc.) is passed without a pre-existing
+        // header, preventing duplicate "# Code signatures" blocks on every run.
+        const adapterContent = stripFormatHeader(content);
         // copilot: honour config.output custom path (redirects away from default .github/copilot-instructions.md)
         if (target === 'copilot') {
           const outPath = resolveAdapterPath('copilot', cwd, config);
           const defaultPath = path.join(cwd, '.github', 'copilot-instructions.md');
           if (outPath !== defaultPath) {
             // custom path: format and write directly (no append logic)
-            const formatted = adapterMod.format(content, { version: VERSION });
+            const formatted = adapterMod.format(adapterContent, { version: VERSION });
             ensureDir(outPath);
             fs.writeFileSync(outPath, formatted, 'utf8');
             console.warn(`[sigmap] wrote ${path.relative(cwd, outPath)}`);
@@ -7711,11 +7780,11 @@ function writeOutputs(content, targets, cwd, config) {
           }
         }
         if (typeof adapterMod.write === 'function') {
-          adapterMod.write(content, cwd, { version: VERSION });
+          adapterMod.write(adapterContent, cwd, { version: VERSION });
           const outPath = adapterMod.outputPath(cwd);
           console.warn(`[sigmap] wrote ${path.relative(cwd, outPath)} (appended signatures)`);
         } else {
-          const formatted = adapterMod.format(content, { version: VERSION });
+          const formatted = adapterMod.format(adapterContent, { version: VERSION });
           const outPath = adapterMod.outputPath(cwd);
           ensureDir(outPath);
           fs.writeFileSync(outPath, formatted, 'utf8');
@@ -7737,18 +7806,36 @@ function writeOutputs(content, targets, cwd, config) {
   }
 }
 
+// Strip the formatOutput() header block before passing content to adapters.
+// formatOutput() prepends "<!-- Generated... -->\n\n# Code signatures\n\n" which
+// is the raw-file header. Adapters add their own header via format(), so passing
+// pre-headered content produces duplicate headers on every run.
+function stripFormatHeader(content) {
+  if (!content || typeof content !== 'string') return content;
+  // Header ends after "# Code signatures\n\n" (with blank line)
+  const marker = '\n# Code signatures\n';
+  const idx = content.indexOf(marker);
+  if (idx === -1) return content;
+  // Skip past the marker line and one blank line
+  const afterMarker = content.slice(idx + marker.length);
+  return afterMarker.startsWith('\n') ? afterMarker.slice(1) : afterMarker;
+}
+
 function writeClaude(content, cwd) {
   const claudePath = path.join(cwd, 'CLAUDE.md');
   let existing = '';
   if (fs.existsSync(claudePath)) {
     existing = fs.readFileSync(claudePath, 'utf8');
   }
+  // Strip the formatOutput() header — CLAUDE.md gets its own header via the MARKER
+  const body = stripFormatHeader(content);
+  const sigHeader = '# Code signatures\n\n';
   const markerIdx = existing.indexOf('## Auto-generated signatures');
   let newContent;
   if (markerIdx !== -1) {
-    newContent = existing.slice(0, markerIdx) + MARKER.trimStart() + content;
+    newContent = existing.slice(0, markerIdx) + MARKER.trimStart() + sigHeader + body;
   } else {
-    newContent = existing + MARKER + content;
+    newContent = existing + MARKER + sigHeader + body;
   }
   fs.writeFileSync(claudePath, newContent, 'utf8');
   console.warn(`[sigmap] wrote CLAUDE.md (appended signatures)`);
@@ -8844,10 +8931,30 @@ function main() {
   }
 
   const invokedFrom = process.cwd();
-  const cwd = resolveProjectRoot(invokedFrom);
+
+  // --cwd <dir>: restrict scanning to that directory instead of the project root
+  const cwdFlagIdx = args.indexOf('--cwd');
+  const cwdFlag = cwdFlagIdx !== -1 ? (args[cwdFlagIdx + 1] || '').trim() : null;
+  if (cwdFlag !== null && (!cwdFlag || cwdFlag.startsWith('--'))) {
+    console.error('[sigmap] --cwd requires a directory path');
+    process.exit(1);
+  }
+  const cwd = cwdFlag
+    ? path.resolve(invokedFrom, cwdFlag)
+    : resolveProjectRoot(invokedFrom);
   const scriptPath = process.argv[1] || path.join(invokedFrom, 'gen-context.js');
 
-  if (cwd !== invokedFrom) {
+  if (cwdFlag) {
+    if (!fs.existsSync(cwd)) {
+      console.error(`[sigmap] --cwd directory does not exist: ${cwd}`);
+      process.exit(1);
+    }
+    if (!fs.statSync(cwd).isDirectory()) {
+      console.error(`[sigmap] --cwd must be a directory, not a file: ${cwd}`);
+      process.exit(1);
+    }
+    console.warn(`[sigmap] --cwd: restricting scan to ${cwd}`);
+  } else if (cwd !== invokedFrom) {
     console.warn(`[sigmap] using project root: ${cwd}`);
   }
 
@@ -8870,6 +8977,11 @@ function main() {
 
   const config = loadConfig(cwd);
 
+  // --cwd restricts scanning: override srcDirs so only the given directory is scanned
+  if (cwdFlag) {
+    config.srcDirs = ['.'];
+  }
+
   // ── --output <file> — parse early so every subsequent block can use it ─────
   // Resolves the custom output path and merges it into config.customOutput.
   // Also persists the resolved relative path to gen-context.config.json so

package/package.json

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

package/packages/adapters/codex.js

@@ -14,19 +14,19 @@
 
 const path = require('path');
 const fs = require('fs');
-const openai = require('./openai');
 
 const name = 'codex';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 /**
- * Format context using the OpenAI adapter format.
+ * Format context for AGENTS.md — clean markdown, no LLM preamble.
  * @param {string} context - Raw signature context string
  * @param {object} [opts]
  * @returns {string}
  */
 function format(context, opts = {}) {
-  return openai.format(context, opts);
+  if (!context || typeof context !== 'string' || !context.trim()) return '';
+  return `# Code signatures\n\n${context}`;
 }
 
 /**

package/packages/cli/package.json

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

package/src/extractors/typescript.js

@@ -146,11 +146,14 @@ function extractInterfaceMembers(block) {
   return members.slice(0, 8);
 }
 
+const _CTRL_KEYWORDS = new Set(['if', 'for', 'while', 'switch', 'do', 'try', 'catch', 'finally', 'else', 'return']);
+
 function extractClassMembers(block) {
   const members = [];
-  // Public methods (skip private/protected/_ prefixed)
+  // Public methods (skip private/protected/_ prefixed and control-flow keywords)
   const methodRe = /^\s+(?:public\s+|static\s+|async\s+|override\s+)*(\w+)\s*(?:<[^(]*>)?\s*\(([^)]*)\)(?:\s*:\s*[^{;]+)?\s*\{/gm;
   for (const m of block.matchAll(methodRe)) {
+    if (_CTRL_KEYWORDS.has(m[1])) continue;
     if (/^(private|protected|_)/.test(m[1])) continue;
     if (m[1] === 'constructor') { members.push(`constructor(${normalizeParams(m[2])})`); continue; }
     const isAsync = m[0].includes('async ') ? 'async ' : '';

package/src/mcp/server.js

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