@krtclcdy/tersio 2.9.0 → 2.11.0

package/README.md

@@ -1,15 +1,34 @@
-# Tersio ✂️
+![Fontora](/TersioBanner.webp)
 
-[![npm version](https://img.shields.io/npm/v/@krtclcdy%2Ftersio?color=cb0000)](https://www.npmjs.com/package/@krtclcdy/tersio)
-[![release](https://img.shields.io/github/v/release/KurutoDenzeru/tersio?color=7c3aed)](https://github.com/KurutoDenzeru/tersio/releases)
-[![license](https://img.shields.io/badge/license-MIT-6e7681)](./LICENSE)
-[![node](https://img.shields.io/node/v/@krtclcdy%2Ftersio?color=30363d)](https://nodejs.org)
-[![CI](https://github.com/KurutoDenzeru/tersio/actions/workflows/ci.yml/badge.svg)](https://github.com/KurutoDenzeru/tersio/actions)
-[![issues](https://img.shields.io/github/issues/KurutoDenzeru/tersio?color=d97706)](https://github.com/KurutoDenzeru/tersio/issues)
+# ✂️ Tersio — Token-saving OMP Add-ons
 
-Terse replies, compact shell output, and minimal code decisions for [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi).
+[![npm version](https://shieldcn.dev/npm/@krtclcdy%2Ftersio.svg?variant=branded&size=xs&logo=npm)](https://www.npmjs.com/package/@krtclcdy/tersio)
+[![node](https://shieldcn.dev/badge/node-%3E%3D20.12-22c55e.svg?variant=branded&size=xs&logo=nodedotjs)](https://nodejs.org)
+[![npm downloads](https://shieldcn.dev/npm/dm/@krtclcdy%2Ftersio.svg?variant=branded&size=xs&logo=npm)](https://www.npmjs.com/package/@krtclcdy/tersio)
+[![Build](https://shieldcn.dev/github/ci/KurutoDenzeru/tersio.svg?variant=branded&size=xs&logo=githubactions&label=Build)](https://github.com/KurutoDenzeru/tersio/actions)
+[![MIT](https://shieldcn.dev/badge/license-MIT-2563eb.svg?variant=branded&size=xs&logo=opensourceinitiative)](./LICENSE)
 
-## Install
+Terse replies, compact shell output, and minimal code decisions for [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi) — one-command combo presets.
+
+## ✨ 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.
+- **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.
+- **Gain dashboard** — `tersio gain` serves a local-only savings dashboard: cost with currency conversion, activity graph, command tools, and model breakdowns.
+- **Usage ledger** — `tersio usage` prints a ledger-backed savings report for the machine, local only.
+
+## 🧱 Tech Stack
+
+- [TypeScript](https://www.typescriptlang.org/) + [Node.js](https://nodejs.org/): CLI and OMP extensions, compiled to dependency-free JS for install.
+- Vanilla dashboard: dependency-free HTML/CSS/JS export — no build step, no runtime deps.
+- [js-tiktoken](https://github.com/dqbd/tiktoken): Real `o200k_base` BPE token counts for benchmarks (dev only).
+ - [tokscale](https://github.com/junhoyeo/tokscale): Token-bucket convention (input / output / cache read / cache write) for parsing OMP session transcripts.
+ - [EcoLogits](https://github.com/genai-impact/ecologits): CO2 model (v0.8.2 port — per-model params, provider grids, served ÷32 amortization).
+
+## ⚡ Getting Started
 
 **Default** (macOS/Linux/WSL) — one line. Installs the CLI via npm, then runs the main installer (scope + Combo preset menus) in the same pass:
 
@@ -46,19 +65,20 @@ tersio install --combo-default balanced --caveman-default lite --rtk-default on
 
 Defaults apply to fresh sessions only — anything persisted with `/tersio combo`, `/tersio caveman`, or `/tersio rtk` wins. Stored as plugin settings (`omp plugin config get @krtclcdy/tersio comboDefault`).
 
-## What it installs
+One-off use without installing:
 
-| Add-on | What it does |
-|---|---|
-| **Caveman** | Shortens replies, keeps technical substance. Modes: `lite`, `full`, `ultra`, `wenyan` |
-| **RTK** | Routes noisy shell commands through the RTK binary for compact output |
-| **Ponytail** | Minimal, YAGNI-oriented code decisions |
-| **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 |
+```bash
+npm exec --yes --prefer-online --package=@krtclcdy/tersio@latest -- tersio install
+```
 
-User-level installs also register the package in `~/.omp/plugins` (visible in OMP **Settings → Plugins**), directly through the plugin manifest. Active modes reassert after Ponytail's prompt block on every top-level turn, including after history compaction.
+### Requirements
+
+- [OMP](https://github.com/can1357/oh-my-pi)
+- Node.js 20.12+ with npm
+
+Windows/WSL have separate OMP homes — install from the environment where OMP runs. Inside WSL, `command -v npm` must resolve to a Linux path, not `/mnt/c/`.
 
-## Benchmarks
+## 📊 Benchmarks
 
 Measured savings against the same workload without the modes. Token counts are real `o200k_base` BPE tokens (js-tiktoken), not chars÷4 estimates. Sample protocol, per-sample data, and caveats in [BENCHMARK.md](./BENCHMARK.md).
 
@@ -73,7 +93,7 @@ Measured savings against the same workload without the modes. Token counts are r
 
 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.
 
-## CLI
+## 🖥️ CLI
 
 | Command | Purpose |
 |---|---|
@@ -83,12 +103,13 @@ Break-even math, balanced preset (caveman full + rtk + ponytail): `⌈overhead
 | `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.
 
-## Commands reference
+## ⌨️ Commands reference
 
 Everything runs under one root. Bare `/tersio` prints status.
 
@@ -106,7 +127,7 @@ Everything runs under one root. Bare `/tersio` prints status.
 | `/tersio help` | This table |
 | `/caveman`, `/rtk`, `/combo`, `/ai-addons` | Legacy aliases, still work; prefer `/tersio`. |
 
-## Files and backups
+## 🗂️ Files and backups
 
 | What | Path |
 |---|---|
@@ -117,27 +138,24 @@ Everything runs under one root. Bare `/tersio` prints status.
 
 The installer writes `<file>.bak` before replacing an extension source; the updater keeps `rtk.bak` / `rule.md.bak` and restores them if the replacement fails validation.
 
-## Requirements
+User-level installs also register the package in `~/.omp/plugins` (visible in OMP **Settings → Plugins**), directly through the plugin manifest. Active modes reassert after Ponytail's prompt block on every top-level turn, including after history compaction.
 
-- [OMP](https://github.com/can1357/oh-my-pi)
-- Node.js 20.12+ with npm
+## 🛠️ Troubleshooting
 
-Windows/WSL have separate OMP homes — install from the environment where OMP runs. Inside WSL, `command -v npm` must resolve to a Linux path, not `/mnt/c/`.
+**Ponytail or Combo command missing:** run `tersio reinstall` in OMP's environment, restart OMP, then `tersio doctor` (repairs `config.yml` registrations).
 
-One-off use without installing:
+**RTK missing or not executable:** run `tersio reinstall`, then `tersio doctor`. On Linux/macOS: `chmod +x ~/.bun/bin/rtk`.
 
-```bash
-npm exec --yes --prefer-online --package=@krtclcdy/tersio@latest -- tersio install
-```
+**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.
 
-## Troubleshooting
+## 🤝🏻 Contributing
 
-**Ponytail or Combo command missing:** run `tersio reinstall` in OMP's environment, restart OMP, then `tersio doctor` (repairs `config.yml` registrations).
+Contributions are always welcome, whether you're fixing bugs, improving docs, or shipping new features that make the project better for everyone.
 
-**RTK missing or not executable:** run `tersio reinstall`, then `tersio doctor`. On Linux/macOS: `chmod +x ~/.bun/bin/rtk`.
+Check out [Contributing.md](Contributing.md) to learn how to get started and follow the recommended workflow.
 
-**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.
+## ⚖️ License
 
-## License
+This project is released under the MIT License, giving you the freedom to use, modify, and distribute the code with minimal restrictions.
 
-[MIT](./LICENSE)
+For the full legal text, see the [LICENSE](LICENSE) file.

package/cli/banner.js

@@ -0,0 +1,84 @@
+// 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';
+import { PACKAGE_VERSION, dryRun } from './common.js';
+function tty() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+// Pixel classes: B/b blades, P pivot, L/R handle rings, l shafts.
+const GRID = [
+    '..BB........bb..',
+    '..BBB......bbb..',
+    '....BB....bb....',
+    '.....BBBbbb.....',
+    '......BPPb......',
+    '....L.lPPl..R...',
+    '..LLLLLl.lRRRRR.',
+    '..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 = {
+    B: ['190;200;210', '252'],
+    b: ['190;200;210', '252'],
+    P: ['212;175;55', '172'],
+    L: ['239;68;68', '196'],
+    R: ['250;204;21', '220'],
+    l: ['190;200;210', '252'],
+};
+function bannerTier() {
+    if (process.env.NO_COLOR !== undefined)
+        return 'plain';
+    if (/truecolor|24bit/i.test(process.env.COLORTERM ?? ''))
+        return 'true';
+    if (/256color/i.test(process.env.TERM ?? ''))
+        return '256';
+    return 'plain';
+}
+function paint(ka, kb, tier) {
+    if (!ka && !kb)
+        return ' ';
+    if (tier === 'plain') {
+        if (ka && kb)
+            return '█';
+        return ka ? '▀' : '▄';
+    }
+    const fg = (k) => (tier === 'true' ? `\x1b[38;2;${PALETTE[k][0]}m` : `\x1b[38;5;${PALETTE[k][1]}m`);
+    const bg = (k) => (tier === 'true' ? `\x1b[48;2;${PALETTE[k][0]}m` : `\x1b[48;5;${PALETTE[k][1]}m`);
+    if (ka && kb && ka === kb)
+        return `${fg(ka)}█\x1b[0m`;
+    if (ka && kb)
+        return `${fg(ka)}${bg(kb)}▀\x1b[0m`;
+    if (ka)
+        return `${fg(ka)}▀\x1b[0m`;
+    return `${fg(kb)}▄\x1b[0m`;
+}
+// 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) {
+        let line = '';
+        for (let x = 0; x < GRID[r].length; x++) {
+            const ka = GRID[r][x] === '.' ? null : GRID[r][x];
+            const kb = GRID[r + 1][x] === '.' ? null : GRID[r + 1][x];
+            line += paint(ka, kb, tier);
+        }
+        out.push(line);
+    }
+    return out;
+}
+let shown = false;
+// OMP-style welcome: intro line + note box with art and tips.
+// No-op unless interactive (and never on --dry-run).
+function printWelcome() {
+    if (shown || dryRun || !tty())
+        return;
+    shown = true;
+    clackIntro(`✂ tersio v${PACKAGE_VERSION}`);
+    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,7 +46,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, 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 command = commandArg?.toLowerCase() || null;
@@ -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;
@@ -254,4 +255,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, 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, };

package/cli/dashboard.js

@@ -8,13 +8,16 @@ 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 TEMPLATE = path.join(path.dirname(fileURLToPath(import.meta.url)), 'dashboard.html');
-const BRAND = path.join(path.dirname(fileURLToPath(import.meta.url)), 'brand.webp');
-async function templateHtml() {
-    return fs.readFile(TEMPLATE, 'utf8');
+const DASH_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'dashboard');
+const TEMPLATE = path.join(DASH_DIR, 'template.html');
+const STYLES = path.join(DASH_DIR, 'styles.css');
+const APP = path.join(DASH_DIR, 'app.js');
+const BRAND = path.join(DASH_DIR, 'brand.webp');
+async function readSegment(file) {
+    return fs.readFile(file, 'utf8');
 }
 async function faviconDataUri() {
     const png = await fs.readFile(BRAND);
@@ -29,22 +32,45 @@ function openBrowser(url) {
 }
 async function runDashboard(options) {
     if (options.exportFile) {
-        const html = await templateHtml();
-        const inline = html
-            .replace("fetch('data.json')", `Promise.resolve({ json: function () { return ${dataJson()}; } })`)
-            .replace('href="brand.webp"', `href="${await faviconDataUri()}"`)
-            .replace('src="brand.webp"', `src="${await faviconDataUri()}"`);
+        const [template, css, js, icon] = await Promise.all([
+            readSegment(TEMPLATE), readSegment(STYLES), readSegment(APP), faviconDataUri(),
+        ]);
+        // 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.
+        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('href="brand.webp"', () => `href="${icon}"`)
+            .replace('src="brand.webp"', () => `src="${icon}"`);
         await fs.writeFile(options.exportFile, inline, 'utf8');
         console.log(`[ok] gain exported → ${options.exportFile}`);
         return;
     }
-    const html = await withInteractiveSpinner('Loading dashboard template', templateHtml);
+    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());
             return;
         }
+        if (req.url === '/styles.css') {
+            res.writeHead(200, { 'Content-Type': 'text/css; charset=utf-8' });
+            res.end(await readSegment(STYLES));
+            return;
+        }
+        if (req.url === '/app.js') {
+            res.writeHead(200, { 'Content-Type': 'text/javascript; charset=utf-8' });
+            res.end(await readSegment(APP));
+            return;
+        }
         if (req.url === '/brand.webp') {
             try {
                 const png = await fs.readFile(BRAND);

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

@@ -5,9 +5,11 @@ 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 { 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';
@@ -549,6 +551,7 @@ let updatePromptDone = false;
 // update offer first (when pending), then a Clack menu over every command.
 // Scripts, pipes, --yes, and --dry-run keep the old straight-to-install path.
 async function runCommandMenu() {
+    printWelcome();
     const newer = await checkForUpdate();
     if (typeof newer === 'string' && !dryRun) {
         const answer = await askInteractiveConfirm(`tersio ${newer} is available (installed ${PACKAGE_VERSION}). Install it now?`);
@@ -566,11 +569,11 @@ 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: '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') {
@@ -582,6 +585,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})`);
@@ -589,13 +594,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();
@@ -608,6 +620,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();
@@ -615,10 +631,14 @@ 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;
     }
+    printWelcome();
     if (reinstall) {
         await runUninstall({ yes: true, removePonytail: false, removeRtk: true });
     }

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/update.js

@@ -5,6 +5,7 @@ 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 { execNetwork } from './interactive.js';
 import { readTextIfExists } from '../extensions/lib/utils.js';
+import { refreshPrices } from '../extensions/shared/pricing.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, httpsGet, normalizeRtkVersion, sha256Hex, } from '../extensions/lib/utils.js';
 const UPDATE_CHECK_TTL_MS = 6 * 60 * 60 * 1000;
 function newerThan(a, b) {
@@ -195,6 +196,13 @@ async function runLatestUpdate() {
     try {
         await execInherit(npmCommand, npmCommandArgs);
         console.log('\n=== Update complete ===');
+        if (!dryRun) {
+            try {
+                if (await refreshPrices())
+                    console.log('  [ok] model price table refreshed');
+            }
+            catch { /* pricing is best-effort; update already succeeded */ }
+        }
     }
     catch (e) {
         const err = e;