pi-mega-compact 0.4.17 → 0.4.19

package/dist/extensions/dashboard-server.js

@@ -12,7 +12,72 @@
  */
 import { createServer } from "node:http";
 import { existsSync, mkdirSync, readFileSync, unlinkSync, watch, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { join } from "node:path";
+import Database from "better-sqlite3";
+// --- Multi-repo index (Phase 5b) ------------------------------------------------
+// The extension writes a machine-wide repo registry into a single SQLite DB
+// (<indexDir>/index.sqlite) as the concurrency-safe write path; the dashboard
+// reads that table directly (one read-only connection, opened per request so a
+// concurrent writer's WAL never blocks the request). All registry data lives in
+// SQLite (the project's one-store invariant) — there is no JSON mirror. Same
+// index-dir resolution as src/store/sqlite.ts getIndexDir().
+function getIndexDir() {
+    const override = process.env.MEGACOMPACT_INDEX_DIR;
+    if (override && override.trim() !== "")
+        return override;
+    try {
+        return join(homedir(), ".mega-compact-index");
+    }
+    catch {
+        return join("/tmp", ".mega-compact-index");
+    }
+}
+/** Read the machine-wide repo registry from SQLite (read-only, single shot). */
+function readIndex() {
+    const indexPath = join(getIndexDir(), "index.sqlite");
+    if (!existsSync(indexPath))
+        return null;
+    let db;
+    try {
+        // Read-only + immutable WAL so a concurrent writer's WAL never blocks us.
+        db = new Database(indexPath, { readonly: true, fileMustExist: true });
+        db.pragma("journal_mode = WAL");
+        const rows = db
+            .prepare("SELECT * FROM repo_registry ORDER BY last_seen DESC")
+            .all();
+        const repos = rows.map((r) => ({
+            repoRoot: String(r.repo_root ?? ""),
+            displayName: String(r.display_name ?? ""),
+            checkpointCount: Number(r.checkpoint_count ?? 0),
+            tokensSaved: Number(r.tokens_saved ?? 0),
+            compressedOriginalBytes: Number(r.compressed_original_bytes ?? 0),
+            lastCompactedAt: r.last_compacted_at ?? null,
+            provider: r.provider ?? null,
+            providerName: r.provider_name ?? null,
+            modelName: r.model_name ?? null,
+            inputRate: r.input_rate ?? null,
+            outputRate: r.output_rate ?? null,
+            lastSeen: Number(r.last_seen ?? 0),
+        }));
+        const summary = {
+            totalRepos: repos.length,
+            totalCheckpoints: repos.reduce((a, r) => a + r.checkpointCount, 0),
+            totalTokensSaved: repos.reduce((a, r) => a + r.tokensSaved, 0),
+            totalCompressedOriginalBytes: repos.reduce((a, r) => a + r.compressedOriginalBytes, 0),
+        };
+        return { updatedAt: new Date().toISOString(), summary, repos };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch { /* ignore */ }
+    }
+}
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -34,6 +99,7 @@ function readSnapshot(snapshotPath) {
             crew: { activeAgents: 0, currentTurn: 0 },
             repo: { checkpointCount: 0, totalTokenEstimate: 0, originalTokens: 0, tokensSaved: 0, sessionCount: 0, dedupAttempts: 0, dedupCollapsed: 0, storageDedupRate: 0 },
             integrity: { regionsRetained: 0, compressedOriginalBytes: 0, duplicatesCollapsed: 0, bytesPermanentlyDeleted: 0 },
+            model: undefined,
         };
     }
 }
@@ -111,14 +177,54 @@ function dashboardHtml(tierName) {
   .updated { font-size: 11px; color: #484f58; margin-top: 16px; text-align: right; }
   .empty { color: #484f58; font-style: italic; font-size: 13px; padding: 8px 0; }
   .offline-banner { background: #f8514922; border: 1px solid #f85149; border-radius: 6px; padding: 10px 16px; margin-bottom: 16px; font-size: 13px; color: #f85149; display: none; }
+  .tabs { display: flex; gap: 8px; margin-bottom: 20px; }
+  .tab { background: #161b22; color: #8b949e; border: 1px solid #30363d; border-radius: 6px; padding: 8px 16px; font-size: 13px; font-weight: 600; cursor: pointer; transition: all .15s ease; }
+  .tab:hover { color: #c9d1d9; border-color: #484f58; }
+  .tab.active { background: #1f6feb; color: #fff; border-color: #1f6feb; }
+  .tab-panel { display: none; }
+  .tab-panel.active { display: block; }
+  .summary-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 16px; margin-bottom: 20px; }
+  .summary-card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 16px; }
+  .summary-card .num { font-size: 24px; font-weight: 700; color: #f0f6fc; }
+  .summary-card .lbl { font-size: 12px; color: #8b949e; text-transform: uppercase; letter-spacing: .5px; margin-top: 4px; }
+  table.repos { width: 100%; border-collapse: collapse; background: #161b22; border: 1px solid #30363d; border-radius: 8px; overflow: hidden; }
+  table.repos th, table.repos td { text-align: left; padding: 10px 14px; font-size: 13px; border-bottom: 1px solid #21262d; }
+  table.repos th { color: #8b949e; text-transform: uppercase; letter-spacing: .5px; font-size: 11px; background: #0d1117; }
+  table.repos td.num { font-family: monospace; color: #f0f6fc; text-align: right; }
+  table.repos tr:last-child td { border-bottom: none; }
+  table.repos tr:hover td { background: #1c2128; }
+  .repo-model { color: #a371f7; }
+  .repo-none { color: #484f58; font-style: italic; }
+  .updated { font-size: 11px; color: #484f58; margin-top: 16px; text-align: right; }
+  .model-pill { background: #6e40c9; color: #fff; font-size: 11px; font-weight: 700; padding: 2px 8px; border-radius: 10px; text-transform: uppercase; letter-spacing: .5px; }
+  .card.cost h2 { color: #a371f7; }
+  .cost-usd { font-size: 22px; font-weight: 700; color: #3fb950; }
+  .cost-sub { font-size: 12px; color: #8b949e; margin-top: 4px; }
+  .repo-link { cursor: pointer; }
+  .repo-link:hover td { color: #58a6ff; }
+  .repo-detail { position: fixed; inset: 0; background: rgba(0,0,0,.6); display: none; align-items: center; justify-content: center; z-index: 50; }
+  .repo-detail.open { display: flex; }
+  .repo-detail-box { background: #161b22; border: 1px solid #30363d; border-radius: 10px; padding: 24px; width: 560px; max-width: 92vw; max-height: 86vh; overflow-y: auto; }
+  .repo-detail-box h2 { font-size: 14px; color: #f0f6fc; margin-bottom: 14px; display: flex; justify-content: space-between; align-items: center; }
+  .repo-close { cursor: pointer; color: #8b949e; font-size: 20px; line-height: 1; border: none; background: none; padding: 0 4px; }
+  .repo-close:hover { color: #f0f6fc; }
+  .repo-path { font-size: 11px; color: #484f58; word-break: break-all; margin: -8px 0 12px; }
 </style>
 </head>
 <body>
 
 <div class="offline-banner" id="offline-banner">Dashboard data unavailable — waiting for a pi session to write snapshot...</div>
 
-<h1><span>mega-compact</span><span class="tier">${tierName}</span></h1>
+<h1><span>mega-compact</span><span class="tier">${tierName}</span><span class="model-pill" id="hdr-model">—</span></h1>
 
+<nav class="tabs">
+  <button class="tab active" data-tab="current">Current repo</button>
+  <button class="tab" data-tab="all">All repos</button>
+  <button class="tab" data-tab="summary">Summary</button>
+</nav>
+
+<!-- Current repo (existing single-repo view) -->
+<div class="tab-panel" id="panel-current">
 <div class="grid">
   <div class="card">
     <h2>Context Window</h2>
@@ -178,6 +284,17 @@ function dashboardHtml(tierName) {
       <span class="label">Anchor</span><span class="value" id="cf-anchor">—</span>
     </div>
   </div>
+  <div class="card cost">
+    <h2>💰 Model &amp; Cost Savings</h2>
+    <div class="cost-usd" id="cost-usd">≈ $0.00 saved</div>
+    <div class="cost-sub" id="cost-windows">0 context-windows extended</div>
+    <div class="stat-grid" style="margin-top:12px">
+      <span class="label" title="The model pi is currently using — its pricing drives the cost figure.">Model</span><span class="value" id="md-name">—</span>
+      <span class="label" title="The provider serving the model.">Provider</span><span class="value" id="md-provider">—</span>
+      <span class="label" title="USD per input token, from the model's pricing.">Input Rate</span><span class="value" id="md-input">—</span>
+      <span class="label" title="USD per output token, from the model's pricing.">Output Rate</span><span class="value" id="md-output">—</span>
+    </div>
+  </div>
   <div class="card">
     <h2>Crew / Agents</h2>
     <div class="stat-grid">
@@ -205,7 +322,67 @@ function dashboardHtml(tierName) {
   <div class="events-wrap" id="events"><div class="empty">connecting…</div></div>
 </div>
 
+<h2 style="margin-top:24px;font-size:13px;color:#8b949e;text-transform:uppercase;letter-spacing:.5px">All Repositories</h2>
+<table class="repos">
+  <thead>
+    <tr>
+      <th>Repo</th><th>Model</th>
+      <th style="text-align:right">Checkpoints</th>
+      <th style="text-align:right">Tokens Saved</th>
+      <th style="text-align:right">Retained</th>
+      <th style="text-align:right">Last Compacted</th>
+    </tr>
+  </thead>
+  <tbody id="cur-rows"><tr><td colspan="6" class="repo-none">loading…</td></tr></tbody>
+</table>
+<div class="updated" id="cur-updated"></div>
+
 <div class="updated" id="updated"></div>
+</div><!-- /panel-current -->
+
+<!-- Per-repo detail modal -->
+<div class="repo-detail" id="repo-detail">
+  <div class="repo-detail-box">
+    <h2><span id="rd-name">Repo</span><button class="repo-close" id="rd-close" title="Close">×</button></h2>
+    <div class="repo-path" id="rd-path"></div>
+    <div class="stat-grid">
+      <span class="label">Model</span><span class="value" id="rd-model">—</span>
+      <span class="label">Checkpoints</span><span class="value" id="rd-cp">0</span>
+      <span class="label">Tokens Saved</span><span class="value" id="rd-saved">0</span>
+      <span class="label">Compressed-Original</span><span class="value" id="rd-bytes">0 B</span>
+      <span class="label">Last Compacted</span><span class="value" id="rd-when">—</span>
+      <span class="label">Provider</span><span class="value" id="rd-provider">—</span>
+    </div>
+  </div>
+</div>
+
+<!-- All repos (machine-wide registry from index.sqlite) -->
+<div class="tab-panel" id="panel-all">
+  <table class="repos">
+    <thead>
+      <tr>
+        <th>Repo</th><th>Model</th>
+        <th style="text-align:right">Checkpoints</th>
+        <th style="text-align:right">Tokens Saved</th>
+        <th style="text-align:right">Retained</th>
+        <th style="text-align:right">Last Compacted</th>
+      </tr>
+    </thead>
+    <tbody id="all-rows"><tr><td colspan="6" class="repo-none">loading…</td></tr></tbody>
+  </table>
+  <div class="updated" id="all-updated"></div>
+</div>
+
+<!-- Summary (aggregate across all repos) -->
+<div class="tab-panel" id="panel-summary">
+  <div class="summary-grid">
+    <div class="summary-card"><div class="num" id="sm-repos">0</div><div class="lbl">Repositories</div></div>
+    <div class="summary-card"><div class="num" id="sm-checkpoints">0</div><div class="lbl">Total Checkpoints</div></div>
+    <div class="summary-card"><div class="num" id="sm-saved">0</div><div class="lbl">Total Tokens Saved</div></div>
+    <div class="summary-card"><div class="num" id="sm-bytes">0 B</div><div class="lbl">Compressed-Original</div></div>
+  </div>
+  <div class="updated" id="sm-updated"></div>
+</div>
 
 <script>
 (function() {
@@ -285,6 +462,24 @@ function dashboardHtml(tierName) {
     document.getElementById('cf-auto').textContent = d.config.auto ? 'enabled' : 'disabled';
     document.getElementById('cf-anchor').textContent = d.config.anchorUserMessages;
 
+    // --- Active model + cost savings (same calc as /mega-status) ---------------
+    var model = d.model;
+    document.getElementById('hdr-model').textContent = model && model.name ? model.name : '—';
+    document.getElementById('md-name').textContent = model && model.name ? model.name : '—';
+    document.getElementById('md-provider').textContent = model && model.providerName ? model.providerName : (model && model.provider ? model.provider : '—');
+    document.getElementById('md-input').textContent = model && model.inputRate ? '$' + (model.inputRate).toFixed(6) : '—';
+    document.getElementById('md-output').textContent = model && model.outputRate ? '$' + (model.outputRate).toFixed(6) : '—';
+    if (model && model.inputRate && repo.tokensSaved > 0) {
+      var usd = (repo.tokensSaved * model.inputRate);
+      var win = d.context.contextWindow || 0;
+      var windows = win > 0 ? (repo.tokensSaved / win).toFixed(1) : '0';
+      document.getElementById('cost-usd').textContent = '≈ $' + usd.toFixed(4) + ' saved';
+      document.getElementById('cost-windows').textContent = windows + ' context-windows extended';
+    } else {
+      document.getElementById('cost-usd').textContent = '≈ $0.00 saved';
+      document.getElementById('cost-windows').textContent = '0 context-windows extended';
+    }
+
     document.getElementById('updated').textContent = 'Updated ' + new Date(d.updatedAt).toLocaleTimeString();
   }
 
@@ -331,6 +526,105 @@ function dashboardHtml(tierName) {
     };
   }
   connectSSE();
+
+  // --- Multi-repo (index.sqlite via /api/index) ---------------------------
+  function fmtBytesTop(b) {
+    b = b || 0;
+    if (b >= 1048576) return (b / 1048576).toFixed(1) + ' MiB';
+    if (b >= 1024) return (b / 1024).toFixed(1) + ' KiB';
+    return b + ' B';
+  }
+  function renderIndex(d) {
+    d = d || { updatedAt: null, summary: null, repos: [] };
+    var repos = d.repos || [];
+    var s = d.summary || { totalRepos: 0, totalCheckpoints: 0, totalTokensSaved: 0, totalCompressedOriginalBytes: 0 };
+    document.getElementById('sm-repos').textContent = (s.totalRepos || 0).toLocaleString();
+    document.getElementById('sm-checkpoints').textContent = (s.totalCheckpoints || 0).toLocaleString();
+    document.getElementById('sm-saved').textContent = (s.totalTokensSaved || 0).toLocaleString();
+    document.getElementById('sm-bytes').textContent = fmtBytesTop(s.totalCompressedOriginalBytes);
+
+    // Shared clickable-row renderer for both the in-current table and the
+    // All-repos tab — each row opens the per-repo detail modal.
+    function rowsHtml() {
+      if (!repos.length) return '<tr><td colspan="6" class="repo-none">No repositories registered yet.</td></tr>';
+      return repos.map(function(r) {
+        var model = r.modelName
+          ? '<span class="repo-model">' + sanitize(r.modelName) + '</span>'
+          : '<span class="repo-none">—</span>';
+        var when = r.lastCompactedAt ? new Date(r.lastCompactedAt).toLocaleString() : '—';
+        return '<tr class="repo-link" data-repo="' + sanitize(r.repoRoot) + '">' +
+          '<td title="' + sanitize(r.repoRoot) + '">' + sanitize(r.displayName || r.repoRoot) + '</td>' +
+          '<td>' + model + '</td>' +
+          '<td class="num">' + (r.checkpointCount || 0).toLocaleString() + '</td>' +
+          '<td class="num">' + (r.tokensSaved || 0).toLocaleString() + '</td>' +
+          '<td class="num">' + fmtBytesTop(r.compressedOriginalBytes) + '</td>' +
+          '<td class="num">' + sanitize(when) + '</td>' +
+        '</tr>';
+      }).join('');
+    }
+    document.getElementById('cur-rows').innerHTML = rowsHtml();
+    document.getElementById('all-rows').innerHTML = rowsHtml();
+    bindRepoRows();
+
+    var stamp = d.updatedAt ? 'Updated ' + new Date(d.updatedAt).toLocaleTimeString() : '';
+    document.getElementById('cur-updated').textContent = stamp;
+    document.getElementById('all-updated').textContent = stamp;
+    document.getElementById('sm-updated').textContent = stamp;
+  }
+
+  // Per-repo detail modal ---------------------------------------------------
+  var detailEl = document.getElementById('repo-detail');
+  var indexCache = { repos: [] };
+  function openRepoDetail(root) {
+    var r = null;
+    for (var i = 0; i < indexCache.repos.length; i++) {
+      if (indexCache.repos[i].repoRoot === root) { r = indexCache.repos[i]; break; }
+    }
+    if (!r) return;
+    document.getElementById('rd-name').textContent = r.displayName || r.repoRoot;
+    document.getElementById('rd-path').textContent = r.repoRoot;
+    document.getElementById('rd-model').textContent = r.modelName || '—';
+    document.getElementById('rd-provider').textContent = r.providerName || (r.provider || '—');
+    document.getElementById('rd-cp').textContent = (r.checkpointCount || 0).toLocaleString();
+    document.getElementById('rd-saved').textContent = (r.tokensSaved || 0).toLocaleString();
+    document.getElementById('rd-bytes').textContent = fmtBytesTop(r.compressedOriginalBytes);
+    document.getElementById('rd-when').textContent = r.lastCompactedAt ? new Date(r.lastCompactedAt).toLocaleString() : '—';
+    detailEl.classList.add('open');
+  }
+  document.getElementById('rd-close').addEventListener('click', function() { detailEl.classList.remove('open'); });
+  detailEl.addEventListener('click', function(e) { if (e.target === detailEl) detailEl.classList.remove('open'); });
+  function bindRepoRows() {
+    var rows = document.querySelectorAll('.repo-link');
+    for (var i = 0; i < rows.length; i++) {
+      rows[i].addEventListener('click', function() { openRepoDetail(this.getAttribute('data-repo')); });
+    }
+  }
+  function pollIndex() {
+    fetch('/api/index').then(function(r) { return r.json(); }).then(function(d) {
+      indexCache = d && d.repos ? d : indexCache;
+      renderIndex(d);
+    }).catch(function() {});
+  }
+  pollIndex();
+  setInterval(pollIndex, 5000);
+
+  // --- Tab switching ------------------------------------------------------
+  var tabs = document.querySelectorAll('.tab');
+  var panels = { current: 'panel-current', all: 'panel-all', summary: 'panel-summary' };
+  for (var i = 0; i < tabs.length; i++) {
+    tabs[i].addEventListener('click', function() {
+      var name = this.getAttribute('data-tab');
+      for (var j = 0; j < tabs.length; j++) tabs[j].classList.remove('active');
+      this.classList.add('active');
+      for (var k in panels) {
+        if (Object.prototype.hasOwnProperty.call(panels, k)) {
+          var el = document.getElementById(panels[k]);
+          if (el) el.classList.toggle('active', k === name);
+        }
+      }
+      if (name === 'all' || name === 'summary') pollIndex();
+    });
+  }
 })();
 </script>
 </body>
@@ -380,6 +674,14 @@ export function launchDashboardServer(stateDir) {
             res.end(JSON.stringify(snap));
             return;
         }
+        // Multi-repo aggregate (Phase 5b): the machine-wide repo registry read
+        // directly from SQLite (index.sqlite). Lets one dashboard show every repo's
+        // checkpoints, tokens saved, and active model. Read-only.
+        if (req.url === "/api/index") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify(readIndex() ?? { updatedAt: null, summary: null, repos: [] }));
+            return;
+        }
         if (req.url === "/api/events") {
             res.writeHead(200, {
                 "Content-Type": "text/event-stream",

package/dist/extensions/mega-runtime.js

@@ -14,7 +14,7 @@ import { VectorStore } from "../src/vectorStore.js";
 import { toEngineMessages } from "../src/adapt.js";
 import { normalizeSessionId } from "../src/store.js";
 import { Logger } from "../src/log.js";
-import { recordModelSnapshot } from "../src/store/sqlite.js";
+import { recordModelSnapshot, latestModelSnapshot, upsertRepoRegistry, recordRepoModel } from "../src/store/sqlite.js";
 import { repoStateDir, resolveRepoRoot } from "./mega-config.js";
 import { Dashboard } from "./mega-dashboard.js";
 export const STATUS_KEY = "mega-compact";
@@ -117,6 +117,27 @@ export class MegaRuntime {
         this.store = new VectorStore({ dedupSim: this.config.dedupSim, stateDir: dir });
         this.logger = new Logger({ enabled: this.config.debug, path: join(dir, "mega-compact.log") });
         this.dashboard = new Dashboard(dir);
+        // Aggregate this repo into the machine-wide index so the multi-repo
+        // dashboard (Summary / All-repos tabs) can show it alongside every other
+        // repo. Best-effort + non-fatal: a read-only index dir or contention must
+        // never break the per-repo compaction path. Runs only on repo-switch
+        // (this branch), so it's infrequent — not per-context-event.
+        try {
+            const repo = this.store.repoStats();
+            const di = this.store.dataInvariant();
+            const root = key !== dir ? key : resolveRepoRoot(cwd ?? dir) ?? dir;
+            upsertRepoRegistry({
+                repoRoot: root,
+                displayName: root.split(/[\\/]/).filter(Boolean).pop() ?? root,
+                stateDir: dir,
+                checkpointCount: repo.checkpointCount,
+                tokensSaved: repo.tokensSaved,
+                compressedOriginalBytes: di.compressedOriginalBytes,
+            });
+        }
+        catch {
+            /* non-fatal: index aggregation must not block compaction */
+        }
         return dir;
     }
     // ---- dashboard snapshot + widget ------------------------------------------
@@ -127,6 +148,17 @@ export class MegaRuntime {
         const st = this.store.stats(this.rt.sessionId);
         const repo = this.store.repoStats();
         const di = this.store.dataInvariant();
+        // Active model/provider for the current-repo card + the multi-repo table.
+        const modelSnap = latestModelSnapshot(this.currentStateDir);
+        const model = modelSnap
+            ? {
+                name: modelSnap.modelName ?? modelSnap.modelId,
+                provider: modelSnap.provider,
+                providerName: modelSnap.providerName ?? "",
+                inputRate: modelSnap.inputRate,
+                outputRate: modelSnap.outputRate,
+            }
+            : undefined;
         const armed = this.lastCtxPercent != null && this.lastCtxPercent >= this.config.fastGatePct;
         const ready = armed && (this.lastCtxTokens ?? 0) >= this.config.thresholdTokens;
         this.dashboard.snapshot({
@@ -171,6 +203,7 @@ export class MegaRuntime {
                 duplicatesCollapsed: di.duplicatesCollapsed,
                 bytesPermanentlyDeleted: di.bytesPermanentlyDeleted,
             },
+            model,
         });
         // Live stats widget above the editor
         if (ctx) {
@@ -301,6 +334,18 @@ export class MegaRuntime {
         try {
             const repo = resolveRepoRoot(ctx.cwd) ?? this.currentStateDir;
             recordModelSnapshot(repo, snap, this.currentStateDir);
+            // Denormalize the active model into the machine-wide index so the
+            // All-repos dashboard table can show provider/model per repo without
+            // opening every repo's DB. Best-effort + non-fatal.
+            recordRepoModel(repo, {
+                provider: snap.provider,
+                providerName: snap.providerName,
+                modelName: snap.modelName,
+                inputRate: snap.inputRate,
+                outputRate: snap.outputRate,
+                stateDir: this.currentStateDir,
+                displayName: repo.split(/[\\/]/).filter(Boolean).pop() ?? repo,
+            });
         }
         catch { /* non-fatal: cost estimation degrades to model-in-memory only */ }
     }

package/dist/src/store/sqlite.js

@@ -16,6 +16,7 @@
  */
 import Database from "better-sqlite3";
 import { existsSync, mkdirSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
 import { join } from "node:path";
 import { getStateDir } from "../store.js";
 import { normalizeSessionId } from "../store.js";
@@ -58,6 +59,167 @@ export function openStore(stateDir = getStateDir()) {
     cache.set(stateDir, db);
     return db;
 }
+// ---------------------------------------------------------------------------
+// Global machine-wide index (Phase 5b): a single SQLite DB, separate from every
+// per-repo store, that aggregates one row per repo this machine has run on. The
+// multi-repo dashboard (Summary / All-repos tabs) reads it so ONE dashboard can
+// show every repo's checkpoints, tokens saved, and active model — instead of a
+// per-repo dashboard that only ever sees the repo it was launched from.
+//
+// Written by every pi process on repo-switch (bindRepo) + model capture; read by
+// the dashboard server. Concurrency across 10+ pi processes is handled by WAL +
+// infrequent idempotent upserts (ON CONFLICT). Fully local (PREVENT-PI-004).
+// ---------------------------------------------------------------------------
+/** Resolve the machine-wide index directory (env-overridable). */
+export function getIndexDir() {
+    const override = process.env.MEGACOMPACT_INDEX_DIR;
+    if (override && override.trim() !== "")
+        return override;
+    // homedir() can throw in exotic sandboxes; fall back to tmpdir.
+    try {
+        return join(homedir(), ".mega-compact-index");
+    }
+    catch {
+        return join(tmpdir(), ".mega-compact-index");
+    }
+}
+let indexCache;
+let indexCacheDir;
+/** Open (or reuse) the machine-wide index DB. WAL for concurrent writers. */
+export function openIndexStore(indexDir = getIndexDir()) {
+    if (indexCache && indexCacheDir === indexDir)
+        return indexCache;
+    if (!existsSync(indexDir))
+        mkdirSync(indexDir, { recursive: true });
+    const db = new Database(join(indexDir, "index.sqlite"));
+    db.pragma("journal_mode = WAL");
+    db.pragma("busy_timeout = 3000"); // tolerate brief cross-process write contention
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS repo_registry (
+      repo_root                 TEXT PRIMARY KEY,
+      display_name              TEXT,
+      state_dir                 TEXT NOT NULL,
+      first_seen                INTEGER,
+      last_seen                 INTEGER,
+      last_compacted_at         INTEGER,
+      checkpoint_count          INTEGER DEFAULT 0,
+      tokens_saved              INTEGER DEFAULT 0,
+      compressed_original_bytes INTEGER DEFAULT 0,
+      provider                  TEXT,
+      provider_name             TEXT,
+      model_name                TEXT,
+      input_rate                REAL,
+      output_rate               REAL,
+      model_captured_at         INTEGER
+    );
+    CREATE INDEX IF NOT EXISTS idx_registry_last_seen ON repo_registry(last_seen DESC);
+  `);
+    indexCache = db;
+    indexCacheDir = indexDir;
+    return db;
+}
+/**
+ * Upsert a repo's aggregate stats into the global index. Called on repo-switch
+ * (infrequent). Preserves first_seen + the model columns on update (model is
+ * written separately by recordRepoModel so we never clobber it here with nulls).
+ */
+export function upsertRepoRegistry(row, indexDir = getIndexDir()) {
+    const db = openIndexStore(indexDir);
+    const now = Date.now();
+    db.prepare(`INSERT INTO repo_registry
+       (repo_root, display_name, state_dir, first_seen, last_seen, last_compacted_at,
+        checkpoint_count, tokens_saved, compressed_original_bytes)
+     VALUES (@repo_root, @display_name, @state_dir, @now, @now, @last_compacted_at,
+             @checkpoint_count, @tokens_saved, @compressed_original_bytes)
+     ON CONFLICT(repo_root) DO UPDATE SET
+       display_name = excluded.display_name,
+       state_dir = excluded.state_dir,
+       last_seen = excluded.last_seen,
+       last_compacted_at = COALESCE(excluded.last_compacted_at, repo_registry.last_compacted_at),
+       checkpoint_count = excluded.checkpoint_count,
+       tokens_saved = excluded.tokens_saved,
+       compressed_original_bytes = excluded.compressed_original_bytes`).run({
+        repo_root: row.repoRoot,
+        display_name: row.displayName,
+        state_dir: row.stateDir,
+        now,
+        last_compacted_at: row.lastCompactedAt ?? null,
+        checkpoint_count: row.checkpointCount,
+        tokens_saved: row.tokensSaved,
+        compressed_original_bytes: row.compressedOriginalBytes,
+    });
+}
+/**
+ * Record the active model/provider for a repo in the global index (denormalized
+ * so the All-repos table shows model without opening each repo's DB). Upserts a
+ * bare registry row if the repo isn't registered yet.
+ */
+export function recordRepoModel(repoRoot, model, indexDir = getIndexDir()) {
+    const db = openIndexStore(indexDir);
+    const now = Date.now();
+    db.prepare(`INSERT INTO repo_registry
+       (repo_root, display_name, state_dir, first_seen, last_seen,
+        provider, provider_name, model_name, input_rate, output_rate, model_captured_at)
+     VALUES (@repo_root, @display_name, @state_dir, @now, @now,
+             @provider, @provider_name, @model_name, @input_rate, @output_rate, @now)
+     ON CONFLICT(repo_root) DO UPDATE SET
+       last_seen = excluded.last_seen,
+       provider = excluded.provider,
+       provider_name = excluded.provider_name,
+       model_name = excluded.model_name,
+       input_rate = excluded.input_rate,
+       output_rate = excluded.output_rate,
+       model_captured_at = excluded.model_captured_at`).run({
+        repo_root: repoRoot,
+        display_name: model.displayName,
+        state_dir: model.stateDir,
+        now,
+        provider: model.provider,
+        provider_name: model.providerName,
+        model_name: model.modelName,
+        input_rate: model.inputRate,
+        output_rate: model.outputRate,
+    });
+}
+function mapRegistryRow(row) {
+    return {
+        repoRoot: row.repo_root,
+        displayName: row.display_name ?? "",
+        stateDir: row.state_dir,
+        firstSeen: row.first_seen ?? 0,
+        lastSeen: row.last_seen ?? 0,
+        lastCompactedAt: row.last_compacted_at ?? null,
+        checkpointCount: row.checkpoint_count ?? 0,
+        tokensSaved: row.tokens_saved ?? 0,
+        compressedOriginalBytes: row.compressed_original_bytes ?? 0,
+        provider: row.provider ?? null,
+        providerName: row.provider_name ?? null,
+        modelName: row.model_name ?? null,
+        inputRate: row.input_rate ?? null,
+        outputRate: row.output_rate ?? null,
+        modelCapturedAt: row.model_captured_at ?? null,
+    };
+}
+/** All registered repos, most-recently-seen first. */
+export function listRepoRegistry(indexDir = getIndexDir()) {
+    const db = openIndexStore(indexDir);
+    const rows = db.prepare("SELECT * FROM repo_registry ORDER BY last_seen DESC").all();
+    return rows.map(mapRegistryRow);
+}
+/** A single repo's registry row, or undefined. */
+export function getRepoRegistry(repoRoot, indexDir = getIndexDir()) {
+    const db = openIndexStore(indexDir);
+    const row = db.prepare("SELECT * FROM repo_registry WHERE repo_root = ?").get(repoRoot);
+    return row ? mapRegistryRow(row) : undefined;
+}
+/** Close the cached index connection (test teardown only). */
+export function closeIndexStore() {
+    if (indexCache) {
+        indexCache.close();
+        indexCache = undefined;
+        indexCacheDir = undefined;
+    }
+}
 function initSchema(db) {
     db.exec(`
     CREATE TABLE IF NOT EXISTS context_chunks (

package/extensions/DASHBOARD.md

@@ -2,7 +2,8 @@
 
 A lightweight local web dashboard for monitoring mega-compact's live state — compactions, context usage, checkpoints, and recall hits.
 
-Zero npm dependencies. Uses only Node built-in modules (`http`, `fs`, `path`).
+Uses Node built-in modules (`http`, `fs`, `path`) plus `better-sqlite3` (the
+project's one-store DB backend) to read the machine-wide multi-repo index.
 
 ## Quick Start
 
@@ -72,8 +73,8 @@ All files are written to the extension's state directory
 The server runs as a detached child process, independent of the pi session. It:
 - Auto-discovers the state directory from the `port.pid` file
 - Cleans up stale `port.pid` files from dead processes
-- Supports `SIGHUP` for graceful shutdown
-- Serves static HTML with no external dependencies
+- Supports `SIGTERM`/`SIGINT` for graceful shutdown
+- Serves static HTML; reads the multi-repo index from SQLite (`better-sqlite3`)
 
 ## Browser UI
 
@@ -147,11 +148,23 @@ The extension tracks active sub-agents in real-time:
 - The server only listens on `127.0.0.1` (localhost)
 - No authentication (local-only, not exposed to network)
 - No write endpoints — all APIs are read-only
-- No npm dependencies — only Node.js built-ins
+
+## Multi-Repo Index (Phase 5b)
+
+The dashboard shows every repo that has run mega-compact on this machine, not
+just the one it was launched from. The extension writes a machine-wide
+`repo_registry` into a single SQLite DB (`<indexDir>/index.sqlite`, where
+`indexDir` is `$MEGACOMPACT_INDEX_DIR` or `~/.mega-compact-index`), one row per
+repo with checkpoint count, tokens saved, compressed-original bytes, and the
+active model/provider (denormalized from `model_snapshots`). The dashboard
+server opens that table read-only (`GET /api/index`) and renders the **All
+repos** (per-repo table) and **Summary** (machine-wide aggregate) tabs. All
+registry data lives in SQLite — there is no JSON mirror; the "one store"
+invariant is preserved end-to-end.
 
 ## Troubleshooting
 
-**Port already in use**: The server picks a random port in 3000–3999. If all are taken, it will retry. Check `/dashboard-status` for the current port.
+**Port already in use**: The server picks a port in 9320–9329. If all are taken, it will retry. Check `/dashboard-status` for the current port.
 
 **Server won't start**: Check for stale `port.pid` files. Run `/dashboard-stop` to clean up, then try `/dashboard` again.