@krtclcdy/tersio 2.14.0 → 2.16.0

package/README.md

@@ -10,24 +10,6 @@
 
 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. The installer wires rtk into OMP automatically (`rtk init -g --agent omp`), so bash tool calls rewrite to `rtk` before execution and meter into the gain dashboard.
-- **Ponytail** — Minimal, YAGNI-oriented code decisions, from nudge (`lite`) to requirement-challenger (`ultra`).
-- **Combo** — Toggles all three at once. Presets: `off`, `medium`, `balanced`, `max`.
-- **Updater** — `/tersio check` and `/tersio update` cover Ponytail, RTK, and Caveman in-session, with dry-run and backups.
-- **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:
@@ -52,10 +34,10 @@ omp plugin features @krtclcdy/tersio --disable rtk
 Then restart OMP and enable a preset:
 
 ```text
-/tersio combo medium
+/combo balanced
 ```
 
-Individual toggles: `/tersio caveman full` · `/tersio rtk on` · `/tersio ponytail full`. Everything starts off until you enable it.
+Individual toggles: `/caveman full` · `/rtk on` · `/ponytail full`. Everything starts off until you enable it.
 
 Session-start defaults (prompted during `install`, or flags):
 
@@ -63,7 +45,7 @@ Session-start defaults (prompted during `install`, or flags):
 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`).
+Defaults apply to fresh sessions only — anything persisted with `/combo`, `/caveman`, or `/rtk` wins. Stored as plugin settings (`omp plugin config get @krtclcdy/tersio comboDefault`).
 
 One-off use without installing:
 
@@ -116,21 +98,21 @@ Flags: `--dry-run`, `--yes`/`-y`, `--verbose`, `--combo-default`/`--caveman-defa
 
 ## ⌨️ Commands reference
 
-Everything runs under one root. Bare `/tersio` prints status.
+Mode switches live on their own commands; bare `/tersio` prints status.
 
 | Command | Purpose |
 |---|---|
-| `/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. |
+| `/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`. |
+| `/caveman lite\|full\|ultra\|wenyan\|off\|status` | Terse replies (substance stays); `ultra` uses fragments only, `wenyan` a compressed classical-Chinese-inspired register. |
+| `/rtk on\|off\|status` | Compact shell output via the real `rtk` binary; exact bytes (checksums, patches) bypass it by policy. |
+| `/ponytail off\|lite\|full\|ultra\|review\|status` | Minimal code (YAGNI): `lite` nudges, `full` enforces, `ultra` challenges the requirement, `review` audits for over-engineering (upstream command). |
 | `/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 gain --open` 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`. |
+| `/ai-addons` | Add-on updater alias, still works. |
 
 ## 🗂️ Files and backups
 

package/cli/banner.js

@@ -72,13 +72,20 @@ function bannerLines(tier = bannerTier()) {
     return out;
 }
 let shown = false;
-// OMP-style welcome: intro line + note box with art and tips.
+// OMP-style welcome: intro line + note box with art left, commands right.
 // 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');
+    const tips = [
+        'tersio install   set up add-ons',
+        'tersio update    refresh CLI + add-ons',
+        'tersio doctor    verify the install',
+    ];
+    const art = bannerLines();
+    const rows = art.map((line, i) => (i >= 1 && i <= 3 ? `${line}  ${tips[i - 1]}` : line));
+    clackNote(rows.join('\n'));
 }
 export { bannerLines, bannerTier, printWelcome };

package/cli/common.js

@@ -104,7 +104,8 @@ async function writeIfChanged(dest, content, options = {}) {
         return false;
     }
     if (options.dryRun) {
-        console.log(`  [dry-run] would write ${dest}`);
+        if (verbose)
+            console.log(`  [dry-run] would write ${dest}`);
         return true;
     }
     await fs.mkdir(path.dirname(dest), { recursive: true });
@@ -113,7 +114,8 @@ async function writeIfChanged(dest, content, options = {}) {
         debug(`${path.basename(dest)} → ${path.basename(dest)}.bak`);
     }
     await fs.writeFile(dest, content, 'utf8');
-    console.log(`  [write] ${dest}`);
+    if (verbose && !options.quiet)
+        console.log(`  [write] ${dest}`);
     return true;
 }
 // omp ships 'extensions: null'; appending list items under a null scalar breaks
@@ -127,11 +129,12 @@ function normalizeExtensionsKey(lines) {
     lines[idx] = 'extensions:';
     return true;
 }
-async function writeConfigLines(configPath, lines, logMsg) {
+async function writeConfigLines(configPath, lines, logMsg, options = {}) {
     await fs.mkdir(path.dirname(configPath), { recursive: true });
     await fs.copyFile(configPath, `${configPath}.bak`).catch(() => { });
     await fs.writeFile(configPath, lines.join('\n'), 'utf8');
-    console.log(logMsg);
+    if (verbose && !options.quiet)
+        console.log(logMsg);
 }
 async function ensureExtensionInConfig(configPath, extensionPath, label, options = {}) {
     const normalizedPath = extensionPath.replace(/\\/g, '/');
@@ -144,7 +147,8 @@ async function ensureExtensionInConfig(configPath, extensionPath, label, options
     }
     const extLineIdx = lines.findIndex((l) => EXTENSIONS_KEY_RE.test(l));
     if (options.dryRun) {
-        console.log(`  [dry-run] would add ${label} to config.yml: ${normalizedPath}`);
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would add ${label} to config.yml`);
         return true;
     }
     if (normalizeExtensionsKey(lines)) {
@@ -158,7 +162,7 @@ async function ensureExtensionInConfig(configPath, extensionPath, label, options
     else {
         lines.splice(extLineIdx + 1, 0, line);
     }
-    await writeConfigLines(configPath, lines, `  [write] Added ${label} to config.yml`);
+    await writeConfigLines(configPath, lines, `  [write] Added ${label} to config.yml`, options);
     return true;
 }
 async function ensureExtensionAfterConfigEntry(configPath, extensionPath, afterPath, label, options = {}) {
@@ -172,7 +176,8 @@ async function ensureExtensionAfterConfigEntry(configPath, extensionPath, afterP
     if (existingIndex !== -1 && afterIndex !== -1 && existingIndex === afterIndex + 1)
         return false;
     if (options.dryRun) {
-        console.log(`  [dry-run] would place ${label} after Ponytail in config.yml: ${normalizedPath}`);
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would place ${label} after Ponytail in config.yml`);
         return true;
     }
     if (existingIndex !== -1)
@@ -191,7 +196,7 @@ async function ensureExtensionAfterConfigEntry(configPath, extensionPath, afterP
             lines.splice(extensionsIndex + 1, 0, line);
         }
     }
-    await writeConfigLines(configPath, lines, `  [write] Placed ${label} after Ponytail in config.yml`);
+    await writeConfigLines(configPath, lines, `  [write] Placed ${label} after Ponytail in config.yml`, options);
     return true;
 }
 function readPonytailConfig() {
@@ -219,7 +224,8 @@ function parsePonytailConfig(existing) {
 async function patchPonytailConfig(apply, dryRunNote, writeNote, options = {}) {
     const config = readPonytailConfig();
     if (options.dryRun) {
-        console.log(`  [dry-run] ${dryRunNote} in ${config.path}`);
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] ${dryRunNote}`);
         return;
     }
     const cfg = parsePonytailConfig(await readTextIfExists(config.path));
@@ -229,7 +235,8 @@ async function patchPonytailConfig(apply, dryRunNote, writeNote, options = {}) {
     }
     await fs.mkdir(config.dir, { recursive: true });
     await fs.writeFile(config.path, JSON.stringify(cfg, null, 2) + '\n', 'utf8');
-    console.log(`  [write] ${writeNote} in ${config.path}`);
+    if (verbose && !options.quiet)
+        console.log(`  [write] ${writeNote}`);
 }
 async function ensurePonytailConfigValue(key, value, options = {}) {
     await patchPonytailConfig((cfg) => {

package/cli/doctor.js

@@ -1,7 +1,7 @@
 // cli/doctor.ts — installation health checks.
 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 { BUN_BIN_DIR, 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, sessionsDir } from '../extensions/shared/usage-ledger.js';
 import { readRtkGain, rtkDbPath } from '../extensions/shared/rtk-gain.js';
@@ -56,50 +56,53 @@ async function runDoctor() {
         const err = e;
         return err.stdout?.trim() || err.stderr?.trim() || null;
     }));
-    const [ompVersion, agentEntries, extEntries, sharedStateText, configText, updateVersion] = await runInteractivePhase('Checking environment and installation', () => Promise.all([
-        probes.ompVersion,
-        probes.agentEntries,
-        probes.extEntries,
-        probes.sharedStateText,
-        probes.configText,
-        probes.updateVersion,
+    const [[ompVersion, agentEntries, extEntries, sharedStateText, configText, updateVersion], [cavemanIndexText, rtkIndexText, updaterIndexText, comboIndexText, tersioIndexText, modeReinforcementText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText], [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, rtkOmpText, ponytailMtime]] = await runInteractivePhase('Checking installation', () => Promise.all([
+        Promise.all([
+            probes.ompVersion,
+            probes.agentEntries,
+            probes.extEntries,
+            probes.sharedStateText,
+            probes.configText,
+            probes.updateVersion,
+        ]),
+        Promise.all([
+            probes.cavemanIndexText,
+            probes.rtkIndexText,
+            probes.updaterIndexText,
+            probes.comboIndexText,
+            probes.tersioIndexText,
+            probes.modeReinforcementText,
+            probes.ponytailPkgText,
+            probes.ponytailExtText,
+            probes.pluginsPkgRaw,
+            probes.selfPkgText,
+        ]),
+        Promise.all([
+            probes.cavemanRuleText,
+            probes.ruleMtime,
+            probes.rtkBinText,
+            probes.rtkMtime,
+            rtkVersionProbe,
+            probes.rtkOmpText,
+            probes.ponytailMtime,
+        ]),
     ]));
-    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,
-        probes.pluginsPkgRaw,
-        probes.selfPkgText,
-    ]));
-    const [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, rtkOmpText, ponytailMtime] = await runInteractivePhase('Checking add-ons', () => Promise.all([
-        probes.cavemanRuleText,
-        probes.ruleMtime,
-        probes.rtkBinText,
-        probes.rtkMtime,
-        rtkVersionProbe,
-        probes.rtkOmpText,
-        probes.ponytailMtime,
-    ]));
-    // Categorized output with a tally; section headers group related probes.
+    // Categorized output with a tally; success rows stay quiet (no path echoes)
+    // while failures print the expected path or fix so they stay actionable.
     const tally = { ok: 0, missing: 0, warn: 0 };
     function check(label, ok, detail = '') {
         if (ok) {
             tally.ok++;
-            console.log(`  ${label}: ok${detail ? ` ${detail}` : ''}`);
+            console.log(`  ✅ ${label}: ok${detail ? ` ${detail}` : ''}`);
         }
         else {
             tally.missing++;
-            console.log(`  ${label}: MISSING${detail ? ` ${detail}` : ''}`);
+            console.log(`  ❌ ${label}: MISSING${detail ? ` ${detail}` : ''}`);
         }
     }
     function warnLine(label, detail) {
         tally.warn++;
-        console.log(`  ${label}: warn ${detail}`);
+        console.log(`  ⚠️ ${label}: warn ${detail}`);
     }
     section('Environment');
     check('Node', true, process.version);
@@ -110,33 +113,27 @@ async function runDoctor() {
         warnLine('Tersio CLI', `${PACKAGE_VERSION} (version check unreachable)`);
     else
         check('Tersio CLI', true, PACKAGE_VERSION);
-    console.log(`  Home: ${HOME}`);
     section('Installation');
-    check('OMP agent dir', agentEntries !== null, agentDir);
-    check('OMP extensions dir', extEntries !== null, extDir);
-    check('OMP config.yml', configText !== null, configPath);
+    check('OMP agent dir', agentEntries !== null, agentEntries === null ? agentDir : '');
+    check('OMP extensions dir', extEntries !== null, extEntries === null ? extDir : '');
+    check('OMP config.yml', configText !== null, configText === null ? configPath : '');
     check('Shared session bridge', sharedStateText !== null);
-    section('Extensions');
+    section('Extensions & plugins');
     check('Caveman extension', cavemanIndexText !== null);
     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);
     check('Ponytail extension', ponytailExtText !== null);
-    if (configText) {
-        check('Ponytail in config.yml', configText.includes('ponytail') && configText.includes('pi-extension'));
-        check('Combo in config.yml', configText.includes('combo-toggle'));
-    }
+    check('Ponytail in config.yml', (configText ?? '').includes('ponytail') && (configText ?? '').includes('pi-extension'));
+    check('Combo in config.yml', (configText ?? '').includes('combo-toggle'));
     check('Self plugin package', selfPkgText !== null, parseJsonObject(selfPkgText)?.version ?? '');
     const selfDep = PACKAGE_NAME in (parseJsonObject(pluginsPkgRaw)?.dependencies || {});
     check('Self plugin in plugins/package.json', selfDep);
-    section('Usage');
+    section('Usage & records');
     const usageRows = readUsage();
-    check('Usage ledger', usageRows.length > 0, usageRows.length ? `${usageRows.length} rows · ${ledgerPath()}` : ledgerPath());
-    section('Records');
+    check('Usage ledger', true, usageRows.length ? `${usageRows.length} rows` : 'empty — no records yet');
     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();
@@ -146,22 +143,17 @@ async function runDoctor() {
     const ruleAge = ruleMtime ? `updated ${relTime(Date.now() - ruleMtime.mtimeMs)}` : '';
     check('Caveman rule', cavemanRuleText !== null, ruleAge);
     const rtkAge = rtkMtime ? `updated ${relTime(Date.now() - rtkMtime.mtimeMs)}` : '';
-    if (rtkBinText === null)
-        check('RTK binary', false, rtkBin);
-    else {
-        const bits = [rtkVersion, rtkAge].filter(Boolean).join(', ');
-        check('RTK binary', true, bits);
-        if (!rtkVersion)
-            warnLine('RTK version', 'unavailable — binary may not be executable');
-        if (rtkOmpText === null)
-            check('RTK OMP wiring (rtk.ts)', false, `run: rtk init -g --agent omp`);
-        else
-            check('RTK OMP wiring (rtk.ts)', true, path.join(extDir, 'rtk.ts'));
-    }
+    check('RTK binary', rtkBinText !== null, rtkBinText === null ? rtkBin : [rtkVersion, rtkAge].filter(Boolean).join(', '));
+    if (rtkBinText !== null && !rtkVersion)
+        warnLine('RTK version', 'unavailable — binary may not be executable');
+    const rtkRegistered = rtkOmpText !== null && (configText ?? '').includes('extensions/rtk.ts');
+    check('RTK OMP wiring (rtk.ts)', rtkOmpText !== null, rtkOmpText === null ? 'run: rtk init -g --agent omp' : '');
+    if (rtkOmpText !== null && !rtkRegistered)
+        warnLine('RTK in config.yml', 'rtk.ts not listed — OMP will not load it; rerun install');
     const ponytailAge = ponytailMtime ? `updated ${relTime(Date.now() - ponytailMtime.mtimeMs)}` : '';
     check('Ponytail', ponytailPkgText !== null, [parseJsonObject(ponytailPkgText)?.version ?? '', ponytailAge].filter(Boolean).join(', '));
     const total = tally.ok + tally.missing + tally.warn;
-    console.log(`\n  Summary: ${total} checks — ${tally.ok} ok, ${tally.warn} warn, ${tally.missing} missing`);
+    console.log(`\n  Summary: ${total} checks — ✅ ${tally.ok} ok, ⚠️ ${tally.warn} warn, ❌ ${tally.missing} missing`);
 }
 function section(name) {
     console.log(`\n${name}`);