@krtclcdy/tersio 2.11.0 → 2.13.0

package/README.md

@@ -1,4 +1,4 @@
-![Fontora](/TersioBanner.webp)
+![Banner](/TersioBanner.webp)
 
 # ✂️ Tersio — Token-saving OMP Add-ons
 
@@ -13,7 +13,7 @@ Terse replies, compact shell output, and minimal code decisions for [Oh My Pi (O
 ## ✨ Features
 
 - **Caveman** — Shortens replies, keeps technical substance. Modes: `lite`, `full`, `ultra`, `wenyan`.
-- **RTK** — Routes noisy shell commands through the RTK binary for compact output; exact bytes bypass it by policy.
+- **RTK** — Routes noisy shell commands through the RTK binary for compact output; exact bytes bypass it by policy. The installer wires rtk into OMP automatically (`rtk init -g --agent omp`), so bash tool calls rewrite to `rtk` before execution and meter into the gain dashboard.
 - **Ponytail** — Minimal, YAGNI-oriented code decisions, from nudge (`lite`) to requirement-challenger (`ultra`).
 - **Combo** — Toggles all three at once. Presets: `off`, `medium`, `balanced`, `max`.
 - **Updater** — `/tersio check` and `/tersio update` cover Ponytail, RTK, and Caveman in-session, with dry-run and backups.
@@ -84,30 +84,35 @@ Measured savings against the same workload without the modes. Token counts are r
 
 | Measured surface (n) | Baseline → Tersio | Δ |
 |---|---|---|
-| Terse reply, caveman lite — BPE tok (3 samples, p50) | 146 → 73 tok | **−52.6%** |
-| Terse reply, caveman full — BPE tok (3 samples, p50) | 154 → 58 tok | **−62.3%** |
-| Terse reply, caveman ultra — BPE tok (3 samples, p50) | 146 → 33 tok | **−78.6%** |
-| Code diff, ponytail minimal-ladder — BPE tok (2 tasks) | 261–481 → 108–143 tok | **−58.6…−70.3%** |
-| Shell output, rtk — `git status` — BPE tok | 32 → 21 tok | **−34.4%** |
-| Shell output, rtk — repo `grep` — BPE tok | 537 → 469 tok | **−12.7%** |
-
-Break-even math, balanced preset (caveman full + rtk + ponytail): `⌈overhead ÷ saving-per-turn⌉ = ⌈480 ÷ 306⌉ = 2 turns`, where a mixed turn (reply + `git status`-class command + code task) costs 944 tok baseline vs 638 tok with Tersio — a 0.68× ratio. Every turn after turn 2 nets ≈ −32%. RTK keeps diffs and failing-test output exact by design (−0.4% and −1.5% there), concentrating savings where noise lives.
+| Terse reply, caveman lite — BPE tok (3 samples, p50) | 173 → 69 tok | **−60.1%** |
+| Terse reply, caveman full — BPE tok (3 samples, p50) | 173 → 49 tok | **−71.7%** |
+| Terse reply, caveman ultra — BPE tok (3 samples, p50) | 173 → 25 tok | **−85.5%** |
+| Code diff, ponytail lite — BPE tok (2 tasks) | 326–462 → 57–121 tok | **−73.8…−82.5%** |
+| Code diff, ponytail full — BPE tok (2 tasks) | 326–462 → 55–88 tok | **−81.0…−83.1%** |
+| Code diff, ponytail ultra — BPE tok (2 tasks) | 326–462 → 40–88 tok | **−81.0…−87.7%** |
+| Shell output, rtk — `git status` — BPE tok | 182 → 72 tok | **−60.4%** |
+| Shell output, rtk — repo `grep` — BPE tok | 376 → 274 tok | **−27.1%** |
+| Shell output, rtk — `find` — BPE tok | 205 → 168 tok | **−18.0%** |
+| Shell output, rtk — `git diff` — BPE tok | 12,684 → 8,504 tok | **−33.0%** |
+| Shell output, rtk — `npm test` (passthrough) — BPE tok | 2,597 → 2,577 tok | **−0.8%** |
+
+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).
 
 ## 🖥️ CLI
 
 | 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 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`, `--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
 
@@ -132,6 +137,7 @@ Everything runs under one root. Bare `/tersio` prints status.
 | What | Path |
 |---|---|
 | Caveman / RTK / Updater / Combo extensions | `~/.omp/agent/extensions/{caveman-session,rtk-session,ai-addons-updater,combo-toggle}/` |
+| RTK OMP wiring (rtk-owned) | `~/.omp/agent/extensions/rtk.ts` — written by the installer via `rtk init -g --agent omp`; auto-loads, no config entry |
 | Ponytail package | `~/.omp/plugins/node_modules/@dietrichgebert/ponytail/` |
 | RTK binary | `~/.bun/bin/rtk` (`rtk.exe` on Windows) |
 | Extension registrations | `~/.omp/agent/config.yml` |
@@ -146,6 +152,8 @@ User-level installs also register the package in `~/.omp/plugins` (visible in OM
 
 **RTK missing or not executable:** run `tersio reinstall`, then `tersio doctor`. On Linux/macOS: `chmod +x ~/.bun/bin/rtk`.
 
+**RTK commands not metered in the gain dashboard:** check `tersio doctor` — the `RTK OMP wiring (rtk.ts)` row must be ok. Missing: run `rtk init -g --agent omp` (needs rtk ≥ 0.49) and restart OMP. Native tool calls (`read`/`edit`/`eval`) stay unmetered — only bash tool calls pass through rtk.
+
 **Checksum warning or failure:** the installer aborts on RTK checksum mismatch but warns and continues when checksum metadata is unavailable; `/tersio update rtk` aborts when metadata is missing.
 
 ## 🤝🏻 Contributing

package/cli/common.js

@@ -48,7 +48,7 @@ function flagValue(name) {
 // --- 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 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';
@@ -71,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');
@@ -239,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)
@@ -255,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, reset, 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/doctor.js

@@ -39,6 +39,7 @@ async function runDoctor() {
         pluginsPkgRaw: readTextIfExists(path.join(pluginsDir, 'package.json')),
         selfPkgText: readTextIfExists(selfPkg),
         rtkBinText: readTextIfExists(rtkBin),
+        rtkOmpText: readTextIfExists(path.join(extDir, 'rtk.ts')),
         cavemanIndexText: readTextIfExists(cavemanIndex),
         cavemanRuleText: readTextIfExists(cavemanRule),
         rtkIndexText: readTextIfExists(rtkIndex),
@@ -75,12 +76,13 @@ async function runDoctor() {
         probes.pluginsPkgRaw,
         probes.selfPkgText,
     ]));
-    const [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, ponytailMtime] = await runInteractivePhase('Checking add-ons', () => Promise.all([
+    const [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, rtkOmpText, ponytailMtime] = await runInteractivePhase('Checking add-ons', () => Promise.all([
         probes.cavemanRuleText,
         probes.ruleMtime,
         probes.rtkBinText,
         probes.rtkMtime,
         rtkVersionProbe,
+        probes.rtkOmpText,
         probes.ponytailMtime,
     ]));
     // Categorized output with a tally; section headers group related probes.
@@ -151,6 +153,10 @@ async function runDoctor() {
         check('RTK binary', true, bits);
         if (!rtkVersion)
             warnLine('RTK version', 'unavailable — binary may not be executable');
+        if (rtkOmpText === null)
+            check('RTK OMP wiring (rtk.ts)', false, `run: rtk init -g --agent omp`);
+        else
+            check('RTK OMP wiring (rtk.ts)', true, path.join(extDir, 'rtk.ts'));
     }
     const ponytailAge = ponytailMtime ? `updated ${relTime(Date.now() - ponytailMtime.mtimeMs)}` : '';
     check('Ponytail', ponytailPkgText !== null, [parseJsonObject(ponytailPkgText)?.version ?? '', ponytailAge].filter(Boolean).join(', '));

package/cli/install.js

@@ -3,8 +3,8 @@ 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';
@@ -12,6 +12,7 @@ import { runDoctor } from './doctor.js';
 import { runReset } from './reset.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';
 // Paths to extension source files (relative to this script)
 const EXT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'extensions');
@@ -25,6 +26,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) {
@@ -231,6 +235,15 @@ async function verifyRtkArchive(archivePath, assetName, checksumsText) {
 function shortError(e) {
     return ((e.stderr) || e.message || '').trim().slice(0, 200);
 }
+async function fileExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 async function extractRtkArchive(archivePath, extractDir) {
     await fs.mkdir(extractDir, { recursive: true });
     if (archivePath.endsWith('.zip')) {
@@ -260,6 +273,9 @@ async function extractRtkArchive(archivePath, extractDir) {
 }
 async function stepRtk(binDir, options) {
     console.log('\n[3/8] Installing RTK binary...');
+    const binDest = path.join(binDir, RTK_BINARY_NAME);
+    // Download failure must not skip wiring: a pre-existing rtk binary is
+    // exactly as good for the OMP hook, so wire whatever ends up at binDest.
     try {
         const release = await withInteractiveSpinner('Finding latest RTK release', () => fetchJson(RTK_RELEASE_API));
         const triple = resolveRtkTriple();
@@ -268,7 +284,6 @@ async function stepRtk(binDir, options) {
         const asset = findRtkAsset(release, triple);
         if (!asset)
             return;
-        const binDest = path.join(binDir, RTK_BINARY_NAME);
         if (options.dryRun) {
             console.log(`  [dry-run] would download ${asset.name} from release ${release.tag_name}`);
             console.log('  [dry-run] would verify checksum against checksums.txt');
@@ -305,7 +320,7 @@ async function stepRtk(binDir, options) {
                 debug(`chmod 755 ${binDest}`);
             }
             try {
-                const v = (await execP(binDest, ['--version'], { timeout: 10000, shell: false })).stdout.trim();
+                const v = (await execP(binDest, ['--version'], { timeout: 30000, shell: false })).stdout.trim();
                 console.log(`  [ok] ${binDest} → ${v}`);
             }
             catch {
@@ -320,6 +335,17 @@ async function stepRtk(binDir, options) {
         console.log(`  [fail] RTK: ${e.message}`);
         console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
     }
+    if (options.dryRun) {
+        await wireRtkOmp(binDest, options);
+        return;
+    }
+    if (!(await fileExists(binDest))) {
+        console.log('  [skip] no rtk binary to wire — install rtk, then run: rtk init -g --agent omp');
+        return;
+    }
+    // Binary alone never meters OMP sessions — wire rtk's tool_call
+    // extension so bash commands rewrite to rtk and land in history.db.
+    await wireRtkOmp(binDest, options);
 }
 // Copy repo source files into the target extension dir. First entry is
 // required (skip label on missing); rest are optional companions.
@@ -345,6 +371,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) {
@@ -358,7 +387,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)
@@ -413,52 +442,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)) {
@@ -568,7 +557,7 @@ 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: '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' },
@@ -674,16 +663,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 {
@@ -694,32 +682,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/rtk-wiring.js

@@ -0,0 +1,58 @@
+// cli/rtk-wiring.ts — wire the installed rtk binary into OMP.
+// `rtk init -g --agent omp` writes rtk's tool_call extension to
+// ~/.omp/agent/extensions/rtk.ts; OMP auto-loads it and rewrites bash
+// commands to rtk before execution, so every rewritten call lands in
+// rtk's history.db and shows metered savings in the gain dashboard.
+// Fail-open: a failed wire only downgrades to manual `rtk` prefixing.
+// Deliberately free of cli/common.ts imports (argv side effects) so tests
+// can load it directly.
+import { execFile } from 'node:child_process';
+function shortWiringError(e) {
+    const err = e;
+    const why = [err.code !== undefined ? `code ${err.code}` : '', err.signal ?? '', err.stderr?.trim(), err.message]
+        .filter(Boolean).join(' · ');
+    return why.slice(0, 200);
+}
+function execFileP(cmd, args, timeout) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, { timeout, encoding: 'utf8' }, (err, stdout, stderr) => {
+            if (err) {
+                err.stderr = String(stderr || '');
+                reject(err);
+            }
+            else {
+                resolve({ stdout: String(stdout), stderr: String(stderr) });
+            }
+        });
+    });
+}
+// Idempotent: rtk rewrites its extension file on every init run, so
+// reinstalling tersio refreshes the wiring for free.
+export async function wireRtkOmp(rtkBin, options = {}) {
+    console.log('  Wiring rtk → OMP (bash tool_call rewrite)...');
+    if (options.dryRun) {
+        console.log('  [dry-run] would run: rtk init -g --agent omp');
+        return true;
+    }
+    try {
+        await execFileP(rtkBin, ['init', '-g', '--agent', 'omp'], 30000);
+        console.log('  [ok] rtk OMP extension wired (~/.omp/agent/extensions/rtk.ts)');
+        return true;
+    }
+    catch (first) {
+        // A freshly written binary can lose its first exec to macOS Gatekeeper
+        // verification; give it one settle-and-retry before reporting failure.
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        try {
+            await execFileP(rtkBin, ['init', '-g', '--agent', 'omp'], 30000);
+            console.log('  [ok] rtk OMP extension wired (~/.omp/agent/extensions/rtk.ts)');
+            return true;
+        }
+        catch (e) {
+            void first;
+            console.log(`  [warn] could not wire rtk → OMP: ${shortWiringError(e)}`);
+            console.log('  [hint] Manual: rtk init -g --agent omp (needs rtk >= 0.49)');
+            return false;
+        }
+    }
+}

package/cli/uninstall.js

@@ -88,6 +88,7 @@ async function runUninstall(options = {}) {
     }
     if (shouldRemoveRtk) {
         console.log(`  ${rtkBin}`);
+        console.log(`  ${path.join(extDir, 'rtk.ts')} (rtk OMP wiring)`);
     }
     if (!confirmed) {
         if (tty()) {
@@ -162,11 +163,14 @@ async function runUninstall(options = {}) {
     if ((await readTextIfExists(path.join(selfPluginDir, 'package.json'))) !== null) {
         await removeUninstallTarget(selfPluginDir, shouldDryRun);
     }
-    // Remove RTK binary if requested
-    if (shouldRemoveRtk)
+    // Remove RTK binary if requested. rtk.ts is rtk-owned but installed by our
+    // wiring step; with the binary gone it would pass through harmlessly, so
+    // only drop it on a full rtk removal.
+    if (shouldRemoveRtk) {
         await removeUninstallTarget(rtkBin, shouldDryRun, false);
+        await removeUninstallTarget(path.join(extDir, 'rtk.ts'), shouldDryRun);
+    }
     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/dashboard/styles.css

@@ -5,6 +5,7 @@
     --cell-0: rgba(24, 24, 27, .07);
     --cell-1: rgba(4, 120, 87, .3); --cell-2: rgba(4, 120, 87, .55);
     --cell-3: rgba(4, 120, 87, .8); --cell-4: #047857;
+    --danger: #dc2626; --danger-border: rgba(220, 38, 38, .35); --danger-soft: rgba(220, 38, 38, .05);
     --shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.07);
   }
   html[data-theme="light"] { color-scheme: light; }
@@ -17,6 +18,7 @@
       --cell-0: rgba(255, 255, 255, .07);
       --cell-1: rgba(52, 211, 153, .3); --cell-2: rgba(52, 211, 153, .55);
       --cell-3: rgba(52, 211, 153, .8); --cell-4: #34d399;
+      --danger: #f87171; --danger-border: rgba(248, 113, 113, .3); --danger-soft: rgba(248, 113, 113, .07);
     --shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.55);
     }
   }
@@ -36,6 +38,7 @@
     --cell-0: rgba(255, 255, 255, .07);
     --cell-1: rgba(52, 211, 153, .3); --cell-2: rgba(52, 211, 153, .55);
     --cell-3: rgba(52, 211, 153, .8); --cell-4: #34d399;
+    --danger: #f87171; --danger-border: rgba(248, 113, 113, .3); --danger-soft: rgba(248, 113, 113, .07);
     --shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.55);
   }
   .ticker { animation: tick 36s linear infinite; will-change: transform; }
@@ -172,6 +175,7 @@
   }
   /* Empty states (shadcn pattern): dashed well, icon chip, title + hint. */
   .empty { display: flex; flex-direction: column; align-items: center; text-align: center; gap: 2px; border: 1px dashed var(--line); border-radius: 12px; padding: 32px 16px; }
+  .empty.hidden { display: none; } /* beats .empty flex: same-file order, higher specificity than tailwind .hidden */
   .empty-icon { display: grid; place-items: center; width: 40px; height: 40px; border-radius: 999px; background: var(--track); color: var(--dim); margin-bottom: 10px; }
   .empty-title { font-weight: 600; font-size: 14px; color: var(--ink); margin: 0; }
   .empty-desc { font-size: 12px; color: var(--dim); margin: 0; max-width: 340px; }
@@ -184,11 +188,16 @@
   .dlg-desc { font-size: 12px; color: var(--dim); margin: 2px 0 0; }
   .dlg-label { font-size: 11px; text-transform: uppercase; letter-spacing: .14em; color: var(--dim); margin: 18px 0 8px; }
   .dlg-row { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+  .dlg-row + .dlg-row { margin-top: 14px; }
   .dlg-name { font-size: 13px; font-weight: 600; margin: 0; }
   .dlg-hint { font-size: 12px; color: var(--dim); margin: 2px 0 0; }
   .dlg-own { font-weight: 400; font-size: 11px; color: var(--dim); }
   .dlg-paths { margin-top: 12px; display: grid; gap: 8px; }
-  .dlg-path { border: 1px solid var(--line); border-radius: 10px; padding: 8px 12px; }
+  .dlg-path { border: 1px solid var(--line); border-radius: 10px; padding: 8px 12px; min-width: 0; overflow: hidden; }
   .dlg-file { font-size: 11px; color: var(--dim); margin: 4px 0 0; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
   #settingsBtn:hover { box-shadow: 0 0 14px var(--accent-soft); border-color: var(--accent); }
+  .dlg-danger { margin-top: 16px; border: 1px solid var(--danger-border); background: var(--danger-soft); border-radius: 12px; padding: 12px; }
+  .dlg-danger .dlg-label { color: var(--danger); margin: 0 0 10px; }
+  #reset { color: var(--danger); }
+  #reset:hover { border-color: var(--danger); box-shadow: 0 0 14px var(--danger-border); }
   .dlg .seg button { display: grid; place-items: center; }

package/dashboard/template.html

@@ -36,9 +36,6 @@
       <span id="clock">--:--</span>
     </span>
     <span class="hidden sm:block w-px h-5 shrink-0" style="background: var(--line)" aria-hidden="true"></span>
-    <button id="reset" class="btn-push mono flex shrink-0 items-center gap-2 text-xs pl-2.5 pr-3 py-2 rounded-xl" style="border: 1px solid var(--line); color: var(--ink)" aria-label="Reset tersio statistics">
-      <i data-lucide="rotate-ccw" class="size-3.5"></i><span class="hidden md:inline" id="resetLabel">Reset</span>
-    </button>
     <button id="settingsBtn" class="btn-push flex shrink-0 items-center p-2 rounded-xl" style="border: 1px solid var(--line); color: var(--ink)" aria-label="Open settings">
       <i data-lucide="settings" class="size-4"></i>
     </button>
@@ -49,7 +46,7 @@
     <div class="dlg-head">
       <div class="min-w-0">
         <p class="dlg-title" id="settingsTitle">Settings</p>
-        <p class="dlg-desc">Appearance, data refresh, and where statistics live.</p>
+        <p class="dlg-desc">Appearance, data, and where statistics live.</p>
       </div>
       <button id="settingsClose" class="btn-push flex shrink-0 items-center p-2 rounded-xl" style="border: 1px solid var(--line); color: var(--ink)" aria-label="Close settings">
         <i data-lucide="x" class="size-4"></i>
@@ -91,6 +88,18 @@
         <p class="mono dlg-file" id="pathRtk" title="">–</p>
       </div>
     </div>
+    <div class="dlg-danger">
+      <p class="dlg-label">Danger zone</p>
+      <div class="dlg-row">
+        <div class="min-w-0">
+          <p class="dlg-name">Reset statistics</p>
+          <p class="dlg-hint">Clears the usage ledger. Click twice to confirm.</p>
+        </div>
+        <button id="reset" class="btn-push mono flex shrink-0 items-center gap-2 text-xs pl-2.5 pr-3 py-2 rounded-xl" style="border: 1px solid var(--danger-border)" aria-label="Reset tersio statistics">
+          <i data-lucide="rotate-ccw" class="size-3.5"></i><span id="resetLabel">Reset</span>
+        </button>
+      </div>
+    </div>
   </dialog>
 
   <!-- Hero: centered total -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krtclcdy/tersio",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "description": "✂️ Token-saving OMP add-ons: terse Caveman replies, compact RTK shell output, lean Ponytail code calls — one-command combo presets.",
   "keywords": [
     "omp",

package/tersio.js

@@ -15,7 +15,7 @@ function printHelp() {
     console.log(`Usage: ${PACKAGE_BIN} [command] [options]
 
 Commands:
-  install      Install the add-ons (user scope by default)
+  install      Install the add-ons (user scope: all OMP sessions)
   update       Refresh the CLI and add-ons (RTK binary, Caveman rule, Ponytail)
   reinstall    Clean and reinstall the user-scope add-ons
   doctor       Check the current installation
@@ -27,7 +27,7 @@ Commands:
   help         Show this help
 
 Options:
-  --scope user|project|both
+  --scope user (legacy; accepted and ignored — user scope is the only scope)
   --keep-ponytail (uninstall: keep the Ponytail plugin — removed by default)
   --remove-rtk (uninstall: also remove the RTK binary)
   --combo-default off|medium|balanced|max (implies caveman, rtk, ponytail)