sigmap 3.5.1 → 3.6.0

package/AGENTS.md

@@ -12,31 +12,17 @@ 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 v3.5.0 on 2026-04-14T21:58:46.968Z.
+Below are the code signatures extracted by SigMap v3.5.1 on 2026-04-14T23:05:11.451Z.
 
 Use these signatures to answer questions about the code accurately.
 
 ## Code Signatures
 
-<!-- Generated by SigMap gen-context.js v3.5.0 -->
+<!-- Generated by SigMap gen-context.js v3.5.1 -->
 <!-- DO NOT EDIT below the marker line — run gen-context.js to regenerate -->
 
 # Code signatures
 
-## changes (last 5 commits — 19 minutes ago)
-```
-src/config/loader.js                          ~detectAutoSrcDirs
-src/eval/analyzer.js                          ~isDockerfile
-src/extractors/markdown.js                    +extract
-src/extractors/patterns.js                    +extract  +implementing
-src/extractors/properties.js                  +extract
-src/extractors/python_dataclass.js            +extract  +definitions
-src/extractors/toml.js                        +extract
-src/extractors/typescript_react.js            +extract  +declarations
-src/extractors/vue_sfc.js                     +extract
-src/extractors/xml.js                         +attributes  +extract
-```
-
 ## packages
 
 ### packages/core/index.js
@@ -99,6 +85,14 @@ function adapt(context, adapterName, opts = {}) → string
 function outputsToAdapters(outputs) → string[]
 ```
 
+### packages/adapters/llm-full.js
+```
+module.exports = { name: 'llm-full', format, outputPath, write }
+function outputPath(cwd)
+function format(context, opts)
+function write(context, cwd, opts)
+```
+
 ### packages/adapters/openai.js
 ```
 module.exports = { name, format, outputPath }
@@ -167,12 +161,6 @@ function formatAnalysisTable(stats, showSlow) → string
 function formatAnalysisJSON(stats) → object
 ```
 
-### src/extractors/graphql.js
-```
-module.exports = { extract }
-function extract(src) → string[]
-```
-
 ### src/extractors/markdown.js
 ```
 module.exports = { extract }
@@ -191,32 +179,12 @@ module.exports = { extract }
 function extract(src) → string[]
 ```
 
-### src/extractors/protobuf.js
-```
-module.exports = { extract }
-function extract(src) → string[]
-```
-
 ### src/extractors/python_dataclass.js
 ```
 module.exports = { extract }
 function extract(src) → string[]
 ```
 
-### src/extractors/sql.js
-```
-module.exports = { extract }
-function extract(src) → string[]
-function _cleanName(raw)
-function _normalizeParams(raw)
-```
-
-### src/extractors/terraform.js
-```
-module.exports = { extract }
-function extract(src) → string[]
-```
-
 ### src/extractors/toml.js
 ```
 module.exports = { extract }
@@ -333,6 +301,12 @@ module.exports = { extract }
 function extract(src) → string[]
 ```
 
+### src/extractors/generic.js
+```
+module.exports = { extract }
+function extract(src)
+```
+
 ### src/extractors/go.js
 ```
 module.exports = { extract }
@@ -342,6 +316,12 @@ function extractInterfaceMethods(block)
 function normalizeParams(params)
 ```
 
+### src/extractors/graphql.js
+```
+module.exports = { extract }
+function extract(src) → string[]
+```
+
 ### src/extractors/html.js
 ```
 module.exports = { extract }
@@ -396,6 +376,12 @@ function diffSignatures(baseSigs, currentSigs) → {added:string[], removed:
 function extractName(sig)
 ```
 
+### src/extractors/protobuf.js
+```
+module.exports = { extract }
+function extract(src) → string[]
+```
+
 ### src/extractors/python.js
 ```
 module.exports = { extract }
@@ -443,6 +429,14 @@ module.exports = { extract }
 function extract(src) → string[]
 ```
 
+### src/extractors/sql.js
+```
+module.exports = { extract }
+function extract(src) → string[]
+function _cleanName(raw)
+function _normalizeParams(raw)
+```
+
 ### src/extractors/svelte.js
 ```
 module.exports = { extract }
@@ -461,6 +455,12 @@ function normalizeParams(params)
 function extractArrowType(str)
 ```
 
+### src/extractors/terraform.js
+```
+module.exports = { extract }
+function extract(src) → string[]
+```
+
 ### src/extractors/todos.js
 ```
 module.exports = { extractTodos }
@@ -518,6 +518,22 @@ function generateDashboardHtml(cwd, health)
 function renderHistoryCharts(cwd, health)
 ```
 
+### src/format/llm-txt.js
+```
+module.exports = { format, outputPath }
+function outputPath(cwd)
+function format(context, cwd, version)
+```
+
+### src/format/llms-txt.js
+```
+module.exports = { format, outputPath }
+function outputPath(cwd)
+function getShortCommit(cwd)
+function detectVersion(cwd)
+function format(context, cwd, writtenFiles, sigmapVersion)
+```
+
 ### src/graph/builder.js
 ```
 module.exports = { build, buildFromCwd, extractFileDeps }

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="docs-vp/.vitepress/public/logo.svg" alt="SigMap logo" width="64" height="84" />
+<img src="assets/logo.png" alt="SigMap logo" width="80" height="80" />
 
 <h1>⚡ SigMap</h1>
 
@@ -456,6 +456,10 @@ Activates on startup (`onStartupFinished`) — loads within 3 s, never blocks ed
 
 The official SigMap JetBrains plugin brings the same features to IntelliJ-based IDEs. Install it from the JetBrains Marketplace and it works identically to the VS Code extension.
 
+<div align="center">
+<img src="assets/intelij.gif" alt="SigMap JetBrains plugin — status bar health grade, regenerate action, and context auto-refresh in IntelliJ IDEA" width="700" />
+</div>
+
 | Feature | Detail |
 |---|---|
 | **Status bar widget** | Shows health grade (`A`-`F`) + time since last regen; updates every 60 s |

package/gen-context.js

@@ -6040,7 +6040,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '3.5.1';
+const VERSION = '3.6.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -6270,12 +6270,13 @@ function applyTokenBudget(fileEntries, maxTokens) {
   // Sort by drop priority (drop first = index 0)
   const withPriority = fileEntries.map((e) => {
     let priority = 0;
-    if (isGeneratedFile(e.filePath)) priority = 10;
-    else if (isMockFile(e.filePath)) priority = 9;
-    else if (isTestFile(e.filePath)) priority = 8;
-    else if (isConfigFile(e.filePath)) priority = 6;
+    let dropReason = 'budget: low recency';
+    if (isGeneratedFile(e.filePath)) { priority = 10; dropReason = 'budget: generated file'; }
+    else if (isMockFile(e.filePath)) { priority = 9;  dropReason = 'budget: mock file'; }
+    else if (isTestFile(e.filePath)) { priority = 8;  dropReason = 'budget: test file'; }
+    else if (isConfigFile(e.filePath)) { priority = 6; dropReason = 'budget: config file'; }
     else priority = 4;
-    return { ...e, priority };
+    return { ...e, priority, dropReason };
   });
 
   // Within same priority, sort by mtime ascending (oldest first = drop first)
@@ -6285,20 +6286,27 @@ function applyTokenBudget(fileEntries, maxTokens) {
   });
 
   const kept = [];
-  let dropped = 0;
+  const verboseDropped = [];
   // Iterate forward: highest drop-priority files (generated=10, mock=9, test=8) are at index 0
   // Drop those first until we're under budget, then keep everything else
   for (const entry of withPriority) {
     const entryTokens = estimateTokens(entry.sigs.join('\n'));
     if (total > effectiveBudget) {
       total -= entryTokens;
-      dropped++;
+      verboseDropped.push({ filePath: entry.filePath, reason: entry.dropReason });
     } else {
       kept.push(entry);
     }
   }
-  if (dropped > 0) {
-    console.warn(`[sigmap] budget: dropped ${dropped} files to stay under ${maxTokens} tokens`);
+  if (verboseDropped.length > 0) {
+    console.warn(`[sigmap] budget: dropped ${verboseDropped.length} files to stay under ${maxTokens} tokens`);
+    // Feature 7: --verbose — print per-file drop reason
+    if (process.argv.includes('--verbose')) {
+      for (const { filePath, reason } of verboseDropped) {
+        console.warn(`[sigmap] dropped: ${path.relative(process.cwd(), filePath)} — ${reason}`);
+      }
+      console.warn(`[sigmap] included: ${kept.length} files, dropped: ${verboseDropped.length}`);
+    }
   }
   return kept;
 }
@@ -7628,6 +7636,87 @@ function main() {
     process.exit(0);
   }
 
+  // Feature 1: `sigmap explain <file>` — why a file is included or excluded
+  if (args[0] === 'explain' || args.includes('--explain')) {
+    const target = args[0] === 'explain'
+      ? args[1]
+      : args[args.indexOf('--explain') + 1];
+
+    if (!target || target.startsWith('--')) {
+      console.error('[sigmap] Usage: sigmap explain <file>');
+      process.exit(1);
+    }
+
+    const absPath = path.resolve(cwd, target);
+    const rel     = path.relative(cwd, absPath);
+    const jsonOut = args.includes('--json');
+
+    // 1. Check .contextignore
+    const ignorePatterns = loadIgnorePatterns(cwd);
+    const ignored = matchesIgnore(rel.replace(/\\/g, '/'), ignorePatterns);
+    if (ignored) {
+      if (jsonOut) {
+        process.stdout.write(JSON.stringify({ status: 'excluded', reason: '.contextignore', fix: `remove the pattern or add '!${rel}' as an exception` }) + '\n');
+      } else {
+        console.log(`[sigmap] ${rel} — EXCLUDED`);
+        console.log(`  Reason: matched .contextignore`);
+        console.log(`  Fix:    remove the pattern or add '!${rel}' as an exception`);
+      }
+      process.exit(0);
+    }
+
+    // 2. Check srcDirs membership
+    const inSrcDirs = (config.srcDirs || []).some(d => absPath.startsWith(path.resolve(cwd, d)));
+    if (!inSrcDirs) {
+      if (jsonOut) {
+        process.stdout.write(JSON.stringify({ status: 'excluded', reason: 'not in srcDirs', srcDirs: config.srcDirs, fix: 'add the containing directory to srcDirs in gen-context.config.json' }) + '\n');
+      } else {
+        console.log(`[sigmap] ${rel} — EXCLUDED`);
+        console.log(`  Reason: not under any srcDir (${(config.srcDirs || []).join(', ')})`);
+        console.log(`  Fix:    add the containing directory to srcDirs in gen-context.config.json`);
+      }
+      process.exit(0);
+    }
+
+    // 3. Detect extractor and extract sigs
+    const base    = path.basename(absPath);
+    const ext     = path.extname(base).toLowerCase();
+    let extractorName = EXT_MAP[ext] || null;
+    if (!extractorName && isDockerfile(base)) extractorName = 'dockerfile';
+    if (!extractorName) extractorName = 'generic';
+
+    let sigs = [];
+    if (fs.existsSync(absPath)) {
+      try {
+        const content = fs.readFileSync(absPath, 'utf8');
+        const extractor = getExtractor(extractorName);
+        if (extractor) sigs = extractor.extract(content).slice(0, config.maxSigsPerFile || 25);
+      } catch (_) {}
+    }
+
+    if (!sigs.length) {
+      if (jsonOut) {
+        process.stdout.write(JSON.stringify({ status: 'excluded', reason: 'no signatures', extractor: extractorName, fix: 'check that the file contains function/class definitions' }) + '\n');
+      } else {
+        console.log(`[sigmap] ${rel} — EXCLUDED`);
+        console.log(`  Reason: no extractable signatures (extractor: ${extractorName})`);
+        console.log(`  Fix:    check that the file contains function/class definitions`);
+      }
+      process.exit(0);
+    }
+
+    // 4. Included
+    if (jsonOut) {
+      process.stdout.write(JSON.stringify({ status: 'included', extractor: extractorName, signatures: sigs.length, preview: sigs.slice(0, 3), sigs }) + '\n');
+    } else {
+      console.log(`[sigmap] ${rel} — INCLUDED`);
+      console.log(`  Extractor : ${extractorName}`);
+      console.log(`  Signatures: ${sigs.length}`);
+      console.log(`  Preview   : ${sigs.slice(0, 3).join(' · ')}`);
+    }
+    process.exit(0);
+  }
+
   if (args.includes('--init')) {
     writeInitConfig(cwd);
     process.exit(0);
@@ -7637,7 +7726,14 @@ function main() {
     const { score } = __require('./src/health/scorer');
     const result = score(cwd);
     if (args.includes('--json')) {
-      process.stdout.write(JSON.stringify(result) + '\n');
+      // Feature 3 (VS Code) + Feature 5 (JetBrains): emit tokens + reduction for plugins
+      const ctxPath = path.join(cwd, '.github', 'copilot-instructions.md');
+      let tokens = 0;
+      let reduction = result.tokenReductionPct || 0;
+      if (fs.existsSync(ctxPath)) {
+        try { tokens = estimateTokens(fs.readFileSync(ctxPath, 'utf8')); } catch (_) {}
+      }
+      process.stdout.write(JSON.stringify({ ...result, tokens, reduction }) + '\n');
     } else {
       console.log('[sigmap] health:');
       console.log(`  score           : ${result.score}/100 (grade ${result.grade})`);

package/package.json

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