pi-mega-compact 0.6.4 → 0.6.6

package/dist/extensions/dashboard-server.js

@@ -436,6 +436,23 @@ function dashboardHtml(tierName) {
     <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>
+
+  <h2 style="margin-top:24px;font-size:13px;color:#8b949e;text-transform:uppercase;letter-spacing:.5px">Savings by Model</h2>
+  <p class="legend-note" style="margin-bottom:10px">How much context &amp; cost mega-compact has reclaimed, grouped by the model you were running. Compression ratio reflects workload/content, not model quality.</p>
+  <table class="repos">
+    <thead>
+      <tr>
+        <th>Model</th><th>Provider</th>
+        <th style="text-align:right">Repos</th>
+        <th style="text-align:right">Checkpoints</th>
+        <th style="text-align:right">Tokens Saved</th>
+        <th style="text-align:right">$ Saved</th>
+        <th style="text-align:right">Last Used</th>
+      </tr>
+    </thead>
+    <tbody id="bm-rows"><tr><td colspan="7" class="repo-none">loading…</td></tr></tbody>
+  </table>
+
   <div class="updated" id="sm-updated"></div>
 </div>
 
@@ -644,6 +661,49 @@ function dashboardHtml(tierName) {
     document.getElementById('cur-updated').textContent = stamp;
     document.getElementById('all-updated').textContent = stamp;
     document.getElementById('sm-updated').textContent = stamp;
+    renderByModel(repos);
+  }
+
+  // Savings-by-model aggregation for the Summary tab — groups the machine-
+  // wide repo registry by (modelName || '(unknown)') so the user can see how
+  // much context + cost mega-compact has reclaimed, broken down by which model
+  // they were running. $ Saved = Σ(tokensSaved × inputRate) per model. Sorted
+  // by tokens saved descending so the biggest-reclaim model wins the top row.
+  function renderByModel(repos) {
+    var rows = document.getElementById('bm-rows');
+    if (!rows) return;
+    if (!repos || !repos.length) {
+      rows.innerHTML = '<tr><td colspan="7" class="repo-none">No repositories registered yet.</td></tr>';
+      return;
+    }
+    var groups = {};
+    for (var i = 0; i < repos.length; i++) {
+      var r = repos[i];
+      var key = (r.modelName && String(r.modelName).trim()) || '(unknown)';
+      if (!groups[key]) groups[key] = { model: key, provider: r.providerName || r.provider || '—', repos: 0, checkpoints: 0, tokensSaved: 0, usd: 0, lastAt: 0, rates: [] };
+      var g = groups[key];
+      g.repos++;
+      g.checkpoints += (r.checkpointCount || 0);
+      g.tokensSaved += (r.tokensSaved || 0);
+      if (r.inputRate) { g.usd += (r.tokensSaved || 0) * r.inputRate; g.rates.push(r.inputRate); }
+      if (r.lastCompactedAt && r.lastCompactedAt > g.lastAt) g.lastAt = r.lastCompactedAt;
+    }
+    var arr = [];
+    for (var k in groups) { if (Object.prototype.hasOwnProperty.call(groups, k)) arr.push(groups[k]); }
+    arr.sort(function(a, b) { return b.tokensSaved - a.tokensSaved; });
+    rows.innerHTML = arr.map(function(g) {
+      var usd = g.usd > 0 ? '$' + g.usd.toFixed(4) : '—';
+      var when = g.lastAt ? new Date(g.lastAt).toLocaleString() : '—';
+      return '<tr>' +
+        '<td><span class="repo-model">' + sanitize(g.model) + '</span></td>' +
+        '<td>' + sanitize(g.provider) + '</td>' +
+        '<td class="num">' + g.repos.toLocaleString() + '</td>' +
+        '<td class="num">' + g.checkpoints.toLocaleString() + '</td>' +
+        '<td class="num">' + g.tokensSaved.toLocaleString() + '</td>' +
+        '<td class="num">' + sanitize(usd) + '</td>' +
+        '<td class="num">' + sanitize(when) + '</td>' +
+      '</tr>';
+    }).join('');
   }
 
   // Per-repo detail modal ---------------------------------------------------

package/dist/extensions/mega-runtime.js

@@ -53,6 +53,7 @@ export const C = {
     magenta: "\x1b[38;5;201m", // dedup rate
     blue: "\x1b[38;5;75m", // repo totals
     gray: "\x1b[38;5;245m", // labels
+    red: "\x1b[38;5;203m", // pressure / overflow
 };
 const PULSE = ["◐", "◓", "◑", "◒"];
 export class MegaRuntime {
@@ -315,7 +316,7 @@ export class MegaRuntime {
             // 1e6, k at/above 1e3, raw below — so 5,472,700 → "5.5M", 24,100 → "24.1k",
             // 142 → "142". Dropped (in) = Freed + Kept; Freed = rt.tokensSaved (session)
             // / repo.tokensSaved meta (repo); Kept = totalTokenEstimate (stored).
-            const fmt = (x) => x >= 1_000_000 ? `${(x / 1_000_000).toFixed(1)}M`
+            const fmt = (x) => x >= 1_000_000 ? `${(x / 1_000_000).toFixed(1)}mil`
                 : x >= 1000 ? `${(x / 1000).toFixed(1)}k`
                     : `${Math.round(x)}`;
             const agentStr = this.activeAgents > 0 ? ` │ 🤖 ${this.activeAgents} agent${this.activeAgents === 1 ? "" : "s"}` : "";
@@ -331,21 +332,32 @@ export class MegaRuntime {
             const repoKept = repo.totalTokenEstimate;
             const repoFreed = repo.tokensSaved;
             const repoPct = repoIn > 0 ? repoFreed / repoIn : 0;
+            // Retro gradient bar — 12 cells, each cell shaded by fill so it reads as a
+            // smooth green→amber→red ramp instead of a flat block. Higher fill = more
+            // reclaimed, so the bar trends green at the right end.
+            const ramp = (pct, w = 12) => {
+                const cells = ["▏", "▎", "▍", "▌", "▋", "▊", "▉", "█"];
+                const scaled = Math.max(0, Math.min(w, pct * w));
+                const full = Math.floor(scaled);
+                const frac = scaled - full;
+                const fracCell = frac > 0 ? cells[Math.round(frac * (cells.length - 1))] : "";
+                let out = "";
+                for (let i = 0; i < full; i++)
+                    out += (i / w < 0.6 ? C.green : i / w < 0.85 ? C.amber : C.red) + "█";
+                if (fracCell)
+                    out += (full / w < 0.6 ? C.green : full / w < 0.85 ? C.amber : C.red) + fracCell;
+                out += C.dim + "░".repeat(Math.max(0, w - full - (fracCell ? 1 : 0))) + C.reset;
+                return out;
+            };
+            const ctxPct = this.lastCtxPercent != null ? this.lastCtxPercent / 100 : 0;
+            const sTxt = (sessPct * 100).toFixed(sessPct * 100 >= 10 ? 0 : 1);
+            const rTxt = (repoPct * 100).toFixed(repoPct * 100 >= 10 ? 0 : 1);
             const lines = [
-                ` ${C.amber}⚡ ${tierLabel}${C.reset} v${C.bold}${ownVersion()}${C.reset} │ ${tokStr}/${maxStr} tokens (${C.bold}${pctStr}${C.reset}) │ ${st.checkpointCount} saved${agentStr}${turnStr}`,
-                `   ${triggerLabel} │ ${C.magenta}repeat-skipped: ${dedupStr}${C.reset}`,
-                `   ${C.gray}dropped ${fmt(sessIn)} → kept ${fmt(sessKept)} sess / ${fmt(repoKept)} repo · freed ${fmt(sessFreed)} sess / ${fmt(repoFreed)} repo${C.reset}`,
+                // L1 — header: tier + ctx fill bar + tokens + checkpoints + agents
+                ` ${C.amber}⚡ ${tierLabel}${C.reset} v${C.bold}${ownVersion()}${C.reset} ${ramp(ctxPct)} ${C.bold}${pctStr}${C.reset} ${tokStr}/${maxStr} │ ${st.checkpointCount} chk${agentStr}${turnStr}`,
+                // L2 — status + dedup + session + all-time savings bars
+                `   ${triggerLabel} ${C.magenta}dup ${dedupStr}${C.reset} ${C.gray}sess${C.reset} ${ramp(sessPct)} ${C.green}${sTxt}%${C.reset} ${C.gray}all-time${C.reset} ${ramp(repoPct)} ${C.blue}${rTxt}%${C.reset}`,
             ];
-            // Compression meter — the single headline "% tokens saved" (Freed / In),
-            // same formula as the dashboard. Higher = better, so it reads green.
-            {
-                const w = 10;
-                const filled = Math.max(0, Math.min(w, Math.round(sessPct * w)));
-                const cbar = C.green + "▓".repeat(filled) + C.dim + "░".repeat(w - filled) + C.reset;
-                const sTxt = (sessPct * 100).toFixed(sessPct * 100 >= 10 ? 0 : 1);
-                const rTxt = (repoPct * 100).toFixed(repoPct * 100 >= 10 ? 0 : 1);
-                lines.push(`   ${cbar} ${sTxt}% tokens saved (sess) · ${rTxt}% repo${C.reset}`);
-            }
             // Live "now processing" line + why + recent deduped/compacted events,
             // collapsed to ONE rotating line (fresh only). The ticker ring buffer
             // (≤5 most-recent events) is cycled one-per-repaint so the line scrolls
@@ -367,10 +379,10 @@ export class MegaRuntime {
             else if (this.pulsing) {
                 lines.push(`   ${pulse}${C.teal}compacting…${C.reset}`);
             }
-            // Plain-language hint so first-time users understand the widget. Always
-            // last, dimmed. "/mega-help explains these terms."
+            // L4 — accounting: session + all-time in/out/freed, one compact line.
+            // in = dropped into compaction, out = kept summaries, freed = saved.
             if (lines.length < 10) {
-                lines.push(`   ${C.dim}auto-compresses old context to free space · nothing deleted · /mega-help${C.reset}`);
+                lines.push(`   ${C.dim}session ↑${fmt(sessIn)} in ↓${fmt(sessKept)} out ↓${fmt(sessFreed)} freed · all-time ↑${fmt(repoIn)} in ↓${fmt(repoKept)} out ↓${fmt(repoFreed)} freed${C.reset}`);
             }
             ctx.ui.setWidget(WIDGET_KEY, lines, { placement: "aboveEditor" });
         }

package/dist/src/compact.js

@@ -27,8 +27,14 @@ export function isChatty(text) {
     }
     return text.length < 40 && !/(\/|\.|\{|import |def |function )/.test(text);
 }
-/** Extract plausible file paths (contain '/' + an interesting extension). */
+/** Extract plausible file paths (contain '/' + an interesting extension).
+ * Defensive against a missing/empty payload: pi's adapter can hand the engine
+ * a message whose `text`/`input`/`output` is undefined (e.g. a pure tool-call
+ * or tool-result message), and `.split` on undefined throws and takes down the
+ * whole compaction. Guard once at the source so every caller is safe. */
 export function extractFileCandidates(content) {
+    if (!content)
+        return [];
     const out = [];
     for (const raw of content.split(/\s+/)) {
         // Trim surrounding punctuation only — do NOT strip internal dots, or we

package/dist/src/supersede.js

@@ -9,6 +9,9 @@
 import { extractFileCandidates } from "./compact.js";
 /** Classify a message's relationship to a file path. */
 function fileOps(msg) {
+    // msg.text may be undefined for pure tool-call/result messages; the guard
+    // lives in extractFileCandidates, but the early return short-circuits the
+    // write-detection regex too so we never classify an empty message.
     const paths = extractFileCandidates(msg.text);
     if (paths.length === 0)
         return [];

package/extensions/dashboard-server.ts

@@ -534,6 +534,23 @@ function dashboardHtml(tierName: string): string {
     <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>
+
+  <h2 style="margin-top:24px;font-size:13px;color:#8b949e;text-transform:uppercase;letter-spacing:.5px">Savings by Model</h2>
+  <p class="legend-note" style="margin-bottom:10px">How much context &amp; cost mega-compact has reclaimed, grouped by the model you were running. Compression ratio reflects workload/content, not model quality.</p>
+  <table class="repos">
+    <thead>
+      <tr>
+        <th>Model</th><th>Provider</th>
+        <th style="text-align:right">Repos</th>
+        <th style="text-align:right">Checkpoints</th>
+        <th style="text-align:right">Tokens Saved</th>
+        <th style="text-align:right">$ Saved</th>
+        <th style="text-align:right">Last Used</th>
+      </tr>
+    </thead>
+    <tbody id="bm-rows"><tr><td colspan="7" class="repo-none">loading…</td></tr></tbody>
+  </table>
+
   <div class="updated" id="sm-updated"></div>
 </div>
 
@@ -742,6 +759,49 @@ function dashboardHtml(tierName: string): string {
     document.getElementById('cur-updated').textContent = stamp;
     document.getElementById('all-updated').textContent = stamp;
     document.getElementById('sm-updated').textContent = stamp;
+    renderByModel(repos);
+  }
+
+  // Savings-by-model aggregation for the Summary tab — groups the machine-
+  // wide repo registry by (modelName || '(unknown)') so the user can see how
+  // much context + cost mega-compact has reclaimed, broken down by which model
+  // they were running. $ Saved = Σ(tokensSaved × inputRate) per model. Sorted
+  // by tokens saved descending so the biggest-reclaim model wins the top row.
+  function renderByModel(repos) {
+    var rows = document.getElementById('bm-rows');
+    if (!rows) return;
+    if (!repos || !repos.length) {
+      rows.innerHTML = '<tr><td colspan="7" class="repo-none">No repositories registered yet.</td></tr>';
+      return;
+    }
+    var groups = {};
+    for (var i = 0; i < repos.length; i++) {
+      var r = repos[i];
+      var key = (r.modelName && String(r.modelName).trim()) || '(unknown)';
+      if (!groups[key]) groups[key] = { model: key, provider: r.providerName || r.provider || '—', repos: 0, checkpoints: 0, tokensSaved: 0, usd: 0, lastAt: 0, rates: [] };
+      var g = groups[key];
+      g.repos++;
+      g.checkpoints += (r.checkpointCount || 0);
+      g.tokensSaved += (r.tokensSaved || 0);
+      if (r.inputRate) { g.usd += (r.tokensSaved || 0) * r.inputRate; g.rates.push(r.inputRate); }
+      if (r.lastCompactedAt && r.lastCompactedAt > g.lastAt) g.lastAt = r.lastCompactedAt;
+    }
+    var arr = [];
+    for (var k in groups) { if (Object.prototype.hasOwnProperty.call(groups, k)) arr.push(groups[k]); }
+    arr.sort(function(a, b) { return b.tokensSaved - a.tokensSaved; });
+    rows.innerHTML = arr.map(function(g) {
+      var usd = g.usd > 0 ? '$' + g.usd.toFixed(4) : '—';
+      var when = g.lastAt ? new Date(g.lastAt).toLocaleString() : '—';
+      return '<tr>' +
+        '<td><span class="repo-model">' + sanitize(g.model) + '</span></td>' +
+        '<td>' + sanitize(g.provider) + '</td>' +
+        '<td class="num">' + g.repos.toLocaleString() + '</td>' +
+        '<td class="num">' + g.checkpoints.toLocaleString() + '</td>' +
+        '<td class="num">' + g.tokensSaved.toLocaleString() + '</td>' +
+        '<td class="num">' + sanitize(usd) + '</td>' +
+        '<td class="num">' + sanitize(when) + '</td>' +
+      '</tr>';
+    }).join('');
   }
 
   // Per-repo detail modal ---------------------------------------------------

package/extensions/mega-runtime.ts

@@ -69,6 +69,7 @@ export const C = {
   magenta: "\x1b[38;5;201m", // dedup rate
   blue: "\x1b[38;5;75m", // repo totals
   gray: "\x1b[38;5;245m", // labels
+  red: "\x1b[38;5;203m", // pressure / overflow
 };
 
 const PULSE = ["◐", "◓", "◑", "◒"];
@@ -344,7 +345,7 @@ export class MegaRuntime {
       // 142 → "142". Dropped (in) = Freed + Kept; Freed = rt.tokensSaved (session)
       // / repo.tokensSaved meta (repo); Kept = totalTokenEstimate (stored).
       const fmt = (x: number) =>
-        x >= 1_000_000 ? `${(x / 1_000_000).toFixed(1)}M`
+        x >= 1_000_000 ? `${(x / 1_000_000).toFixed(1)}mil`
         : x >= 1000 ? `${(x / 1000).toFixed(1)}k`
         : `${Math.round(x)}`;
       const agentStr = this.activeAgents > 0 ? ` │ 🤖 ${this.activeAgents} agent${this.activeAgents === 1 ? "" : "s"}` : "";
@@ -360,21 +361,30 @@ export class MegaRuntime {
       const repoKept = repo.totalTokenEstimate;
       const repoFreed = repo.tokensSaved;
       const repoPct = repoIn > 0 ? repoFreed / repoIn : 0;
+      // Retro gradient bar — 12 cells, each cell shaded by fill so it reads as a
+      // smooth green→amber→red ramp instead of a flat block. Higher fill = more
+      // reclaimed, so the bar trends green at the right end.
+      const ramp = (pct: number, w = 12): string => {
+        const cells = ["▏","▎","▍","▌","▋","▊","▉","█"];
+        const scaled = Math.max(0, Math.min(w, pct * w));
+        const full = Math.floor(scaled);
+        const frac = scaled - full;
+        const fracCell = frac > 0 ? cells[Math.round(frac * (cells.length - 1))] : "";
+        let out = "";
+        for (let i = 0; i < full; i++) out += (i / w < 0.6 ? C.green : i / w < 0.85 ? C.amber : C.red) + "█";
+        if (fracCell) out += (full / w < 0.6 ? C.green : full / w < 0.85 ? C.amber : C.red) + fracCell;
+        out += C.dim + "░".repeat(Math.max(0, w - full - (fracCell ? 1 : 0))) + C.reset;
+        return out;
+      };
+      const ctxPct = this.lastCtxPercent != null ? this.lastCtxPercent / 100 : 0;
+      const sTxt = (sessPct * 100).toFixed(sessPct * 100 >= 10 ? 0 : 1);
+      const rTxt = (repoPct * 100).toFixed(repoPct * 100 >= 10 ? 0 : 1);
       const lines = [
-        ` ${C.amber}⚡ ${tierLabel}${C.reset} v${C.bold}${ownVersion()}${C.reset} │ ${tokStr}/${maxStr} tokens (${C.bold}${pctStr}${C.reset}) │ ${st.checkpointCount} saved${agentStr}${turnStr}`,
-        `   ${triggerLabel} │ ${C.magenta}repeat-skipped: ${dedupStr}${C.reset}`,
-        `   ${C.gray}dropped ${fmt(sessIn)} → kept ${fmt(sessKept)} sess / ${fmt(repoKept)} repo · freed ${fmt(sessFreed)} sess / ${fmt(repoFreed)} repo${C.reset}`,
+        // L1 — header: tier + ctx fill bar + tokens + checkpoints + agents
+        ` ${C.amber}⚡ ${tierLabel}${C.reset} v${C.bold}${ownVersion()}${C.reset} ${ramp(ctxPct)} ${C.bold}${pctStr}${C.reset} ${tokStr}/${maxStr} │ ${st.checkpointCount} chk${agentStr}${turnStr}`,
+        // L2 — status + dedup + session + all-time savings bars
+        `   ${triggerLabel} ${C.magenta}dup ${dedupStr}${C.reset} ${C.gray}sess${C.reset} ${ramp(sessPct)} ${C.green}${sTxt}%${C.reset} ${C.gray}all-time${C.reset} ${ramp(repoPct)} ${C.blue}${rTxt}%${C.reset}`,
       ];
-      // Compression meter — the single headline "% tokens saved" (Freed / In),
-      // same formula as the dashboard. Higher = better, so it reads green.
-      {
-        const w = 10;
-        const filled = Math.max(0, Math.min(w, Math.round(sessPct * w)));
-        const cbar = C.green + "▓".repeat(filled) + C.dim + "░".repeat(w - filled) + C.reset;
-        const sTxt = (sessPct * 100).toFixed(sessPct * 100 >= 10 ? 0 : 1);
-        const rTxt = (repoPct * 100).toFixed(repoPct * 100 >= 10 ? 0 : 1);
-        lines.push(`   ${cbar} ${sTxt}% tokens saved (sess) · ${rTxt}% repo${C.reset}`);
-      }
       // Live "now processing" line + why + recent deduped/compacted events,
       // collapsed to ONE rotating line (fresh only). The ticker ring buffer
       // (≤5 most-recent events) is cycled one-per-repaint so the line scrolls
@@ -394,10 +404,10 @@ export class MegaRuntime {
       } else if (this.pulsing) {
         lines.push(`   ${pulse}${C.teal}compacting…${C.reset}`);
       }
-      // Plain-language hint so first-time users understand the widget. Always
-      // last, dimmed. "/mega-help explains these terms."
+      // L4 — accounting: session + all-time in/out/freed, one compact line.
+      // in = dropped into compaction, out = kept summaries, freed = saved.
       if (lines.length < 10) {
-        lines.push(`   ${C.dim}auto-compresses old context to free space · nothing deleted · /mega-help${C.reset}`);
+        lines.push(`   ${C.dim}session ↑${fmt(sessIn)} in ↓${fmt(sessKept)} out ↓${fmt(sessFreed)} freed · all-time ↑${fmt(repoIn)} in ↓${fmt(repoKept)} out ↓${fmt(repoFreed)} freed${C.reset}`);
       }
       ctx.ui.setWidget(WIDGET_KEY, lines, { placement: "aboveEditor" });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "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/compact.ts

@@ -36,8 +36,13 @@ export function isChatty(text: string): boolean {
   return text.length < 40 && !/(\/|\.|\{|import |def |function )/.test(text);
 }
 
-/** Extract plausible file paths (contain '/' + an interesting extension). */
-export function extractFileCandidates(content: string): string[] {
+/** Extract plausible file paths (contain '/' + an interesting extension).
+ * Defensive against a missing/empty payload: pi's adapter can hand the engine
+ * a message whose `text`/`input`/`output` is undefined (e.g. a pure tool-call
+ * or tool-result message), and `.split` on undefined throws and takes down the
+ * whole compaction. Guard once at the source so every caller is safe. */
+export function extractFileCandidates(content: string | undefined | null): string[] {
+  if (!content) return [];
   const out: string[] = [];
   for (const raw of content.split(/\s+/)) {
     // Trim surrounding punctuation only — do NOT strip internal dots, or we

package/src/supersede.ts

@@ -12,6 +12,9 @@ import { extractFileCandidates } from "./compact.js";
 
 /** Classify a message's relationship to a file path. */
 function fileOps(msg: EngineMessage): { path: string; op: "read" | "write" }[] {
+  // msg.text may be undefined for pure tool-call/result messages; the guard
+  // lives in extractFileCandidates, but the early return short-circuits the
+  // write-detection regex too so we never classify an empty message.
   const paths = extractFileCandidates(msg.text);
   if (paths.length === 0) return [];
   const low = msg.text.toLowerCase();