sigmap 2.9.1 → 3.0.0

package/CHANGELOG.md

@@ -6,6 +6,45 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [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.
+- **Advanced metrics** — extend evaluation output with precision@K, recall@K, MRR, and query-level diagnostics.
+- **CLI reporting mode** — introduce richer report surfaces for both human-readable tables and structured JSON artifacts.
+- **Benchmark visibility** — include comparative metrics across runs to track regressions and improvements over time.
+- **Docs refresh** — align roadmap and docs site references to the v2.10 milestone.
+
+### Go / No-go criteria
+- Full test suite passes (extractor + integration).
+- Report output includes chart-friendly numeric series and summary stats.
+- Benchmark metrics remain stable or improve versus v2.9 baseline.
+- Generated docs and release metadata are version-synced to `2.10.0`.
+
+---
+
 ## [2.9.1] — 2026-04-06 · JetBrains Marketplace Publishing
 
 ### Added

package/README.md

@@ -112,31 +112,49 @@ AI agent session starts with full context
 
 ---
 
-## 🔭 What's next — v2.9 (in progress · [#23](https://github.com/manojmallick/sigmap/issues/23))
+## 🔭 What's next — v2.10 (in progress · [#25](https://github.com/manojmallick/sigmap/issues/25))
 
-### v2.9 — IDE Expansion: JetBrains Plugin
+### v2.10 — Reporting: Charts + Advanced Metrics
 
 | Feature | Description |
 |---|---|
-| **JetBrains plugin** | Install SigMap natively in IntelliJ IDEA, WebStorm, PyCharm, GoLand, RubyMine |
-| **Toolbar actions** | "Regenerate Context", "Open Context File", "View Roadmap" buttons |
-| **Settings panel** | Configure srcDirs, exclude patterns, maxTokens, routing presets from IDE |
-| **File watcher** | Auto-regenerate context on file changes (opt-in) |
-| **Marketplace publishing** | Automated publishing to JetBrains Marketplace via GitHub Actions |
+| **Charts in reports** | Visualize token reduction, signature counts, and budget usage per run |
+| **Advanced retrieval metrics** | Add precision@K, recall@K, MRR trend, and query-level diagnostics |
+| **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
@@ -722,6 +740,6 @@ MIT © 2026 [Manoj Mallick](https://github.com/manojmallick) · Made in Amsterda
 
 If SigMap saves you time — a ⭐ on [GitHub](https://github.com/manojmallick/sigmap) helps others find it.
 
-**[Docs](https://manojmallick.github.io/sigmap) · [Changelog](CHANGELOG.md) · [Roadmap](docs/roadmap.html) · [Repomix](https://github.com/yamadashy/repomix)**
+**[Docs](https://manojmallick.github.io/sigmap) · [Changelog](CHANGELOG.md) · [Roadmap](https://manojmallick.github.io/sigmap/roadmap.html) · [Repomix](https://github.com/yamadashy/repomix)**
 
 </div>