@krtclcdy/tersio 2.10.0 → 2.12.0

package/README.md

@@ -97,16 +97,17 @@ Break-even math, balanced preset (caveman full + rtk + ponytail): `⌈overhead
 
 | Command | Purpose |
 |---|---|
-| `tersio install` | Install (user scope by default; `--scope project\|both` for more) |
+| `tersio install` | Install (user scope: all OMP sessions) |
 | `tersio update` | Refresh the CLI, extensions, and add-ons (RTK binary, Caveman rule, Ponytail) |
 | `tersio reinstall` | Fresh install, preserving the Ponytail package |
 | `tersio doctor` | Check OMP, extension, Ponytail, and RTK health |
 | `tersio usage` | Ledger-backed usage + savings report |
 | `tersio gain` | Open the gain dashboard (`--open`, `--export <file>`, `--port <n>`; serves localhost only) |
+| `tersio reset` | Clear tersio statistics (usage ledger; `--dry-run`, `--yes`) — sessions and RTK history stay intact |
 | `tersio uninstall` | Remove extensions, registration, and the Ponytail plugin (`--keep-ponytail` keeps Ponytail; `--remove-rtk` also removes the RTK binary) |
 | `tersio version` | Print version |
 
-Flags: `--dry-run`, `--yes`/`-y`, `--verbose`, `--scope`, `--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`. Legacy `--doctor` / `--uninstall` forms still work.
 
 ## ⌨️ Commands reference
 

package/cli/banner.js

@@ -1,4 +1,4 @@
-// cli/banner.ts — mini pixel-scissor welcome (16x10 px -> 5 half-block rows).
+// cli/banner.ts — mini pixel-scissor welcome (16x12 px -> 6 half-block rows).
 // OMP-style launch moment for interactive runs: clack intro + note box.
 // TTY-only and skipped on --dry-run, so piped output stays byte-identical.
 import { intro as clackIntro, note as clackNote } from '@clack/prompts';
@@ -18,6 +18,8 @@ const GRID = [
     '..LL.LL...RR.RR.',
     '.LL...LL.RR...RR',
     '..LL.LL...RR.RR.',
+    '..LLLLL...RRRRR.',
+    '....L.......R...',
 ];
 // [truecolor rgb, ansi256] per class. Left ring red, right ring yellow.
 const PALETTE = {
@@ -55,7 +57,7 @@ function paint(ka, kb, tier) {
         return `${fg(ka)}▀\x1b[0m`;
     return `${fg(kb)}▄\x1b[0m`;
 }
-// Five 16-wide rows. Pure: unit-testable without a TTY.
+// Six 16-wide rows. Pure: unit-testable without a TTY.
 function bannerLines(tier = bannerTier()) {
     const out = [];
     for (let r = 0; r < GRID.length; r += 2) {
@@ -77,6 +79,6 @@ function printWelcome() {
         return;
     shown = true;
     clackIntro(`✂ tersio v${PACKAGE_VERSION}`);
-    clackNote(`${bannerLines().join('\n')}\n\n  /tersio combo medium   toggle all three\n  /tersio caveman full    terse replies\n  /tersio rtk on          compact shell output`, 'cut token bloat');
+    clackNote(`${bannerLines().join('\n')}\n\n  tersio install   set up add-ons\n  tersio update    refresh CLI + add-ons\n  tersio doctor    verify the install`, 'cut token bloat');
 }
 export { bannerLines, bannerTier, printWelcome };

package/cli/common.js

@@ -46,9 +46,9 @@ 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, version: true, help: true };
+const COMMANDS = { install: true, update: true, reinstall: true, doctor: true, uninstall: true, usage: true, gain: true, reset: true, version: true, help: true };
 const args = process.argv.slice(2);
-const commandArg = args.find((arg, index) => !arg.startsWith('-') && args[index - 1] !== '--scope');
+const commandArg = args.find((arg) => !arg.startsWith('-'));
 const command = commandArg?.toLowerCase() || null;
 const unknownCommand = command !== null && !COMMANDS[command];
 const install = command === 'install';
@@ -63,6 +63,7 @@ const verbose = args.includes('--verbose');
 const doctor = command === 'doctor' || args.includes('--doctor');
 const usage = command === 'usage' || args.includes('--usage');
 const gain = command === 'gain';
+const reset = command === 'reset';
 const dashboardPort = Number.parseInt(flagValue('--port') ?? '', 10) || 0;
 const dashboardOpen = args.includes('--open');
 const dashboardExport = flagValue('--export') ?? null;
@@ -70,7 +71,13 @@ const uninstall = command === 'uninstall' || args.includes('--uninstall');
 const removePonytail = args.includes('--remove-ponytail');
 const keepPonytail = args.includes('--keep-ponytail');
 const removeRtk = args.includes('--remove-rtk');
-const scopeFlag = flagValue('--scope')?.toLowerCase() ?? null;
+// Project scope was removed: tersio installs user-level (all OMP sessions)
+// only. A bare `--scope user` still parses (old scripts); anything else fails.
+const legacyScope = flagValue('--scope')?.toLowerCase() ?? null;
+if (legacyScope !== null && legacyScope !== 'user') {
+    console.error(`[fail] Invalid --scope: ${legacyScope}. Project scope was removed; tersio installs user-level only.`);
+    process.exit(1);
+}
 // --- Profile selection (session-start mode defaults) ---
 const comboDefaultFlag = parseEnum(flagValue('--combo-default'), COMBO_DEFAULTS, '--combo-default');
 const cavemanDefaultFlag = parseEnum(flagValue('--caveman-default'), CAVEMAN_DEFAULTS, '--caveman-default');
@@ -238,7 +245,6 @@ async function readPluginsPackage(pkgPath) {
     const pkg = parseJsonObject(await readTextIfExists(pkgPath)) ?? {};
     return { ...pkg, name: pkg.name || 'omp-plugins', private: true, dependencies: pkg.dependencies || {} };
 }
-const SCOPE_MAP = { user: '1', project: '2', both: '3' };
 function relTime(ageMs) {
     const mins = Math.floor(ageMs / 60000);
     if (mins < 1)
@@ -254,4 +260,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, dashboardPort, dashboardOpen, dashboardExport, removePonytail, keepPonytail, removeRtk, scopeFlag, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, profileFlagsGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, ensureExtensionAfterConfigEntry, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, SCOPE_MAP, 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, 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, };

package/cli/dashboard.js

@@ -8,7 +8,7 @@ import { promises as fs } from 'node:fs';
 import http from 'node:http';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { readUsage } from '../extensions/shared/usage-ledger.js';
+import { clearUsageLedger, readUsage } from '../extensions/shared/usage-ledger.js';
 import { summarizeUsage } from './usage.js';
 import { withInteractiveSpinner } from './interactive.js';
 const DASH_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'dashboard');
@@ -50,6 +50,12 @@ async function runDashboard(options) {
     }
     const html = await withInteractiveSpinner('Loading dashboard template', () => readSegment(TEMPLATE));
     const server = http.createServer(async (req, res) => {
+        if (req.url === '/reset' && req.method === 'POST') {
+            const rows = clearUsageLedger();
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, rows }));
+            return;
+        }
         if (req.url === '/data.json') {
             res.writeHead(200, { 'Content-Type': 'application/json' });
             res.end(dataJson());

package/cli/doctor.js

@@ -3,7 +3,8 @@ import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { BUN_BIN_DIR, HOME, 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 } from '../extensions/shared/usage-ledger.js';
+import { ledgerPath, readUsage, sessionsDir } from '../extensions/shared/usage-ledger.js';
+import { readRtkGain, rtkDbPath } from '../extensions/shared/rtk-gain.js';
 import { checkForUpdate } from './update.js';
 import { readTextIfExists } from '../extensions/lib/utils.js';
 async function runDoctor() {
@@ -133,6 +134,12 @@ async function runDoctor() {
     section('Usage');
     const usageRows = readUsage();
     check('Usage ledger', usageRows.length > 0, usageRows.length ? `${usageRows.length} rows · ${ledgerPath()}` : ledgerPath());
+    section('Records');
+    console.log(`  Usage ledger (tersio-owned, tersio reset clears): ${ledgerPath()} · ${usageRows.length} rows`);
+    console.log(`  Session transcripts (host-owned, never touched): ${sessionsDir()}`);
+    const rtkDb = rtkDbPath();
+    const rtk = readRtkGain();
+    console.log(`  RTK history (rtk-owned, never touched): ${rtkDb}${rtk.commands ? ` · ${rtk.commands} commands` : ''}`);
     section('Add-ons');
     const ruleAge = ruleMtime ? `updated ${relTime(Date.now() - ruleMtime.mtimeMs)}` : '';
     check('Caveman rule', cavemanRuleText !== null, ruleAge);

package/cli/install.js

@@ -3,12 +3,13 @@ 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, COMBO_PRESET_MODES, EXTENSIONS_KEY_RE, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, SCOPE_MAP, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, scopeFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
-import { ask, askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
+import { BUN_BIN_DIR, COMBO_PRESET_MODES, EXTENSIONS_KEY_RE, HOME, 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 { runUsage } from './usage.js';
 import { runDashboard } from './dashboard.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, parseChecksum, readTextIfExists, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
@@ -24,6 +25,9 @@ const MODE_REINFORCEMENT_INDEX = path.join(EXT_DIR, 'shared', 'mode-reinforcemen
 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 PONYTAIL_GITHUB_SPEC = 'github:DietrichGebert/ponytail';
 const PONYTAIL_NPM_SPEC = '@dietrichgebert/ponytail@latest';
 async function stepPonytail(pluginsDir, userDir, options) {
@@ -344,6 +348,9 @@ async function stepSharedSessionState(extDir, options) {
         [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.js', options);
 }
 async function stepModeReinforcement(extDir, ponytailExtPath, options) {
@@ -357,7 +364,7 @@ async function stepRtkSession(extDir, options) {
     console.log('\n[4/8] Installing RTK session extension...');
     await copySources(extDir, [[RTK_SESSION_INDEX, path.join('rtk-session', 'index.js')]], 'rtk-session/index.js', options);
 }
-// One rule fetch serves user- and project-level installs; dry runs stay offline
+// One rule fetch serves the install; dry runs stay offline
 // and fall back to the bundled rule to preview its destination.
 async function fetchCavemanRule(options) {
     if (options.dryRun)
@@ -412,52 +419,12 @@ function defaultProfile() {
         ponytailDefault: 'off',
     };
 }
-// Determine install scope: reinstall > flag > non-interactive default > prompt.
-async function resolveScope() {
-    if (reinstall) {
-        console.log('  Scope: user (reinstall)');
-        return '1';
-    }
-    if (scopeFlag) {
-        const scope = SCOPE_MAP[scopeFlag];
-        if (!scope) {
-            console.log(`  [fail] Invalid --scope: ${scopeFlag}. Use: user, project, both`);
-            closeRL();
-            process.exit(1);
-        }
-        console.log(`  Scope: ${scopeFlag}`);
-        return scope;
-    }
-    if (install || yes) {
-        console.log(`  Scope: user (${install ? 'install default' : '--scope omitted, defaulting to user with --yes'})`);
-        return '1';
-    }
-    if (tty()) {
-        const choice = await askInteractiveChoice('Install scope', [
-            { value: '1', label: 'User-level', hint: 'all OMP sessions' },
-            { value: '2', label: 'Project-level', hint: 'this repo only' },
-            { value: '3', label: 'Both' },
-        ], '1');
-        if (choice.status === 'selected')
-            return choice.value;
-        closeRL();
-        process.exit(130);
-    }
-    console.log('\nInstall scope:');
-    console.log('  1) User-level (all OMP sessions)');
-    console.log('  2) Project-level (this repo only)');
-    console.log('  3) Both');
-    while (true) {
-        const answer = (await ask('\nChoose [1-3] (default 1): ')).trim() || '1';
-        if (answer === '1' || answer === '2' || answer === '3')
-            return answer;
-        console.log(`  [fail] Invalid scope: ${answer}. Choose 1, 2, or 3.`);
-    }
-}
+// Install is always user-level (all OMP sessions). Project scope was removed:
+// session extensions must live in ~/.omp/agent/extensions to load.
 async function resolveProfile() {
     const profile = defaultProfile();
     // Single interactive prompt: the Combo preset implies all three modes.
-    // Numbered menu, same pattern as the scope prompt — no typing preset names.
+    // Numbered menu — no typing preset names.
     // Only for a real user at a terminal, only when no default flags were
     // given, and never for --apply-update runs.
     if (tty() && !profileFlagsGiven && !applyUpdate && (install || reinstall)) {
@@ -567,12 +534,12 @@ async function runCommandMenu() {
     }
     updatePromptDone = true;
     const choice = await askInteractiveChoice('Tersio — what next?', [
-        { value: 'install', label: 'Install add-ons', hint: 'user/project scope + combo defaults' },
-        { value: 'check', label: 'Check for updates', hint: 'compare installed vs latest release' },
-        { value: 'update', label: 'Update everything', hint: 'CLI plus all ai-addons' },
+        { value: 'install', label: 'Install add-ons', hint: 'user scope + combo defaults' },
+        { value: 'check', label: 'Check for updates', hint: 'check CLI version, then update ai-addons' },
         { 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: 'reset', label: 'Reset statistics', hint: 'clear the tersio usage ledger' },
         { value: 'uninstall', label: 'Uninstall', hint: 'remove tersio' },
     ], 'install');
     if (choice.status !== 'selected') {
@@ -584,6 +551,8 @@ async function runCommandMenu() {
             await runInstall();
             break;
         case 'check': {
+            // One bound flow: report the CLI version, then offer the ai-addons
+            // refresh in the same pass — no redundant second "update" option.
             const latest = await checkForUpdate(true);
             if (typeof latest === 'string')
                 console.log(`  [update] tersio ${latest} available (installed ${PACKAGE_VERSION})`);
@@ -591,13 +560,20 @@ async function runCommandMenu() {
                 console.log(`  [warn] could not reach the npm registry — run \`tersio update\` to retry`);
             else
                 console.log(`  [ok] tersio ${PACKAGE_VERSION} is the latest`);
+            const go = await askInteractiveConfirm('Update ai-addons now (RTK, Caveman rule, Ponytail)?');
+            if (go.status === 'confirmed' && go.value) {
+                await runLatestUpdate();
+            }
+            else if (go.status === 'cancelled') {
+                closeRL();
+                process.exit(130);
+            }
+            else {
+                console.log(`  staying on ${PACKAGE_VERSION} — run \`tersio update\` anytime`);
+            }
             closeRL();
             break;
         }
-        case 'update':
-            await runLatestUpdate();
-            closeRL();
-            break;
         case 'doctor':
             await runDoctor();
             closeRL();
@@ -610,6 +586,10 @@ async function runCommandMenu() {
             await runDashboard({ port: dashboardPort, open: true, exportFile: dashboardExport });
             closeRL();
             break;
+        case 'reset':
+            await runReset();
+            closeRL();
+            break;
         case 'uninstall':
             await runUninstall();
             closeRL();
@@ -617,7 +597,10 @@ async function runCommandMenu() {
     }
 }
 async function runInstall() {
-    if (command === null && tty() && !yes) {
+    // Menu-driven installs must fall through: bare `tersio` re-enters here
+    // with command === null after the picker, and without this guard the
+    // choice loops straight back into runCommandMenu() forever.
+    if (command === null && tty() && !yes && !updatePromptDone) {
         await runCommandMenu();
         return;
     }
@@ -657,16 +640,15 @@ async function runInstall() {
             }
         }
     }
-    const scope = await resolveScope();
+    console.log('  Scope: user (all OMP sessions)');
     // Resolve session defaults: flags > interactive prompt > defaults.
     const profile = await resolveProfile();
     const userDir = OMP_AGENT_DIR;
     const userExtDir = path.join(userDir, 'extensions');
-    const projectExtDir = path.join(process.cwd(), '.omp', 'extensions');
     // apply-update is `tersio update`'s payload run: treat it like reinstall so
     // the add-ons refresh too — Ponytail package via npm, self plugin, RTK
     // binary (always re-downloaded), and the Caveman rule (always re-fetched).
-    const options = { dryRun, verbose, yes, scope, reinstall: reinstall || applyUpdate };
+    const options = { dryRun, verbose, yes, reinstall: reinstall || applyUpdate };
     // Check prerequisites
     console.log('\nPrerequisites:');
     try {
@@ -677,32 +659,20 @@ async function runInstall() {
         console.log('  [fail] omp not found — ensure it\'s installed');
     }
     const cavemanRule = await fetchCavemanRule(options);
-    if (scope === '1' || scope === '3') {
-        console.log('\n--- User-level install ---');
-        await stepSharedSessionState(userExtDir, options);
-        await stepPonytail(OMP_PLUGINS_DIR, userDir, options);
-        const selfPlugin = await stepSelfPlugin(OMP_PLUGINS_DIR, options);
-        const ponytailExtPath = path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
-        await stepRtk(BUN_BIN_DIR, options);
-        await stepRtkSession(userExtDir, options);
-        await stepCaveman(userExtDir, cavemanRule, options);
-        await stepCombo(userExtDir, options);
-        await stepTersioCommands(userExtDir, options);
-        await stepModeReinforcement(userExtDir, ponytailExtPath, options);
-        await stepUpdater(userExtDir, options);
-        if (selfPlugin)
-            await writePluginSettings(profile, options);
-        await validateConfigExtensions(userDir, options);
-    }
-    if (scope === '2' || scope === '3') {
-        console.log('\n--- Project-level install ---');
-        await stepSharedSessionState(projectExtDir, options);
-        await stepRtkSession(projectExtDir, options);
-        await stepCaveman(projectExtDir, cavemanRule, options);
-        await stepTersioCommands(projectExtDir, options);
-        await stepUpdater(projectExtDir, options);
-        console.log('  [note] Ponytail, RTK binary, and Combo toggle require user-level (global) install');
-    }
+    console.log('\n--- User-level install ---');
+    await stepSharedSessionState(userExtDir, options);
+    await stepPonytail(OMP_PLUGINS_DIR, userDir, options);
+    const selfPlugin = await stepSelfPlugin(OMP_PLUGINS_DIR, options);
+    const ponytailExtPath = path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
+    await stepRtk(BUN_BIN_DIR, options);
+    await stepRtkSession(userExtDir, options);
+    await stepCaveman(userExtDir, cavemanRule, options);
+    await stepCombo(userExtDir, options);
+    await stepTersioCommands(userExtDir, options);
+    await stepModeReinforcement(userExtDir, ponytailExtPath, options);
+    await stepUpdater(userExtDir, options);
+    if (selfPlugin)
+        await writePluginSettings(profile, options);
     console.log('\n=== Installation complete ===');
     console.log('\nNext steps:');
     console.log('  1. Restart OMP');

package/cli/reset.js

@@ -0,0 +1,51 @@
+// cli/reset.ts — clear tersio-owned statistics (usage ledger).
+// Session transcripts (~/.omp/agent/sessions) and the RTK database are
+// host/tool-owned and are never touched; doctor shows where they live.
+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, ledgerPath, readUsage } from '../extensions/shared/usage-ledger.js';
+import { sessionsDir } from '../extensions/shared/usage-ledger.js';
+import { rtkDbPath } from '../extensions/shared/rtk-gain.js';
+async function runReset() {
+    console.log('\n=== Tersio Reset ===\n');
+    const rows = readUsage().length;
+    console.log(`Will remove: ${rows} usage rows · ${ledgerPath()}`);
+    console.log(`Left intact: sessions ${sessionsDir()}, rtk ${rtkDbPath()}`);
+    if (dryRun) {
+        console.log('[dry-run] ledger kept.');
+        return true;
+    }
+    if (rows === 0) {
+        console.log('Nothing to reset — usage ledger is already empty.');
+        return true;
+    }
+    if (!yes) {
+        if (tty()) {
+            closeRL();
+            const confirmedChoice = await clackConfirm({ message: 'Clear the usage ledger?', initialValue: false });
+            if (typeof confirmedChoice !== 'boolean') {
+                clackCancel('Aborted.');
+                closeRL();
+                return false;
+            }
+            if (!confirmedChoice) {
+                console.log('Aborted.');
+                closeRL();
+                return false;
+            }
+        }
+        else {
+            const answer = await ask('\nProceed? [y/N]: ');
+            if (!answer.toLowerCase().startsWith('y')) {
+                console.log('Aborted.');
+                closeRL();
+                return false;
+            }
+        }
+    }
+    const cleared = clearUsageLedger();
+    console.log(`[ok] reset — removed ${cleared} usage rows`);
+    return true;
+}
+export { runReset };

package/cli/uninstall.js

@@ -168,5 +168,4 @@ async function runUninstall(options = {}) {
     console.log('\nDone. Restart OMP for changes to take effect.');
     return true;
 }
-const SCOPE_MAP = { user: '1', project: '2', both: '3' };
 export { runUninstall };

package/cli/update.js

@@ -2,7 +2,7 @@
 import { promises as fs } from 'node:fs';
 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, SCOPE_MAP, dryRun, execP, parseJsonObject, scopeFlag, verbose, } from './common.js';
+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 { refreshPrices } from '../extensions/shared/pricing.js';
@@ -127,13 +127,7 @@ function planLine(name, current, latest) {
         console.log(`  ${name}: ${current ?? 'missing'} → ${latest}`);
 }
 async function runLatestUpdate() {
-    const updateScope = scopeFlag || 'user';
-    if (!Object.hasOwn(SCOPE_MAP, updateScope)) {
-        console.error(`[fail] Invalid --scope: ${updateScope}. Use: user, project, both`);
-        process.exitCode = 1;
-        return;
-    }
-    const forwardedArgs = ['--yes', '--scope', updateScope];
+    const forwardedArgs = ['--yes'];
     if (dryRun)
         forwardedArgs.push('--dry-run');
     if (verbose)

package/cli/usage.js

@@ -1,6 +1,6 @@
 // cli/usage.ts — ledger + session-token usage report, tokscale-style.
-import { co2GramsFor, energyWhFor, importSessionTokens, priceFor, readUsage, usdCost, } from '../extensions/shared/usage-ledger.js';
-import { readRtkGain } from '../extensions/shared/rtk-gain.js';
+import { co2GramsFor, energyWhFor, importSessionTokens, ledgerPath, priceFor, readUsage, sessionsDir, usdCost, } from '../extensions/shared/usage-ledger.js';
+import { readRtkGain, rtkDbPath } from '../extensions/shared/rtk-gain.js';
 import { withInteractiveSpinner } from './interactive.js';
 import { PACKAGE_VERSION } from './common.js';
 export function summarizeUsage(rows) {
@@ -43,6 +43,7 @@ export function summarizeUsage(rows) {
         byDay: session.byDay,
         byDayModel: session.byDayModel,
         byTool,
+        recent: session.recent,
         rtkGain: readRtkGain(),
         usd,
         priced,
@@ -51,6 +52,7 @@ export function summarizeUsage(rows) {
         co2g,
         energyWh,
         version: PACKAGE_VERSION,
+        paths: { ledger: ledgerPath(), sessions: sessionsDir(), rtk: rtkDbPath() },
     };
 }
 function fmt(n) {