@krtclcdy/tersio 2.21.0 → 2.22.1

package/cli/doctor.js

@@ -1,12 +1,10 @@
 // cli/doctor.ts — installation health checks.
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
-import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, args, dryRun, fix, yes, execP, parseJsonObject, relTime, } from './common.js';
+import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, RTK_BINARY_NAME, args, dryRun, fix, yes, execP, parseJsonObject, relTime, } from './common.js';
 import { askInteractiveChoice, askInteractiveConfirm, runInteractivePhase } from './interactive.js';
-import { ledgerPath, readUsage, sessionsDir } from '../extensions/shared/usage-ledger.js';
 import { usageDbPath } from '../extensions/shared/usage-store.js';
-import { readRtkGain, rtkDbPath } from '../extensions/shared/rtk-gain.js';
-import { checkForUpdate } from './update.js';
+import { pricesCachePath } from '../extensions/shared/pricing.js';
 import { readTextIfExists } from '../extensions/lib/utils.js';
 async function runDoctor(recheck = false) {
     console.log('\n=== Tersio Doctor ===');
@@ -23,60 +21,43 @@ async function runDoctor(recheck = false) {
     const cavemanRule = path.join(extDir, 'caveman-session', 'rule.md');
     const rtkIndex = path.join(extDir, 'rtk-session', 'index.ts');
     const updaterIndex = path.join(extDir, 'ai-addons-updater', 'index.ts');
-    const comboIndex = path.join(extDir, 'combo-toggle', 'index.ts');
-    const tersioIndex = path.join(extDir, 'tersio-commands', 'index.ts');
-    const modeReinforcement = path.join(extDir, 'shared', 'mode-reinforcement.ts');
-    const selfPkg = path.join(pluginsDir, 'node_modules', PACKAGE_NAME, 'package.json');
     // Independent probes start concurrently; sections report in fixed order as
     // their data settles. Every probe resolves instead of rejecting.
     const probes = {
-        ompVersion: execP(OMP_BIN, ['--version']).then((r) => r.stdout.trim(), () => null),
         agentEntries: fs.readdir(agentDir).catch(() => null),
         extEntries: fs.readdir(extDir).catch(() => null),
         sharedStateText: readTextIfExists(path.join(extDir, 'shared', 'session-state.ts')),
         configText: readTextIfExists(configPath),
         ponytailPkgText: readTextIfExists(ponytailPkg),
         ponytailExtText: readTextIfExists(ponytailExt),
-        pluginsPkgRaw: readTextIfExists(path.join(pluginsDir, 'package.json')),
-        selfPkgText: readTextIfExists(selfPkg),
         rtkBinText: readTextIfExists(rtkBin),
         rtkOmpText: readTextIfExists(path.join(extDir, 'rtk.ts')),
         cavemanIndexText: readTextIfExists(cavemanIndex),
         cavemanRuleText: readTextIfExists(cavemanRule),
         rtkIndexText: readTextIfExists(rtkIndex),
         updaterIndexText: readTextIfExists(updaterIndex),
-        comboIndexText: readTextIfExists(comboIndex),
-        tersioIndexText: readTextIfExists(tersioIndex),
-        modeReinforcementText: readTextIfExists(modeReinforcement),
         ruleMtime: fs.stat(cavemanRule).catch(() => null),
         rtkMtime: fs.stat(rtkBin).catch(() => null),
         ponytailMtime: fs.stat(ponytailPkg).catch(() => null),
-        updateVersion: checkForUpdate(),
+        pricesMtime: fs.stat(pricesCachePath()).catch(() => null),
     };
     const rtkVersionProbe = probes.rtkBinText.then((text) => text === null ? null : execP(rtkBin, ['--version'], { timeout: 5000 }).then((r) => r.stdout.trim() || r.stderr.trim() || null, (e) => {
         const err = e;
         return err.stdout?.trim() || err.stderr?.trim() || null;
     }));
-    const [[ompVersion, agentEntries, extEntries, sharedStateText, configText, updateVersion], [cavemanIndexText, rtkIndexText, updaterIndexText, comboIndexText, tersioIndexText, modeReinforcementText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText], [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, rtkOmpText, ponytailMtime]] = await runInteractivePhase('Checking installation', () => Promise.all([
+    const [[agentEntries, extEntries, sharedStateText, configText], [cavemanIndexText, rtkIndexText, updaterIndexText, ponytailPkgText, ponytailExtText], [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, rtkOmpText, ponytailMtime, pricesMtime]] = await runInteractivePhase('Checking installation', () => Promise.all([
         Promise.all([
-            probes.ompVersion,
             probes.agentEntries,
             probes.extEntries,
             probes.sharedStateText,
             probes.configText,
-            probes.updateVersion,
         ]),
         Promise.all([
             probes.cavemanIndexText,
             probes.rtkIndexText,
             probes.updaterIndexText,
-            probes.comboIndexText,
-            probes.tersioIndexText,
-            probes.modeReinforcementText,
             probes.ponytailPkgText,
             probes.ponytailExtText,
-            probes.pluginsPkgRaw,
-            probes.selfPkgText,
         ]),
         Promise.all([
             probes.cavemanRuleText,
@@ -86,11 +67,18 @@ async function runDoctor(recheck = false) {
             rtkVersionProbe,
             probes.rtkOmpText,
             probes.ponytailMtime,
+            probes.pricesMtime,
         ]),
     ]));
     // Categorized output with a tally; success rows stay quiet (no path echoes)
     // while failures print the expected path or fix so they stay actionable.
     const tally = { ok: 0, missing: 0, warn: 0 };
+    function absDate(ms) {
+        const d = new Date(ms);
+        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'}`;
+    }
     function check(label, ok, detail = '') {
         if (ok) {
             tally.ok++;
@@ -107,13 +95,6 @@ async function runDoctor(recheck = false) {
     }
     section('Environment');
     check('Node', true, process.version);
-    check('OMP CLI', ompVersion !== null, ompVersion ?? '');
-    if (typeof updateVersion === 'string')
-        warnLine('Tersio CLI', `${updateVersion} available — run tersio update`);
-    else if (updateVersion === 'unknown')
-        warnLine('Tersio CLI', `${PACKAGE_VERSION} (version check unreachable)`);
-    else
-        check('Tersio CLI', true, PACKAGE_VERSION);
     section('Installation');
     check('OMP agent dir', agentEntries !== null, agentEntries === null ? agentDir : '');
     check('OMP extensions dir', extEntries !== null, extEntries === null ? extDir : '');
@@ -123,37 +104,25 @@ async function runDoctor(recheck = false) {
     check('Caveman extension', cavemanIndexText !== null);
     check('RTK extension', rtkIndexText !== null);
     check('Updater extension', updaterIndexText !== null);
-    check('Combo extension', comboIndexText !== null);
-    check('Tersio commands extension', tersioIndexText !== null);
-    check('Mode reinforcement extension', modeReinforcementText !== null);
     check('Ponytail extension', ponytailExtText !== null);
-    check('Ponytail in config.yml', (configText ?? '').includes('ponytail') && (configText ?? '').includes('pi-extension'));
-    check('Combo in config.yml', (configText ?? '').includes('combo-toggle'));
-    check('Self plugin package', selfPkgText !== null, parseJsonObject(selfPkgText)?.version ?? '');
-    const selfDep = PACKAGE_NAME in (parseJsonObject(pluginsPkgRaw)?.dependencies || {});
-    check('Self plugin in plugins/package.json', selfDep);
     section('Usage & records');
-    const usageRows = readUsage();
-    check('Usage ledger', true, usageRows.length ? `${usageRows.length} rows` : 'empty — no records yet');
-    console.log(`  Usage ledger (tersio-owned, tersio reset clears): ${ledgerPath()} · ${usageRows.length} rows`);
-    console.log(`  Session transcripts (host-owned, never touched): ${sessionsDir()}`);
-    console.log(`  Usage DB (tersio-owned, tersio reset clears): ${usageDbPath()}`);
-    const rtkDb = rtkDbPath();
-    const rtk = readRtkGain();
-    console.log(`  RTK history (rtk-owned, never touched): ${rtkDb}${rtk.commands ? ` · ${rtk.commands} commands` : ''}`);
+    console.log(`  Usage DB (tersio-owned · local hosted): ${usageDbPath()}`);
+    const pricesAge = pricesMtime ? `(pulled ${relTime(Date.now() - pricesMtime.mtimeMs)} · ${absDate(pricesMtime.mtimeMs)})` : '';
+    check('Prices feed', pricesMtime !== null, pricesAge || pricesCachePath());
     section('Add-ons');
-    const ruleAge = ruleMtime ? `updated ${relTime(Date.now() - ruleMtime.mtimeMs)}` : '';
+    const ruleAge = ruleMtime ? `(updated ${relTime(Date.now() - ruleMtime.mtimeMs)} · ${absDate(ruleMtime.mtimeMs)})` : '';
     check('Caveman rule', cavemanRuleText !== null, ruleAge);
-    const rtkAge = rtkMtime ? `updated ${relTime(Date.now() - rtkMtime.mtimeMs)}` : '';
-    check('RTK binary', rtkBinText !== null, rtkBinText === null ? rtkBin : [rtkVersion, rtkAge].filter(Boolean).join(', '));
+    const rtkAge = rtkMtime ? `(updated ${relTime(Date.now() - rtkMtime.mtimeMs)} · ${absDate(rtkMtime.mtimeMs)})` : '';
+    check('RTK binary', rtkBinText !== null, rtkBinText === null ? rtkBin : [rtkVersion, rtkAge].filter(Boolean).join(' '));
     if (rtkBinText !== null && !rtkVersion)
         warnLine('RTK version', 'unavailable — binary may not be executable');
     const rtkRegistered = rtkOmpText !== null && (configText ?? '').includes('extensions/rtk.ts');
     check('RTK OMP wiring (rtk.ts)', rtkOmpText !== null, rtkOmpText === null ? 'run: rtk init -g --agent omp' : '');
     if (rtkOmpText !== null && !rtkRegistered)
         warnLine('RTK in config.yml', 'rtk.ts not listed — OMP will not load it; rerun install');
-    const ponytailAge = ponytailMtime ? `updated ${relTime(Date.now() - ponytailMtime.mtimeMs)}` : '';
-    check('Ponytail', ponytailPkgText !== null, [parseJsonObject(ponytailPkgText)?.version ?? '', ponytailAge].filter(Boolean).join(', '));
+    const ponytailAge = ponytailMtime ? `(updated ${relTime(Date.now() - ponytailMtime.mtimeMs)} · ${absDate(ponytailMtime.mtimeMs)})` : '';
+    const ponytailVer = parseJsonObject(ponytailPkgText)?.version ?? '';
+    check('Ponytail', ponytailPkgText !== null, [ponytailVer, ponytailAge].filter(Boolean).join(' '));
     const total = tally.ok + tally.missing + tally.warn;
     console.log(`\n  Summary: ${total} checks — ✅ ${tally.ok} ok, ⚠️ ${tally.warn} warn, ❌ ${tally.missing} missing`);
     if (!recheck && tally.missing + tally.warn > 0 && (fix || dryRun)) {
@@ -219,7 +188,7 @@ async function runDoctorFix(tally) {
             { value: 'extensions', label: 'Missing extension files', hint: 'copy sources from this CLI' },
             { value: 'registrations', label: 'config.yml registrations', hint: 'combo, ponytail, rtk.ts entries' },
             { value: 'rtk', label: 'RTK binary + wiring', hint: 'download checksum-verified binary, rtk init' },
-            { value: 'ponytail', label: 'Ponytail package', hint: 'omp plugin install + npm refresh' },
+            { value: 'ponytail', label: 'Ponytail package', hint: 'bundled reinstall via tersio dep' },
             { value: 'cli', label: 'CLI update', hint: 'latest tersio + delegated refresh' },
         ], 'all');
         if (picked.status !== 'selected') {

package/cli/install.js

@@ -31,98 +31,69 @@ const SHARED_PLUGIN_SETTINGS = path.join(EXT_DIR, 'shared', 'plugin-settings.ts'
 const SHARED_USAGE_LEDGER = path.join(EXT_DIR, 'shared', 'usage-ledger.ts');
 const SHARED_PRICING = path.join(EXT_DIR, 'shared', 'pricing.ts');
 const SHARED_CARBON = path.join(EXT_DIR, 'shared', 'carbon.ts');
-const PONYTAIL_GITHUB_SPEC = 'github:DietrichGebert/ponytail';
-const PONYTAIL_NPM_SPEC = '@dietrichgebert/ponytail@latest';
 async function stepPonytail(pluginsDir, userDir, options) {
     if (!options.quiet)
-        console.log('  Ponytail — refresh plugin');
+        console.log('  Ponytail — ensure bundled plugin');
     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;
+    // Migration: ponytail was a separate plugin row. It is now a tersio
+    // dependency, so drop the legacy row. Runs after stepSelfPlugin.
+    let migrated = false;
+    if ('@dietrichgebert/ponytail' in pkg.dependencies) {
+        delete pkg.dependencies['@dietrichgebert/ponytail'];
+        migrated = true;
+    }
     if (options.dryRun) {
         if (verbose && !options.quiet)
             console.log(`  [dry-run] would write ${pkgPath}`);
+        if (migrated && verbose && !options.quiet)
+            console.log(`  [dry-run] would drop the separate @dietrichgebert/ponytail dependency (bundled with tersio)`);
     }
-    else {
+    else if (migrated) {
         await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+        if (!options.quiet)
+            console.log('  [migrate] dropped separate @dietrichgebert/ponytail dependency (now bundled with tersio)');
     }
     const ponytailExtPath = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
     const probeExt = async () => (await readTextIfExists(ponytailExtPath)) !== null;
-    // Fast path: extension already present and no refresh asked — skip network.
-    let ponytailExtExists = !options.reinstall && !options.dryRun ? await probeExt() : false;
+    // Fast path: bundled copy already present and no refresh asked — skip
+    // network. Migration always reinstalls: the probe may hit the stale legacy
+    // copy, and only npm install prunes it into the tersio-owned one.
+    let ponytailExtExists = !options.reinstall && !options.dryRun && !migrated ? await probeExt() : false;
     if (ponytailExtExists) {
-        debug('Ponytail pi-extension already installed; skipping network refresh');
+        debug('Bundled Ponytail pi-extension already installed; skipping network refresh');
     }
     else if (options.dryRun) {
         // Dry runs preview the wiring below without touching the network.
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would run: omp plugin install ${PONYTAIL_GITHUB_SPEC}`);
-        if (options.reinstall && verbose && !options.quiet) {
-            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)');
         ponytailExtExists = true;
     }
     else {
-        // Try omp plugin install first
+        // Self-plugin npm install already materialized the bundled copy.
+        // Reinstall here only when the probe still misses.
         try {
-            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('Installing bundled Ponytail', 'npm', ['install', '--no-audit', '--no-fund'], { cwd: pluginsDir, timeout: 180000 });
         }
-        if (options.reinstall) {
+        catch {
             try {
-                await execNetwork('Refreshing Ponytail package', 'npm', ['install', PONYTAIL_NPM_SPEC, '--save', '--no-audit', '--no-fund'], { cwd: pluginsDir, timeout: 120000 });
+                await execNetwork('Installing bundled Ponytail', 'bun', ['install'], { cwd: pluginsDir, timeout: 180000 });
             }
             catch (e) {
-                console.log(`  [fail] Could not refresh ponytail: ${e.message}`);
-                console.log(`  [hint] Manual: cd ~/.omp/plugins && npm install ${PONYTAIL_NPM_SPEC} --save --no-audit --no-fund`);
+                console.log(`  [fail] Could not install bundled ponytail: ${e.message}`);
+                console.log('  [hint] Manual: cd ~/.omp/plugins && npm install --no-audit --no-fund');
             }
         }
-        // Verify the pi-extension/index.js actually exists
         ponytailExtExists = await probeExt();
-        // Fallback: try bun install or npm install
-        if (!ponytailExtExists) {
-            if (!options.quiet)
-                console.log('  [info] pi-extension/index.js not found after omp plugin install — trying npm/bun install...');
-            try {
-                await execNetwork('Installing Ponytail dependencies', 'npm', ['install'], { cwd: pluginsDir, timeout: 120000 });
-            }
-            catch {
-                try {
-                    await execNetwork('Installing Ponytail dependencies', 'bun', ['install'], { cwd: pluginsDir, timeout: 120000 });
-                }
-                catch (e2) {
-                    console.log(`  [fail] Could not install ponytail: ${e2.message}`);
-                    console.log('  [hint] Manual: cd ~/.omp/plugins && npm install');
-                }
-            }
-            ponytailExtExists = await probeExt();
-        }
-        // Last-resort fallback: git clone the repo into node_modules
-        if (!ponytailExtExists) {
-            if (!options.quiet)
-                console.log('  [info] npm/bun did not produce pi-extension — trying git clone...');
-            try {
-                const dest = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail');
-                await fs.mkdir(path.dirname(dest), { recursive: true });
-                await execNetwork('Cloning Ponytail repository', 'git', ['clone', '--depth', '1', 'https://github.com/DietrichGebert/ponytail.git', dest], { timeout: 180000 });
-                ponytailExtExists = await probeExt();
-            }
-            catch (e3) {
-                console.log(`  [fail] git clone failed: ${e3.message}`);
-                console.log('  [hint] Install git or check network: https://github.com/DietrichGebert/ponytail');
-            }
-        }
     }
     if (!ponytailExtExists) {
-        console.log('  [skip] Ponytail pi-extension/index.js still not found — skill-only mode');
+        console.log('  [skip] Bundled Ponytail pi-extension/index.js still not found — skill-only mode');
         console.log('  [hint] The /ponytail command won\'t work, but ponytail skills will still load');
     }
     else if (!options.dryRun && !options.quiet) {
         // Wire extension into config.yml so /ponytail command loads
-        debug('Ponytail pi-extension found');
+        debug('Bundled Ponytail pi-extension found');
     }
     // Still set Ponytail config defaults even without the extension command
     const configPath = path.join(userDir, 'config.yml');
@@ -513,7 +484,7 @@ async function runCommandMenu() {
         { value: 'reinstall', label: 'Reinstall', hint: 'clean and reinstall the add-ons, Ponytail package kept' },
         { value: 'doctor', label: 'Doctor', hint: 'verify the installation' },
         { value: 'usage', label: 'Usage', hint: 'token usage and savings report' },
-        { value: 'gain', label: 'Gain dashboard', hint: 'open the report in your browser' },
+        { value: 'dashboard', label: 'Dashboard', hint: 'open the report in your browser' },
         { value: 'reset', label: 'Reset statistics', hint: 'clear statistics; transcripts and RTK history stay' },
         { value: 'settings', label: 'Settings', hint: 'defaults: combo, caveman, rtk, ponytail, currency' },
         { value: 'uninstall', label: 'Uninstall', hint: 'remove tersio' },
@@ -574,7 +545,7 @@ async function runCommandMenu() {
             await runUsage();
             closeRL();
             break;
-        case 'gain':
+        case 'dashboard':
             await runDashboard({ port: dashboardPort, open: true, exportFile: dashboardExport });
             closeRL();
             break;
@@ -671,9 +642,9 @@ async function runInstall(overrides = {}) {
         }
     };
     await capture('shared', () => stepSharedSessionState(userExtDir, options));
-    await capture('ponytail', () => stepPonytail(OMP_PLUGINS_DIR, userDir, options));
     let selfPlugin = false;
     await capture('self-plugin', async () => { selfPlugin = await stepSelfPlugin(OMP_PLUGINS_DIR, options); });
+    await capture('ponytail', () => stepPonytail(OMP_PLUGINS_DIR, userDir, options));
     const ponytailExtPath = path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
     await capture('rtk', () => stepRtk(BUN_BIN_DIR, options));
     await capture('rtk session', () => stepRtkSession(userExtDir, options));

package/cli/profile.js

@@ -1,5 +1,5 @@
 // cli/profile.ts — session-start defaults profile (combo/caveman/rtk/ponytail)
-// plus the display-currency default for usage/gain reports.
+// plus the display-currency default for usage/dashboard reports.
 // Single source for reading/writing the omp plugin settings lock entry.
 // Extracted from cli/install.ts so both install and settings share it.
 import { promises as fs } from 'node:fs';

package/cli/settings.js

@@ -1,14 +1,15 @@
 // cli/settings.ts — view/edit session-start defaults (combo/caveman/rtk/ponytail)
-// plus the display-currency default for usage/gain reports.
+// plus the display-currency default for usage/dashboard reports.
 // Non-interactive: `tersio settings --combo-default balanced` (plus per-mode
 // override flags and --currency). Interactive: clack selects seeded from the
 // stored profile.
 import path from 'node:path';
-import { CAVEMAN_DEFAULTS, COMBO_DEFAULTS, COMBO_PRESET_MODES, OMP_PLUGINS_DIR, PACKAGE_NAME, PONYTAIL_DEFAULTS, cavemanDefaultFlag, comboDefaultFlag, currency, currencyGiven, dryRun, ponytailDefaultFlag, profileFlagsGiven, rtkDefaultFlag, } from './common.js';
+import { CAVEMAN_DEFAULTS, COMBO_DEFAULTS, COMBO_PRESET_MODES, OMP_PLUGINS_DIR, PACKAGE_NAME, PONYTAIL_DEFAULTS, cavemanDefaultFlag, comboDefaultFlag, currency, currencyGiven, diagScheduleFlag, dryRun, ponytailDefaultFlag, profileFlagsGiven, rtkDefaultFlag, settingArg, } from './common.js';
 import { CURRENCY_CODES } from './currency.js';
 import { textTable } from './usage.js';
 import { askInteractiveChoice, closeRL, tty } from './interactive.js';
 import { formatProfile, storedProfile, writePluginSettings } from './profile.js';
+import { readDiagSchedule, setDiagSchedule } from './dashboard.js';
 function applyFlags(base) {
     const next = { ...base };
     if (comboDefaultFlag !== undefined)
@@ -63,7 +64,7 @@ async function askProfile(current) {
     if (ponytail.status !== 'selected')
         return null;
     next.ponytailDefault = ponytail.value;
-    const cur = await askInteractiveChoice('Display currency (usage/gain reports)', CURRENCY_CODES.map((v) => ({
+    const cur = await askInteractiveChoice('Display currency (usage/dashboard reports)', CURRENCY_CODES.map((v) => ({
         value: v, label: v,
     })), next.currency);
     if (cur.status !== 'selected')
@@ -71,9 +72,97 @@ async function askProfile(current) {
     next.currency = cur.value;
     return next;
 }
+async function askDiagSchedule(current) {
+    const picked = await askInteractiveChoice('Diagnosis auto-check', [
+        { value: 'manual', label: 'manual', hint: 'check on open' },
+        { value: 'daily', label: 'daily' },
+        { value: 'weekly', label: 'weekly' },
+        { value: 'monthly', label: 'monthly' },
+    ], current);
+    if (picked.status !== 'selected')
+        return null;
+    return picked.value;
+}
+const SETTING_NAMES = ['combo', 'caveman', 'rtk', 'ponytail', 'currency', 'diagnosis'];
+function settingsUsage() {
+    console.log('  Usage: tersio settings [combo|caveman|rtk|ponytail|currency|diagnosis] [--combo-default off|medium|balanced|max] [--caveman-default off|lite|full|ultra|wenyan] [--rtk-default on|off] [--ponytail-default off|lite|full|ultra|review] [--currency USD|PHP|EUR|GBP|JPY|KRW|SGD|AUD|CAD|INR] [--diag-schedule manual|daily|weekly|monthly] [--dry-run]');
+}
+// Single-setting jump: `tersio settings diagnosis` prompts only that value
+// instead of walking the whole chain. Returns false when aborted.
+async function runSingleSetting(name, current, nextDiag) {
+    const next = { ...current };
+    let diag = nextDiag;
+    switch (name) {
+        case 'combo': {
+            const combo = await askInteractiveChoice('Session-start defaults — Combo preset', [
+                { value: 'off', label: 'off' },
+                { value: 'medium', label: 'medium', hint: 'caveman=lite, rtk=on, ponytail=lite' },
+                { value: 'balanced', label: 'balanced', hint: 'caveman=full, rtk=on, ponytail=full' },
+                { value: 'max', label: 'max', hint: 'caveman=ultra, rtk=on, ponytail=ultra' },
+            ], current.comboDefault);
+            if (combo.status !== 'selected')
+                return null;
+            const preset = COMBO_PRESET_MODES[combo.value] ?? COMBO_PRESET_MODES.off;
+            next.comboDefault = combo.value;
+            next.cavemanDefault = preset.caveman;
+            next.rtkDefault = preset.rtk;
+            next.ponytailDefault = preset.ponytail;
+            break;
+        }
+        case 'caveman': {
+            const picked = await askInteractiveChoice('Caveman default', [...CAVEMAN_DEFAULTS].map((v) => ({
+                value: v, label: v,
+            })), next.cavemanDefault);
+            if (picked.status !== 'selected')
+                return null;
+            next.cavemanDefault = picked.value;
+            break;
+        }
+        case 'rtk': {
+            const picked = await askInteractiveChoice('RTK default', [
+                { value: 'on', label: 'on' },
+                { value: 'off', label: 'off' },
+            ], next.rtkDefault ? 'on' : 'off');
+            if (picked.status !== 'selected')
+                return null;
+            next.rtkDefault = picked.value === 'on';
+            break;
+        }
+        case 'ponytail': {
+            const picked = await askInteractiveChoice('Ponytail default', [...PONYTAIL_DEFAULTS].map((v) => ({
+                value: v, label: v,
+            })), next.ponytailDefault);
+            if (picked.status !== 'selected')
+                return null;
+            next.ponytailDefault = picked.value;
+            break;
+        }
+        case 'currency': {
+            const picked = await askInteractiveChoice('Display currency (usage/dashboard reports)', CURRENCY_CODES.map((v) => ({
+                value: v, label: v,
+            })), next.currency);
+            if (picked.status !== 'selected')
+                return null;
+            next.currency = picked.value;
+            break;
+        }
+        case 'diagnosis': {
+            const picked = await askDiagSchedule(diag);
+            if (picked === null)
+                return null;
+            diag = picked;
+            break;
+        }
+        default: {
+            console.error(`[fail] Invalid setting: ${name}. Valid: ${SETTING_NAMES.join(', ')}`);
+            process.exit(1);
+        }
+    }
+    return { profile: next, diag };
+}
 function printSettingsTable(current) {
     console.log('\n=== Tersio Settings ===');
-    // Currency lives here no longer: the gain dashboard owns displaying and
+    // Currency lives here no longer: the dashboard owns displaying and
     // persisting it (its picker POSTs to /currency); settings can still set
     // the stored default via --currency or the prompt below.
     const rows = [
@@ -81,6 +170,7 @@ function printSettingsTable(current) {
         ['caveman', current.cavemanDefault, [...CAVEMAN_DEFAULTS].join(' | ')],
         ['rtk', current.rtkDefault ? 'on' : 'off', 'on | off'],
         ['ponytail', current.ponytailDefault, [...PONYTAIL_DEFAULTS].join(' | ')],
+        ['diagnosis', readDiagSchedule(), 'manual | daily | weekly | monthly'],
     ];
     for (const l of textTable(['Setting', 'Current', 'Valid values'], rows, [false, false, false], 64)) {
         console.log(l);
@@ -91,7 +181,32 @@ async function runSettings() {
     const current = await storedProfile();
     printSettingsTable(current);
     let next;
-    if (profileFlagsGiven || currencyGiven) {
+    let nextDiag = readDiagSchedule();
+    if (diagScheduleFlag !== undefined)
+        nextDiag = diagScheduleFlag;
+    if (settingArg !== null) {
+        if (!SETTING_NAMES.includes(settingArg)) {
+            console.error(`[fail] Invalid setting: ${settingArg}. Valid: ${SETTING_NAMES.join(', ')}`);
+            closeRL();
+            process.exit(1);
+            return;
+        }
+        if (!tty()) {
+            console.log('\n  Single-setting jump needs a terminal.');
+            settingsUsage();
+            closeRL();
+            return;
+        }
+        const single = await runSingleSetting(settingArg, current, nextDiag);
+        if (single === null) {
+            closeRL();
+            process.exit(130);
+            return;
+        }
+        next = single.profile;
+        nextDiag = single.diag;
+    }
+    else if (profileFlagsGiven || currencyGiven || diagScheduleFlag !== undefined) {
         next = applyFlags(current);
     }
     else if (tty()) {
@@ -101,22 +216,30 @@ async function runSettings() {
             process.exit(130);
             return;
         }
+        const picked = await askDiagSchedule(nextDiag);
+        if (picked === null) {
+            closeRL();
+            process.exit(130);
+            return;
+        }
+        nextDiag = picked;
     }
     else {
         console.log('\n  No flags given and no TTY — nothing to change.');
-        console.log('  Usage: tersio settings [--combo-default off|medium|balanced|max] [--caveman-default off|lite|full|ultra|wenyan] [--rtk-default on|off] [--ponytail-default off|lite|full|ultra|review] [--currency USD|PHP|EUR|GBP|JPY|KRW|SGD|AUD|CAD|INR] [--dry-run]');
+        settingsUsage();
         closeRL();
         return;
     }
     if (dryRun) {
-        console.log(`\n  [dry-run] would set defaults: ${formatProfile(next)}`);
+        console.log(`\n  [dry-run] would set defaults: ${formatProfile(next)} · diagnosis=${nextDiag}`);
         closeRL();
         return;
     }
     await writePluginSettings(next, {});
-    console.log(`  Defaults: ${formatProfile(next)}`);
+    setDiagSchedule(nextDiag);
+    console.log(`  Defaults: ${formatProfile(next)} · diagnosis=${nextDiag}`);
     console.log('  Applies to fresh sessions only — anything persisted with /combo, /caveman, or /rtk wins.');
-    console.log('  Currency applies to usage/gain reports; --currency overrides it per run.');
+    console.log('  Currency applies to usage/dashboard reports; --currency overrides it per run.');
     closeRL();
 }
 export { runSettings };

package/cli/uninstall.js

@@ -56,8 +56,8 @@ async function removeUninstallTarget(target, shouldDryRun, recursive = true) {
 async function runUninstall(options = {}) {
     const shouldDryRun = options.dryRun ?? dryRun;
     const confirmed = (options.yes ?? yes) || shouldDryRun;
-    // Ponytail ships with Tersio's presets, so a full uninstall removes it too;
-    // --keep-ponytail opts out and reinstall always preserves it.
+    // Ponytail is bundled with Tersio's presets, so a full uninstall removes
+    // its copy too; --keep-ponytail opts out and reinstall always preserves it.
     const shouldRemovePonytail = options.removePonytail ?? (removePonytail || !keepPonytail);
     const shouldRemoveRtk = options.removeRtk ?? removeRtk;
     console.log('\n=== Tersio Uninstall ===\n');
@@ -135,8 +135,8 @@ async function runUninstall(options = {}) {
                 await writeConfigLines(configPath, lines, `  [write] Updated config.yml (removed ${before - lines.length} entries)`);
         }
     }
-    // Remove the Ponytail plugin package the installer added (dep, files,
-    // lock entry); the config.yml entry was filtered above.
+    // Remove the bundled Ponytail copy (dep entry exists only on
+    // pre-bundle installs); the config.yml entry was filtered above.
     if (shouldRemovePonytail) {
         const pluginsPkgPath = path.join(pluginsDir, 'package.json');
         await updateJsonFile(pluginsPkgPath, (data) => dropKey(data.dependencies, '@dietrichgebert/ponytail'), `would remove @dietrichgebert/ponytail from ${pluginsPkgPath}`, 'Removed @dietrichgebert/ponytail from plugins/package.json', shouldDryRun);

package/cli/update.js

@@ -4,7 +4,7 @@ import path from 'node:path';
 import { spawn } from 'node:child_process';
 import { BUN_BIN_DIR, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, dryRun, execP, parseJsonObject, verbose, } from './common.js';
 import { execNetwork } from './interactive.js';
-import { readTextIfExists } from '../extensions/lib/utils.js';
+import { readTextIfExists, tersioDataPath } from '../extensions/lib/utils.js';
 import { refreshPrices } from '../extensions/shared/pricing.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, httpsGet, normalizeRtkVersion, sha256Hex, } from '../extensions/lib/utils.js';
 const UPDATE_CHECK_TTL_MS = 6 * 60 * 60 * 1000;
@@ -39,7 +39,7 @@ async function latestPublishedVersion() {
 // (cached under OMP_PLUGINS_DIR) unless force skips the cache — an explicit
 // "check for updates" must never trust a stale cache.
 async function checkForUpdate(force = false) {
-    const cachePath = path.join(OMP_PLUGINS_DIR, 'tersio-update-check.json');
+    const cachePath = tersioDataPath('update-check.json', 'tersio-update-check.json');
     const cached = parseJsonObject(await readTextIfExists(cachePath));
     const cacheFresh = typeof cached?.lastCheck === 'number' && Date.now() - cached.lastCheck < UPDATE_CHECK_TTL_MS;
     if (!force && cacheFresh && cached?.latest)
@@ -68,20 +68,6 @@ async function settle(work, ms) {
         clearTimeout(timer);
     }
 }
-// Plain `npm view <spec> version` with no spinner, for background probes.
-async function npmViewVersion(spec, timeoutMs) {
-    try {
-        const exe = IS_WINDOWS ? process.env.ComSpec || 'cmd.exe' : 'npm';
-        const args = IS_WINDOWS
-            ? ['/d', '/s', '/c', 'npm', 'view', spec, 'version', '--prefer-online']
-            : ['view', spec, 'version', '--prefer-online'];
-        const r = await execP(exe, args, { timeout: timeoutMs, maxBuffer: 1024 * 1024, windowsHide: true, shell: false });
-        return r.stdout.trim() || null;
-    }
-    catch {
-        return null;
-    }
-}
 // Run a child with inherited stdio for live output. Used when the child
 // renders its own interactive UI (the delegated installer runs Clack
 // spinners), which a concurrent outer spinner would corrupt into stray bars.
@@ -100,20 +86,19 @@ async function probeUpdatePlan(cliLatest) {
     const rtkBin = path.join(BUN_BIN_DIR, RTK_BINARY_NAME);
     const ponytailPkg = path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'package.json');
     const ruleDest = path.join(OMP_AGENT_DIR, 'extensions', 'caveman-session', 'rule.md');
-    const [rtkLocal, rtkRelease, ruleLocalText, ruleRemoteText, ponytailLocalText, ponytailLatest] = await Promise.all([
+    const [rtkLocal, rtkRelease, ruleLocalText, ruleRemoteText, ponytailLocalText] = await Promise.all([
         settle(execP(rtkBin, ['--version'], { timeout: 5000 }).then((r) => normalizeRtkVersion(r.stdout.trim() || r.stderr.trim()) || null), 6000),
         settle(fetchJson(RTK_RELEASE_API).then((r) => normalizeRtkVersion(r.tag_name) || null), 4000),
         readTextIfExists(ruleDest),
         settle(httpsGet(CAVEMAN_REMOTE_RULE), 4000),
         readTextIfExists(ponytailPkg),
-        settle(npmViewVersion('@dietrichgebert/ponytail', 4000), 5000),
     ]);
     const shortHash = (text) => text === null ? null : sha256Hex(text).slice(0, 8);
     return {
         cli: cliLatest,
         rtk: [rtkLocal, rtkRelease],
         rule: [shortHash(ruleLocalText), shortHash(ruleRemoteText)],
-        ponytail: [ponytailLocalText ? parseJsonObject(ponytailLocalText)?.version ?? null : null, ponytailLatest],
+        ponytail: ponytailLocalText ? parseJsonObject(ponytailLocalText)?.version ?? null : null,
     };
 }
 // Every add-on prints its status: version jump when stale, "up to date"
@@ -136,7 +121,12 @@ function planLines(plan) {
     push('Tersio', PACKAGE_VERSION, plan.cli);
     push('RTK', plan.rtk[0], plan.rtk[1]);
     push('Caveman rule', plan.rule[0], plan.rule[1]);
-    push('Ponytail', plan.ponytail[0], plan.ponytail[1]);
+    if (plan.ponytail)
+        status.push(`Ponytail: ${plan.ponytail} (bundled with tersio)`);
+    else {
+        status.push('Ponytail: missing → bundled reinstall');
+        stale.push('Ponytail: missing → bundled reinstall');
+    }
     return { stale, status };
 }
 async function runLatestUpdate() {

package/cli/usage.js

@@ -132,7 +132,7 @@ function printReport(report) {
         return;
     }
     const t = report.tokens;
-    console.log(`  TOKENS  ${fmt(t.input)} in · ${fmt(t.output)} out · ${fmt(t.cacheRead)} cache read${t.cacheWrite > 0 ? ` · ${fmt(t.cacheWrite)} written` : ''}`);
+    console.log(`  TOKENS  ${fmt(t.input)} in · ${fmt(t.output)} out · ${fmt(t.cacheRead)} cache read · ${fmt(t.cacheWrite)} cache write`);
     console.log(`  COST    ${formatCurrency(report.usd, report.currency)}${report.priced ? '' : ' (includes default pricing)'} · ~${formatCurrency(report.savedUsd, report.currency)} cache-saved (est.) · ~${report.co2g.toFixed(1)}g CO2 (est.)`);
     const models = Object.entries(report.byModel).filter(([, b]) => b.input + b.output + b.cacheRead + b.cacheWrite > 0).sort((a, b) => (b[1].input + b[1].output) - (a[1].input + a[1].output)).slice(0, 8);
     if (models.length) {