sigmap 2.9.1 → 2.10.0

package/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

package/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>

package/gen-context.js

@@ -1937,6 +1937,316 @@ __factories["./src/format/cache"] = function(module, exports) {
   
 };
 
+  // ── ./src/format/dashboard ──
+  __factories["./src/format/dashboard"] = function(module, exports) {
+    const fs = require('fs');
+    const path = require('path');
+    const { readLog } = __require('./src/tracking/logger');
+
+    const LANGUAGE_KEYS = [
+      'typescript', 'javascript', 'python', 'java', 'kotlin', 'go', 'rust',
+      'csharp', 'cpp', 'ruby', 'php', 'swift', 'dart', 'scala', 'vue',
+      'svelte', 'html', 'css', 'yaml', 'shell', 'dockerfile',
+    ];
+
+    function toNumber(v) {
+      const n = Number(v);
+      return Number.isFinite(n) ? n : null;
+    }
+
+    function percentile(values, p) {
+      if (!Array.isArray(values) || values.length === 0) return 0;
+      const sorted = values.filter(Number.isFinite).slice().sort((a, b) => a - b);
+      if (sorted.length === 0) return 0;
+      if (p <= 0) return sorted[0];
+      if (p >= 100) return sorted[sorted.length - 1];
+      const idx = (p / 100) * (sorted.length - 1);
+      const lo = Math.floor(idx);
+      const hi = Math.ceil(idx);
+      if (lo === hi) return sorted[lo];
+      const frac = idx - lo;
+      return sorted[lo] + (sorted[hi] - sorted[lo]) * frac;
+    }
+
+    function overBudgetStreak(entries) {
+      if (!Array.isArray(entries) || entries.length === 0) return 0;
+      let streak = 0;
+      for (let i = entries.length - 1; i >= 0; i--) {
+        if (entries[i] && entries[i].overBudget) streak++;
+        else break;
+      }
+      return streak;
+    }
+
+    function walkFiles(dir, maxDepth, depth, out, excludeSet) {
+      if (depth > maxDepth) return;
+      let entries = [];
+      try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+      } catch (_) {
+        return;
+      }
+      for (const entry of entries) {
+        const abs = path.join(dir, entry.name);
+        const rel = abs.replace(/\\/g, '/');
+        if (excludeSet.has(entry.name) || rel.includes('/node_modules/') || rel.includes('/.git/')) continue;
+        if (entry.isDirectory()) walkFiles(abs, maxDepth, depth + 1, out, excludeSet);
+        else if (entry.isFile()) out.push(abs);
+      }
+    }
+
+    function detectLanguage(filePath) {
+      const base = path.basename(filePath);
+      const ext = path.extname(filePath).toLowerCase();
+      if (base === 'Dockerfile' || /^Dockerfile\./.test(base)) return 'dockerfile';
+      if (ext === '.ts' || ext === '.tsx') return 'typescript';
+      if (ext === '.js' || ext === '.jsx' || ext === '.mjs' || ext === '.cjs') return 'javascript';
+      if (ext === '.py' || ext === '.pyw') return 'python';
+      if (ext === '.java') return 'java';
+      if (ext === '.kt' || ext === '.kts') return 'kotlin';
+      if (ext === '.go') return 'go';
+      if (ext === '.rs') return 'rust';
+      if (ext === '.cs') return 'csharp';
+      if (ext === '.cpp' || ext === '.c' || ext === '.h' || ext === '.hpp' || ext === '.cc') return 'cpp';
+      if (ext === '.rb' || ext === '.rake') return 'ruby';
+      if (ext === '.php') return 'php';
+      if (ext === '.swift') return 'swift';
+      if (ext === '.dart') return 'dart';
+      if (ext === '.scala' || ext === '.sc') return 'scala';
+      if (ext === '.vue') return 'vue';
+      if (ext === '.svelte') return 'svelte';
+      if (ext === '.html' || ext === '.htm') return 'html';
+      if (ext === '.css' || ext === '.scss' || ext === '.sass' || ext === '.less') return 'css';
+      if (ext === '.yml' || ext === '.yaml') return 'yaml';
+      if (ext === '.sh' || ext === '.bash' || ext === '.zsh' || ext === '.fish') return 'shell';
+      return null;
+    }
+
+    function computeExtractorCoverage(cwd) {
+      let cfg = {};
+      try {
+        const cfgPath = path.join(cwd, 'gen-context.config.json');
+        if (fs.existsSync(cfgPath)) cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+      } catch (_) {}
+      const srcDirs = Array.isArray(cfg.srcDirs) && cfg.srcDirs.length > 0
+        ? cfg.srcDirs
+        : ['src', 'app', 'lib', 'packages', 'services', 'api'];
+      const exclude = new Set(['node_modules', '.git', 'dist', 'build', 'out', '__pycache__', '.next', 'coverage', 'target', 'vendor', '.context']);
+      if (Array.isArray(cfg.exclude)) for (const x of cfg.exclude) exclude.add(String(x));
+      const counts = {};
+      for (const k of LANGUAGE_KEYS) counts[k] = 0;
+      const files = [];
+      for (const relDir of srcDirs) {
+        const absDir = path.join(cwd, relDir);
+        if (!fs.existsSync(absDir)) continue;
+        walkFiles(absDir, 8, 0, files, exclude);
+      }
+      for (const f of files) {
+        const lang = detectLanguage(f);
+        if (lang) counts[lang]++;
+      }
+      const covered = LANGUAGE_KEYS.filter((k) => counts[k] > 0).length;
+      const supported = LANGUAGE_KEYS.length;
+      const pct = supported > 0 ? parseFloat(((covered / supported) * 100).toFixed(1)) : 0;
+      return { supported, covered, pct, perLanguage: counts };
+    }
+
+    function readBenchmarkTrend(cwd) {
+      const resultDir = path.join(cwd, 'benchmarks', 'results');
+      if (!fs.existsSync(resultDir)) return [];
+      const files = [];
+      walkFiles(resultDir, 6, 0, files, new Set());
+      const values = [];
+      for (const filePath of files) {
+        const base = path.basename(filePath).toLowerCase();
+        if (!base.endsWith('.json') && !base.endsWith('.jsonl') && !base.endsWith('.ndjson')) continue;
+        let raw = '';
+        try { raw = fs.readFileSync(filePath, 'utf8'); } catch (_) { continue; }
+        if (base.endsWith('.json')) {
+          try {
+            const obj = JSON.parse(raw);
+            const v = toNumber(obj && obj.hitAt5);
+            const m = toNumber(obj && obj.metrics && obj.metrics.hitAt5);
+            if (v !== null) values.push(v);
+            else if (m !== null) values.push(m);
+          } catch (_) {}
+          continue;
+        }
+        for (const line of raw.split('\n').filter(Boolean)) {
+          try {
+            const obj = JSON.parse(line);
+            const v = toNumber(obj && obj.hitAt5);
+            const m = toNumber(obj && obj.metrics && obj.metrics.hitAt5);
+            if (v !== null) values.push(v);
+            else if (m !== null) values.push(m);
+          } catch (_) {}
+        }
+      }
+      return values.slice(-30);
+    }
+
+    function lineChartSvg(values, title, ySuffix) {
+      const width = 760;
+      const height = 210;
+      const left = 38;
+      const right = 18;
+      const top = 22;
+      const bottom = 30;
+      const innerW = width - left - right;
+      const innerH = height - top - bottom;
+      const clean = values.filter((n) => Number.isFinite(n));
+      if (clean.length === 0) {
+        return `<svg viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="${title}"><rect x="0" y="0" width="100%" height="100%" fill="#0f1320" rx="12"/><text x="20" y="36" fill="#d7defa" font-size="14" font-family="monospace">${title}</text><text x="20" y="96" fill="#8ea0d9" font-size="13" font-family="monospace">No data yet. Run with --track and --benchmark.</text></svg>`;
+      }
+      const min = Math.min(...clean);
+      const max = Math.max(...clean);
+      const span = max - min || 1;
+      const points = clean.map((v, i) => {
+        const x = left + ((clean.length === 1 ? 0 : i / (clean.length - 1)) * innerW);
+        const y = top + (1 - ((v - min) / span)) * innerH;
+        return `${x.toFixed(1)},${y.toFixed(1)}`;
+      }).join(' ');
+      const latest = clean[clean.length - 1];
+      const grid = [];
+      for (let i = 0; i <= 4; i++) {
+        const gy = top + (i / 4) * innerH;
+        grid.push(`<line x1="${left}" y1="${gy.toFixed(1)}" x2="${left + innerW}" y2="${gy.toFixed(1)}" stroke="#223056" stroke-width="1"/>`);
+      }
+      return `<svg viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="${title}"><rect x="0" y="0" width="100%" height="100%" fill="#0f1320" rx="12"/><text x="20" y="26" fill="#d7defa" font-size="13" font-family="monospace">${title}</text>${grid.join('')}<polyline fill="none" stroke="#42d392" stroke-width="2.5" points="${points}"/><text x="20" y="${height - 8}" fill="#8ea0d9" font-size="12" font-family="monospace">latest: ${latest.toFixed(2)}${ySuffix || ''}</text></svg>`;
+    }
+
+    function barChartSvg(perLanguage) {
+      const width = 760;
+      const height = 260;
+      const left = 20;
+      const top = 34;
+      const usableW = width - left * 2;
+      const max = Math.max(1, ...LANGUAGE_KEYS.map((k) => perLanguage[k] || 0));
+      const barW = usableW / LANGUAGE_KEYS.length;
+      const labels = ['ts', 'js', 'py', 'java', 'kt', 'go', 'rs', 'cs', 'cpp', 'rb', 'php', 'swift', 'dart', 'scala', 'vue', 'sv', 'html', 'css', 'yaml', 'sh', 'df'];
+      const bars = [];
+      for (let i = 0; i < LANGUAGE_KEYS.length; i++) {
+        const key = LANGUAGE_KEYS[i];
+        const v = perLanguage[key] || 0;
+        const h = (v / max) * 160;
+        const x = left + i * barW + 2;
+        const y = top + 160 - h;
+        bars.push(`<rect x="${x.toFixed(1)}" y="${y.toFixed(1)}" width="${Math.max(2, barW - 4).toFixed(1)}" height="${h.toFixed(1)}" fill="#7aa2ff" rx="2"/>`);
+      }
+      const xLabels = labels.map((lbl, i) => {
+        const x = left + i * barW + barW / 2;
+        return `<text x="${x.toFixed(1)}" y="222" fill="#8ea0d9" font-size="9" font-family="monospace" text-anchor="middle">${lbl}</text>`;
+      });
+      return `<svg viewBox="0 0 760 260" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Extractor coverage by language"><rect x="0" y="0" width="100%" height="100%" fill="#0f1320" rx="12"/><text x="20" y="24" fill="#d7defa" font-size="13" font-family="monospace">Per-language extractor coverage (file counts)</text><line x1="20" y1="194" x2="740" y2="194" stroke="#223056" stroke-width="1"/>${bars.join('')}${xLabels.join('')}</svg>`;
+    }
+
+    function sparkline(values) {
+      const clean = values.filter((n) => Number.isFinite(n));
+      if (clean.length === 0) return 'n/a';
+      const ticks = '▁▂▃▄▅▆▇█';
+      const min = Math.min(...clean);
+      const max = Math.max(...clean);
+      const span = max - min || 1;
+      return clean.map((v) => {
+        const idx = Math.max(0, Math.min(ticks.length - 1, Math.round(((v - min) / span) * (ticks.length - 1))));
+        return ticks[idx];
+      }).join('');
+    }
+
+    function buildDashboardData(cwd, health) {
+      const entries = readLog(cwd);
+      const recent = entries.slice(-30);
+      const tokenReductionTrend = recent.map((e) => toNumber(e.reductionPct)).filter((n) => n !== null);
+      const hitAt5Trend = readBenchmarkTrend(cwd);
+      const coverage = computeExtractorCoverage(cwd);
+      const finals = entries.map((e) => toNumber(e.finalTokens)).filter((n) => n !== null);
+      const summary = {
+        grade: health.grade,
+        score: health.score,
+        daysSinceRegen: health.daysSinceRegen,
+        totalRuns: entries.length,
+        overBudgetRate: entries.length > 0 ? parseFloat(((entries.filter((e) => e.overBudget).length / entries.length) * 100).toFixed(1)) : 0,
+        p50TokenCount: Math.round(percentile(finals, 50)),
+        p95TokenCount: Math.round(percentile(finals, 95)),
+        overBudgetStreak: overBudgetStreak(entries),
+        extractorCoverage: coverage.pct,
+      };
+      return {
+        summary,
+        tokenReductionTrend,
+        hitAt5Trend,
+        coverage,
+        charts: {
+          tokenReductionSvg: lineChartSvg(tokenReductionTrend, 'Token reduction trend (last 30 tracked runs)', '%'),
+          hitAt5Svg: lineChartSvg(hitAt5Trend, 'hit@5 trend (last 30 benchmark runs)', ''),
+          coverageSvg: barChartSvg(coverage.perLanguage),
+        },
+      };
+    }
+
+    function generateDashboardHtml(cwd, health) {
+      const data = buildDashboardData(cwd, health);
+      const cards = [
+        { label: 'Current grade', value: `${data.summary.grade} (${data.summary.score}/100)` },
+        { label: 'Days since regen', value: data.summary.daysSinceRegen === null ? 'n/a' : String(data.summary.daysSinceRegen) },
+        { label: 'Total tracked runs', value: String(data.summary.totalRuns) },
+        { label: 'Over-budget %', value: `${data.summary.overBudgetRate}%` },
+        { label: 'p50 token count', value: String(data.summary.p50TokenCount) },
+        { label: 'p95 token count', value: String(data.summary.p95TokenCount) },
+        { label: 'Over-budget streak', value: String(data.summary.overBudgetStreak) },
+        { label: 'Extractor coverage', value: `${data.summary.extractorCoverage}%` },
+      ];
+      const cardHtml = cards.map((c) => `<div class="card"><div class="label">${c.label}</div><div class="value">${c.value}</div></div>`).join('');
+      const html = [
+        '<!doctype html>', '<html lang="en">', '<head>', '<meta charset="utf-8"/>',
+        '<meta name="viewport" content="width=device-width,initial-scale=1"/>', '<title>SigMap Dashboard</title>',
+        '<style>',
+        'body{margin:0;background:#0a0f1e;color:#e6ecff;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}',
+        '.wrap{max-width:980px;margin:0 auto;padding:24px}',
+        'h1{font-size:22px;margin:0 0 6px 0}', '.sub{color:#8ea0d9;font-size:12px;margin-bottom:20px}',
+        '.grid{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px;margin-bottom:16px}',
+        '.card{background:#111a33;border:1px solid #223056;border-radius:10px;padding:10px}',
+        '.label{font-size:11px;color:#8ea0d9;margin-bottom:6px}', '.value{font-size:16px;color:#f5f7ff}',
+        '.panel{background:#111a33;border:1px solid #223056;border-radius:12px;padding:10px;margin-top:12px}',
+        '@media (max-width:900px){.grid{grid-template-columns:repeat(2,minmax(0,1fr));}}',
+        '</style>', '</head>', '<body>', '<div class="wrap">',
+        '<h1>SigMap v2.10 dashboard</h1>',
+        '<div class="sub">Self-contained report. No external scripts, styles, or network calls.</div>',
+        `<div class="grid">${cardHtml}</div>`,
+        `<div class="panel">${data.charts.tokenReductionSvg}</div>`,
+        `<div class="panel">${data.charts.hitAt5Svg}</div>`,
+        `<div class="panel">${data.charts.coverageSvg}</div>`,
+        '</div>', '</body>', '</html>',
+      ].join('');
+      return { html, data };
+    }
+
+    function renderHistoryCharts(cwd, health) {
+      const data = buildDashboardData(cwd, health);
+      const lines = [
+        '[sigmap] history charts:',
+        `  token reduction trend : ${sparkline(data.tokenReductionTrend)}`,
+        `  hit@5 trend           : ${sparkline(data.hitAt5Trend)}`,
+        `  extractor coverage    : ${data.coverage.covered}/${data.coverage.supported} (${data.coverage.pct}%)`,
+        '',
+        '[sigmap] inline svg: token reduction', data.charts.tokenReductionSvg,
+        '',
+        '[sigmap] inline svg: hit@5', data.charts.hitAt5Svg,
+        '',
+        '[sigmap] inline svg: coverage', data.charts.coverageSvg,
+      ];
+      return {
+        text: lines.join('\n'),
+        tokenReductionSparkline: sparkline(data.tokenReductionTrend),
+        hitAt5Sparkline: sparkline(data.hitAt5Trend),
+        summary: data.summary,
+        charts: data.charts,
+      };
+    }
+
+    module.exports = { generateDashboardHtml, renderHistoryCharts, computeExtractorCoverage, percentile, overBudgetStreak };
+  };
+
 // ── ./src/health/scorer ──
 __factories["./src/health/scorer"] = function(module, exports) {
   
@@ -1970,36 +2280,148 @@ __factories["./src/health/scorer"] = function(module, exports) {
   function score(cwd) {
     const fs = require('fs');
     const path = require('path');
+
+    function toNumber(v) {
+      const n = Number(v);
+      return Number.isFinite(n) ? n : null;
+    }
+
+    function percentile(values, p) {
+      if (!Array.isArray(values) || values.length === 0) return 0;
+      const sorted = values.filter(Number.isFinite).slice().sort((a, b) => a - b);
+      if (sorted.length === 0) return 0;
+      if (p <= 0) return sorted[0];
+      if (p >= 100) return sorted[sorted.length - 1];
+      const idx = (p / 100) * (sorted.length - 1);
+      const lo = Math.floor(idx);
+      const hi = Math.ceil(idx);
+      if (lo === hi) return sorted[lo];
+      const frac = idx - lo;
+      return sorted[lo] + (sorted[hi] - sorted[lo]) * frac;
+    }
+
+    function overBudgetStreak(entries) {
+      if (!Array.isArray(entries) || entries.length === 0) return 0;
+      let streak = 0;
+      for (let i = entries.length - 1; i >= 0; i--) {
+        if (entries[i] && entries[i].overBudget) streak++;
+        else break;
+      }
+      return streak;
+    }
+
+    function walkFiles(dir, maxDepth, depth, out, excludeSet) {
+      if (depth > maxDepth) return;
+      let entries = [];
+      try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch (_) { return; }
+      for (const entry of entries) {
+        const abs = path.join(dir, entry.name);
+        const rel = abs.replace(/\\/g, '/');
+        if (excludeSet.has(entry.name) || rel.includes('/node_modules/') || rel.includes('/.git/')) continue;
+        if (entry.isDirectory()) walkFiles(abs, maxDepth, depth + 1, out, excludeSet);
+        else if (entry.isFile()) out.push(abs);
+      }
+    }
+
+    function detectLanguage(filePath) {
+      const base = path.basename(filePath);
+      const ext = path.extname(filePath).toLowerCase();
+      if (base === 'Dockerfile' || /^Dockerfile\./.test(base)) return 'dockerfile';
+      if (ext === '.ts' || ext === '.tsx') return 'typescript';
+      if (ext === '.js' || ext === '.jsx' || ext === '.mjs' || ext === '.cjs') return 'javascript';
+      if (ext === '.py' || ext === '.pyw') return 'python';
+      if (ext === '.java') return 'java';
+      if (ext === '.kt' || ext === '.kts') return 'kotlin';
+      if (ext === '.go') return 'go';
+      if (ext === '.rs') return 'rust';
+      if (ext === '.cs') return 'csharp';
+      if (ext === '.cpp' || ext === '.c' || ext === '.h' || ext === '.hpp' || ext === '.cc') return 'cpp';
+      if (ext === '.rb' || ext === '.rake') return 'ruby';
+      if (ext === '.php') return 'php';
+      if (ext === '.swift') return 'swift';
+      if (ext === '.dart') return 'dart';
+      if (ext === '.scala' || ext === '.sc') return 'scala';
+      if (ext === '.vue') return 'vue';
+      if (ext === '.svelte') return 'svelte';
+      if (ext === '.html' || ext === '.htm') return 'html';
+      if (ext === '.css' || ext === '.scss' || ext === '.sass' || ext === '.less') return 'css';
+      if (ext === '.yml' || ext === '.yaml') return 'yaml';
+      if (ext === '.sh' || ext === '.bash' || ext === '.zsh' || ext === '.fish') return 'shell';
+      return null;
+    }
+
+    function computeExtractorCoverage(cwd, cfg) {
+      const LANGUAGE_KEYS = [
+        'typescript', 'javascript', 'python', 'java', 'kotlin', 'go', 'rust',
+        'csharp', 'cpp', 'ruby', 'php', 'swift', 'dart', 'scala', 'vue',
+        'svelte', 'html', 'css', 'yaml', 'shell', 'dockerfile',
+      ];
+      const srcDirs = Array.isArray(cfg && cfg.srcDirs) && cfg.srcDirs.length > 0
+        ? cfg.srcDirs
+        : ['src', 'app', 'lib', 'packages', 'services', 'api'];
+      const exclude = new Set(['node_modules', '.git', 'dist', 'build', 'out', '__pycache__', '.next', 'coverage', 'target', 'vendor', '.context']);
+      if (cfg && Array.isArray(cfg.exclude)) for (const x of cfg.exclude) exclude.add(String(x));
+      const counts = {};
+      for (const k of LANGUAGE_KEYS) counts[k] = 0;
+      const files = [];
+      for (const relDir of srcDirs) {
+        const absDir = path.join(cwd, relDir);
+        if (!fs.existsSync(absDir)) continue;
+        walkFiles(absDir, 8, 0, files, exclude);
+      }
+      for (const f of files) {
+        const lang = detectLanguage(f);
+        if (lang) counts[lang]++;
+      }
+      const covered = LANGUAGE_KEYS.filter((k) => counts[k] > 0).length;
+      return LANGUAGE_KEYS.length > 0 ? parseFloat(((covered / LANGUAGE_KEYS.length) * 100).toFixed(1)) : 0;
+    }
   
     let tokenReductionPct = null;
     let daysSinceRegen = null;
     let strategyFreshnessDays = null;
     let overBudgetRuns = 0;
     let totalRuns = 0;
+    let p50TokenCount = 0;
+    let p95TokenCount = 0;
+    let overBudgetStreakCount = 0;
+    let extractorCoverage = 0;
+    let cfgObj = null;
+    let entries = [];
   
     // ── Detect active strategy ──────────────────────────────────────────────
     let strategy = 'full';
     try {
       const cfgPath = path.join(cwd, 'gen-context.config.json');
       if (fs.existsSync(cfgPath)) {
-        const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
-        strategy = cfg.strategy || 'full';
+        cfgObj = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+        strategy = cfgObj.strategy || 'full';
       }
     } catch (_) {}
   
     // ── Read usage log via tracking logger ──────────────────────────────────
     try {
       const { readLog, summarize } = __require('./src/tracking/logger');
-      const entries = readLog(cwd);
+      entries = readLog(cwd);
       const s = summarize(entries);
       // Only set tokenReductionPct when there is actual history; a brand-new/
       // untracked project should not be penalised for "0% reduction".
       if (s.totalRuns > 0) tokenReductionPct = s.avgReductionPct;
       overBudgetRuns = s.overBudgetRuns;
       totalRuns = s.totalRuns;
+      const finals = entries.map((e) => toNumber(e.finalTokens)).filter((n) => n !== null);
+      p50TokenCount = Math.round(percentile(finals, 50));
+      p95TokenCount = Math.round(percentile(finals, 95));
+      overBudgetStreakCount = overBudgetStreak(entries);
     } catch (_) {
       // No usage log yet — proceed with nulls
     }
+
+    try {
+      extractorCoverage = computeExtractorCoverage(cwd, cfgObj || {});
+    } catch (_) {
+      extractorCoverage = 0;
+    }
   
     // ── Days since primary context file was last regenerated ─────────────────
     try {
@@ -2057,7 +2479,20 @@ __factories["./src/health/scorer"] = function(module, exports) {
     else if (points >= 60) grade = 'C';
     else grade = 'D';
   
-    return { score: points, grade, strategy, tokenReductionPct, daysSinceRegen, strategyFreshnessDays, totalRuns, overBudgetRuns };
+    return {
+      score: points,
+      grade,
+      strategy,
+      tokenReductionPct,
+      daysSinceRegen,
+      strategyFreshnessDays,
+      totalRuns,
+      overBudgetRuns,
+      p50TokenCount,
+      p95TokenCount,
+      overBudgetStreak: overBudgetStreakCount,
+      extractorCoverage,
+    };
   }
   
   module.exports = { score };
@@ -3107,7 +3542,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
   
   const SERVER_INFO = {
     name: 'sigmap',
-    version: '1.5.0',
+    version: '2.10.0',
     description: 'SigMap MCP server — code signatures on demand',
   };
   
@@ -4304,7 +4739,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '2.9.1';
+const VERSION = '2.10.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -5503,6 +5938,8 @@ Usage:
   node gen-context.js --report                          Token reduction stats to stdout
   node gen-context.js --report --json                   Token report as JSON (for CI; exits 1 if over budget)
   node gen-context.js --report --history                Print usage log summary from .context/usage.ndjson
+  node gen-context.js --report --history --chart        Include inline SVG charts + Unicode sparklines
+  node gen-context.js --dashboard                       Write benchmarks/reports/dashboard.html
   node gen-context.js --suggest-tool "<task>"           Recommend model tier for a task description
   node gen-context.js --suggest-tool "<task>" --json    Machine-readable tier recommendation
   node gen-context.js --health                          Print composite health score
@@ -5625,6 +6062,31 @@ function main() {
       }
       console.log(`  total runs      : ${result.totalRuns}`);
       console.log(`  over-budget runs: ${result.overBudgetRuns}`);
+      console.log(`  p50 token count : ${result.p50TokenCount}`);
+      console.log(`  p95 token count : ${result.p95TokenCount}`);
+      console.log(`  overbudget streak: ${result.overBudgetStreak}`);
+      console.log(`  extractor cover.: ${result.extractorCoverage}%`);
+    }
+    process.exit(0);
+  }
+
+  if (args.includes('--dashboard')) {
+    try {
+      const { score } = __require('./src/health/scorer');
+      const health = score(cwd);
+      const { generateDashboardHtml } = requireSourceOrBundled('./src/format/dashboard');
+      const out = generateDashboardHtml(cwd, health);
+      const outPath = path.join(cwd, 'benchmarks', 'reports', 'dashboard.html');
+      fs.mkdirSync(path.dirname(outPath), { recursive: true });
+      fs.writeFileSync(outPath, out.html, 'utf8');
+      if (args.includes('--json')) {
+        process.stdout.write(JSON.stringify({ ok: true, file: path.relative(cwd, outPath), summary: out.data.summary }) + '\n');
+      } else {
+        console.log(`[sigmap] dashboard written: ${path.relative(cwd, outPath)}`);
+      }
+    } catch (err) {
+      console.error(`[sigmap] dashboard error: ${err.message}`);
+      process.exit(1);
     }
     process.exit(0);
   }
@@ -5876,8 +6338,25 @@ function main() {
         const { readLog, summarize } = __require('./src/tracking/logger');
         const entries = readLog(cwd);
         const summary = summarize(entries);
+        let chartInfo = null;
+        if (args.includes('--chart')) {
+          const { score } = __require('./src/health/scorer');
+          const { renderHistoryCharts } = requireSourceOrBundled('./src/format/dashboard');
+          chartInfo = renderHistoryCharts(cwd, score(cwd));
+        }
         if (args.includes('--json')) {
-          process.stdout.write(JSON.stringify(summary) + '\n');
+          const payload = chartInfo
+            ? {
+                ...summary,
+                chart: {
+                  tokenReductionSparkline: chartInfo.tokenReductionSparkline,
+                  hitAt5Sparkline: chartInfo.hitAt5Sparkline,
+                  summary: chartInfo.summary,
+                  charts: chartInfo.charts,
+                },
+              }
+            : summary;
+          process.stdout.write(JSON.stringify(payload) + '\n');
         } else {
           console.log('[sigmap] usage history:');
           console.log(`  total runs      : ${summary.totalRuns}`);
@@ -5886,6 +6365,10 @@ function main() {
           console.log(`  over-budget runs: ${summary.overBudgetRuns}`);
           if (summary.firstRun) console.log(`  first run       : ${summary.firstRun}`);
           if (summary.lastRun)  console.log(`  last run        : ${summary.lastRun}`);
+          if (chartInfo) {
+            console.log('');
+            console.log(chartInfo.text);
+          }
         }
       } catch (err) {
         console.warn(`[sigmap] tracking: ${err.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap",
-  "version": "2.9.1",
+  "version": "2.10.0",
   "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": "2.9.1",
+  "version": "2.10.0",
   "description": "SigMap CLI wrapper — thin adapter for programmatic CLI invocation",
   "main": "index.js",
   "keywords": [

package/packages/core/README.md

@@ -128,9 +128,9 @@ const health = score('/path/to/project');
 
 All existing CLI flags (`--generate`, `--watch`, `--mcp`, `--query`, `--analyze`, `--benchmark`, `--health`, …) are unchanged.
 
-## What's next — v2.9
+## What's next — v2.10
 
-v2.9 adds JetBrains plugin support — install SigMap natively in IntelliJ IDEA, WebStorm, PyCharm, GoLand, RubyMine. Includes toolbar actions, settings panel, file watcher integration, and automated JetBrains Marketplace publishing. See [issue #23](https://github.com/manojmallick/sigmap/issues/23).
+v2.10 adds reporting charts and advanced metrics for benchmark visibility. This milestone focuses on chart-ready report output, precision@K/recall@K/MRR trends, and CI-friendly metrics artifacts. See [issue #25](https://github.com/manojmallick/sigmap/issues/25).
 
 See the full [roadmap](https://manojmallick.github.io/sigmap/roadmap.html).
 

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-core",
-  "version": "2.9.1",
+  "version": "2.10.0",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [

package/src/format/dashboard.js

@@ -0,0 +1,400 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { readLog } = require('../tracking/logger');
+
+const LANGUAGE_KEYS = [
+  'typescript', 'javascript', 'python', 'java', 'kotlin', 'go', 'rust',
+  'csharp', 'cpp', 'ruby', 'php', 'swift', 'dart', 'scala', 'vue',
+  'svelte', 'html', 'css', 'yaml', 'shell', 'dockerfile',
+];
+
+function toNumber(v) {
+  const n = Number(v);
+  return Number.isFinite(n) ? n : null;
+}
+
+function percentile(values, p) {
+  if (!Array.isArray(values) || values.length === 0) return 0;
+  const sorted = values.filter(Number.isFinite).slice().sort((a, b) => a - b);
+  if (sorted.length === 0) return 0;
+  if (p <= 0) return sorted[0];
+  if (p >= 100) return sorted[sorted.length - 1];
+  const idx = (p / 100) * (sorted.length - 1);
+  const lo = Math.floor(idx);
+  const hi = Math.ceil(idx);
+  if (lo === hi) return sorted[lo];
+  const frac = idx - lo;
+  return sorted[lo] + (sorted[hi] - sorted[lo]) * frac;
+}
+
+function overBudgetStreak(entries) {
+  if (!Array.isArray(entries) || entries.length === 0) return 0;
+  let streak = 0;
+  for (let i = entries.length - 1; i >= 0; i--) {
+    if (entries[i] && entries[i].overBudget) streak++;
+    else break;
+  }
+  return streak;
+}
+
+function loadConfig(cwd) {
+  try {
+    const p = path.join(cwd, 'gen-context.config.json');
+    if (!fs.existsSync(p)) return null;
+    return JSON.parse(fs.readFileSync(p, 'utf8'));
+  } catch (_) {
+    return null;
+  }
+}
+
+function shouldExclude(rel, excludeSet) {
+  if (!rel) return true;
+  const parts = rel.split('/');
+  for (const part of parts) {
+    if (excludeSet.has(part)) return true;
+  }
+  return false;
+}
+
+function detectLanguage(filePath) {
+  const base = path.basename(filePath);
+  const ext = path.extname(filePath).toLowerCase();
+  if (base === 'Dockerfile' || /^Dockerfile\./.test(base)) return 'dockerfile';
+  if (ext === '.ts' || ext === '.tsx') return 'typescript';
+  if (ext === '.js' || ext === '.jsx' || ext === '.mjs' || ext === '.cjs') return 'javascript';
+  if (ext === '.py' || ext === '.pyw') return 'python';
+  if (ext === '.java') return 'java';
+  if (ext === '.kt' || ext === '.kts') return 'kotlin';
+  if (ext === '.go') return 'go';
+  if (ext === '.rs') return 'rust';
+  if (ext === '.cs') return 'csharp';
+  if (ext === '.cpp' || ext === '.c' || ext === '.h' || ext === '.hpp' || ext === '.cc') return 'cpp';
+  if (ext === '.rb' || ext === '.rake') return 'ruby';
+  if (ext === '.php') return 'php';
+  if (ext === '.swift') return 'swift';
+  if (ext === '.dart') return 'dart';
+  if (ext === '.scala' || ext === '.sc') return 'scala';
+  if (ext === '.vue') return 'vue';
+  if (ext === '.svelte') return 'svelte';
+  if (ext === '.html' || ext === '.htm') return 'html';
+  if (ext === '.css' || ext === '.scss' || ext === '.sass' || ext === '.less') return 'css';
+  if (ext === '.yml' || ext === '.yaml') return 'yaml';
+  if (ext === '.sh' || ext === '.bash' || ext === '.zsh' || ext === '.fish') return 'shell';
+  return null;
+}
+
+function walkFiles(dir, maxDepth, depth, out, excludeSet) {
+  if (depth > maxDepth) return;
+  let entries = [];
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch (_) {
+    return;
+  }
+  for (const entry of entries) {
+    const abs = path.join(dir, entry.name);
+    const rel = abs.replace(/\\/g, '/');
+    if (shouldExclude(rel, excludeSet)) continue;
+    if (entry.isDirectory()) {
+      walkFiles(abs, maxDepth, depth + 1, out, excludeSet);
+    } else if (entry.isFile()) {
+      out.push(abs);
+    }
+  }
+}
+
+function computeExtractorCoverage(cwd) {
+  const cfg = loadConfig(cwd) || {};
+  const srcDirs = Array.isArray(cfg.srcDirs) && cfg.srcDirs.length > 0
+    ? cfg.srcDirs
+    : ['src', 'app', 'lib', 'packages', 'services', 'api'];
+  const exclude = new Set([
+    'node_modules', '.git', 'dist', 'build', 'out', '__pycache__', '.next',
+    'coverage', 'target', 'vendor', '.context', 'jetbrains-plugin/build',
+  ]);
+  if (Array.isArray(cfg.exclude)) {
+    for (const item of cfg.exclude) exclude.add(String(item));
+  }
+
+  const counts = {};
+  for (const key of LANGUAGE_KEYS) counts[key] = 0;
+
+  const files = [];
+  for (const relDir of srcDirs) {
+    const absDir = path.join(cwd, relDir);
+    if (!fs.existsSync(absDir)) continue;
+    walkFiles(absDir, 8, 0, files, exclude);
+  }
+
+  for (const f of files) {
+    const lang = detectLanguage(f);
+    if (lang) counts[lang]++;
+  }
+
+  const covered = LANGUAGE_KEYS.filter((k) => counts[k] > 0).length;
+  const supported = LANGUAGE_KEYS.length;
+  const pct = supported > 0 ? parseFloat(((covered / supported) * 100).toFixed(1)) : 0;
+  return { supported, covered, pct, perLanguage: counts };
+}
+
+function readBenchmarkTrend(cwd) {
+  const resultDir = path.join(cwd, 'benchmarks', 'results');
+  if (!fs.existsSync(resultDir)) return [];
+
+  const files = [];
+  walkFiles(resultDir, 6, 0, files, new Set());
+
+  const values = [];
+  for (const filePath of files) {
+    const base = path.basename(filePath).toLowerCase();
+    if (!base.endsWith('.json') && !base.endsWith('.jsonl') && !base.endsWith('.ndjson')) continue;
+    let raw = '';
+    try {
+      raw = fs.readFileSync(filePath, 'utf8');
+    } catch (_) {
+      continue;
+    }
+
+    if (base.endsWith('.json')) {
+      try {
+        const obj = JSON.parse(raw);
+        const direct = toNumber(obj && obj.hitAt5);
+        const nested = toNumber(obj && obj.metrics && obj.metrics.hitAt5);
+        if (direct !== null) values.push(direct);
+        else if (nested !== null) values.push(nested);
+      } catch (_) {}
+      continue;
+    }
+
+    const lines = raw.split('\n').filter(Boolean);
+    for (const line of lines) {
+      try {
+        const obj = JSON.parse(line);
+        const direct = toNumber(obj && obj.hitAt5);
+        const nested = toNumber(obj && obj.metrics && obj.metrics.hitAt5);
+        if (direct !== null) values.push(direct);
+        else if (nested !== null) values.push(nested);
+      } catch (_) {}
+    }
+  }
+
+  return values.slice(-30);
+}
+
+function lineChartSvg(values, title, ySuffix) {
+  const width = 760;
+  const height = 210;
+  const left = 38;
+  const right = 18;
+  const top = 22;
+  const bottom = 30;
+  const innerW = width - left - right;
+  const innerH = height - top - bottom;
+  const clean = values.filter((n) => Number.isFinite(n));
+
+  if (clean.length === 0) {
+    return [
+      `<svg viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="${title}">`,
+      '<rect x="0" y="0" width="100%" height="100%" fill="#0f1320" rx="12"/>',
+      `<text x="20" y="36" fill="#d7defa" font-size="14" font-family="monospace">${title}</text>`,
+      '<text x="20" y="96" fill="#8ea0d9" font-size="13" font-family="monospace">No data yet. Run with --track and --benchmark.</text>',
+      '</svg>',
+    ].join('');
+  }
+
+  const min = Math.min(...clean);
+  const max = Math.max(...clean);
+  const span = max - min || 1;
+
+  const points = clean.map((v, i) => {
+    const x = left + ((clean.length === 1 ? 0 : i / (clean.length - 1)) * innerW);
+    const y = top + (1 - ((v - min) / span)) * innerH;
+    return `${x.toFixed(1)},${y.toFixed(1)}`;
+  }).join(' ');
+
+  const latest = clean[clean.length - 1];
+  const yLabel = ySuffix || '';
+  const grid = [];
+  for (let i = 0; i <= 4; i++) {
+    const gy = top + (i / 4) * innerH;
+    grid.push(`<line x1="${left}" y1="${gy.toFixed(1)}" x2="${left + innerW}" y2="${gy.toFixed(1)}" stroke="#223056" stroke-width="1"/>`);
+  }
+
+  return [
+    `<svg viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="${title}">`,
+    '<defs><linearGradient id="lineFill" x1="0" y1="0" x2="0" y2="1"><stop offset="0%" stop-color="#42d392" stop-opacity="0.25"/><stop offset="100%" stop-color="#42d392" stop-opacity="0"/></linearGradient></defs>',
+    '<rect x="0" y="0" width="100%" height="100%" fill="#0f1320" rx="12"/>',
+    `<text x="20" y="26" fill="#d7defa" font-size="13" font-family="monospace">${title}</text>`,
+    grid.join(''),
+    `<polyline fill="none" stroke="#42d392" stroke-width="2.5" points="${points}"/>`,
+    `<text x="20" y="${height - 8}" fill="#8ea0d9" font-size="12" font-family="monospace">latest: ${latest.toFixed(2)}${yLabel}</text>`,
+    '</svg>',
+  ].join('');
+}
+
+function barChartSvg(perLanguage) {
+  const width = 760;
+  const height = 260;
+  const left = 20;
+  const top = 34;
+  const usableW = width - left * 2;
+  const keys = LANGUAGE_KEYS.slice();
+  const max = Math.max(1, ...keys.map((k) => perLanguage[k] || 0));
+  const barW = usableW / keys.length;
+
+  const bars = [];
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    const v = perLanguage[key] || 0;
+    const h = (v / max) * 160;
+    const x = left + i * barW + 2;
+    const y = top + 160 - h;
+    bars.push(`<rect x="${x.toFixed(1)}" y="${y.toFixed(1)}" width="${Math.max(2, barW - 4).toFixed(1)}" height="${h.toFixed(1)}" fill="#7aa2ff" rx="2"/>`);
+  }
+
+  const labels = ['ts', 'js', 'py', 'java', 'kt', 'go', 'rs', 'cs', 'cpp', 'rb', 'php', 'swift', 'dart', 'scala', 'vue', 'sv', 'html', 'css', 'yaml', 'sh', 'df'];
+  const xLabels = labels.map((lbl, i) => {
+    const x = left + i * barW + barW / 2;
+    return `<text x="${x.toFixed(1)}" y="222" fill="#8ea0d9" font-size="9" font-family="monospace" text-anchor="middle">${lbl}</text>`;
+  });
+
+  return [
+    `<svg viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Extractor coverage by language">`,
+    '<rect x="0" y="0" width="100%" height="100%" fill="#0f1320" rx="12"/>',
+    '<text x="20" y="24" fill="#d7defa" font-size="13" font-family="monospace">Per-language extractor coverage (file counts)</text>',
+    '<line x1="20" y1="194" x2="740" y2="194" stroke="#223056" stroke-width="1"/>',
+    bars.join(''),
+    xLabels.join(''),
+    '</svg>',
+  ].join('');
+}
+
+function sparkline(values) {
+  const clean = values.filter((n) => Number.isFinite(n));
+  if (clean.length === 0) return 'n/a';
+  const ticks = '▁▂▃▄▅▆▇█';
+  const min = Math.min(...clean);
+  const max = Math.max(...clean);
+  const span = max - min || 1;
+  return clean.map((v) => {
+    const idx = Math.max(0, Math.min(ticks.length - 1, Math.round(((v - min) / span) * (ticks.length - 1))));
+    return ticks[idx];
+  }).join('');
+}
+
+function buildDashboardData(cwd, health) {
+  const entries = readLog(cwd);
+  const recent = entries.slice(-30);
+  const tokenReductionTrend = recent.map((e) => toNumber(e.reductionPct)).filter((n) => n !== null);
+  const hitAt5Trend = readBenchmarkTrend(cwd);
+  const coverage = computeExtractorCoverage(cwd);
+
+  const finals = entries.map((e) => toNumber(e.finalTokens)).filter((n) => n !== null);
+  const summary = {
+    grade: health.grade,
+    score: health.score,
+    daysSinceRegen: health.daysSinceRegen,
+    totalRuns: entries.length,
+    overBudgetRate: entries.length > 0
+      ? parseFloat(((entries.filter((e) => e.overBudget).length / entries.length) * 100).toFixed(1))
+      : 0,
+    p50TokenCount: Math.round(percentile(finals, 50)),
+    p95TokenCount: Math.round(percentile(finals, 95)),
+    overBudgetStreak: overBudgetStreak(entries),
+    extractorCoverage: coverage.pct,
+  };
+
+  return {
+    summary,
+    tokenReductionTrend,
+    hitAt5Trend,
+    coverage,
+    charts: {
+      tokenReductionSvg: lineChartSvg(tokenReductionTrend, 'Token reduction trend (last 30 tracked runs)', '%'),
+      hitAt5Svg: lineChartSvg(hitAt5Trend, 'hit@5 trend (last 30 benchmark runs)', ''),
+      coverageSvg: barChartSvg(coverage.perLanguage),
+    },
+  };
+}
+
+function generateDashboardHtml(cwd, health) {
+  const data = buildDashboardData(cwd, health);
+  const cards = [
+    { label: 'Current grade', value: `${data.summary.grade} (${data.summary.score}/100)` },
+    { label: 'Days since regen', value: data.summary.daysSinceRegen === null ? 'n/a' : String(data.summary.daysSinceRegen) },
+    { label: 'Total tracked runs', value: String(data.summary.totalRuns) },
+    { label: 'Over-budget %', value: `${data.summary.overBudgetRate}%` },
+    { label: 'p50 token count', value: String(data.summary.p50TokenCount) },
+    { label: 'p95 token count', value: String(data.summary.p95TokenCount) },
+    { label: 'Over-budget streak', value: String(data.summary.overBudgetStreak) },
+    { label: 'Extractor coverage', value: `${data.summary.extractorCoverage}%` },
+  ];
+
+  const cardHtml = cards.map((c) => `<div class="card"><div class="label">${c.label}</div><div class="value">${c.value}</div></div>`).join('');
+
+  const html = [
+    '<!doctype html>',
+    '<html lang="en">',
+    '<head>',
+    '<meta charset="utf-8"/>',
+    '<meta name="viewport" content="width=device-width,initial-scale=1"/>',
+    '<title>SigMap Dashboard</title>',
+    '<style>',
+    'body{margin:0;background:#0a0f1e;color:#e6ecff;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}',
+    '.wrap{max-width:980px;margin:0 auto;padding:24px}',
+    'h1{font-size:22px;margin:0 0 6px 0}',
+    '.sub{color:#8ea0d9;font-size:12px;margin-bottom:20px}',
+    '.grid{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px;margin-bottom:16px}',
+    '.card{background:#111a33;border:1px solid #223056;border-radius:10px;padding:10px}',
+    '.label{font-size:11px;color:#8ea0d9;margin-bottom:6px}',
+    '.value{font-size:16px;color:#f5f7ff}',
+    '.panel{background:#111a33;border:1px solid #223056;border-radius:12px;padding:10px;margin-top:12px}',
+    '@media (max-width:900px){.grid{grid-template-columns:repeat(2,minmax(0,1fr));}}',
+    '</style>',
+    '</head>',
+    '<body>',
+    '<div class="wrap">',
+    '<h1>SigMap v2.10 dashboard</h1>',
+    '<div class="sub">Self-contained report. No external scripts, styles, or network calls.</div>',
+    `<div class="grid">${cardHtml}</div>`,
+    `<div class="panel">${data.charts.tokenReductionSvg}</div>`,
+    `<div class="panel">${data.charts.hitAt5Svg}</div>`,
+    `<div class="panel">${data.charts.coverageSvg}</div>`,
+    '</div>',
+    '</body>',
+    '</html>',
+  ].join('');
+
+  return { html, data };
+}
+
+function renderHistoryCharts(cwd, health) {
+  const data = buildDashboardData(cwd, health);
+  const lines = [
+    '[sigmap] history charts:',
+    `  token reduction trend : ${sparkline(data.tokenReductionTrend)}`,
+    `  hit@5 trend           : ${sparkline(data.hitAt5Trend)}`,
+    `  extractor coverage    : ${data.coverage.covered}/${data.coverage.supported} (${data.coverage.pct}%)`,
+    '',
+    '[sigmap] inline svg: token reduction',
+    data.charts.tokenReductionSvg,
+    '',
+    '[sigmap] inline svg: hit@5',
+    data.charts.hitAt5Svg,
+    '',
+    '[sigmap] inline svg: coverage',
+    data.charts.coverageSvg,
+  ];
+
+  return {
+    text: lines.join('\n'),
+    tokenReductionSparkline: sparkline(data.tokenReductionTrend),
+    hitAt5Sparkline: sparkline(data.hitAt5Trend),
+    summary: data.summary,
+    charts: data.charts,
+  };
+}
+
+module.exports = { generateDashboardHtml, renderHistoryCharts, computeExtractorCoverage, percentile, overBudgetStreak };

package/src/health/scorer.js

@@ -36,6 +36,10 @@ function score(cwd) {
   let strategyFreshnessDays = null;
   let overBudgetRuns = 0;
   let totalRuns = 0;
+  let p50TokenCount = 0;
+  let p95TokenCount = 0;
+  let overBudgetStreak = 0;
+  let extractorCoverage = 0;
 
   // ── Detect active strategy ────────────────────────────────────────────────
   let strategy = 'full';
@@ -50,6 +54,7 @@ function score(cwd) {
   // ── Read usage log via tracking logger ──────────────────────────────────
   try {
     const { readLog, summarize } = require('../tracking/logger');
+    const { percentile, overBudgetStreak: calcOverBudgetStreak } = require('../format/dashboard');
     const entries = readLog(cwd);
     const s = summarize(entries);
     // Only set tokenReductionPct when there is actual history; a brand-new/
@@ -57,10 +62,21 @@ function score(cwd) {
     if (s.totalRuns > 0) tokenReductionPct = s.avgReductionPct;
     overBudgetRuns = s.overBudgetRuns;
     totalRuns = s.totalRuns;
+    const finals = entries.map((e) => Number(e.finalTokens)).filter(Number.isFinite);
+    p50TokenCount = Math.round(percentile(finals, 50));
+    p95TokenCount = Math.round(percentile(finals, 95));
+    overBudgetStreak = calcOverBudgetStreak(entries);
   } catch (_) {
     // No usage log yet — proceed with nulls
   }
 
+  try {
+    const { computeExtractorCoverage } = require('../format/dashboard');
+    extractorCoverage = computeExtractorCoverage(cwd).pct;
+  } catch (_) {
+    extractorCoverage = 0;
+  }
+
   // ── Days since primary context file was last regenerated ─────────────────
   try {
     const ctxFile = path.join(cwd, '.github', 'copilot-instructions.md');
@@ -117,7 +133,20 @@ function score(cwd) {
   else if (points >= 60) grade = 'C';
   else grade = 'D';
 
-  return { score: points, grade, strategy, tokenReductionPct, daysSinceRegen, strategyFreshnessDays, totalRuns, overBudgetRuns };
+  return {
+    score: points,
+    grade,
+    strategy,
+    tokenReductionPct,
+    daysSinceRegen,
+    strategyFreshnessDays,
+    totalRuns,
+    overBudgetRuns,
+    p50TokenCount,
+    p95TokenCount,
+    overBudgetStreak,
+    extractorCoverage,
+  };
 }
 
 module.exports = { score };

package/src/mcp/server.js

@@ -18,7 +18,7 @@ const { readContext, searchSignatures, getMap, createCheckpoint, getRouting, exp
 
 const SERVER_INFO = {
   name: 'sigmap',
-  version: '2.9.1',
+  version: '2.10.0',
   description: 'SigMap MCP server — code signatures on demand',
 };