release: prep v2.10 reporting docs and version sync

Author: manojmallick

CHANGELOG.md

@@ -6,6 +6,23 @@ 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`
+
+### 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

README.md

@@ -112,17 +112,17 @@ 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 |
 
 ---
 | **`get_impact` MCP tool** | 9th MCP tool — `{ file, depth? }` → impacted files + signatures |
@@ -722,6 +722,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>

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.8.0</span></div>
+      <div><span class="tp">SigMap v2.10.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>
@@ -609,7 +609,7 @@ <h2>Explore further</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.9.0</span>
+    <span class="footer-logo">sigmap v2.10.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.9.0</span>
+    <span class="footer-logo">sigmap v2.10.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.9.0 &middot; <a href="roadmap.html#v2.9" style="color:var(--gd);text-decoration:none">Latest</a></span>
+    <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>
     <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.9.0 &middot; <a href="roadmap.html#v2.9" style="color:var(--gd);text-decoration:none">Latest</a></span>
+    <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>
     <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.9.0</span>
+    <span class="footer-logo">sigmap v2.10.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.8.0 &middot; <a href="roadmap.html#v2.8" style="color:var(--gd);text-decoration:none">Latest</a></span></div>
+      <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>&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.6</div>
+      <div class="next-card-ey">v0.1 → v2.10</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.9.0 &middot; <a href="roadmap.html#v2.9" style="color:var(--gd);text-decoration:none">Latest</a></span>
+    <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>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/repomix.html

@@ -518,7 +518,7 @@ <h2>Both tools, five minutes</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.9.0</span>
+    <span class="footer-logo">sigmap v2.10.0</span>
     <div class="footer-links">
       <a href="quick-start.html">Quick start</a>
       <a href="cli.html">CLI reference</a>

docs/roadmap.html

@@ -4,15 +4,15 @@
 <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.9 — 97% token reduction, 340+ tests. Impact layer, query-aware retrieval, research-grade benchmarks, ranking optimization, snippet retrieval, and JetBrains plugin complete. Full visual timeline from baseline to complete system.">
-<meta property="og:title" content="SigMap Roadmap — v0.1 to v2.9 complete · 97% token reduction">
-<meta property="og:description" content="24 versions shipped. 97% token reduction. 340 tests. MIT license. See how SigMap was built from first extractor to full enterprise system.">
+<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 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">
 <meta name="twitter:card" content="summary_large_image">
 <meta property="og:image" content="https://manojmallick.github.io/sigmap/sigmap-banner.png">
 <meta name="twitter:image" content="https://manojmallick.github.io/sigmap/sigmap-banner.png">
 <link rel="canonical" href="https://manojmallick.github.io/sigmap/roadmap.html">
-<script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"SigMap roadmap — v0.1 to v2.8 complete","description":"23 versions shipped. 97% token reduction. 340+ tests. MIT license. Impact layer, query-aware retrieval, research-grade benchmarks, ranking optimization, and snippet retrieval shipped. See how SigMap was built from first extractor to full enterprise system.","url":"https://manojmallick.github.io/sigmap/roadmap.html","author":{"@type":"Person","name":"Manoj Mallick","url":"https://github.com/manojmallick"},"isPartOf":{"@type":"WebSite","name":"SigMap","url":"https://manojmallick.github.io/sigmap/"}}</script>
+<script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"SigMap roadmap — v0.1 to v2.10","description":"25 versions shipped/planned. 97% token reduction. 340+ tests. MIT license. Reporting charts and advanced metrics are the current milestone.","url":"https://manojmallick.github.io/sigmap/roadmap.html","author":{"@type":"Person","name":"Manoj Mallick","url":"https://github.com/manojmallick"},"isPartOf":{"@type":"WebSite","name":"SigMap","url":"https://manojmallick.github.io/sigmap/"}}</script>
 <link href="https://fonts.googleapis.com/css2?family=Syne:wght@700;800&family=IBM+Plex+Mono:wght@400;500&family=DM+Sans:wght@300;400;500;600&display=swap" rel="stylesheet">
 <script>(function(){var r=document.documentElement;if(localStorage.getItem('cf-theme')==='light')r.classList.add('light');document.addEventListener('DOMContentLoaded',function(){document.querySelectorAll('.theme-toggle').forEach(function(b){b.addEventListener('click',function(){r.classList.toggle('light');localStorage.setItem('cf-theme',r.classList.contains('light')?'light':'dark');});});});})();</script>
 <style>
@@ -145,9 +145,9 @@
 
 <div class="page-hero">
   <div class="hero-inner">
-    <div class="hero-badge"><span class="dot" style="background:var(--g)"></span>v2.6 released</div>
-    <h1>v0.0 → v2.6</h1>
-    <p class="hero-sub">Twenty-one versions shipped. Impact layer, query-aware retrieval, and research-grade benchmarks complete. MIT open source from day one.</p>
+    <div class="hero-badge"><span class="dot" style="background:var(--g)"></span>v2.10 in progress</div>
+    <h1>v0.0 → v2.10</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>
       <div class="hstat"><span class="hstat-val g">340</span><span class="hstat-lbl">Tests passing</span></div>
@@ -899,14 +899,38 @@ <h2>Every version, every feature</h2>
       </div>
     </div>
 
+    <!-- v2.10 -->
+    <div id="v2.10" class="tl-item">
+      <div class="tl-rail">
+        <div class="tl-dot done">v2.10</div>
+      </div>
+      <div class="tl-content">
+        <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>
+        </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">
+          <span class="tl-tag">report charts</span>
+          <span class="tl-tag">advanced metrics</span>
+          <span class="tl-tag">precision@K</span>
+          <span class="tl-tag">recall@K</span>
+          <span class="tl-tag">MRR trend</span>
+          <span class="tl-tag">issue #25</span>
+        </div>
+        <div class="tl-impact">Release confidence — measurable quality gates for retrieval and token efficiency</div>
+      </div>
+    </div>
+
   </div>
 </section>
 
 <hr class="divider">
 
 <section class="section">
   <p class="section-ey">Final numbers</p>
-  <h2>v2.9.0 — Complete feature set</h2>
+  <h2>v2.10.0 — Current milestone</h2>
 
   <div class="final-grid">
     <div class="final-stat">
@@ -935,7 +959,7 @@ <h2>v2.9.0 — Complete feature set</h2>
 
 <footer>
   <div class="footer-inner">
-    <span class="footer-logo">sigmap v2.9.0 &middot; <span style="color:var(--gd)">Latest</span></span>
+    <span class="footer-logo">sigmap v2.10.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>