@krtclcdy/tersio 2.24.0 → 2.24.1

package/cli/install.js

@@ -4,7 +4,7 @@ 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 { askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
+import { askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, withInteractiveTask, sayTagged } from './interactive.js';
 import { printWelcome } from './banner.js';
 import { checkForUpdate, runLatestUpdate } from './update.js';
 import { runUninstall } from './uninstall.js';
@@ -15,6 +15,8 @@ import { runDashboard } from './dashboard.js';
 import { wireRtkOmp } 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 { runSettings } from './settings.js';
+import { tersioSettingsFile } from '../extensions/shared/plugin-settings.js';
 import { filesUnder, sourcePath } from './manifest.js';
 import { detectHosts, hostHint, hostLabel, parseHostArg, piTersioSource } from './hosts.js';
 async function stepPonytail(pluginsDir, options) {
@@ -31,9 +33,9 @@ async function stepPonytail(pluginsDir, options) {
     }
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would write ${pkgPath}`);
+            sayTagged(`  [dry-run] would write ${pkgPath}`);
         if (migrated && verbose && !options.quiet)
-            console.log(`  [dry-run] would drop the separate @dietrichgebert/ponytail dependency (bundled with tersio)`);
+            sayTagged(`  [dry-run] would drop the separate @dietrichgebert/ponytail dependency (bundled with tersio)`);
     }
     else if (migrated) {
         await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
@@ -63,7 +65,7 @@ async function stepPonytail(pluginsDir, options) {
                 await execNetwork('Installing bundled Ponytail', 'bun', ['install'], { cwd: pluginsDir, timeout: 180000 });
             }
             catch (e) {
-                console.log(`  [fail] Could not install bundled ponytail: ${e.message}`);
+                sayTagged(`  [fail] Could not install bundled ponytail: ${e.message}`);
                 console.log('  [hint] Manual: cd ~/.omp/plugins && npm install --no-audit --no-fund');
             }
         }
@@ -91,14 +93,14 @@ async function stepSelfPlugin(pluginsDir, options) {
         if (legacy in pkg.dependencies) {
             delete pkg.dependencies[legacy];
             if (!options.dryRun && !options.quiet)
-                console.log(`  [migrate] dropped legacy ${legacy} dependency`);
+                sayTagged(`  [migrate] dropped legacy ${legacy} dependency`);
         }
     }
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would add ${PACKAGE_NAME}@^${PACKAGE_VERSION} to ${pkgPath}`);
+            sayTagged(`  [dry-run] would add ${PACKAGE_NAME}@^${PACKAGE_VERSION} to ${pkgPath}`);
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would run: npm install --no-audit --no-fund (in ${pluginsDir})`);
+            sayTagged(`  [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.
@@ -119,14 +121,14 @@ async function stepSelfPlugin(pluginsDir, options) {
             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`);
+            sayTagged(`  [fail] Could not install ${PACKAGE_NAME} into plugins dir: ${e.message}`);
+            sayTagged(`  [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`);
+        sayTagged(`  [warn] ${PACKAGE_NAME} not found in plugins/node_modules after install`);
         return false;
     }
     debug('tersio listed in OMP plugins');
@@ -136,7 +138,7 @@ function resolveRtkTriple() {
     const triple = rtkPlatformSpec()?.triple;
     if (triple)
         return triple;
-    console.log(`  [fail] Unsupported platform: ${process.platform}/${process.arch}`);
+    sayTagged(`  [fail] Unsupported platform: ${process.platform}/${process.arch}`);
     console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
     return null;
 }
@@ -145,8 +147,8 @@ function findRtkAsset(release, triple) {
     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(', ')}`);
+    sayTagged(`  [fail] No rtk-${triple}.<zip|tar.gz> in release ${release.tag_name}`);
+    sayTagged(`  [hint] Available: ${assets.map((a) => a.name).filter((n) => n.startsWith('rtk-')).join(', ')}`);
     return null;
 }
 async function downloadRtkChecksums(release) {
@@ -171,16 +173,16 @@ async function verifyRtkArchive(archivePath, assetName, checksumsText, options =
     const actual = await sha256File(archivePath);
     if (!expected) {
         if (!options.quiet)
-            console.log(`  [warn] checksums.txt missing entry for ${assetName} — skipping verification`);
+            sayTagged(`  [warn] checksums.txt missing entry for ${assetName} — skipping verification`);
         return true;
     }
     if (actual === expected) {
         debug(`Checksum verified for ${assetName}`);
         return true;
     }
-    console.log(`  [fail] Checksum mismatch for ${assetName}`);
-    console.log(`  [fail] Expected: ${expected}`);
-    console.log(`  [fail] Got:      ${actual}`);
+    sayTagged(`  [fail] Checksum mismatch for ${assetName}`);
+    sayTagged(`  [fail] Expected: ${expected}`);
+    sayTagged(`  [fail] Got:      ${actual}`);
     // Caller finally removes the temp dir.
     return false;
 }
@@ -214,13 +216,13 @@ async function extractRtkArchive(archivePath, extractDir) {
         }
         catch (e) {
             debug(`tar xzf failed: ${shortError(e)}`);
-            console.log(`  [fail] tar could not extract ${path.basename(archivePath)}`);
+            sayTagged(`  [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}`);
+    sayTagged(`  [fail] Unknown archive format: ${archivePath}`);
     return false;
 }
 // The binary is machine-wide and only OMP needs the wiring, so an install that
@@ -253,59 +255,69 @@ async function stepRtk(binDir, options, target = 'omp') {
     // OMP hook just as well. Dry runs stay offline.
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would download rtk binary and install to ${binDest}`);
+            sayTagged(`  [dry-run] would download rtk binary and install to ${binDest}`);
         await bind(found ?? binDest);
         return;
     }
     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 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, options))
-                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`);
+        // 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);
+            if (!asset) {
+                sayTagged(`  [fail] No rtk-${triple}.<zip|tar.gz> in release ${release.tag_name}`);
                 return;
             }
-            await fs.mkdir(path.dirname(binDest), { recursive: true });
-            await fs.copyFile(binDest, `${binDest}.bak`).catch(() => { });
-            await fs.copyFile(found, binDest);
-            if (!IS_WINDOWS) {
-                await fs.chmod(binDest, 0o755);
-                debug(`chmod 755 ${binDest}`);
-            }
+            const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'omp-rtk-'));
             try {
-                await execP(binDest, ['--version'], { timeout: 30000, shell: false });
+                const archivePath = path.join(tmpDir, asset.name);
+                update(`Downloading ${asset.name}`);
+                const [checksumsText] = await Promise.all([
+                    downloadRtkChecksums(release),
+                    httpsDownload(asset.browser_download_url, archivePath),
+                ]);
+                update('Verifying checksum');
+                if (!await verifyRtkArchive(archivePath, asset.name, checksumsText, options)) {
+                    sayTagged('  [hint] RTK install skipped for this run');
+                    return;
+                }
+                update('Extracting');
+                const extractDir = path.join(tmpDir, 'extracted');
+                if (!await extractRtkArchive(archivePath, extractDir)) {
+                    sayTagged(`  [fail] Could not extract ${asset.name}`);
+                    return;
+                }
+                update('Installing binary');
+                const found = await findFile(extractDir, RTK_BINARY_NAME);
+                if (!found) {
+                    sayTagged(`  [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);
+                if (!IS_WINDOWS) {
+                    await fs.chmod(binDest, 0o755);
+                    debug(`chmod 755 ${binDest}`);
+                }
+                try {
+                    await execP(binDest, ['--version'], { timeout: 30000, shell: false });
+                }
+                catch {
+                    sayTagged(`  [hint] Verify manually: ${binDest} --version`);
+                }
             }
-            catch {
-                console.log(`  [hint] Verify manually: ${binDest} --version`);
+            finally {
+                await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
             }
-        }
-        finally {
-            await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
-        }
+        });
     }
     catch (e) {
-        console.log(`  [fail] RTK: ${e.message}`);
+        sayTagged(`  [fail] RTK: ${e.message}`);
         console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
     }
     // Wire rtk's tool_call extension: the binary alone never meters a session.
@@ -317,7 +329,7 @@ async function copySources(extDir, files, skipLabel, options) {
     const src = await readTextIfExists(files[0][0]);
     if (!src) {
         if (!options.quiet && options.dryRun)
-            console.log(`  [skip] ${skipLabel} not found in repo`);
+            sayTagged(`  [skip] ${skipLabel} not found in repo`);
         return false;
     }
     await writeIfChanged(path.join(extDir, files[0][1]), src, options);
@@ -355,7 +367,7 @@ async function fetchCavemanRule(options) {
             debug(`Using bundled Caveman rule: ${e.message}`);
             return bundled;
         }
-        console.log(`  [warn] Could not fetch caveman rule: ${e.message}`);
+        sayTagged(`  [warn] Could not fetch caveman rule: ${e.message}`);
         return null;
     }
 }
@@ -371,7 +383,7 @@ async function stepCaveman(extDir, rule, options) {
     }
     else if (rule === null) {
         console.log('  [skip] Caveman rule.md unavailable');
-        console.log(`  [hint] Manual: ${CAVEMAN_REMOTE_RULE}`);
+        sayTagged(`  [hint] Manual: ${CAVEMAN_REMOTE_RULE}`);
     }
     else {
         await writeIfChanged(ruleDest, rule, options);
@@ -450,6 +462,7 @@ async function runCommandMenu() {
         { 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' },
+        { value: 'settings', label: 'Settings', hint: 'default combo mode, currency, diagnosis schedule' },
         { value: 'usage', label: 'Usage', hint: 'token usage and savings report' },
         { value: 'dashboard', label: 'Dashboard', hint: 'open the report in your browser' },
         { value: 'reset', label: 'Reset statistics', hint: 'clear statistics; transcripts and RTK history stay' },
@@ -503,6 +516,10 @@ async function runCommandMenu() {
             closeRL();
             break;
         }
+        case 'settings':
+            await runSettings();
+            closeRL();
+            break;
         case 'usage':
             await runUsage();
             closeRL();
@@ -524,13 +541,24 @@ async function runCommandMenu() {
 // 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.
+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) {
     const hosts = detectHosts().filter((host) => !only || only.includes(host.id));
-    const choice = await askInteractiveChoice(title, hosts.map((host) => ({
+    const options = hosts.map((host) => ({
         value: host.id,
         label: hostLabel(host),
         hint: hostHint(host),
-    })), targetHost);
+    }));
+    // A scoped menu (uninstall --host) lists only real hosts.
+    if (!only)
+        options.push(...SOON_HOSTS.map((h) => ({ ...h, disabled: true })));
+    const choice = await askInteractiveChoice(title, options, targetHost);
     if (choice.status !== 'selected') {
         closeRL();
         process.exit(130);
@@ -542,12 +570,12 @@ function hostEntry(id) {
 }
 // pi auto-discovers `<agent-dir>/extensions/**/index.ts`, so this route writes
 // the same tree as OMP's and registers nothing.
-async function stepPiLayer(profile, options) {
+async function stepPiLayer(options) {
     const agentDir = piAgentDir();
     const extDir = path.join(agentDir, 'extensions');
     const declared = piTersioSource(agentDir);
     if (declared)
-        console.log(`  [note] pi also has a tersio package (${declared}) — remove one, or both copies load: pi remove npm:${PACKAGE_NAME}`);
+        sayTagged(`  [note] pi also has a tersio package (${declared}) — remove one, or both copies load: pi remove npm:${PACKAGE_NAME}`);
     if (!options.quiet)
         console.log(`  Pi — write the extension tree (${extDir})`);
     const cavemanRule = await fetchCavemanRule(options);
@@ -570,7 +598,7 @@ async function stepPonytailForPi(agentDir, options) {
             return;
         }
         catch (e) {
-            console.log(`  [fail] pi install ponytail: ${shortError(e)}`);
+            sayTagged(`  [fail] pi install ponytail: ${shortError(e)}`);
         }
     }
     const skills = findHoistedPackage('@dietrichgebert/ponytail', path.dirname(fileURLToPath(import.meta.url)), 'skills');
@@ -582,7 +610,7 @@ async function stepPonytailForPi(agentDir, options) {
     const dest = path.join(agentDir, 'skills');
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would copy Ponytail skills to ${dest}`);
+            sayTagged(`  [dry-run] would copy Ponytail skills to ${dest}`);
         return;
     }
     for (const entry of await fs.readdir(skills, { withFileTypes: true })) {
@@ -592,7 +620,7 @@ async function stepPonytailForPi(agentDir, options) {
         await fs.rm(to, { recursive: true, force: true });
         await fs.cp(path.join(skills, entry.name), to, { recursive: true });
         if (!options.quiet)
-            console.log(`  [write] skill ${entry.name} → ${to}`);
+            sayTagged(`  [write] skill ${entry.name} → ${to}`);
     }
 }
 async function runInstall() {
@@ -616,7 +644,6 @@ async function runInstall() {
     else if (tty() && !yes && !dryRun && !applyUpdate && command !== 'uninstall') {
         targetHost = await chooseHost('Install Tersio into which agent?');
     }
-    const host = hostEntry(targetHost);
     // apply-update stays silent: the parent printed the plan.
     const quiet = applyUpdate;
     if (!quiet)
@@ -656,6 +683,21 @@ async function runInstall() {
     const userExtDir = path.join(userDir, 'extensions');
     // apply-update refreshes every add-on like a reinstall.
     const installOptions = { dryRun, verbose, yes, reinstall: applyUpdate, quiet };
+    // 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');
+        console.log(`\nWill install into ${target.label}:`);
+        console.log(`  ${where}`);
+        console.log('  caveman · rtk · ponytail session modes');
+        console.log(`  session defaults → ${tersioSettingsFile()}`);
+        const go = await askInteractiveConfirm(`Install Tersio into ${target.label}?`);
+        if (go.status !== 'confirmed' || !go.value) {
+            closeRL();
+            console.log('\nAborted. Nothing was changed.');
+            return;
+        }
+    }
     try {
         const v = (await execP(OMP_BIN, ['--version'])).stdout.trim();
         if (verbose && !quiet)
@@ -672,11 +714,11 @@ async function runInstall() {
         }
         catch (e) {
             failures.push(label);
-            console.log(`  [fail] ${label}: ${shortError(e)}`);
+            sayTagged(`  [fail] ${label}: ${shortError(e)}`);
         }
     };
     if (targetHost === 'pi') {
-        await capture('pi tree', () => stepPiLayer(profile, installOptions));
+        await capture('pi tree', () => stepPiLayer(installOptions));
         await capture('rtk', () => stepRtk(BUN_BIN_DIR, installOptions, 'pi'));
         await capture('settings', () => writePluginSettings(profile, installOptions));
         if (failures.length > 0)

package/cli/interactive.js

@@ -1,6 +1,6 @@
 // cli/interactive.ts — TTY layer: readline, Clack spinners, selects, task phases.
 import readline from 'node:readline';
-import { cancel as clackCancel, confirm as clackConfirm, select as clackSelect, spinner as clackSpinner, tasks as clackTasks } from '@clack/prompts';
+import { cancel as clackCancel, confirm as clackConfirm, log as clackLog, select as clackSelect, spinner as clackSpinner, tasks as clackTasks } from '@clack/prompts';
 import { execP } from './common.js';
 const RL = readline.createInterface({ input: process.stdin, output: process.stdout });
 let rlOpen = true;
@@ -103,7 +103,41 @@ async function runInteractivePhase(title, collect) {
     await clackTasks([{ title, task: async () => { result = await collect(); } }]);
     return result;
 }
+const TAG_KIND = {
+    fail: 'error', warn: 'warn', hint: 'info', ok: 'success', note: 'message',
+    write: 'step', rm: 'step', migrate: 'step', skip: 'info', 'dry-run': 'info',
+};
+function sayTagged(line) {
+    const m = /^\s*\[([\w-]+)\]\s?([\s\S]*)$/.exec(line);
+    const kind = (m && TAG_KIND[m[1]]) || 'info';
+    if (tty() && m)
+        clackLog[kind](m[2]);
+    else
+        console.log(line);
+}
+// One live-updating task line instead of a spinner per step.
+async function withInteractiveTask(title, work) {
+    if (!tty())
+        return work(() => { });
+    closeRL();
+    let result;
+    const spin = clackSpinner();
+    spin.start(title);
+    try {
+        result = await work((message) => spin.message(message));
+        spin.stop('done');
+    }
+    catch (e) {
+        spin.error(shortSpinnerError(e));
+        throw e;
+    }
+    return result;
+}
+function shortSpinnerError(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return (msg.split('\n')[0] || 'failed').slice(0, 120);
+}
 async function execNetwork(label, cmd, args, opts = {}) {
     return withInteractiveSpinner(label, () => execP(cmd, args, opts));
 }
-export { ask, closeRL, tty, withInteractiveSpinner, execNetwork, askInteractiveChoice, askInteractiveConfirm, confirmDestructive, runInteractivePhase, };
+export { ask, closeRL, tty, withInteractiveSpinner, withInteractiveTask, execNetwork, sayTagged, askInteractiveChoice, askInteractiveConfirm, confirmDestructive, runInteractivePhase, };

package/cli/layer.js

@@ -8,9 +8,7 @@ export function layerEntries(extDir, table) {
 export function layerDirs(table) {
     return table.map(([dir]) => dir);
 }
-// A port source sits two levels below extensions/; installed, it sits one level
-// below <agent-dir>/extensions/. Rewriting on the way in keeps one spelling in
-// the repo and the same other spelling in every installed tree.
+// A port source sits two levels below extensions/, one level once installed.
 export function rewritePortImports(content) {
     return content.replace(/from '\.\.\/\.\.\/(shared|lib)\//g, "from '../$1/");
 }

package/cli/manifest.js

@@ -1,7 +1,4 @@
-// cli/manifest.ts — the one list of what an install writes into a host's
-// extension tree. The installer, `doctor --fix extensions`, the doctor's
-// per-host tree row, and the loadability test all read it, so none of them
-// can drift from what actually ships.
+// Single list of install writes, shared by installer, doctor, and tests.
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 export const EXT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'extensions');

package/cli/profile.js

@@ -1,7 +1,5 @@
-// cli/profile.ts — session-start defaults profile (combo/caveman/rtk/ponytail)
-// plus the display-currency default for usage/dashboard reports.
-// Stored in ~/.tersio/settings.json, which every host reads. Extracted from
-// cli/install.ts so both install and settings share it.
+// cli/profile.ts — session-start defaults and the display-currency default,
+// stored in ~/.tersio/settings.json. Shared by install and settings.
 import { existsSync, promises as fs } from 'node:fs';
 import path from 'node:path';
 import { CAVEMAN_DEFAULTS, COMBO_PRESET_MODES, PACKAGE_NAME, PONYTAIL_DEFAULTS, verbose, } from './common.js';
@@ -9,6 +7,7 @@ import os from 'node:os';
 import { DEFAULT_CURRENCY, isCurrencyCode } from './currency.js';
 import { readTextIfExists } from '../extensions/lib/utils.js';
 import { tersioSettingsFile } from '../extensions/shared/plugin-settings.js';
+export const BACKUP_SCHEDULES = new Set(['manual', 'daily', 'weekly', 'monthly']);
 function defaultProfile() {
     return {
         comboDefault: 'off',
@@ -16,11 +15,10 @@ function defaultProfile() {
         rtkDefault: false,
         ponytailDefault: 'off',
         currency: DEFAULT_CURRENCY,
+        backupSchedule: 'monthly',
     };
 }
-// Stored profile: ~/.tersio/settings.json. An install that predates that file
-// kept the same values as OMP plugin settings, so seed from there once and
-// never lose a user's choice.
+// Seed once from OMP plugin settings so a pre-~/.tersio install keeps its values.
 async function storedProfile() {
     const base = defaultProfile();
     const stored = (await readTextIfExists(tersioSettingsFile())) !== null
@@ -39,6 +37,9 @@ async function storedProfile() {
     if (typeof stored.currency === 'string' && isCurrencyCode(stored.currency.trim().toUpperCase())) {
         base.currency = stored.currency.trim().toUpperCase();
     }
+    if (typeof stored.backupSchedule === 'string' && BACKUP_SCHEDULES.has(stored.backupSchedule)) {
+        base.backupSchedule = stored.backupSchedule;
+    }
     return base;
 }
 function legacyOmpLockPath() {
@@ -75,6 +76,7 @@ async function writePluginSettings(profile, options) {
         rtkDefault: profile.rtkDefault,
         ponytailDefault: profile.ponytailDefault,
         currency: profile.currency,
+        backupSchedule: profile.backupSchedule,
     };
     if (options.dryRun) {
         if (verbose && !options.quiet)

package/cli/reset.js

@@ -1,10 +1,6 @@
-// cli/reset.ts — clear tersio-owned statistics: the usage ledger plus a reset
-// watermark that filters session-derived and RTK-metered rows out of every
-// derived view. Session transcripts (~/.omp/agent/sessions) and the RTK
-// database are host/tool-owned and are never touched; the watermark only
-// changes what tersio shows.
+// Clears tersio-owned stats only; transcripts and RTK data stay.
 import { dryRun, yes } from './common.js';
-import { confirmDestructive } from './interactive.js';
+import { confirmDestructive, sayTagged } from './interactive.js';
 import { clearUsageLedger, importSessionTokens, ledgerPath, markReset, readUsage, sessionsDir } from '../extensions/shared/usage-ledger.js';
 import { clearUsageDb, usageDbPath } from '../extensions/shared/usage-store.js';
 import { readRtkGain, rtkDbPath } from '../extensions/shared/rtk-gain.js';
@@ -29,7 +25,7 @@ async function runReset() {
     const cleared = clearUsageLedger();
     const dbCleared = clearUsageDb();
     const ts = markReset();
-    console.log(`[ok] reset — removed ${cleared} usage rows${dbCleared ? ' + usage.db' : ''}; statistics view starts at ${new Date(ts).toISOString()}`);
+    sayTagged(`[ok] reset — removed ${cleared} usage rows${dbCleared ? ' + usage.db' : ''}; statistics view starts at ${new Date(ts).toISOString()}`);
     return true;
 }
 export { runReset };

package/cli/rtk-wiring.js

@@ -1,9 +1,4 @@
-// cli/rtk-wiring.ts — wire the installed rtk binary into OMP.
-// `rtk init -g --agent omp` writes rtk's tool_call extension to
-// ~/.omp/agent/extensions/rtk.ts but does not register it, and OMP loads only
-// listed extensions, so we add the path to config.yml. Every rewritten bash
-// call then lands in rtk's history.db. Fail-open: a failed wire only downgrades
-// to manual `rtk` prefixing. No cli/common.ts import (argv side effects).
+// OMP loads only listed extensions, so register rtk's path; fail-open.
 import { promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';

package/cli/settings.js

@@ -1,8 +1,4 @@
-// cli/settings.ts — view/edit session-start defaults (combo/caveman/rtk/ponytail)
-// plus the display-currency default for usage/dashboard reports.
-// Non-interactive: `tersio settings --combo-default balanced` (plus per-mode
-// override flags and --currency). Interactive: clack selects seeded from the
-// stored profile.
+// cli/settings.ts — view/edit session-start defaults and the display currency.
 import path from 'node:path';
 import { CAVEMAN_DEFAULTS, COMBO_DEFAULTS, COMBO_PRESET_MODES, OMP_PLUGINS_DIR, PACKAGE_NAME, PONYTAIL_DEFAULTS, cavemanDefaultFlag, comboDefaultFlag, currency, currencyGiven, diagScheduleFlag, dryRun, ponytailDefaultFlag, profileFlagsGiven, rtkDefaultFlag, settingArg, } from './common.js';
 import { CURRENCY_CODES } from './currency.js';
@@ -44,6 +40,7 @@ async function askProfile(current) {
         rtkDefault: preset.rtk,
         ponytailDefault: preset.ponytail,
         currency: current.currency,
+        backupSchedule: current.backupSchedule,
     };
     const caveman = await askInteractiveChoice('Caveman default', [...CAVEMAN_DEFAULTS].map((v) => ({
         value: v, label: v,
@@ -162,9 +159,7 @@ async function runSingleSetting(name, current, nextDiag) {
 }
 function printSettingsTable(current) {
     console.log('\n=== Tersio Settings ===');
-    // Currency lives here no longer: the dashboard owns displaying and
-    // persisting it (its picker POSTs to /currency); settings can still set
-    // the stored default via --currency or the prompt below.
+    // The dashboard owns displaying currency; settings only sets the default.
     const rows = [
         ['combo', current.comboDefault, [...COMBO_DEFAULTS].join(' | ')],
         ['caveman', current.cavemanDefault, [...CAVEMAN_DEFAULTS].join(' | ')],