@krtclcdy/tersio 2.16.0 → 2.18.0

package/README.md

@@ -1,4 +1,4 @@
-![Banner](/TersioBanner.webp)
+![Banner](/assets/Banner.webp)
 
 # ✂️ Tersio — Token-saving OMP Add-ons
 
@@ -8,7 +8,7 @@
 [![Build](https://shieldcn.dev/github/ci/KurutoDenzeru/tersio.svg?variant=branded&size=xs&logo=githubactions&label=Build)](https://github.com/KurutoDenzeru/tersio/actions)
 [![MIT](https://shieldcn.dev/badge/license-MIT-2563eb.svg?variant=branded&size=xs&logo=opensourceinitiative)](./LICENSE)
 
-Terse replies, compact shell output, and minimal code decisions for [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi) — one-command combo presets.
+ Terse replies, compact shell output, and minimal code decisions for [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi) — one-command combo presets.
 
 ## ⚡ Getting Started
 
@@ -80,6 +80,22 @@ Measured savings against the same workload without the modes. Token counts are r
 
 Break-even math, balanced preset (caveman full + rtk + ponytail): a mixed turn costs 941 tok baseline vs 399 with Tersio (0.42×, **−57.6% per turn**). Overhead repays in turn 1 with the bundled floor (464 tok); turn 4 with the real installed Ponytail plugin (v4.9.0, 1,264 tok). RTK concentrates savings where noise lives — hook-wired sessions record **−97.5% on summarized test suites** (rtk `history.db`, 4 runs).
 
+## 📈 Gain Dashboard
+
+`tersio gain --open` serves a local dashboard (127.0.0.1 only) that charts your own savings from `~/.omp/plugins/tersio-usage.jsonl`. Three views:
+
+**Live feed and savings.** Token throughput, cost, savings bento, and recent activity — the top of the dashboard.
+
+![Gain dashboard: live token feed, cost, savings, and activity](/assets/GainHero.webp)
+
+**Top models and recent requests.** Per-model cost breakdown plus the last requests with elapsed time and token speed.
+
+![Gain dashboard: top models with per-model cost, recent requests with elapsed time and token speed](/assets/GainModels.webp)
+
+**Command tools.** Token savings, average rate, and timing per shell tool.
+
+![Gain dashboard: command tools with token savings, average rate, and timing](/assets/GainTools.webp)
+
 ## 🖥️ CLI
 
 | Command | Purpose |

package/cli/dashboard.js

@@ -88,6 +88,10 @@ async function runDashboard(options) {
         res.end(html);
     });
     server.listen(options.port, '127.0.0.1', () => {
+        try {
+            process.title = 'tersio gain';
+        }
+        catch { /* non-POSIX shells keep node */ }
         const address = server.address();
         const port = typeof address === 'object' && address ? address.port : options.port;
         const url = `http://127.0.0.1:${port}`;

package/cli/usage.js

@@ -1,8 +1,15 @@
 // cli/usage.ts — ledger + session-token usage report, tokscale-style.
+import path from 'node:path';
 import { co2GramsFor, energyWhFor, importSessionTokens, ledgerPath, priceFor, readResetWatermark, readUsage, refreshPricesIfStale, sessionsDir, usdCost, } from '../extensions/shared/usage-ledger.js';
 import { readRtkGain } from '../extensions/shared/rtk-gain.js';
 import { withInteractiveSpinner } from './interactive.js';
 import { PACKAGE_VERSION } from './common.js';
+// RTK's history is machine-wide, so every project's commands have to reach
+// the table or a busy repo silently stands in for all of them. The old cap of
+// 10 rows ranked by tokens saved hid whole projects whose commands save little
+// to nothing; 2000 groups covers a long history (~1.7k today) while still
+// bounding /data.json.
+const RTK_COMMAND_ROWS = 2000;
 export function summarizeUsage(rows) {
     refreshPricesIfStale();
     const byKind = {};
@@ -18,12 +25,14 @@ export function summarizeUsage(rows) {
     let priced = true;
     let savedUsd = 0;
     const byModelUsd = {};
+    const byModelBucketUsd = {};
     let co2g = 0;
     let energyWh = 0;
     for (const [model, t] of Object.entries(session.byModel)) {
         const c = usdCost(t, model);
         usd += c.usd;
         byModelUsd[model] = c.usd;
+        byModelBucketUsd[model] = c.buckets;
         co2g += co2GramsFor(model, t.output);
         energyWh += energyWhFor(model, t.output);
         if (!c.priced)
@@ -41,12 +50,16 @@ export function summarizeUsage(rows) {
         tokens: session.totals,
         byModel: session.byModel,
         byModelUsd,
+        byModelBucketUsd,
         byModelMessages: session.byModelMessages,
         byDay: session.byDay,
         byDayModel: session.byDayModel,
         byTool,
-        recent: session.recent,
-        rtkGain: readRtkGain(10, watermark || undefined),
+        recent: session.recent.map((r) => ({
+            ...r,
+            est: usdCost({ input: r.i, output: r.o, cacheRead: r.cr ?? 0, cacheWrite: r.cw ?? 0 }, r.m).usd,
+        })),
+        rtkGain: readRtkGain(RTK_COMMAND_ROWS, watermark || undefined),
         usd,
         priced,
         savedUsd,
@@ -119,28 +132,30 @@ function printReport(report) {
             console.log(l);
         }
     }
-    const cmdRows = report.byTool.map(([tool, n]) => ({ name: tool, count: n, saved: null, avgPct: null, avgMs: null }));
+    const cmdRows = report.byTool.map(([tool, n]) => ({ name: tool, project: '', count: n, saved: null, avgPct: null, avgMs: null }));
     for (const r of report.rtkGain.byCommand) {
-        cmdRows.push({ name: r.command, count: r.count, saved: r.saved, avgPct: r.avgPct, avgMs: r.avgMs });
+        cmdRows.push({ name: r.command, project: r.project, count: r.count, saved: r.saved, avgPct: r.avgPct, avgMs: r.avgMs });
     }
     cmdRows.sort((a, b) => b.count - a.count);
     if (cmdRows.length) {
         const g = report.rtkGain;
+        const projects = new Set(g.byCommand.map((r) => r.project).filter(Boolean));
         const scope = g.commands
-            ? `  COMMAND TOOLS  ${fmt(report.byTool.length)} tools · ${fmt(g.commands)} commands · ${fmtShort(g.saved)} saved`
+            ? `  COMMAND TOOLS  ${fmt(report.byTool.length)} tools · ${fmt(g.commands)} commands · ${fmtShort(g.saved)} saved · ${fmt(projects.size)} projects`
             : '  COMMAND TOOLS';
         console.log(scope);
         const top = cmdRows.reduce((m, r) => Math.max(m, r.count), 1);
         const crows = cmdRows.slice(0, 15).map((r, idx) => [
             String(idx + 1),
             r.name,
+            r.project ? path.basename(r.project) : '–',
             fmt(r.count),
             r.saved === null ? '–' : fmtShort(r.saved),
             r.avgPct === null ? '–' : `${r.avgPct.toFixed(1)}%`,
             r.avgMs === null ? '–' : fmtMs(r.avgMs),
             bar(r.count / top, 8),
         ]);
-        for (const l of table(['#', 'Tool/Command', 'Count', 'Saved', 'Avg%', 'Time', 'Impact'], crows, [true, false, true, true, true, true, false], 30)) {
+        for (const l of table(['#', 'Tool/Command', 'Project', 'Count', 'Saved', 'Avg%', 'Time', 'Impact'], crows, [true, false, false, true, true, true, true, false], 30)) {
             console.log(l);
         }
     }