sigmap 3.3.0 → 3.3.1

package/CHANGELOG.md

@@ -10,6 +10,17 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [3.3.1] — 2026-04-10 — Patch: `--each --adapter` flag combination
+
+### Fixed
+- **`--each --adapter <name>` now works correctly** · [#37](https://github.com/manojmallick/sigmap/issues/37)
+  - Running `sigmap --each --adapter claude` (or any adapter) from a parent directory containing multiple git repos now correctly writes the chosen adapter output (e.g. `CLAUDE.md`) inside each sub-repo.
+  - Root cause: the `--adapter` handler ran before `--each` in `main()`, so `--each` was never reached when both flags were supplied together. The `--each` block is now evaluated first.
+  - `runEach()` accepts an optional `adapterOverride` parameter that merges `outputs`/`adapters` into each sub-repo's config before calling `runGenerate`, mirroring how the standalone `--adapter` flag works.
+  - Invalid adapter names passed alongside `--each` now exit non-zero with a clear error message listing valid adapters.
+
+---
+
 ## [3.3.0] — 2026-04-08 — Context-Aware CLI & Command Switcher
 
 ### Added

package/README.md

@@ -9,9 +9,11 @@
   Multiple install options. Zero runtime dependencies. Requires only Node.js 18+.
 </p>
 
+<img src="docs/sigmap-banner.png" alt="SigMap — AI context engine" width="700">
+
 <!-- Status -->
 [![npm version](https://img.shields.io/npm/v/sigmap?color=7c6af7&label=latest&logo=npm)](https://www.npmjs.com/package/sigmap)
-[![Tests](https://img.shields.io/badge/tests-340%20passing-22c55e)](https://github.com/manojmallick/sigmap/tree/main/test)
+[![CI](https://github.com/manojmallick/sigmap/actions/workflows/ci.yml/badge.svg)](https://github.com/manojmallick/sigmap/actions/workflows/ci.yml)
 [![Zero deps](https://img.shields.io/badge/dependencies-zero-22c55e)](package.json)
 [![Last commit](https://img.shields.io/github/last-commit/manojmallick/sigmap?color=7c6af7)](https://github.com/manojmallick/sigmap/commits/main)
 
@@ -39,7 +41,7 @@
 |---|---|
 | [What it does](#-what-it-does) | Token reduction table, pipeline overview |
 | [Quick start](#-quick-start) | Install (binary or npm), generate in 60 seconds |
-| [Standalone binaries](docs/binaries.md) | macOS, Linux, Windows — no Node required |
+| [Standalone binaries](docs/readmes/binaries.md) | macOS, Linux, Windows — no Node required |
 | [VS Code extension](#-vs-code-extension) | Status bar, stale alerts, commands |
 | [JetBrains plugin](#-jetbrains-plugin) | IntelliJ IDEA, WebStorm, PyCharm support |
 | [Languages supported](#-languages-supported) | 21 languages |
@@ -53,7 +55,7 @@
 | [Project structure](#-project-structure) | File-by-file map |
 | [Principles](#-principles) | Design decisions |
 
-> 📖 **New to SigMap?** Read the **[Complete Getting Started Guide](docs/GETTING_STARTED.md)** — token savings walkthrough, every command, VS Code plugin, and CI setup.
+> 📖 **New to SigMap?** Read the **[Complete Getting Started Guide](docs/readmes/GETTING_STARTED.md)** — token savings walkthrough, every command, VS Code plugin, and CI setup.
 
 ---
 
@@ -198,7 +200,7 @@ shasum -a 256 sigmap-darwin-arm64
 # Compare with sigmap-checksums.txt
 ```
 
-Full guide: [docs/binaries.md](docs/binaries.md)
+Full guide: [docs/readmes/binaries.md](docs/readmes/binaries.md)
 
 </details>
 
@@ -327,7 +329,7 @@ chmod +x ./sigmap-darwin-arm64
 ./sigmap-darwin-arm64
 ```
 
-See [docs/binaries.md](docs/binaries.md) for Gatekeeper / SmartScreen notes and checksum verification.
+See [docs/readmes/binaries.md](docs/readmes/binaries.md) for Gatekeeper / SmartScreen notes and checksum verification.
 
 **npm** (requires Node.js 18+):
 
@@ -402,7 +404,7 @@ The `jetbrains-plugin/` directory contains a Kotlin-based plugin for JetBrains I
 
 Compatible with **IntelliJ IDEA 2024.1+** (Community & Ultimate), **WebStorm**, **PyCharm**, **GoLand**, **RubyMine**, **PhpStorm**, and all other IntelliJ-based IDEs.
 
-**Install:** [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/31109-sigmap--ai-context-engine/) | [Manual setup guide](docs/JETBRAINS_SETUP.md)
+**Install:** [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/31109-sigmap--ai-context-engine/) | [Manual setup guide](docs/readmes/JETBRAINS_SETUP.md)
 
 ---
 
@@ -484,7 +486,7 @@ One `.github/context-<module>.md` per top-level source directory, plus a tiny ov
 
 Recently committed files are **hot** (auto-injected). Everything else is **cold** (on-demand via MCP). Best reduction available — ~200 tokens always-on.
 
-📖 Full guide: [docs/CONTEXT_STRATEGIES.md](docs/CONTEXT_STRATEGIES.md) — decision tree, scenario comparisons, migration steps.
+📖 Full guide: [docs/readmes/CONTEXT_STRATEGIES.md](docs/readmes/CONTEXT_STRATEGIES.md) — decision tree, scenario comparisons, migration steps.
 
 ---
 
@@ -511,7 +513,7 @@ node gen-context.js --mcp
 
 Reads files on every call — no stale state, no restart needed.
 
-📖 Setup guide: [docs/MCP_SETUP.md](docs/MCP_SETUP.md)
+📖 Setup guide: [docs/readmes/MCP_SETUP.md](docs/readmes/MCP_SETUP.md)
 
 ---
 
@@ -519,48 +521,57 @@ Reads files on every call — no stale state, no restart needed.
 
 > See [CHANGELOG.md](CHANGELOG.md) for the full history.
 
+All flags are the same regardless of how you invoke SigMap — swap the prefix to match your install:
+
+> `sigmap` · `npx sigmap` · `gen-context` · `node gen-context.js`
+
+<details>
+<summary><strong>All flags</strong></summary>
+
 ```
-node gen-context.js                           Generate once and exit
-node gen-context.js --watch                   Generate and watch for file changes
-node gen-context.js --setup                   Generate + install git hook + start watcher
-node gen-context.js --diff                    Generate context for git-changed files only
-node gen-context.js --diff --staged           Staged files only (pre-commit check)
-node gen-context.js --mcp                     Start MCP server on stdio
+sigmap                                        Generate once and exit
+sigmap --watch                                Generate and watch for file changes
+sigmap --setup                                Generate + install git hook + start watcher
+sigmap --diff                                 Generate context for git-changed files only
+sigmap --diff --staged                        Staged files only (pre-commit check)
+sigmap --mcp                                  Start MCP server on stdio
 
-node gen-context.js --query "<text>"          Rank files by relevance to a query
-node gen-context.js --query "<text>" --json   Ranked results as JSON
-node gen-context.js --query "<text>" --top <n> Limit results to top N files (default 10)
+sigmap --query "<text>"                       Rank files by relevance to a query
+sigmap --query "<text>" --json                Ranked results as JSON
+sigmap --query "<text>" --top <n>             Limit results to top N files (default 10)
 
-node gen-context.js --analyze                 Per-file breakdown (sigs / tokens / extractor / coverage)
-node gen-context.js --analyze --json          Analysis as JSON
-node gen-context.js --analyze --slow          Include extraction timing per file
-node gen-context.js --diagnose-extractors     Self-test all 21 extractors against fixtures
+sigmap --analyze                              Per-file breakdown (sigs / tokens / extractor / coverage)
+sigmap --analyze --json                       Analysis as JSON
+sigmap --analyze --slow                       Include extraction timing per file
+sigmap --diagnose-extractors                  Self-test all 21 extractors against fixtures
 
-node gen-context.js --benchmark               Run retrieval quality benchmark (hit@5 / MRR)
-node gen-context.js --benchmark --json        Benchmark results as JSON
-node gen-context.js --eval                    Alias for --benchmark
+sigmap --benchmark                            Run retrieval quality benchmark (hit@5 / MRR)
+sigmap --benchmark --json                     Benchmark results as JSON
+sigmap --eval                                 Alias for --benchmark
 
-node gen-context.js --report                  Token reduction stats
-node gen-context.js --report --json           Structured JSON report (exits 1 if over budget)
-node gen-context.js --report --history        Usage log summary
-node gen-context.js --report --history --json Usage history as JSON
+sigmap --report                               Token reduction stats
+sigmap --report --json                        Structured JSON report (exits 1 if over budget)
+sigmap --report --history                     Usage log summary
+sigmap --report --history --json              Usage history as JSON
 
-node gen-context.js --health                  Composite health score (0–100, grade A–D)
-node gen-context.js --health --json           Machine-readable health JSON
+sigmap --health                               Composite health score (0–100, grade A–D)
+sigmap --health --json                        Machine-readable health JSON
 
-node gen-context.js --suggest-tool "<task>"   Recommend model tier for a task
-node gen-context.js --suggest-tool "<task>" --json  Machine-readable tier recommendation
+sigmap --suggest-tool "<task>"                Recommend model tier for a task
+sigmap --suggest-tool "<task>" --json         Machine-readable tier recommendation
 
-node gen-context.js --monorepo                Per-package context for monorepos (packages/, apps/, services/)
-node gen-context.js --each                    Process each sub-repo under a parent directory
-node gen-context.js --routing                 Include model routing hints in output
-node gen-context.js --format cache            Write Anthropic prompt-cache JSON
-node gen-context.js --track                   Append run metrics to .context/usage.ndjson
+sigmap --monorepo                             Per-package context for monorepos (packages/, apps/, services/)
+sigmap --each                                 Process each sub-repo under a parent directory
+sigmap --routing                              Include model routing hints in output
+sigmap --format cache                         Write Anthropic prompt-cache JSON
+sigmap --track                                Append run metrics to .context/usage.ndjson
 
-node gen-context.js --init                    Write config + .contextignore scaffold
-node gen-context.js --version                 Version string
-node gen-context.js --help                    Usage information
+sigmap --init                                 Write config + .contextignore scaffold
+sigmap --version                              Version string
+sigmap --help                                 Usage information
 ```
+</details>
+
 
 ### Task classification — `--suggest-tool`
 
@@ -689,7 +700,7 @@ Copy `examples/self-healing-github-action.yml` to `.github/workflows/` to auto-r
   run: node gen-context.js
 ```
 
-📖 Full guide: [docs/ENTERPRISE_SETUP.md](docs/ENTERPRISE_SETUP.md)
+📖 Full guide: [docs/readmes/ENTERPRISE_SETUP.md](docs/readmes/ENTERPRISE_SETUP.md)
 
 ### Prompt caching — 60% API cost reduction
 
@@ -699,7 +710,7 @@ node gen-context.js --format cache
 # Format: { type: 'text', text: '...', cache_control: { type: 'ephemeral' } }
 ```
 
-📖 Full guide: [docs/REPOMIX_CACHE.md](docs/REPOMIX_CACHE.md)
+📖 Full guide: [docs/readmes/REPOMIX_CACHE.md](docs/readmes/REPOMIX_CACHE.md)
 
 ---
 

package/gen-context.js

@@ -5049,7 +5049,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '3.3.0';
+const VERSION = '3.3.1';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -6257,7 +6257,7 @@ function detectRepoDirs(cwd) {
   return repos;
 }
 
-function runEach(cwd, baseConfig) {
+function runEach(cwd, baseConfig, adapterOverride) {
   const repos = detectRepoDirs(cwd);
   if (repos.length === 0) {
     console.warn('[sigmap] --each: no project subdirectories found');
@@ -6276,6 +6276,13 @@ function runEach(cwd, baseConfig) {
     } catch (_) {
       repoConfig = { ...baseConfig };
     }
+    // --adapter override: apply on top of per-repo config
+    if (adapterOverride) {
+      repoConfig = Object.assign({}, repoConfig, {
+        outputs: adapterOverride === 'claude' ? ['claude'] : [adapterOverride],
+        adapters: [adapterOverride],
+      });
+    }
     console.warn(`[sigmap] --each: processing ${name} …`);
     try {
       runGenerate(repoDir, repoConfig, false);
@@ -6748,6 +6755,23 @@ function main() {
     process.exit(0);
   }
 
+  // ── --each [--adapter <name>] ────────────────────────────────────────────
+  // Must be checked before --adapter so that --each --adapter <name> is
+  // handled here (per-repo) rather than running a single generate on the
+  // parent directory.
+  if (args.includes('--each')) {
+    const VALID_ADAPTERS = ['copilot', 'claude', 'cursor', 'windsurf', 'openai', 'gemini'];
+    const adpIdx = args.indexOf('--adapter');
+    const adapterOverride = adpIdx >= 0 ? (args[adpIdx + 1] || '').trim().toLowerCase() : null;
+    if (adapterOverride && !VALID_ADAPTERS.includes(adapterOverride)) {
+      console.error(`[sigmap] --each: unknown adapter "${adapterOverride}"`);
+      console.error(`  Valid adapters: ${VALID_ADAPTERS.join(', ')}`);
+      process.exit(1);
+    }
+    runEach(cwd, config, adapterOverride || null);
+    process.exit(0);
+  }
+
   // ── --adapter <name> ───────────────────────────────────────────────────────
   if (args.includes('--adapter')) {
     try {
@@ -6867,11 +6891,6 @@ function main() {
     process.exit(0);
   }
 
-  if (args.includes('--each')) {
-    runEach(cwd, config);
-    process.exit(0);
-  }
-
   if (args.includes('--setup')) {
     runGenerate(cwd, config, false);
     installHook(cwd, scriptPath);

package/package.json

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

package/packages/cli/package.json

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