@krtclcdy/tersio 2.6.0 → 2.7.0

package/README.md

@@ -94,40 +94,17 @@ Everything runs under one root. Bare `/tersio` prints status.
 
 | Command | Purpose |
 |---|---|
-| `/tersio combo off\|medium\|balanced\|max\|status` | preset for all three modes (start here) |
-| `/tersio caveman lite\|full\|ultra\|wenyan\|off\|status` | terse-reply mode |
-| `/tersio rtk on\|off\|status` | compact shell-output toggle |
-| `/tersio ponytail off\|lite\|full\|ultra\|review\|status` | minimal-code level |
-| `/tersio status` | active modes + combo level |
-| `/tersio check` | add-on version check (same as old `/ai-addons check`) |
-| `/tersio update <ponytail\|rtk\|caveman\|all> [--dry-run]` | update add-ons, preview with dry-run |
-| `/tersio gain` | savings summary + dashboard hint |
-| `/tersio usage` | ledger report for this machine |
-| `/tersio help` | this table |
-
-### Combo — one preset for all three
-
-Start here: one setting drives all three modes (`medium` = lite/lite/on, `balanced` = full/full/on, `max` = ultra/ultra/on, `off` = normal). Tweaking a mode individually drops to a `custom` mix.
-
-### Caveman — terse replies
-
-Pleasantries and restatements go; substance stays. Ladder: `lite`, `full`, `ultra` (fragments only), `wenyan` (compressed classical-Chinese-inspired register).
-
-### RTK — compact shell output
-
-A real binary, not a prompt trick: `rtk git status|diff|grep|test|tsc|lint` strips noise before output reaches the model. Exact bytes (checksums, patches) bypass it by policy.
-
-### Ponytail — minimal code (YAGNI)
-
-You Aren't Gonna Need It: smallest working change, no speculative abstractions, no new deps for stdlib jobs. `lite` nudges, `full` enforces, `ultra` challenges the requirement, `review` audits for over-engineering.
-
-`/tersio` persists state and reloads OMP without emitting separate command messages. Presets propagate to task subagents and light the Combo footer indicator; mixed individual settings report via `/tersio status`.
-
-### Legacy aliases (still work)
-
-The pre-`/tersio` commands remain registered: `/caveman`, `/rtk`, `/combo`, `/ai-addons`. Prefer `/tersio` in new muscle memory; help output lists the aliases as deprecated-but-working.
-
-Usage rows land in `~/.omp/plugins/tersio-usage.jsonl` (local only); `tersio dashboard` serves them as a plain-HTML page on 127.0.0.1.
+| `/tersio combo off\|medium\|balanced\|max\|status` | One preset for all three (start here): medium = lite/lite/on, balanced = full/full/on, max = ultra/ultra/on; per-mode tweaks drop to `custom`. |
+| `/tersio caveman lite\|full\|ultra\|wenyan\|off\|status` | Terse replies (substance stays); `ultra` uses fragments only, `wenyan` a compressed classical-Chinese-inspired register. |
+| `/tersio rtk on\|off\|status` | Compact shell output via the real `rtk` binary; exact bytes (checksums, patches) bypass it by policy. |
+| `/tersio ponytail off\|lite\|full\|ultra\|review\|status` | Minimal code (YAGNI): `lite` nudges, `full` enforces, `ultra` challenges the requirement, `review` audits for over-engineering. |
+| `/tersio status` | Active modes + combo level; state persists, propagates to subagents, and lights the Combo footer indicator. |
+| `/tersio check` | Add-on version check |
+| `/tersio update <ponytail\|rtk\|caveman\|all> [--dry-run]` | Update add-ons, preview with dry-run |
+| `/tersio gain` | Savings summary; the gain dashboard charts `~/.omp/plugins/tersio-usage.jsonl` (`tersio dashboard` serves on 127.0.0.1, `--export` writes one file). |
+| `/tersio usage` | Ledger report for this machine (rows in `~/.omp/plugins/tersio-usage.jsonl`, local only) |
+| `/tersio help` | This table |
+| `/caveman`, `/rtk`, `/combo`, `/ai-addons` | Legacy aliases, still work; prefer `/tersio`. |
 
 ## Files and backups
 

package/cli/doctor.js

@@ -22,6 +22,7 @@ async function runDoctor() {
     const rtkIndex = path.join(extDir, 'rtk-session', 'index.js');
     const updaterIndex = path.join(extDir, 'ai-addons-updater', 'index.js');
     const comboIndex = path.join(extDir, 'combo-toggle', 'index.js');
+    const tersioIndex = path.join(extDir, 'tersio-commands', 'index.js');
     const modeReinforcement = path.join(extDir, 'shared', 'mode-reinforcement.js');
     const selfPkg = path.join(pluginsDir, 'node_modules', PACKAGE_NAME, 'package.json');
     // Independent probes start concurrently; sections report in fixed order as
@@ -42,6 +43,7 @@ async function runDoctor() {
         rtkIndexText: readTextIfExists(rtkIndex),
         updaterIndexText: readTextIfExists(updaterIndex),
         comboIndexText: readTextIfExists(comboIndex),
+        tersioIndexText: readTextIfExists(tersioIndex),
         modeReinforcementText: readTextIfExists(modeReinforcement),
         ruleMtime: fs.stat(cavemanRule).catch(() => null),
         rtkMtime: fs.stat(rtkBin).catch(() => null),
@@ -60,11 +62,12 @@ async function runDoctor() {
         probes.configText,
         probes.updateVersion,
     ]));
-    const [cavemanIndexText, rtkIndexText, updaterIndexText, comboIndexText, modeReinforcementText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText] = await runInteractivePhase('Checking extensions and plugins', () => Promise.all([
+    const [cavemanIndexText, rtkIndexText, updaterIndexText, comboIndexText, tersioIndexText, modeReinforcementText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText] = await runInteractivePhase('Checking extensions and plugins', () => Promise.all([
         probes.cavemanIndexText,
         probes.rtkIndexText,
         probes.updaterIndexText,
         probes.comboIndexText,
+        probes.tersioIndexText,
         probes.modeReinforcementText,
         probes.ponytailPkgText,
         probes.ponytailExtText,
@@ -113,6 +116,7 @@ async function runDoctor() {
     check('RTK extension', rtkIndexText !== null);
     check('Updater extension', updaterIndexText !== null);
     check('Combo extension', comboIndexText !== null);
+    check('Tersio commands extension', tersioIndexText !== null);
     check('Mode reinforcement extension', modeReinforcementText !== null);
     section('Plugins');
     check('Ponytail package', ponytailPkgText !== null);

package/cli/install.js

@@ -3,10 +3,13 @@ import { promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { BUN_BIN_DIR, COMBO_PRESET_MODES, EXTENSIONS_KEY_RE, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, SCOPE_MAP, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, scopeFlag, verbose, yes, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
-import { ask, askInteractiveChoice, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
-import { checkForUpdate } from './update.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, SCOPE_MAP, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, scopeFlag, verbose, yes, dashboardExport, dashboardOpen, dashboardPort, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
+import { ask, askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
+import { checkForUpdate, runLatestUpdate } from './update.js';
 import { runUninstall } from './uninstall.js';
+import { runDoctor } from './doctor.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';
 // Paths to extension source files (relative to this script)
 const EXT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'extensions');
@@ -15,6 +18,7 @@ const CAVEMAN_INDEX = path.join(EXT_DIR, 'caveman-session', 'index.js');
 const RTK_SESSION_INDEX = path.join(EXT_DIR, 'rtk-session', 'index.js');
 const UPDATER_INDEX = path.join(EXT_DIR, 'ai-addons-updater', 'index.js');
 const COMBO_TOGGLE_INDEX = path.join(EXT_DIR, 'combo-toggle', 'index.js');
+const TERSIO_COMMANDS_INDEX = path.join(EXT_DIR, 'tersio-commands', 'index.js');
 const MODE_REINFORCEMENT_INDEX = path.join(EXT_DIR, 'shared', 'mode-reinforcement.js');
 const SHARED_TYPES = path.join(EXT_DIR, 'shared', 'types.js');
 const LIB_UTILS = path.join(EXT_DIR, 'lib', 'utils.js');
@@ -22,7 +26,7 @@ const SHARED_PLUGIN_SETTINGS = path.join(EXT_DIR, 'shared', 'plugin-settings.js'
 const PONYTAIL_GITHUB_SPEC = 'github:DietrichGebert/ponytail';
 const PONYTAIL_NPM_SPEC = '@dietrichgebert/ponytail@latest';
 async function stepPonytail(pluginsDir, userDir, options) {
-    console.log('\n[1/7] Installing Ponytail plugin...');
+    console.log('\n[1/8] Installing Ponytail plugin...');
     await fs.mkdir(pluginsDir, { recursive: true });
     const pkgPath = path.join(pluginsDir, 'package.json');
     const pkg = await readPluginsPackage(pkgPath);
@@ -124,7 +128,7 @@ async function stepPonytail(pluginsDir, userDir, options) {
 // Settings → Plugins page (OMP enumerates plugins/package.json dependencies).
 // Returns true when the package is verified in plugins/node_modules.
 async function stepSelfPlugin(pluginsDir, options) {
-    console.log('\n[2/7] Registering tersio as OMP plugin...');
+    console.log('\n[2/8] Registering tersio as OMP plugin...');
     const pkgPath = path.join(pluginsDir, 'package.json');
     const pkg = await readPluginsPackage(pkgPath);
     pkg.dependencies[PACKAGE_NAME] = `^${PACKAGE_VERSION}`;
@@ -253,7 +257,7 @@ async function extractRtkArchive(archivePath, extractDir) {
     return false;
 }
 async function stepRtk(binDir, options) {
-    console.log('\n[3/7] Installing RTK binary...');
+    console.log('\n[3/8] Installing RTK binary...');
     try {
         const release = await withInteractiveSpinner('Finding latest RTK release', () => fetchJson(RTK_RELEASE_API));
         const triple = resolveRtkTriple();
@@ -342,14 +346,14 @@ async function stepSharedSessionState(extDir, options) {
     ], 'shared/session-state.js', options);
 }
 async function stepModeReinforcement(extDir, ponytailExtPath, options) {
-    console.log('\n[7/7] Installing mode reinforcement extension...');
+    console.log('\n[8/8] Installing mode reinforcement extension...');
     const dest = path.join(extDir, 'shared', 'mode-reinforcement.js');
     if (!await copySources(extDir, [[MODE_REINFORCEMENT_INDEX, path.join('shared', 'mode-reinforcement.js')]], 'shared/mode-reinforcement.js', options))
         return;
     await ensureExtensionAfterConfigEntry(path.join(path.dirname(extDir), 'config.yml'), dest, ponytailExtPath, 'mode reinforcement', options);
 }
 async function stepRtkSession(extDir, options) {
-    console.log('\n[4/7] Installing RTK session extension...');
+    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
@@ -366,7 +370,7 @@ async function fetchCavemanRule(options) {
     }
 }
 async function stepCaveman(extDir, rule, options) {
-    console.log('\n[5/7] Installing Caveman session extension...');
+    console.log('\n[5/8] Installing Caveman session extension...');
     const cavemanDir = path.join(extDir, 'caveman-session');
     if (!options.dryRun)
         await fs.mkdir(cavemanDir, { recursive: true });
@@ -383,11 +387,15 @@ async function stepCaveman(extDir, rule, options) {
     }
     await copySources(extDir, [[CAVEMAN_INDEX, path.join('caveman-session', 'index.js')]], 'caveman-session/index.js', options);
 }
+async function stepTersioCommands(extDir, options) {
+    console.log('\n[7/8] Installing Tersio root-command extension...');
+    await copySources(extDir, [[TERSIO_COMMANDS_INDEX, path.join('tersio-commands', 'index.js')]], 'tersio-commands/index.js', options);
+}
 async function stepUpdater(extDir, options) {
     await copySources(extDir, [[UPDATER_INDEX, path.join('ai-addons-updater', 'index.js')]], 'ai-addons-updater/index.js', options);
 }
 async function stepCombo(extDir, options) {
-    console.log('\n[6/7] Installing Combo toggle extension...');
+    console.log('\n[6/8] Installing Combo toggle extension...');
     const dest = path.join(extDir, 'combo-toggle', 'index.js');
     if (!await copySources(extDir, [[COMBO_TOGGLE_INDEX, path.join('combo-toggle', 'index.js')]], 'combo-toggle/index.js', options))
         return;
@@ -536,7 +544,81 @@ async function writePluginSettings(profile, options) {
     await fs.writeFile(lockPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
     console.log(`  [write] Plugin settings in ${lockPath}`);
 }
+let updatePromptDone = false;
+// Bare `tersio` at a terminal is a command picker, not an install run:
+// 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() {
+    const newer = await checkForUpdate();
+    if (newer && !dryRun) {
+        const answer = await askInteractiveConfirm(`tersio ${newer} is available (installed ${PACKAGE_VERSION}). Install it now?`);
+        if (answer.status === 'confirmed' && answer.value) {
+            await runLatestUpdate();
+            closeRL();
+            return;
+        }
+        if (answer.status === 'cancelled') {
+            closeRL();
+            process.exit(130);
+        }
+        console.log(`\n  [update] staying on ${PACKAGE_VERSION} — run ` + '`tersio update`' + ` anytime`);
+    }
+    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: '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: 'dashboard', label: 'Serve dashboard', hint: 'localhost server, no browser' },
+        { value: 'uninstall', label: 'Uninstall', hint: 'remove tersio' },
+    ], 'install');
+    if (choice.status !== 'selected') {
+        closeRL();
+        process.exit(130);
+    }
+    switch (choice.value) {
+        case 'install':
+            await runInstall();
+            break;
+        case 'check': {
+            const latest = await checkForUpdate();
+            console.log(latest ? `  [update] tersio ${latest} available (installed ${PACKAGE_VERSION})` : `  [ok] tersio ${PACKAGE_VERSION} is the latest`);
+            closeRL();
+            break;
+        }
+        case 'update':
+            await runLatestUpdate();
+            closeRL();
+            break;
+        case 'doctor':
+            await runDoctor();
+            closeRL();
+            break;
+        case 'usage':
+            await runUsage();
+            closeRL();
+            break;
+        case 'gain':
+            await runDashboard({ port: dashboardPort, open: true, exportFile: null });
+            closeRL();
+            break;
+        case 'dashboard':
+            await runDashboard({ port: dashboardPort, open: dashboardOpen, exportFile: dashboardExport });
+            closeRL();
+            break;
+        case 'uninstall':
+            await runUninstall();
+            closeRL();
+            break;
+    }
+}
 async function runInstall() {
+    if (command === null && tty() && !yes) {
+        await runCommandMenu();
+        return;
+    }
     if (reinstall) {
         await runUninstall({ yes: true, removePonytail: false, removeRtk: true });
     }
@@ -550,8 +632,27 @@ async function runInstall() {
     // the apply-update payload, which is itself an update run.
     if (tty() && !applyUpdate && command !== 'uninstall') {
         const newer = await checkForUpdate();
-        if (newer)
-            console.log(`\n  [update] tersio ${newer} available (installed ${PACKAGE_VERSION}) — run \`tersio update\``);
+        if (newer) {
+            // Bare `tersio` with an update pending: offer it now (Y/n) instead of
+            // burying the banner above the install prompts. Yes runs the full
+            // update and stops here — the fresh binary owns what follows.
+            if (command === null && !dryRun && !yes && !updatePromptDone) {
+                const answer = await askInteractiveConfirm(`tersio ${newer} is available (installed ${PACKAGE_VERSION}). Install it now?`);
+                if (answer.status === 'confirmed' && answer.value) {
+                    await runLatestUpdate();
+                    closeRL();
+                    return;
+                }
+                if (answer.status === 'cancelled') {
+                    closeRL();
+                    process.exit(130);
+                }
+                console.log(`\n  [update] staying on ${PACKAGE_VERSION} — run \`tersio update\` anytime`);
+            }
+            else {
+                console.log(`\n  [update] tersio ${newer} available (installed ${PACKAGE_VERSION}) — run \`tersio update\``);
+            }
+        }
     }
     const scope = await resolveScope();
     // Resolve session defaults: flags > interactive prompt > defaults.
@@ -583,6 +684,7 @@ async function runInstall() {
         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)
@@ -594,6 +696,7 @@ async function runInstall() {
         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');
     }

package/cli/interactive.js

@@ -1,6 +1,6 @@
 // cli/interactive.ts — TTY layer: readline, Clack spinners, selects, task phases.
 import readline from 'node:readline';
-import { cancel as clackCancel, select as clackSelect, spinner as clackSpinner, tasks as clackTasks } from '@clack/prompts';
+import { cancel as clackCancel, confirm as clackConfirm, select as clackSelect, spinner as clackSpinner, tasks as clackTasks } from '@clack/prompts';
 import { execP } from './common.js';
 const RL = readline.createInterface({ input: process.stdin, output: process.stdout });
 let rlOpen = true;
@@ -56,6 +56,17 @@ async function askInteractiveChoice(message, options, initialValue) {
     }
     return { status: 'selected', value: choice };
 }
+async function askInteractiveConfirm(message, initialValue = true) {
+    if (!tty())
+        return { status: 'unavailable' };
+    closeRL();
+    const answer = await clackConfirm({ message, initialValue });
+    if (typeof answer !== 'boolean') {
+        clackCancel('Aborted.');
+        return { status: 'cancelled' };
+    }
+    return { status: 'confirmed', value: answer };
+}
 // Run collecting work under one TTY-only Clack task. Callers print after the
 // task completes, keeping normal output out of the spinner animation.
 async function runInteractivePhase(title, collect) {
@@ -69,4 +80,4 @@ async function runInteractivePhase(title, collect) {
 async function execNetwork(label, cmd, args, opts = {}) {
     return withInteractiveSpinner(label, () => execP(cmd, args, opts));
 }
-export { ask, closeRL, tty, withInteractiveSpinner, execNetwork, askInteractiveChoice, runInteractivePhase, };
+export { ask, closeRL, tty, withInteractiveSpinner, execNetwork, askInteractiveChoice, askInteractiveConfirm, runInteractivePhase, };

package/cli/uninstall.js

@@ -71,6 +71,7 @@ async function runUninstall(options = {}) {
         'rtk-session',
         'ai-addons-updater',
         'combo-toggle',
+        'tersio-commands',
         'shared',
         // Only consumed by ai-addons-updater (removed above); otherwise orphaned.
         'lib',

package/extensions/tersio-commands/index.js

@@ -4,6 +4,8 @@
 // sibling extensions restore from, then reloads so their local mirrors sync
 // (same mechanism /combo already uses to drive its siblings).
 import { COMBO_LEVELS, activeModesSummary, getSharedComboState, normalizeComboLevel, normalizeMode, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, setSharedComboMode, } 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 = [
@@ -35,6 +37,23 @@ function usageSummary() {
     const last = new Date(rows[rows.length - 1].ts).toISOString();
     return `tersio usage: ${rows.length} rows (${parts.join(', ')}), last write ${last}.`;
 }
+// Gain opens instantaneously in the default browser: export a file://-ready
+// snapshot (data inlined, no server to babysit) and open it. Falls back to
+// the shell command when export or open fails.
+async function openGainDashboard(pi, ctx) {
+    const file = path.join(os.tmpdir(), `tersio-gain-${Date.now()}.html`);
+    try {
+        const exported = await pi.exec?.('tersio', ['dashboard', '--export', file], { cwd: ctx?.cwd });
+        if (!exported || exported.code !== 0)
+            throw new Error((exported?.stderr || 'export failed').trim());
+        const openCmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+        await pi.exec?.(openCmd, [file], { cwd: ctx?.cwd });
+        ctx?.ui?.notify?.(`tersio gain: dashboard opened in your browser.`, 'info');
+    }
+    catch (e) {
+        ctx?.ui?.notify?.(`tersio gain: could not open dashboard (${e.message}). Run 'tersio dashboard --open' in a shell.`, 'warning');
+    }
+}
 export default function tersioCommandsExtension(pi) {
     pi.setLabel?.('Tersio unified root command');
     async function reload(ctx) {
@@ -138,8 +157,12 @@ export default function tersioCommandsExtension(pi) {
                 await runAddonUpdate(pi, ctx, target, dryRun);
                 return;
             }
-            if (sub === 'gain' || sub === 'usage') {
-                ctx?.ui?.notify?.(`${usageSummary()}\nFull dashboard: run \`tersio dashboard --open\` in a shell.`, 'info');
+            if (sub === 'gain') {
+                await openGainDashboard(pi, ctx);
+                return;
+            }
+            if (sub === 'usage') {
+                ctx?.ui?.notify?.(usageSummary(), 'info');
                 return;
             }
             ctx?.ui?.notify?.(`Unknown subcommand: ${sub}.\n${HELP}`, 'warning');

package/package.json

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