pi-mega-compact 0.4.17 → 0.4.18

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
 // ---------------------------------------------------------------------------
@@ -111,6 +176,25 @@ 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; }
 </style>
 </head>
 <body>
@@ -119,6 +203,14 @@ function dashboardHtml(tierName) {
 
 <h1><span>mega-compact</span><span class="tier">${tierName}</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>
@@ -206,6 +298,35 @@ function dashboardHtml(tierName) {
 </div>
 
 <div class="updated" id="updated"></div>
+</div><!-- /panel-current -->
+
+<!-- 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() {
@@ -331,6 +452,69 @@ 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);
+
+    var body = document.getElementById('all-rows');
+    if (!repos.length) {
+      body.innerHTML = '<tr><td colspan="6" class="repo-none">No repositories registered yet.</td></tr>';
+    } else {
+      body.innerHTML = 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>' +
+          '<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('');
+    }
+    var stamp = d.updatedAt ? 'Updated ' + new Date(d.updatedAt).toLocaleTimeString() : '';
+    document.getElementById('all-updated').textContent = stamp;
+    document.getElementById('sm-updated').textContent = stamp;
+  }
+  function pollIndex() {
+    fetch('/api/index').then(function(r) { return r.json(); }).then(renderIndex).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 +564,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.
 

package/extensions/dashboard-server.ts

@@ -13,7 +13,81 @@
 
 import { createServer, type IncomingMessage, type ServerResponse } 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(): string {
+  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");
+  }
+}
+
+interface IndexRepo {
+  repoRoot: string;
+  displayName: string;
+  checkpointCount: number;
+  tokensSaved: number;
+  compressedOriginalBytes: number;
+  lastCompactedAt: number | null;
+  provider: string | null;
+  providerName: string | null;
+  modelName: string | null;
+  inputRate: number | null;
+  outputRate: number | null;
+  lastSeen: number;
+}
+
+/** Read the machine-wide repo registry from SQLite (read-only, single shot). */
+function readIndex(): { updatedAt: string; summary: unknown; repos: unknown[] } | null {
+  const indexPath = join(getIndexDir(), "index.sqlite");
+  if (!existsSync(indexPath)) return null;
+  let db: Database.Database | undefined;
+  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() as Record<string, unknown>[];
+    const repos: IndexRepo[] = 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 as number | null) ?? null,
+      provider: (r.provider as string | null) ?? null,
+      providerName: (r.provider_name as string | null) ?? null,
+      modelName: (r.model_name as string | null) ?? null,
+      inputRate: (r.input_rate as number | null) ?? null,
+      outputRate: (r.output_rate as number | null) ?? 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 */ }
+  }
+}
 
 // ---------------------------------------------------------------------------
 // Types
@@ -175,6 +249,25 @@ function dashboardHtml(tierName: string): string {
   .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; }
 </style>
 </head>
 <body>
@@ -183,6 +276,14 @@ function dashboardHtml(tierName: string): string {
 
 <h1><span>mega-compact</span><span class="tier">${tierName}</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>
@@ -270,6 +371,35 @@ function dashboardHtml(tierName: string): string {
 </div>
 
 <div class="updated" id="updated"></div>
+</div><!-- /panel-current -->
+
+<!-- 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() {
@@ -395,6 +525,69 @@ function dashboardHtml(tierName: string): string {
     };
   }
   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);
+
+    var body = document.getElementById('all-rows');
+    if (!repos.length) {
+      body.innerHTML = '<tr><td colspan="6" class="repo-none">No repositories registered yet.</td></tr>';
+    } else {
+      body.innerHTML = 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>' +
+          '<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('');
+    }
+    var stamp = d.updatedAt ? 'Updated ' + new Date(d.updatedAt).toLocaleTimeString() : '';
+    document.getElementById('all-updated').textContent = stamp;
+    document.getElementById('sm-updated').textContent = stamp;
+  }
+  function pollIndex() {
+    fetch('/api/index').then(function(r) { return r.json(); }).then(renderIndex).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>
@@ -453,6 +646,15 @@ export function launchDashboardServer(stateDir: string): Promise<{ port: number;
       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/extensions/mega-dashboard.ts

@@ -82,6 +82,14 @@ export interface DashboardSnapshot {
     duplicatesCollapsed: number;     // dedup duplicates (original kept on survivor)
     bytesPermanentlyDeleted: number; // ALWAYS 0 — the invariant
   };
+  /** Active model/provider (captured live) — shown on the current-repo card. */
+  model?: {
+    name: string;          // Model.name or Model.id
+    provider: string;      // ProviderId (Model.provider)
+    providerName: string;  // human display name (e.g. "OpenAI")
+    inputRate: number;     // USD per input token (Model.cost)
+    outputRate: number;    // USD per output token (Model.cost)
+  };
 }
 
 export class Dashboard {

package/extensions/mega-runtime.ts

@@ -17,7 +17,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, type ModelSnapshot } from "../src/store/sqlite.js";
+import { recordModelSnapshot, latestModelSnapshot, upsertRepoRegistry, recordRepoModel, type ModelSnapshot } from "../src/store/sqlite.js";
 import { repoStateDir, resolveRepoRoot, type MegaConfig } from "./mega-config.js";
 import { Dashboard, type DashboardSnapshot } from "./mega-dashboard.js";
 
@@ -142,6 +142,26 @@ 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;
   }
 
@@ -153,6 +173,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({
@@ -197,6 +228,7 @@ export class MegaRuntime {
         duplicatesCollapsed: di.duplicatesCollapsed,
         bytesPermanentlyDeleted: di.bytesPermanentlyDeleted,
       },
+      model,
     } as DashboardSnapshot);
 
     // Live stats widget above the editor
@@ -321,6 +353,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.4.17",
+  "version": "0.4.18",
   "description": "Layered, local, vector-backed context compressor for pi — supersede/collapse/cluster compaction with deduped inline recall.",
   "type": "module",
   "license": "BSD-2-Clause",

package/src/store/sqlite.ts

@@ -17,6 +17,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 type { StoredCheckpoint, SessionState } from "../store.js";
@@ -62,6 +63,219 @@ export function openStore(stateDir: string = getStateDir()): Database.Database {
   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(): string {
+  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: Database.Database | undefined;
+let indexCacheDir: string | undefined;
+
+/** Open (or reuse) the machine-wide index DB. WAL for concurrent writers. */
+export function openIndexStore(indexDir: string = getIndexDir()): Database.Database {
+  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;
+}
+
+/** One row of the global repo registry (multi-repo dashboard source). */
+export interface RepoRegistryRow {
+  repoRoot: string;
+  displayName: string;
+  stateDir: string;
+  firstSeen: number;
+  lastSeen: number;
+  lastCompactedAt: number | null;
+  checkpointCount: number;
+  tokensSaved: number;
+  compressedOriginalBytes: number;
+  provider: string | null;
+  providerName: string | null;
+  modelName: string | null;
+  inputRate: number | null;
+  outputRate: number | null;
+  modelCapturedAt: number | null;
+}
+
+/**
+ * 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: {
+    repoRoot: string;
+    displayName: string;
+    stateDir: string;
+    checkpointCount: number;
+    tokensSaved: number;
+    compressedOriginalBytes: number;
+    lastCompactedAt?: number | null;
+  },
+  indexDir: string = getIndexDir(),
+): void {
+  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: string,
+  model: {
+    provider: string;
+    providerName: string | null;
+    modelName: string | null;
+    inputRate: number;
+    outputRate: number;
+    stateDir: string;
+    displayName: string;
+  },
+  indexDir: string = getIndexDir(),
+): void {
+  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: any): RepoRegistryRow {
+  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: string = getIndexDir()): RepoRegistryRow[] {
+  const db = openIndexStore(indexDir);
+  const rows = db.prepare("SELECT * FROM repo_registry ORDER BY last_seen DESC").all() as any[];
+  return rows.map(mapRegistryRow);
+}
+
+/** A single repo's registry row, or undefined. */
+export function getRepoRegistry(repoRoot: string, indexDir: string = getIndexDir()): RepoRegistryRow | undefined {
+  const db = openIndexStore(indexDir);
+  const row = db.prepare("SELECT * FROM repo_registry WHERE repo_root = ?").get(repoRoot) as any;
+  return row ? mapRegistryRow(row) : undefined;
+}
+
+/** Close the cached index connection (test teardown only). */
+export function closeIndexStore(): void {
+  if (indexCache) {
+    indexCache.close();
+    indexCache = undefined;
+    indexCacheDir = undefined;
+  }
+}
+
 function initSchema(db: Database.Database): void {
   db.exec(`
     CREATE TABLE IF NOT EXISTS context_chunks (