@krtclcdy/tersio 2.20.1 → 2.21.0

package/README.md

@@ -103,7 +103,7 @@ Break-even math, balanced preset (caveman full + rtk + ponytail): a mixed turn c
 | `tersio install` | Install (user scope: all OMP sessions) |
 | `tersio update` | Refresh the CLI, extensions, and add-ons (RTK binary, Caveman rule, Ponytail) |
 | `tersio reinstall` | Fresh install, preserving the Ponytail package |
-| `tersio doctor` | Check OMP, extension, Ponytail, and RTK health |
+| `tersio doctor` | Check OMP, extension, Ponytail, and RTK health (`--fix` repairs, `--fix=<scope>` one scope, `--dry-run` previews) |
 | `tersio usage` | Ledger-backed usage + savings report |
 | `tersio gain` | Open the gain dashboard (`--open`, `--export <file>`, `--port <n>`, `--currency <code>`; serves localhost only) |
 | `tersio reset` | Clear tersio statistics: usage ledger + a watermark that hides pre-reset rows from every derived view (Y/N confirm, `--dry-run`, `--yes`) — session transcripts and RTK history stay intact on disk |

package/cli/common.js

@@ -62,6 +62,7 @@ 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 fix = args.includes('--fix') || args.some((a) => a.startsWith('--fix='));
 const usage = command === 'usage' || args.includes('--usage');
 const gain = command === 'gain';
 const reset = command === 'reset';
@@ -285,4 +286,4 @@ function relTime(ageMs) {
     const weeks = Math.floor(days / 7);
     return `${weeks} week${weeks === 1 ? '' : 's'} ago`;
 }
-export { IS_WINDOWS, RTK_BINARY_NAME, HOME, OMP_AGENT_DIR, OMP_PLUGINS_DIR, BUN_BIN_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_BIN, PACKAGE_VERSION, CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS, RTK_DEFAULTS, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, unknownCommand, install, update, reinstall, showVersion, showHelp, applyUpdate, dryRun, yes, verbose, doctor, uninstall, usage, gain, reset, settings, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, profileFlagsGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, ensureExtensionAfterConfigEntry, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, relTime, };
+export { IS_WINDOWS, RTK_BINARY_NAME, HOME, OMP_AGENT_DIR, OMP_PLUGINS_DIR, BUN_BIN_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_BIN, PACKAGE_VERSION, CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS, RTK_DEFAULTS, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, unknownCommand, install, update, reinstall, showVersion, showHelp, applyUpdate, args, dryRun, yes, verbose, doctor, fix, uninstall, usage, gain, reset, settings, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, profileFlagsGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, ensureExtensionAfterConfigEntry, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, relTime, };

package/cli/doctor-fix.js

@@ -0,0 +1,185 @@
+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, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, dryRun, verbose, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, execP, readPluginsPackage, writeIfChanged, } from './common.js';
+import { execNetwork } from './interactive.js';
+import { wireRtkOmp, ensureRtkInConfig } from './rtk-wiring.js';
+import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, parseChecksum, readTextIfExists, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
+import { runLatestUpdate } from './update.js';
+const EXT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'extensions');
+const SOURCES = [
+    [path.join(EXT_DIR, 'shared', 'session-state.ts'), path.join('shared', 'session-state.ts')],
+    [path.join(EXT_DIR, 'shared', 'types.ts'), path.join('shared', 'types.ts')],
+    [path.join(EXT_DIR, 'lib', 'utils.ts'), path.join('lib', 'utils.ts')],
+    [path.join(EXT_DIR, 'shared', 'plugin-settings.ts'), path.join('shared', 'plugin-settings.ts')],
+    [path.join(EXT_DIR, 'shared', 'usage-ledger.ts'), path.join('shared', 'usage-ledger.ts')],
+    [path.join(EXT_DIR, 'shared', 'pricing.ts'), path.join('shared', 'pricing.ts')],
+    [path.join(EXT_DIR, 'shared', 'carbon.ts'), path.join('shared', 'carbon.ts')],
+    [path.join(EXT_DIR, 'caveman-session', 'index.ts'), path.join('caveman-session', 'index.ts')],
+    [path.join(EXT_DIR, 'rtk-session', 'index.ts'), path.join('rtk-session', 'index.ts')],
+    [path.join(EXT_DIR, 'ai-addons-updater', 'index.ts'), path.join('ai-addons-updater', 'index.ts')],
+    [path.join(EXT_DIR, 'combo-toggle', 'index.ts'), path.join('combo-toggle', 'index.ts')],
+    [path.join(EXT_DIR, 'tersio-commands', 'index.ts'), path.join('tersio-commands', 'index.ts')],
+    [path.join(EXT_DIR, 'shared', 'mode-reinforcement.ts'), path.join('shared', 'mode-reinforcement.ts')],
+];
+const PONYTAIL_GITHUB_SPEC = 'github:DietrichGebert/ponytail';
+const PONYTAIL_NPM_SPEC = '@dietrichgebert/ponytail@latest';
+async function fixExtensions(extDir) {
+    console.log('  Doctor --fix: restoring extension files');
+    await fs.mkdir(extDir, { recursive: true });
+    const texts = await Promise.all(SOURCES.map(([from]) => readTextIfExists(from)));
+    const writes = [];
+    for (let i = 0; i < SOURCES.length; i++) {
+        if (texts[i] !== null)
+            writes.push(writeIfChanged(path.join(extDir, SOURCES[i][1]), texts[i], { dryRun, verbose }));
+        else
+            console.log(`  [warn] bundled source missing: ${SOURCES[i][0]}`);
+    }
+    await Promise.all(writes);
+    if ((await readTextIfExists(path.join(extDir, 'caveman-session', 'rule.md'))) === null) {
+        const rule = await Promise.race([
+            httpsGet(CAVEMAN_REMOTE_RULE).catch(() => null),
+            new Promise((resolve) => setTimeout(() => resolve(null), 8000)),
+        ]);
+        if (rule !== null)
+            await writeIfChanged(path.join(extDir, 'caveman-session', 'rule.md'), rule, { dryRun, verbose });
+        else
+            console.log('  [warn] Caveman rule unreachable — kept existing rule.md');
+    }
+}
+async function fixRegistrations(agentDir, pluginsDir) {
+    console.log('  Doctor --fix: repairing config.yml registrations');
+    const configPath = path.join(agentDir, 'config.yml');
+    if ((await readTextIfExists(configPath)) === null) {
+        if (dryRun)
+            console.log(`  [dry-run] would create ${configPath}`);
+        else {
+            await fs.mkdir(agentDir, { recursive: true });
+            await fs.writeFile(configPath, 'extensions:\n', 'utf8');
+        }
+    }
+    const extDir = path.join(agentDir, 'extensions');
+    const ponytailExtPath = path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js');
+    await ensureExtensionInConfig(configPath, ponytailExtPath, 'ponytail', { dryRun, verbose });
+    await ensureExtensionInConfig(configPath, path.join(extDir, 'combo-toggle', 'index.ts'), 'combo', { dryRun, verbose });
+    const rtkTs = path.join(extDir, 'rtk.ts');
+    if ((await readTextIfExists(rtkTs)) !== null)
+        await ensureRtkInConfig({ dryRun, verbose });
+    await ensureExtensionAfterConfigEntry(configPath, path.join(extDir, 'shared', 'mode-reinforcement.ts'), ponytailExtPath, 'mode reinforcement', { dryRun, verbose });
+    const pkgPath = path.join(pluginsDir, 'package.json');
+    const pkg = await readPluginsPackage(pkgPath);
+    if (!(PACKAGE_NAME in pkg.dependencies)) {
+        pkg.dependencies[PACKAGE_NAME] = `^${PACKAGE_VERSION}`;
+        if (dryRun)
+            console.log(`  [dry-run] would register ${PACKAGE_NAME} in ${pkgPath}`);
+        else {
+            await fs.mkdir(pluginsDir, { recursive: true });
+            await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+        }
+    }
+}
+async function fixRtk(binDir) {
+    console.log('  Doctor --fix: repairing RTK binary + wiring');
+    const binDest = path.join(binDir, RTK_BINARY_NAME);
+    if (dryRun) {
+        console.log(`  [dry-run] would download a checksum-verified rtk to ${binDest} and wire it into OMP`);
+        return;
+    }
+    const spec = rtkPlatformSpec();
+    if (!spec)
+        throw new Error(`unsupported platform ${process.platform}/${process.arch}`);
+    const release = await fetchJson(RTK_RELEASE_API);
+    const asset = (release.assets || []).find((a) => a.name === `rtk-${spec.triple}${spec.ext}`);
+    const checksAsset = (release.assets || []).find((a) => a.name === 'checksums.txt');
+    if (!asset || !checksAsset)
+        throw new Error(`required assets missing in release ${release.tag_name}`);
+    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'tersio-doctor-rtk-'));
+    try {
+        const archivePath = path.join(tmpDir, asset.name);
+        const [checks] = await Promise.all([
+            httpsGet(checksAsset.browser_download_url).catch(() => null),
+            httpsDownload(asset.browser_download_url, archivePath),
+        ]);
+        if (checks) {
+            const expected = parseChecksum(checks, asset.name);
+            if (expected && await sha256File(archivePath) !== expected)
+                throw new Error(`checksum mismatch for ${asset.name}`);
+            debug('RTK checksum verified');
+        }
+        const extractDir = path.join(tmpDir, 'extracted');
+        await fs.mkdir(extractDir, { recursive: true });
+        if (asset.name.endsWith('.zip'))
+            await execP('powershell', ['Expand-Archive', '-Path', archivePath, '-DestinationPath', extractDir, '-Force'], { timeout: 60000 });
+        else
+            await execP('tar', ['xzf', archivePath, '-C', extractDir], { timeout: 60000 });
+        const found = await findFile(extractDir, RTK_BINARY_NAME);
+        if (!found)
+            throw new Error(`${RTK_BINARY_NAME} not found in ${asset.name}`);
+        await fs.mkdir(path.dirname(binDest), { recursive: true });
+        await fs.copyFile(binDest, `${binDest}.bak`).catch(() => { });
+        await fs.copyFile(found, binDest);
+        if (process.platform !== 'win32')
+            await fs.chmod(binDest, 0o755);
+        await execP(binDest, ['--version'], { timeout: 30000, shell: false });
+    }
+    finally {
+        await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
+    }
+    if (!(await wireRtkOmp(binDest, { dryRun, verbose })))
+        throw new Error('rtk wiring failed');
+}
+async function fixPonytail(pluginsDir, agentDir) {
+    console.log('  Doctor --fix: refreshing Ponytail package');
+    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 (dryRun) {
+        console.log(`  [dry-run] would run: omp plugin install ${PONYTAIL_GITHUB_SPEC}`);
+        console.log(`  [dry-run] would run: npm install ${PONYTAIL_NPM_SPEC} --save --no-audit --no-fund`);
+        return;
+    }
+    await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+    await execNetwork('Installing Ponytail plugin', OMP_BIN, ['plugin', 'install', PONYTAIL_GITHUB_SPEC], { cwd: pluginsDir }).catch((e) => {
+        console.log(`  [warn] omp plugin install failed: ${e.message}`);
+    });
+    await execNetwork('Refreshing Ponytail package', 'npm', ['install', PONYTAIL_NPM_SPEC, '--save', '--no-audit', '--no-fund'], { cwd: pluginsDir, timeout: 120000 }).catch((e) => {
+        throw new Error(`ponytail refresh failed: ${e.message}`);
+    });
+    await ensureExtensionInConfig(path.join(agentDir, 'config.yml'), path.join(pluginsDir, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js'), 'ponytail', { dryRun, verbose });
+}
+async function fixCli() {
+    console.log('  Doctor --fix: updating CLI + add-ons');
+    await runLatestUpdate();
+}
+async function runDoctorRepairs(targets) {
+    const all = targets.includes('all');
+    const want = (t) => all || targets.includes(t);
+    if (dryRun)
+        console.log('Preview — no changes will be written.\n');
+    const failed = [];
+    const attempt = async (label, work) => {
+        try {
+            await work();
+            if (!dryRun)
+                console.log(`  [ok] ${label}`);
+        }
+        catch (e) {
+            failed.push(label);
+            console.log(`  [fail] ${label}: ${(e.message || '').slice(0, 200)}`);
+        }
+    };
+    if (want('extensions'))
+        await attempt('extensions', () => fixExtensions(path.join(OMP_AGENT_DIR, 'extensions')));
+    if (want('registrations'))
+        await attempt('registrations', () => fixRegistrations(OMP_AGENT_DIR, OMP_PLUGINS_DIR));
+    if (want('rtk'))
+        await attempt('rtk', () => fixRtk(BUN_BIN_DIR));
+    if (want('ponytail'))
+        await attempt('ponytail', () => fixPonytail(OMP_PLUGINS_DIR, OMP_AGENT_DIR));
+    if (want('cli'))
+        await attempt('cli', fixCli);
+    return failed;
+}
+export { runDoctorRepairs };

package/cli/doctor.js

@@ -1,14 +1,14 @@
 // cli/doctor.ts — installation health checks.
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
-import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, execP, parseJsonObject, relTime, } from './common.js';
-import { runInteractivePhase } from './interactive.js';
+import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, args, dryRun, fix, yes, execP, parseJsonObject, relTime, } from './common.js';
+import { askInteractiveChoice, askInteractiveConfirm, runInteractivePhase } from './interactive.js';
 import { ledgerPath, readUsage, sessionsDir } from '../extensions/shared/usage-ledger.js';
 import { usageDbPath } from '../extensions/shared/usage-store.js';
 import { readRtkGain, rtkDbPath } from '../extensions/shared/rtk-gain.js';
 import { checkForUpdate } from './update.js';
 import { readTextIfExists } from '../extensions/lib/utils.js';
-async function runDoctor() {
+async function runDoctor(recheck = false) {
     console.log('\n=== Tersio Doctor ===');
     // Directories
     const agentDir = OMP_AGENT_DIR;
@@ -156,6 +156,104 @@ async function runDoctor() {
     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`);
+    if (!recheck && tally.missing + tally.warn > 0 && (fix || dryRun)) {
+        await runDoctorFix(tally);
+    }
+    else if (!recheck && tally.missing + tally.warn > 0) {
+        console.log('\n  Run `tersio doctor --fix` to repair the rows above.');
+    }
+    return tally;
+}
+function fixScope() {
+    const eq = args.find((a) => a.startsWith('--fix='));
+    if (eq !== undefined) {
+        const raw = eq.slice('--fix='.length).trim().toLowerCase();
+        if (raw === '')
+            return null;
+        return checkFixScope(raw);
+    }
+    const i = args.indexOf('--fix');
+    if (i === -1)
+        return null;
+    const next = args[i + 1];
+    if (next === undefined || next.startsWith('-'))
+        return null;
+    return checkFixScope(next.trim().toLowerCase());
+}
+function checkFixScope(raw) {
+    const valid = ['extensions', 'registrations', 'rtk', 'ponytail', 'cli'];
+    if (!valid.includes(raw)) {
+        console.error(`[fail] Invalid --fix scope: ${raw}. Valid: ${valid.join(', ')}`);
+        process.exit(1);
+    }
+    return raw;
+}
+async function runDoctorFix(tally) {
+    const problems = [];
+    if (tally.missing > 0)
+        problems.push(`${tally.missing} missing`);
+    if (tally.warn > 0)
+        problems.push(`${tally.warn} warn`);
+    if (dryRun) {
+        console.log(`\n  [dry-run] would repair ${problems.join(' + ')} (extensions, config.yml registrations, rtk wiring, ponytail refresh, CLI update)`);
+        return;
+    }
+    const scoped = fixScope();
+    let targets;
+    if (scoped) {
+        targets = [scoped];
+        if (!yes) {
+            const go = await askInteractiveConfirm(`Repair "${scoped}" now?`);
+            if (go.status !== 'confirmed' || !go.value) {
+                process.exitCode = 130;
+                return;
+            }
+        }
+    }
+    else if (yes) {
+        targets = ['all'];
+    }
+    else {
+        const picked = await askInteractiveChoice('Doctor — what should I repair?', [
+            { value: 'all', label: 'Fix everything', hint: `${tally.missing + tally.warn} rows` },
+            { value: 'extensions', label: 'Missing extension files', hint: 'copy sources from this CLI' },
+            { value: 'registrations', label: 'config.yml registrations', hint: 'combo, ponytail, rtk.ts entries' },
+            { value: 'rtk', label: 'RTK binary + wiring', hint: 'download checksum-verified binary, rtk init' },
+            { value: 'ponytail', label: 'Ponytail package', hint: 'omp plugin install + npm refresh' },
+            { value: 'cli', label: 'CLI update', hint: 'latest tersio + delegated refresh' },
+        ], 'all');
+        if (picked.status !== 'selected') {
+            process.exitCode = 130;
+            return;
+        }
+        if (picked.value === 'all')
+            targets = ['all'];
+        else {
+            const go = await askInteractiveConfirm(`Repair "${picked.value}" now?`);
+            if (go.status !== 'confirmed' || !go.value) {
+                process.exitCode = 130;
+                return;
+            }
+            targets = [picked.value];
+        }
+    }
+    const { runDoctorRepairs } = await import('./doctor-fix.js');
+    const failed = await runDoctorRepairs(targets);
+    if (failed.length > 0) {
+        console.log(`\n  Doctor --fix: ${failed.length} repair(s) failed (${failed.join(', ')}) — rerun or see [fail] lines above.`);
+        process.exitCode = 1;
+        return;
+    }
+    if (targets.includes('cli')) {
+        console.log('\n  Doctor --fix: CLI refresh delegated — rerun `tersio doctor` after it lands.');
+        return;
+    }
+    console.log('\n  Doctor --fix: repairs done — rechecking.');
+    const again = await runDoctor(true);
+    if (again.missing + again.warn === 0)
+        console.log('  Doctor --fix: all checks pass. Restart OMP.');
+    else
+        console.log(`  Doctor --fix: still ${again.missing} missing + ${again.warn} warn — rerun or repair manually.`);
 }
 function section(name) {
     console.log(`\n${name}`);

package/cli/install.js

@@ -551,10 +551,25 @@ async function runCommandMenu() {
             await runInstall({ reinstall: true });
             closeRL();
             break;
-        case 'doctor':
-            await runDoctor();
+        case 'doctor': {
+            const summary = await runDoctor();
+            if (!dryRun && summary.missing + summary.warn > 0) {
+                const fixIt = await askInteractiveConfirm('Doctor found problems — repair them now?');
+                if (fixIt.status === 'confirmed' && fixIt.value) {
+                    const { runDoctorRepairs } = await import('./doctor-fix.js');
+                    const failed = await runDoctorRepairs(['all']);
+                    if (failed.length === 0) {
+                        console.log('\n  Repairs done — rechecking.');
+                        await runDoctor();
+                    }
+                    else {
+                        console.log(`\n  ${failed.length} repair(s) failed (${failed.join(', ')}) — see [fail] lines above.`);
+                    }
+                }
+            }
             closeRL();
             break;
+        }
         case 'usage':
             await runUsage();
             closeRL();

package/cli/rtk-wiring.js

@@ -55,7 +55,7 @@ function rtkExtensionPath() {
 }
 // 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) {
+export 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, '/');

package/cli/update.js

@@ -166,6 +166,25 @@ async function runLatestUpdate() {
         return;
     }
     console.log(`Updating ${stale.join(', ')}`);
+    // Broken payloads (v2.20.0) crash on boot — smoke-check the target before touching anything installed.
+    const smokeArgs = IS_WINDOWS
+        ? ['/d', '/s', '/c', 'npm', 'exec', '--yes', '--prefer-online', `--package=${PACKAGE_NAME}${target}`, '--', PACKAGE_BIN, '--version']
+        : ['exec', '--yes', '--prefer-online', `--package=${PACKAGE_NAME}${target}`, '--', PACKAGE_BIN, '--version'];
+    try {
+        await execP(npmCommand, smokeArgs, {
+            timeout: 120000,
+            maxBuffer: 1024 * 1024,
+            windowsHide: true,
+            shell: false,
+        });
+    }
+    catch (e) {
+        console.error(`[fail] Update payload ${PACKAGE_NAME}${target} failed its smoke check — staying on ${PACKAGE_VERSION}.`);
+        console.error(`[fail] ${e.message.split('\n')[0]}`);
+        console.error(`[hint] Retry once released fixed; manual: npm install -g ${PACKAGE_NAME}@latest --no-audit --no-fund --prefer-online`);
+        process.exitCode = 1;
+        return;
+    }
     // The npx delegation below only refreshes the OMP-side files; the globally
     // installed CLI keeps its old version until npm -g runs. Refresh both.
     const globalArgs = IS_WINDOWS

package/package.json

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

package/tersio.js

@@ -19,7 +19,7 @@ Commands:
   install      Install the add-ons (user scope: all OMP sessions)
   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
+  doctor       Check the current installation (--fix repairs, --dry-run previews)
   usage        Ledger-backed usage + savings report
   gain         Open the gain dashboard (localhost only)
   reset        Clear tersio statistics (usage ledger)
@@ -29,6 +29,7 @@ Commands:
   help         Show this help
 
 Options:
+  --fix (doctor: repairs all; --fix=<scope> repairs one of extensions, registrations, rtk, ponytail, cli)
   --scope user (legacy; accepted and ignored — user scope is the only scope)
   --keep-ponytail (uninstall: keep the Ponytail plugin — removed by default)
   --remove-rtk (uninstall: also remove the RTK binary)