@krtclcdy/tersio 2.0.0 → 2.0.1

package/README.md

@@ -61,16 +61,18 @@ User-level installs also register the package in `~/.omp/plugins` (visible in OM
 
 ## Benchmarks
 
-Measured before/after — real `o200k_base` token counts, samples and run protocol in [BENCHMARK.md](./BENCHMARK.md). Overhead is paid once per session; savings accumulate per reply, command, or task.
+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).
 
-| Mode | Overhead (once) | Before | After | Saving | Pays off after |
-|---|---:|---:|---:|---:|---|
-| `/caveman lite` | 46 tok | 146 tok/reply | 67 | −55% | 1 reply |
-| `/caveman full` | 172 tok | 146 tok/reply | 61 | −58% | ~2 replies |
-| `/caveman ultra` | 68 tok | 146 tok/reply | 34 | −77% | 1 reply |
-| `/rtk on` | 165 tok | 537 tok (grep) | 469 | −13% (−34% on `git status`) | varies |
-| `/ponytail full` | 76 tok | 261–481 tok/task | 108–143 | −59 to −70% | first task |
-| `/combo balanced` | 480 tok | 944 tok mixed turn | 638 | −32%/turn | first turn |
+| 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.
 
 ## CLI
 
@@ -80,7 +82,7 @@ Measured before/after — real `o200k_base` token counts, samples and run protoc
 | `tersio update` | Refresh from the latest release |
 | `tersio reinstall` | Fresh install, preserving the Ponytail package |
 | `tersio doctor` | Check OMP, extension, Ponytail, and RTK health |
-| `tersio uninstall` | Remove extensions and registration (`--remove-rtk`, `--remove-ponytail` for more) |
+| `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.

package/extensions/caveman-session/index.js

@@ -1,7 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
-import { asPromptArray, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, normalizeMode, paintStatusBar, sessionEntries, setSharedComboMode } from '../shared/session-state.js';
+import { asPromptArray, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, normalizeMode, paintStatusBar, reconcileSharedComboEntries, sessionEntries, setSharedComboMode } from '../shared/session-state.js';
 import { readCavemanDefault } from '../shared/plugin-settings.js';
 const CAVERN_DIR = dirname(fileURLToPath(import.meta.url));
 const RULE_PATH = join(CAVERN_DIR, 'rule.md');
@@ -96,6 +96,11 @@ export default function cavemanSessionExtension(pi) {
     });
     function restoreMode(ctx) {
         const entries = sessionEntries(ctx);
+        // Publish the persisted combo state (incl. combo-level) before painting:
+        // bar suppression reads the in-process bridge, which is empty in a fresh
+        // host until the combo extension reconciles — and its reconcile is
+        // UI-gated. Deriving it here makes suppression independent of load order.
+        reconcileSharedComboEntries(entries);
         // Persisted session state wins; a fresh session falls back to the
         // installer/user-configured default (off unless configured).
         const persisted = resolveMode(entries, '');

package/extensions/combo-toggle/index.js

@@ -29,7 +29,6 @@ function loadPonytailInstructions(mode) {
 }
 export default function comboToggleExtension(pi) {
     pi.setLabel?.('Combo session toggle (all 3 add-ons)');
-    let currentState = getSharedComboState();
     let lastCtx = undefined;
     function syncStatus(ctx) {
         if (ctx)
@@ -43,11 +42,14 @@ export default function comboToggleExtension(pi) {
             c.ui.setStatus('combo', undefined);
             return;
         }
+        // Read the live bridge, not cached extension state: sibling extensions
+        // reconcile it from persisted entries before this one runs.
+        const state = getSharedComboState();
         const theme = c.ui.theme;
-        const c0 = currentState.caveman.toUpperCase();
-        const r = currentState.rtk.toUpperCase();
-        const p = currentState.ponytail.toUpperCase();
-        const lvl = currentState.level.toUpperCase();
+        const c0 = state.caveman.toUpperCase();
+        const r = state.rtk.toUpperCase();
+        const p = state.ponytail.toUpperCase();
+        const lvl = state.level.toUpperCase();
         const label = `combo ${lvl}: 🪨caveman=${c0} ⚡rtk=${r} 🦥ponytail=${p}`;
         c.ui.setStatus('combo', theme?.fg ? `${theme.fg('accent', '🧩')} ${theme.fg('muted', label)}` : `🧩 ${label}`);
         // Clobber any sibling bars another extension may have painted in a race
@@ -67,13 +69,12 @@ export default function comboToggleExtension(pi) {
         pi.appendEntry?.('combo-level', { level });
     }
     function useState(state, ctx) {
-        currentState = state;
         syncStatus(ctx);
         return state;
     }
     function reconcile(ctx) {
         if (!ctx?.hasUI)
-            return currentState;
+            return getSharedComboState();
         return useState(reconcileSharedComboEntries(sessionEntries(ctx)), ctx);
     }
     function listen(ctx) {
@@ -109,7 +110,7 @@ export default function comboToggleExtension(pi) {
             }
             persistPreset(level);
             useState(setSharedComboLevel(level), ctx);
-            ctx?.ui?.notify?.(`Combo ${level} applied: ${levelSummary(currentState)}`, 'info');
+            ctx?.ui?.notify?.(`Combo ${level} applied: ${levelSummary(getSharedComboState())}`, 'info');
             if (ctx?.reload)
                 await ctx.reload();
         },

package/extensions/rtk-session/index.js

@@ -1,6 +1,6 @@
 import os from 'node:os';
 import path from 'node:path';
-import { asPromptArray, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, paintStatusBar, sessionEntries, setSharedComboMode } from '../shared/session-state.js';
+import { asPromptArray, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, paintStatusBar, reconcileSharedComboEntries, sessionEntries, setSharedComboMode } from '../shared/session-state.js';
 import { readRtkDefault } from '../shared/plugin-settings.js';
 const DEFAULT_ENABLED = false;
 function asBoolean(value) {
@@ -102,6 +102,11 @@ export default function rtkSessionExtension(pi) {
     });
     function restoreEnabled(ctx) {
         const entries = sessionEntries(ctx);
+        // Publish the persisted combo state (incl. combo-level) before painting:
+        // bar suppression reads the in-process bridge, which is empty in a fresh
+        // host until the combo extension reconciles — and its reconcile is
+        // UI-gated. Deriving it here makes suppression independent of load order.
+        reconcileSharedComboEntries(entries);
         // Persisted session state wins; a fresh session falls back to the
         // installer/user-configured default (off unless configured).
         const persisted = resolveEnabled(entries);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krtclcdy/tersio",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "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

@@ -69,6 +69,7 @@ const verbose = args.includes('--verbose');
 const doctor = command === 'doctor' || args.includes('--doctor');
 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;
 // --- Profile selection (session-start mode defaults) ---
@@ -92,7 +93,7 @@ Commands:
 
 Options:
   --scope user|project|both
-  --remove-ponytail (uninstall: also remove the Ponytail plugin)
+  --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)
   --caveman-default off|lite|full|ultra|wenyan (override; default follows combo)
@@ -800,7 +801,9 @@ async function removeUninstallTarget(target, shouldDryRun, recursive = true) {
 async function runUninstall(options = {}) {
     const shouldDryRun = options.dryRun ?? dryRun;
     const confirmed = (options.yes ?? yes) || shouldDryRun;
-    const shouldRemovePonytail = options.removePonytail ?? removePonytail;
+    // Ponytail ships with Tersio's presets, so a full uninstall removes it too;
+    // --keep-ponytail opts out and reinstall always preserves it.
+    const shouldRemovePonytail = options.removePonytail ?? (removePonytail || !keepPonytail);
     const shouldRemoveRtk = options.removeRtk ?? removeRtk;
     console.log('\n=== Tersio Uninstall ===\n');
     const extDir = path.join(OMP_AGENT_DIR, 'extensions');