@krtclcdy/tersio 2.21.0 → 2.22.1

package/README.md

@@ -18,17 +18,16 @@
 curl -fsSL https://github.com/KurutoDenzeru/tersio/releases/latest/download/install.sh | sh
 ```
 
-Prefer OMP-managed updates and feature flags? Install as an OMP plugin instead:
+Prefer OMP-managed updates? Install as an OMP plugin instead:
 
 ```bash
 omp plugin install @krtclcdy/tersio
 ```
 
-Subset only:
+All modes load always. Only the updater stays toggleable:
 
 ```bash
-omp plugin install '@krtclcdy/tersio[caveman,ponytail]'
-omp plugin features @krtclcdy/tersio --disable rtk
+omp plugin features @krtclcdy/tersio --disable updater
 ```
 
 Then restart OMP and enable a preset:
@@ -80,21 +79,26 @@ 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
+## 📈 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:
+`tersio dashboard --open` serves a local dashboard (127.0.0.1 only) that charts your own savings from `~/.tersio/usage.db`. 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)
+![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)
+![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)
+![Dashboard: command tools with token savings, average rate, and timing](/assets/GainTools.webp)
+
+### Measurement references
+
+- **[EcoLogits](https://github.com/mlco2/ecologits)** informs Tersio's local CO₂ and energy estimates. Tersio ports the model to TypeScript; EcoLogits is not a runtime dependency.
+- **[Tokscale](https://github.com/junhoyeo/tokscale)** informs Tersio's Input, Output, Cache Read, and Cache Write accounting from local OMP sessions. Tokscale is a reference, not a runtime dependency.
 
 ## 🖥️ CLI
 
@@ -105,12 +109,12 @@ Break-even math, balanced preset (caveman full + rtk + ponytail): a mixed turn c
 | `tersio reinstall` | Fresh install, preserving the Ponytail package |
 | `tersio doctor` | Check OMP, extension, Ponytail, and RTK health (`--fix` repairs, `--fix=<scope>` one scope, `--dry-run` previews) |
 | `tersio usage` | Ledger-backed usage + savings report |
-| `tersio gain` | Open the gain dashboard (`--open`, `--export <file>`, `--port <n>`, `--currency <code>`; serves localhost only) |
+| `tersio dashboard` | Open the Dashboard (`--open`, `--export <file>`, `--port <n>`, `--currency <code>`; serves localhost only) |
 | `tersio reset` | Clear tersio statistics: usage ledger + a watermark that hides pre-reset rows from every derived view (Y/N confirm, `--dry-run`, `--yes`) — session transcripts and RTK history stay intact on disk |
 | `tersio uninstall` | Remove extensions, registration, and the Ponytail plugin (`--keep-ponytail` keeps Ponytail; `--remove-rtk` also removes the RTK binary and its `rtk.ts` OMP wiring) |
 | `tersio version` | Print version |
 
-Flags: `--dry-run`, `--yes`/`-y`, `--verbose`, `--combo-default`/`--caveman-default`/`--rtk-default`/`--ponytail-default`, `--currency <code>` (usage|gain display currency; flag wins, then the `tersio settings` default, then USD). Legacy `--doctor` / `--uninstall` forms still work.
+Flags: `--dry-run`, `--yes`/`-y`, `--verbose`, `--combo-default`/`--caveman-default`/`--rtk-default`/`--ponytail-default`, `--currency <code>` (usage/dashboard display currency; flag wins, then the `tersio settings` default, then USD). Legacy `--doctor` / `--uninstall` forms still work.
 
 ## ⌨️ Commands reference
 
@@ -125,8 +129,8 @@ Mode switches live on their own commands; bare `/tersio` prints status.
 | `/tersio status` | Active modes + combo level; state persists, propagates to subagents, and lights the Combo footer indicator. |
 | `/tersio check` | Add-on version check |
 | `/tersio update <ponytail\|rtk\|caveman\|all> [--dry-run]` | Update add-ons, preview with dry-run |
-| `/tersio gain` | Savings summary; the gain dashboard charts `~/.omp/plugins/tersio-usage.jsonl` (`tersio gain --open` serves on 127.0.0.1, `--export` writes one file). |
-| `/tersio usage` | Ledger report for this machine (rows in `~/.omp/plugins/tersio-usage.jsonl`, local only) |
+| `/tersio dashboard` | Open the Dashboard. |
+| `/tersio usage` | Ledger report for this machine (rows in `~/.tersio/usage.db`, local only) |
 | `/tersio help` | This table |
 | `/ai-addons` | Add-on updater alias, still works. |
 
@@ -136,7 +140,7 @@ Mode switches live on their own commands; bare `/tersio` prints status.
 |---|---|
 | Caveman / RTK / Updater / Combo extensions | `~/.omp/agent/extensions/{caveman-session,rtk-session,ai-addons-updater,combo-toggle}/` |
 | RTK OMP wiring (rtk-owned) | `~/.omp/agent/extensions/rtk.ts` — written by the installer via `rtk init -g --agent omp`; auto-loads, no config entry |
-| Ponytail package | `~/.omp/plugins/node_modules/@dietrichgebert/ponytail/` |
+| Ponytail package (bundled tersio dependency — one Plugins row, updates with `tersio update`) | `~/.omp/plugins/node_modules/@dietrichgebert/ponytail/` |
 | RTK binary | `~/.bun/bin/rtk` (`rtk.exe` on Windows) |
 | Extension registrations | `~/.omp/agent/config.yml` |
 
@@ -150,7 +154,7 @@ User-level installs also register the package in `~/.omp/plugins` (visible in OM
 
 **RTK missing or not executable:** run `tersio reinstall`, then `tersio doctor`. On Linux/macOS: `chmod +x ~/.bun/bin/rtk`.
 
-**RTK commands not metered in the gain dashboard:** check `tersio doctor` — the `RTK OMP wiring (rtk.ts)` row must be ok. Missing: run `rtk init -g --agent omp` (needs rtk ≥ 0.49) and restart OMP. Native tool calls (`read`/`edit`/`eval`) stay unmetered — only bash tool calls pass through rtk.
+**RTK commands not metered in the Dashboard:** check `tersio doctor` — the `RTK OMP wiring (rtk.ts)` row must be ok. Missing: run `rtk init -g --agent omp` (needs rtk ≥ 0.49) and restart OMP. Native tool calls (`read`/`edit`/`eval`) stay unmetered — only bash tool calls pass through rtk.
 
 **Checksum warning or failure:** the installer aborts on RTK checksum mismatch but warns and continues when checksum metadata is unavailable; `/tersio update rtk` aborts when metadata is missing.
 

package/cli/common.js

@@ -20,6 +20,7 @@ const { version: PACKAGE_VERSION } = createRequire(import.meta.url)('../package.
 const CAVEMAN_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'wenyan']);
 const PONYTAIL_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'review']);
 const RTK_DEFAULTS = new Set(['on', 'off']);
+const DIAG_SCHEDULES = new Set(['manual', 'daily', 'weekly', 'monthly']);
 // ponytail: Combo preset implies all three modes. Mirrors COMBO_LEVELS in
 // extensions/shared/session-state.ts (rtk as boolean here). Single source.
 const COMBO_PRESET_MODES = {
@@ -47,10 +48,20 @@ function flagValue(name) {
     return args.find((arg) => arg.startsWith(prefix))?.slice(prefix.length);
 }
 // --- CLI flags ---
-const COMMANDS = { install: true, update: true, reinstall: true, doctor: true, uninstall: true, usage: true, gain: true, reset: true, settings: true, version: true, help: true };
+const COMMANDS = { install: true, update: true, reinstall: true, doctor: true, uninstall: true, usage: true, dashboard: true, reset: true, settings: true, version: true, help: true };
 const args = process.argv.slice(2);
 const commandArg = args.find((arg) => !arg.startsWith('-'));
 const command = commandArg?.toLowerCase() || null;
+// Positional after the command: `tersio settings diagnosis` jumps straight
+// to one prompt instead of walking the whole chain. Index-based so flag
+// values (e.g. `--combo-default balanced`) never count as positionals.
+const settingArg = (() => {
+    const at = args.indexOf(commandArg ?? '');
+    const next = at >= 0 ? args[at + 1] : undefined;
+    if (!next || next.startsWith('-'))
+        return null;
+    return next.toLowerCase();
+})();
 const unknownCommand = command !== null && !COMMANDS[command];
 const install = command === 'install';
 const update = command === 'update';
@@ -64,13 +75,13 @@ const verbose = args.includes('--verbose');
 const doctor = command === 'doctor' || args.includes('--doctor');
 const fix = args.includes('--fix') || args.some((a) => a.startsWith('--fix='));
 const usage = command === 'usage' || args.includes('--usage');
-const gain = command === 'gain';
+const dashboard = command === 'dashboard';
 const reset = command === 'reset';
 const settings = command === 'settings';
 const dashboardPort = Number.parseInt(flagValue('--port') ?? '', 10) || 0;
 const dashboardOpen = args.includes('--open');
 const dashboardExport = flagValue('--export') ?? null;
-// Display currency for usage/gain: --currency flag wins, then the stored
+// Display currency for usage/dashboard: --currency flag wins, then the stored
 // plugin default (tersio settings), then USD.
 const currency = parseCurrencyFlag(flagValue('--currency')) ?? readStoredCurrency();
 const currencyGiven = flagValue('--currency') !== undefined;
@@ -90,6 +101,7 @@ const comboDefaultFlag = parseEnum(flagValue('--combo-default'), COMBO_DEFAULTS,
 const cavemanDefaultFlag = parseEnum(flagValue('--caveman-default'), CAVEMAN_DEFAULTS, '--caveman-default');
 const ponytailDefaultFlag = parseEnum(flagValue('--ponytail-default'), PONYTAIL_DEFAULTS, '--ponytail-default');
 const rtkDefaultFlag = parseEnum(flagValue('--rtk-default'), RTK_DEFAULTS, '--rtk-default');
+const diagScheduleFlag = parseEnum(flagValue('--diag-schedule'), DIAG_SCHEDULES, '--diag-schedule');
 const profileFlagsGiven = [comboDefaultFlag, cavemanDefaultFlag, rtkDefaultFlag, ponytailDefaultFlag]
     .some((flag) => flag !== undefined);
 function debug(...a) {
@@ -286,4 +298,4 @@ function relTime(ageMs) {
     const weeks = Math.floor(days / 7);
     return `${weeks} week${weeks === 1 ? '' : 's'} ago`;
 }
-export { IS_WINDOWS, RTK_BINARY_NAME, HOME, OMP_AGENT_DIR, OMP_PLUGINS_DIR, BUN_BIN_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_BIN, PACKAGE_VERSION, CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS, RTK_DEFAULTS, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, unknownCommand, install, update, reinstall, showVersion, showHelp, applyUpdate, args, dryRun, yes, verbose, doctor, fix, uninstall, usage, gain, reset, settings, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, profileFlagsGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, ensureExtensionAfterConfigEntry, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, relTime, };
+export { IS_WINDOWS, RTK_BINARY_NAME, HOME, OMP_AGENT_DIR, OMP_PLUGINS_DIR, BUN_BIN_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_BIN, PACKAGE_VERSION, CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS, RTK_DEFAULTS, DIAG_SCHEDULES, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, settingArg, unknownCommand, install, update, reinstall, showVersion, showHelp, applyUpdate, args, dryRun, yes, verbose, doctor, fix, uninstall, usage, dashboard, reset, settings, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, diagScheduleFlag, profileFlagsGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, ensureExtensionAfterConfigEntry, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, relTime, };

package/cli/currency.js

@@ -1,6 +1,6 @@
 // cli/currency.ts — display-currency helpers (USD-base, offline snapshot rates).
-// Same 10 currencies, symbols, and snapshot rates as the gain dashboard's
-// converter (dashboard/app.js); the dashboard replaces rates with live
+// Same 10 currencies, symbols, and snapshot rates as the dashboard's
+// converter (dashboard/app); the dashboard replaces rates with live
 // frankfurter figures when reachable, the CLI always uses the snapshot.
 import { existsSync, readFileSync } from 'node:fs';
 import os from 'node:os';

package/cli/dashboard.js

@@ -1,35 +1,269 @@
-// cli/dashboard.ts — gain dashboard. Serves the single plain-HTML
-// template (no deps, no build) plus a /data.json endpoint from the ledger.
+// cli/dashboard.ts — serves the built shadcn Dashboard with local usage APIs.
 // Binds 127.0.0.1 only; --export writes a file://-ready file instead.
 // Note: no Promise.withResolvers here — engines still allow Node 20.12,
 // which lacks it; the listening server itself keeps the process alive.
 import { spawn } from 'node:child_process';
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { promises as fs } from 'node:fs';
 import http from 'node:http';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { clearUsageLedger, markReset, readUsage } from '../extensions/shared/usage-ledger.js';
+import { pricesCachePath } from '../extensions/shared/pricing.js';
 import { summarizeUsage } from './usage.js';
 import { isCurrencyCode } from './currency.js';
+import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_VERSION, RTK_BINARY_NAME, } from './common.js';
 import { storedProfile, writePluginSettings } from './profile.js';
-import { withInteractiveSpinner } from './interactive.js';
-const DASH_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'dashboard');
-const TEMPLATE = path.join(DASH_DIR, 'template.html');
-const STYLES = path.join(DASH_DIR, 'styles.css');
-const APP = path.join(DASH_DIR, 'app.js');
-const BRAND = path.join(DASH_DIR, 'brand.webp');
+const DASHBOARD_DIST = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'dashboard', 'dist');
+const DASHBOARD_INDEX = path.join(DASHBOARD_DIST, 'index.html');
+const DASHBOARD_BRAND = path.join(DASHBOARD_DIST, 'brand.webp');
+function requireDashboardBundle() {
+    if (existsSync(DASHBOARD_INDEX))
+        return;
+    throw new Error('Dashboard bundle missing. Run `bun run build` before using `tersio dashboard`.');
+}
+function contentType(file) {
+    if (file.endsWith('.html'))
+        return 'text/html; charset=utf-8';
+    if (file.endsWith('.js'))
+        return 'text/javascript; charset=utf-8';
+    if (file.endsWith('.css'))
+        return 'text/css; charset=utf-8';
+    if (file.endsWith('.webp'))
+        return 'image/webp';
+    if (file.endsWith('.svg'))
+        return 'image/svg+xml';
+    if (file.endsWith('.png'))
+        return 'image/png';
+    if (file.endsWith('.woff2'))
+        return 'font/woff2';
+    return 'application/octet-stream';
+}
 async function readSegment(file) {
     return fs.readFile(file, 'utf8');
 }
-async function faviconDataUri() {
-    const png = await fs.readFile(BRAND);
-    return `data:image/webp;base64,${png.toString('base64')}`;
+async function brandDataUri() {
+    const brand = await fs.readFile(DASHBOARD_BRAND);
+    return `data:image/webp;base64,${brand.toString('base64')}`;
 }
 function dataJson() {
     return JSON.stringify(summarizeUsage(readUsage()));
 }
+// Local-only health + diagnosis for the settings modal. No network: version
+// probes run with short timeouts, file checks are existsSync.
+function ompPath() {
+    const names = process.platform === 'win32' ? ['omp.cmd', 'omp.exe', 'omp.bat', 'omp'] : ['omp'];
+    for (const dir of (process.env.PATH || '').split(path.delimiter).filter(Boolean)) {
+        for (const name of names) {
+            const candidate = path.join(dir, name);
+            try {
+                if (statSync(candidate).isFile())
+                    return candidate;
+            }
+            catch { /* continue searching PATH */ }
+        }
+    }
+    return null;
+}
+function ompVersion(bin = ompPath()) {
+    if (!bin)
+        return null;
+    try {
+        if (process.platform === 'win32') {
+            const exe = process.env.ComSpec || 'cmd.exe';
+            return execFileSync(exe, ['/d', '/s', '/c', bin, '--version'], { encoding: 'utf8', timeout: 5000, windowsHide: true }).trim() || null;
+        }
+        return execFileSync(bin, ['--version'], { encoding: 'utf8', timeout: 5000, windowsHide: true }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function rtkVersion(bin) {
+    try {
+        return execFileSync(bin, ['--version'], { encoding: 'utf8', timeout: 5000, windowsHide: true }).trim().split(/\r?\n/)[0] || null;
+    }
+    catch {
+        return null;
+    }
+}
+function ompDefaultModel() {
+    try {
+        const text = readFileSync(path.join(OMP_AGENT_DIR, 'config.yml'), 'utf8');
+        const m = text.match(/^\s*default\s*:\s*(.+?)\s*$/m);
+        return m ? m[1].replace(/^['"]|['"]$/g, '') : null;
+    }
+    catch {
+        return null;
+    }
+}
+function healthJson() {
+    const rtkBin = path.join(BUN_BIN_DIR, RTK_BINARY_NAME);
+    const rtkPresent = existsSync(rtkBin);
+    const detectedOmpPath = ompPath();
+    return JSON.stringify({
+        tersio: PACKAGE_VERSION,
+        node: process.version,
+        platform: `${process.platform}/${process.arch}`,
+        omp: ompVersion(detectedOmpPath),
+        ompPath: detectedOmpPath,
+        provider: ompDefaultModel(),
+        rtk: { present: rtkPresent, version: rtkPresent ? rtkVersion(rtkBin) : null, path: rtkBin },
+        home: tersioHomePath(),
+    });
+}
+function tersioHomePath() {
+    return path.join(process.env.HOME || process.env.USERPROFILE || '', '.tersio');
+}
+const DIAG_TTL_MS = {
+    manual: 0,
+    daily: 24 * 3600 * 1000,
+    weekly: 7 * 24 * 3600 * 1000,
+    monthly: 30 * 24 * 3600 * 1000,
+};
+function diagPaths() {
+    // Hermetic env (tests) overrides the DB path: keep the report next to it
+    // so test runs never touch the real ~/.tersio/diag.json.
+    const dbOverride = process.env.TERSIO_USAGE_DB;
+    if (dbOverride)
+        return { report: path.join(path.dirname(dbOverride), 'diag.json') };
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return { report: path.join(home, '.tersio', 'diag.json') };
+}
+function readDiagReport() {
+    try {
+        const raw = JSON.parse(readFileSync(diagPaths().report, 'utf8'));
+        if (!Array.isArray(raw.rows) || typeof raw.checkedAt !== 'number')
+            return null;
+        const schedule = raw.schedule === 'daily' || raw.schedule === 'weekly' || raw.schedule === 'monthly' ? raw.schedule : 'manual';
+        return { rows: raw.rows, checkedAt: raw.checkedAt, schedule };
+    }
+    catch {
+        return null;
+    }
+}
+function writeDiagReport(report) {
+    try {
+        mkdirSync(path.dirname(diagPaths().report), { recursive: true });
+        writeFileSync(diagPaths().report, JSON.stringify(report) + '\n', 'utf8');
+    }
+    catch { /* best-effort */ }
+}
+function ageStr(p) {
+    try {
+        return relAge(Date.now() - statSync(p).mtimeMs);
+    }
+    catch {
+        return null;
+    }
+}
+function absTime(p) {
+    try {
+        const d = new Date(statSync(p).mtimeMs);
+        const q = (n) => String(n).padStart(2, '0');
+        const h24 = d.getHours();
+        return `${q(d.getMonth() + 1)}-${q(d.getDate())}-${d.getFullYear()}, ${q(h24 % 12 || 12)}:${q(d.getMinutes())} ${h24 >= 12 ? 'PM' : 'AM'}`;
+    }
+    catch {
+        return null;
+    }
+}
+function relAge(ms) {
+    const mins = Math.floor(ms / 60000);
+    if (mins < 1)
+        return 'just now';
+    if (mins < 60)
+        return `${mins} min${mins === 1 ? '' : 's'} ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours} hour${hours === 1 ? '' : 's'} ago`;
+    const days = Math.floor(hours / 24);
+    return `${days} day${days === 1 ? '' : 's'} ago`;
+}
+function computeDoctorRows() {
+    const rows = [];
+    const extDir = path.join(OMP_AGENT_DIR, 'extensions');
+    const rtkBin = path.join(BUN_BIN_DIR, RTK_BINARY_NAME);
+    const ponytailPkg = path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'package.json');
+    const ok = (p) => existsSync(p);
+    const ext = (label, p) => {
+        rows.push({ label, ok: ok(p), detail: ok(p) ? 'installed' : p, group: 'Extensions' });
+    };
+    const addon = (label, present, detail, group = 'Add-ons') => {
+        rows.push({ label, ok: present, detail, group });
+    };
+    ext('Caveman extension', path.join(extDir, 'caveman-session', 'index.ts'));
+    ext('RTK extension', path.join(extDir, 'rtk-session', 'index.ts'));
+    ext('Ponytail extension', path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js'));
+    const rule = path.join(extDir, 'caveman-session', 'rule.md');
+    const ruleAge = ageStr(rule);
+    const ruleAt = absTime(rule);
+    addon('Caveman rule', ruleAge !== null, ruleAge && ruleAt ? `(updated ${ruleAge} · ${ruleAt})` : rule);
+    const rtkVer = ok(rtkBin) ? rtkVersion(rtkBin) : null;
+    const rtkAge = ageStr(rtkBin);
+    const rtkAt = absTime(rtkBin);
+    addon('RTK binary', rtkVer !== null, rtkVer && rtkAge && rtkAt ? `${rtkVer} (updated ${rtkAge} · ${rtkAt})` : rtkBin);
+    const wiring = path.join(extDir, 'rtk.ts');
+    addon('RTK OMP wiring (rtk.ts)', ok(wiring), ok(wiring) ? 'loaded' : wiring);
+    let ponytailVer = null;
+    try {
+        ponytailVer = JSON.parse(readFileSync(ponytailPkg, 'utf8')).version ?? null;
+    }
+    catch {
+        ponytailVer = null;
+    }
+    const ponytailAge = ageStr(ponytailPkg);
+    const ponytailAt = absTime(ponytailPkg);
+    addon('Ponytail', ponytailVer !== null, ponytailVer && ponytailAge && ponytailAt ? `${ponytailVer} (updated ${ponytailAge} · ${ponytailAt})` : ponytailPkg);
+    const prices = pricesCachePath();
+    const pricesAge = ageStr(prices);
+    const pricesAt = absTime(prices);
+    addon('Prices feed', pricesAge !== null, pricesAge && pricesAt ? `(pulled ${pricesAge} · ${pricesAt})` : prices, 'Usage');
+    return rows;
+}
+// Retained diagnosis: recompute when forced, missing, or older than the
+// schedule. Otherwise return the saved report so users never re-run.
+// Labels retired from the report. A saved report containing any of them
+// is stale by definition and always recomputes.
+const RETIRED_DIAG_LABELS = new Set([
+    'OMP CLI',
+    'Tersio CLI',
+    'Tersio commands',
+    'Mode reinforcement',
+    'Combo registered',
+    'Combo extension',
+    'Self plugin',
+    'Ponytail registered',
+    'Usage store',
+]);
+function isRetiredReport(report) {
+    return report.rows.some((r) => RETIRED_DIAG_LABELS.has(r.label));
+}
+// Retained diagnosis: recompute when forced, missing, retired, or older
+// than the schedule. Otherwise return the saved report.
+function getDoctorReport(force) {
+    const saved = readDiagReport();
+    const ttl = saved ? DIAG_TTL_MS[saved.schedule] : 0;
+    // Manual always recomputes on open; dated schedules reuse the saved
+    // report until stale. Otherwise a retained snapshot hides new rows.
+    if (!force && saved && !isRetiredReport(saved) && ttl > 0 && Date.now() - saved.checkedAt < ttl)
+        return saved;
+    const report = { rows: computeDoctorRows(), checkedAt: Date.now(), schedule: saved?.schedule ?? 'manual' };
+    writeDiagReport(report);
+    return report;
+}
+function setDiagSchedule(schedule) {
+    const base = readDiagReport() ?? { rows: computeDoctorRows(), checkedAt: Date.now(), schedule };
+    base.schedule = schedule;
+    writeDiagReport(base);
+    return base;
+}
+function readDiagSchedule() {
+    return readDiagReport()?.schedule ?? 'manual';
+}
 // Persist the dashboard's picker choice so close → reopen keeps it: each
-// `tersio gain` run serves a fresh ephemeral port (a new origin), so the
+// `tersio dashboard` run serves a fresh ephemeral port (a new origin), so the
 // browser's localStorage alone cannot survive a restart. The stored default
 // feeds data.json and `tersio usage` on the next run.
 async function saveDashboardCurrency(raw) {
@@ -55,33 +289,33 @@ function openBrowser(url) {
     const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
     spawn(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
 }
+// Replacer functions throughout: session data routinely contains `$'`
+// sequences (shell quoting in tool details), which String.replace would
+// expand as match-suffix patterns and corrupt the file.
+// RTK-metered command lines routinely contain literal `</script>` (Vue
+// SFC probes), which would close the inlined <script> early and dump the
+// rest of the JSON as page text. Escape it; JSON.parse never sees the
+// backslash form inside a string literal, the browser decodes it first.
+function escapeInline(json) {
+    return json.replace(/<\/(script)/gi, '<\\/$1');
+}
+async function exportDashboard(exportFile) {
+    requireDashboardBundle();
+    const [bundle, icon] = await Promise.all([readSegment(DASHBOARD_INDEX), brandDataUri()]);
+    const inline = bundle
+        .replace('window.__TERSIO_SNAP = null;', () => `window.__TERSIO_SNAP = ${escapeInline(JSON.stringify({ data: JSON.parse(dataJson()), health: JSON.parse(healthJson()), doctor: getDoctorReport(false) }))};`)
+        .replace(/href="brand\.webp"/g, () => `href="${icon}"`)
+        .replace(/src="brand\.webp"/g, () => `src="${icon}"`)
+        .replace('fetch("brand.webp")', () => `Promise.resolve({ ok: true, blob: async () => new Blob([atob("${icon.split(',')[1]}")], { type: "image/webp" }) })`);
+    await fs.writeFile(exportFile, inline, 'utf8');
+    console.log(`[ok] Dashboard exported → ${exportFile}`);
+}
 async function runDashboard(options) {
     if (options.exportFile) {
-        const [template, css, js, icon] = await Promise.all([
-            readSegment(TEMPLATE), readSegment(STYLES), readSegment(APP), faviconDataUri(),
-        ]);
-        // Replacer functions throughout: session data routinely contains `$'`
-        // sequences (shell quoting in tool details), which String.replace would
-        // expand as match-suffix patterns and corrupt the file.
-        // RTK-metered command lines routinely contain literal `</script>` (Vue
-        // SFC probes), which would close the inlined <script> early and dump the
-        // rest of the JSON as page text. Escape it; JSON.parse never sees the
-        // backslash form inside a string literal, the browser decodes it first.
-        const inline = template
-            .replace('<link rel="stylesheet" href="styles.css">', () => `<style>\n${css}</style>`)
-            .replace('<script src="app.js" defer></script>', () => `<script>\n${js}</script>`)
-            .replace("fetch('data.json')", () => `Promise.resolve({ json: function () { return ${dataJson().replace(/<\/(script)/gi, '<\\/$1')}; } })`)
-            // Exported file runs on file:// where load() early-returns before the
-            // stub above ever runs, so nothing ever renders. Drop that guard in
-            // the export only; template.html keeps it to avoid 404 polling loops.
-            .replace("if (window.location.protocol === 'file:') return;", () => `if (false) return;`)
-            .replace('href="brand.webp"', () => `href="${icon}"`)
-            .replace('src="brand.webp"', () => `src="${icon}"`);
-        await fs.writeFile(options.exportFile, inline, 'utf8');
-        console.log(`[ok] gain exported → ${options.exportFile}`);
+        await exportDashboard(options.exportFile);
         return;
     }
-    const html = await withInteractiveSpinner('Loading dashboard template', () => readSegment(TEMPLATE));
+    requireDashboardBundle();
     const server = http.createServer(async (req, res) => {
         if (req.url === '/reset' && req.method === 'POST') {
             const rows = clearUsageLedger();
@@ -114,42 +348,69 @@ async function runDashboard(options) {
             res.end(dataJson());
             return;
         }
-        if (req.url === '/styles.css') {
-            res.writeHead(200, { 'Content-Type': 'text/css; charset=utf-8' });
-            res.end(await readSegment(STYLES));
+        if (req.url === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(healthJson());
             return;
         }
-        if (req.url === '/app.js') {
-            res.writeHead(200, { 'Content-Type': 'text/javascript; charset=utf-8' });
-            res.end(await readSegment(APP));
+        if (req.url === '/doctor' && req.method === 'POST') {
+            let schedule = 'manual';
+            try {
+                const raw = JSON.parse(await readBody(req)).schedule;
+                if (raw === 'daily' || raw === 'weekly' || raw === 'monthly' || raw === 'manual')
+                    schedule = raw;
+            }
+            catch { /* keep manual */ }
+            const report = schedule === 'manual' ? getDoctorReport(true) : setDiagSchedule(schedule);
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(report));
             return;
         }
-        if (req.url === '/brand.webp') {
+        if (req.url === '/doctor/fix' && req.method === 'POST') {
             try {
-                const png = await fs.readFile(BRAND);
-                res.writeHead(200, { 'Content-Type': 'image/webp' });
-                res.end(png);
+                const { runDoctorRepairs } = await import('./doctor-fix.js');
+                const failed = await runDoctorRepairs(['extensions', 'registrations', 'ponytail']);
+                getDoctorReport(true);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: failed.length === 0, failed }));
             }
-            catch {
-                res.writeHead(404);
-                res.end();
+            catch (e) {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, failed: ['fix'], error: e.message }));
             }
             return;
         }
+        if (req.url === '/doctor' || req.url?.startsWith('/doctor?')) {
+            const fresh = (req.url.split('?')[1] ?? '').includes('fresh=1');
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(getDoctorReport(fresh)));
+            return;
+        }
+        const name = (req.url ?? '/').split('?')[0];
+        const file = path.normalize(path.join(DASHBOARD_DIST, name === '/' ? 'index.html' : name.slice(1)));
+        if (file === DASHBOARD_DIST || file.startsWith(DASHBOARD_DIST + path.sep)) {
+            try {
+                const body = await fs.readFile(file);
+                res.writeHead(200, { 'Content-Type': contentType(file) });
+                res.end(body);
+                return;
+            }
+            catch { /* fall through to index */ }
+        }
         res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-        res.end(html);
+        res.end(await readSegment(DASHBOARD_INDEX));
     });
     server.listen(options.port, '127.0.0.1', () => {
         try {
-            process.title = 'tersio gain';
+            process.title = 'tersio dashboard';
         }
         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}`;
-        console.log(`[ok] gain live → ${url} (Ctrl-C to stop)`);
+        console.log(`[ok] Dashboard live → ${url} (Ctrl-C to stop)`);
         if (options.open)
             openBrowser(url);
     });
 }
-export { runDashboard, saveDashboardCurrency };
+export { runDashboard, saveDashboardCurrency, readDiagSchedule, setDiagSchedule };

package/cli/doctor-fix.js

@@ -2,7 +2,7 @@ import { promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, dryRun, verbose, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, execP, readPluginsPackage, writeIfChanged, } from './common.js';
+import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, dryRun, verbose, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, execP, readPluginsPackage, writeIfChanged, } from './common.js';
 import { execNetwork } from './interactive.js';
 import { wireRtkOmp, ensureRtkInConfig } from './rtk-wiring.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, parseChecksum, readTextIfExists, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
@@ -23,8 +23,6 @@ const SOURCES = [
     [path.join(EXT_DIR, 'tersio-commands', 'index.ts'), path.join('tersio-commands', 'index.ts')],
     [path.join(EXT_DIR, 'shared', 'mode-reinforcement.ts'), path.join('shared', 'mode-reinforcement.ts')],
 ];
-const PONYTAIL_GITHUB_SPEC = 'github:DietrichGebert/ponytail';
-const PONYTAIL_NPM_SPEC = '@dietrichgebert/ponytail@latest';
 async function fixExtensions(extDir) {
     console.log('  Doctor --fix: restoring extension files');
     await fs.mkdir(extDir, { recursive: true });
@@ -130,22 +128,24 @@ async function fixRtk(binDir) {
         throw new Error('rtk wiring failed');
 }
 async function fixPonytail(pluginsDir, agentDir) {
-    console.log('  Doctor --fix: refreshing Ponytail package');
+    console.log('  Doctor --fix: restoring bundled Ponytail');
     await fs.mkdir(pluginsDir, { recursive: true });
     const pkgPath = path.join(pluginsDir, 'package.json');
     const pkg = await readPluginsPackage(pkgPath);
-    pkg.dependencies['@dietrichgebert/ponytail'] = PONYTAIL_GITHUB_SPEC;
+    // Drop the legacy separate entry: ponytail is a tersio dependency now.
+    if ('@dietrichgebert/ponytail' in pkg.dependencies) {
+        delete pkg.dependencies['@dietrichgebert/ponytail'];
+        console.log('  [migrate] dropped separate @dietrichgebert/ponytail dependency (now bundled with tersio)');
+    }
+    if (!(PACKAGE_NAME in pkg.dependencies))
+        pkg.dependencies[PACKAGE_NAME] = `^${PACKAGE_VERSION}`;
     if (dryRun) {
-        console.log(`  [dry-run] would run: omp plugin install ${PONYTAIL_GITHUB_SPEC}`);
-        console.log(`  [dry-run] would run: npm install ${PONYTAIL_NPM_SPEC} --save --no-audit --no-fund`);
+        console.log('  [dry-run] would run: npm install --no-audit --no-fund (in plugins dir)');
         return;
     }
     await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
-    await execNetwork('Installing Ponytail plugin', OMP_BIN, ['plugin', 'install', PONYTAIL_GITHUB_SPEC], { cwd: pluginsDir }).catch((e) => {
-        console.log(`  [warn] omp plugin install failed: ${e.message}`);
-    });
-    await execNetwork('Refreshing Ponytail package', 'npm', ['install', PONYTAIL_NPM_SPEC, '--save', '--no-audit', '--no-fund'], { cwd: pluginsDir, timeout: 120000 }).catch((e) => {
-        throw new Error(`ponytail refresh failed: ${e.message}`);
+    await execNetwork('Restoring bundled Ponytail', 'npm', ['install', '--no-audit', '--no-fund'], { cwd: pluginsDir, timeout: 180000 }).catch((e) => {
+        throw new Error(`bundled ponytail restore failed: ${e.message}`);
     });
     await ensureExtensionInConfig(path.join(agentDir, 'config.yml'), path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js'), 'ponytail', { dryRun, verbose });
 }