@krtclcdy/tersio 2.24.1 → 2.25.1

package/cli/doctor.js

@@ -1,34 +1,31 @@
 // cli/doctor.ts — installation health checks.
 import { existsSync, promises as fs } from 'node:fs';
 import path from 'node:path';
-import { OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_NAME, args, dryRun, fix, yes, execP, parseJsonObject, relTime, } from './common.js';
-import { detectHosts, ompPackageDir } from './hosts.js';
+import { OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_NAME, PACKAGE_VERSION, args, dryRun, fix, yes, execP, parseJsonObject, relTime, } from './common.js';
+import { detectHosts, hostExtensionsDir, ompPackageDir } from './hosts.js';
 import { askInteractiveChoice, askInteractiveConfirm, runInteractivePhase } from './interactive.js';
 import { usageDbPath } from '../extensions/shared/usage-store.js';
 import { pricesCachePath } from '../extensions/shared/pricing.js';
 import { readTextIfExists, resolveRtkBinary } from '../extensions/lib/utils.js';
+import { TREE_FILES } from './manifest.js';
 async function runDoctor(recheck = false) {
     console.log('\n=== Tersio Doctor ===');
-    // OMP loads the plugin from its plugins dir; pi loads the same package as a
-    // pi package, which its own settings.json declares and its npm dir holds.
+    // OMP loads the plugin from its plugins dir; pi loads the same package as a pi package, which its own settings.json declares and its npm dir holds.
     const pluginsDir = OMP_PLUGINS_DIR;
     const rtkBin = resolveRtkBinary();
     // 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 tersioPluginDir = path.join(pluginsDir, 'node_modules', '@krtclcdy', 'tersio');
     const cavemanIndex = path.join(tersioPluginDir, 'extensions', 'caveman-session', 'index.ts');
     const cavemanRule = path.join(tersioPluginDir, 'extensions', 'caveman-session', 'rule.md');
     const rtkIndex = path.join(tersioPluginDir, 'extensions', 'rtk-session', 'index.ts');
     const updaterIndex = path.join(tersioPluginDir, 'extensions', 'ai-addons-updater', 'index.ts');
-    // Independent probes start concurrently; sections report in fixed order as
-    // their data settles. Every probe resolves instead of rejecting.
+    // Independent probes start concurrently; sections report in fixed order as their data settles. Every probe resolves instead of rejecting.
     const hosts = detectHosts();
     const probes = {
         ompPkgText: readTextIfExists(path.join(ompPackageDir(), 'package.json')),
         configText: readTextIfExists(path.join(OMP_AGENT_DIR, 'config.yml')),
         ponytailPkgText: readTextIfExists(ponytailPkg),
-        ponytailExtText: readTextIfExists(ponytailExt),
         rtkBinText: rtkBin ? readTextIfExists(rtkBin) : Promise.resolve(null),
         cavemanIndexText: readTextIfExists(cavemanIndex),
         cavemanRuleText: readTextIfExists(cavemanRule),
@@ -43,7 +40,7 @@ async function runDoctor(recheck = false) {
         const err = e;
         return err.stdout?.trim() || err.stderr?.trim() || null;
     }) : Promise.resolve(null);
-    const [[ompPkgText, configText], [cavemanIndexText, rtkIndexText, updaterIndexText, ponytailPkgText, ponytailExtText], [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, ponytailMtime, pricesMtime]] = await runInteractivePhase('Checking installation', () => Promise.all([
+    const [[ompPkgText, configText], [cavemanIndexText, rtkIndexText, updaterIndexText, ponytailPkgText], [cavemanRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, ponytailMtime, pricesMtime]] = await runInteractivePhase('Checking installation', () => Promise.all([
         Promise.all([
             probes.ompPkgText,
             probes.configText,
@@ -53,7 +50,6 @@ async function runDoctor(recheck = false) {
             probes.rtkIndexText,
             probes.updaterIndexText,
             probes.ponytailPkgText,
-            probes.ponytailExtText,
         ]),
         Promise.all([
             probes.cavemanRuleText,
@@ -65,8 +61,7 @@ async function runDoctor(recheck = false) {
             probes.pricesMtime,
         ]),
     ]));
-    // Categorized output with a tally; success rows stay quiet (no path echoes)
-    // while failures print the expected path or fix so they stay actionable.
+    // Categorized output with a tally; success rows stay quiet (no path echoes) while failures print the expected path or fix so they stay actionable.
     const tally = { ok: 0, missing: 0, warn: 0 };
     function absDate(ms) {
         const d = new Date(ms);
@@ -88,37 +83,45 @@ async function runDoctor(recheck = false) {
         tally.warn++;
         console.log(`  ⚠️ ${label}: warn ${detail}`);
     }
-    // A host you do not use is not a fault, so it stays out of the tally and only
-    // carries the one line that installs it.
+    // A host you do not use is not a fault, so it stays out of the tally and only carries the one line that installs it.
     function unused(label, detail) {
         console.log(`  —  ${label}: not installed ${detail}`);
     }
     section('Hosts');
     for (const host of hosts) {
+        // pi can hold a working tree while reading as not installed; use the tree as ground truth.
+        const piTree = (host.id === 'pi' && !host.installed && existsSync(hostExtensionsDir('pi')))
+            ? hostExtensionsDir('pi')
+            : null;
+        if (piTree !== null) {
+            check(host.label, true, `extensions ${PACKAGE_NAME} ${PACKAGE_VERSION}`);
+            continue;
+        }
         if (!host.installed) {
-            // A pi declaration without the tree or the package is a broken install,
-            // so it stays a counted row rather than reading as "not installed".
+            // A pi declaration without the tree or the package is a broken install, so it stays a counted row rather than reading as "not installed".
             if (host.declared)
                 check(host.label, false, `declared (${host.declared}) but not installed`);
             else
                 unused(host.label, `· ${host.installCmd}`);
             continue;
         }
-        const where = host.via === 'tree' ? `extensions in ${host.dir}` : `package ${PACKAGE_NAME}`;
-        check(host.label, true, `${where}${host.version ? ` ${host.version}` : ''}`);
+        // One line per host, omp style: kind and version, no path echo.
+        const kind = host.via === 'tree' ? 'extensions' : 'package';
+        check(host.label, true, `${kind} ${PACKAGE_NAME}${host.version ? ` ${host.version}` : ''}`);
     }
     section('Extensions & plugins');
-    const ompEntry = hosts.find((host) => host.id === 'omp');
-    if (ompEntry?.via === 'package') {
+    if (hosts.find((host) => host.id === 'omp')?.via === 'package') {
         const explicitEntries = (configText ?? '').split('\n')
             .map((line) => line.trim().replace(/^-\s*/, '').replace(/^['"]|['"]$/g, ''))
             .filter((line) => line.startsWith('/') || line.startsWith('.'));
         const duplicateExtensions = [...new Set(explicitEntries.filter((entry, index) => explicitEntries.indexOf(entry) !== index))];
         check('Unique config registrations', duplicateExtensions.length === 0, duplicateExtensions.length ? duplicateExtensions.join(', ') : '');
-        check('Caveman extension', existsSync(path.join(tersioPluginDir, 'extensions', 'caveman-session', 'index.ts')), existsSync(path.join(tersioPluginDir, 'extensions', 'caveman-session', 'index.ts')) ? '' : path.join(tersioPluginDir, 'extensions', 'caveman-session', 'index.ts'));
-        check('RTK extension', existsSync(path.join(tersioPluginDir, 'extensions', 'rtk-session', 'index.ts')), existsSync(path.join(tersioPluginDir, 'extensions', 'rtk-session', 'index.ts')) ? '' : path.join(tersioPluginDir, 'extensions', 'rtk-session', 'index.ts'));
-        check('Updater extension', existsSync(path.join(tersioPluginDir, 'extensions', 'ai-addons-updater', 'index.ts')), existsSync(path.join(tersioPluginDir, 'extensions', 'ai-addons-updater', 'index.ts')) ? '' : path.join(tersioPluginDir, 'extensions', 'ai-addons-updater', 'index.ts'));
-        check('Ponytail extension', existsSync(path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js')), existsSync(path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js')) ? '' : path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js'));
+        // A half-written tree imports a module that is absent; OMP then drops the extension.
+        const extDir = path.join(tersioPluginDir, 'extensions');
+        const missing = TREE_FILES.filter((file) => !existsSync(path.join(extDir, ...file.split('/'))));
+        check('Extension tree', missing.length === 0, missing.length === 0
+            ? `${TREE_FILES.length} files ok`
+            : `${missing.length} of ${TREE_FILES.length} missing: ${missing.join(', ')}`);
     }
     section('Usage & records');
     console.log(`  Usage DB (tersio-owned · local hosted): ${usageDbPath()}`);
@@ -129,6 +132,11 @@ async function runDoctor(recheck = false) {
     check('Caveman rule', cavemanRuleText !== null, ruleAge);
     const rtkAge = rtkMtime ? `(updated ${relTime(Date.now() - rtkMtime.mtimeMs)} · ${absDate(rtkMtime.mtimeMs)})` : '';
     check('RTK binary', rtkBin !== null, rtkBinText === null ? 'not found in PATH' : [rtkVersion, rtkAge].filter(Boolean).join(' '));
+    // rtk_run needs a host exec API, which doctor cannot assume.
+    if (rtkBin === null)
+        unused('RTK exec', '· install Tersio to place rtk in ~/.bun/bin');
+    else if (!hosts.some((host) => host.installed && (host.id === 'omp' || host.id === 'opencode')))
+        warnLine('RTK exec', 'no installed host exposes an exec API — rtk_run is unavailable; call rtk from bash instead');
     if (rtkBinText !== null && !rtkVersion)
         warnLine('RTK version', 'unavailable — binary may not be executable');
     const ponytailAge = ponytailMtime ? `(updated ${relTime(Date.now() - ponytailMtime.mtimeMs)} · ${absDate(ponytailMtime.mtimeMs)})` : '';

package/cli/hosts.js

@@ -1,14 +1,15 @@
-// cli/hosts.ts — the agent hosts Tersio installs into, and what is on disk.
-// One detector, shared by the doctor and both menus, so they cannot disagree.
+// cli/hosts.ts — the agent hosts Tersio installs into, and what is on disk. One detector, shared by the doctor and both menus, so they cannot disagree.
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { HOME, OMP_PLUGINS_DIR, PACKAGE_NAME, PACKAGE_VERSION } from './common.js';
 import { TREE_FILES } from './manifest.js';
 import { piAgentDir } from '../extensions/lib/utils.js';
 export function hostExtensionsDir(id, agentDir = piAgentDir()) {
-    return id === 'omp'
-        ? path.join(HOME, '.omp', 'agent', 'extensions')
-        : path.join(agentDir, 'extensions');
+    if (id === 'omp')
+        return path.join(HOME, '.omp', 'agent', 'extensions');
+    if (id === 'opencode')
+        return path.join(HOME, '.config', 'opencode', 'plugins', 'tersio');
+    return path.join(agentDir, 'extensions');
 }
 export function missingTreeFiles(id, agentDir = piAgentDir()) {
     const dir = hostExtensionsDir(id, agentDir);
@@ -32,8 +33,7 @@ function packageVersion(dir) {
         return null;
     }
 }
-// The tersio package pi declared in its own settings.json, or null. pi
-// identifies a source by name, so an npm spec, git URL, or path all count.
+// The tersio package pi declared in its own settings.json, or null. pi identifies a source by name, so an npm spec, git URL, or path all count.
 export function piTersioSource(agentDir = piAgentDir()) {
     let settings;
     try {
@@ -61,24 +61,26 @@ export function piTersioSource(agentDir = piAgentDir()) {
 const HOSTS = [
     { id: 'omp', label: 'Oh My Pi', bin: 'omp', installCmd: `omp plugin install ${PACKAGE_NAME}`, removeCmd: `omp plugin remove ${PACKAGE_NAME}` },
     { id: 'pi', label: 'Pi', bin: 'pi', installCmd: `pi install npm:${PACKAGE_NAME}`, removeCmd: `pi remove npm:${PACKAGE_NAME}` },
+    { id: 'opencode', label: 'OpenCode', bin: 'opencode', installCmd: `tersio install --host opencode`, removeCmd: `tersio uninstall --host opencode` },
 ];
 function detect(agentDir = piAgentDir()) {
     return HOSTS.map((host) => {
-        const pkgDir = host.id === 'omp' ? ompPackageDir() : piPackageDir(agentDir);
+        const pkgDir = host.id === 'omp' ? ompPackageDir() : host.id === 'pi' ? piPackageDir(agentDir) : null;
         const tree = hostExtensionsDir(host.id, agentDir);
-        // A tree wins: it is what the installer writes, and it carries no
-        // package.json, so its version is ours.
+        // A tree wins: it is what the installer writes, and it carries no package.json, so its version is ours.
         const via = missingTreeFiles(host.id, agentDir).length === 0
             ? 'tree'
-            : existsSync(pkgDir) ? 'package' : null;
+            : pkgDir && existsSync(pkgDir) ? 'package' : null;
         return {
             ...host,
             installed: via !== null,
             via,
             declared: host.id === 'omp'
-                ? (existsSync(pkgDir) ? `plugin ${PACKAGE_NAME}` : null)
-                : piTersioSource(agentDir),
-            version: via === 'tree' ? PACKAGE_VERSION : via === 'package' ? packageVersion(pkgDir) : null,
+                ? (pkgDir && existsSync(pkgDir) ? `plugin ${PACKAGE_NAME}` : null)
+                : host.id === 'pi'
+                    ? piTersioSource(agentDir)
+                    : existsSync(tree) ? 'plugin tree' : null,
+            version: via === 'tree' ? PACKAGE_VERSION : via === 'package' && pkgDir ? packageVersion(pkgDir) : null,
             dir: via === 'tree' ? tree : via === 'package' ? pkgDir : null,
         };
     });
@@ -99,16 +101,15 @@ export function hostHint(host) {
         return host.via === 'tree' ? 'extension tree' : 'plugin package';
     return host.installCmd;
 }
-// `--host omp|pi` from raw argv; undefined when absent. Throws on an unknown
-// value so the caller can exit(1) with the message.
+// `--host omp|pi` from raw argv; undefined when absent. Throws on an unknown value so the caller can exit(1) with the message.
 export function parseHostArg(argv) {
     const i = argv.indexOf('--host');
     const raw = (i === -1 ? undefined : argv[i + 1]) ?? argv.find((a) => a.startsWith('--host='))?.slice('--host='.length);
     if (raw === undefined)
         return undefined;
     const value = raw.trim().toLowerCase();
-    if (value !== 'omp' && value !== 'pi')
-        throw new Error(`Invalid --host: ${raw}. Valid: omp, pi`);
+    if (value !== 'omp' && value !== 'pi' && value !== 'opencode')
+        throw new Error(`Invalid --host: ${raw}. Valid: omp, pi, opencode`);
     return value;
 }
 export { HOME, detect as detectHosts };

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, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, args, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, ponytailDefaultFlag, profileFlagsGiven, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
+import { BUN_BIN_DIR, COMBO_PRESET_MODES, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, args, allowUnverified, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, ponytailDefaultFlag, profileFlagsGiven, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
 import { askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, withInteractiveTask, sayTagged } from './interactive.js';
 import { printWelcome } from './banner.js';
 import { checkForUpdate, runLatestUpdate } from './update.js';
@@ -12,12 +12,12 @@ import { runDoctor } from './doctor.js';
 import { runReset } from './reset.js';
 import { runUsage } from './usage.js';
 import { runDashboard } from './dashboard.js';
-import { wireRtkOmp } from './rtk-wiring.js';
+import { wireRtkOmp, wireRtkOpencode, wireRtkPi } from './rtk-wiring.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, findHoistedPackage, httpsGet, httpsDownload, parseChecksum, piAgentDir, readTextIfExists, resolveRtkBinary, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
-import { storedProfile, writePluginSettings } from './profile.js';
+import { formatCliStatus, storedProfile, storedProfileSync, writePluginSettings } from './profile.js';
 import { runSettings } from './settings.js';
 import { tersioSettingsFile } from '../extensions/shared/plugin-settings.js';
-import { filesUnder, sourcePath } from './manifest.js';
+import { OPENCODE_SERVER_SHIM, filesUnder, sourcePath } from './manifest.js';
 import { detectHosts, hostHint, hostLabel, parseHostArg, piTersioSource } from './hosts.js';
 async function stepPonytail(pluginsDir, options) {
     if (!options.quiet)
@@ -163,19 +163,23 @@ async function downloadRtkChecksums(release) {
         return null;
     }
 }
-async function verifyRtkArchive(archivePath, assetName, checksumsText, options = {}) {
-    if (!checksumsText) {
-        if (!options.quiet)
-            console.log('  [warn] No checksums.txt available — skipping verification');
-        return true;
-    }
+// Fails closed: a missing checksum is worse than a failed install, since an unverifiable RTK binary runs with the user's privileges. `--allow-unverified` opts out.
+async function verifyRtkArchive(archivePath, assetName, checksumsText) {
+    const unverified = (reason) => {
+        if (allowUnverified) {
+            sayTagged(`  [warn] ${reason} — installing anyway (--allow-unverified)`);
+            return true;
+        }
+        sayTagged(`  [fail] ${reason}`);
+        sayTagged('  [hint] RTK not installed. Retry with --allow-unverified to accept an unverified binary.');
+        return false;
+    };
+    if (!checksumsText)
+        return unverified(`No checksums.txt published for ${assetName}`);
     const expected = parseChecksum(checksumsText, assetName);
+    if (!expected)
+        return unverified(`checksums.txt has no entry for ${assetName}`);
     const actual = await sha256File(archivePath);
-    if (!expected) {
-        if (!options.quiet)
-            sayTagged(`  [warn] checksums.txt missing entry for ${assetName} — skipping verification`);
-        return true;
-    }
     if (actual === expected) {
         debug(`Checksum verified for ${assetName}`);
         return true;
@@ -225,34 +229,35 @@ async function extractRtkArchive(archivePath, extractDir) {
     sayTagged(`  [fail] Unknown archive format: ${archivePath}`);
     return false;
 }
-// The binary is machine-wide and only OMP needs the wiring, so an install that
-// finds one present only rebinds. `tersio update` still refreshes it.
+// The binary is machine-wide; hosts without a hook only rebind. `tersio update` still refreshes it.
 async function stepRtk(binDir, options, target = 'omp') {
     const binDest = path.join(binDir, RTK_BINARY_NAME);
     const found = resolveRtkBinary();
+    const hostName = target === 'omp' ? 'OMP' : target === 'opencode' ? 'OpenCode' : 'pi';
     const bind = async (binary) => {
-        if (target !== 'omp')
-            return;
         if (!(await fileExists(binary))) {
-            console.log('  [skip] no rtk binary to wire — install rtk, then run: rtk init -g --agent omp');
+            console.log(`  [skip] no rtk binary to wire — install rtk, then run: rtk init -g ${target === 'opencode' ? '--opencode' : `--agent ${target}`}`);
             return;
         }
-        await wireRtkOmp(binary, options);
+        if (target === 'opencode')
+            await wireRtkOpencode(binary, options);
+        else if (target === 'pi')
+            await wireRtkPi(binary, options);
+        else
+            await wireRtkOmp(binary, options);
     };
     if (found && !applyUpdate) {
-        // The path only under --verbose: a plain run, and a dry run, stay free of
-        // real user paths.
+        // The path only under --verbose: a plain run, and a dry run, stay free of real user paths.
         if (!options.quiet) {
             const where = verbose ? ` (${found})` : '';
-            console.log(`  RTK — already installed${where}${target === 'omp' ? ', binding into OMP' : ', nothing to bind on pi'}`);
+            console.log(`  RTK — already installed${where}, binding into ${hostName}`);
         }
         await bind(found);
         return;
     }
     if (!options.quiet)
-        console.log(`  RTK — download binary and ${target === 'omp' ? 'wire into OMP' : 'put it on PATH'}`);
-    // A failed download must not skip wiring: a pre-existing binary serves the
-    // OMP hook just as well. Dry runs stay offline.
+        console.log(`  RTK — download binary and wire into ${hostName}`);
+    // A failed download must not skip wiring: a pre-existing binary serves the host hook just as well. Dry runs stay offline.
     if (options.dryRun) {
         if (verbose && !options.quiet)
             sayTagged(`  [dry-run] would download rtk binary and install to ${binDest}`);
@@ -263,8 +268,7 @@ async function stepRtk(binDir, options, target = 'omp') {
         const triple = resolveRtkTriple();
         if (!triple)
             return;
-        // One task with streamed sub-steps: release lookup, download, checksum,
-        // extract, install. Non-TTY keeps the plain lines each step already prints.
+        // One task with streamed sub-steps: release lookup, download, checksum, extract, install. Non-TTY keeps the plain lines each step already prints.
         await withInteractiveTask('Installing RTK', async (update) => {
             const release = await fetchJson(RTK_RELEASE_API);
             const asset = findRtkAsset(release, triple);
@@ -281,7 +285,7 @@ async function stepRtk(binDir, options, target = 'omp') {
                     httpsDownload(asset.browser_download_url, archivePath),
                 ]);
                 update('Verifying checksum');
-                if (!await verifyRtkArchive(archivePath, asset.name, checksumsText, options)) {
+                if (!await verifyRtkArchive(archivePath, asset.name, checksumsText)) {
                     sayTagged('  [hint] RTK install skipped for this run');
                     return;
                 }
@@ -323,8 +327,7 @@ async function stepRtk(binDir, options, target = 'omp') {
     // Wire rtk's tool_call extension: the binary alone never meters a session.
     await bind(binDest);
 }
-// Copy sources into the target extension dir. First entry is required; the
-// rest are optional companions.
+// Copy sources into the target extension dir. First entry is required; the rest are optional companions.
 async function copySources(extDir, files, skipLabel, options) {
     const src = await readTextIfExists(files[0][0]);
     if (!src) {
@@ -353,8 +356,7 @@ async function stepRtkSession(extDir, options) {
         console.log('  RTK session — install session mode');
     await copySources(extDir, filesUnder('rtk-session'), 'rtk-session/index.ts', options);
 }
-// One fetch serves the install; dry runs stay offline and preview the bundled
-// rule's destination.
+// One fetch serves the install; dry runs stay offline and preview the bundled rule's destination.
 async function fetchCavemanRule(options) {
     const bundled = await readTextIfExists(sourcePath('caveman-session/rule.md'));
     if (options.dryRun)
@@ -403,11 +405,72 @@ async function stepCombo(extDir, options) {
         console.log('  Combo — install preset switch');
     await copySources(extDir, filesUnder('combo-toggle'), 'combo-toggle/index.ts', options);
 }
+// The tree ships no node_modules, so the full ruleset rides along as files.
+const PONYTAIL_BUNDLE_FILES = [
+    'hooks/ponytail-instructions.js',
+    'hooks/ponytail-config.js',
+    'skills/ponytail/SKILL.md',
+];
+async function stepPonytailBundle(treeDir, options) {
+    const root = findHoistedPackage('@dietrichgebert/ponytail', path.dirname(fileURLToPath(import.meta.url)));
+    if (!root) {
+        if (!options.quiet)
+            console.log('  [skip] Ponytail package not found next to the CLI — OpenCode keeps the built-in text');
+        return;
+    }
+    if (!options.quiet)
+        console.log('  Ponytail — bundle the full ruleset for OpenCode');
+    for (const rel of PONYTAIL_BUNDLE_FILES) {
+        const src = path.join(root, ...rel.split('/'));
+        let text;
+        try {
+            text = await fs.readFile(src, 'utf8');
+        }
+        catch {
+            sayTagged(`  [fail] Ponytail bundle file missing: ${rel}`);
+            return;
+        }
+        await writeIfChanged(path.join(treeDir, 'ponytail-bundle', ...rel.split('/')), text, options);
+    }
+}
+// OpenCode loads imported .ts plugins from the config plugins dir, so a plain tree copy + one config entry is enough.
+async function stepOpencode(options) {
+    const dir = path.join(HOME, '.config', 'opencode', 'plugins', 'tersio');
+    if (!options.quiet)
+        console.log(`  OpenCode — write the plugin tree (${dir})`);
+    await stepSharedSessionState(dir, options);
+    await copySources(dir, filesUnder('rtk-session'), 'rtk-session/index.ts', options);
+    await copySources(dir, filesUnder('caveman-session'), 'caveman-session/index.ts', options);
+    await stepCombo(dir, options);
+    await copySources(dir, filesUnder('tersio-commands'), 'tersio-commands/index.ts', options);
+    await stepUpdater(dir, options);
+    await copySources(dir, filesUnder('opencode'), 'opencode/server.ts', options);
+    await stepPonytailBundle(dir, options);
+    // The loader resolves <pluginDir>/server.ts, so mirror the entry at the tree root.
+    await writeIfChanged(path.join(dir, 'server.ts'), OPENCODE_SERVER_SHIM, options);
+    if (!options.dryRun)
+        await fs.rm(path.join(dir, 'opencode', 'index.ts'), { force: true }).catch(() => { });
+    const configPath = path.join(HOME, '.config', 'opencode', 'opencode.json');
+    let config = {};
+    try {
+        config = JSON.parse((await readTextIfExists(configPath)) ?? '{}');
+    }
+    catch {
+        return;
+    }
+    const plugins = Array.isArray(config.plugins) ? [...config.plugins] : [];
+    const withoutTersio = plugins.filter((p) => typeof p !== 'string' || !p.includes('/opencode/plugins/tersio'));
+    if (!withoutTersio.includes(dir))
+        withoutTersio.push(dir);
+    config.plugins = withoutTersio;
+    if (!options.dryRun)
+        await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await writeIfChanged(configPath, `${JSON.stringify(config, null, 2)}\n`, options);
+}
 async function resolveProfile(opts = {}) {
     // Seed from the stored defaults so flag-less runs keep them.
     const profile = await storedProfile();
-    // One numbered prompt for all three modes, for a real terminal user with no
-    // default flags. Never for --apply-update, and never for a script.
+    // One numbered prompt for all three modes, for a real terminal user with no default flags. Never for --apply-update, and never for a script.
     if (tty() && !profileFlagsGiven && !applyUpdate) {
         const choice = await askInteractiveChoice('Session-start defaults — Combo preset', [
             { value: 'off', label: 'off' },
@@ -458,7 +521,7 @@ async function runCommandMenu() {
         console.log(`\n  [update] staying on ${PACKAGE_VERSION} — run ` + '`tersio update`' + ` anytime`);
     }
     updatePromptDone = true;
-    const choice = await askInteractiveChoice('Tersio — what next?', [
+    const choice = await askInteractiveChoice(`Tersio — what next?\n${formatCliStatus(storedProfileSync())}`, [
         { value: 'install', label: 'Install add-ons', hint: 'user scope + combo defaults' },
         { value: 'update', label: 'Update', hint: 'CLI version check, then refresh add-ons (RTK, Caveman rule, Ponytail)' },
         { value: 'doctor', label: 'Doctor', hint: 'verify the installation' },
@@ -477,8 +540,7 @@ async function runCommandMenu() {
             await runInstall();
             break;
         case 'update': {
-            // One bound flow: the version check already ran above, so report it
-            // and offer the refresh in the same breath — no second "update" quiz.
+            // 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
@@ -538,14 +600,11 @@ async function runCommandMenu() {
             break;
     }
 }
-// Which host this run targets. --host pins it; a TTY user picks; scripts,
-// pipes, --yes, and --dry-run keep the pre-multi-host default of Oh My Pi.
+// Which host this run targets. --host pins it; a TTY user picks; scripts, pipes, --yes, and --dry-run keep the pre-multi-host default of Oh My Pi.
 let targetHost = 'omp';
-// Hosts the menu advertises but cannot install yet. Listed disabled so the
-// roadmap is visible without offering a target that does nothing.
+// Hosts the menu advertises but cannot install yet. Listed disabled so the roadmap is visible without offering a target that does nothing.
 const SOON_HOSTS = [
     { value: 'claude', label: 'Claude Code', hint: 'Coming soon' },
-    { value: 'opencode', label: 'OpenCode', hint: 'Coming soon' },
     { value: 'codex', label: 'Codex', hint: 'Coming soon' },
 ];
 async function chooseHost(title, only) {
@@ -568,8 +627,7 @@ async function chooseHost(title, only) {
 function hostEntry(id) {
     return detectHosts().find((host) => host.id === id);
 }
-// pi auto-discovers `<agent-dir>/extensions/**/index.ts`, so this route writes
-// the same tree as OMP's and registers nothing.
+// pi auto-discovers `<agent-dir>/extensions/**/index.ts`, so this route writes the same tree as OMP's and registers nothing.
 async function stepPiLayer(options) {
     const agentDir = piAgentDir();
     const extDir = path.join(agentDir, 'extensions');
@@ -624,8 +682,7 @@ async function stepPonytailForPi(agentDir, options) {
     }
 }
 async function runInstall() {
-    // Without this guard a picked command re-enters here with command === null
-    // and loops straight back into the picker.
+    // Without this guard a picked command re-enters here with command === null and loops straight back into the picker.
     if (command === null && tty() && !yes && !updatePromptDone) {
         await runCommandMenu();
         return;
@@ -657,8 +714,7 @@ async function runInstall() {
     if (tty() && !applyUpdate && command !== 'uninstall') {
         const newer = await checkForUpdate();
         if (typeof newer === 'string') {
-            // Update pending: offer it here instead of burying it above the install
-            // prompts. Yes runs the full update and stops.
+            // Update pending: offer it here instead of burying it above the install prompts. Yes runs the full update and stops.
             if (command === null && !dryRun && !yes && !updatePromptDone) {
                 const answer = await askInteractiveConfirm(`tersio ${newer} is available (installed ${PACKAGE_VERSION}). Install it now?`);
                 if (answer.status === 'confirmed' && answer.value) {
@@ -686,7 +742,11 @@ async function runInstall() {
     // Point of no return: disk writes start here; pipes stay unattended.
     if (!yes && !dryRun && !applyUpdate && tty()) {
         const target = hostEntry(targetHost);
-        const where = targetHost === 'pi' ? path.join(piAgentDir(), 'extensions') : path.join(OMP_AGENT_DIR, 'extensions');
+        const where = targetHost === 'pi'
+            ? path.join(piAgentDir(), 'extensions')
+            : targetHost === 'opencode'
+                ? path.join(HOME, '.config', 'opencode', 'plugins', 'tersio')
+                : path.join(OMP_AGENT_DIR, 'extensions');
         console.log(`\nWill install into ${target.label}:`);
         console.log(`  ${where}`);
         console.log('  caveman · rtk · ponytail session modes');
@@ -717,6 +777,17 @@ async function runInstall() {
             sayTagged(`  [fail] ${label}: ${shortError(e)}`);
         }
     };
+    if (targetHost === 'opencode') {
+        await capture('opencode tree', () => stepOpencode(installOptions));
+        await capture('rtk', () => stepRtk(BUN_BIN_DIR, installOptions, 'opencode'));
+        await capture('settings', () => writePluginSettings(profile, installOptions));
+        if (failures.length > 0)
+            console.log(`\nDone with ${failures.length} failure(s) — see [fail] lines above.`);
+        else
+            console.log('\nDone — restart OpenCode, then /combo balanced.');
+        closeRL();
+        return;
+    }
     if (targetHost === 'pi') {
         await capture('pi tree', () => stepPiLayer(installOptions));
         await capture('rtk', () => stepRtk(BUN_BIN_DIR, installOptions, 'pi'));
@@ -750,4 +821,4 @@ async function runInstall() {
     }
     closeRL();
 }
-export { runInstall };
+export { runInstall, verifyRtkArchive };

package/cli/interactive.js

@@ -26,13 +26,11 @@ 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.
+// 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.
+    // 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);
@@ -49,26 +47,33 @@ 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' };
+    try {
+        const choice = await clackSelect({ message, options, initialValue });
+        if (typeof choice !== 'string') {
+            clackCancel('Aborted.');
+            return { status: 'cancelled' };
+        }
+        return { status: 'selected', value: choice };
+    }
+    finally {
     }
-    return { status: 'selected', value: choice };
 }
 async function askInteractiveConfirm(message, initialValue = true) {
     if (!tty())
         return { status: 'unavailable' };
     closeRL();
-    const answer = await clackConfirm({ message, initialValue });
-    if (typeof answer !== 'boolean') {
-        clackCancel('Aborted.');
-        return { status: 'cancelled' };
+    try {
+        const answer = await clackConfirm({ message, initialValue });
+        if (typeof answer !== 'boolean') {
+            clackCancel('Aborted.');
+            return { status: 'cancelled' };
+        }
+        return { status: 'confirmed', value: answer };
+    }
+    finally {
     }
-    return { status: 'confirmed', value: answer };
 }
-// Confirm a destructive run: a Clack dialog at a terminal, a plain prompt in a
-// pipe or script. False means the user declined or aborted.
+// Confirm a destructive run: a Clack dialog at a terminal, a plain prompt in a pipe or script. False means the user declined or aborted.
 async function confirmDestructive(message) {
     if (tty()) {
         closeRL();
@@ -93,14 +98,17 @@ async function confirmDestructive(message) {
     }
     return true;
 }
-// Run collecting work under one TTY-only Clack task. Callers print after the
-// task completes, keeping normal output out of the spinner animation.
+// 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(); } }]);
+    try {
+        await clackTasks([{ title, task: async () => { result = await collect(); } }]);
+    }
+    finally {
+    }
     return result;
 }
 const TAG_KIND = {
@@ -131,6 +139,8 @@ async function withInteractiveTask(title, work) {
         spin.error(shortSpinnerError(e));
         throw e;
     }
+    finally {
+    }
     return result;
 }
 function shortSpinnerError(e) {