@krtclcdy/tersio 2.25.4 → 2.25.6

package/dist/cli/backups.js

@@ -0,0 +1,187 @@
+// Data snapshots: a manifest directory, not one file; older lone `usage-<stamp>.db` installs still restore.
+import { promises as fs } from 'node:fs';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { sqliteExec } from '../extensions/shared/sqlite.js';
+import { agentDbPath, statsDbPath } from '../extensions/shared/agent-stats.js';
+import { rtkDbPath } from '../extensions/shared/rtk-gain.js';
+import { pricesCachePath } from '../extensions/shared/pricing.js';
+import { usageDbPath } from '../extensions/shared/usage-store.js';
+import { resetMarkerPath } from '../extensions/shared/usage-ledger.js';
+import { tersioHome } from '../extensions/shared/utils.js';
+/** Snapshots kept on disk, oldest pruned first; six fills past one screen so the pane scrolls. */
+export const BACKUP_KEEP = 6;
+export function backupDir() {
+    return path.join(tersioHome(), 'backups');
+}
+function manifestPath(dir) {
+    return path.join(dir, 'manifest.json');
+}
+/** Every file this build knows how to snapshot, whether or not it exists yet. */
+export function dataSources() {
+    const sources = [
+        ['Usage ledger', usageDbPath()],
+        ['Reset watermark', resetMarkerPath()],
+        ['Settings', path.join(tersioHome(), 'settings.json')],
+        ['Price cache', pricesCachePath()],
+        ['Model price cache', path.join(tersioHome(), 'prices-modelsdev.json')],
+        ['Agent stats', statsDbPath()],
+        ['Agent quota windows', agentDbPath()],
+        ['Command history', rtkDbPath()],
+    ];
+    return sources.map(([label, source]) => ({ label, source, bytes: sizeOf(source) }));
+}
+/** Byte size of a file, zero when it is absent or unreadable. */
+function sizeOf(file) {
+    try {
+        return statSync(file).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Snapshot label for a legacy single-file backup, so the list reads the same for both. */
+function legacyLabel(name) {
+    return name.startsWith('usage-') ? 'Usage ledger' : 'Snapshot';
+}
+/** Newest first: the directories this build wrote, then the lone `usage-*.db` files. */
+export function listDataBackups() {
+    let names = [];
+    try {
+        names = readdirSync(backupDir());
+    }
+    catch {
+        return [];
+    }
+    const dirs = [];
+    const legacy = [];
+    for (const name of names) {
+        const full = path.join(backupDir(), name);
+        let stat;
+        try {
+            stat = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            const files = readManifest(full);
+            if (files.length === 0)
+                continue;
+            dirs.push({ name, path: full, mtime: stat.mtimeMs, bytes: totalOf(full), files, legacy: false });
+            continue;
+        }
+        if (/^usage-\d{14}\.db$/.test(name)) {
+            legacy.push({
+                name,
+                path: full,
+                mtime: stat.mtimeMs,
+                bytes: stat.size,
+                files: [{ label: legacyLabel(name), source: usageDbPath(), bytes: stat.size }],
+                legacy: true,
+            });
+        }
+    }
+    return [...dirs, ...legacy].toSorted((a, b) => b.mtime - a.mtime);
+}
+function readManifest(dir) {
+    try {
+        const raw = JSON.parse(readFileSync(manifestPath(dir), 'utf8'));
+        if (!Array.isArray(raw))
+            return [];
+        return raw
+            .map((entry) => {
+            const record = (entry ?? {});
+            const source = String(record.source ?? '');
+            const name = path.basename(source);
+            const file = path.join(dir, name);
+            const bytes = sizeOf(file);
+            if (!source || bytes === 0)
+                return null;
+            return { label: String(record.label ?? name), source, bytes };
+        })
+            .filter((entry) => entry !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/** Disk size of a snapshot, counting the manifest. */
+function totalOf(dir) {
+    return sizeOf(manifestPath(dir)) + readdirSync(dir).reduce((sum, name) => sum + sizeOf(path.join(dir, name)), 0);
+}
+/** Put the sqlite ledger's write-ahead log back in the main file, so a copy is one whole database. */
+function checkpointLedger() {
+    try {
+        sqliteExec(usageDbPath(), 'PRAGMA wal_checkpoint(TRUNCATE);');
+    }
+    catch {
+        /* no SQLite on this host, or no ledger: the plain file copy is the best available */
+    }
+}
+/** Take a snapshot: one copy of every existing file under a stamp dir, keeping the newest {@link BACKUP_KEEP}. */
+export async function createDataBackup() {
+    // The stamp keeps milliseconds: two snapshots in the same second must not land in one directory.
+    const stamp = new Date().toISOString().replace(/[-:TZ.]/g, '');
+    const dir = path.join(backupDir(), `data-${stamp}`);
+    checkpointLedger();
+    await fs.mkdir(dir, { recursive: true });
+    const files = [];
+    for (const source of dataSources()) {
+        if (source.bytes === 0)
+            continue;
+        const target = path.join(dir, path.basename(source.source));
+        await fs.copyFile(source.source, target);
+        files.push({ ...source, bytes: sizeOf(target) });
+    }
+    await fs.writeFile(manifestPath(dir), JSON.stringify(files.map(({ label, source }) => ({ label, source }))), 'utf8');
+    await pruneBackups();
+    return { name: path.basename(dir), path: dir, mtime: Date.now(), bytes: files.reduce((sum, f) => sum + f.bytes, 0), files, legacy: false };
+}
+/** Keep the newest {@link BACKUP_KEEP} snapshots and drop the rest, legacy files included. */
+export async function pruneBackups() {
+    const all = listDataBackups();
+    for (const old of all.slice(BACKUP_KEEP)) {
+        await fs.rm(old.path, { recursive: true, force: true }).catch(() => { });
+    }
+}
+/** A snapshot name resolves to a path inside the backup directory, or null when it does not. */
+function resolveBackup(name) {
+    if (!name || path.basename(name) !== name || /[\\/]/.test(name))
+        return null;
+    const found = listDataBackups().find((entry) => entry.name === name);
+    return found ?? null;
+}
+/** Restore: files the snapshot holds overwrite their live source; files it lacks stay put, so nothing is lost. */
+export async function restoreDataBackup(name) {
+    const found = resolveBackup(name);
+    if (!found)
+        return false;
+    if (found.legacy) {
+        await fs.mkdir(path.dirname(usageDbPath()), { recursive: true });
+        await fs.copyFile(found.path, usageDbPath());
+        return true;
+    }
+    for (const file of found.files) {
+        const from = path.join(found.path, path.basename(file.source));
+        await fs.mkdir(path.dirname(file.source), { recursive: true });
+        await fs.copyFile(from, file.source);
+    }
+    return true;
+}
+/** Remove one snapshot. Only ever touches a path inside the backup directory. */
+export async function deleteDataBackup(name) {
+    const found = resolveBackup(name);
+    if (!found)
+        return false;
+    await fs.rm(found.path, { recursive: true, force: true });
+    return true;
+}
+/** Total size of every snapshot on disk, for the pane's footer. */
+export function backupDiskBytes() {
+    return listDataBackups().reduce((sum, entry) => sum + entry.bytes, 0);
+}
+/** The home directory the snapshots live under, for the pane's path line. */
+export function backupHome() {
+    return tersioHome();
+}

package/dist/cli/banner.js

@@ -1,4 +1,4 @@
-// cli/banner.ts — mini pixel-scissor welcome. TTY-only and skipped on --dry-run, so piped output stays byte-identical.
+// cli/banner.ts — mini pixel-scissor welcome. TTY-only, skipped on --dry-run; piped output stays byte-identical.
 import { intro as clackIntro, note as clackNote } from '@clack/prompts';
 import { PACKAGE_VERSION, dryRun } from './common.js';
 function tty() {
@@ -81,9 +81,10 @@ function printWelcome() {
         'tersio update    refresh CLI + add-ons',
         'tersio doctor    verify the install',
     ];
-    // Below 26 rows the note scrolls off the top and slices the art.
+    // Below 26 rows the note scrolls off the top and slices the art, and the screen must also hold the
+    // update prompt and every option, so the tips take one line there.
     if (process.stdout.rows < 26) {
-        clackNote(tips.map((t) => `  ${t}`).join('\n'));
+        clackNote(`  ${tips.join(' · ')}`);
         return;
     }
     const art = bannerLines();

package/dist/cli/common.js

@@ -5,7 +5,7 @@ import path from 'node:path';
 import { promisify } from 'node:util';
 import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
-import { findPackageRoot, readTextIfExists } from '../extensions/lib/utils.js';
+import { findPackageRoot, readTextIfExists } from '../extensions/shared/utils.js';
 import { parseCurrencyFlag, readStoredCurrency } from './currency.js';
 const IS_WINDOWS = process.platform === 'win32';
 const RTK_BINARY_NAME = IS_WINDOWS ? 'rtk.exe' : 'rtk';
@@ -19,14 +19,15 @@ const PACKAGE_BIN = 'tersio';
 const { version: PACKAGE_VERSION } = createRequire(import.meta.url)(path.join(findPackageRoot(path.dirname(fileURLToPath(import.meta.url))), 'package.json'));
 const CAVEMAN_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'megacave-lite', 'megacave-full', 'megacave-ultra']);
 const PONYTAIL_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra']);
+const PSTACK_DEFAULTS = new Set(['off', 'on']);
 const RTK_DEFAULTS = new Set(['on', 'off']);
 const DIAG_SCHEDULES = new Set(['manual', 'daily', 'weekly', 'monthly']);
-// Mirrors COMBO_LEVELS in extensions/shared/session-state.ts (rtk as a boolean here), so the combo preset implies all three modes.
+// Mirrors COMBO_LEVELS in extensions/shared/session-state.ts, so the combo preset implies all four modes.
 const COMBO_PRESET_MODES = {
-    off: { caveman: 'off', rtk: false, ponytail: 'off' },
-    medium: { caveman: 'lite', rtk: true, ponytail: 'lite' },
-    balanced: { caveman: 'full', rtk: true, ponytail: 'full' },
-    max: { caveman: 'ultra', rtk: true, ponytail: 'ultra' },
+    off: { caveman: 'off', rtk: false, ponytail: 'off', pstack: 'off' },
+    medium: { caveman: 'lite', rtk: true, ponytail: 'lite', pstack: 'on' },
+    balanced: { caveman: 'full', rtk: true, ponytail: 'full', pstack: 'on' },
+    max: { caveman: 'ultra', rtk: true, ponytail: 'ultra', pstack: 'on' },
 };
 const COMBO_DEFAULTS = new Set(Object.keys(COMBO_PRESET_MODES));
 function parseEnum(value, valid, flag) {
@@ -46,12 +47,11 @@ function flagValue(name) {
     const prefix = `${name}=`;
     return args.find((arg) => arg.startsWith(prefix))?.slice(prefix.length);
 }
-// --- CLI flags ---
-const COMMANDS = { install: true, update: true, doctor: true, uninstall: true, usage: true, dashboard: true, reset: true, settings: true, version: true, help: true };
+const COMMANDS = { install: true, reinstall: true, update: true, doctor: true, uninstall: true, usage: true, dashboard: true, reset: true, settings: true, version: true, help: true };
 const args = process.argv.slice(2);
 const commandArg = args.find((arg) => !arg.startsWith('-'));
 const command = commandArg?.toLowerCase() || null;
-// `tersio settings diagnosis` jumps to one prompt instead of walking the chain. Index-based, so flag values never count as positionals.
+// `tersio settings diagnosis` jumps to one prompt. Index-based, so flag values never count as positionals.
 const settingArg = (() => {
     const at = args.indexOf(commandArg ?? '');
     const next = at >= 0 ? args[at + 1] : undefined;
@@ -61,6 +61,7 @@ const settingArg = (() => {
 })();
 const unknownCommand = command !== null && !COMMANDS[command];
 const install = command === 'install';
+const reinstall = command === 'reinstall';
 const update = command === 'update';
 const showVersion = command === 'version' || args.includes('--version') || args.includes('-v');
 const showHelp = command === 'help' || args.includes('--help') || args.includes('-h');
@@ -96,9 +97,10 @@ if (legacyScope !== null && legacyScope !== 'user') {
 const comboDefaultFlag = parseEnum(flagValue('--combo-default'), COMBO_DEFAULTS, '--combo-default');
 const cavemanDefaultFlag = parseEnum(flagValue('--caveman-default'), CAVEMAN_DEFAULTS, '--caveman-default');
 const ponytailDefaultFlag = parseEnum(flagValue('--ponytail-default'), PONYTAIL_DEFAULTS, '--ponytail-default');
+const pstackDefaultFlag = parseEnum(flagValue('--pstack-default'), PSTACK_DEFAULTS, '--pstack-default');
 const rtkDefaultFlag = parseEnum(flagValue('--rtk-default'), RTK_DEFAULTS, '--rtk-default');
 const diagScheduleFlag = parseEnum(flagValue('--diag-schedule'), DIAG_SCHEDULES, '--diag-schedule');
-const profileFlagsGiven = [comboDefaultFlag, cavemanDefaultFlag, rtkDefaultFlag, ponytailDefaultFlag]
+const profileFlagsGiven = [comboDefaultFlag, cavemanDefaultFlag, rtkDefaultFlag, ponytailDefaultFlag, pstackDefaultFlag]
     .some((flag) => flag !== undefined);
 // Repeatable `--subagent-marker`; overrides the built-in host prompt marker.
 const subagentMarkerFlags = args
@@ -138,7 +140,7 @@ async function writeIfChanged(dest, content, options = {}) {
         console.log(`  [write] ${dest}`);
     return true;
 }
-// omp ships 'extensions: null', and list items under a null scalar break YAML: normalize null/~/[]/empty to a mapping key first.
+// omp ships 'extensions: null'; normalize it to a mapping key first, or YAML rejects the list items.
 const EXTENSIONS_KEY_RE = /^\s*extensions\s*:/i;
 const EXTENSIONS_NULL_RE = /^\s*extensions\s*:\s*(?:\[\s*\]|null|~)?\s*$/i;
 function normalizeExtensionsKey(lines) {
@@ -160,7 +162,7 @@ async function ensureExtensionInConfig(configPath, extensionPath, label, options
     const line = `  - ${normalizedPath}`;
     const raw = await readTextIfExists(configPath);
     let lines = (raw || '').split('\n');
-    // Drop legacy compiled twins (same dir/name, .js): OMP must never load both copies. Matched on the trailing path so relative entries are caught too.
+    // Drop legacy compiled twins (.js beside the name): OMP must never load both. Matched on the trailing path.
     if (normalizedPath.endsWith('.ts')) {
         const legacyTail = `${normalizedPath.slice(0, -3)}.js`.split('/').slice(-2).join('/');
         lines = lines.filter((l) => !l.trim().replace(/^\.\//, '').endsWith(legacyTail));
@@ -239,6 +241,12 @@ function readPonytailConfig() {
         : path.join(HOME, '.config', 'ponytail');
     return { dir, path: path.join(dir, 'config.json') };
 }
+/** This package's ponytail range, or null; repair pins it, since npm installs the published range. */
+async function bundledPonytailSpec() {
+    const root = findPackageRoot(path.dirname(fileURLToPath(import.meta.url)));
+    const text = await readTextIfExists(path.join(root, 'package.json'));
+    return parseJsonObject(text)?.dependencies?.['@dietrichgebert/ponytail'] ?? null;
+}
 function parseJsonObject(text) {
     if (!text)
         return null;
@@ -280,6 +288,14 @@ async function ensurePonytailConfigValue(key, value, options = {}) {
         return true;
     }, `would set Ponytail ${key}=${value}`, `Set Ponytail ${key}=${value}`, options);
 }
+// npm prefers a nested copy over the pin when the plugin's range excludes it; only `overrides` reaches it.
+function ponytailOverride(pkg) {
+    const overrides = pkg.overrides;
+    if (typeof overrides !== 'object' || overrides === null)
+        return null;
+    const value = overrides['@dietrichgebert/ponytail'];
+    return typeof value === 'string' ? value : null;
+}
 // Read plugins/package.json tolerantly; a corrupt or missing file starts fresh with installer-managed defaults.
 async function readPluginsPackage(pkgPath) {
     const pkg = parseJsonObject(await readTextIfExists(pkgPath)) ?? {};
@@ -300,4 +316,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, DIAG_SCHEDULES, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, settingArg, unknownCommand, install, update, showVersion, showHelp, applyUpdate, args, dryRun, yes, verbose, doctor, fix, uninstall, usage, dashboard, reset, settings, allowUnverified, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, diagScheduleFlag, profileFlagsGiven, subagentMarkerFlags, subagentMarkersGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, removeExtensionFromConfig, 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, PSTACK_DEFAULTS, RTK_DEFAULTS, DIAG_SCHEDULES, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, settingArg, unknownCommand, install, reinstall, update, showVersion, showHelp, applyUpdate, args, dryRun, yes, verbose, doctor, fix, uninstall, usage, dashboard, reset, settings, allowUnverified, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, pstackDefaultFlag, rtkDefaultFlag, diagScheduleFlag, profileFlagsGiven, subagentMarkerFlags, subagentMarkersGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, writeConfigLines, ensureExtensionInConfig, removeExtensionFromConfig, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, relTime, bundledPonytailSpec, ponytailOverride, };

package/dist/cli/currency.js

@@ -1,4 +1,4 @@
-// cli/currency.ts — USD-base currency helpers on offline snapshot rates. Same 10 currencies as the dashboard, which prefers live frankfurter figures.
+// cli/currency.ts — USD-base helpers on offline snapshot rates. Same 10 currencies as the dashboard's live figures.
 import { existsSync, readFileSync } from 'node:fs';
 import { tersioSettingsFile } from '../extensions/shared/plugin-settings.js';
 const CURRENCY_CODES = [