@krtclcdy/tersio 2.17.0 → 2.19.0

package/README.md

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

package/cli/common.js

@@ -5,6 +5,7 @@ import path from 'node:path';
 import { promisify } from 'node:util';
 import { createRequire } from 'node:module';
 import { readTextIfExists } from '../extensions/lib/utils.js';
+import { parseCurrencyFlag, readStoredCurrency } from './currency.js';
 const IS_WINDOWS = process.platform === 'win32';
 const RTK_BINARY_NAME = IS_WINDOWS ? 'rtk.exe' : 'rtk';
 const HOME = process.env.HOME || process.env.USERPROFILE || '';
@@ -46,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, version: true, help: true };
+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 args = process.argv.slice(2);
 const commandArg = args.find((arg) => !arg.startsWith('-'));
 const command = commandArg?.toLowerCase() || null;
@@ -64,9 +65,14 @@ const doctor = command === 'doctor' || args.includes('--doctor');
 const usage = command === 'usage' || args.includes('--usage');
 const gain = command === 'gain';
 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
+// plugin default (tersio settings), then USD.
+const currency = parseCurrencyFlag(flagValue('--currency')) ?? readStoredCurrency();
+const currencyGiven = flagValue('--currency') !== undefined;
 const uninstall = command === 'uninstall' || args.includes('--uninstall');
 const removePonytail = args.includes('--remove-ponytail');
 const keepPonytail = args.includes('--keep-ponytail');
@@ -267,4 +273,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, dashboardPort, dashboardOpen, dashboardExport, 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, 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, };

package/cli/currency.js

@@ -0,0 +1,102 @@
+// 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
+// frankfurter figures when reachable, the CLI always uses the snapshot.
+import { existsSync, readFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const CURRENCY_CODES = [
+    'USD',
+    'PHP',
+    'EUR',
+    'GBP',
+    'JPY',
+    'KRW',
+    'SGD',
+    'AUD',
+    'CAD',
+    'INR',
+];
+const DEFAULT_CURRENCY = 'USD';
+function isCurrencyCode(value) {
+    return CURRENCY_CODES.includes(value);
+}
+// --currency flag parsing: undefined when absent, exits on invalid input.
+function parseCurrencyFlag(raw) {
+    if (raw === undefined)
+        return undefined;
+    const v = raw.trim().toUpperCase();
+    if (!isCurrencyCode(v)) {
+        console.error(`[fail] Invalid --currency: ${raw}. Valid: ${CURRENCY_CODES.join(', ')}`);
+        process.exit(1);
+    }
+    return v;
+}
+// Stored default from the omp plugin lock file (written by tersio settings);
+// USD when missing, corrupt, or holding an unknown code. Sync so flag
+// parsing in cli/common.ts can fall back to it at startup.
+function readStoredCurrency() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    const lock = path.join(home, '.omp', 'plugins', 'omp-plugins.lock.json');
+    if (!existsSync(lock))
+        return DEFAULT_CURRENCY;
+    try {
+        const parsed = JSON.parse(readFileSync(lock, 'utf8'));
+        if (!parsed || typeof parsed !== 'object' || !('settings' in parsed))
+            return DEFAULT_CURRENCY;
+        const entry = parsed.settings?.['@krtclcdy/tersio'];
+        if (!entry || typeof entry !== 'object')
+            return DEFAULT_CURRENCY;
+        const raw = entry.currency;
+        return typeof raw === 'string' && isCurrencyCode(raw.trim().toUpperCase())
+            ? raw.trim().toUpperCase()
+            : DEFAULT_CURRENCY;
+    }
+    catch {
+        return DEFAULT_CURRENCY;
+    }
+}
+const CURRENCY_META = {
+    USD: { symbol: '$', decimals: 2 },
+    PHP: { symbol: '₱', decimals: 2 },
+    EUR: { symbol: '€', decimals: 2 },
+    GBP: { symbol: '£', decimals: 2 },
+    JPY: { symbol: '¥', decimals: 0 },
+    KRW: { symbol: '₩', decimals: 0 },
+    SGD: { symbol: 'S$', decimals: 2 },
+    AUD: { symbol: 'A$', decimals: 2 },
+    CAD: { symbol: 'C$', decimals: 2 },
+    INR: { symbol: '₹', decimals: 2 },
+};
+const FX_SNAPSHOT_RATES = {
+    USD: 1,
+    PHP: 58.7,
+    EUR: 0.92,
+    GBP: 0.79,
+    JPY: 149.8,
+    KRW: 1385,
+    SGD: 1.34,
+    AUD: 1.52,
+    CAD: 1.37,
+    INR: 88.2,
+};
+function decimalsFor(amount, base) {
+    const a = Math.abs(amount);
+    if (a >= 0.1 || a === 0)
+        return base;
+    if (a >= 0.001)
+        return Math.max(base, 4);
+    if (a >= 0.00001)
+        return Math.max(base, 6);
+    return Math.max(base, 8);
+}
+function convertUsd(usd, currency) {
+    return usd * FX_SNAPSHOT_RATES[currency];
+}
+function formatCurrency(usd, currency) {
+    const meta = CURRENCY_META[currency];
+    const amount = convertUsd(usd, currency);
+    const d = decimalsFor(amount, meta.decimals);
+    return meta.symbol + amount.toLocaleString('en-US', { minimumFractionDigits: d, maximumFractionDigits: d });
+}
+export { CURRENCY_CODES, DEFAULT_CURRENCY, convertUsd, formatCurrency, isCurrencyCode, parseCurrencyFlag, readStoredCurrency, };

package/cli/dashboard.js

@@ -10,6 +10,8 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { clearUsageLedger, markReset, readUsage } from '../extensions/shared/usage-ledger.js';
 import { summarizeUsage } from './usage.js';
+import { isCurrencyCode } from './currency.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');
@@ -26,6 +28,29 @@ async function faviconDataUri() {
 function dataJson() {
     return JSON.stringify(summarizeUsage(readUsage()));
 }
+// 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
+// feeds data.json and `tersio usage` on the next run.
+async function saveDashboardCurrency(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    const code = raw.trim().toUpperCase();
+    if (!isCurrencyCode(code))
+        return null;
+    const profile = await storedProfile();
+    profile.currency = code;
+    await writePluginSettings(profile, {});
+    return code;
+}
+function readBody(req) {
+    return new Promise((resolve) => {
+        let body = '';
+        req.on('data', (chunk) => { body += String(chunk); });
+        req.on('end', () => { resolve(body); });
+        req.on('error', () => { resolve(''); });
+    });
+}
 function openBrowser(url) {
     const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
     spawn(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
@@ -38,10 +63,18 @@ async function runDashboard(options) {
         // 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("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');
@@ -57,6 +90,25 @@ async function runDashboard(options) {
             res.end(JSON.stringify({ ok: true, rows }));
             return;
         }
+        if (req.url === '/currency' && req.method === 'POST') {
+            let code = null;
+            try {
+                code = JSON.parse(await readBody(req)).currency ?? null;
+            }
+            catch {
+                code = null;
+            }
+            const saved = await saveDashboardCurrency(code);
+            if (saved === null) {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, error: 'unknown currency' }));
+            }
+            else {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true, currency: saved }));
+            }
+            return;
+        }
         if (req.url === '/data.json') {
             res.writeHead(200, { 'Content-Type': 'application/json' });
             res.end(dataJson());
@@ -100,4 +152,4 @@ async function runDashboard(options) {
             openBrowser(url);
     });
 }
-export { runDashboard };
+export { runDashboard, saveDashboardCurrency };

package/cli/doctor.js

@@ -4,6 +4,7 @@ import path from 'node:path';
 import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, execP, parseJsonObject, relTime, } from './common.js';
 import { 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 { readTextIfExists } from '../extensions/lib/utils.js';
@@ -136,6 +137,7 @@ async function runDoctor() {
     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` : ''}`);

package/cli/install.js

@@ -3,17 +3,19 @@ import { promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { BUN_BIN_DIR, CAVEMAN_DEFAULTS, COMBO_PRESET_MODES, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, PONYTAIL_DEFAULTS, RTK_BINARY_NAME, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
+import { BUN_BIN_DIR, COMBO_PRESET_MODES, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
 import { askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
 import { printWelcome } from './banner.js';
 import { checkForUpdate, runLatestUpdate } from './update.js';
 import { runUninstall } from './uninstall.js';
 import { runDoctor } from './doctor.js';
 import { runReset } from './reset.js';
+import { runSettings } from './settings.js';
 import { runUsage } from './usage.js';
 import { runDashboard } from './dashboard.js';
 import { wireRtkOmp } from './rtk-wiring.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, parseChecksum, readTextIfExists, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
+import { storedProfile, writePluginSettings } from './profile.js';
 // Paths to extension source files (relative to this script)
 const EXT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'extensions');
 const SHARED_SESSION_STATE = path.join(EXT_DIR, 'shared', 'session-state.js');
@@ -445,45 +447,6 @@ async function stepCombo(extDir, options) {
     const configPath = path.join(path.dirname(extDir), 'config.yml');
     await ensureExtensionInConfig(configPath, dest, 'combo', options);
 }
-function defaultProfile() {
-    return {
-        comboDefault: 'off',
-        cavemanDefault: 'off',
-        rtkDefault: false,
-        ponytailDefault: 'off',
-    };
-}
-async function storedProfile() {
-    const base = defaultProfile();
-    const raw = await readTextIfExists(path.join(OMP_PLUGINS_DIR, 'omp-plugins.lock.json'));
-    if (!raw)
-        return base;
-    let stored;
-    try {
-        const parsed = JSON.parse(raw);
-        if (!parsed || typeof parsed !== 'object' || !('settings' in parsed))
-            return base;
-        const settings = parsed.settings;
-        if (!settings || typeof settings !== 'object' || !(PACKAGE_NAME in settings))
-            return base;
-        const entry = settings[PACKAGE_NAME];
-        if (!entry || typeof entry !== 'object')
-            return base;
-        stored = entry;
-    }
-    catch {
-        return base;
-    }
-    if (typeof stored.comboDefault === 'string' && stored.comboDefault in COMBO_PRESET_MODES)
-        base.comboDefault = stored.comboDefault;
-    if (typeof stored.cavemanDefault === 'string' && CAVEMAN_DEFAULTS.has(stored.cavemanDefault))
-        base.cavemanDefault = stored.cavemanDefault;
-    if (typeof stored.rtkDefault === 'boolean')
-        base.rtkDefault = stored.rtkDefault;
-    if (typeof stored.ponytailDefault === 'string' && PONYTAIL_DEFAULTS.has(stored.ponytailDefault))
-        base.ponytailDefault = stored.ponytailDefault;
-    return base;
-}
 async function resolveProfile(forceReinstall = false, opts = {}) {
     // Seed from the lock file so flag-less update/reinstall runs keep the
     // user's configured defaults instead of resetting them to off.
@@ -523,39 +486,6 @@ async function resolveProfile(forceReinstall = false, opts = {}) {
         console.log(`  Defaults: combo=${profile.comboDefault} (caveman=${profile.cavemanDefault} · rtk=${profile.rtkDefault ? 'on' : 'off'} · ponytail=${profile.ponytailDefault})`);
     return profile;
 }
-// Persist the profile as omp plugin settings so `omp plugin config get`
-// reflects the choice and the extensions pick it up on session start.
-async function writePluginSettings(profile, options) {
-    const pluginsDir = OMP_PLUGINS_DIR;
-    const lockPath = path.join(pluginsDir, 'omp-plugins.lock.json');
-    let config = {};
-    const existing = await readTextIfExists(lockPath);
-    if (existing) {
-        try {
-            config = JSON.parse(existing);
-        }
-        catch {
-            config = {};
-        }
-    }
-    config.plugins = config.plugins || {};
-    config.settings = config.settings || {};
-    config.settings[PACKAGE_NAME] = {
-        ...(config.settings[PACKAGE_NAME] || {}),
-        comboDefault: profile.comboDefault,
-        cavemanDefault: profile.cavemanDefault,
-        rtkDefault: profile.rtkDefault,
-        ponytailDefault: profile.ponytailDefault,
-    };
-    if (options.dryRun) {
-        if (verbose && !options.quiet)
-            console.log(`  [dry-run] would write plugin settings (${PACKAGE_NAME}) to ${lockPath}`);
-        return;
-    }
-    await fs.mkdir(pluginsDir, { recursive: true });
-    await fs.writeFile(lockPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
-    console.log(`  [write] Plugin settings in ${lockPath}`);
-}
 let updatePromptDone = false;
 // Bare `tersio` at a terminal is a command picker, not an install run:
 // update offer first (when pending), then a Clack menu over every command.
@@ -585,6 +515,7 @@ async function runCommandMenu() {
         { value: 'usage', label: 'Usage', hint: 'token usage and savings report' },
         { value: 'gain', label: 'Gain 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' },
     ], 'install');
     if (choice.status !== 'selected') {
@@ -636,6 +567,9 @@ async function runCommandMenu() {
             await runReset();
             closeRL();
             break;
+        case 'settings':
+            await runSettings();
+            break;
         case 'uninstall':
             await runUninstall();
             closeRL();

package/cli/profile.js

@@ -0,0 +1,92 @@
+// cli/profile.ts — session-start defaults profile (combo/caveman/rtk/ponytail)
+// plus the display-currency default for usage/gain 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';
+import path from 'node:path';
+import { CAVEMAN_DEFAULTS, COMBO_PRESET_MODES, OMP_PLUGINS_DIR, PACKAGE_NAME, PONYTAIL_DEFAULTS, verbose, } from './common.js';
+import { DEFAULT_CURRENCY, isCurrencyCode } from './currency.js';
+import { readTextIfExists } from '../extensions/lib/utils.js';
+function defaultProfile() {
+    return {
+        comboDefault: 'off',
+        cavemanDefault: 'off',
+        rtkDefault: false,
+        ponytailDefault: 'off',
+        currency: DEFAULT_CURRENCY,
+    };
+}
+// Stored profile from the live lock file: update/reinstall runs without flags
+// or prompts must preserve the user's choice, never reset it to off.
+async function storedProfile() {
+    const base = defaultProfile();
+    const raw = await readTextIfExists(path.join(OMP_PLUGINS_DIR, 'omp-plugins.lock.json'));
+    if (!raw)
+        return base;
+    let stored;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || !('settings' in parsed))
+            return base;
+        const settings = parsed.settings;
+        if (!settings || typeof settings !== 'object' || !(PACKAGE_NAME in settings))
+            return base;
+        const entry = settings[PACKAGE_NAME];
+        if (!entry || typeof entry !== 'object')
+            return base;
+        stored = entry;
+    }
+    catch {
+        return base;
+    }
+    if (typeof stored.comboDefault === 'string' && stored.comboDefault in COMBO_PRESET_MODES)
+        base.comboDefault = stored.comboDefault;
+    if (typeof stored.cavemanDefault === 'string' && CAVEMAN_DEFAULTS.has(stored.cavemanDefault))
+        base.cavemanDefault = stored.cavemanDefault;
+    if (typeof stored.rtkDefault === 'boolean')
+        base.rtkDefault = stored.rtkDefault;
+    if (typeof stored.ponytailDefault === 'string' && PONYTAIL_DEFAULTS.has(stored.ponytailDefault))
+        base.ponytailDefault = stored.ponytailDefault;
+    if (typeof stored.currency === 'string' && isCurrencyCode(stored.currency.trim().toUpperCase())) {
+        base.currency = stored.currency.trim().toUpperCase();
+    }
+    return base;
+}
+// Persist the profile as omp plugin settings so `omp plugin config get`
+// reflects the choice and the extensions pick it up on session start.
+async function writePluginSettings(profile, options) {
+    const pluginsDir = OMP_PLUGINS_DIR;
+    const lockPath = path.join(pluginsDir, 'omp-plugins.lock.json');
+    let config = {};
+    const existing = await readTextIfExists(lockPath);
+    if (existing) {
+        try {
+            config = JSON.parse(existing);
+        }
+        catch {
+            config = {};
+        }
+    }
+    config.plugins = config.plugins || {};
+    config.settings = config.settings || {};
+    config.settings[PACKAGE_NAME] = {
+        ...(config.settings[PACKAGE_NAME] || {}),
+        comboDefault: profile.comboDefault,
+        cavemanDefault: profile.cavemanDefault,
+        rtkDefault: profile.rtkDefault,
+        ponytailDefault: profile.ponytailDefault,
+        currency: profile.currency,
+    };
+    if (options.dryRun) {
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would write plugin settings (${PACKAGE_NAME}) to ${lockPath}`);
+        return;
+    }
+    await fs.mkdir(pluginsDir, { recursive: true });
+    await fs.writeFile(lockPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    console.log(`  [write] Plugin settings in ${lockPath}`);
+}
+function formatProfile(profile) {
+    return `combo=${profile.comboDefault} (caveman=${profile.cavemanDefault} · rtk=${profile.rtkDefault ? 'on' : 'off'} · ponytail=${profile.ponytailDefault}) · currency=${profile.currency}`;
+}
+export { defaultProfile, formatProfile, storedProfile, writePluginSettings };

package/cli/reset.js

@@ -7,13 +7,14 @@ import { cancel as clackCancel, confirm as clackConfirm } from '@clack/prompts';
 import { dryRun, yes } from './common.js';
 import { ask, closeRL, tty } from './interactive.js';
 import { clearUsageLedger, importSessionTokens, ledgerPath, markReset, readUsage, sessionsDir } from '../extensions/shared/usage-ledger.js';
+import { clearUsageDb, usageDbPath } from '../extensions/shared/usage-store.js';
 import { readRtkGain, rtkDbPath } from '../extensions/shared/rtk-gain.js';
 async function runReset() {
     console.log('\n=== Tersio Reset ===\n');
     const rows = readUsage().length;
     const sessions = importSessionTokens();
     const rtk = readRtkGain(1);
-    console.log(`Will clear: ${rows} usage ledger rows · ${ledgerPath()}`);
+    console.log(`Will clear: ${rows} usage ledger rows · ${ledgerPath()} + usage.db ${usageDbPath()}`);
     console.log(`Will hide (view-level watermark): session-derived statistics (${sessions.messages} messages) · RTK metered rows (${rtk.commands})`);
     console.log(`Left intact on disk: sessions ${sessionsDir()}, rtk ${rtkDbPath()}`);
     if (dryRun) {
@@ -49,8 +50,9 @@ async function runReset() {
         }
     }
     const cleared = clearUsageLedger();
+    const dbCleared = clearUsageDb();
     const ts = markReset();
-    console.log(`[ok] reset — removed ${cleared} usage rows; statistics view starts at ${new Date(ts).toISOString()}`);
+    console.log(`[ok] reset — removed ${cleared} usage rows${dbCleared ? ' + usage.db' : ''}; statistics view starts at ${new Date(ts).toISOString()}`);
     return true;
 }
 export { runReset };