@krtclcdy/tersio 2.22.0 → 2.23.0

package/README.md

@@ -38,6 +38,8 @@ Then restart OMP and enable a preset:
 
 Individual toggles: `/caveman full` · `/rtk on` · `/ponytail full`. Everything starts off until you enable it.
 
+When Tersio is installed through OMP, the first interactive launch asks for a session-start Combo preset once (`off`, `medium`, `balanced`, or `max`) and saves it as `comboDefault`. Running `tersio install` performs the same setup through the CLI.
+
 Session-start defaults (prompted during `install`, or flags):
 
 ```bash
@@ -61,39 +63,45 @@ Windows/WSL have separate OMP homes — install from the environment where OMP r
 
 ## 📊 Benchmarks
 
-Measured savings against the same workload without the modes. Token counts are real `o200k_base` BPE tokens (js-tiktoken), not chars÷4 estimates. Sample protocol, per-sample data, and caveats in [BENCHMARK.md](./BENCHMARK.md).
+Measured surfaces use different boundaries. Do not treat reply-text, code-diff, and shell-output reductions as total bill savings. Full protocol and caveats are in [BENCHMARK.md](./BENCHMARK.md).
 
 | Measured surface (n) | Baseline → Tersio | Δ |
 |---|---|---|
-| Terse reply, caveman lite — BPE tok (3 samples, p50) | 173 → 69 tok | **−60.1%** |
-| Terse reply, caveman full — BPE tok (3 samples, p50) | 173 → 49 tok | **−71.7%** |
-| Terse reply, caveman ultra — BPE tok (3 samples, p50) | 173 → 25 tok | **−85.5%** |
-| Code diff, ponytail lite — BPE tok (2 tasks) | 326–462 → 57–121 tok | **−73.8…−82.5%** |
-| Code diff, ponytail full — BPE tok (2 tasks) | 326–462 → 55–88 tok | **−81.0…−83.1%** |
-| Code diff, ponytail ultra — BPE tok (2 tasks) | 326–462 → 40–88 tok | **−81.0…−87.7%** |
-| Shell output, rtk — `git status` — BPE tok | 182 → 72 tok | **−60.4%** |
-| Shell output, rtk — repo `grep` — BPE tok | 376 → 274 tok | **−27.1%** |
-| Shell output, rtk — `find` — BPE tok | 205 → 168 tok | **−18.0%** |
-| Shell output, rtk — `git diff` — BPE tok | 12,684 → 8,504 tok | **−33.0%** |
-| Shell output, rtk — `npm test` (passthrough) — BPE tok | 2,597 → 2,577 tok | **−0.8%** |
+| Terse reply, caveman lite — BPE tokens (3 samples, p50) | 173 → 69 | **−60.1% reply text** |
+| Terse reply, caveman full — BPE tokens (3 samples, p50) | 173 → 49 | **−71.7% reply text** |
+| Terse reply, caveman ultra — BPE tokens (3 samples, p50) | 173 → 25 | **−85.5% reply text** |
+| Code diff, ponytail lite — BPE tokens (2 tasks) | 326–462 → 57–121 | **−73.8…−82.5% diff** |
+| Code diff, ponytail full — BPE tokens (2 tasks) | 326–462 → 55–88 | **−81.0…−83.1% diff** |
+| Code diff, ponytail ultra — BPE tokens (2 tasks) | 326–462 → 40–88 | **−81.0…−87.7% diff** |
+| Shell output, rtk `git status` | 182 → 72 | **−60.4% command output** |
+| Shell output, rtk repo `grep` | 376 → 274 | **−27.1% command output** |
+| Shell output, rtk `find` | 205 → 168 | **−18.0% command output** |
+| Shell output, rtk `git diff` | 12,684 → 8,504 | **−33.0% command output** |
+
+The Command tools table reports weighted RTK command-output savings and OMP-specific adoption from executed Bash records. It does not estimate provider billing.
+Upstream Ponytail's fair agentic benchmark reports 54% less code, 22% fewer tokens, 20% lower cost, and 100% retained safety. RTK estimates command-output tokens, not bill savings. Caveman and Ponytail compliance varies by model. Measure your own sessions with `tersio usage` and the dashboard.
 
-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 `~/.tersio/usage.db`. 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
 
@@ -104,12 +112,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
 
@@ -118,13 +126,13 @@ Mode switches live on their own commands; bare `/tersio` prints status.
 | Command | Purpose |
 |---|---|
 | `/combo off\|medium\|balanced\|max\|status` | One preset for all three (start here): medium = lite/lite/on, balanced = full/full/on, max = ultra/ultra/on; per-mode tweaks drop to `custom`. |
-| `/caveman lite\|full\|ultra\|wenyan\|off\|status` | Terse replies (substance stays); `ultra` uses fragments only, `wenyan` a compressed classical-Chinese-inspired register. |
-| `/rtk on\|off\|status` | Compact shell output via the real `rtk` binary; exact bytes (checksums, patches) bypass it by policy. |
-| `/ponytail off\|lite\|full\|ultra\|review\|status` | Minimal code (YAGNI): `lite` nudges, `full` enforces, `ultra` challenges the requirement, `review` audits for over-engineering (upstream command). |
+| `/caveman lite\|full\|ultra\|wenyan-lite\|wenyan-full\|wenyan-ultra\|off\|status` | Terse replies with upstream-aligned Caveman levels. Legacy `wenyan` restores as `wenyan-full`. |
+| `/rtk on\|off\|status` | Controls RTK session guidance, `rtk_run`, and the automatic hook through shared `RTK_DISABLED` state. Exact bytes bypass RTK. |
+| `/ponytail off\|lite\|full\|ultra\|status` | Minimal code using upstream Ponytail modes. Review runs separately through `/ponytail-review`. |
 | `/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 `~/.tersio/usage.db` (`tersio gain --open` serves on 127.0.0.1, `--export` writes one file). |
+| `/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. |
@@ -133,11 +141,11 @@ Mode switches live on their own commands; bare `/tersio` prints status.
 
 | What | Path |
 |---|---|
-| Caveman / RTK / Updater / Combo extensions | `~/.omp/agent/extensions/{caveman-session,rtk-session,ai-addons-updater,combo-toggle}/` |
+| Caveman / RTK / Combo / Tersio commands | `~/.omp/plugins/node_modules/@krtclcdy/tersio/extensions/{caveman-session,rtk-session,combo-toggle,tersio-commands}/` — loaded from Tersio's OMP plugin manifest |
 | 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 (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` |
+| Ponytail package (bundled Tersio dependency — one Plugins row, updates with `tersio update`) | `~/.omp/plugins/node_modules/@dietrichgebert/ponytail/` — loaded as a nested plugin dependency |
+| RTK binary | Installer writes `~/.bun/bin/rtk` (`rtk.exe` on Windows). Runtime resolves `PATH` first, then this managed path. |
+| Legacy config cleanup | `~/.omp/agent/config.yml` — doctor removes retired or duplicate extension entries |
 
 The installer writes `<file>.bak` before replacing an extension source; the updater keeps `rtk.bak` / `rule.md.bak` and restores them if the replacement fails validation.
 
@@ -145,11 +153,11 @@ User-level installs also register the package in `~/.omp/plugins` (visible in OM
 
 ## 🛠️ Troubleshooting
 
-**Ponytail or Combo command missing:** run `tersio reinstall` in OMP's environment, restart OMP, then `tersio doctor` (repairs `config.yml` registrations).
+**Ponytail or Combo command missing:** confirm `~/.omp/plugins/package.json` lists `@krtclcdy/tersio`, then run `tersio reinstall`, restart OMP, and check `tersio doctor`.
 
 **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

@@ -16,9 +16,8 @@ const OMP_BIN = IS_WINDOWS ? 'omp.cmd' : 'omp';
 const PACKAGE_NAME = '@krtclcdy/tersio';
 const PACKAGE_BIN = 'tersio';
 const { version: PACKAGE_VERSION } = createRequire(import.meta.url)('../package.json');
-// Session-start mode defaults for fresh installs.
-const CAVEMAN_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'wenyan']);
-const PONYTAIL_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'review']);
+const CAVEMAN_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'wenyan-lite', 'wenyan-full', 'wenyan-ultra']);
+const PONYTAIL_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra']);
 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
@@ -48,7 +47,7 @@ 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;
@@ -75,13 +74,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;
@@ -167,7 +166,26 @@ async function ensureExtensionInConfig(configPath, extensionPath, label, options
         const legacyTail = `${normalizedPath.slice(0, -3)}.js`.split('/').slice(-2).join('/');
         lines = lines.filter((l) => !l.trim().replace(/^\.\//, '').endsWith(legacyTail));
     }
-    if (lines.some((l) => l.includes(normalizedPath))) {
+    const matchingEntries = lines.filter((entry) => entry.trim().replace(/^-\s*/, '').replace(/^['"]|['"]$/g, '') === normalizedPath);
+    if (matchingEntries.length > 1) {
+        if (options.dryRun) {
+            if (verbose && !options.quiet)
+                console.log(`  [dry-run] would remove ${matchingEntries.length - 1} duplicate ${label} registration${matchingEntries.length === 2 ? '' : 's'}`);
+            return true;
+        }
+        let kept = false;
+        lines = lines.filter((entry) => {
+            if (entry.trim().replace(/^-\s*/, '').replace(/^['"]|['"]$/g, '') !== normalizedPath)
+                return true;
+            if (kept)
+                return false;
+            kept = true;
+            return true;
+        });
+        await writeConfigLines(configPath, lines, `  [write] Removed duplicate ${label} registration`, options);
+        return true;
+    }
+    if (matchingEntries.length === 1) {
         debug(`${label} already in config.yml`);
         return false;
     }
@@ -191,43 +209,29 @@ async function ensureExtensionInConfig(configPath, extensionPath, label, options
     await writeConfigLines(configPath, lines, `  [write] Added ${label} to config.yml`, options);
     return true;
 }
-async function ensureExtensionAfterConfigEntry(configPath, extensionPath, afterPath, label, options = {}) {
-    const normalizedPath = extensionPath.replace(/\\/g, '/');
-    const normalizedAfterPath = afterPath.replace(/\\/g, '/');
-    const line = `  - ${normalizedPath}`;
+async function removeExtensionFromConfig(configPath, extensionPath, label, options = {}) {
+    const normalizedPath = extensionPath.replace(/\\/g, '/').replace(/^\.\//, '');
+    const extensionSuffix = normalizedPath.includes('/extensions/')
+        ? normalizedPath.slice(normalizedPath.indexOf('/extensions/') + 1)
+        : normalizedPath;
     const raw = await readTextIfExists(configPath);
-    let lines = (raw || '').split('\n');
-    // Same legacy-twin drop as ensureExtensionInConfig above.
-    if (normalizedPath.endsWith('.ts')) {
-        const legacyTail = `${normalizedPath.slice(0, -3)}.js`.split('/').slice(-2).join('/');
-        lines = lines.filter((l) => !l.trim().replace(/^\.\//, '').endsWith(legacyTail));
-    }
-    const existingIndex = lines.findIndex((entry) => entry.includes(normalizedPath));
-    const afterIndex = lines.findIndex((entry) => entry.includes(normalizedAfterPath));
-    if (existingIndex !== -1 && afterIndex !== -1 && existingIndex === afterIndex + 1)
+    if (raw === null)
+        return false;
+    const lines = raw.split('\n');
+    const matches = (entry) => {
+        const value = entry.trim().replace(/^-\s*/, '').replace(/^['"]|['"]$/g, '').replace(/\\/g, '/').replace(/^\.\//, '');
+        return value === extensionSuffix || value.endsWith(`/${extensionSuffix}`);
+    };
+    const kept = lines.filter((entry) => !matches(entry));
+    const removed = lines.length - kept.length;
+    if (removed === 0)
         return false;
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would place ${label} after Ponytail in config.yml`);
+            console.log(`  [dry-run] would remove ${label} registration${removed === 1 ? '' : 's'}`);
         return true;
     }
-    if (existingIndex !== -1)
-        lines.splice(existingIndex, 1);
-    const refreshedAfterIndex = lines.findIndex((entry) => entry.includes(normalizedAfterPath));
-    if (refreshedAfterIndex !== -1) {
-        lines.splice(refreshedAfterIndex + 1, 0, line);
-    }
-    else {
-        const extensionsIndex = lines.findIndex((entry) => EXTENSIONS_KEY_RE.test(entry));
-        if (extensionsIndex === -1) {
-            lines.push('extensions:', line, '');
-        }
-        else {
-            normalizeExtensionsKey(lines);
-            lines.splice(extensionsIndex + 1, 0, line);
-        }
-    }
-    await writeConfigLines(configPath, lines, `  [write] Placed ${label} after Ponytail in config.yml`, options);
+    await writeConfigLines(configPath, kept, `  [write] Removed duplicate ${label} registration`, options);
     return true;
 }
 function readPonytailConfig() {
@@ -298,4 +302,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, 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, gain, 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, };
+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, removeExtensionFromConfig, 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,5 +1,4 @@
-// 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.
@@ -14,24 +13,17 @@ import { clearUsageLedger, markReset, readUsage } from '../extensions/shared/usa
 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 { OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_VERSION, } 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 CORE_JS = path.join(DASH_DIR, 'core.js');
-const CHARTS_JS = path.join(DASH_DIR, 'charts.js');
-const SETTINGS_JS = path.join(DASH_DIR, 'settings.js');
-const SHARE_JS = path.join(DASH_DIR, 'share.js');
-const BRAND = path.join(DASH_DIR, 'brand.webp');
-// shadcn gain app (gain/). When its production bundle exists the server
-// binds to it; otherwise it falls back to the legacy dashboard/ segments.
-const GAIN_DIST = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'gain', 'dist');
-const GAIN_INDEX = path.join(GAIN_DIST, 'index.html');
-const GAIN_BRAND = path.join(GAIN_DIST, 'brand.webp');
-function useGainBundle() {
-    return existsSync(GAIN_INDEX);
+import { PACKAGE_NAME } from './common.js';
+import { resolveRtkBinary } from '../extensions/lib/utils.js';
+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'))
@@ -53,9 +45,9 @@ function contentType(file) {
 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()));
@@ -109,8 +101,8 @@ function ompDefaultModel() {
     }
 }
 function healthJson() {
-    const rtkBin = path.join(BUN_BIN_DIR, RTK_BINARY_NAME);
-    const rtkPresent = existsSync(rtkBin);
+    const rtkBin = resolveRtkBinary();
+    const rtkPresent = rtkBin !== null;
     const detectedOmpPath = ompPath();
     return JSON.stringify({
         tersio: PACKAGE_VERSION,
@@ -119,7 +111,7 @@ function healthJson() {
         omp: ompVersion(detectedOmpPath),
         ompPath: detectedOmpPath,
         provider: ompDefaultModel(),
-        rtk: { present: rtkPresent, version: rtkPresent ? rtkVersion(rtkBin) : null, path: rtkBin },
+        rtk: { present: rtkPresent, version: rtkPresent ? rtkVersion(rtkBin) : null, path: rtkBin || 'not found in PATH' },
         home: tersioHomePath(),
     });
 }
@@ -194,26 +186,39 @@ function relAge(ms) {
 function computeDoctorRows() {
     const rows = [];
     const extDir = path.join(OMP_AGENT_DIR, 'extensions');
-    const rtkBin = path.join(BUN_BIN_DIR, RTK_BINARY_NAME);
+    const rtkBin = resolveRtkBinary();
     const ponytailPkg = path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'package.json');
+    const tersioPluginDir = path.join(OMP_PLUGINS_DIR, 'node_modules', ...PACKAGE_NAME.split('/'));
     const ok = (p) => existsSync(p);
+    const configPath = path.join(OMP_AGENT_DIR, 'config.yml');
     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'));
+    let explicitEntries = [];
+    try {
+        explicitEntries = readFileSync(configPath, 'utf8').split('\n')
+            .map((line) => line.trim().replace(/^-\s*/, '').replace(/^['"]|['"]$/g, ''))
+            .filter((line) => line.startsWith('/') || line.startsWith('.'));
+    }
+    catch { /* missing config is reported by extension rows */ }
+    const duplicateExtensions = [...new Set(explicitEntries.filter((entry, index) => explicitEntries.indexOf(entry) !== index))];
+    addon('Unique config registrations', duplicateExtensions.length === 0, duplicateExtensions.length ? duplicateExtensions.join(', ') : 'ok', 'Extensions');
+    const retiredReinforcement = explicitEntries.filter((entry) => entry.endsWith('/shared/mode-reinforcement.ts')).length;
+    addon('No retired reinforcement', retiredReinforcement === 0, retiredReinforcement ? `${retiredReinforcement} registration(s)` : 'ok', 'Extensions');
+    ext('Caveman extension', path.join(tersioPluginDir, 'extensions', 'caveman-session', 'index.ts'));
+    ext('RTK extension', path.join(tersioPluginDir, 'extensions', '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 rule = path.join(tersioPluginDir, 'extensions', '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 rtkVer = rtkBin ? rtkVersion(rtkBin) : null;
+    const rtkAge = rtkBin ? ageStr(rtkBin) : null;
+    const rtkAt = rtkBin ? absTime(rtkBin) : null;
+    addon('RTK binary', rtkVer !== null, rtkVer && rtkAge && rtkAt ? `${rtkVer} (updated ${rtkAge} · ${rtkAt})` : rtkBin || 'not found in PATH');
     const wiring = path.join(extDir, 'rtk.ts');
     addon('RTK OMP wiring (rtk.ts)', ok(wiring), ok(wiring) ? 'loaded' : wiring);
     let ponytailVer = null;
@@ -273,7 +278,7 @@ 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) {
@@ -310,45 +315,22 @@ function escapeInline(json) {
     return json.replace(/<\/(script)/gi, '<\\/$1');
 }
 async function exportDashboard(exportFile) {
-    if (useGainBundle()) {
-        const [bundle, icon] = await Promise.all([readSegment(GAIN_INDEX), faviconDataUri()]);
-        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"', () => `href="${icon}"`)
-            .replace(/src="brand.webp"/g, () => `src="${icon}"`);
-        await fs.writeFile(exportFile, inline, 'utf8');
-        console.log(`[ok] gain exported → ${exportFile}`);
-        return;
-    }
-    const [template, css, core, charts, settings, share, legacyIcon] = await Promise.all([
-        readSegment(TEMPLATE), readSegment(STYLES), readSegment(CORE_JS), readSegment(CHARTS_JS),
-        readSegment(SETTINGS_JS), readSegment(SHARE_JS), faviconDataUri(),
-    ]);
-    const inline = template
-        .replace('<link rel="stylesheet" href="styles.css">', () => `<style>\n${css}</style>`)
-        .replace('<script src="core.js" defer></script>', () => `<script>\n${core}</script>`)
-        .replace('<script src="charts.js" defer></script>', () => `<script>\n${charts}</script>`)
-        .replace('<script src="settings.js" defer></script>', () => `<script>\n${settings}</script>`)
-        .replace('<script src="share.js" defer></script>', () => `<script>\n${share}</script>`)
-        .replace('window.__TERSIO_SNAP = null;', () => `window.__TERSIO_SNAP = ${escapeInline(JSON.stringify({ health: JSON.parse(healthJson()), doctor: getDoctorReport(false) }))};`)
-        .replace("fetch('data.json')", () => `Promise.resolve({ json: function () { return ${escapeInline(dataJson())}; } })`)
-        // 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="${legacyIcon}"`)
-        .replace(/src="brand.webp"/g, () => `src="${legacyIcon}"`);
+    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] gain exported → ${exportFile}`);
+    console.log(`[ok] Dashboard exported → ${exportFile}`);
 }
 async function runDashboard(options) {
     if (options.exportFile) {
         await exportDashboard(options.exportFile);
         return;
     }
-    const html = useGainBundle()
-        ? null
-        : 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();
@@ -419,67 +401,29 @@ async function runDashboard(options) {
             res.end(JSON.stringify(getDoctorReport(fresh)));
             return;
         }
-        if (req.url === '/styles.css') {
-            res.writeHead(200, { 'Content-Type': 'text/css; charset=utf-8' });
-            res.end(await readSegment(STYLES));
-            return;
-        }
-        const scripts = {
-            '/core.js': CORE_JS,
-            '/charts.js': CHARTS_JS,
-            '/settings.js': SETTINGS_JS,
-            '/share.js': SHARE_JS,
-        };
-        if (req.url !== undefined && req.url in scripts) {
-            res.writeHead(200, { 'Content-Type': 'text/javascript; charset=utf-8' });
-            res.end(await readSegment(scripts[req.url]));
-            return;
-        }
-        if (req.url === '/brand.webp') {
-            // Prefer the bundled brand; fall back to the legacy dashboard copy.
-            for (const file of [GAIN_BRAND, BRAND]) {
-                try {
-                    const png = await fs.readFile(file);
-                    res.writeHead(200, { 'Content-Type': 'image/webp' });
-                    res.end(png);
-                    return;
-                }
-                catch { /* try the next copy */ }
-            }
-            res.writeHead(404);
-            res.end();
-            return;
-        }
-        if (useGainBundle()) {
-            // shadcn bundle: index.html at /, sibling files (brand.webp,
-            // vite.svg) by path. No path escapes outside gain/dist.
-            const name = (req.url ?? '/').split('?')[0];
-            const file = path.normalize(path.join(GAIN_DIST, name === '/' ? 'index.html' : name.slice(1)));
-            if (file === GAIN_DIST || file.startsWith(GAIN_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 */ }
+        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;
             }
-            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-            res.end(await readSegment(GAIN_INDEX));
-            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);
     });