@krtclcdy/tersio 2.14.0 → 2.16.0

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, COMBO_PRESET_MODES, EXTENSIONS_KEY_RE, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, 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;
@@ -442,10 +453,41 @@ function defaultProfile() {
         ponytailDefault: 'off',
     };
 }
-// Install is always user-level (all OMP sessions). Project scope was removed:
-// session extensions must live in ~/.omp/agent/extensions to load.
-async function resolveProfile(forceReinstall = false) {
-    const profile = defaultProfile();
+async function storedProfile() {
+    const base = defaultProfile();
+    const raw = await readTextIfExists(path.join(OMP_PLUGINS_DIR, 'omp-plugins.lock.json'));
+    if (!raw)
+        return base;
+    let stored;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || !('settings' in parsed))
+            return base;
+        const settings = parsed.settings;
+        if (!settings || typeof settings !== 'object' || !(PACKAGE_NAME in settings))
+            return base;
+        const entry = settings[PACKAGE_NAME];
+        if (!entry || typeof entry !== 'object')
+            return base;
+        stored = entry;
+    }
+    catch {
+        return base;
+    }
+    if (typeof stored.comboDefault === 'string' && stored.comboDefault in COMBO_PRESET_MODES)
+        base.comboDefault = stored.comboDefault;
+    if (typeof stored.cavemanDefault === 'string' && CAVEMAN_DEFAULTS.has(stored.cavemanDefault))
+        base.cavemanDefault = stored.cavemanDefault;
+    if (typeof stored.rtkDefault === 'boolean')
+        base.rtkDefault = stored.rtkDefault;
+    if (typeof stored.ponytailDefault === 'string' && PONYTAIL_DEFAULTS.has(stored.ponytailDefault))
+        base.ponytailDefault = stored.ponytailDefault;
+    return base;
+}
+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();
     // Single interactive prompt: the Combo preset implies all three modes.
     // Numbered menu — no typing preset names.
     // Only for a real user at a terminal, only when no default flags were
@@ -456,7 +498,7 @@ async function resolveProfile(forceReinstall = false) {
             { value: 'medium', label: 'medium', hint: 'caveman=lite, rtk=on, ponytail=lite' },
             { value: 'balanced', label: 'balanced', hint: 'caveman=full, rtk=on, ponytail=full' },
             { value: 'max', label: 'max', hint: 'caveman=ultra, rtk=on, ponytail=ultra' },
-        ], 'off');
+        ], profile.comboDefault);
         if (choice.status === 'selected')
             profile.comboDefault = choice.value;
         else {
@@ -477,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) {
@@ -528,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 });
@@ -575,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();
             }
@@ -633,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') {
@@ -672,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 };

package/cli/rtk-wiring.js

@@ -1,12 +1,20 @@
 // cli/rtk-wiring.ts — wire the installed rtk binary into OMP.
 // `rtk init -g --agent omp` writes rtk's tool_call extension to
-// ~/.omp/agent/extensions/rtk.ts; OMP auto-loads it and rewrites bash
-// commands to rtk before execution, so every rewritten call lands in
-// rtk's history.db and shows metered savings in the gain dashboard.
+// ~/.omp/agent/extensions/rtk.ts, and we register that path in config.yml
+// (OMP only loads listed extensions — rtk init does not register it).
+// Once loaded, OMP rewrites bash commands to rtk before execution, so every
+// rewritten call lands in rtk's history.db and shows metered savings.
 // Fail-open: a failed wire only downgrades to manual `rtk` prefixing.
 // Deliberately free of cli/common.ts imports (argv side effects) so tests
 // can load it directly.
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
 import { execFile } from 'node:child_process';
+function debugWire(options, msg) {
+    if (!options.quiet)
+        console.log(`  ${msg}`);
+}
 function shortWiringError(e) {
     const err = e;
     const why = [err.code !== undefined ? `code ${err.code}` : '', err.signal ?? '', err.stderr?.trim(), err.message]
@@ -29,14 +37,64 @@ function execFileP(cmd, args, timeout) {
 // Idempotent: rtk rewrites its extension file on every init run, so
 // reinstalling tersio refreshes the wiring for free.
 export async function wireRtkOmp(rtkBin, options = {}) {
-    console.log('  Wiring rtk → OMP (bash tool_call rewrite)...');
-    if (options.dryRun) {
-        console.log('  [dry-run] would run: rtk init -g --agent omp');
+    if (!options.dryRun)
+        debugWire(options, 'Wiring rtk → OMP (bash tool_call rewrite)…');
+    if (options.dryRun)
         return true;
+    const wired = await runRtkInit(rtkBin, options);
+    if (!wired)
+        return false;
+    await ensureRtkInConfig(options);
+    return true;
+}
+// The rtk.ts path rtk init writes (mirrors OMP_AGENT_DIR in cli/common.ts
+// without importing it — see header note on argv side effects).
+function rtkExtensionPath() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return path.join(home, '.omp', 'agent', 'extensions', 'rtk.ts');
+}
+// OMP loads only listed extensions: append rtk.ts after the existing entries
+// (or create the key) so a fresh wire takes effect on next OMP start.
+async function ensureRtkInConfig(options) {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    const configPath = path.join(home, '.omp', 'agent', 'config.yml');
+    const extPath = rtkExtensionPath().replace(/\\/g, '/');
+    let raw = null;
+    try {
+        raw = await fs.readFile(configPath, 'utf8');
+    }
+    catch {
+        return;
+    }
+    if (raw.includes(extPath)) {
+        debugWire(options, 'rtk already in config.yml');
+        return;
     }
+    const lines = raw.split('\n');
+    const keyIdx = lines.findIndex((l) => /^\s*extensions\s*:/i.test(l));
+    const line = `  - ${extPath}`;
+    if (keyIdx === -1) {
+        lines.push('extensions:', line, '');
+    }
+    else {
+        if (/^\s*extensions\s*:\s*(?:\[\s*\]|null|~)?\s*$/i.test(lines[keyIdx]))
+            lines[keyIdx] = 'extensions:';
+        lines.splice(keyIdx + 1, 0, line);
+    }
+    try {
+        await fs.mkdir(path.dirname(configPath), { recursive: true });
+        await fs.copyFile(configPath, `${configPath}.bak`).catch(() => { });
+        await fs.writeFile(configPath, lines.join('\n'), 'utf8');
+        debugWire(options, 'rtk registered in config.yml');
+    }
+    catch (e) {
+        console.log(`  [warn] could not register rtk in config.yml: ${e.message}`);
+    }
+}
+async function runRtkInit(rtkBin, options) {
     try {
         await execFileP(rtkBin, ['init', '-g', '--agent', 'omp'], 30000);
-        console.log('  [ok] rtk OMP extension wired (~/.omp/agent/extensions/rtk.ts)');
+        debugWire(options, 'rtk OMP extension wired');
         return true;
     }
     catch (first) {
@@ -45,7 +103,7 @@ export async function wireRtkOmp(rtkBin, options = {}) {
         await new Promise((resolve) => setTimeout(resolve, 2000));
         try {
             await execFileP(rtkBin, ['init', '-g', '--agent', 'omp'], 30000);
-            console.log('  [ok] rtk OMP extension wired (~/.omp/agent/extensions/rtk.ts)');
+            debugWire(options, 'rtk OMP extension wired');
             return true;
         }
         catch (e) {