sigmap 7.0.0 → 7.1.0

package/llms-full.txt

@@ -9,7 +9,7 @@ the files relevant to the task — cutting tokens ~97% while keeping answers
 grounded. Deterministic, offline, no embeddings or vector database. Works with
 Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 
-# Version: 7.0.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.1.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
 # Source: auto-generated from package.json, version.json, src/mcp/tools.js, src/config/defaults.js
 # Regenerate: npm run generate:llms   |   Validate: npm run validate:llms
 
@@ -67,6 +67,13 @@ sigmap --suggest-tool "<task>"           Recommend model tier for a task descrip
 sigmap --suggest-tool "<task>" --json    Machine-readable tier recommendation
 sigmap --health                          Print composite health score
 sigmap --health --json                   Machine-readable health score
+sigmap gain                              Token-savings dashboard (totals + by-operation)
+sigmap gain --all                        Add daily / weekly / monthly trend tables
+sigmap gain --json                       Aggregate savings as JSON
+sigmap gain --since 7d                    Window filter (7d, 30d, 12h, or ISO date)
+sigmap gain --top <n> | --model <name>   Limit rows / set $ pricing model
+sigmap gain --reset                      Clear the local savings log (.context/gain.ndjson)
+sigmap ... --no-track                    Disable gain savings capture for this run
 sigmap --diff                            Generate context for git-changed files only
 sigmap --diff <base-ref>                 Generate context + structural diff vs base ref (e.g. main)
 sigmap --diff --staged                   Generate context for staged files only
@@ -273,7 +280,7 @@ the relevant regulation before publication; SigMap makes no legal claims.
 - Author: Manoj Mallick
 - License: MIT
 - Repository: https://github.com/manojmallick/sigmap
-- Documentation: https://manojmallick.github.io/sigmap/
+- Documentation: https://sigmap.io/
 - npm: https://www.npmjs.com/package/sigmap
 - Benchmark dataset: https://doi.org/10.5281/zenodo.19898842
 - Issues: https://github.com/manojmallick/sigmap/issues

package/llms.txt

@@ -9,7 +9,7 @@ the files relevant to the task — cutting tokens ~97% while keeping answers
 grounded. Deterministic, offline, no embeddings or vector database. Works with
 Claude, Cursor, GitHub Copilot, Aider, Windsurf, local LLMs, and MCP.
 
-# Version: 7.0.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
+# Version: 7.1.0 | Benchmark: sigmap-v7.0-main (2026-06-14)
 # Source: auto-generated from package.json, version.json, src/mcp/tools.js, src/config/defaults.js
 # Regenerate: npm run generate:llms   |   Validate: npm run validate:llms
 
@@ -39,18 +39,18 @@ npx sigmap --mcp                    # start the MCP server over stdio
 ```
 
 ## Docs
-- [Full documentation](https://manojmallick.github.io/sigmap/)
-- [CLI reference](https://manojmallick.github.io/sigmap/guide/cli)
-- [MCP tools](https://manojmallick.github.io/sigmap/guide/mcp)
-- [Benchmark methodology](https://manojmallick.github.io/sigmap/guide/benchmark)
-- [Configuration guide](https://manojmallick.github.io/sigmap/guide/config)
+- [Full documentation](https://sigmap.io/)
+- [CLI reference](https://sigmap.io/guide/cli)
+- [MCP tools](https://sigmap.io/guide/mcp)
+- [Benchmark methodology](https://sigmap.io/guide/benchmark)
+- [Configuration guide](https://sigmap.io/guide/config)
 - [Changelog](https://github.com/manojmallick/sigmap/blob/main/CHANGELOG.md)
 
 ## Optional
 - [GitHub repository](https://github.com/manojmallick/sigmap)
 - [npm package](https://www.npmjs.com/package/sigmap)
 - [Benchmark dataset (Zenodo)](https://doi.org/10.5281/zenodo.19898842)
-- [Full LLM reference](https://manojmallick.github.io/sigmap/llms-full.txt)
+- [Full LLM reference](https://sigmap.io/llms-full.txt)
 
 SigMap — grounded AI coding context. The lightweight, deterministic alternative
 to embeddings for feeding the right code to AI assistants.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "sigmap",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "97% token reduction for AI coding. Extracts function & class signatures with TF-IDF ranking to feed only the right files to Claude, Cursor, Copilot, Aider, Windsurf, local LLMs & MCP. Zero dependencies, runs offline via npx.",
-  "main": "gen-context.js",
+  "main": "packages/core/index.js",
   "exports": {
     ".": "./packages/core/index.js",
     "./cli": "./packages/cli/index.js",
@@ -82,7 +82,7 @@
     "type": "git",
     "url": "https://github.com/manojmallick/sigmap.git"
   },
-  "homepage": "https://manojmallick.github.io/sigmap/",
+  "homepage": "https://sigmap.io/",
   "bugs": {
     "url": "https://github.com/manojmallick/sigmap/issues"
   },

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-cli",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "SigMap CLI wrapper — thin adapter for programmatic CLI invocation",
   "main": "index.js",
   "keywords": [
@@ -18,7 +18,7 @@
     "url": "https://github.com/manojmallick/sigmap.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://manojmallick.github.io/sigmap/",
+  "homepage": "https://sigmap.io/",
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"

package/packages/core/README.md

@@ -1,6 +1,6 @@
 # sigmap-core
 
-Programmatic API for [SigMap](https://manojmallick.github.io/sigmap/) — zero-dependency code signature extraction, ranked retrieval, secret scanning, project health scoring, and multi-adapter output formatting (v3.0+).
+Programmatic API for [SigMap](https://sigmap.io/) — zero-dependency code signature extraction, ranked retrieval, secret scanning, project health scoring, and multi-adapter output formatting (v3.0+).
 
 ## Installation
 
@@ -145,7 +145,7 @@ const geminiInstruction = adapt(context, 'gemini');
 // All 6 adapters: copilot | claude | cursor | windsurf | openai | gemini
 ```
 
-See the full [roadmap](https://manojmallick.github.io/sigmap/roadmap.html).
+See the full [roadmap](https://sigmap.io/roadmap.html).
 
 ## Zero dependencies
 

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-core",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [
@@ -20,7 +20,7 @@
     "url": "https://github.com/manojmallick/sigmap.git",
     "directory": "packages/core"
   },
-  "homepage": "https://manojmallick.github.io/sigmap/",
+  "homepage": "https://sigmap.io/",
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"

package/src/config/loader.js

@@ -34,12 +34,12 @@ function loadBaseConfig(extendsVal, cwd) {
           }).on('error', reject);
         });
       })();
-      // sync fallback: use execSync with node -e
-      const { execSync } = require('child_process');
-      const out = execSync(
-        `node -e "const h=require('${extendsVal.startsWith('https') ? 'https' : 'http'}');let d='';h.get(${JSON.stringify(extendsVal)},r=>{r.on('data',c=>d+=c);r.on('end',()=>process.stdout.write(d))}).on('error',()=>process.exit(1))"`,
-        { timeout: 10000, encoding: 'utf8' }
-      );
+      // Sync fallback: run a tiny fetch in a child node process. Shell-free —
+      // execFileSync runs the node binary directly (no /bin/sh) and the URL is
+      // passed as an argv value, never interpolated into a command string.
+      const { execFileSync } = require('child_process');
+      const SYNC_FETCH = "const u=process.argv[1];const h=require(u.startsWith('https')?'https':'http');let d='';h.get(u,r=>{r.on('data',c=>d+=c);r.on('end',()=>process.stdout.write(d))}).on('error',()=>process.exit(1))";
+      const out = execFileSync(process.execPath, ['-e', SYNC_FETCH, extendsVal], { timeout: 10000, encoding: 'utf8' });
       const parsed = JSON.parse(out);
       if (!fs.existsSync(cacheDir)) fs.mkdirSync(cacheDir, { recursive: true });
       fs.writeFileSync(cachePath, JSON.stringify(parsed), 'utf8');

package/src/discovery/source-root-scorer.js

@@ -2,7 +2,7 @@
 
 const fs   = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { git } = require('../util/git');
 
 const CODE_EXTS = new Set([
   '.js','.mjs','.cjs','.ts','.tsx','.jsx',
@@ -35,7 +35,7 @@ const ROOT_ENTRYPOINTS = {
 
 function getRecentlyChangedDirs(cwd) {
   try {
-    const out = execSync('git log --name-only --format="" HEAD~10 2>/dev/null', { cwd, timeout: 3000 }).toString();
+    const out = git(['log', '--name-only', '--format=', 'HEAD~10'], { cwd, timeout: 3000 }).toString();
     return new Set(out.split('\n').filter(Boolean).map(f => f.split('/')[0]));
   } catch { return new Set(); }
 }

package/src/format/gain-terminal.js

@@ -0,0 +1,206 @@
+'use strict';
+
+/**
+ * SigMap `gain` — terminal renderer.
+ *
+ * Zero-dependency ANSI dashboard for token savings. Honors NO_COLOR and
+ * non-TTY output (plain text for pipes / --json consumers elsewhere).
+ *
+ * "saved" is a counterfactual estimate (whole-file baseline − actual context),
+ * never a measured delta — the footer says so on every view.
+ */
+
+const USE_COLOR = !process.env.NO_COLOR && process.stdout.isTTY;
+
+const C = {
+  reset: USE_COLOR ? '\x1b[0m' : '',
+  dim: USE_COLOR ? '\x1b[2m' : '',
+  bold: USE_COLOR ? '\x1b[1m' : '',
+  green: USE_COLOR ? '\x1b[32m' : '',
+  yellow: USE_COLOR ? '\x1b[33m' : '',
+  red: USE_COLOR ? '\x1b[31m' : '',
+  cyan: USE_COLOR ? '\x1b[36m' : '',
+  gray: USE_COLOR ? '\x1b[90m' : '',
+};
+
+// ── formatters ───────────────────────────────────────────────────────────
+function humanTokens(n) {
+  n = Number(n) || 0;
+  if (n >= 1e9) return (n / 1e9).toFixed(1) + 'B';
+  if (n >= 1e6) return (n / 1e6).toFixed(1) + 'M';
+  if (n >= 1e3) return (n / 1e3).toFixed(1) + 'K';
+  return String(Math.round(n));
+}
+
+function fmtInt(n) {
+  return (Number(n) || 0).toLocaleString('en-US');
+}
+
+function fmtUSD(n) {
+  n = Number(n) || 0;
+  if (n >= 1000) return '$' + n.toLocaleString('en-US', { maximumFractionDigits: 0 });
+  return '$' + n.toFixed(2);
+}
+
+function fmtDuration(ms) {
+  ms = Number(ms) || 0;
+  if (ms >= 3.6e6) return (ms / 3.6e6).toFixed(1) + 'h';
+  if (ms >= 60000) return (ms / 60000).toFixed(1) + 'm';
+  if (ms >= 1000) return (ms / 1000).toFixed(1) + 's';
+  return Math.round(ms) + 'ms';
+}
+
+function fmtPct(p) {
+  return (Number(p) || 0).toFixed(1) + '%';
+}
+
+function colorPct(p, text) {
+  if (!USE_COLOR) return text;
+  const c = p >= 85 ? C.green : p >= 60 ? C.yellow : C.red;
+  return c + text + C.reset;
+}
+
+function pad(s, w, align) {
+  s = String(s);
+  const visible = s.replace(/\x1b\[[0-9;]*m/g, '');
+  const gap = Math.max(0, w - visible.length);
+  return align === 'right' ? ' '.repeat(gap) + s : s + ' '.repeat(gap);
+}
+
+/** Solid horizontal efficiency bar with a dotted remainder. */
+function bar(pct, width) {
+  const filled = Math.round((clamp(pct, 0, 100) / 100) * width);
+  const solid = '█'.repeat(filled);
+  const rest = '░'.repeat(Math.max(0, width - filled));
+  return (USE_COLOR ? C.green : '') + solid + (USE_COLOR ? C.gray : '') + rest + C.reset;
+}
+
+/** Proportional impact bar (share of total saved). */
+function impactBar(sharePct, width) {
+  const n = Math.max(1, Math.round((clamp(sharePct, 0, 100) / 100) * width));
+  return (USE_COLOR ? C.cyan : '') + '█'.repeat(n) + C.reset;
+}
+
+const clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
+const rule = (w) => C.gray + '─'.repeat(w) + C.reset;
+
+// ── views ──────────────────────────────────────────────────────────────
+/**
+ * Render the global summary + by-operation table.
+ * @param {object} agg     output of aggregate()
+ * @param {object} [opts]  { version, scope }
+ * @returns {string}
+ */
+function renderSummary(agg, opts = {}) {
+  const W = 74;
+  const t = agg.totals;
+  const L = [];
+  const scope = opts.scope || 'this repo';
+  const ver = opts.version ? `v${opts.version}` : '';
+
+  L.push('');
+  const heading = `⚡ SigMap — Token Savings (${scope})`;
+  L.push('  ' + C.bold + C.cyan + heading + C.reset +
+    pad(`${C.green}✓${C.reset} ${C.dim}${ver}${C.reset}`, W - heading.length, 'right'));
+  L.push('  ' + rule(W));
+  L.push('');
+
+  if (t.count === 0) {
+    L.push(`  ${C.yellow}No usage recorded yet.${C.reset}`);
+    L.push(`  ${C.dim}Run a few queries (sigmap ask "...") or seed a demo:${C.reset}`);
+    L.push(`  ${C.dim}  node scripts/gain.mjs --demo${C.reset}`);
+    L.push('');
+    return L.join('\n');
+  }
+
+  const label = (k) => C.dim + pad(k, 21) + C.reset;
+  L.push('  ' + label('Total operations') + ': ' + C.bold + fmtInt(t.count) + C.reset);
+  L.push('  ' + label('Whole-file baseline') + ': ' + humanTokens(t.baseline) + ' tok' +
+    `   ${C.dim}← est. cost of feeding full files${C.reset}`);
+  L.push('  ' + label('SigMap context') + ': ' + humanTokens(t.actual) + ' tok');
+  L.push('  ' + label('Tokens saved') + ': ' + C.bold + humanTokens(t.saved) + C.reset +
+    '  (' + colorPct(t.savedPct, fmtPct(t.savedPct)) + ')');
+  L.push('  ' + label('Est. money saved') + ': ' + C.bold + C.green + fmtUSD(t.usdSaved) + C.reset +
+    `   ${C.dim}(${agg.price.model} input @ $${agg.price.perMtok}/M · --model to change)${C.reset}`);
+  L.push('  ' + label('Avg latency') + ': ' + fmtDuration(t.avgMs) + ' / op' +
+    `   ${C.dim}(local, no API round-trip)${C.reset}`);
+  L.push('');
+  L.push('  ' + label('Efficiency') + ': ▕' + bar(t.savedPct, 30) + '▏  ' +
+    colorPct(t.savedPct, C.bold + fmtPct(t.savedPct) + C.reset));
+  L.push('');
+
+  // By operation table
+  L.push(`  ${C.bold}By operation${C.reset}`);
+  L.push('  ' + rule(W));
+  L.push('  ' + C.dim +
+    pad('#', 3) + pad('Operation', 24) + pad('Count', 8, 'right') +
+    pad('Saved', 9, 'right') + pad('Avg%', 8, 'right') + pad('Time', 8, 'right') +
+    '  Impact' + C.reset);
+  agg.byOp.forEach((o, i) => {
+    L.push('  ' +
+      pad(`${i + 1}.`, 3) +
+      pad(o.op, 24) +
+      pad(fmtInt(o.count), 8, 'right') +
+      pad(humanTokens(o.saved), 9, 'right') +
+      pad(colorPct(o.avgPct, fmtPct(o.avgPct)), 8, 'right') +
+      pad(fmtDuration(o.avgMs), 8, 'right') +
+      '  ' + impactBar(o.sharePct, 12));
+  });
+  L.push('  ' + rule(W));
+  L.push(`  ${C.dim}saved = baseline − actual · estimated vs whole-file reads · local-only${C.reset}`);
+  L.push('');
+  return L.join('\n');
+}
+
+/**
+ * Render daily / weekly / monthly trend tables.
+ * @param {object} agg
+ * @returns {string}
+ */
+function renderBreakdown(agg) {
+  const L = [];
+  if (agg.totals.count === 0) return renderSummary(agg);
+
+  const section = (icon, title, rows, keyHeader) => {
+    L.push('');
+    L.push(`  ${C.bold}${icon} ${title}${C.reset}`);
+    L.push('  ' + C.dim +
+      pad(keyHeader, 14) + pad('Ops', 7, 'right') + pad('Baseline', 11, 'right') +
+      pad('Actual', 10, 'right') + pad('Saved', 10, 'right') + pad('Save%', 8, 'right') +
+      pad('Time', 8, 'right') + C.reset);
+    let TB = 0, TA = 0, TS = 0, TC = 0, TM = 0;
+    for (const r of rows) {
+      TB += r.baseline; TA += r.actual; TS += r.saved; TC += r.count; TM += r.ms;
+      L.push('  ' +
+        pad(r.key, 14) + pad(fmtInt(r.count), 7, 'right') +
+        pad(humanTokens(r.baseline), 11, 'right') + pad(humanTokens(r.actual), 10, 'right') +
+        pad(humanTokens(r.saved), 10, 'right') +
+        pad(colorPct(r.savedPct, fmtPct(r.savedPct)), 8, 'right') +
+        pad(fmtDuration(r.ms), 8, 'right'));
+    }
+    const tp = TB > 0 ? (TS / TB) * 100 : 0;
+    L.push('  ' + C.bold +
+      pad('TOTAL', 14) + pad(fmtInt(TC), 7, 'right') +
+      pad(humanTokens(TB), 11, 'right') + pad(humanTokens(TA), 10, 'right') +
+      pad(humanTokens(TS), 10, 'right') + pad(fmtPct(tp), 8, 'right') +
+      pad(fmtDuration(TM), 8, 'right') + C.reset);
+  };
+
+  const daily = agg.buckets.daily.slice(-30);
+  section('📅', `Daily (last ${daily.length})`, daily, 'Date');
+  const weekly = agg.buckets.weekly.slice(-6);
+  section('📆', `Weekly (last ${weekly.length})`, weekly, 'Week of');
+  const monthly = agg.buckets.monthly.slice(-3);
+  section('🗓️', `Monthly (last ${monthly.length})`, monthly, 'Month');
+  L.push('');
+  L.push(`  ${C.dim}saved = baseline − actual · estimated vs whole-file reads · local-only${C.reset}`);
+  L.push('');
+  return L.join('\n');
+}
+
+module.exports = {
+  renderSummary,
+  renderBreakdown,
+  // exported for tests
+  humanTokens, fmtUSD, fmtDuration, fmtPct,
+};

package/src/format/llms-txt.js

@@ -1,14 +1,13 @@
 'use strict';
 const path = require('path');
 const fs   = require('fs');
-const { execSync } = require('child_process');
+const { tryGit } = require('../util/git');
 module.exports = { format, outputPath };
 
 function outputPath(cwd) { return path.join(cwd, 'llms.txt'); }
 
 function getShortCommit(cwd) {
-  try { return execSync('git rev-parse --short HEAD', { cwd, timeout: 2000 }).toString().trim(); }
-  catch (_) { return ''; }
+  return tryGit(['rev-parse', '--short', 'HEAD'], { cwd, timeout: 2000 });
 }
 
 function detectVersion(cwd) {

package/src/mcp/handlers.js

@@ -2,7 +2,7 @@
 
 const fs   = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { git } = require('../util/git');
 
 const CONTEXT_FILE = path.join('.github', 'copilot-instructions.md');
 const CONTEXT_COLD_FILE = path.join('.github', 'context-cold.md');
@@ -149,19 +149,14 @@ function createCheckpoint(args, cwd) {
   // ── Git info ────────────────────────────────────────────────────────────
   lines.push('## Git state');
   try {
-    const branch = execSync('git rev-parse --abbrev-ref HEAD', {
-      cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
+    const branch = git(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd }).trim();
     lines.push(`**Branch:** ${branch}`);
   } catch (_) {
     lines.push('**Branch:** (not a git repo)');
   }
 
   try {
-    const log = execSync(
-      'git log --oneline -5 --no-decorate 2>/dev/null',
-      { cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
-    ).trim();
+    const log = git(['log', '--oneline', '-5', '--no-decorate'], { cwd }).trim();
     if (log) {
       lines.push('');
       lines.push('**Recent commits:**');

package/src/mcp/server.js

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

package/src/nudge.js

@@ -11,8 +11,6 @@
 
 const fs = require('fs');
 const path = require('path');
-const os = require('os');
-const crypto = require('crypto');
 
 const RUN_THRESHOLD = 10;
 const SUCCESS_THRESHOLD = 8;
@@ -22,7 +20,7 @@ function usagePath(cwd) { return path.join(cwd, '.context', 'usage.json'); }
 function defaultUsage() {
   return {
     totalRuns: 0, successfulRuns: 0, squeezeOffered: 0, squeezeAccepted: 0,
-    starNudgeShown: false, machineId: '', firstRunDate: null, lastRunDate: null,
+    starNudgeShown: false, firstRunDate: null, lastRunDate: null,
   };
 }
 
@@ -75,9 +73,6 @@ function checkStarNudge(cwd, runSuccess, opts = {}) {
   const today = opts.today || new Date().toISOString().slice(0, 10);
   if (!usage.firstRunDate) usage.firstRunDate = today;
   usage.lastRunDate = today;
-  if (!usage.machineId) {
-    try { usage.machineId = 'sha256-' + crypto.createHash('sha256').update(os.hostname()).digest('hex').slice(0, 16); } catch (_) {}
-  }
 
   let nudged = false;
   if (!usage.starNudgeShown && usage.totalRuns >= RUN_THRESHOLD && usage.successfulRuns >= SUCCESS_THRESHOLD) {

package/src/session/notes.js

@@ -15,7 +15,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { tryGit } = require('../util/git');
 
 const NOTES_FILE = path.join('.context', 'notes.ndjson');
 const MAX_TEXT = 2000;
@@ -25,13 +25,7 @@ function notesPath(cwd) {
 }
 
 function _currentBranch(cwd) {
-  try {
-    return execSync('git rev-parse --abbrev-ref HEAD', {
-      cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim() || null;
-  } catch (_) {
-    return null;
-  }
+  return tryGit(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd }) || null;
 }
 
 /**