@krtclcdy/tersio 2.24.0 → 2.24.1

package/README.md

@@ -8,9 +8,7 @@
 [![Build](https://shieldcn.dev/github/ci/KurutoDenzeru/tersio.svg?variant=branded&size=xs&logo=githubactions&label=Build)](https://github.com/KurutoDenzeru/tersio/actions)
 [![MIT](https://shieldcn.dev/badge/license-MIT-2563eb.svg?variant=branded&size=xs&logo=opensourceinitiative)](./LICENSE)
 
-Token-saving add-ons for Oh My Pi and pi: terse caveman replies, compact
-RTK shell output, lean Ponytail code calls, usage tracking with a gain
-dashboard — one-command combo presets, one shared extension tree.
+Token saver & usage tracker for coding agents: terse caveman replies, compact RTK shell output, lean Ponytail code calls, and a gain dashboard — one-command combo presets over one shared extension tree.
 
 ## ⚡ Getting Started
 

package/cli/banner.js

@@ -1,6 +1,5 @@
-// cli/banner.ts — mini pixel-scissor welcome (16x12 px -> 6 half-block rows).
-// OMP-style launch moment for interactive runs: clack intro + note box.
-// TTY-only and skipped on --dry-run, so piped output stays byte-identical.
+// cli/banner.ts — mini pixel-scissor welcome. TTY-only and skipped on
+// --dry-run, so piped output stays byte-identical.
 import { intro as clackIntro, note as clackNote } from '@clack/prompts';
 import { PACKAGE_VERSION, dryRun } from './common.js';
 function tty() {

package/cli/currency.js

@@ -1,7 +1,5 @@
-// cli/currency.ts — display-currency helpers (USD-base, offline snapshot rates).
-// Same 10 currencies, symbols, and snapshot rates as the dashboard's
-// converter (dashboard/app); the dashboard replaces rates with live
-// frankfurter figures when reachable, the CLI always uses the snapshot.
+// cli/currency.ts — USD-base currency helpers on offline snapshot rates. Same
+// 10 currencies as the dashboard, which prefers live frankfurter figures.
 import { existsSync, readFileSync } from 'node:fs';
 import { tersioSettingsFile } from '../extensions/shared/plugin-settings.js';
 const CURRENCY_CODES = [
@@ -31,9 +29,7 @@ function parseCurrencyFlag(raw) {
     }
     return v;
 }
-// Stored default from the omp plugin lock file (written by tersio settings);
-// USD when missing, corrupt, or holding an unknown code. Sync so flag
-// parsing in cli/common.ts can fall back to it at startup.
+// Stored default; USD when missing, corrupt, or an unknown code.
 function readStoredCurrency() {
     const file = tersioSettingsFile();
     if (!existsSync(file))

package/cli/dashboard.js

@@ -10,9 +10,12 @@ import { fileURLToPath } from 'node:url';
 import { clearUsageLedger, markReset, readUsage } from '../extensions/shared/usage-ledger.js';
 import { pricesCachePath } from '../extensions/shared/pricing.js';
 import { summarizeUsage } from './usage.js';
+import { deleteUsageBackup, listUsageBackups, restoreUsageBackup } from '../extensions/shared/usage-store.js';
 import { isCurrencyCode } from './currency.js';
 import { OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_VERSION, } from './common.js';
-import { storedProfile, writePluginSettings } from './profile.js';
+import { BACKUP_SCHEDULES, storedProfile, writePluginSettings } from './profile.js';
+import { normalizeComboLevel } from '../extensions/shared/session-state.js';
+import { CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS } from './common.js';
 import { PACKAGE_NAME } from './common.js';
 import { resolveRtkBinary } from '../extensions/lib/utils.js';
 const DASHBOARD_DIST = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'dashboard', 'dist');
@@ -217,8 +220,12 @@ function computeDoctorRows() {
     catch { /* missing config is reported by extension rows */ }
     const duplicateExtensions = [...new Set(explicitEntries.filter((entry, index) => explicitEntries.indexOf(entry) !== index))];
     addon('Unique config registrations', duplicateExtensions.length === 0, duplicateExtensions.length ? duplicateExtensions.join(', ') : 'ok', 'Extensions');
-    const retiredReinforcement = explicitEntries.filter((entry) => entry.endsWith('/shared/mode-reinforcement.ts')).length;
-    addon('No retired reinforcement', retiredReinforcement === 0, retiredReinforcement ? `${retiredReinforcement} registration(s)` : 'ok', 'Extensions');
+    // A listed extension whose file is gone makes the host warn on every load, so
+    // surface it rather than leaving the user with only a startup message.
+    const dangling = explicitEntries
+        .filter((entry) => entry.includes(`extensions${path.sep}`) || entry.includes('extensions/'))
+        .filter((entry) => !ok(path.isAbsolute(entry) ? entry : path.resolve(OMP_AGENT_DIR, entry)));
+    addon('Extension files present', dangling.length === 0, dangling.length ? dangling.join(', ') : 'ok', 'Extensions');
     ext('Caveman extension', path.join(tersioPluginDir, 'extensions', 'caveman-session', 'index.ts'));
     ext('RTK extension', path.join(tersioPluginDir, 'extensions', 'rtk-session', 'index.ts'));
     ext('Ponytail extension', path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js'));
@@ -258,6 +265,7 @@ const RETIRED_DIAG_LABELS = new Set([
     'Self plugin',
     'Ponytail registered',
     'Usage store',
+    'RTK OMP wiring (rtk.ts)',
 ]);
 function isRetiredReport(report) {
     return report.rows.some((r) => RETIRED_DIAG_LABELS.has(r.label));
@@ -279,6 +287,50 @@ function setDiagSchedule(schedule) {
     writeDiagReport(base);
     return base;
 }
+// One field per call, validated against the same sets the CLI uses.
+async function saveDefaults(body) {
+    const profile = await storedProfile();
+    if (body.comboDefault !== undefined) {
+        const level = normalizeComboLevel(body.comboDefault);
+        if (!level)
+            return { ok: false, error: 'unknown combo level' };
+        profile.comboDefault = level;
+    }
+    if (body.cavemanDefault !== undefined) {
+        const v = String(body.cavemanDefault);
+        if (!CAVEMAN_DEFAULTS.has(v))
+            return { ok: false, error: 'unknown caveman level' };
+        profile.cavemanDefault = v;
+    }
+    if (body.ponytailDefault !== undefined) {
+        const v = String(body.ponytailDefault);
+        if (!PONYTAIL_DEFAULTS.has(v))
+            return { ok: false, error: 'unknown ponytail level' };
+        profile.ponytailDefault = v;
+    }
+    if (body.backupSchedule !== undefined) {
+        const v = String(body.backupSchedule);
+        if (!BACKUP_SCHEDULES.has(v))
+            return { ok: false, error: 'unknown backup schedule' };
+        profile.backupSchedule = v;
+    }
+    if (body.rtkDefault !== undefined) {
+        if (typeof body.rtkDefault !== 'boolean')
+            return { ok: false, error: 'rtk default must be true or false' };
+        profile.rtkDefault = body.rtkDefault;
+    }
+    await writePluginSettings(profile, {});
+    return {
+        ok: true,
+        profile: {
+            comboDefault: profile.comboDefault,
+            cavemanDefault: profile.cavemanDefault,
+            rtkDefault: profile.rtkDefault,
+            ponytailDefault: profile.ponytailDefault,
+            backupSchedule: profile.backupSchedule,
+        },
+    };
+}
 function readDiagSchedule() {
     return readDiagReport()?.schedule ?? 'manual';
 }
@@ -295,6 +347,50 @@ async function saveDashboardCurrency(raw) {
     await writePluginSettings(profile, {});
     return code;
 }
+export const EXPORT_FORMATS = ['json', 'jsonl', 'csv'];
+export function exportRows(report) {
+    return report.recent.map((r) => ({
+        timestamp: new Date(r.t).toISOString(),
+        local: new Date(r.t).toLocaleString(),
+        agent: r.h ?? 'pi',
+        model: r.m,
+        input: r.i,
+        output: r.o,
+        cacheRead: r.cr ?? 0,
+        cacheWrite: r.cw ?? 0,
+        costUsd: r.usd,
+        elapsedMs: r.d,
+        status: r.st,
+    }));
+}
+export function csvCell(v) {
+    const s = v === undefined || v === null ? '' : String(v);
+    return /[",\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+}
+export function exportBody(format, report) {
+    const stamp = new Date().toISOString().slice(0, 10);
+    if (format === 'json') {
+        return { body: JSON.stringify({ exportedAt: new Date().toISOString(), version: report.version, source: report.source, report }, null, 2), type: 'application/json' };
+    }
+    const rows = exportRows(report);
+    if (format === 'jsonl') {
+        return { body: rows.map((r) => JSON.stringify(r)).join('\n') + '\n', type: 'application/x-ndjson' };
+    }
+    const cols = Object.keys(rows[0] ?? { timestamp: '', agent: '' });
+    const head = cols.join(',');
+    const body = [head, ...rows.map((r) => cols.map((c) => csvCell(r[c])).join(','))].join('\n') + '\n';
+    return { body, type: 'text/csv; charset=utf-8' };
+}
+function serveExport(req, res) {
+    const format = ((req.url || '').split('?')[1] || '').match(/format=([a-z]+)/)?.[1];
+    const fmt = format && EXPORT_FORMATS.includes(format) ? format : 'json';
+    const { body, type } = exportBody(fmt, summarizeUsage(readUsage()));
+    res.writeHead(200, {
+        'Content-Type': type,
+        'Content-Disposition': `attachment; filename="tersio-usage-${new Date().toISOString().slice(0, 10)}.${fmt === 'jsonl' ? 'ndjson' : fmt}"`,
+    });
+    res.end(body);
+}
 function readBody(req) {
     return new Promise((resolve) => {
         let body = '';
@@ -351,6 +447,70 @@ async function runDashboard(options) {
             res.end(JSON.stringify({ ok: true, rows }));
             return;
         }
+        if (req.url === '/backups' && req.method === 'GET') {
+            const rows = listUsageBackups().map((b) => ({ file: path.basename(b.file), mtime: b.mtime, size: b.size }));
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ backups: rows }));
+            return;
+        }
+        if (req.url === '/backups/delete' && req.method === 'POST') {
+            let file = '';
+            try {
+                file = String(JSON.parse(await readBody(req)).file ?? '');
+            }
+            catch {
+                file = '';
+            }
+            const ok = deleteUsageBackup(file);
+            res.writeHead(ok ? 200 : 400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(ok ? { ok: true, file } : { ok: false, error: 'unknown backup' }));
+            return;
+        }
+        if (req.url === '/backups/restore' && req.method === 'POST') {
+            let file = '';
+            try {
+                file = String(JSON.parse(await readBody(req)).file ?? '');
+            }
+            catch {
+                file = '';
+            }
+            const ok = restoreUsageBackup(file);
+            res.writeHead(ok ? 200 : 400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(ok ? { ok: true, file } : { ok: false, error: 'unknown backup' }));
+            return;
+        }
+        if (req.url === '/settings' && req.method === 'GET') {
+            storedProfile().then((profile) => {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    comboDefault: profile.comboDefault,
+                    cavemanDefault: profile.cavemanDefault,
+                    rtkDefault: profile.rtkDefault,
+                    ponytailDefault: profile.ponytailDefault,
+                    backupSchedule: profile.backupSchedule,
+                }));
+            });
+            return;
+        }
+        if (req.url === '/settings' && req.method === 'POST') {
+            let body = {};
+            try {
+                body = JSON.parse(await readBody(req)) ?? {};
+            }
+            catch {
+                body = {};
+            }
+            const saved = await saveDefaults(body);
+            if (!saved.ok) {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, error: saved.error }));
+            }
+            else {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true, ...saved.profile }));
+            }
+            return;
+        }
         if (req.url === '/currency' && req.method === 'POST') {
             let code = null;
             try {
@@ -375,6 +535,10 @@ async function runDashboard(options) {
             res.end(dataJson());
             return;
         }
+        if (req.url?.startsWith('/export')) {
+            serveExport(req, res);
+            return;
+        }
         if (req.url === '/health') {
             res.writeHead(200, { 'Content-Type': 'application/json' });
             res.end(healthJson());

package/cli/doctor-fix.js

@@ -3,7 +3,7 @@ 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, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, removeExtensionFromConfig, dryRun, verbose, debug, execP, readPluginsPackage, writeIfChanged, } from './common.js';
-import { execNetwork } from './interactive.js';
+import { execNetwork, sayTagged } 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';
@@ -25,12 +25,12 @@ async function fixExtensionTrees() {
             const from = path.join(EXT_DIR, ...file.split('/'));
             const text = await readTextIfExists(from);
             if (text === null)
-                console.log(`  [warn] bundled source missing: ${from}`);
+                sayTagged(`  [warn] bundled source missing: ${from}`);
             else
                 await writeIfChanged(path.join(dest, file), text, { dryRun, verbose });
         }
         if (!dryRun)
-            console.log(`  [ok] ${host.label} extension tree: ${dest}`);
+            sayTagged(`  [ok] ${host.label} extension tree: ${dest}`);
     }
 }
 async function fixExtensions(pluginsDir) {
@@ -39,13 +39,16 @@ async function fixExtensions(pluginsDir) {
     const tersioPluginDir = path.join(pluginsDir, 'node_modules', '@krtclcdy', 'tersio');
     const pluginExtDir = path.join(tersioPluginDir, 'extensions');
     await fs.mkdir(pluginExtDir, { recursive: true });
-    for (const [from, to] of TREE_FILES.map((file) => [sourcePath(file), file])) {
-        const text = await readTextIfExists(from);
+    // rule.md is skipped: its live content is the upstream fetch, not the bundle.
+    const bundledTree = TREE_FILES.filter((file) => file !== 'caveman-session/rule.md');
+    for (const file of bundledTree) {
+        const text = await readTextIfExists(sourcePath(file));
         if (text === null)
-            console.log(`  [warn] bundled source missing: ${from}`);
+            sayTagged(`  [warn] bundled source missing: ${sourcePath(file)}`);
         else
-            await writeIfChanged(path.join(pluginExtDir, to), text, { dryRun, verbose });
+            await writeIfChanged(path.join(pluginExtDir, file), text, { dryRun, verbose });
     }
+    // Restore only a missing rule; a stale one is /ai-addons' to report.
     const ruleDest = path.join(pluginExtDir, 'caveman-session', 'rule.md');
     if ((await readTextIfExists(ruleDest)) === null) {
         const bundled = await readTextIfExists(path.join(EXT_DIR, 'caveman-session', 'rule.md'));
@@ -69,7 +72,7 @@ async function fixRegistrations(agentDir, pluginsDir) {
     const configPath = path.join(agentDir, 'config.yml');
     if ((await readTextIfExists(configPath)) === null) {
         if (dryRun)
-            console.log(`  [dry-run] would create ${configPath}`);
+            sayTagged(`  [dry-run] would create ${configPath}`);
         else {
             await fs.mkdir(agentDir, { recursive: true });
             await fs.writeFile(configPath, 'extensions:\n', 'utf8');
@@ -88,7 +91,7 @@ async function fixRegistrations(agentDir, pluginsDir) {
     if (!(PACKAGE_NAME in pkg.dependencies)) {
         pkg.dependencies[PACKAGE_NAME] = `^${PACKAGE_VERSION}`;
         if (dryRun)
-            console.log(`  [dry-run] would register ${PACKAGE_NAME} in ${pkgPath}`);
+            sayTagged(`  [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');
@@ -99,7 +102,7 @@ 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`);
+        sayTagged(`  [dry-run] would download a checksum-verified rtk to ${binDest} and wire it into OMP`);
         return;
     }
     const spec = rtkPlatformSpec();
@@ -180,11 +183,11 @@ async function runDoctorRepairs(targets) {
         try {
             await work();
             if (!dryRun)
-                console.log(`  [ok] ${label}`);
+                sayTagged(`  [ok] ${label}`);
         }
         catch (e) {
             failed.push(label);
-            console.log(`  [fail] ${label}: ${(e.message || '').slice(0, 200)}`);
+            sayTagged(`  [fail] ${label}: ${(e.message || '').slice(0, 200)}`);
         }
     };
     if (want('extensions'))

package/cli/doctor.js

@@ -2,7 +2,7 @@
 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, missingTreeFiles, ompPackageDir } from './hosts.js';
+import { detectHosts, 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';
@@ -115,22 +115,11 @@ async function runDoctor(recheck = false) {
             .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(', ') : '');
-        const retiredReinforcement = explicitEntries.filter((entry) => entry.endsWith('/shared/mode-reinforcement.ts')).length;
-        if (retiredReinforcement === 0)
-            check('No retired reinforcement', true);
-        else
-            warnLine('Retired reinforcement registration', `${retiredReinforcement} found; run doctor --fix registrations`);
         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'));
     }
-    for (const host of hosts) {
-        if (!host.installed || host.via !== 'tree')
-            continue;
-        const missing = missingTreeFiles(host.id);
-        check(`${host.label} extension tree`, missing.length === 0, missing.length ? `${missing.length} missing in ${host.dir}` : '');
-    }
     section('Usage & records');
     console.log(`  Usage DB (tersio-owned · local hosted): ${usageDbPath()}`);
     const pricesAge = pricesMtime ? `(pulled ${relTime(Date.now() - pricesMtime.mtimeMs)} · ${absDate(pricesMtime.mtimeMs)})` : '';

package/cli/hosts.js

@@ -1,6 +1,5 @@
 // cli/hosts.ts — the agent hosts Tersio installs into, and what is on disk.
-// One detector, shared by the doctor rows, the install menu, and the uninstall
-// menu, so the three can never disagree about what is installed.
+// 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';
@@ -33,9 +32,8 @@ function packageVersion(dir) {
         return null;
     }
 }
-// The tersio package pi has declared in its own settings.json, or null. pi
-// writes the declaration on install and identifies a source by name, so an npm
-// spec, a git URL, and a local path all count when they name this package.
+// 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 {
@@ -85,10 +83,7 @@ function detect(agentDir = piAgentDir()) {
         };
     });
 }
-/**
- * The menu label, with the current state in brackets: the version when the
- * package is already there, so a rerun shows what it would replace.
- */
+/** Menu label with current state in brackets, so a rerun shows what it replaces. */
 export function hostLabel(host) {
     if (host.installed && host.version)
         return `${host.label} (installed ${host.version})`;
@@ -98,9 +93,10 @@ export function hostLabel(host) {
         return `${host.label} (package declared, not on disk)`;
     return `${host.label} (not installed)`;
 }
+// Hints render inline, so menus name the install and doctor keeps the path.
 export function hostHint(host) {
-    if (host.installed && host.dir)
-        return host.dir;
+    if (host.installed && host.via)
+        return host.via === 'tree' ? 'extension tree' : 'plugin package';
     return host.installCmd;
 }
 // `--host omp|pi` from raw argv; undefined when absent. Throws on an unknown