@krtclcdy/tersio 2.20.1 → 2.22.0

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:
@@ -82,7 +81,7 @@ Break-even math, balanced preset (caveman full + rtk + ponytail): a mixed turn c
 
 ## 📈 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:
+`tersio gain --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.
 
@@ -103,7 +102,7 @@ Break-even math, balanced preset (caveman full + rtk + ponytail): a mixed turn c
 | `tersio install` | Install (user scope: all OMP sessions) |
 | `tersio update` | Refresh the CLI, extensions, and add-ons (RTK binary, Caveman rule, Ponytail) |
 | `tersio reinstall` | Fresh install, preserving the Ponytail package |
-| `tersio doctor` | Check OMP, extension, Ponytail, and RTK health |
+| `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 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 |
@@ -125,8 +124,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 gain` | Savings summary; the gain dashboard charts `~/.tersio/usage.db` (`tersio gain --open` serves on 127.0.0.1, `--export` writes one file). |
+| `/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 +135,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` |
 

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 = {
@@ -51,6 +52,16 @@ const COMMANDS = { install: true, update: true, reinstall: true, doctor: true, u
 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';
@@ -62,6 +73,7 @@ const dryRun = args.includes('--dry-run');
 const yes = args.includes('--yes') || args.includes('-y') || install || update || reinstall || applyUpdate;
 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 reset = command === 'reset';
@@ -89,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) {
@@ -285,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, dryRun, yes, verbose, doctor, 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, 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, };

package/cli/dashboard.js

@@ -4,20 +4,52 @@
 // 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 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);
+}
+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');
 }
@@ -28,6 +60,218 @@ async function faviconDataUri() {
 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
 // browser's localStorage alone cannot survive a restart. The stored default
@@ -55,33 +299,56 @@ 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) {
+    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}"`);
+    await fs.writeFile(exportFile, inline, 'utf8');
+    console.log(`[ok] gain 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));
+    const html = useGainBundle()
+        ? null
+        : await withInteractiveSpinner('Loading dashboard template', () => readSegment(TEMPLATE));
     const server = http.createServer(async (req, res) => {
         if (req.url === '/reset' && req.method === 'POST') {
             const rows = clearUsageLedger();
@@ -114,30 +381,95 @@ async function runDashboard(options) {
             res.end(dataJson());
             return;
         }
+        if (req.url === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(healthJson());
+            return;
+        }
+        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 === '/doctor/fix' && req.method === 'POST') {
+            try {
+                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 (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;
+        }
         if (req.url === '/styles.css') {
             res.writeHead(200, { 'Content-Type': 'text/css; charset=utf-8' });
             res.end(await readSegment(STYLES));
             return;
         }
-        if (req.url === '/app.js') {
+        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(APP));
+            res.end(await readSegment(scripts[req.url]));
             return;
         }
         if (req.url === '/brand.webp') {
-            try {
-                const png = await fs.readFile(BRAND);
-                res.writeHead(200, { 'Content-Type': 'image/webp' });
-                res.end(png);
+            // 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 */ }
             }
-            catch {
-                res.writeHead(404);
-                res.end();
+            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 */ }
             }
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            res.end(await readSegment(GAIN_INDEX));
             return;
         }
         res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-        res.end(html);
+        res.end(html ?? '');
     });
     server.listen(options.port, '127.0.0.1', () => {
         try {
@@ -152,4 +484,4 @@ async function runDashboard(options) {
             openBrowser(url);
     });
 }
-export { runDashboard, saveDashboardCurrency };
+export { runDashboard, saveDashboardCurrency, readDiagSchedule, setDiagSchedule };