@krtclcdy/tersio 2.15.0 → 2.17.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:

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

@@ -88,6 +88,10 @@ async function runDashboard(options) {
         res.end(html);
     });
     server.listen(options.port, '127.0.0.1', () => {
+        try {
+            process.title = 'tersio gain';
+        }
+        catch { /* non-POSIX shells keep node */ }
         const address = server.address();
         const port = typeof address === 'object' && address ? address.port : options.port;
         const url = `http://127.0.0.1:${port}`;

package/cli/doctor.js

@@ -146,7 +146,10 @@ async function runDoctor() {
     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;

package/cli/install.js

@@ -3,7 +3,7 @@ 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, CAVEMAN_DEFAULTS, COMBO_PRESET_MODES, EXTENSIONS_KEY_RE, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, PONYTAIL_DEFAULTS, RTK_BINARY_NAME, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
+import { BUN_BIN_DIR, CAVEMAN_DEFAULTS, COMBO_PRESET_MODES, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, PONYTAIL_DEFAULTS, RTK_BINARY_NAME, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
 import { askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
 import { printWelcome } from './banner.js';
 import { checkForUpdate, runLatestUpdate } from './update.js';
@@ -32,17 +32,18 @@ const SHARED_CARBON = path.join(EXT_DIR, 'shared', 'carbon.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/8] Installing Ponytail plugin...');
+    if (!options.quiet)
+        console.log('  Ponytail — refresh plugin');
     await fs.mkdir(pluginsDir, { recursive: true });
     const pkgPath = path.join(pluginsDir, 'package.json');
     const pkg = await readPluginsPackage(pkgPath);
     pkg.dependencies['@dietrichgebert/ponytail'] = PONYTAIL_GITHUB_SPEC;
     if (options.dryRun) {
-        console.log(`  [dry-run] would write ${pkgPath}`);
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would write ${pkgPath}`);
     }
     else {
         await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
-        console.log('  [write] package.json');
     }
     const ponytailExtPath = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
     const probeExt = async () => (await readTextIfExists(ponytailExtPath)) !== null;
@@ -53,8 +54,9 @@ async function stepPonytail(pluginsDir, userDir, options) {
     }
     else if (options.dryRun) {
         // Dry runs preview the wiring below without touching the network.
-        console.log(`  [dry-run] would run: omp plugin install ${PONYTAIL_GITHUB_SPEC}`);
-        if (options.reinstall) {
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would run: omp plugin install ${PONYTAIL_GITHUB_SPEC}`);
+        if (options.reinstall && verbose && !options.quiet) {
             console.log(`  [dry-run] would run: npm install ${PONYTAIL_NPM_SPEC} --save --no-audit --no-fund`);
         }
         ponytailExtExists = true;
@@ -63,7 +65,6 @@ async function stepPonytail(pluginsDir, userDir, options) {
         // Try omp plugin install first
         try {
             await execNetwork('Installing Ponytail plugin', OMP_BIN, ['plugin', 'install', PONYTAIL_GITHUB_SPEC], { cwd: pluginsDir });
-            console.log('  [ok] omp plugin install ran');
         }
         catch (e) {
             console.log(`  [warn] omp plugin install failed: ${e.message}`);
@@ -71,7 +72,6 @@ async function stepPonytail(pluginsDir, userDir, options) {
         if (options.reinstall) {
             try {
                 await execNetwork('Refreshing Ponytail package', 'npm', ['install', PONYTAIL_NPM_SPEC, '--save', '--no-audit', '--no-fund'], { cwd: pluginsDir, timeout: 120000 });
-                console.log('  [ok] Ponytail refreshed');
             }
             catch (e) {
                 console.log(`  [fail] Could not refresh ponytail: ${e.message}`);
@@ -82,15 +82,14 @@ async function stepPonytail(pluginsDir, userDir, options) {
         ponytailExtExists = await probeExt();
         // Fallback: try bun install or npm install
         if (!ponytailExtExists) {
-            console.log('  [info] pi-extension/index.js not found after omp plugin install — trying npm/bun install...');
+            if (!options.quiet)
+                console.log('  [info] pi-extension/index.js not found after omp plugin install — trying npm/bun install...');
             try {
                 await execNetwork('Installing Ponytail dependencies', 'npm', ['install'], { cwd: pluginsDir, timeout: 120000 });
-                console.log('  [ok] npm install completed');
             }
             catch {
                 try {
                     await execNetwork('Installing Ponytail dependencies', 'bun', ['install'], { cwd: pluginsDir, timeout: 120000 });
-                    console.log('  [ok] bun install completed');
                 }
                 catch (e2) {
                     console.log(`  [fail] Could not install ponytail: ${e2.message}`);
@@ -101,12 +100,12 @@ async function stepPonytail(pluginsDir, userDir, options) {
         }
         // Last-resort fallback: git clone the repo into node_modules
         if (!ponytailExtExists) {
-            console.log('  [info] npm/bun did not produce pi-extension — trying git clone...');
+            if (!options.quiet)
+                console.log('  [info] npm/bun did not produce pi-extension — trying git clone...');
             try {
                 const dest = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail');
                 await fs.mkdir(path.dirname(dest), { recursive: true });
                 await execNetwork('Cloning Ponytail repository', 'git', ['clone', '--depth', '1', 'https://github.com/DietrichGebert/ponytail.git', dest], { timeout: 180000 });
-                console.log('  [ok] git clone completed');
                 ponytailExtExists = await probeExt();
             }
             catch (e3) {
@@ -119,9 +118,9 @@ async function stepPonytail(pluginsDir, userDir, options) {
         console.log('  [skip] Ponytail pi-extension/index.js still not found — skill-only mode');
         console.log('  [hint] The /ponytail command won\'t work, but ponytail skills will still load');
     }
-    else if (!options.dryRun) {
+    else if (!options.dryRun && !options.quiet) {
         // Wire extension into config.yml so /ponytail command loads
-        console.log('  [ok] Ponytail pi-extension found');
+        debug('Ponytail pi-extension found');
     }
     // Still set Ponytail config defaults even without the extension command
     const configPath = path.join(userDir, 'config.yml');
@@ -134,20 +133,23 @@ 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/8] Registering tersio as OMP plugin...');
+    if (!options.quiet)
+        console.log('  Tersio — register plugin');
     const pkgPath = path.join(pluginsDir, 'package.json');
     const pkg = await readPluginsPackage(pkgPath);
     pkg.dependencies[PACKAGE_NAME] = `^${PACKAGE_VERSION}`;
     for (const legacy of ['oh-my-pi-token-saver', 'tersio-omp']) {
         if (legacy in pkg.dependencies) {
             delete pkg.dependencies[legacy];
-            if (!options.dryRun)
+            if (!options.dryRun && !options.quiet)
                 console.log(`  [migrate] dropped legacy ${legacy} dependency`);
         }
     }
     if (options.dryRun) {
-        console.log(`  [dry-run] would add ${PACKAGE_NAME}@^${PACKAGE_VERSION} to ${pkgPath}`);
-        console.log(`  [dry-run] would run: npm install --no-audit --no-fund (in ${pluginsDir})`);
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would add ${PACKAGE_NAME}@^${PACKAGE_VERSION} to ${pkgPath}`);
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would run: npm install --no-audit --no-fund (in ${pluginsDir})`);
         return false;
     }
     // pkg.dependencies[PACKAGE_NAME] was assigned above, so only reinstall skips this fast path.
@@ -155,7 +157,6 @@ async function stepSelfPlugin(pluginsDir, options) {
         const installedPkgRaw = await readTextIfExists(path.join(pluginsDir, 'node_modules', PACKAGE_NAME, 'package.json'));
         if (parseJsonObject(installedPkgRaw)?.version === PACKAGE_VERSION) {
             debug(`${PACKAGE_NAME} already installed at v${PACKAGE_VERSION}; skipping npm install`);
-            console.log('  [ok] Listed in OMP Settings → Plugins as tersio');
             return true;
         }
     }
@@ -179,7 +180,7 @@ async function stepSelfPlugin(pluginsDir, options) {
         console.log(`  [warn] ${PACKAGE_NAME} not found in plugins/node_modules after install`);
         return false;
     }
-    console.log('  [ok] Listed in OMP Settings → Plugins as tersio');
+    debug('tersio listed in OMP plugins');
     return true;
 }
 function resolveRtkTriple() {
@@ -211,19 +212,21 @@ async function downloadRtkChecksums(release) {
         return null;
     }
 }
-async function verifyRtkArchive(archivePath, assetName, checksumsText) {
+async function verifyRtkArchive(archivePath, assetName, checksumsText, options = {}) {
     if (!checksumsText) {
-        console.log('  [warn] No checksums.txt available — skipping verification');
+        if (!options.quiet)
+            console.log('  [warn] No checksums.txt available — skipping verification');
         return true;
     }
     const expected = parseChecksum(checksumsText, assetName);
     const actual = await sha256File(archivePath);
     if (!expected) {
-        console.log(`  [warn] checksums.txt missing entry for ${assetName} — skipping verification`);
+        if (!options.quiet)
+            console.log(`  [warn] checksums.txt missing entry for ${assetName} — skipping verification`);
         return true;
     }
     if (actual === expected) {
-        console.log(`  [ok] Checksum verified for ${assetName}`);
+        debug(`Checksum verified for ${assetName}`);
         return true;
     }
     console.log(`  [fail] Checksum mismatch for ${assetName}`);
@@ -272,10 +275,18 @@ async function extractRtkArchive(archivePath, extractDir) {
     return false;
 }
 async function stepRtk(binDir, options) {
-    console.log('\n[3/8] Installing RTK binary...');
+    if (!options.quiet)
+        console.log('  RTK — download binary and wire into OMP');
     const binDest = path.join(binDir, RTK_BINARY_NAME);
     // Download failure must not skip wiring: a pre-existing rtk binary is
     // exactly as good for the OMP hook, so wire whatever ends up at binDest.
+    // Dry runs stay offline: no registry probe, just the plan line above.
+    if (options.dryRun) {
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would download rtk binary and install to ${binDest}`);
+        await wireRtkOmp(binDest, options);
+        return;
+    }
     try {
         const release = await withInteractiveSpinner('Finding latest RTK release', () => fetchJson(RTK_RELEASE_API));
         const triple = resolveRtkTriple();
@@ -284,12 +295,6 @@ async function stepRtk(binDir, options) {
         const asset = findRtkAsset(release, triple);
         if (!asset)
             return;
-        if (options.dryRun) {
-            console.log(`  [dry-run] would download ${asset.name} from release ${release.tag_name}`);
-            console.log('  [dry-run] would verify checksum against checksums.txt');
-            console.log(`  [dry-run] would extract and install to ${binDest}`);
-            return;
-        }
         const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'omp-rtk-'));
         try {
             const archivePath = path.join(tmpDir, asset.name);
@@ -301,7 +306,7 @@ async function stepRtk(binDir, options) {
                 update('Verifying RTK checksum');
                 return downloadedChecksums;
             });
-            if (!await verifyRtkArchive(archivePath, asset.name, checksumsText))
+            if (!await verifyRtkArchive(archivePath, asset.name, checksumsText, options))
                 return;
             const extractDir = path.join(tmpDir, 'extracted');
             if (!await extractRtkArchive(archivePath, extractDir))
@@ -314,14 +319,12 @@ async function stepRtk(binDir, options) {
             await fs.mkdir(path.dirname(binDest), { recursive: true });
             await fs.copyFile(binDest, `${binDest}.bak`).catch(() => { });
             await fs.copyFile(found, binDest);
-            console.log(`  [write] ${binDest}`);
             if (!IS_WINDOWS) {
                 await fs.chmod(binDest, 0o755);
                 debug(`chmod 755 ${binDest}`);
             }
             try {
-                const v = (await execP(binDest, ['--version'], { timeout: 30000, shell: false })).stdout.trim();
-                console.log(`  [ok] ${binDest} → ${v}`);
+                await execP(binDest, ['--version'], { timeout: 30000, shell: false });
             }
             catch {
                 console.log(`  [hint] Verify manually: ${binDest} --version`);
@@ -352,7 +355,8 @@ async function stepRtk(binDir, options) {
 async function copySources(extDir, files, skipLabel, options) {
     const src = await readTextIfExists(files[0][0]);
     if (!src) {
-        console.log(`  [skip] ${skipLabel} not found in repo`);
+        if (!options.quiet && options.dryRun)
+            console.log(`  [skip] ${skipLabel} not found in repo`);
         return false;
     }
     await writeIfChanged(path.join(extDir, files[0][1]), src, options);
@@ -366,6 +370,8 @@ async function copySources(extDir, files, skipLabel, options) {
     return true;
 }
 async function stepSharedSessionState(extDir, options) {
+    if (!options.quiet)
+        console.log('  Shared files — sync session bridge');
     await copySources(extDir, [
         [SHARED_SESSION_STATE, path.join('shared', 'session-state.js')],
         [SHARED_TYPES, path.join('shared', 'types.js')],
@@ -377,14 +383,16 @@ async function stepSharedSessionState(extDir, options) {
     ], 'shared/session-state.js', options);
 }
 async function stepModeReinforcement(extDir, ponytailExtPath, options) {
-    console.log('\n[8/8] Installing mode reinforcement extension...');
+    if (!options.quiet)
+        console.log('  Session helpers — sync shared files');
     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/8] Installing RTK session extension...');
+    if (!options.quiet)
+        console.log('  RTK session — install session mode');
     await copySources(extDir, [[RTK_SESSION_INDEX, path.join('rtk-session', 'index.js')]], 'rtk-session/index.js', options);
 }
 // One rule fetch serves the install; dry runs stay offline
@@ -401,13 +409,14 @@ async function fetchCavemanRule(options) {
     }
 }
 async function stepCaveman(extDir, rule, options) {
-    console.log('\n[5/8] Installing Caveman session extension...');
+    if (!options.quiet)
+        console.log('  Caveman — fetch rule and install session mode');
     const cavemanDir = path.join(extDir, 'caveman-session');
     if (!options.dryRun)
         await fs.mkdir(cavemanDir, { recursive: true });
     const ruleDest = path.join(cavemanDir, 'rule.md');
     if (rule === null && (await readTextIfExists(ruleDest)) !== null) {
-        console.log('  [info] Keeping existing rule.md');
+        debug('Keeping existing rule.md');
     }
     else if (rule === null) {
         console.log('  [skip] Caveman rule.md unavailable');
@@ -419,14 +428,16 @@ 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...');
+    if (!options.quiet)
+        console.log('  Tersio commands — install /tersio root command');
     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/8] Installing Combo toggle extension...');
+    if (!options.quiet)
+        console.log('  Combo — install preset switch');
     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;
@@ -473,7 +484,7 @@ async function storedProfile() {
         base.ponytailDefault = stored.ponytailDefault;
     return base;
 }
-async function resolveProfile(forceReinstall = false) {
+async function resolveProfile(forceReinstall = false, opts = {}) {
     // Seed from the lock file so flag-less update/reinstall runs keep the
     // user's configured defaults instead of resetting them to off.
     const profile = await storedProfile();
@@ -508,32 +519,10 @@ async function resolveProfile(forceReinstall = false) {
         profile.rtkDefault = rtkDefaultFlag === 'on';
     if (ponytailDefaultFlag !== undefined)
         profile.ponytailDefault = ponytailDefaultFlag;
-    console.log(`  Profile: combo default=${profile.comboDefault} (caveman=${profile.cavemanDefault} · rtk=${profile.rtkDefault ? 'on' : 'off'} · ponytail=${profile.ponytailDefault})`);
+    if ((!opts.quiet && verbose) || dryRun)
+        console.log(`  Defaults: combo=${profile.comboDefault} (caveman=${profile.cavemanDefault} · rtk=${profile.rtkDefault ? 'on' : 'off'} · ponytail=${profile.ponytailDefault})`);
     return profile;
 }
-// ponytail: post-install guard. List entries under `extensions: null` break
-// OMP launch, so fail loudly here instead of at the next OMP start.
-async function validateConfigExtensions(agentDir, options) {
-    if (options.dryRun)
-        return;
-    const raw = await readTextIfExists(path.join(agentDir, 'config.yml'));
-    if (!raw)
-        return;
-    const lines = raw.split('\n');
-    const keyIdx = lines.findIndex((l) => EXTENSIONS_KEY_RE.test(l));
-    if (keyIdx === -1)
-        return;
-    const scalarNull = /^\s*extensions\s*:\s*(null|~|\[\s*\])\s*$/i.test(lines[keyIdx]);
-    const hasEntries = lines.slice(keyIdx + 1).some((l) => /^\s*-\s+\S/.test(l));
-    if (scalarNull && hasEntries) {
-        console.log('  [fail] config.yml lists extensions under `extensions: null` — OMP will fail to launch.');
-        console.log('  [hint] Replace the `extensions: null` line with `extensions:`, then reinstall.');
-        process.exitCode = 1;
-    }
-    else {
-        console.log('  [ok] config.yml extensions key valid');
-    }
-}
 // Persist the profile as omp plugin settings so `omp plugin config get`
 // reflects the choice and the extensions pick it up on session start.
 async function writePluginSettings(profile, options) {
@@ -559,7 +548,8 @@ async function writePluginSettings(profile, options) {
         ponytailDefault: profile.ponytailDefault,
     };
     if (options.dryRun) {
-        console.log(`  [dry-run] would write plugin settings (${PACKAGE_NAME}) to ${lockPath}`);
+        if (verbose && !options.quiet)
+            console.log(`  [dry-run] would write plugin settings (${PACKAGE_NAME}) to ${lockPath}`);
         return;
     }
     await fs.mkdir(pluginsDir, { recursive: true });
@@ -606,16 +596,13 @@ async function runCommandMenu() {
             await runInstall();
             break;
         case 'update': {
-            // One bound flow: report the CLI version, then offer the add-on
-            // 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})`);
-            else if (latest === 'unknown')
-                console.log(`  [warn] could not reach the npm registry — run \`tersio update\` to retry`);
+            // One bound flow: the version check already ran above, so report it
+            // and offer the refresh in the same breath — no second "update" quiz.
+            if (typeof newer === 'string')
+                console.log(`  tersio ${newer} available (installed ${PACKAGE_VERSION})`);
             else
-                console.log(`  [ok] tersio ${PACKAGE_VERSION} is the latest`);
-            const go = await askInteractiveConfirm('Update add-ons now (RTK, Caveman rule, Ponytail)?');
+                console.log(`  tersio ${PACKAGE_VERSION} is the latest`);
+            const go = await askInteractiveConfirm('Update now (CLI + RTK, Caveman rule, Ponytail)?');
             if (go.status === 'confirmed' && go.value) {
                 await runLatestUpdate();
             }
@@ -664,19 +651,23 @@ async function runInstall(overrides = {}) {
         await runCommandMenu();
         return;
     }
-    printWelcome();
+    // apply-update is the delegated payload of `tersio update`: stay silent —
+    // the parent already printed the plan and owns the closing summary. Banner
+    // repeats here otherwise (the reported double-print), burying real output.
+    const quiet = applyUpdate;
+    if (!quiet)
+        printWelcome();
     if (isReinstall) {
         // removeRtk stays false: reinstall is about to replace the binary, and
         // deleting it first would leave nothing to wire if the fresh download
         // fails (rate limit, offline). rtk.ts is removed here and re-wired below.
         await runUninstall({ yes: true, removePonytail: false, removeRtk: false });
     }
-    if (dryRun)
-        console.log('[dry-run] No changes will be written.\n');
-    console.log(`=== Tersio v${PACKAGE_VERSION} ===`);
-    console.log(`  Platform: ${process.platform}`);
-    console.log(`  Arch: ${process.arch}`);
-    console.log(`  Home: ${HOME}`);
+    if (dryRun && !quiet)
+        console.log('Preview — no changes will be written.\n');
+    if (!quiet) {
+        console.log(`Installing Tersio v${PACKAGE_VERSION}`);
+    }
     // Remind humans a newer release exists; silent for scripts (no TTY) and for
     // the apply-update payload, which is itself an update run.
     if (tty() && !applyUpdate && command !== 'uninstall') {
@@ -703,47 +694,54 @@ async function runInstall(overrides = {}) {
             }
         }
     }
-    console.log('  Scope: user (all OMP sessions)');
     // Resolve session defaults: flags > interactive prompt > defaults.
-    const profile = await resolveProfile(isReinstall);
+    const profile = await resolveProfile(isReinstall, { quiet });
     const userDir = OMP_AGENT_DIR;
     const userExtDir = path.join(userDir, 'extensions');
     // apply-update is `tersio update`'s payload run: treat it like reinstall so
     // the add-ons refresh too — Ponytail package via npm, self plugin, RTK
     // binary (always re-downloaded), and the Caveman rule (always re-fetched).
-    const options = { dryRun, verbose, yes, reinstall: isReinstall || applyUpdate };
-    // Check prerequisites
-    console.log('\nPrerequisites:');
+    const options = { dryRun, verbose, yes, reinstall: isReinstall || applyUpdate, quiet };
     try {
         const v = (await execP(OMP_BIN, ['--version'])).stdout.trim();
-        console.log(`  [ok] omp ${v}`);
+        if (verbose && !quiet)
+            console.log(`  omp ${v}`);
     }
     catch {
         console.log('  [fail] omp not found — ensure it\'s installed');
     }
     const cavemanRule = await fetchCavemanRule(options);
-    console.log('\n--- User-level install ---');
-    await stepSharedSessionState(userExtDir, options);
-    await stepPonytail(OMP_PLUGINS_DIR, userDir, options);
-    const selfPlugin = await stepSelfPlugin(OMP_PLUGINS_DIR, options);
+    const failures = [];
+    const capture = async (label, work) => {
+        try {
+            await work();
+        }
+        catch (e) {
+            failures.push(label);
+            console.log(`  [fail] ${label}: ${shortError(e)}`);
+        }
+    };
+    await capture('shared', () => stepSharedSessionState(userExtDir, options));
+    await capture('ponytail', () => stepPonytail(OMP_PLUGINS_DIR, userDir, options));
+    let selfPlugin = false;
+    await capture('self-plugin', async () => { selfPlugin = await stepSelfPlugin(OMP_PLUGINS_DIR, options); });
     const ponytailExtPath = path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
-    await stepRtk(BUN_BIN_DIR, options);
-    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);
+    await capture('rtk', () => stepRtk(BUN_BIN_DIR, options));
+    await capture('rtk session', () => stepRtkSession(userExtDir, options));
+    await capture('caveman', () => stepCaveman(userExtDir, cavemanRule, options));
+    await capture('combo', () => stepCombo(userExtDir, options));
+    await capture('commands', () => stepTersioCommands(userExtDir, options));
+    await capture('reinforcement', () => stepModeReinforcement(userExtDir, ponytailExtPath, options));
+    await capture('updater', () => stepUpdater(userExtDir, options));
     if (selfPlugin)
-        await writePluginSettings(profile, options);
-    console.log('\n=== Installation complete ===');
-    console.log('\nNext steps:');
-    console.log('  1. Restart OMP');
-    console.log('  2. /caveman full');
-    console.log('  3. /rtk on');
-    console.log('  4. /ponytail full');
-    console.log('  5. /ai-addons check');
-    console.log('  6. /combo medium   (toggle all 3 at once — off by default)');
+        await capture('settings', () => writePluginSettings(profile, options));
+    if (quiet) {
+        if (failures.length > 0)
+            console.log(`  add-ons: ${failures.length} failed (${failures.join(', ')}) — see [fail] lines above`);
+    }
+    else {
+        console.log(failures.length === 0 ? '\nDone — restart OMP, then /combo medium.' : `\nDone with ${failures.length} failure(s) — see [fail] lines above.`);
+    }
     closeRL();
 }
 export { runInstall };