@krtclcdy/tersio 2.4.1 → 2.6.0

package/tersio.js

@@ -2,84 +2,14 @@
 // tersio.ts — Install Tersio (caveman/rtk/ponytail) add-ons on any OMP device.
 // Usage: node tersio.js [install|update|reinstall|doctor|uninstall|version|help] [options]
 // Requires: node/npm and omp CLI
-import { execFile } from 'node:child_process';
-import { promises as fs } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import readline from 'node:readline';
-import { fileURLToPath } from 'node:url';
-import { promisify } from 'node:util';
-import { createRequire } from 'node:module';
-import { cancel as clackCancel, confirm as clackConfirm, select as clackSelect, spinner as clackSpinner, tasks as clackTasks } from '@clack/prompts';
-import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, sha256File, parseChecksum, readTextIfExists, rtkPlatformSpec, } from './extensions/lib/utils.js';
-const IS_WINDOWS = process.platform === 'win32';
-const RTK_BINARY_NAME = IS_WINDOWS ? 'rtk.exe' : 'rtk';
-const HOME = process.env.HOME || process.env.USERPROFILE || '';
-const OMP_AGENT_DIR = path.join(HOME, '.omp', 'agent');
-const OMP_PLUGINS_DIR = path.join(HOME, '.omp', 'plugins');
-const BUN_BIN_DIR = path.join(HOME, '.bun', 'bin');
-const OMP_BIN = IS_WINDOWS ? 'omp.cmd' : 'omp';
-const PACKAGE_NAME = '@krtclcdy/tersio';
-const PACKAGE_BIN = 'tersio';
-const { version: PACKAGE_VERSION } = createRequire(import.meta.url)('./package.json');
-// Session-start mode defaults for fresh installs.
-const CAVEMAN_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'wenyan']);
-const PONYTAIL_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'review']);
-const RTK_DEFAULTS = new Set(['on', 'off']);
-// ponytail: Combo preset implies all three modes. Mirrors COMBO_LEVELS in
-// extensions/shared/session-state.ts (rtk as boolean here). Single source.
-const COMBO_PRESET_MODES = {
-    off: { caveman: 'off', rtk: false, ponytail: 'off' },
-    medium: { caveman: 'lite', rtk: true, ponytail: 'lite' },
-    balanced: { caveman: 'full', rtk: true, ponytail: 'full' },
-    max: { caveman: 'ultra', rtk: true, ponytail: 'ultra' },
-};
-const COMBO_DEFAULTS = new Set(Object.keys(COMBO_PRESET_MODES));
-function parseEnum(value, valid, flag) {
-    if (value === undefined)
-        return undefined;
-    const v = value.trim().toLowerCase();
-    if (!valid.has(v)) {
-        console.error(`[fail] Invalid ${flag}: ${value}. Valid: ${[...valid].join(', ')}`);
-        process.exit(1);
-    }
-    return v;
-}
-function flagValue(name) {
-    const i = args.indexOf(name);
-    if (i !== -1)
-        return args[i + 1];
-    const prefix = `${name}=`;
-    return args.find((arg) => arg.startsWith(prefix))?.slice(prefix.length);
-}
-// --- CLI flags ---
-const COMMANDS = new Set(['install', 'update', 'reinstall', 'doctor', 'uninstall', 'version', 'help']);
-const args = process.argv.slice(2);
-const commandArg = args.find((arg, index) => !arg.startsWith('-') && args[index - 1] !== '--scope');
-const command = commandArg?.toLowerCase() || null;
-const unknownCommand = command !== null && !COMMANDS.has(command);
-const install = command === 'install';
-const update = command === 'update';
-const reinstall = command === 'reinstall';
-const showVersion = command === 'version' || args.includes('--version') || args.includes('-v');
-const showHelp = command === 'help' || args.includes('--help') || args.includes('-h');
-const applyUpdate = args.includes('--apply-update');
-const dryRun = args.includes('--dry-run');
-const yes = args.includes('--yes') || args.includes('-y') || install || update || reinstall || applyUpdate;
-const verbose = args.includes('--verbose');
-const doctor = command === 'doctor' || args.includes('--doctor');
-const uninstall = command === 'uninstall' || args.includes('--uninstall');
-const removePonytail = args.includes('--remove-ponytail');
-const keepPonytail = args.includes('--keep-ponytail');
-const removeRtk = args.includes('--remove-rtk');
-const scopeFlag = flagValue('--scope')?.toLowerCase() ?? null;
-// --- Profile selection (session-start mode defaults) ---
-const comboDefaultFlag = parseEnum(flagValue('--combo-default'), COMBO_DEFAULTS, '--combo-default');
-const cavemanDefaultFlag = parseEnum(flagValue('--caveman-default'), CAVEMAN_DEFAULTS, '--caveman-default');
-const ponytailDefaultFlag = parseEnum(flagValue('--ponytail-default'), PONYTAIL_DEFAULTS, '--ponytail-default');
-const rtkDefaultFlag = parseEnum(flagValue('--rtk-default'), RTK_DEFAULTS, '--rtk-default');
-const profileFlagsGiven = [comboDefaultFlag, cavemanDefaultFlag, rtkDefaultFlag, ponytailDefaultFlag]
-    .some((flag) => flag !== undefined);
+import { PACKAGE_BIN, PACKAGE_VERSION, applyUpdate, commandArg, dashboard, dashboardExport, dashboardOpen, dashboardPort, doctor, showHelp, showVersion, uninstall, unknownCommand, update, usage, } from './cli/common.js';
+import { closeRL } from './cli/interactive.js';
+import { runInstall } from './cli/install.js';
+import { runDoctor } from './cli/doctor.js';
+import { runLatestUpdate } from './cli/update.js';
+import { runUninstall } from './cli/uninstall.js';
+import { runUsage } from './cli/usage.js';
+import { runDashboard } from './cli/dashboard.js';
 function printHelp() {
     console.log(`Usage: ${PACKAGE_BIN} [command] [options]
 
@@ -88,6 +18,8 @@ Commands:
   update       Refresh the CLI and add-ons (RTK binary, Caveman rule, Ponytail)
   reinstall    Clean and reinstall the user-scope add-ons
   doctor       Check the current installation
+  usage        Ledger-backed usage + savings report
+  dashboard    Serve the gain dashboard (localhost only)
   uninstall    Remove the managed extensions
   version      Print the package version
   help         Show this help
@@ -103,1204 +35,12 @@ Options:
   --yes, -y
   --dry-run
   --verbose
+  --port <n> (dashboard: pin port, default ephemeral)
+  --open (dashboard: open browser)
+  --export <file> (dashboard: write HTML file instead of serving)
   --version, -v
   --help, -h`);
 }
-function debug(...a) {
-    if (verbose)
-        console.log('  [debug]', ...a);
-}
-const RL = readline.createInterface({ input: process.stdin, output: process.stdout });
-let rlOpen = true;
-function ask(q) {
-    return new Promise((resolve) => {
-        if (!rlOpen) {
-            resolve('');
-            return;
-        }
-        try {
-            RL.question(q, resolve);
-        }
-        catch {
-            resolve('');
-        }
-    });
-}
-function closeRL() { if (rlOpen) {
-    RL.close();
-    rlOpen = false;
-} }
-// Paths to extension source files (relative to this script)
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const EXT_DIR = path.join(SCRIPT_DIR, 'extensions');
-const SHARED_SESSION_STATE = path.join(EXT_DIR, 'shared', 'session-state.js');
-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 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');
-const SHARED_PLUGIN_SETTINGS = path.join(EXT_DIR, 'shared', 'plugin-settings.js');
-// --- Helpers ---
-const execFileP = promisify(execFile);
-async function execP(cmd, args, opts = {}) {
-    return execFileP(cmd, args, {
-        timeout: opts.timeout || 120000,
-        encoding: 'utf8',
-        ...opts,
-    });
-}
-async function execNetwork(label, cmd, args, opts = {}) {
-    return withInteractiveSpinner(label, () => execP(cmd, args, opts));
-}
-async function writeIfChanged(dest, content, options = {}) {
-    const existing = await readTextIfExists(dest);
-    if (existing === content) {
-        debug(`${dest} already up to date`);
-        return false;
-    }
-    if (options.dryRun) {
-        console.log(`  [dry-run] would write ${dest}`);
-        return true;
-    }
-    await fs.mkdir(path.dirname(dest), { recursive: true });
-    if (existing !== null) {
-        await fs.copyFile(dest, `${dest}.bak`);
-        debug(`${path.basename(dest)} → ${path.basename(dest)}.bak`);
-    }
-    await fs.writeFile(dest, content, 'utf8');
-    console.log(`  [write] ${dest}`);
-    return true;
-}
-// omp ships 'extensions: null'; appending list items under a null scalar breaks
-// YAML parsing. Normalize null/~/[]/empty to a mapping key first.
-const EXTENSIONS_KEY_RE = /^\s*extensions\s*:/i;
-const EXTENSIONS_NULL_RE = /^\s*extensions\s*:\s*(?:\[\s*\]|null|~)?\s*$/i;
-function normalizeExtensionsKey(lines) {
-    const idx = lines.findIndex((l) => EXTENSIONS_NULL_RE.test(l));
-    if (idx === -1)
-        return false;
-    lines[idx] = 'extensions:';
-    return true;
-}
-async function writeConfigLines(configPath, lines, logMsg) {
-    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);
-}
-async function ensureExtensionInConfig(configPath, extensionPath, label, options = {}) {
-    const normalizedPath = extensionPath.replace(/\\/g, '/');
-    const line = `  - ${normalizedPath}`;
-    const raw = await readTextIfExists(configPath);
-    let lines = (raw || '').split('\n');
-    if (lines.some((l) => l.includes(normalizedPath))) {
-        debug(`${label} already in config.yml`);
-        return false;
-    }
-    const extLineIdx = lines.findIndex((l) => EXTENSIONS_KEY_RE.test(l));
-    if (options.dryRun) {
-        console.log(`  [dry-run] would add ${label} to config.yml: ${normalizedPath}`);
-        return true;
-    }
-    if (normalizeExtensionsKey(lines)) {
-        lines.splice(extLineIdx + 1, 0, line, '');
-    }
-    else if (extLineIdx === -1) {
-        lines.push('extensions:');
-        lines.push(line);
-        lines.push('');
-    }
-    else {
-        lines.splice(extLineIdx + 1, 0, line);
-    }
-    await writeConfigLines(configPath, lines, `  [write] Added ${label} to config.yml`);
-    return true;
-}
-async function ensureExtensionAfterConfigEntry(configPath, extensionPath, afterPath, label, options = {}) {
-    const normalizedPath = extensionPath.replace(/\\/g, '/');
-    const normalizedAfterPath = afterPath.replace(/\\/g, '/');
-    const line = `  - ${normalizedPath}`;
-    const raw = await readTextIfExists(configPath);
-    const lines = (raw || '').split('\n');
-    const existingIndex = lines.findIndex((entry) => entry.includes(normalizedPath));
-    const afterIndex = lines.findIndex((entry) => entry.includes(normalizedAfterPath));
-    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}`);
-        return true;
-    }
-    if (existingIndex !== -1)
-        lines.splice(existingIndex, 1);
-    const refreshedAfterIndex = lines.findIndex((entry) => entry.includes(normalizedAfterPath));
-    if (refreshedAfterIndex !== -1) {
-        lines.splice(refreshedAfterIndex + 1, 0, line);
-    }
-    else {
-        const extensionsIndex = lines.findIndex((entry) => EXTENSIONS_KEY_RE.test(entry));
-        if (extensionsIndex === -1) {
-            lines.push('extensions:', line, '');
-        }
-        else {
-            normalizeExtensionsKey(lines);
-            lines.splice(extensionsIndex + 1, 0, line);
-        }
-    }
-    await writeConfigLines(configPath, lines, `  [write] Placed ${label} after Ponytail in config.yml`);
-    return true;
-}
-function readPonytailConfig() {
-    const dir = process.env.XDG_CONFIG_HOME
-        ? path.join(process.env.XDG_CONFIG_HOME, 'ponytail')
-        : path.join(HOME, '.config', 'ponytail');
-    return { dir, path: path.join(dir, 'config.json') };
-}
-function parseJsonObject(text) {
-    if (!text)
-        return null;
-    try {
-        const parsed = JSON.parse(text.replace(/^\uFEFF/, ''));
-        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
-            return null;
-        return parsed;
-    }
-    catch {
-        return null;
-    }
-}
-function parsePonytailConfig(existing) {
-    return parseJsonObject(existing) ?? {};
-}
-async function patchPonytailConfig(apply, dryRunNote, writeNote, options = {}) {
-    const config = readPonytailConfig();
-    if (options.dryRun) {
-        console.log(`  [dry-run] ${dryRunNote} in ${config.path}`);
-        return;
-    }
-    const cfg = parsePonytailConfig(await readTextIfExists(config.path));
-    if (!apply(cfg)) {
-        debug('Ponytail config already up to date');
-        return;
-    }
-    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}`);
-}
-async function ensurePonytailConfigValue(key, value, options = {}) {
-    await patchPonytailConfig((cfg) => {
-        if (cfg[key] === value)
-            return false;
-        cfg[key] = value;
-        return true;
-    }, `would set Ponytail ${key}=${value}`, `Set Ponytail ${key}=${value}`, options);
-}
-// Read plugins/package.json tolerantly; corrupt or missing files start fresh
-// with installer-managed defaults.
-async function readPluginsPackage(pkgPath) {
-    const pkg = parseJsonObject(await readTextIfExists(pkgPath)) ?? {};
-    return { ...pkg, name: pkg.name || 'omp-plugins', private: true, dependencies: pkg.dependencies || {} };
-}
-const PONYTAIL_GITHUB_SPEC = 'github:DietrichGebert/ponytail';
-const PONYTAIL_NPM_SPEC = '@dietrichgebert/ponytail@latest';
-// --- Steps ---
-async function stepPonytail(pluginsDir, userDir, options) {
-    console.log('\n[1/7] Installing Ponytail 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}`);
-    }
-    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;
-    // Fast path: extension already present and no refresh asked — skip network.
-    let ponytailExtExists = !options.reinstall && !options.dryRun ? await probeExt() : false;
-    if (ponytailExtExists) {
-        debug('Ponytail pi-extension already installed; skipping network refresh');
-    }
-    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) {
-            console.log(`  [dry-run] would run: npm install ${PONYTAIL_NPM_SPEC} --save --no-audit --no-fund`);
-        }
-        ponytailExtExists = true;
-    }
-    else {
-        // 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}`);
-        }
-        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}`);
-                console.log(`  [hint] Manual: cd ~/.omp/plugins && npm install ${PONYTAIL_NPM_SPEC} --save --no-audit --no-fund`);
-            }
-        }
-        // Verify the pi-extension/index.js actually exists
-        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...');
-            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}`);
-                    console.log('  [hint] Manual: cd ~/.omp/plugins && npm install');
-                }
-            }
-            ponytailExtExists = await probeExt();
-        }
-        // 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...');
-            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) {
-                console.log(`  [fail] git clone failed: ${e3.message}`);
-                console.log('  [hint] Install git or check network: https://github.com/DietrichGebert/ponytail');
-            }
-        }
-    }
-    if (!ponytailExtExists) {
-        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) {
-        // Wire extension into config.yml so /ponytail command loads
-        console.log('  [ok] Ponytail pi-extension found');
-    }
-    // Still set Ponytail config defaults even without the extension command
-    const configPath = path.join(userDir, 'config.yml');
-    await ensureExtensionInConfig(configPath, ponytailExtPath, 'ponytail', options);
-    await ensurePonytailConfigValue('defaultMode', 'off', options);
-    // hideStatus=true keeps the upstream ponytail bar hidden; combo owns the bar.
-    await ensurePonytailConfigValue('hideStatus', true, options);
-}
-// Registers this package in ~/.omp/plugins so OMP lists it on the
-// 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...');
-    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)
-                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})`);
-        return false;
-    }
-    // pkg.dependencies[PACKAGE_NAME] was assigned above, so only reinstall skips this fast path.
-    if (!options.reinstall) {
-        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;
-        }
-    }
-    await fs.mkdir(pluginsDir, { recursive: true });
-    await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
-    try {
-        await execNetwork('Installing Tersio plugin dependencies', 'npm', ['install', '--no-audit', '--no-fund'], { cwd: pluginsDir, timeout: 180000 });
-    }
-    catch {
-        try {
-            await execNetwork('Installing Tersio plugin dependencies', 'bun', ['install'], { cwd: pluginsDir, timeout: 180000 });
-        }
-        catch (e) {
-            console.log(`  [fail] Could not install ${PACKAGE_NAME} into plugins dir: ${e.message}`);
-            console.log(`  [hint] Manual: cd ~/.omp/plugins && npm install ${PACKAGE_NAME}@^${PACKAGE_VERSION} --save --no-audit --no-fund`);
-            return false;
-        }
-    }
-    const installedPkg = path.join(pluginsDir, 'node_modules', PACKAGE_NAME, 'package.json');
-    if ((await readTextIfExists(installedPkg)) === null) {
-        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');
-    return true;
-}
-function resolveRtkTriple() {
-    const triple = rtkPlatformSpec()?.triple;
-    if (triple)
-        return triple;
-    console.log(`  [fail] Unsupported platform: ${process.platform}/${process.arch}`);
-    console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
-    return null;
-}
-function findRtkAsset(release, triple) {
-    const assets = release.assets || [];
-    const asset = assets.find((a) => a.name === `rtk-${triple}.zip` || a.name === `rtk-${triple}.tar.gz`);
-    if (asset)
-        return asset;
-    console.log(`  [fail] No rtk-${triple}.<zip|tar.gz> in release ${release.tag_name}`);
-    console.log(`  [hint] Available: ${assets.map((a) => a.name).filter((n) => n.startsWith('rtk-')).join(', ')}`);
-    return null;
-}
-async function downloadRtkChecksums(release) {
-    const checksumsAsset = (release.assets || []).find((a) => a.name === 'checksums.txt');
-    if (!checksumsAsset)
-        return null;
-    try {
-        return await httpsGet(checksumsAsset.browser_download_url);
-    }
-    catch (e) {
-        debug(`Could not download checksums.txt: ${e.message}`);
-        return null;
-    }
-}
-async function verifyRtkArchive(archivePath, assetName, checksumsText) {
-    if (!checksumsText) {
-        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`);
-        return true;
-    }
-    if (actual === expected) {
-        console.log(`  [ok] Checksum verified for ${assetName}`);
-        return true;
-    }
-    console.log(`  [fail] Checksum mismatch for ${assetName}`);
-    console.log(`  [fail] Expected: ${expected}`);
-    console.log(`  [fail] Got:      ${actual}`);
-    // Caller finally removes the temp dir.
-    return false;
-}
-function shortError(e) {
-    return ((e.stderr) || e.message || '').trim().slice(0, 200);
-}
-async function extractRtkArchive(archivePath, extractDir) {
-    await fs.mkdir(extractDir, { recursive: true });
-    if (archivePath.endsWith('.zip')) {
-        if (IS_WINDOWS) {
-            await execP('powershell', ['Expand-Archive', '-Path', archivePath, '-DestinationPath', extractDir, '-Force'], { timeout: 60000 });
-        }
-        else {
-            await execP('unzip', [archivePath, '-d', extractDir], { timeout: 60000 });
-        }
-        return true;
-    }
-    if (archivePath.endsWith('.tar.gz') || archivePath.endsWith('.tgz')) {
-        try {
-            await execP('tar', ['xzf', archivePath, '-C', extractDir], { timeout: 60000 });
-            debug('tar xzf ok');
-        }
-        catch (e) {
-            debug(`tar xzf failed: ${shortError(e)}`);
-            console.log(`  [fail] tar could not extract ${path.basename(archivePath)}`);
-            console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
-            return false;
-        }
-        return true;
-    }
-    console.log(`  [fail] Unknown archive format: ${archivePath}`);
-    return false;
-}
-async function stepRtk(binDir, options) {
-    console.log('\n[3/7] Installing RTK binary...');
-    try {
-        const release = await withInteractiveSpinner('Finding latest RTK release', () => fetchJson(RTK_RELEASE_API));
-        const triple = resolveRtkTriple();
-        if (!triple)
-            return;
-        const asset = findRtkAsset(release, triple);
-        if (!asset)
-            return;
-        const binDest = path.join(binDir, RTK_BINARY_NAME);
-        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);
-            const checksumsText = await withInteractiveSpinner('Downloading RTK binary', async (update) => {
-                const [downloadedChecksums] = await Promise.all([
-                    downloadRtkChecksums(release),
-                    httpsDownload(asset.browser_download_url, archivePath),
-                ]);
-                update('Verifying RTK checksum');
-                return downloadedChecksums;
-            });
-            if (!await verifyRtkArchive(archivePath, asset.name, checksumsText))
-                return;
-            const extractDir = path.join(tmpDir, 'extracted');
-            if (!await extractRtkArchive(archivePath, extractDir))
-                return;
-            const found = await findFile(extractDir, RTK_BINARY_NAME);
-            if (!found) {
-                console.log(`  [fail] Could not find ${RTK_BINARY_NAME} in extracted archive`);
-                return;
-            }
-            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: 10000, shell: false })).stdout.trim();
-                console.log(`  [ok] ${binDest} → ${v}`);
-            }
-            catch {
-                console.log(`  [hint] Verify manually: ${binDest} --version`);
-            }
-        }
-        finally {
-            await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
-        }
-    }
-    catch (e) {
-        console.log(`  [fail] RTK: ${e.message}`);
-        console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
-    }
-}
-// Copy repo source files into the target extension dir. First entry is
-// required (skip label on missing); rest are optional companions.
-async function copySources(extDir, files, skipLabel, options) {
-    const src = await readTextIfExists(files[0][0]);
-    if (!src) {
-        console.log(`  [skip] ${skipLabel} not found in repo`);
-        return false;
-    }
-    await writeIfChanged(path.join(extDir, files[0][1]), src, options);
-    const rest = files.slice(1);
-    const extras = await Promise.all(rest.map(([from]) => readTextIfExists(from)));
-    for (let i = 0; i < rest.length; i++) {
-        const extra = extras[i];
-        if (extra)
-            await writeIfChanged(path.join(extDir, rest[i][1]), extra, options);
-    }
-    return true;
-}
-async function stepSharedSessionState(extDir, options) {
-    await copySources(extDir, [
-        [SHARED_SESSION_STATE, path.join('shared', 'session-state.js')],
-        [SHARED_TYPES, path.join('shared', 'types.js')],
-        [LIB_UTILS, path.join('lib', 'utils.js')],
-        [SHARED_PLUGIN_SETTINGS, path.join('shared', 'plugin-settings.js')],
-    ], 'shared/session-state.js', options);
-}
-async function stepModeReinforcement(extDir, ponytailExtPath, options) {
-    console.log('\n[7/7] 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...');
-    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
-// and fall back to the bundled rule to preview its destination.
-async function fetchCavemanRule(options) {
-    if (options.dryRun)
-        return (await readTextIfExists(path.join(path.dirname(CAVEMAN_INDEX), 'rule.md'))) || '';
-    try {
-        return await withInteractiveSpinner('Fetching Caveman rule', () => httpsGet(CAVEMAN_REMOTE_RULE));
-    }
-    catch (e) {
-        console.log(`  [warn] Could not fetch caveman rule: ${e.message}`);
-        return null;
-    }
-}
-async function stepCaveman(extDir, rule, options) {
-    console.log('\n[5/7] Installing Caveman session extension...');
-    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');
-    }
-    else if (rule === null) {
-        console.log('  [skip] Caveman rule.md unavailable');
-        console.log(`  [hint] Manual: ${CAVEMAN_REMOTE_RULE}`);
-    }
-    else {
-        await writeIfChanged(ruleDest, rule, options);
-    }
-    await copySources(extDir, [[CAVEMAN_INDEX, path.join('caveman-session', 'index.js')]], 'caveman-session/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...');
-    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;
-    // Auto-register combo in config.yml
-    const configPath = path.join(path.dirname(extDir), 'config.yml');
-    await ensureExtensionInConfig(configPath, dest, 'combo', options);
-}
-// --- Doctor ---
-async function runDoctor() {
-    console.log('\n=== Tersio Doctor ===');
-    // Directories
-    const agentDir = OMP_AGENT_DIR;
-    const extDir = path.join(agentDir, 'extensions');
-    const configPath = path.join(agentDir, 'config.yml');
-    const pluginsDir = OMP_PLUGINS_DIR;
-    const rtkBin = path.join(BUN_BIN_DIR, RTK_BINARY_NAME);
-    // Ponytail
-    const ponytailPkg = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'package.json');
-    const ponytailExt = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
-    const cavemanIndex = path.join(extDir, 'caveman-session', 'index.js');
-    const cavemanRule = path.join(extDir, 'caveman-session', 'rule.md');
-    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 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
-    // their data settles. Every probe resolves instead of rejecting.
-    const probes = {
-        ompVersion: execP(OMP_BIN, ['--version']).then((r) => r.stdout.trim(), () => null),
-        agentEntries: fs.readdir(agentDir).catch(() => null),
-        extEntries: fs.readdir(extDir).catch(() => null),
-        sharedStateText: readTextIfExists(path.join(extDir, 'shared', 'session-state.js')),
-        configText: readTextIfExists(configPath),
-        ponytailPkgText: readTextIfExists(ponytailPkg),
-        ponytailExtText: readTextIfExists(ponytailExt),
-        pluginsPkgRaw: readTextIfExists(path.join(pluginsDir, 'package.json')),
-        selfPkgText: readTextIfExists(selfPkg),
-        rtkBinText: readTextIfExists(rtkBin),
-        cavemanIndexText: readTextIfExists(cavemanIndex),
-        cavemanRuleText: readTextIfExists(cavemanRule),
-        rtkIndexText: readTextIfExists(rtkIndex),
-        updaterIndexText: readTextIfExists(updaterIndex),
-        comboIndexText: readTextIfExists(comboIndex),
-        modeReinforcementText: readTextIfExists(modeReinforcement),
-        ruleMtime: fs.stat(cavemanRule).catch(() => null),
-        rtkMtime: fs.stat(rtkBin).catch(() => null),
-        ponytailMtime: fs.stat(ponytailPkg).catch(() => null),
-        updateVersion: checkForUpdate(),
-    };
-    const rtkVersionProbe = probes.rtkBinText.then((text) => text === null ? null : execP(rtkBin, ['--version'], { timeout: 5000 }).then((r) => r.stdout.trim() || r.stderr.trim() || null, (e) => {
-        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 [cavemanIndexText, rtkIndexText, updaterIndexText, comboIndexText, modeReinforcementText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText] = await runInteractivePhase('Checking extensions and plugins', () => Promise.all([
-        probes.cavemanIndexText,
-        probes.rtkIndexText,
-        probes.updaterIndexText,
-        probes.comboIndexText,
-        probes.modeReinforcementText,
-        probes.ponytailPkgText,
-        probes.ponytailExtText,
-        probes.pluginsPkgRaw,
-        probes.selfPkgText,
-    ]));
-    const [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, ponytailMtime] = await runInteractivePhase('Checking add-ons', () => Promise.all([
-        probes.cavemanRuleText,
-        probes.ruleMtime,
-        probes.rtkBinText,
-        probes.rtkMtime,
-        rtkVersionProbe,
-        probes.ponytailMtime,
-    ]));
-    // Categorized output with a tally; section headers group related probes.
-    const tally = { ok: 0, missing: 0, warn: 0 };
-    function check(label, ok, detail = '') {
-        if (ok) {
-            tally.ok++;
-            console.log(`  ${label}: ok${detail ? ` ${detail}` : ''}`);
-        }
-        else {
-            tally.missing++;
-            console.log(`  ${label}: MISSING${detail ? ` ${detail}` : ''}`);
-        }
-    }
-    function warnLine(label, detail) {
-        tally.warn++;
-        console.log(`  ${label}: warn ${detail}`);
-    }
-    section('Environment');
-    check('Node', true, process.version);
-    check('OMP CLI', ompVersion !== null, ompVersion ?? '');
-    if (updateVersion)
-        warnLine('Tersio CLI', `${updateVersion} available — run tersio update`);
-    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('Shared session bridge', sharedStateText !== null);
-    section('Extensions');
-    check('Caveman extension', cavemanIndexText !== null);
-    check('RTK extension', rtkIndexText !== null);
-    check('Updater extension', updaterIndexText !== null);
-    check('Combo extension', comboIndexText !== 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('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('Add-ons');
-    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');
-    }
-    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`);
-}
-function section(name) {
-    console.log(`\n${name}`);
-}
-// Read-modify-write a JSON file. mutate returns true when it changed
-// something; no change (or unreadable file) means no output at all.
-async function updateJsonFile(filePath, mutate, dryRunNote, writeNote, dryRun) {
-    const raw = await readTextIfExists(filePath);
-    if (!raw)
-        return;
-    let data;
-    try {
-        data = JSON.parse(raw);
-    }
-    catch {
-        debug(`Could not parse ${filePath}`);
-        return;
-    }
-    if (!mutate(data))
-        return;
-    if (dryRun) {
-        console.log(`  [dry-run] ${dryRunNote}`);
-        return;
-    }
-    await fs.writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
-    console.log(`  [write] ${writeNote}`);
-}
-function dropKey(section, key) {
-    if (!section || typeof section !== 'object')
-        return false;
-    const record = section;
-    if (!(key in record))
-        return false;
-    delete record[key];
-    return true;
-}
-async function removeUninstallTarget(target, shouldDryRun, recursive = true) {
-    try {
-        if (shouldDryRun) {
-            console.log(`  [dry-run] would remove ${target}`);
-            return;
-        }
-        if (recursive)
-            await fs.rm(target, { recursive: true, force: true });
-        else
-            await fs.unlink(target);
-        console.log(`  [rm] ${target}`);
-    }
-    catch {
-        debug(`Could not remove ${target}`);
-    }
-}
-async function runUninstall(options = {}) {
-    const shouldDryRun = options.dryRun ?? dryRun;
-    const confirmed = (options.yes ?? yes) || shouldDryRun;
-    // Ponytail ships with Tersio's presets, so a full uninstall removes it too;
-    // --keep-ponytail opts out and reinstall always preserves it.
-    const shouldRemovePonytail = options.removePonytail ?? (removePonytail || !keepPonytail);
-    const shouldRemoveRtk = options.removeRtk ?? removeRtk;
-    console.log('\n=== Tersio Uninstall ===\n');
-    const extDir = path.join(OMP_AGENT_DIR, 'extensions');
-    const configPath = path.join(OMP_AGENT_DIR, 'config.yml');
-    const rtkBin = path.join(BUN_BIN_DIR, RTK_BINARY_NAME);
-    const pluginsDir = OMP_PLUGINS_DIR;
-    const ponytailPkgDir = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail');
-    const targets = [
-        'caveman-session',
-        'rtk-session',
-        'ai-addons-updater',
-        'combo-toggle',
-        'shared',
-        // Only consumed by ai-addons-updater (removed above); otherwise orphaned.
-        'lib',
-        // Legacy always-on combo helper; imports shared/session-state.js, so it
-        // breaks with a module-not-found warning once the shared dir is removed.
-        'aaa-combo-boot',
-    ].map((dir) => path.join(extDir, dir));
-    console.log('Will remove:');
-    for (const t of targets) {
-        console.log(`  ${t}`);
-    }
-    if (shouldRemovePonytail) {
-        console.log(`  ${ponytailPkgDir} (ponytail plugin package)`);
-    }
-    if (shouldRemoveRtk) {
-        console.log(`  ${rtkBin}`);
-    }
-    if (!confirmed) {
-        if (tty()) {
-            closeRL();
-            const confirmedChoice = await clackConfirm({ message: 'Remove the listed Tersio files?', initialValue: false });
-            if (typeof confirmedChoice !== 'boolean') {
-                clackCancel('Aborted.');
-                closeRL();
-                return false;
-            }
-            if (!confirmedChoice) {
-                console.log('Aborted.');
-                closeRL();
-                return false;
-            }
-        }
-        else {
-            const answer = await ask('\nProceed? [y/N]: ');
-            if (!answer.toLowerCase().startsWith('y')) {
-                console.log('Aborted.');
-                closeRL();
-                return false;
-            }
-        }
-    }
-    // Remove extension directories (independent paths, so concurrently).
-    await Promise.all(targets.map((t) => removeUninstallTarget(t, shouldDryRun)));
-    // Remove Combo and mode-reinforcement registrations; Ponytail only when requested.
-    const configRaw = await readTextIfExists(configPath);
-    if (configRaw) {
-        let lines = configRaw.split('\n');
-        const before = lines.length;
-        lines = lines.filter((l) => {
-            if (l.includes('combo-toggle') || l.includes('mode-reinforcement'))
-                return false;
-            if (shouldRemovePonytail && l.includes('ponytail') && l.includes('pi-extension'))
-                return false;
-            return true;
-        });
-        if (lines.length !== before) {
-            if (shouldDryRun)
-                console.log(`  [dry-run] would remove ${before - lines.length} config.yml entries`);
-            else
-                await writeConfigLines(configPath, lines, `  [write] Updated config.yml (removed ${before - lines.length} entries)`);
-        }
-    }
-    // Remove the Ponytail plugin package the installer added (dep, files,
-    // lock entry); the config.yml entry was filtered above.
-    if (shouldRemovePonytail) {
-        const pluginsPkgPath = path.join(pluginsDir, 'package.json');
-        await updateJsonFile(pluginsPkgPath, (data) => dropKey(data.dependencies, '@dietrichgebert/ponytail'), `would remove @dietrichgebert/ponytail from ${pluginsPkgPath}`, 'Removed @dietrichgebert/ponytail from plugins/package.json', shouldDryRun);
-        try {
-            if (shouldDryRun)
-                console.log(`  [dry-run] would remove ${ponytailPkgDir}`);
-            else {
-                await fs.rm(ponytailPkgDir, { recursive: true, force: true });
-                console.log(`  [rm] ${ponytailPkgDir}`);
-                await fs.rm(path.dirname(ponytailPkgDir));
-                console.log(`  [rm] ${path.dirname(ponytailPkgDir)} (empty scope)`);
-            }
-        }
-        catch {
-            debug('Could not remove ponytail package dir (scope may hold other packages)');
-        }
-        const lockPath = path.join(pluginsDir, 'omp-plugins.lock.json');
-        await updateJsonFile(lockPath, (data) => dropKey(data.plugins, '@dietrichgebert/ponytail'), `would remove @dietrichgebert/ponytail from ${lockPath}`, `Removed @dietrichgebert/ponytail from ${lockPath}`, shouldDryRun);
-    }
-    // Remove our plugin registration from ~/.omp/plugins
-    const pluginsPkgPath = path.join(pluginsDir, 'package.json');
-    await updateJsonFile(pluginsPkgPath, (data) => dropKey(data.dependencies, PACKAGE_NAME), `would remove ${PACKAGE_NAME} from ${pluginsPkgPath}`, `Removed ${PACKAGE_NAME} from plugins/package.json`, shouldDryRun);
-    const selfPluginDir = path.join(pluginsDir, 'node_modules', PACKAGE_NAME);
-    if ((await readTextIfExists(path.join(selfPluginDir, 'package.json'))) !== null) {
-        await removeUninstallTarget(selfPluginDir, shouldDryRun);
-    }
-    // Remove RTK binary if requested
-    if (shouldRemoveRtk)
-        await removeUninstallTarget(rtkBin, shouldDryRun, false);
-    console.log('\nDone. Restart OMP for changes to take effect.');
-    return true;
-}
-const SCOPE_MAP = { user: '1', project: '2', both: '3' };
-// --- Update check (cached; used by the bare-invocation banner and doctor) ---
-const UPDATE_CHECK_TTL_MS = 6 * 60 * 60 * 1000;
-function newerThan(a, b) {
-    const pa = a.replace(/^v/, '').split('.').map((n) => parseInt(n, 10) || 0);
-    const pb = b.replace(/^v/, '').split('.').map((n) => parseInt(n, 10) || 0);
-    for (let i = 0; i < 3; i++) {
-        if ((pa[i] || 0) !== (pb[i] || 0))
-            return (pa[i] || 0) > (pb[i] || 0);
-    }
-    return false;
-}
-async function latestPublishedVersion() {
-    try {
-        const args = IS_WINDOWS
-            ? ['/d', '/s', '/c', 'npm', 'view', PACKAGE_NAME, 'version', '--prefer-online']
-            : ['view', PACKAGE_NAME, 'version', '--prefer-online'];
-        const r = await execNetwork('Checking npm registry for tersio updates', IS_WINDOWS ? process.env.ComSpec || 'cmd.exe' : 'npm', args, {
-            timeout: 4000,
-            maxBuffer: 1024 * 1024,
-            windowsHide: true,
-            shell: false,
-        });
-        return r.stdout.trim() || null;
-    }
-    catch {
-        return null;
-    }
-}
-// Returns a newer published version, or null. Reads the registry at most once
-// per TTL (cached under OMP_PLUGINS_DIR) and stays silent on failure.
-async function checkForUpdate() {
-    const cachePath = path.join(OMP_PLUGINS_DIR, 'tersio-update-check.json');
-    const cached = parseJsonObject(await readTextIfExists(cachePath));
-    const cacheFresh = typeof cached?.lastCheck === 'number' && Date.now() - cached.lastCheck < UPDATE_CHECK_TTL_MS;
-    if (cacheFresh && cached?.latest)
-        return newerThan(cached.latest, PACKAGE_VERSION) ? cached.latest : null;
-    const latest = await latestPublishedVersion();
-    if (latest) {
-        await fs.mkdir(OMP_PLUGINS_DIR, { recursive: true }).catch(() => { });
-        await fs.writeFile(cachePath, JSON.stringify({ latest, lastCheck: Date.now() }) + '\n', 'utf8').catch(() => { });
-        return newerThan(latest, PACKAGE_VERSION) ? latest : null;
-    }
-    // Registry unreachable: fall back to a stale cache rather than staying silent.
-    return cached?.latest && newerThan(cached.latest, PACKAGE_VERSION) ? cached.latest : null;
-}
-function relTime(ageMs) {
-    const mins = Math.floor(ageMs / 60000);
-    if (mins < 1)
-        return 'just now';
-    if (mins < 60)
-        return `${mins} min${mins === 1 ? '' : 's'} ago`;
-    const hours = Math.floor(mins / 60);
-    if (hours < 24)
-        return `${hours} hour${hours === 1 ? '' : 's'} ago`;
-    const days = Math.floor(hours / 24);
-    if (days < 14)
-        return `${days} day${days === 1 ? '' : 's'} ago`;
-    const weeks = Math.floor(days / 7);
-    return `${weeks} week${weeks === 1 ? '' : 's'} ago`;
-}
-async function runLatestUpdate() {
-    const updateScope = scopeFlag || 'user';
-    if (!Object.hasOwn(SCOPE_MAP, updateScope)) {
-        console.error(`[fail] Invalid --scope: ${updateScope}. Use: user, project, both`);
-        process.exitCode = 1;
-        return;
-    }
-    const forwardedArgs = ['--yes', '--scope', updateScope];
-    if (dryRun)
-        forwardedArgs.push('--dry-run');
-    if (verbose)
-        forwardedArgs.push('--verbose');
-    const npmArgs = [
-        'exec',
-        '--yes',
-        '--prefer-online',
-        `--package=${PACKAGE_NAME}@latest`,
-        '--',
-        PACKAGE_BIN,
-        '--apply-update',
-        ...forwardedArgs,
-    ];
-    const npmCommand = IS_WINDOWS ? process.env.ComSpec || 'cmd.exe' : 'npm';
-    const npmCommandArgs = IS_WINDOWS ? ['/d', '/s', '/c', 'npm', ...npmArgs] : npmArgs;
-    console.log('=== Updating Tersio ===');
-    console.log(`  Running the latest ${PACKAGE_NAME} installer...\n`);
-    // The npx delegation below only refreshes the OMP-side files; the globally
-    // installed CLI keeps its old version until npm -g runs. Refresh both.
-    if (dryRun) {
-        console.log(`  [dry-run] would run: npm install -g ${PACKAGE_NAME}@latest --no-audit --no-fund`);
-    }
-    else {
-        try {
-            const globalArgs = IS_WINDOWS ? ['/d', '/s', '/c', 'npm', 'install', '-g', `${PACKAGE_NAME}@latest`, '--no-audit', '--no-fund'] : ['install', '-g', `${PACKAGE_NAME}@latest`, '--no-audit', '--no-fund'];
-            const globalResult = await execNetwork('Updating global Tersio CLI', npmCommand, globalArgs, {
-                timeout: 300000,
-                maxBuffer: 10 * 1024 * 1024,
-                windowsHide: true,
-                shell: false,
-            });
-            if (globalResult.stdout)
-                process.stdout.write(globalResult.stdout);
-            if (globalResult.stderr)
-                process.stderr.write(globalResult.stderr);
-            console.log(`  [ok] CLI updated to ${PACKAGE_NAME}@latest`);
-        }
-        catch (e) {
-            console.log(`  [warn] Global CLI update skipped: ${e.message}`);
-            console.log(`  [hint] Manual: npm install -g ${PACKAGE_NAME}@latest`);
-        }
-    }
-    try {
-        const result = await execNetwork('Running latest Tersio installer', npmCommand, npmCommandArgs, {
-            timeout: 300000,
-            maxBuffer: 10 * 1024 * 1024,
-            windowsHide: true,
-            shell: false,
-        });
-        if (result.stdout)
-            process.stdout.write(result.stdout);
-        if (result.stderr)
-            process.stderr.write(result.stderr);
-        console.log('\n=== Update complete ===');
-    }
-    catch (e) {
-        const err = e;
-        if (err.stdout)
-            process.stdout.write(err.stdout);
-        if (err.stderr)
-            process.stderr.write(err.stderr);
-        process.exitCode = 1;
-    }
-}
-// --- Install profile (session-start mode defaults) ---
-function defaultProfile() {
-    return {
-        comboDefault: 'off',
-        cavemanDefault: 'off',
-        rtkDefault: false,
-        ponytailDefault: 'off',
-    };
-}
-function tty() {
-    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
-let spinnerDepth = 0;
-// Run async work under a TTY-only timer spinner. The spinner is cleared before
-// the caller prints its normal result line, preserving locked output shapes.
-async function withInteractiveSpinner(message, work) {
-    if (!tty() || spinnerDepth > 0)
-        return work(() => { });
-    // Clack manages stdin itself. Close the legacy question interface before its
-    // first use; non-interactive callers never reach this branch.
-    closeRL();
-    const active = clackSpinner({ indicator: 'timer' });
-    active.start(message);
-    spinnerDepth += 1;
-    try {
-        return await work((next) => { active.message(next); });
-    }
-    finally {
-        active.clear();
-        spinnerDepth -= 1;
-    }
-}
-async function askInteractiveChoice(message, options, initialValue) {
-    if (!tty())
-        return { status: 'unavailable' };
-    closeRL();
-    const choice = await clackSelect({ message, options, initialValue });
-    if (typeof choice !== 'string') {
-        clackCancel('Aborted.');
-        return { status: 'cancelled' };
-    }
-    return { status: 'selected', value: choice };
-}
-// 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) {
-    if (!tty())
-        return collect();
-    closeRL();
-    let result;
-    await clackTasks([{ title, task: async () => { result = await collect(); } }]);
-    return result;
-}
-// Determine install scope: reinstall > flag > non-interactive default > prompt.
-async function resolveScope() {
-    if (reinstall) {
-        console.log('  Scope: user (reinstall)');
-        return '1';
-    }
-    if (scopeFlag) {
-        const scope = SCOPE_MAP[scopeFlag];
-        if (!scope) {
-            console.log(`  [fail] Invalid --scope: ${scopeFlag}. Use: user, project, both`);
-            closeRL();
-            process.exit(1);
-        }
-        console.log(`  Scope: ${scopeFlag}`);
-        return scope;
-    }
-    if (install || yes) {
-        console.log(`  Scope: user (${install ? 'install default' : '--scope omitted, defaulting to user with --yes'})`);
-        return '1';
-    }
-    if (tty()) {
-        const choice = await askInteractiveChoice('Install scope', [
-            { value: '1', label: 'User-level', hint: 'all OMP sessions' },
-            { value: '2', label: 'Project-level', hint: 'this repo only' },
-            { value: '3', label: 'Both' },
-        ], '1');
-        if (choice.status === 'selected')
-            return choice.value;
-        closeRL();
-        process.exit(130);
-    }
-    console.log('\nInstall scope:');
-    console.log('  1) User-level (all OMP sessions)');
-    console.log('  2) Project-level (this repo only)');
-    console.log('  3) Both');
-    while (true) {
-        const answer = (await ask('\nChoose [1-3] (default 1): ')).trim() || '1';
-        if (answer === '1' || answer === '2' || answer === '3')
-            return answer;
-        console.log(`  [fail] Invalid scope: ${answer}. Choose 1, 2, or 3.`);
-    }
-}
-async function resolveProfile() {
-    const profile = defaultProfile();
-    // Single interactive prompt: the Combo preset implies all three modes.
-    // Numbered menu, same pattern as the scope prompt — no typing preset names.
-    // Only for a real user at a terminal, only when no default flags were
-    // given, and never for --apply-update runs.
-    if (tty() && !profileFlagsGiven && !applyUpdate && (install || reinstall)) {
-        const choice = await askInteractiveChoice('Session-start defaults — Combo preset', [
-            { value: 'off', label: 'off' },
-            { 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');
-        if (choice.status === 'selected')
-            profile.comboDefault = choice.value;
-        else {
-            closeRL();
-            process.exit(130);
-        }
-    }
-    // Explicit flags always win over the Combo preset.
-    if (comboDefaultFlag !== undefined)
-        profile.comboDefault = comboDefaultFlag;
-    const preset = COMBO_PRESET_MODES[profile.comboDefault] ?? COMBO_PRESET_MODES.off;
-    profile.cavemanDefault = preset.caveman;
-    profile.rtkDefault = preset.rtk;
-    profile.ponytailDefault = preset.ponytail;
-    if (cavemanDefaultFlag !== undefined)
-        profile.cavemanDefault = cavemanDefaultFlag;
-    if (rtkDefaultFlag !== undefined)
-        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})`);
-    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) {
-    const pluginsDir = OMP_PLUGINS_DIR;
-    const lockPath = path.join(pluginsDir, 'omp-plugins.lock.json');
-    let config = {};
-    const existing = await readTextIfExists(lockPath);
-    if (existing) {
-        try {
-            config = JSON.parse(existing);
-        }
-        catch {
-            config = {};
-        }
-    }
-    config.plugins = config.plugins || {};
-    config.settings = config.settings || {};
-    config.settings[PACKAGE_NAME] = {
-        ...(config.settings[PACKAGE_NAME] || {}),
-        comboDefault: profile.comboDefault,
-        cavemanDefault: profile.cavemanDefault,
-        rtkDefault: profile.rtkDefault,
-        ponytailDefault: profile.ponytailDefault,
-    };
-    if (options.dryRun) {
-        console.log(`  [dry-run] would write plugin settings (${PACKAGE_NAME}) to ${lockPath}`);
-        return;
-    }
-    await fs.mkdir(pluginsDir, { recursive: true });
-    await fs.writeFile(lockPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
-    console.log(`  [write] Plugin settings in ${lockPath}`);
-}
-// --- Main ---
 async function main() {
     if (showVersion) {
         console.log(PACKAGE_VERSION);
@@ -1329,79 +69,21 @@ async function main() {
         closeRL();
         return;
     }
-    if (uninstall) {
-        await runUninstall();
+    if (usage) {
+        await runUsage();
         closeRL();
         return;
     }
-    if (reinstall) {
-        await runUninstall({ yes: true, removePonytail: false, removeRtk: true });
-    }
-    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}`);
-    // 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') {
-        const newer = await checkForUpdate();
-        if (newer)
-            console.log(`\n  [update] tersio ${newer} available (installed ${PACKAGE_VERSION}) — run \`tersio update\``);
-    }
-    const scope = await resolveScope();
-    // Resolve session defaults: flags > interactive prompt > defaults.
-    const profile = await resolveProfile();
-    const userDir = OMP_AGENT_DIR;
-    const userExtDir = path.join(userDir, 'extensions');
-    const projectExtDir = path.join(process.cwd(), '.omp', '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, scope, reinstall: reinstall || applyUpdate };
-    // Check prerequisites
-    console.log('\nPrerequisites:');
-    try {
-        const v = (await execP(OMP_BIN, ['--version'])).stdout.trim();
-        console.log(`  [ok] omp ${v}`);
-    }
-    catch {
-        console.log('  [fail] omp not found — ensure it\'s installed');
-    }
-    const cavemanRule = await fetchCavemanRule(options);
-    if (scope === '1' || scope === '3') {
-        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 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 stepModeReinforcement(userExtDir, ponytailExtPath, options);
-        await stepUpdater(userExtDir, options);
-        if (selfPlugin)
-            await writePluginSettings(profile, options);
-        await validateConfigExtensions(userDir, options);
+    if (dashboard) {
+        await runDashboard({ port: dashboardPort, open: dashboardOpen, exportFile: dashboardExport });
+        closeRL();
+        return;
     }
-    if (scope === '2' || scope === '3') {
-        console.log('\n--- Project-level install ---');
-        await stepSharedSessionState(projectExtDir, options);
-        await stepRtkSession(projectExtDir, options);
-        await stepCaveman(projectExtDir, cavemanRule, options);
-        await stepUpdater(projectExtDir, options);
-        console.log('  [note] Ponytail, RTK binary, and Combo toggle require user-level (global) install');
+    if (uninstall) {
+        await runUninstall();
+        closeRL();
+        return;
     }
-    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)');
-    closeRL();
+    await runInstall();
 }
 main().catch((e) => { closeRL(); console.error(e); process.exitCode = 1; });