feat(v3.0): implement multi-adapter architecture (#28)

- Add packages/adapters/ with 6 adapters: copilot, claude, cursor, windsurf, openai, gemini
- Add packages/adapters/index.js registry with getAdapter(), listAdapters(), adapt(), outputsToAdapters()
- Add adapt() to packages/core/index.js public API
- Add --adapter <name> CLI flag to gen-context.js
- Add bundled adapter factories in gen-context.js for zero-dep compatibility
- Backward compat: existing 'outputs' config key continues to work
- Bump all versions to 3.0.0
- Add 20 integration tests (test/integration/adapters.test.js)
- Update CHANGELOG, README, all docs/*.html pages

Author: manojmallick

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "java.configuration.updateBuildConfiguration": "interactive"
+}

CHANGELOG.md

@@ -6,7 +6,29 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
-## [2.10.0] — upcoming · [#25](https://github.com/manojmallick/sigmap/issues/25) · branch: `feat/v2.10-reporting-charts-advanced-metrics`
+## [3.0.0] — 2026-04-06 — Platform: Multi-Adapter Architecture
+
+### Added
+- **Multi-adapter platform** — `packages/adapters/` with 6 output adapters: `copilot`, `claude`, `cursor`, `windsurf`, `openai`, `gemini`
+- **`--adapter <name>` CLI flag** — generate output for a specific adapter only (e.g. `node gen-context.js --adapter openai`)
+- **`adapt()` in packages/core** — programmatic API: `const { adapt } = require('sigmap'); adapt(context, 'openai')`
+- **New config key `adapters`** — replaces `outputs`; old `outputs` key is silently mapped for full backward compatibility
+- **OpenAI adapter** — formats context as an OpenAI system prompt, writes `.github/openai-context.md`
+- **Gemini adapter** — formats context as a Gemini system instruction, writes `.github/gemini-context.md`
+- **API stability guarantee** — `packages/core` API is now semver-stable; breaking changes require v4.0
+- **20 new integration tests** in `test/integration/adapters.test.js`
+
+### Changed
+- `packages/core/index.js` — adds `adapt()` export alongside existing `extract`, `rank`, `scan`, `score`, `buildSigIndex`
+- `writeOutputs()` in `gen-context.js` — now routes `openai`, `gemini` through adapter pipeline
+
+### Backward compat
+- `outputs: ["copilot","claude"]` config still works — automatically mirrored to `adapters`
+- All existing CLI flags unchanged
+
+---
+
+## [2.10.0] — 2026-04-06 · [#25](https://github.com/manojmallick/sigmap/issues/25)
 
 ### Planned additions
 - **Report charts** — add chart-ready output for token reduction, signatures per file, and budget utilization trends.

README.md

@@ -123,20 +123,38 @@ AI agent session starts with full context
 | **Evaluation dashboard output** | Generate shareable HTML/JSON benchmark summaries from CLI runs |
 | **CI-friendly metrics export** | Persist machine-readable metrics for release gates and regression tracking |
 | **Release quality gates** | Add pass/fail thresholds for hit@5 and precision before publish |
+## 🔌 v3.0 — Platform: Multi-Adapter Architecture
 
----
-| **`get_impact` MCP tool** | 9th MCP tool — `{ file, depth? }` → impacted files + signatures |
-| **`src/map/dep-graph.js`** | Reverse-dependency graph built from the import analysis; circular deps handled safely |
-| **15 new tests** | `impact.test.js` — direct deps, transitive deps, depth limit, JSON output |
+SigMap is now an **adapter platform**. Any AI assistant — Copilot, Claude, Cursor, Windsurf, OpenAI, or Gemini — plugs in through a standard interface.
 
----
+```bash
+# Generate for a specific AI assistant
+node gen-context.js --adapter copilot    # → .github/copilot-instructions.md
+node gen-context.js --adapter openai     # → .github/openai-context.md
+node gen-context.js --adapter gemini     # → .github/gemini-context.md
+node gen-context.js --adapter claude     # → CLAUDE.md (append)
+```
 
-## 🚀 Quick start
+```js
+// Programmatic API — fully semver-stable from v3.0
+const { adapt } = require('sigmap');
+const systemPrompt = adapt(context, 'openai', { version: '3.0.0' });
+```
 
-**No install required — just Node.js 18+.**
+| Adapter | Output file | AI assistant |
+|---|---|---|
+| `copilot` | `.github/copilot-instructions.md` | GitHub Copilot |
+| `claude` | `CLAUDE.md` (append) | Claude / Claude Code |
+| `cursor` | `.cursorrules` | Cursor |
+| `windsurf` | `.windsurfrules` | Windsurf |
+| `openai` | `.github/openai-context.md` | Any OpenAI model |
+| `gemini` | `.github/gemini-context.md` | Google Gemini |
 
-```bash
-# 1. Copy gen-context.js into your project root
+**Backward compat:** existing `outputs` config key silently maps to `adapters` — no migration needed.
+
+See full roadmap: [manojmallick.github.io/sigmap/roadmap.html](https://manojmallick.github.io/sigmap/roadmap.html)
+
+---
 curl -O https://raw.githubusercontent.com/manojmallick/sigmap/main/gen-context.js
 
 # 2. Generate your context file

docs/cli.html

@@ -185,7 +185,7 @@ <h2>All flags at a glance</h2>
       <span class="term-title">node gen-context.js --help</span>
     </div>
     <div class="term-body">
-      <div><span class="tp">SigMap v2.10.0</span></div>
+      <div><span class="tp">SigMap v3.0.0</span></div>
       <div>&nbsp;</div>
       <div><span class="tc">Usage:</span> <span class="tw">node gen-context.js [flag]</span></div>
       <div>&nbsp;</div>
@@ -205,6 +205,8 @@ <h2>All flags at a glance</h2>
       <div><span class="ts">  --benchmark             </span><span class="tc">Run retrieval quality benchmark (hit@5 / MRR)</span></div>
       <div><span class="ts">  --benchmark --json      </span><span class="tc">Benchmark results as JSON</span></div>
       <div><span class="ts">  --eval                  </span><span class="tc">Alias for --benchmark</span></div>
+      <div><span class="ts">  --adapter &lt;name&gt;        </span><span class="tc">Generate for one adapter: copilot|claude|cursor|windsurf|openai|gemini (v3.0+)</span></div>
+      <div><span class="ts">  --adapter &lt;name&gt; --json </span><span class="tc">Show adapter output path as JSON</span></div>
       <div><span class="ts">  --report                </span><span class="tc">Token reduction stats</span></div>
       <div><span class="ts">  --report --json         </span><span class="tc">Token report as JSON (CI-compatible, exits 1 if over budget)</span></div>
       <div><span class="ts">  --report --history      </span><span class="tc">Historical usage trends</span></div>
@@ -609,7 +611,7 @@ <h2>Explore further</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.10.0</span>
+    <span class="footer-logo">sigmap v3.0.0</span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/config.html

@@ -472,7 +472,7 @@ <h2>Explore further</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.10.0</span>
+    <span class="footer-logo">sigmap v3.0.0</span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/index.html

@@ -438,7 +438,7 @@ <h2>Built for the community</h2>
 <!-- FOOTER -->
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.10.0 &middot; <a href="roadmap.html#v2.10" style="color:var(--gd);text-decoration:none">Latest</a></span>
+    <span class="footer-logo">sigmap v3.0.0 &middot; <a href="roadmap.html#v3.0" style="color:var(--gd);text-decoration:none">Latest</a></span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/languages.html

@@ -619,7 +619,7 @@ <h2>Contributing is simple</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.10.0 &middot; <a href="roadmap.html#v2.10" style="color:var(--gd);text-decoration:none">Latest</a></span>
+    <span class="footer-logo">sigmap v3.0.0 &middot; <a href="roadmap.html#v3.0" style="color:var(--gd);text-decoration:none">Latest</a></span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/mcp.html

@@ -512,7 +512,7 @@ <h2>Explore further</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.10.0</span>
+    <span class="footer-logo">sigmap v3.0.0</span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/quick-start.html

@@ -442,7 +442,7 @@ <h2>Command reference</h2>
       <span class="term-title">node gen-context.js --help</span>
     </div>
     <div class="term-body">
-      <div><span class="tp">SigMap v2.10.0 &middot; <a href="roadmap.html#v2.10" style="color:var(--gd);text-decoration:none">Latest</a></span></div>
+      <div><span class="tp">SigMap v3.0.0 &middot; <a href="roadmap.html#v3.0" style="color:var(--gd);text-decoration:none">Latest</a></span></div>
       <div>&nbsp;</div>
       <div><span class="tc">Usage:</span> <span class="tw">node gen-context.js [flag]</span></div>
       <div>&nbsp;</div>
@@ -486,7 +486,7 @@ <h2>Explore further</h2>
       <div class="next-card-desc">Stack both tools for the two-layer caching strategy. SigMap for daily; Repomix for deep sessions.</div>
     </a>
     <a class="next-card" href="roadmap.html">
-      <div class="next-card-ey">v0.1 → v2.10</div>
+      <div class="next-card-ey">v0.1 → v3.0</div>
       <div class="next-card-title">Full roadmap</div>
       <div class="next-card-desc">All major versions shipped. 97% token reduction. 340 tests. MIT license.</div>
     </a>
@@ -495,7 +495,7 @@ <h2>Explore further</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.10.0 &middot; <a href="roadmap.html#v2.10" style="color:var(--gd);text-decoration:none">Latest</a></span>
+    <span class="footer-logo">sigmap v3.0.0 &middot; <a href="roadmap.html#v3.0" style="color:var(--gd);text-decoration:none">Latest</a></span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/roadmap.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width,initial-scale=1.0">
 <title>Roadmap — SigMap</title>
-<meta name="description" content="SigMap shipped v0.1 through v2.10 — 97% token reduction, 340+ tests. Reporting charts and advanced metrics are the current milestone. Full visual timeline from baseline to complete system.">
+<meta name="description" content="SigMap shipped v0.1 through v3.0 — 97% token reduction, 360+ tests. Multi-adapter platform (Copilot, Claude, Cursor, Windsurf, OpenAI, Gemini) is the current milestone. Full visual timeline from baseline to complete system.">
 <meta property="og:title" content="SigMap Roadmap — v0.1 to v2.10 · 97% token reduction">
 <meta property="og:description" content="25 versions shipped/planned. 97% token reduction. 340 tests. MIT license. See how SigMap evolved from first extractor to full context platform.">
 <meta property="og:url" content="https://manojmallick.github.io/sigmap/roadmap.html">
@@ -145,8 +145,8 @@
 
 <div class="page-hero">
   <div class="hero-inner">
-    <div class="hero-badge"><span class="dot" style="background:var(--g)"></span>v2.10 in progress</div>
-    <h1>v0.0 → v2.10</h1>
+    <div class="hero-badge"><span class="dot" style="background:var(--g)"></span>v3.0.0 released</div>
+    <h1>v0.0 → v3.0</h1>
     <p class="hero-sub">Twenty-five versions shipped/planned. Reporting charts and advanced metrics are now the active milestone. MIT open source from day one.</p>
     <div class="hero-stats">
       <div class="hstat"><span class="hstat-val p">97%</span><span class="hstat-lbl">Token reduction</span></div>
@@ -908,7 +908,7 @@ <h2>Every version, every feature</h2>
         <div class="tl-header">
           <span class="tl-version">v2.10</span>
           <span class="tl-name">Reporting — Charts + Advanced Metrics</span>
-          <span class="tl-badge done">● In progress</span>
+          <span class="tl-badge done">✓ Complete — tagged v2.10.0</span>
         </div>
         <div class="tl-desc">Adds chart-ready reporting for token reduction and signature coverage, plus advanced benchmark metrics such as precision@K, recall@K, and MRR trends. Includes richer CLI report output and CI-friendly JSON artifacts for release quality gates.</div>
         <div class="tl-tags">
@@ -923,22 +923,46 @@ <h2>Every version, every feature</h2>
       </div>
     </div>
 
+    <!-- v3.0 -->
+    <div id="v3.0" class="tl-item">
+      <div class="tl-rail">
+        <div class="tl-dot done">v3.0</div>
+      </div>
+      <div class="tl-content">
+        <div class="tl-header">
+          <span class="tl-version">v3.0</span>
+          <span class="tl-name">Platform — Multi-Adapter Architecture</span>
+          <span class="tl-badge done">✓ Complete — tagged v3.0.0</span>
+        </div>
+        <div class="tl-desc">SigMap becomes an adapter platform. Six output adapters ship: <code>copilot</code>, <code>claude</code>, <code>cursor</code>, <code>windsurf</code>, <code>openai</code>, and <code>gemini</code>. New <code>--adapter &lt;name&gt;</code> CLI flag generates output for a specific adapter. <code>packages/core</code> gains <code>adapt(context, adapterName)</code> for programmatic use. Old <code>outputs</code> config key silently maps to <code>adapters</code> — full backward compatibility. API stability guarantee: breaking changes require v4.0.</div>
+        <div class="tl-tags">
+          <span class="tl-tag">6 adapters</span>
+          <span class="tl-tag">openai</span>
+          <span class="tl-tag">gemini</span>
+          <span class="tl-tag">adapt() API</span>
+          <span class="tl-tag">backward compat</span>
+          <span class="tl-tag">semver-stable core</span>
+        </div>
+        <div class="tl-impact">Platform milestone — SigMap works with any AI assistant, not just Copilot</div>
+      </div>
+    </div>
+
   </div>
 </section>
 
 <hr class="divider">
 
 <section class="section">
   <p class="section-ey">Final numbers</p>
-  <h2>v2.10.0 — Current milestone</h2>
+  <h2>v3.0.0 — Current milestone</h2>
 
   <div class="final-grid">
     <div class="final-stat">
       <span class="final-stat-val p">97%</span>
       <div class="final-stat-lbl">Token reduction</div>
     </div>
     <div class="final-stat">
-      <span class="final-stat-val g">340</span>
+      <span class="final-stat-val g">360</span>
       <div class="final-stat-lbl">Tests passing</div>
     </div>
     <div class="final-stat">
@@ -959,7 +983,7 @@ <h2>v2.10.0 — Current milestone</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.10.0 &middot; <span style="color:var(--gd)">Latest</span></span>
+    <span class="footer-logo">sigmap v3.0.0 &middot; <span style="color:var(--gd)">Latest</span></span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>