switchroom 0.20.13 → 0.20.14

package/dist/cli/switchroom.js

@@ -2120,7 +2120,7 @@ var init_esm = __esm(() => {
 });
 
 // src/build-info.ts
-var VERSION = "0.20.13", COMMIT_SHA = "a73b0fd2";
+var VERSION = "0.20.14", COMMIT_SHA = "acb44b7f";
 
 // src/cli/resolve-version.ts
 import { existsSync, readFileSync } from "node:fs";
@@ -128794,6 +128794,8 @@ function buildBankMap(result) {
     push(c.bank);
   for (const a of result.arms ?? [])
     push(a.bank);
+  for (const p of result.phases ?? [])
+    push(p.bank);
   const width = Math.max(2, String(ordered.length).length);
   const map2 = new Map;
   ordered.forEach((bank, i2) => map2.set(bank, pseudonym(i2 + 1, width)));
@@ -128812,7 +128814,8 @@ function anonymiseResult(result) {
         bankRows: (result.db?.bankRows ?? []).map((r) => ({ ...r, bank: sub(r.bank) }))
       },
       cells: (result.cells ?? []).map((c) => ({ ...c, bank: sub(c.bank) })),
-      arms: result.arms === null ? null : result.arms.map((a) => ({ ...a, bank: sub(a.bank) }))
+      arms: (result.arms ?? null)?.map((a) => ({ ...a, bank: sub(a.bank) })) ?? null,
+      phases: (result.phases ?? null)?.map((p) => ({ ...p, bank: sub(p.bank) })) ?? null
     }
   };
 }
@@ -128952,6 +128955,18 @@ function assertReadOnlyOrWritesAllowed(allowWrites, opts = {}) {
     throw new SqlError("refusing to run: the harness's database session is WRITABLE " + `(transaction_read_only=${declared ?? "?"}, temp-table write ${writeLanded ? "succeeded" : "failed"}). ` + "This harness measures a read path and must not be able to mutate a bank. " + "Pass --allow-writes only if you genuinely intend a writable session " + "(contention profile `write` needs one for its own scratch table).");
   }
 }
+function readStatsEpoch(opts = {}) {
+  const rows = sql(`SELECT
+       (SELECT stats_reset::text FROM pg_stat_database WHERE datname = current_database()),
+       (SELECT CASE WHEN heap_blks_hit + heap_blks_read = 0 THEN NULL
+                    ELSE heap_blks_hit::float8 / (heap_blks_hit + heap_blks_read) END
+          FROM pg_statio_user_tables WHERE relname = 'memory_units');`, opts);
+  const f = (rows[0] ?? "").split("|");
+  return {
+    statsResetAt: (f[0] ?? "") === "" ? null : f[0],
+    heapHitRatio: (f[1] ?? "") === "" ? null : num3(f[1])
+  };
+}
 function resetStats(opts = {}) {
   sql("SELECT pg_stat_reset();", { ...opts, writable: true });
 }
@@ -129546,9 +129561,35 @@ function formatSummary(r) {
       L.push(`  ${pad5(a.bank, 16)}${pad5(a.method, 12)}${pad5(a.fact_type, 12)}${padL(String(a.n), 5)}` + `${padL(a.p50.toFixed(1), 9)}${padL(a.p95.toFixed(1), 9)}`);
     }
   }
+  L.push(...formatPhases(r.phases ?? null));
   return L.join(`
 `);
 }
+function formatPhases(phases) {
+  if (phases === null || phases.length === 0)
+    return [];
+  const L = [];
+  L.push("");
+  L.push("  phase attribution (SEPARATE traced pass \u2014 not comparable to the latency table above)");
+  L.push(`  ${pad5("bank", 16)}${padL("conc", 6)}${padL("n", 5)}${padL("client ms", 11)}${padL("server ms", 11)}` + `${padL("db ms", 9)}${padL("db/server", 11)}${padL("max gain", 10)}`);
+  for (const c of phases) {
+    L.push(`  ${pad5(c.bank, 16)}${padL(String(c.concurrency), 6)}${padL(String(c.n), 5)}` + `${padL(c.clientMsMean.toFixed(0), 11)}${padL(c.serverMsMean.toFixed(0), 11)}` + `${padL(c.dbMsMean.toFixed(0), 9)}${padL(`${round(c.dbShareOfServer * 100, 1)}%`, 11)}` + `${padL(`${round(c.maxDbSideGainFraction * 100, 1)}%`, 10)}`);
+  }
+  const worst = Math.max(...phases.map((c) => c.maxDbSideGainFraction));
+  L.push("");
+  L.push(`  ceiling: a PERFECT database (every PostgreSQL call instantaneous) removes at most ` + `${round(worst * 100, 1)}% of end-to-end recall latency, at the most database-bound cell measured.`);
+  L.push("  Any database-side proposal claiming more than that is refuted by this number.");
+  const totals = new Map;
+  for (const c of phases) {
+    for (const p of c.phases)
+      totals.set(p.name, (totals.get(p.name) ?? 0) + p.meanMs);
+  }
+  const ranked = [...totals.entries()].sort((a, b) => b[1] - a[1]).slice(0, 4);
+  if (ranked.length > 0) {
+    L.push(`  largest phases by mean time across all cells: ${ranked.map(([n]) => n).join(", ")}`);
+  }
+  return L;
+}
 function formatReproducibility(rep) {
   const L = [];
   L.push(`reproducibility (AC1) \u2014 tolerance \u00b1${round(rep.tolerance * 100, 0)}% on p95 per cell`);
@@ -129615,6 +129656,71 @@ function toCsv(r) {
 `);
 }
 
+// src/hindsight-bench/phases.ts
+var DB_PHASES = ["parallel_retrieval"];
+var DB_DIAGNOSTIC_PHASES = ["connection_wait"];
+function isDiagnosticPhase(entry) {
+  const details = entry?.details;
+  return details?.diagnostic === true;
+}
+function extractPhases(trace) {
+  const summary = trace?.summary;
+  const totalS = Number(summary?.total_duration_seconds);
+  const raw = summary?.phase_metrics;
+  const phases = new Map;
+  const diagnostics = new Map;
+  if (Array.isArray(raw)) {
+    for (const entry of raw) {
+      const name = entry?.phase_name;
+      const secs = Number(entry?.duration_seconds);
+      if (typeof name !== "string" || name === "" || !Number.isFinite(secs))
+        continue;
+      const into = isDiagnosticPhase(entry) ? diagnostics : phases;
+      into.set(name, (into.get(name) ?? 0) + secs * 1000);
+    }
+  }
+  return { serverMs: Number.isFinite(totalS) ? totalS * 1000 : 0, phases, diagnostics };
+}
+function reducePhaseCell(bank, rows, concurrency, samples, errors4) {
+  if (samples.length === 0)
+    return null;
+  const clientMsMean = mean(samples.map((s) => s.clientMs));
+  const serverMsMean = mean(samples.map((s) => s.extracted.serverMs));
+  const names = new Set;
+  for (const s of samples)
+    for (const n of s.extracted.phases.keys())
+      names.add(n);
+  const phases = [];
+  for (const name of [...names].sort()) {
+    const vals = samples.map((s) => s.extracted.phases.get(name) ?? 0);
+    const st = summarize(vals, 0);
+    phases.push({
+      name,
+      meanMs: st.mean,
+      p95Ms: st.p95,
+      shareOfServer: serverMsMean > 0 ? st.mean / serverMsMean : 0
+    });
+  }
+  phases.sort((a, b) => b.meanMs - a.meanMs);
+  const dbMsMean = DB_PHASES.reduce((acc, name) => acc + mean(samples.map((s) => s.extracted.phases.get(name) ?? 0)), 0) + DB_DIAGNOSTIC_PHASES.reduce((acc, name) => acc + mean(samples.map((s) => s.extracted.diagnostics.get(name) ?? 0)), 0);
+  return {
+    bank,
+    rows,
+    concurrency,
+    n: samples.length,
+    errors: errors4,
+    clientMsMean,
+    serverMsMean,
+    dbMsMean,
+    dbShareOfServer: serverMsMean > 0 ? dbMsMean / serverMsMean : 0,
+    maxDbSideGainFraction: clientMsMean > 0 ? dbMsMean / clientMsMean : 0,
+    phases
+  };
+}
+function mean(xs) {
+  return xs.length === 0 ? 0 : xs.reduce((a, b) => a + b, 0) / xs.length;
+}
+
 // src/hindsight-bench/run.ts
 var MAX_ERROR_SAMPLES = 5;
 var realSleep = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -129724,6 +129830,43 @@ async function runArmSweep(opts) {
   rows.sort((a, b) => a.bank.localeCompare(b.bank) || b.p50 - a.p50);
   return rows;
 }
+async function runPhaseSweep(opts) {
+  const { config: config2, db } = opts;
+  const deps = opts.deps ?? {};
+  const sleep5 = deps.sleep ?? realSleep;
+  const log = deps.log ?? (() => {});
+  const settleMs = opts.settleMs ?? 2000;
+  const recall = deps.recall ?? ((bank, query) => recallOnce(bank, query, {
+    apiUrl: config2.apiUrl,
+    timeoutMs: config2.timeoutMs,
+    budget: config2.budget,
+    maxTokens: config2.maxTokens,
+    trace: true
+  }));
+  const rowsFor = new Map(db.bankRows.map((b) => [b.bank, b.rows]));
+  const out = [];
+  for (const bank of config2.banks) {
+    for (const concurrency of [...config2.concurrency].sort((a, b) => a - b)) {
+      const count = Math.max(opts.samples, concurrency);
+      const raw = await driveCell(bank, concurrency, count, recall);
+      const ok = raw.filter((s) => s.ok);
+      const samples = ok.map((s) => ({
+        clientMs: s.ms,
+        extracted: extractPhases(s.trace)
+      }));
+      const cell = reducePhaseCell(bank, rowsFor.get(bank) ?? 0, concurrency, samples, raw.length - ok.length);
+      if (cell === null) {
+        log(`  phases: ${bank} c=${concurrency}: no successful traced calls`);
+      } else {
+        out.push(cell);
+        log(`  phases: ${bank} c=${concurrency}: n=${cell.n} db=${(cell.dbShareOfServer * 100).toFixed(1)}% of server, ` + `max end-to-end gain from a perfect DB = ${(cell.maxDbSideGainFraction * 100).toFixed(1)}%`);
+      }
+      if (settleMs > 0)
+        await sleep5(settleMs);
+    }
+  }
+  return out;
+}
 
 // src/hindsight-bench/types.ts
 var BENCH_SCHEMA_VERSION = 2;
@@ -129777,7 +129920,7 @@ function intOpt(raw, name) {
   return n;
 }
 function registerHindsightBenchCommand(program3) {
-  program3.command("hindsight-bench").description("Measure Hindsight recall latency as a function of bank size and concurrency. " + "Percentiles, not means. Read-only by default; --contention degrades the live box.").option("--api-url <url>", "Hindsight REST base", DEFAULT_API_URL).option("--container <name>", "hindsight container for the psql probes", DEFAULT_CONTAINER2).option("--banks <spec>", "all | top:<n> | spread:<n> | comma list", "spread:5").option("--concurrency <list>", "comma-separated concurrency levels", "1,4,8,16").option("--samples <n>", "recorded recalls per cell", "60").option("--warmup <n>", "discarded recalls per cell before recording", "8").option("--timeout-ms <ms>", "per-recall timeout", "30000").option("--settle-ms <ms>", "quiet period between cells", "2000").option("--budget <budget>", "recall budget", "mid").option("--max-tokens <n>", "recall max_tokens", "4096").option("--contention [profile]", "run the sweep under synthetic load: read (cache churn, SELECT-only) or " + "write (adds a WAL storm against a harness-owned scratch table; needs --allow-writes)").option("--contention-workers <n>", "concurrent load backends", String(DEFAULT_CONTENTION.workers)).option("--contention-scan-pct <pct>", "TABLESAMPLE percentage per churn scan", String(DEFAULT_CONTENTION.scanPct)).option("--contention-max-seconds <s>", "absolute in-SQL deadline for every load backend (orphan guard)", String(DEFAULT_CONTENTION.maxSeconds)).option("--reset-stats", "call pg_stat_reset() before the sweep (never implicit)", false).option("--allow-writes", "authorise a writable database session (AC5 gate)", false).option("--arms [n]", "additionally run a traced per-arm attribution pass (n samples/bank, default 5)").option("--label <text>", "free-form label recorded in the result file", "").option("--out <path>", "write the JSON result file (or the SVG in --plot mode)").option("--csv <path>", "also write a flat per-cell CSV").option("--plot <files...>", "render the chart from result files instead of measuring").option("--compare <files...>", "AC1 reproducibility verdict over two result files").option("--contention-compare <files...>", "AC4 contention verdict over two result files").option("--tolerance <fraction>", "AC1 tolerance", String(DEFAULT_TOLERANCE)).option("--json", "emit machine-readable JSON for the verdict modes", false).action(async (opts) => {
+  program3.command("hindsight-bench").description("Measure Hindsight recall latency as a function of bank size and concurrency. " + "Percentiles, not means. Read-only by default; --contention degrades the live box.").option("--api-url <url>", "Hindsight REST base", DEFAULT_API_URL).option("--container <name>", "hindsight container for the psql probes", DEFAULT_CONTAINER2).option("--banks <spec>", "all | top:<n> | spread:<n> | comma list", "spread:5").option("--concurrency <list>", "comma-separated concurrency levels", "1,4,8,16").option("--samples <n>", "recorded recalls per cell", "60").option("--warmup <n>", "discarded recalls per cell before recording", "8").option("--timeout-ms <ms>", "per-recall timeout", "30000").option("--settle-ms <ms>", "quiet period between cells", "2000").option("--budget <budget>", "recall budget", "mid").option("--max-tokens <n>", "recall max_tokens", "4096").option("--contention [profile]", "run the sweep under synthetic load: read (cache churn, SELECT-only) or " + "write (adds a WAL storm against a harness-owned scratch table; needs --allow-writes)").option("--contention-workers <n>", "concurrent load backends", String(DEFAULT_CONTENTION.workers)).option("--contention-scan-pct <pct>", "TABLESAMPLE percentage per churn scan", String(DEFAULT_CONTENTION.scanPct)).option("--contention-max-seconds <s>", "absolute in-SQL deadline for every load backend (orphan guard)", String(DEFAULT_CONTENTION.maxSeconds)).option("--reset-stats", "call pg_stat_reset() before the sweep (never implicit)", false).option("--allow-writes", "authorise a writable database session (AC5 gate)", false).option("--arms [n]", "additionally run a traced per-arm attribution pass (n samples/bank, default 5)").option("--phases [n]", "additionally run a traced phase-attribution pass over the full concurrency ladder " + "(n samples/cell, default 8); reports how much end-to-end latency a perfect database could remove").option("--label <text>", "free-form label recorded in the result file", "").option("--out <path>", "write the JSON result file (or the SVG in --plot mode)").option("--csv <path>", "also write a flat per-cell CSV").option("--plot <files...>", "render the chart from result files instead of measuring").option("--compare <files...>", "AC1 reproducibility verdict over two result files").option("--contention-compare <files...>", "AC4 contention verdict over two result files").option("--tolerance <fraction>", "AC1 tolerance", String(DEFAULT_TOLERANCE)).option("--json", "emit machine-readable JSON for the verdict modes", false).action(async (opts) => {
     if (opts.plot !== undefined)
       return runPlotMode(opts);
     if (opts.compare !== undefined)
@@ -129856,6 +129999,7 @@ async function runMeasureMode(opts) {
       resetStats(sqlOpts);
       process.stderr.write(`${source_default.yellow("!")} pg_stat_reset() called \u2014 cumulative statistics were discarded
 `);
+      db = { ...db, ...readStatsEpoch(sqlOpts) };
     } catch (e) {
       fail9(`--reset-stats failed: ${e.message}`);
     }
@@ -129881,6 +130025,9 @@ async function runMeasureMode(opts) {
   const armSamples = opts.arms === undefined ? 0 : opts.arms === true || opts.arms === "" ? 5 : Number(opts.arms);
   if (!Number.isFinite(armSamples) || armSamples < 0)
     fail9(`--arms must be a non-negative integer`);
+  const phaseSamples = opts.phases === undefined ? 0 : opts.phases === true || opts.phases === "" ? 8 : Number(opts.phases);
+  if (!Number.isFinite(phaseSamples) || phaseSamples < 0)
+    fail9(`--phases must be a non-negative integer`);
   process.stderr.write(`sweeping ${banks.length} bank(s) \u00d7 ${concurrency.length} concurrency level(s) = ` + `${banks.length * concurrency.length} cells, ${config2.samples} samples each ` + `(+${config2.warmup} warm-up) \u00b7 contention=${profile}
 `);
   const t0 = Date.now();
@@ -129914,6 +130061,14 @@ async function runMeasureMode(opts) {
     });
     const arms = armSamples > 0 ? await runArmSweep({ config: config2, samples: armSamples, deps: { log: (m) => process.stderr.write(`${m}
 `) } }) : null;
+    const phases = phaseSamples > 0 ? await runPhaseSweep({
+      config: config2,
+      db,
+      samples: phaseSamples,
+      settleMs: intOpt(opts.settleMs, "--settle-ms"),
+      deps: { log: (m) => process.stderr.write(`${m}
+`) }
+    }) : null;
     result = {
       schema: BENCH_SCHEMA_VERSION,
       config: config2,
@@ -129921,6 +130076,7 @@ async function runMeasureMode(opts) {
       instance,
       cells,
       arms,
+      phases,
       durationS: (Date.now() - t0) / 1000
     };
   } finally {

package/dist/host-control/main.js

@@ -21559,7 +21559,7 @@ function allocateAgentUid(name) {
 }
 
 // src/build-info.ts
-var VERSION = "0.20.13";
+var VERSION = "0.20.14";
 
 // src/setup/hindsight-recall-passthrough.ts
 var HINDSIGHT_RECALL_TAG_WEIGHT_SEED = Object.freeze({ sidechain: 0.8 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "switchroom",
   "//version": "NOT the release version — source of truth is the git tag, resolved by scripts/build.mjs:resolveVersion() (see CLAUDE.md > Standard release process). This field is stale by design and only the Layer-4 dev/non-tag fallback for build.mjs + src/cli/resolve-version.ts; do NOT bump it expecting a release to pick it up. npm-pack tarball naming needs a real version — do that as an UNCOMMITTED pack-time bump (see release step 6), never a committed one.",
-  "version": "0.20.13",
+  "version": "0.20.14",
   "description": "Run Claude Code 24/7 on your Claude Pro/Max subscription over Telegram. Open-source alternative to OpenClaw and NanoClaw — no API keys.",
   "type": "module",
   "bin": {

package/telegram-plugin/dist/gateway/gateway.js

@@ -103438,10 +103438,10 @@ function startOutboxSweep(deps) {
 }
 
 // ../src/build-info.ts
-var VERSION2 = "0.20.13";
-var COMMIT_SHA = "a73b0fd2";
-var COMMIT_DATE = "2026-08-07T03:01:37Z";
-var LATEST_PR = 4502;
+var VERSION2 = "0.20.14";
+var COMMIT_SHA = "acb44b7f";
+var COMMIT_DATE = "2026-08-07T07:09:13Z";
+var LATEST_PR = 4505;
 var COMMITS_AHEAD_OF_TAG = 0;
 
 // gateway/boot-version.ts