@krtclcdy/tersio 2.18.0 → 2.20.0

package/README.md

@@ -105,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');
@@ -141,6 +147,13 @@ async function ensureExtensionInConfig(configPath, extensionPath, label, options
     const line = `  - ${normalizedPath}`;
     const raw = await readTextIfExists(configPath);
     let lines = (raw || '').split('\n');
+    // Drop legacy compiled twins (same dir/name, .js): previous installs
+    // registered them, and OMP must never load both copies. Match on the
+    // trailing path so absolute and relative entries are both caught.
+    if (normalizedPath.endsWith('.ts')) {
+        const legacyTail = `${normalizedPath.slice(0, -3)}.js`.split('/').slice(-2).join('/');
+        lines = lines.filter((l) => !l.trim().replace(/^\.\//, '').endsWith(legacyTail));
+    }
     if (lines.some((l) => l.includes(normalizedPath))) {
         debug(`${label} already in config.yml`);
         return false;
@@ -170,7 +183,12 @@ async function ensureExtensionAfterConfigEntry(configPath, extensionPath, afterP
     const normalizedAfterPath = afterPath.replace(/\\/g, '/');
     const line = `  - ${normalizedPath}`;
     const raw = await readTextIfExists(configPath);
-    const lines = (raw || '').split('\n');
+    let lines = (raw || '').split('\n');
+    // Same legacy-twin drop as ensureExtensionInConfig above.
+    if (normalizedPath.endsWith('.ts')) {
+        const legacyTail = `${normalizedPath.slice(0, -3)}.js`.split('/').slice(-2).join('/');
+        lines = lines.filter((l) => !l.trim().replace(/^\.\//, '').endsWith(legacyTail));
+    }
     const existingIndex = lines.findIndex((entry) => entry.includes(normalizedPath));
     const afterIndex = lines.findIndex((entry) => entry.includes(normalizedAfterPath));
     if (existingIndex !== -1 && afterIndex !== -1 && existingIndex === afterIndex + 1)
@@ -267,4 +285,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';
@@ -18,13 +19,13 @@ async function runDoctor() {
     // Ponytail
     const ponytailPkg = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'package.json');
     const ponytailExt = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
-    const cavemanIndex = path.join(extDir, 'caveman-session', 'index.js');
+    const cavemanIndex = path.join(extDir, 'caveman-session', 'index.ts');
     const cavemanRule = path.join(extDir, 'caveman-session', 'rule.md');
-    const rtkIndex = path.join(extDir, 'rtk-session', 'index.js');
-    const updaterIndex = path.join(extDir, 'ai-addons-updater', 'index.js');
-    const comboIndex = path.join(extDir, 'combo-toggle', 'index.js');
-    const tersioIndex = path.join(extDir, 'tersio-commands', 'index.js');
-    const modeReinforcement = path.join(extDir, 'shared', 'mode-reinforcement.js');
+    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.
@@ -32,7 +33,7 @@ async function runDoctor() {
         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.js')),
+        sharedStateText: readTextIfExists(path.join(extDir, 'shared', 'session-state.ts')),
         configText: readTextIfExists(configPath),
         ponytailPkgText: readTextIfExists(ponytailPkg),
         ponytailExtText: readTextIfExists(ponytailExt),
@@ -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,32 +3,34 @@ 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');
-const CAVEMAN_INDEX = path.join(EXT_DIR, 'caveman-session', 'index.js');
-const RTK_SESSION_INDEX = path.join(EXT_DIR, 'rtk-session', 'index.js');
-const UPDATER_INDEX = path.join(EXT_DIR, 'ai-addons-updater', 'index.js');
-const COMBO_TOGGLE_INDEX = path.join(EXT_DIR, 'combo-toggle', 'index.js');
-const TERSIO_COMMANDS_INDEX = path.join(EXT_DIR, 'tersio-commands', 'index.js');
-const MODE_REINFORCEMENT_INDEX = path.join(EXT_DIR, 'shared', 'mode-reinforcement.js');
-const SHARED_TYPES = path.join(EXT_DIR, 'shared', 'types.js');
-const LIB_UTILS = path.join(EXT_DIR, 'lib', 'utils.js');
-const SHARED_PLUGIN_SETTINGS = path.join(EXT_DIR, 'shared', 'plugin-settings.js');
-const SHARED_USAGE_LEDGER = path.join(EXT_DIR, 'shared', 'usage-ledger.js');
-const SHARED_PRICING = path.join(EXT_DIR, 'shared', 'pricing.js');
-const SHARED_CARBON = path.join(EXT_DIR, 'shared', 'carbon.js');
+const SHARED_SESSION_STATE = path.join(EXT_DIR, 'shared', 'session-state.ts');
+const CAVEMAN_INDEX = path.join(EXT_DIR, 'caveman-session', 'index.ts');
+const RTK_SESSION_INDEX = path.join(EXT_DIR, 'rtk-session', 'index.ts');
+const UPDATER_INDEX = path.join(EXT_DIR, 'ai-addons-updater', 'index.ts');
+const COMBO_TOGGLE_INDEX = path.join(EXT_DIR, 'combo-toggle', 'index.ts');
+const TERSIO_COMMANDS_INDEX = path.join(EXT_DIR, 'tersio-commands', 'index.ts');
+const MODE_REINFORCEMENT_INDEX = path.join(EXT_DIR, 'shared', 'mode-reinforcement.ts');
+const SHARED_TYPES = path.join(EXT_DIR, 'shared', 'types.ts');
+const LIB_UTILS = path.join(EXT_DIR, 'lib', 'utils.ts');
+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) {
@@ -373,27 +375,27 @@ async function stepSharedSessionState(extDir, options) {
     if (!options.quiet)
         console.log('  Shared files — sync session bridge');
     await copySources(extDir, [
-        [SHARED_SESSION_STATE, path.join('shared', 'session-state.js')],
-        [SHARED_TYPES, path.join('shared', 'types.js')],
-        [LIB_UTILS, path.join('lib', 'utils.js')],
-        [SHARED_PLUGIN_SETTINGS, path.join('shared', 'plugin-settings.js')],
-        [SHARED_USAGE_LEDGER, path.join('shared', 'usage-ledger.js')],
-        [SHARED_PRICING, path.join('shared', 'pricing.js')],
-        [SHARED_CARBON, path.join('shared', 'carbon.js')],
+        [SHARED_SESSION_STATE, path.join('shared', 'session-state.ts')],
+        [SHARED_TYPES, path.join('shared', 'types.ts')],
+        [LIB_UTILS, path.join('lib', 'utils.ts')],
+        [SHARED_PLUGIN_SETTINGS, path.join('shared', 'plugin-settings.ts')],
+        [SHARED_USAGE_LEDGER, path.join('shared', 'usage-ledger.ts')],
+        [SHARED_PRICING, path.join('shared', 'pricing.ts')],
+        [SHARED_CARBON, path.join('shared', 'carbon.ts')],
     ], 'shared/session-state.js', options);
 }
 async function stepModeReinforcement(extDir, ponytailExtPath, options) {
     if (!options.quiet)
         console.log('  Session helpers — sync shared files');
-    const dest = path.join(extDir, 'shared', 'mode-reinforcement.js');
-    if (!await copySources(extDir, [[MODE_REINFORCEMENT_INDEX, path.join('shared', 'mode-reinforcement.js')]], 'shared/mode-reinforcement.js', options))
+    const dest = path.join(extDir, 'shared', 'mode-reinforcement.ts');
+    if (!await copySources(extDir, [[MODE_REINFORCEMENT_INDEX, path.join('shared', 'mode-reinforcement.ts')]], 'shared/mode-reinforcement.ts', options))
         return;
     await ensureExtensionAfterConfigEntry(path.join(path.dirname(extDir), 'config.yml'), dest, ponytailExtPath, 'mode reinforcement', options);
 }
 async function stepRtkSession(extDir, options) {
     if (!options.quiet)
         console.log('  RTK session — install session mode');
-    await copySources(extDir, [[RTK_SESSION_INDEX, path.join('rtk-session', 'index.js')]], 'rtk-session/index.js', options);
+    await copySources(extDir, [[RTK_SESSION_INDEX, path.join('rtk-session', 'index.ts')]], 'rtk-session/index.ts', options);
 }
 // One rule fetch serves the install; dry runs stay offline
 // and fall back to the bundled rule to preview its destination.
@@ -425,65 +427,26 @@ async function stepCaveman(extDir, rule, options) {
     else {
         await writeIfChanged(ruleDest, rule, options);
     }
-    await copySources(extDir, [[CAVEMAN_INDEX, path.join('caveman-session', 'index.js')]], 'caveman-session/index.js', options);
+    await copySources(extDir, [[CAVEMAN_INDEX, path.join('caveman-session', 'index.ts')]], 'caveman-session/index.ts', options);
 }
 async function stepTersioCommands(extDir, options) {
     if (!options.quiet)
         console.log('  Tersio commands — install /tersio root command');
-    await copySources(extDir, [[TERSIO_COMMANDS_INDEX, path.join('tersio-commands', 'index.js')]], 'tersio-commands/index.js', options);
+    await copySources(extDir, [[TERSIO_COMMANDS_INDEX, path.join('tersio-commands', 'index.ts')]], 'tersio-commands/index.ts', options);
 }
 async function stepUpdater(extDir, options) {
-    await copySources(extDir, [[UPDATER_INDEX, path.join('ai-addons-updater', 'index.js')]], 'ai-addons-updater/index.js', options);
+    await copySources(extDir, [[UPDATER_INDEX, path.join('ai-addons-updater', 'index.ts')]], 'ai-addons-updater/index.ts', options);
 }
 async function stepCombo(extDir, options) {
     if (!options.quiet)
         console.log('  Combo — install preset switch');
-    const dest = path.join(extDir, 'combo-toggle', 'index.js');
-    if (!await copySources(extDir, [[COMBO_TOGGLE_INDEX, path.join('combo-toggle', 'index.js')]], 'combo-toggle/index.js', options))
+    const dest = path.join(extDir, 'combo-toggle', 'index.ts');
+    if (!await copySources(extDir, [[COMBO_TOGGLE_INDEX, path.join('combo-toggle', 'index.ts')]], 'combo-toggle/index.ts', options))
         return;
     // Auto-register combo in config.yml
     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 };