@krtclcdy/tersio 2.25.5 → 2.25.6

package/dist/cli/backups.js

@@ -1,25 +1,19 @@
-// Data snapshots: what tersio keeps, where the copies live, and how one is put back.
-//
-// A snapshot is a directory with a manifest, not a single file, so one copy holds the whole set.
-// Older installs wrote a lone `usage-<stamp>.db`; those still list and restore, over the ledger alone.
+// 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 { execFileSync } from 'node:child_process';
 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; the oldest is pruned first. Six keeps the list past one screen, so
- *  the pane scrolls instead of showing the whole history at once. */
+/** Snapshots kept on disk, oldest pruned first; six fills past one screen so the pane scrolls. */
 export const BACKUP_KEEP = 6;
-/** Where a snapshot's files live. */
 export function backupDir() {
     return path.join(tersioHome(), 'backups');
 }
-/** A snapshot directory's manifest, read back out with its files. */
 function manifestPath(dir) {
     return path.join(dir, 'manifest.json');
 }
@@ -90,7 +84,6 @@ export function listDataBackups() {
     }
     return [...dirs, ...legacy].toSorted((a, b) => b.mtime - a.mtime);
 }
-/** The files a snapshot directory holds, read from its manifest. */
 function readManifest(dir) {
     try {
         const raw = JSON.parse(readFileSync(manifestPath(dir), 'utf8'));
@@ -120,13 +113,13 @@ function totalOf(dir) {
 /** Put the sqlite ledger's write-ahead log back in the main file, so a copy is one whole database. */
 function checkpointLedger() {
     try {
-        execFileSync('sqlite3', [usageDbPath(), 'PRAGMA wal_checkpoint(TRUNCATE);'], { stdio: 'ignore', timeout: 10_000 });
+        sqliteExec(usageDbPath(), 'PRAGMA wal_checkpoint(TRUNCATE);');
     }
     catch {
-        /* no sqlite3, or no ledger: the plain file copy is the best available */
+        /* no SQLite on this host, or no ledger: the plain file copy is the best available */
     }
 }
-/** Take a snapshot now: one copy of every file that exists, under a stamp directory, then keep only the newest {@link BACKUP_KEEP}. */
+/** 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, '');
@@ -159,7 +152,7 @@ function resolveBackup(name) {
     const found = listDataBackups().find((entry) => entry.name === name);
     return found ?? null;
 }
-/** Put a snapshot back: every file it holds is copied over its live source. A file it lacks is left alone, so a restore never deletes what it does not carry. */
+/** 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)

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

@@ -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, 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 = [

package/dist/cli/dashboard.js

@@ -1,4 +1,4 @@
-// Serves the built Dashboard with local usage APIs. Binds 127.0.0.1 only; --export writes a file instead. No Promise.withResolvers: Node 20.12 lacks it.
+// Dashboard server + usage APIs. Binds 127.0.0.1; --export writes a file. No Promise.withResolvers (Node 20.12).
 import { spawn } from 'node:child_process';
 import { execFileSync } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
@@ -11,11 +11,11 @@ import { isCurrencyCode } from './currency.js';
 import { OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_VERSION, } from './common.js';
 import { BACKUP_SCHEDULES, formatCliStatus, storedProfile, writePluginSettings } from './profile.js';
 import { normalizeComboLevel } from '../extensions/shared/session-state.js';
-import { CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS } from './common.js';
+import { CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS, PSTACK_DEFAULTS } from './common.js';
 import { PACKAGE_NAME } from './common.js';
-import { findPackageRoot, resolveRtkBinary } from '../extensions/shared/utils.js';
+import { findPackageRoot, resolveRtkBinary, ruleBodyProblem } from '../extensions/shared/utils.js';
 import { BACKUP_KEEP, backupDir, backupDiskBytes, createDataBackup, dataSources, deleteDataBackup, listDataBackups, restoreDataBackup } from './backups.js';
-import { readBackupSchedule } from '../extensions/shared/usage-store.js';
+import { readBackupSchedule, syncUsageDb } from '../extensions/shared/usage-store.js';
 import { agentDbPath, emptyRequestEntry, isAgentView, isRangeKey, readAgentRequestEntry, readAgentStats, readSessionTrace, statsDbPath } from '../extensions/shared/agent-stats.js';
 const DASHBOARD_DIST = path.join(findPackageRoot(path.dirname(fileURLToPath(import.meta.url))), 'dashboard', 'dist');
 const DASHBOARD_INDEX = path.join(DASHBOARD_DIST, 'index.html');
@@ -51,9 +51,12 @@ async function brandDataUri() {
 }
 /** The range a page opens on, matching the reference dashboard. */
 const DEFAULT_AGENT_RANGE = '24h';
-/** The omp aggregate spawns a sqlite3 process per query group, so a repeat poll reuses it. */
+/** Poll memo TTL: every poll re-reads the aggregate, so a repeat poll reuses the last answer. */
 const AGENT_REFRESH_MS = 5000;
+/** A sync walks every transcript, so it runs at most this often even while a poll outruns it. */
+const AGENT_SYNC_MS = 15_000;
 let agentMemo = null;
+let lastSyncAt = 0;
 function fileStamp(file) {
     try {
         const stat = statSync(file);
@@ -63,15 +66,25 @@ function fileStamp(file) {
         return '-';
     }
 }
-/** Reads the omp databases, unless the same window and view were read recently and nothing moved. */
-function agentStats(range, view = 'all') {
-    const stamp = `${fileStamp(statsDbPath())}|${fileStamp(agentDbPath())}`;
+/** Both sources: the usage store carries every host's rows, agent.db only omp's quota snapshots. */
+function storeStamp() {
+    return `${fileStamp(statsDbPath())}|${fileStamp(agentDbPath())}`;
+}
+/** Syncs before reading past the throttle; without it a page misses pi and OpenCode rows. */
+function agentStats(range, view = 'all', offset = 0) {
     const held = agentMemo;
-    if (held && held.range === range && held.view === view && held.stamp === stamp && Date.now() - held.at < AGENT_REFRESH_MS) {
+    if (held && held.range === range && held.view === view && held.offset === offset && held.stamp === storeStamp() && Date.now() - held.at < AGENT_REFRESH_MS) {
         return held.value;
     }
-    const value = readAgentStats(range, view);
-    agentMemo = { range, view, stamp, at: Date.now(), value };
+    if (Date.now() - lastSyncAt >= AGENT_SYNC_MS) {
+        lastSyncAt = Date.now();
+        try {
+            syncUsageDb();
+        }
+        catch { /* a store that will not write still reads the rows it already holds */ }
+    }
+    const value = readAgentStats(range, view, Date.now(), offset);
+    agentMemo = { range, view, offset, stamp: storeStamp(), at: Date.now(), value };
     return value;
 }
 /** `?range=` on any of the omp routes; an unknown value falls back to the default. */
@@ -86,8 +99,14 @@ function viewFrom(url) {
     const raw = queryParam(url, 'view');
     return isAgentView(raw) ? raw : 'all';
 }
-function agentJson(range, view) {
-    return JSON.stringify({ range, view, agent: agentStats(range, view) });
+/** `?offset=` in whole rows, floored; a later page starts further back instead of clamping at the cap. */
+function offsetFrom(url) {
+    const raw = queryParam(url, 'offset');
+    const value = raw === null ? 0 : Number(raw);
+    return Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+}
+function agentJson(range, view, offset) {
+    return JSON.stringify({ range, view, offset, agent: agentStats(range, view, offset) });
 }
 // Runs outside any agent session, so it reports the persisted defaults.
 async function statusJson() {
@@ -98,6 +117,7 @@ async function statusJson() {
         caveman: profile.cavemanDefault,
         rtk: profile.rtkDefault ? 'on' : 'off',
         ponytail: profile.ponytailDefault,
+        pstack: profile.pstackDefault,
     });
 }
 // Local-only health: find each agent on PATH, run `--version`, report both.
@@ -282,18 +302,29 @@ 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', true, '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.
+    addon('Unique config registrations', duplicateExtensions.length === 0, duplicateExtensions.length ? duplicateExtensions.join(', ') : 'ok', 'Extensions');
+    // A listed extension whose file is gone makes the host warn on every load, so surface it here.
     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'));
-    const rule = path.join(tersioPluginDir, 'extensions', 'caveman-session', 'rule.md');
+    ext('Caveman extension', path.join(tersioPluginDir, 'extensions', 'caveman', 'index.ts'));
+    ext('pstack extension', path.join(tersioPluginDir, 'extensions', 'pstack', 'index.ts'));
+    ext('RTK extension', path.join(tersioPluginDir, 'extensions', 'rtk', 'session.ts'));
+    const rule = path.join(tersioPluginDir, 'extensions', 'caveman', 'rule.md');
     const ruleAge = ageStr(rule);
     const ruleAt = absTime(rule);
     addon('Caveman rule', ruleAge !== null, ruleAge && ruleAt ? `(updated ${ruleAge} · ${ruleAt})` : rule);
+    // The pstack body is a Tersio fork with no remote, so this row proves it is usable, not current.
+    const pstackRule = path.join(tersioPluginDir, 'extensions', 'pstack', 'rule.md');
+    let pstackProblem = 'missing — run: tersio install';
+    try {
+        pstackProblem = ruleBodyProblem(readFileSync(pstackRule, 'utf8'));
+    }
+    catch { /* missing stays */ }
+    const pstackAge = ageStr(pstackRule);
+    const pstackAt = absTime(pstackRule);
+    addon('pstack rule', pstackProblem === null, pstackProblem ?? `(updated ${pstackAge} · ${pstackAt})`);
     const rtkVer = rtkBin ? rtkVersion(rtkBin) : null;
     const rtkAge = rtkBin ? ageStr(rtkBin) : null;
     const rtkAt = rtkBin ? absTime(rtkBin) : null;
@@ -314,7 +345,7 @@ function computeDoctorRows() {
     addon('Prices feed', pricesAge !== null, pricesAge && pricesAt ? `(pulled ${pricesAge} · ${pricesAt})` : prices, 'Usage');
     return rows;
 }
-// Recompute when forced, missing, or past the schedule; a report holding a retired label is stale by definition.
+// A report holding any of these labels is stale by definition.
 const RETIRED_DIAG_LABELS = new Set([
     'OMP CLI',
     'Tersio CLI',
@@ -335,11 +366,10 @@ const RETIRED_DIAG_LABELS = new Set([
 function isRetiredReport(report) {
     return report.rows.some((r) => RETIRED_DIAG_LABELS.has(r.label));
 }
-// Recompute when forced, missing, retired, or past the schedule.
+// Recompute when forced, missing, retired, or past schedule; manual schedules recompute on open, dated ones reuse.
 function getDoctorReport(force) {
     const saved = readDiagReport();
     const ttl = saved ? DIAG_TTL_MS[saved.schedule] : 0;
-    // Manual recomputes on open; a dated schedule reuses the saved report.
     if (!force && saved && !isRetiredReport(saved) && ttl > 0 && Date.now() - saved.checkedAt < ttl)
         return saved;
     const report = { rows: computeDoctorRows(), checkedAt: Date.now(), schedule: saved?.schedule ?? 'manual' };
@@ -373,6 +403,12 @@ async function saveDefaults(body) {
             return { ok: false, error: 'unknown ponytail level' };
         profile.ponytailDefault = v;
     }
+    if (body.pstackDefault !== undefined) {
+        const v = String(body.pstackDefault);
+        if (!PSTACK_DEFAULTS.has(v))
+            return { ok: false, error: 'unknown pstack level' };
+        profile.pstackDefault = v;
+    }
     if (body.backupSchedule !== undefined) {
         const v = String(body.backupSchedule);
         if (!BACKUP_SCHEDULES.has(v))
@@ -392,6 +428,7 @@ async function saveDefaults(body) {
             cavemanDefault: profile.cavemanDefault,
             rtkDefault: profile.rtkDefault,
             ponytailDefault: profile.ponytailDefault,
+            pstackDefault: profile.pstackDefault,
             backupSchedule: profile.backupSchedule,
         },
     };
@@ -423,7 +460,7 @@ function openBrowser(url) {
     const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
     spawn(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
 }
-// Replacers throughout: session data holds `$'` (shell quoting) and literal `</script>`, which String.replace would mangle.
+// Replacers throughout: session data holds `$'` (shell quoting) and `</script>`, which String.replace would mangle.
 function escapeInline(json) {
     return json.replace(/<\/(script)/gi, '<\\/$1');
 }
@@ -444,20 +481,13 @@ function parseOwnJson(json, field) {
 async function exportDashboard(exportFile, currency) {
     requireDashboardBundle();
     const [bundle, icon] = await Promise.all([readSegment(DASHBOARD_INDEX), brandDataUri()]);
-    // The bundle is minified, so the brand fetch reaches the file as `fetch(\`brand.webp\`)` or
-    // `fetch("brand.webp")` depending on the bundler's quote choice. Match either, or the exported
-    // card silently loses its mark. `atob` returns one char per byte, and a Blob encodes a string
-    // as UTF-8, so the bytes go through a Uint8Array first: a webp is binary and every byte at or
-    // above 0x80 would otherwise double and corrupt the image.
+    // Minified: fetch reads `fetch(\`brand.webp\`)` or `fetch("brand.webp")`; a mismatch loses the card's mark.
     const b64 = icon.split(',')[1] ?? '';
-    // atob yields one char per byte; a Blob encodes a string as UTF-8, so the bytes pass through a
-    // Uint8Array or every byte at or above 0x80 doubles and the webp comes out corrupt.
+    // atob yields one byte per char, so a Uint8Array is needed or bytes >= 0x80 double and corrupt the webp.
     const brandBytes = `(() => { const c = atob(${JSON.stringify(b64)}); const v = new Uint8Array(c.length); for (let i = 0; i < c.length; i++) v[i] = c.charCodeAt(i); return v; })()`;
     const inline = bundle
         .replace('window.__TERSIO_SNAP = null;', () => `window.__TERSIO_SNAP = ${escapeInline(JSON.stringify({ currency, agent: agentStats(DEFAULT_AGENT_RANGE), health: parseOwnJson(healthJson(), 'health'), doctor: getDoctorReport(false) }))};`)
-        // A mark reaches the bundle three ways: an HTML attribute in `index.html`, and a JSX prop
-        // esbuild compiled with a backtick. Match any of `"`, `'`, and `` ` ``, or an exported file
-        // keeps a bare reference that file:// cannot resolve.
+        // A mark is an HTML attribute or JSX prop; match every quote or the file keeps an unresolvable reference.
         .replace(/((?:src|href)[=:][ \t]*)([`"'])brand\.webp\2/g, (_all, head, quote) => `${head}${quote}${icon}${quote}`)
         .replace(/fetch\(([`"])brand\.webp\1\)/g, () => `Promise.resolve({ ok: true, blob: async () => new Blob([${brandBytes}], { type: "image/webp" }) })`);
     await fs.writeFile(exportFile, inline, 'utf8');
@@ -492,7 +522,7 @@ async function runDashboard(options) {
             }
             const action = String(body.action ?? '');
             const name = String(body.name ?? '');
-            // A missing sqlite3, or a locked file, is a 500 with a message rather than a silent no-op.
+            // A missing SQLite engine, or a locked file, is a 500 with a message rather than a silent no-op.
             try {
                 if (action === 'create') {
                     const made = await createDataBackup();
@@ -530,6 +560,7 @@ async function runDashboard(options) {
                     cavemanDefault: profile.cavemanDefault,
                     rtkDefault: profile.rtkDefault,
                     ponytailDefault: profile.ponytailDefault,
+                    pstackDefault: profile.pstackDefault,
                     backupSchedule: profile.backupSchedule,
                     currency: options.currency,
                 }));
@@ -576,7 +607,7 @@ async function runDashboard(options) {
         }
         if (req.url === '/api/agent' || req.url?.startsWith('/api/agent?')) {
             res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(agentJson(rangeFrom(req.url), viewFrom(req.url)));
+            res.end(agentJson(rangeFrom(req.url), viewFrom(req.url), offsetFrom(req.url)));
             return;
         }
         if (req.url?.startsWith('/api/agent/session')) {
@@ -691,4 +722,4 @@ async function runDashboard(options) {
         });
     });
 }
-export { runDashboard, saveDashboardCurrency, readDiagSchedule, setDiagSchedule };
+export { runDashboard, saveDashboardCurrency, readDiagSchedule, setDiagSchedule, offsetFrom };