sigmap 4.1.0 → 4.1.1

package/CHANGELOG.md

@@ -10,6 +10,51 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [4.1.1] — 2026-04-16 — Fix: --query works with any adapter output
+
+### Fixed
+
+- **`--query` fails after `--adapter` generation** (`[sigmap] no context file found`):  
+  `buildSigIndex` hardcoded `.github/copilot-instructions.md` as the only
+  context file path, so `--query` always failed when any adapter other than
+  `copilot` wrote to a different location (`CLAUDE.md`, `AGENTS.md`,
+  `.cursorrules`, `.windsurfrules`, etc.).
+
+  `buildSigIndex` now probes all nine known adapter output paths in priority
+  order and returns the first non-empty index:
+  ```
+  copilot → claude → codex → cursor → windsurf → openai → gemini → llm-full → llm
+  ```
+  Human-written preamble before the `## Auto-generated signatures` marker
+  (e.g. custom content in `CLAUDE.md`) is skipped so those `###` sections
+  don't pollute the signature index.
+
+- **`--adapter <name> --query "..."` combination ignored the adapter flag**:  
+  The `--query` handler now detects a co-present `--adapter` flag, resolves
+  that adapter's output path, and reads from it directly — so both forms work:
+  ```bash
+  # generate with claude adapter, then query without re-specifying adapter
+  node gen-context.js --adapter claude
+  node gen-context.js --query "add a new extractor"
+
+  # or pin explicitly in one command
+  node gen-context.js --adapter claude --query "add a new extractor"
+  ```
+
+- **`--analyze --json` output truncated at ~8 KB on macOS**:  
+  Calling `process.exit(0)` immediately after `process.stdout.write(largeJson)`
+  truncated output because the underlying pipe write is asynchronous even
+  when `write()` returns `true`. Fixed by using the write callback so the
+  process exits only after the OS has accepted all bytes.
+
+### Tests
+
+- Added `test/integration/query-adapter.test.js` (17 tests) covering every
+  adapter output path (unit + CLI), probe order, marker-skipping, explicit
+  `opts.contextPath` override, and empty-project fallback.
+
+---
+
 ## [4.1.0] — 2026-04-15 — Smart Budget: auto-scaling token budget
 
 ### Added

package/gen-context.js

@@ -5449,12 +5449,24 @@ __factories["./src/retrieval/ranker"] = function(module, exports) {
     scored.sort((a, b) => b.score - a.score || a.file.localeCompare(b.file));
     return scored.slice(0, topK);
   }
-  function buildSigIndex(cwd) {
-    const fs = require('fs'); const path = require('path');
-    const contextPath = path.join(cwd, '.github', 'copilot-instructions.md');
+  const ADAPTER_OUTPUT_PATHS = [
+    ['.github', 'copilot-instructions.md'],
+    ['CLAUDE.md'],
+    ['AGENTS.md'],
+    ['.cursorrules'],
+    ['.windsurfrules'],
+    ['.github', 'openai-context.md'],
+    ['.github', 'gemini-context.md'],
+    ['llm-full.txt'],
+    ['llm.txt'],
+  ];
+  function _parseContextFile(contextPath) {
+    const fs = require('fs');
     const index = new Map();
     if (!fs.existsSync(contextPath)) return index;
-    const content = fs.readFileSync(contextPath, 'utf8');
+    let content = fs.readFileSync(contextPath, 'utf8');
+    const markerIdx = content.indexOf('## Auto-generated signatures');
+    if (markerIdx !== -1) content = content.slice(markerIdx);
     const lines = content.split('\n');
     let currentFile = null; let inBlock = false; let sigs = [];
     for (const line of lines) {
@@ -5466,6 +5478,16 @@ __factories["./src/retrieval/ranker"] = function(module, exports) {
     if (currentFile !== null) index.set(currentFile, sigs);
     return index;
   }
+  function buildSigIndex(cwd, opts) {
+    const path = require('path');
+    if (opts && opts.contextPath) return _parseContextFile(opts.contextPath);
+    for (const parts of ADAPTER_OUTPUT_PATHS) {
+      const contextPath = path.join(cwd, ...parts);
+      const index = _parseContextFile(contextPath);
+      if (index.size > 0) return index;
+    }
+    return new Map();
+  }
   function formatRankTable(results, query) {
     if (!results || results.length === 0) return `No matching files found for query: "${query}"\n`;
     const lines = [`## Query: ${query}`, '', '| Rank | File | Score | Sigs | Tokens |', '|------|------|-------|------|--------|',
@@ -8220,7 +8242,13 @@ function main() {
       const stats = analyzeFiles(allFiles, cwd, { slow, maxSigs: cfg.maxSigsPerFile || 25 });
 
       if (args.includes('--json')) {
-        process.stdout.write(JSON.stringify(formatAnalysisJSON(stats)) + '\n');
+        const out = JSON.stringify(formatAnalysisJSON(stats)) + '\n';
+        // Use the write callback to exit only after the OS has accepted all
+        // bytes. Calling process.exit(0) synchronously after write() truncates
+        // large outputs because the underlying pipe write is asynchronous even
+        // when write() returns true.
+        process.stdout.write(out, 'utf8', () => process.exit(0));
+        return; // exit is handled by the callback above
       } else {
         const table = formatAnalysisTable(stats, slow);
         process.stdout.write(table);
@@ -8326,9 +8354,29 @@ function main() {
         process.exit(1);
       }
       const { rank, buildSigIndex, formatRankTable, formatRankJSON } = requireSourceOrBundled('./src/retrieval/ranker');
-      const index = buildSigIndex(cwd);
+
+      // Resolve an explicit context file path when --adapter is present.
+      // This lets `--adapter claude --query "..."` read CLAUDE.md instead of
+      // falling through to the default copilot-instructions.md probe.
+      let queryOpts;
+      const adpIdx = args.indexOf('--adapter');
+      if (adpIdx >= 0) {
+        const adapterName = (args[adpIdx + 1] || '').trim().toLowerCase();
+        const VALID_ADAPTERS = ['copilot', 'claude', 'cursor', 'windsurf', 'openai', 'gemini', 'codex'];
+        if (VALID_ADAPTERS.includes(adapterName)) {
+          try {
+            const adapterMod = __require('./packages/adapters/' + adapterName);
+            queryOpts = { contextPath: adapterMod.outputPath(cwd) };
+          } catch (_) {}
+        }
+      }
+
+      const index = buildSigIndex(cwd, queryOpts);
       if (index.size === 0) {
         console.error('[sigmap] no context file found. Run: node gen-context.js');
+        if (adpIdx >= 0) {
+          console.error('  (tried the path for --adapter ' + (args[adpIdx + 1] || '') + ')');
+        }
         process.exit(1);
       }
       const topIdx = args.indexOf('--top');

package/package.json

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

package/src/retrieval/ranker.js

@@ -141,24 +141,45 @@ function rank(query, sigIndex, opts) {
 }
 
 /**
- * Build a signature index from the generated context file.
- * Returns Map<filePath, string[]> where filePath is the relative path
- * as it appears in the ### headers of copilot-instructions.md.
+ * All paths where sigmap adapters write their context files, in probe order.
+ * The first existing file with a non-empty index wins when no explicit path
+ * is supplied.
+ */
+const ADAPTER_OUTPUT_PATHS = [
+  ['.github', 'copilot-instructions.md'], // copilot (default)
+  ['CLAUDE.md'],                           // claude
+  ['AGENTS.md'],                           // codex
+  ['.cursorrules'],                        // cursor
+  ['.windsurfrules'],                      // windsurf
+  ['.github', 'openai-context.md'],        // openai
+  ['.github', 'gemini-context.md'],        // gemini
+  ['llm-full.txt'],                        // llm-full
+  ['llm.txt'],                             // llm
+];
+
+/**
+ * Parse a single context file into a Map<filePath, string[]>.
  *
- * @param {string} cwd
+ * Files that contain human-written content before an
+ * "## Auto-generated signatures" marker (e.g. CLAUDE.md) are handled
+ * by skipping everything above the marker before scanning for ### headers.
+ *
+ * @param {string} contextPath  - absolute path to the context file
  * @returns {Map<string, string[]>}
  */
-function buildSigIndex(cwd) {
-  const fs   = require('fs');
-  const path = require('path');
-  const contextPath = path.join(cwd, '.github', 'copilot-instructions.md');
+function _parseContextFile(contextPath) {
+  const fs = require('fs');
   const index = new Map();
 
   if (!fs.existsSync(contextPath)) return index;
 
-  const content = fs.readFileSync(contextPath, 'utf8');
-  const lines = content.split('\n');
+  let content = fs.readFileSync(contextPath, 'utf8');
 
+  // Skip any human-written preamble that sits above the auto-generated block.
+  const markerIdx = content.indexOf('## Auto-generated signatures');
+  if (markerIdx !== -1) content = content.slice(markerIdx);
+
+  const lines = content.split('\n');
   let currentFile = null;
   let inBlock = false;
   let sigs = [];
@@ -180,6 +201,40 @@ function buildSigIndex(cwd) {
   return index;
 }
 
+/**
+ * Build a signature index from the generated context file.
+ * Returns Map<filePath, string[]> where filePath is the relative path
+ * as it appears in the ### headers of the context file.
+ *
+ * When `opts.contextPath` is provided, that specific file is used.
+ * This is the case when the caller already knows the path (e.g. via
+ * --adapter <name> or --output <file>).
+ *
+ * Otherwise all known adapter output paths are probed in order and the
+ * first file that produces a non-empty index is returned.
+ *
+ * @param {string} cwd
+ * @param {{ contextPath?: string }} [opts]
+ * @returns {Map<string, string[]>}
+ */
+function buildSigIndex(cwd, opts) {
+  const path = require('path');
+
+  // Caller supplied an explicit path — use it directly.
+  if (opts && opts.contextPath) {
+    return _parseContextFile(opts.contextPath);
+  }
+
+  // Probe all known adapter output paths; return first non-empty index.
+  for (const parts of ADAPTER_OUTPUT_PATHS) {
+    const contextPath = path.join(cwd, ...parts);
+    const index = _parseContextFile(contextPath);
+    if (index.size > 0) return index;
+  }
+
+  return new Map();
+}
+
 /**
  * Format ranked results as a markdown table string.
  *