@krtclcdy/tersio 2.14.0 → 2.16.0

package/cli/update.js

@@ -116,15 +116,28 @@ async function probeUpdatePlan(cliLatest) {
         ponytail: [ponytailLocalText ? parseJsonObject(ponytailLocalText)?.version ?? null : null, ponytailLatest],
     };
 }
-function planLine(name, current, latest) {
-    if (!current && !latest)
-        console.log(`  ${name}: unknown`);
-    else if (!latest)
-        console.log(`  ${name}: ${current} (latest unknown)`);
-    else if (current === latest)
-        console.log(`  ${name}: ${current} (up to date)`);
-    else
-        console.log(`  ${name}: ${current ?? 'missing'} → ${latest}`);
+// Every add-on prints its status: version jump when stale, "up to date"
+// otherwise, honest "unknown" when the probe cannot reach its source.
+function planLines(plan) {
+    const stale = [];
+    const status = [];
+    const push = (name, current, latest) => {
+        if (!current && !latest)
+            status.push(`${name}: unknown`);
+        else if (!latest)
+            status.push(`${name}: ${current} (latest unknown)`);
+        else if (current === latest)
+            status.push(`${name}: ${current} (up to date)`);
+        else {
+            status.push(`${name}: ${current ?? 'missing'} → ${latest}`);
+            stale.push(`${name}: ${current ?? 'missing'} → ${latest}`);
+        }
+    };
+    push('Tersio', PACKAGE_VERSION, plan.cli);
+    push('RTK', plan.rtk[0], plan.rtk[1]);
+    push('Caveman rule', plan.rule[0], plan.rule[1]);
+    push('Ponytail', plan.ponytail[0], plan.ponytail[1]);
+    return { stale, status };
 }
 async function runLatestUpdate() {
     const forwardedArgs = ['--yes'];
@@ -133,7 +146,6 @@ async function runLatestUpdate() {
     if (verbose)
         forwardedArgs.push('--verbose');
     const npmCommand = IS_WINDOWS ? process.env.ComSpec || 'cmd.exe' : 'npm';
-    console.log('=== Updating Tersio ===');
     // Resolve the target explicitly: `npm view --prefer-online` beats the local
     // metadata cache, so a stale `@latest` can never pin an older release.
     const cliLatest = await latestPublishedVersion();
@@ -141,37 +153,38 @@ async function runLatestUpdate() {
     // Current → latest per add-on. Best-effort; unreachable probes print as
     // unknown and never block the update.
     const plan = await probeUpdatePlan(cliLatest);
-    planLine('Tersio', PACKAGE_VERSION, plan.cli);
-    planLine('RTK', plan.rtk[0], plan.rtk[1]);
-    planLine('Caveman rule', plan.rule[0], plan.rule[1]);
-    planLine('Ponytail', plan.ponytail[0], plan.ponytail[1]);
-    console.log('');
+    const { stale, status } = planLines(plan);
+    if (dryRun) {
+        console.log(`tersio update (dry-run):\n  ${status.join('\n  ')}`);
+        console.log(`  [dry-run] would run: npm install -g ${PACKAGE_NAME}${target} --no-audit --no-fund --prefer-online`);
+        console.log(`  [dry-run] would delegate: npm exec --yes --prefer-online --package=${PACKAGE_NAME}${target} -- tersio --apply-update ${forwardedArgs.join(' ')}`);
+        return;
+    }
+    console.log(`Checking for updates:\n  ${status.join('\n  ')}`);
+    if (stale.length === 0) {
+        console.log(`tersio ${PACKAGE_VERSION} — up to date`);
+        return;
+    }
+    console.log(`Updating ${stale.join(', ')}`);
     // The npx delegation below only refreshes the OMP-side files; the globally
     // installed CLI keeps its old version until npm -g runs. Refresh both.
     const globalArgs = IS_WINDOWS
         ? ['/d', '/s', '/c', 'npm', 'install', '-g', `${PACKAGE_NAME}${target}`, '--no-audit', '--no-fund', '--prefer-online']
         : ['install', '-g', `${PACKAGE_NAME}${target}`, '--no-audit', '--no-fund', '--prefer-online'];
-    if (dryRun) {
-        console.log(`  [dry-run] would run: npm install -g ${PACKAGE_NAME}${target} --no-audit --no-fund --prefer-online`);
+    try {
+        const globalResult = await execNetwork(`Updating global Tersio CLI to ${PACKAGE_NAME}${target}`, npmCommand, globalArgs, {
+            timeout: 300000,
+            maxBuffer: 10 * 1024 * 1024,
+            windowsHide: true,
+            shell: false,
+        });
+        // npm -g echoes its own added/changed summary; only failures surface here.
+        if (globalResult.stderr)
+            process.stderr.write(globalResult.stderr);
     }
-    else {
-        try {
-            const globalResult = await execNetwork(`Updating global Tersio CLI to ${PACKAGE_NAME}${target}`, npmCommand, globalArgs, {
-                timeout: 300000,
-                maxBuffer: 10 * 1024 * 1024,
-                windowsHide: true,
-                shell: false,
-            });
-            if (globalResult.stdout)
-                process.stdout.write(globalResult.stdout);
-            if (globalResult.stderr)
-                process.stderr.write(globalResult.stderr);
-            console.log(`  [ok] CLI updated to ${PACKAGE_NAME}${target}`);
-        }
-        catch (e) {
-            console.log(`  [warn] Global CLI update skipped: ${e.message}`);
-            console.log(`  [hint] Manual: npm install -g ${PACKAGE_NAME}${target} --no-audit --no-fund --prefer-online`);
-        }
+    catch (e) {
+        console.log(`  [warn] Global CLI update skipped: ${e.message}`);
+        console.log(`  [hint] Manual: npm install -g ${PACKAGE_NAME}${target} --no-audit --no-fund --prefer-online`);
     }
     const npmArgs = [
         'exec',
@@ -184,23 +197,22 @@ async function runLatestUpdate() {
         ...forwardedArgs,
     ];
     const npmCommandArgs = IS_WINDOWS ? ['/d', '/s', '/c', 'npm', ...npmArgs] : npmArgs;
-    // Inherited stdio, no outer spinner: the delegated installer renders its
-    // own Clack UI live, which capture-then-dump would corrupt into stray bars.
-    console.log(`  Running ${PACKAGE_NAME}${target} installer...`);
+    // Inherited stdio, no outer spinner. The delegated installer runs quiet
+    // (banner and per-file writes suppressed); this parent owns both the plan
+    // line above and the closing summary below — one voice, no repeats.
     try {
         await execInherit(npmCommand, npmCommandArgs);
-        console.log('\n=== Update complete ===');
+        console.log(`Done — tersio ${plan.cli ?? PACKAGE_VERSION}. Restart OMP.`);
         if (!dryRun) {
             try {
-                if (await refreshPrices())
-                    console.log('  [ok] model price table refreshed');
+                await refreshPrices();
             }
             catch { /* pricing is best-effort; update already succeeded */ }
         }
     }
     catch (e) {
         const err = e;
-        console.error(`\n[fail] Could not run ${PACKAGE_NAME}${target}: ${err.message}`);
+        console.error(`[fail] Could not run ${PACKAGE_NAME}${target}: ${err.message}`);
         process.exitCode = 1;
     }
 }

package/cli/usage.js

@@ -1,9 +1,10 @@
 // cli/usage.ts — ledger + session-token usage report, tokscale-style.
-import { co2GramsFor, energyWhFor, importSessionTokens, ledgerPath, priceFor, readResetWatermark, readUsage, sessionsDir, usdCost, } from '../extensions/shared/usage-ledger.js';
+import { co2GramsFor, energyWhFor, importSessionTokens, ledgerPath, priceFor, readResetWatermark, readUsage, refreshPricesIfStale, sessionsDir, usdCost, } from '../extensions/shared/usage-ledger.js';
 import { readRtkGain } from '../extensions/shared/rtk-gain.js';
 import { withInteractiveSpinner } from './interactive.js';
 import { PACKAGE_VERSION } from './common.js';
 export function summarizeUsage(rows) {
+    refreshPricesIfStale();
     const byKind = {};
     const detailCounts = {};
     for (const r of rows) {

package/dashboard/app.js

@@ -879,14 +879,29 @@
     els.forEach(function(el) { if (!seen.has(el)) io.observe(el); });
   }
 
+  var lastJson = '';
   function load() {
-    fetch('data.json').then(function(r) { return r.json(); }).then(render).catch(function() {
+    // Served mode only: file:// exports have no data.json endpoint, so
+    // polling there would just burn cycles on 404s.
+    if (window.location.protocol === 'file:') return;
+    // Skip background tabs: no render work while hidden, instant refresh on return.
+    if (document.hidden) return;
+    fetch('data.json').then(function(r) { return r.json(); }).then(function(d) {
+      var json = JSON.stringify(d);
+      if (json === lastJson) return;
+      lastJson = json;
+      render(d);
+    }).catch(function() {
       var cards = document.getElementById('modelCards');
       if (cards && !cards.children.length) cards.innerHTML = '<div class="empty md:col-span-3">' + emptyState('cloud-off', 'Could not load data', 'Serve with tersio gain instead of opening this file directly.') + '</div>';
       if (window.lucide) lucide.createIcons();
       observe();
     });
   }
+  // Live view: re-read data.json every 5s while served and visible; identical
+  // payloads skip render. The manual Reload button stays as an instant refresh.
+  setInterval(load, 5000);
+  document.addEventListener('visibilitychange', function() { if (!document.hidden) load(); });
   function toast(title, desc, icon) {
     var wrap = document.querySelector('.toaster');
     if (!wrap) {

package/extensions/combo-toggle/index.js

@@ -3,8 +3,8 @@
 import os from 'node:os';
 import path from 'node:path';
 import { createRequire } from 'node:module';
-import { activeModesSummary, asPromptArray, COMBO_LEVELS, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, normalizeComboLevel, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, setSharedComboListener, systemPromptIncludes, } from '../shared/session-state.js';
-import { readComboDefault } from '../shared/plugin-settings.js';
+import { activeModesSummary, asPromptArray, COMBO_LEVELS, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, normalizeComboLevel, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, setSharedComboListener, setSharedComboMode, systemPromptIncludes, } from '../shared/session-state.js';
+import { readComboDefault, readPonytailDefault } from '../shared/plugin-settings.js';
 const require = createRequire(import.meta.url);
 const PONYTAIL_FALLBACK_INTENSITY = {
     lite: 'Prefer the simplest correct solution.',
@@ -120,9 +120,13 @@ export default function comboToggleExtension(pi) {
         track(ctx);
         if (!ctx?.hasUI)
             syncStatus(ctx);
-        // Installer/user-configured default applies only to a fresh session with
-        // no persisted state — real session state always wins.
-        if (getSharedComboState().level === 'off' && !sessionEntries(ctx).length) {
+        // Installer/user-configured default applies only when no persisted *mode*
+        // state exists — unrelated session entries must not block it, or the
+        // combo bar never paints on sessions that already carry other entries.
+        const entries = sessionEntries(ctx);
+        const hasModeState = entries.some((e) => e?.type === 'custom' && (e.customType === 'combo-level' || e.customType === 'caveman-mode' ||
+            e.customType === 'rtk-mode' || e.customType === 'ponytail-mode'));
+        if (getSharedComboState().level === 'off' && !hasModeState) {
             const fallback = readComboDefault();
             if (fallback !== 'off') {
                 persistPreset(fallback);
@@ -130,6 +134,17 @@ export default function comboToggleExtension(pi) {
                 ctx?.ui?.notify?.(`Combo default applied: ${fallback} — ${activeModesSummary(getSharedComboState())} active for this session.`, 'info');
             }
         }
+        // Standalone ponytail default: no sibling extension restores it (upstream
+        // owns the command), so apply it here when nothing persisted a
+        // ponytail-mode entry. Skipped when it matches the active preset — the
+        // preset entry already covers that, no redundant write.
+        if (!entries.some((e) => e?.type === 'custom' && e.customType === 'ponytail-mode')) {
+            const ponytailFallback = readPonytailDefault();
+            if (ponytailFallback !== 'off' && ponytailFallback !== getSharedComboState().ponytail) {
+                pi.appendEntry?.('ponytail-mode', { mode: ponytailFallback });
+                useState(setSharedComboMode('ponytail', ponytailFallback), ctx);
+            }
+        }
     });
     for (const event of ['session_branch', 'session_tree', 'agent_start']) {
         pi.on(event, async (_event, ctx) => {

package/extensions/shared/plugin-settings.js

@@ -31,6 +31,7 @@ export function readPluginSettings() {
 }
 const COMBO_LEVELS = new Set(['off', 'medium', 'balanced', 'max']);
 const CAVEMAN_MODES = new Set(['off', 'lite', 'full', 'ultra', 'wenyan']);
+const PONYTAIL_MODES = new Set(['off', 'lite', 'full', 'ultra', 'review']);
 function readStringDefault(key, valid) {
     const raw = readPluginSettings()[key];
     return typeof raw === 'string' && valid.has(raw) ? raw : 'off';
@@ -45,3 +46,6 @@ export function readRtkDefault() {
     const raw = readPluginSettings().rtkDefault;
     return typeof raw === 'boolean' ? raw : false;
 }
+export function readPonytailDefault() {
+    return readStringDefault('ponytailDefault', PONYTAIL_MODES);
+}

package/extensions/shared/pricing.js

@@ -1,25 +1,19 @@
-// extensions/shared/pricing.ts — model pricing with live LiteLLM refresh.
-// Lookup order: exact id in the live cache → built-in substring table → default.
-// Network only in refreshPrices (called from `tersio update`); every reader is
-// sync and offline-safe. Best-effort throughout: pricing never breaks a caller.
+// extensions/shared/pricing.ts — dynamic model pricing from LiteLLM.
+// Lookup order: exact id in the live cache → provider-prefix strip → default.
+// The cache is the full LiteLLM feed (3k+ ids), refreshed lazily in background
+// and on `tersio update`; every reader is sync and offline-safe. No static
+// per-model table — list prices rot, the feed does not. Unknown models report
+// the default with known:false so the dashboard labels them honestly.
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-// Rough list rates (USD per 1M tokens) for the models OMP sessions cite.
-// Refresh against LiteLLM pricing data when adding families.
-const PRICE_TABLE = [
-    { match: ':free', price: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } },
-    { match: 'opus', price: { input: 15, output: 75, cacheRead: 1.5, cacheWrite: 18.75 } },
-    { match: 'sonnet', price: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 } },
-    { match: 'haiku', price: { input: 0.8, output: 4, cacheRead: 0.08, cacheWrite: 1 } },
-    { match: 'gpt', price: { input: 2.5, output: 10, cacheRead: 1.25, cacheWrite: 2.5 } },
-    { match: 'gemini', price: { input: 1.25, output: 10, cacheRead: 0.125, cacheWrite: 1.25 } },
-    { match: 'glm', price: { input: 0.5, output: 1, cacheRead: 0.05, cacheWrite: 0.5 } },
-];
-export const DEFAULT_PRICE = { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 };
+// Sonnet-class default for unpriced models; always paired with known:false.
+export const DEFAULT_PRICE = { input: 2, output: 10, cacheRead: 0.2, cacheWrite: 2.5 };
 const LITELLM_URL = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json';
+// Live cache refreshes lazily: readers use the file even when stale, and only
+// one refresh runs per process. `tersio update` still forces a fresh fetch.
 const CACHE_TTL_MS = 7 * 24 * 3600 * 1000;
-const KEEP_RE = /claude|sonnet|opus|haiku|gpt|gemini|glm|deepseek|qwen|kimi|mistral|grok|llama|muse|nemotron|ministral|codestral|qwen/i;
+let refreshInflight = null;
 export function pricesCachePath() {
     const override = process.env.TERSIO_PRICES_FILE;
     if (override)
@@ -29,6 +23,23 @@ export function pricesCachePath() {
 export function pricesUrl() {
     return process.env.TERSIO_PRICES_URL || LITELLM_URL;
 }
+function toPrice(t) {
+    return { input: t[0], output: t[1], cacheRead: t[2], cacheWrite: t[3] };
+}
+// Tolerate both cache shapes: compact tuples (new) and ModelPrice objects
+// (written by older refreshes) — a version bump never orphans the cache.
+function asPrice(v) {
+    if (Array.isArray(v) && v.length === 4 && v.every((n) => typeof n === 'number' && Number.isFinite(n) && n >= 0)) {
+        return toPrice(v);
+    }
+    if (v && typeof v === 'object') {
+        const o = v;
+        if (['input', 'output', 'cacheRead', 'cacheWrite'].every((k) => typeof o[k] === 'number' && Number.isFinite(o[k]) && o[k] >= 0)) {
+            return o;
+        }
+    }
+    return null;
+}
 export function loadLivePrices() {
     let raw;
     try {
@@ -41,9 +52,17 @@ export function loadLivePrices() {
         const parsed = JSON.parse(raw);
         if (typeof parsed.fetchedAt !== 'number' || !parsed.exact || typeof parsed.exact !== 'object')
             return null;
-        if (Date.now() - parsed.fetchedAt > CACHE_TTL_MS)
+        const exact = {};
+        for (const [k, v] of Object.entries(parsed.exact)) {
+            const p = asPrice(v);
+            if (p)
+                exact[k] = [p.input, p.output, p.cacheRead, p.cacheWrite];
+        }
+        if (!Object.keys(exact).length)
             return null;
-        return { fetchedAt: parsed.fetchedAt, exact: parsed.exact };
+        // Stale entries stay usable; refreshPricesIfStale refreshes in background.
+        const deprecated = Array.isArray(parsed.deprecated) ? parsed.deprecated.filter((d) => typeof d === 'string') : [];
+        return { fetchedAt: parsed.fetchedAt, exact, deprecated };
     }
     catch {
         return null;
@@ -55,67 +74,90 @@ function num(v) {
 export function priceFor(model, live) {
     const table = live === undefined ? loadLivePrices() : live;
     if (table) {
-        const hit = table.exact[model] ?? table.exact[model.toLowerCase()];
-        if (hit && [hit.input, hit.output, hit.cacheRead, hit.cacheWrite].every((v) => typeof v === 'number')) {
+        const hit = asPrice(table.exact[model] ?? table.exact[model.toLowerCase()]);
+        if (hit)
             return { price: hit, known: true, live: true };
-        }
-    }
-    const name = model.toLowerCase();
-    for (const row of PRICE_TABLE) {
-        if (name.includes(row.match))
-            return { price: row.price, known: true, live: false };
+        // Provider-prefixed ids ("azure/gpt-4o", "dashscope/qwen-max"): match the
+        // first cached id that ends with the bare model name.
+        const name = model.toLowerCase();
+        const key = Object.keys(table.exact).find((k) => k.toLowerCase() === name || k.toLowerCase().endsWith(`/${name}`));
+        const prefixed = key ? asPrice(table.exact[key]) : null;
+        if (prefixed)
+            return { price: prefixed, known: true, live: true };
     }
     return { price: DEFAULT_PRICE, known: false, live: false };
 }
-// Fetch LiteLLM pricing, keep relevant families, write the cache. False on
-// any failure (offline, timeout, shape change) — callers fall back silently.
+// Fetch LiteLLM pricing, keep every id with valid input/output rates, write
+// the cache. False on any failure (offline, timeout, shape change) — callers
+// fall back silently.
 export async function refreshPrices() {
-    let res;
-    try {
-        const ctl = new AbortController();
-        const timer = setTimeout(() => ctl.abort(), 15000);
+    if (refreshInflight)
+        return refreshInflight;
+    refreshInflight = (async () => {
+        let res;
         try {
-            res = await fetch(pricesUrl(), { signal: ctl.signal });
+            const ctl = new AbortController();
+            const timer = setTimeout(() => ctl.abort(), 15000);
+            try {
+                res = await fetch(pricesUrl(), { signal: ctl.signal });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!res.ok)
+                return false;
+        }
+        catch {
+            return false;
         }
-        finally {
-            clearTimeout(timer);
+        let data;
+        try {
+            data = (await res.json());
         }
-        if (!res.ok)
+        catch {
             return false;
-    }
-    catch {
-        return false;
-    }
-    let data;
-    try {
-        data = (await res.json());
-    }
-    catch {
-        return false;
-    }
-    const exact = {};
-    for (const [id, row] of Object.entries(data)) {
-        if (!row || typeof row !== 'object' || !KEEP_RE.test(id))
-            continue;
-        const input = num(row.input_cost_per_token);
-        const output = num(row.output_cost_per_token);
-        if (input === null || output === null)
-            continue;
-        exact[id] = {
-            input: input * 1e6,
-            output: output * 1e6,
-            cacheRead: (num(row.cache_read_input_token_cost) ?? input) * 1e6,
-            cacheWrite: (num(row.cache_creation_input_token_cost) ?? input) * 1e6,
-        };
-    }
-    if (!Object.keys(exact).length)
-        return false;
+        }
+        const exact = {};
+        const deprecated = [];
+        for (const [id, row] of Object.entries(data)) {
+            if (!row || typeof row !== 'object')
+                continue;
+            const input = num(row.input_cost_per_token);
+            const output = num(row.output_cost_per_token);
+            if (input === null || output === null)
+                continue;
+            exact[id] = [
+                input * 1e6,
+                output * 1e6,
+                (num(row.cache_read_input_token_cost) ?? input) * 1e6,
+                (num(row.cache_creation_input_token_cost) ?? input) * 1e6,
+            ];
+            if (typeof row.deprecation_date === 'string' && row.deprecation_date)
+                deprecated.push(id);
+        }
+        if (!Object.keys(exact).length)
+            return false;
+        try {
+            fs.mkdirSync(path.dirname(pricesCachePath()), { recursive: true });
+            fs.writeFileSync(pricesCachePath(), JSON.stringify({ fetchedAt: Date.now(), exact, deprecated }), 'utf8');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    })();
     try {
-        fs.mkdirSync(path.dirname(pricesCachePath()), { recursive: true });
-        fs.writeFileSync(pricesCachePath(), JSON.stringify({ fetchedAt: Date.now(), exact }), 'utf8');
-        return true;
+        return await refreshInflight;
     }
-    catch {
-        return false;
+    finally {
+        refreshInflight = null;
     }
 }
+// Fire-and-forget refresh when the cache is stale or missing. Readers keep
+// using the stale file (or the built-in table) — pricing never blocks.
+export function refreshPricesIfStale() {
+    const live = loadLivePrices();
+    if (live && Date.now() - live.fetchedAt <= CACHE_TTL_MS)
+        return;
+    void refreshPrices().catch(() => false);
+}

package/extensions/shared/usage-ledger.js

@@ -215,9 +215,9 @@ function leadBinary(command) {
     return 'bash';
 }
 // --- Pricing lives in ./pricing.ts (live LiteLLM cache + fallback table) ---
-import { DEFAULT_PRICE, priceFor } from './pricing.js';
+import { DEFAULT_PRICE, priceFor, refreshPricesIfStale } from './pricing.js';
 import { co2GramsFor, energyWhFor } from './carbon.js';
-export { DEFAULT_PRICE, priceFor };
+export { DEFAULT_PRICE, priceFor, refreshPricesIfStale };
 export { co2GramsFor, energyWhFor };
 export function usdCost(t, model) {
     const { price, known } = model ? priceFor(model) : { price: DEFAULT_PRICE, known: false };

package/extensions/tersio-commands/index.js

@@ -1,25 +1,21 @@
-// /tersio unified root command — routes every tersio capability through one
-// namespaced entrypoint. Aliases (/caveman, /rtk, /combo, /ai-addons) keep
-// working: this router drives the same shared bridge + session entries the
-// sibling extensions restore from. Shared-state publishes sync their local
-// mirrors live, so switches notify and take effect next turn — no reload.
-import { COMBO_LEVELS, activeModesSummary, getSharedComboState, normalizeComboLevel, normalizeMode, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, setSharedComboMode, } from '../shared/session-state.js';
+// /tersio root command — status, check, update, gain, usage, help.
+// Mode switches live on their own commands (/caveman, /rtk, /combo, and the
+// upstream /ponytail): the router keeps no redundant copies. Shared-state
+// publishes sync sibling mirrors live, so switches notify and take effect
+// next turn — no reload.
+import { getSharedComboState, reconcileSharedComboEntries, sessionEntries, } from '../shared/session-state.js';
 import os from 'node:os';
 import path from 'node:path';
 import { appendUsage, readUsage } from '../shared/usage-ledger.js';
 import { checkAddonsSummary, runAddonUpdate } from '../ai-addons-updater/index.js';
 const HELP = [
-    '/tersio caveman lite|full|ultra|wenyan|off — terse-reply mode',
-    '/tersio combo off|medium|balanced|max — preset for all three modes',
-    '/tersio rtk on|off — compact shell output',
-    '/tersio ponytail off|lite|full|ultra|review — minimal code',
     '/tersio status — active modes + combo level',
     '/tersio check — add-on version check',
     '/tersio update <ponytail|rtk|caveman|all> [--dry-run]',
     '/tersio gain — savings summary + dashboard hint',
     '/tersio usage — ledger report for this machine',
     '/tersio help — this table',
-    'aliases (still work): /caveman /rtk /combo /ai-addons',
+    'mode switches: /caveman /rtk /combo (tersio) + /ponytail (upstream)',
 ].join('\n');
 function statusLine() {
     const s = getSharedComboState();
@@ -56,14 +52,11 @@ async function openGainDashboard(pi, ctx) {
 }
 export default function tersioCommandsExtension(pi) {
     pi.setLabel?.('Tersio unified root command');
-    // Mode switches never reload the session: entries persist, the shared
-    // bridge publishes to every sibling mirror, and the change injects on the
-    // next turn like a normal input message. Only notify below.
     pi.registerCommand?.('tersio', {
-        description: 'Tersio root: caveman|combo|rtk|ponytail|status|check|update|gain|usage|help',
+        description: 'Tersio root: status|check|update|gain|usage|help (modes: /caveman /rtk /combo /ponytail)',
         handler: async (args, ctx) => {
             const parts = String(args || '').trim().toLowerCase().split(/\s+/).filter(Boolean);
-            const [sub, rest] = [parts[0], parts.slice(1).join(' ')];
+            const [sub] = [parts[0]];
             appendUsage('command', `/tersio ${parts.join(' ')}`.trim());
             if (!sub || sub === 'status') {
                 if (ctx?.hasUI)
@@ -75,69 +68,6 @@ export default function tersioCommandsExtension(pi) {
                 ctx?.ui?.notify?.(HELP, 'info');
                 return;
             }
-            if (sub === 'caveman') {
-                const mode = normalizeMode('caveman', rest);
-                if (!mode) {
-                    ctx?.ui?.notify?.('Usage: /tersio caveman [lite|full|ultra|wenyan|off|status]', 'warning');
-                    return;
-                }
-                pi.appendEntry?.('caveman-mode', { mode });
-                setSharedComboMode('caveman', mode);
-                appendUsage('toggle', `caveman=${mode}`);
-                ctx?.ui?.notify?.(`Caveman ${mode} on — Active: ${activeModesSummary(getSharedComboState())}.`, 'info');
-                return;
-            }
-            if (sub === 'rtk') {
-                if (!rest || rest === 'status') {
-                    const on = getSharedComboState().rtk === 'on';
-                    ctx?.ui?.notify?.(`RTK: ${on ? 'on' : 'off'}`, 'info');
-                    return;
-                }
-                if (!['on', 'off'].includes(rest)) {
-                    ctx?.ui?.notify?.('Usage: /tersio rtk [on|off|status]', 'warning');
-                    return;
-                }
-                const enabled = rest === 'on';
-                pi.appendEntry?.('rtk-mode', { enabled });
-                setSharedComboMode('rtk', enabled);
-                appendUsage('toggle', `rtk=${rest}`);
-                ctx?.ui?.notify?.(`RTK ${rest} — Active: ${activeModesSummary(getSharedComboState())}.`, 'info');
-                return;
-            }
-            if (sub === 'ponytail') {
-                const mode = normalizeMode('ponytail', rest);
-                if (!mode) {
-                    ctx?.ui?.notify?.('Usage: /tersio ponytail [off|lite|full|ultra|review|status]', 'warning');
-                    return;
-                }
-                pi.appendEntry?.('ponytail-mode', { mode });
-                setSharedComboMode('ponytail', mode);
-                appendUsage('toggle', `ponytail=${mode}`);
-                ctx?.ui?.notify?.(`Ponytail ${mode} — Active: ${activeModesSummary(getSharedComboState())}.`, 'info');
-                return;
-            }
-            if (sub === 'combo') {
-                if (!rest || rest === 'status') {
-                    if (ctx?.hasUI)
-                        reconcileSharedComboEntries(sessionEntries(ctx));
-                    ctx?.ui?.notify?.(statusLine(), 'info');
-                    return;
-                }
-                const level = normalizeComboLevel(rest);
-                if (!level) {
-                    ctx?.ui?.notify?.('Unknown combo level. Use: off | medium | balanced | max', 'warning');
-                    return;
-                }
-                const modes = COMBO_LEVELS[level];
-                pi.appendEntry?.('caveman-mode', { mode: modes.caveman });
-                pi.appendEntry?.('rtk-mode', { enabled: modes.rtk === 'on' });
-                pi.appendEntry?.('ponytail-mode', { mode: modes.ponytail });
-                pi.appendEntry?.('combo-level', { level });
-                setSharedComboLevel(level);
-                appendUsage('toggle', `combo=${level}`);
-                ctx?.ui?.notify?.(`Combo ${level} on — ${activeModesSummary(getSharedComboState())} active for this session.`, 'info');
-                return;
-            }
             if (sub === 'check') {
                 await checkAddonsSummary(ctx);
                 return;
@@ -160,6 +90,12 @@ export default function tersioCommandsExtension(pi) {
                 ctx?.ui?.notify?.(usageSummary(), 'info');
                 return;
             }
+            // Removed mode switches redirect to their own commands so only one
+            // spelling exists to learn: /caveman, /rtk, /combo, /ponytail.
+            if (sub === 'caveman' || sub === 'rtk' || sub === 'combo' || sub === 'ponytail') {
+                ctx?.ui?.notify?.(`Use /${sub} instead — /tersio no longer duplicates mode switches.\n${HELP}`, 'warning');
+                return;
+            }
             ctx?.ui?.notify?.(`Unknown subcommand: ${sub}.\n${HELP}`, 'warning');
         },
     });

package/package.json

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