cc-viewer 1.7.11 → 1.7.13

package/dist/index.html

@@ -21,7 +21,7 @@
     // 整体显示大小已弃用 CSS zoom：Electron 改用 webFrame.setZoomFactor（首屏抢占见
     // electron/tab-content-preload.js），纯浏览器交由用户用浏览器自带快捷键缩放，故此处不再设 zoom。
   </script>
-  <script type="module" crossorigin src="./assets/index-gH_W4sVT.js"></script>
+  <script type="module" crossorigin src="./assets/index-DSTQIMmZ.js"></script>
   <link rel="modulepreload" crossorigin href="./assets/vendor-antd-DADYo_zg.js">
   <link rel="modulepreload" crossorigin href="./assets/vendor-codemirror-tF6HNoR6.js">
   <link rel="modulepreload" crossorigin href="./assets/vendor-mdxeditor-CFAmRN3Y.js">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-viewer",
-  "version": "1.7.11",
+  "version": "1.7.13",
   "description": "Claude Code logging, visualization, and management toolkit — launch a web viewer alongside Claude Code with full request/response tracing, proxy, and mobile support",
   "license": "MIT",
   "main": "server.js",

package/server/lib/context-rules.js

@@ -27,6 +27,29 @@ export function parseContextSizeSuffix(modelName) {
   return m[2].toLowerCase() === 'm' ? num * 1000000 : num * 1000;
 }
 
+/**
+ * Resolve the model name to use for context-window classification (血条窗口判定专用).
+ *
+ * Precedence differs from getEffectiveModel (response-first) on one deliberate
+ * point: an EXPLICIT [Nk]/[Nm] suffix on the REQUEST model (`body.model`, which
+ * carries the user's hot-switch config / model selector intent) is authoritative
+ * and must NOT be overridden by the upstream response. Upstream APIs normalize
+ * the response `model` — e.g. hot-switching to `k3[1m]` makes Moonshot return
+ * `response.body.model: "k3"`, stripping the [1m] marker; a response-first read
+ * would then misclassify the window (bare k3 vs the configured 1M). So: request
+ * suffix wins; otherwise fall back to the response model, then the request name.
+ *
+ * @param {object|null|undefined} request log entry with body / response
+ * @returns {string|null}
+ */
+export function getCalibrationModel(request) {
+  const reqModel = request?.body?.model;
+  if (typeof reqModel === 'string' && parseContextSizeSuffix(reqModel) != null) return reqModel;
+  const respModel = request?.response?.body?.model;
+  if (typeof respModel === 'string' && respModel) return respModel;
+  return (typeof reqModel === 'string' && reqModel) ? reqModel : null;
+}
+
 // 模型家族 → 窗口档位表(有序,首条命中)。后缀解析在表外先行(见 getModelMaxTokens)。
 const MODEL_CONTEXT_SIZES = [
   // haiku 全系 200K,显式置于一切 1M 默认之前(claude-haiku-4-5 等)
@@ -48,6 +71,10 @@ const MODEL_CONTEXT_SIZES = [
   { match: /gpt-4o|o1|o3|o4/i, tokens: 128000 },
   { match: /gpt-4/i, tokens: 128000 },
   { match: /gpt-3/i, tokens: 16000 },
+  // Kimi 家族精确档:k2.x/k3 等带 kimi/moonshot 前缀的 → 256K;裸 'k3'(无前缀,
+  // 代理直连时的简写 model 名)→ 256K 精确档但 classifyContextWindow 不升 1M
+  // (见该函数的家族特判,裸 k3 归 200K 桶,超量由 adaptContextWindow 纠偏)。
+  { match: /kimi|moonshot|^k3$/i, tokens: 256000 },
   // deepseek-v4 defaults to 1M; placed before generic /deepseek/ so the
   // first-match-wins loop picks it up before falling through to 128K.
   { match: /deepseek-v4/i, tokens: 1000000 },
@@ -74,12 +101,19 @@ export function getModelMaxTokens(modelName) {
  * 不变量:只返回 1000000 或 200000(resolveCalibrationTokens 依赖此不变量)。
  * 裸 '1m' 子串(无方括号,如 deepseek-v3-1m)→ 1M 的宽松规则仅限本分类器,
  * 刻意不进 getModelMaxTokens(后者面向精确档位)。128K/16K 档归入 200K 桶。
+ * Kimi 家族特判:kimi/moonshot 前缀型号(k2.x/k3,真实窗口 256K)归 1M 桶 ——
+ * 避免会话中段从 200K 重标定到 256K/1M 的跳变;代价是相对真实 256K 上限
+ * 长期低估(约 4 倍刻度),可接受。裸 'k3' 同样归 1M:代理热切换到
+ * 'k3[1m]' 时上游会把响应 model 归一化成裸 'k3'(剥掉 [1m] 后缀),
+ * response-first 解析读到裸 'k3' 若归 200K 桶会与请求侧 1M 判定分裂,
+ * 血条分母错成 200K;且裸 'k3' 本就是 k3[1m] 的 1M 形态被剥后缀的产物。
  * @param {string} modelName
  * @returns {1000000|200000}
  */
 export function classifyContextWindow(modelName) {
   if (!modelName || typeof modelName !== 'string') return 200000;
   if (modelName.toLowerCase().includes('1m')) return 1000000;
+  if (/kimi|moonshot|^k3$/i.test(modelName)) return 1000000;
   return getModelMaxTokens(modelName) >= 1000000 ? 1000000 : 200000;
 }
 
@@ -88,7 +122,9 @@ export function classifyContextWindow(modelName) {
  * 一个真正的 200K 模型,其输入上下文(input + cache_creation + cache_read)物理上不可能
  * 超过 200K —— 超了 API 直接拒收。所以一旦真实输入用量越过 200K 还被判成 200K,必然是
  * model 名识别错了(误判),此时自动升到 1M,免得血条卡死在 100%、百分比与真实进度脱节。
- * 仅做 200K→1M 这一个方向的纠偏;其余判定(1M、各家 200K 真值等)一律原样返回。
+ * One-way upgrades only: 200K→1M and 256K→1M (the kimi exact tier used by the
+ * server-side SSE path); every other classification (1M, 128K/16K tiers, true
+ * 200K values) is returned unchanged — 128K is deliberately never promoted.
  * 注意:usedContextTokens 必须是"输入侧"用量(sumUsageInputTokens,不含 output_tokens),
  * 否则大输出会误触发。
  * @param {number} classifiedTokens classifyContextWindow / getModelMaxTokens 的结果
@@ -97,6 +133,7 @@ export function classifyContextWindow(modelName) {
  */
 export function adaptContextWindow(classifiedTokens, usedContextTokens) {
   if (classifiedTokens === 200000 && usedContextTokens > 200000) return 1000000;
+  if (classifiedTokens === 256000 && usedContextTokens > 256000) return 1000000;
   return classifiedTokens;
 }
 

package/server/lib/context-watcher.js

@@ -2,7 +2,7 @@ import { readFileSync, existsSync, realpathSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { getClaudeConfigDir } from '../../findcc.js';
-import { getModelMaxTokens, adaptContextWindow, sumUsageInputTokens, sumUsageContextTokens } from './context-rules.js';
+import { getModelMaxTokens, adaptContextWindow, sumUsageInputTokens, sumUsageContextTokens, getCalibrationModel } from './context-rules.js';
 
 export const CONTEXT_WINDOW_FILE = join(getClaudeConfigDir(), 'context-window.json');
 export const CLAUDE_SETTINGS_FILE = join(getClaudeConfigDir(), 'settings.json');
@@ -43,10 +43,25 @@ export function readModelContextSize() {
 /**
  * Get context size for a given API model name (e.g. 'claude-opus-4-6-20250514').
  * Uses startup cache to avoid re-reading the file.
- * @param {string} apiModelName - model name from req.body.model
+ * Accepts either a bare model-name string (legacy path) or a full log entry.
+ * Entry input resolves the model via getCalibrationModel (context-rules.js):
+ * an explicit [Nk]/[Nm] suffix on the REQUEST model wins (the user's hot-switch
+ * config intent, e.g. k3[1m]); otherwise the upstream response.body.model is
+ * authoritative. The startup cache is request-side static info, stale after a
+ * hot-switch, so entry resolution skips it and goes straight to the family
+ * rules table. String input keeps legacy cache-first behavior unchanged.
+ * @param {string|object} modelOrEntry - model name, or log entry with body/response
  * @returns {number} context window size in tokens
  */
-export function getContextSizeForModel(apiModelName) {
+export function getContextSizeForModel(modelOrEntry) {
+  const isEntry = modelOrEntry !== null && typeof modelOrEntry === 'object';
+  // Entry input: calibration-aware resolution (request [Nk]/[Nm] suffix wins,
+  // else response model). Authoritative over the stale startup cache.
+  if (isEntry) {
+    const model = getCalibrationModel(modelOrEntry);
+    return model ? getModelMaxTokens(model) : (_startupContextSize || 200000);
+  }
+  const apiModelName = modelOrEntry;
   if (!apiModelName) return _startupContextSize || 200000;
   const lower = apiModelName.toLowerCase();
   // Extract base: 'claude-opus-4-6-20250514' → 'opus-4-6'
@@ -56,7 +71,7 @@ export function getContextSizeForModel(apiModelName) {
     return _startupContextSize;
   }
   // 完整档位表见 server/lib/context-rules.js(与前端同源;含 haiku/旧 opus/3-opus 200K、
-  // deepseek-v4 1M、gpt/deepseek 等三方档位,默认 200K)
+  // deepseek-v4 1M、kimi/moonshot 256K、gpt/deepseek 等三方档位,默认 200K)
   return getModelMaxTokens(apiModelName);
 }
 

package/server/lib/log-management.js

@@ -4,6 +4,8 @@ import { join, sep, dirname, basename } from 'node:path';
 import { reconstructEntries } from './delta-reconstructor.js';
 import { sanitizePathComponent } from './v2/layout.js';
 import { listV2Sessions } from './v2/adapter.js';
+import { summarizeSessionPage } from './v2/session-list.js';
+import { listSessionIds } from './v2/replay.js';
 
 // wire-v2 S5 addressing (spec §12): 'v2:<project>/<session_id>' in every
 // existing ?file= parameter slot. Components must survive the same whitelist
@@ -122,6 +124,61 @@ export function listV2Logs(logDir, currentProjectName) {
   return { ...grouped, _currentProject: currentProjectName || '' };
 }
 
+/**
+ * Server-side paginated v2 log list for ONE project (2026-07-31). The modal
+ * only ever renders the current project's sessions, so instead of summarizing
+ * every session up front we page: enumerate session dirs (readdir — cheap),
+ * read each meta.json only for the startTs ordering + leader filter, sort
+ * newest-first, then run the EXPENSIVE summarize (journal fold + dir walk +
+ * prompts head) on just the `pageSize` sessions of the requested page — those
+ * go through the same row cache as listV2Sessions, so revisiting a page is
+ * ~1-3ms. Trade-off documented inline: `size==0` and `discard` verdicts live
+ * behind that summarize, so `total` is the pre-filter session count (the empty
+ * / quota-probe sessions are excluded as their pages are computed). For
+ * realistic data (empties + probes are a small minority) this keeps cold open
+ * at ~1 page of work instead of N.
+ *
+ * @returns {{items: Array, total: number, page: number, pageSize: number}}
+ *   items rows keep the exact listV2Logs shape {file, kind, timestamp, size, turns, preview}.
+ */
+export function listV2LogsPage(logDir, project, { page = 1, pageSize = 50 } = {}) {
+  const out = { items: [], total: 0, page, pageSize, _currentProject: project || '' };
+  if (!project) return out;
+  const projectDir = join(logDir, project);
+  if (!existsSync(projectDir)) return out;
+
+  // Cheap pass: order candidates by startTs without paying per-session folds.
+  const candidates = [];
+  for (const dirName of listSessionIds(projectDir)) {
+    let meta = null;
+    try { meta = JSON.parse(readFileSync(join(projectDir, 'sessions', dirName, 'meta.json'), 'utf-8')); } catch { /* journal is self-describing */ }
+    if (meta && meta.leader) continue; // teammate — folded into its leader's row
+    candidates.push({ dirName, startTs: (meta && meta.startTs) || '' });
+  }
+  // Newest first; dirName tiebreak matches listV2Logs' file tiebreak for stability.
+  candidates.sort((a, b) => b.startTs.localeCompare(a.startTs) || b.dirName.localeCompare(a.dirName));
+  out.total = candidates.length;
+
+  const start = (page - 1) * pageSize;
+  for (const c of candidates.slice(start, start + pageSize)) {
+    let s = null;
+    try { s = summarizeSessionPage(projectDir, c.dirName); } catch { continue; }
+    if (!s) continue;
+    if (s.leader) continue;
+    if (s.size === 0) continue;
+    if (s.discard) continue; // quota-probe orphans: never listed
+    out.items.push({
+      file: `v2:${project}/${s.sid}`,
+      kind: 'v2',
+      timestamp: compactLocalTs(s.startTs),
+      size: s.size,
+      turns: s.turns,
+      preview: s.preview || [],
+    });
+  }
+  return out;
+}
+
 /**
  * 1.7.0 v1 view: list legacy v1 `.jsonl` files, grouped per project — same row
  * shape as listV2Logs so LogTable renders both views unchanged. Every

package/server/lib/log-watcher.js

@@ -156,7 +156,7 @@ export function processWatchedEntry(parsed, ctx) {
     if (cached) sendEventToClients(clients, 'kv_cache_content', cached);
     const usage = parsed.response?.body?.usage;
     if (usage) {
-      const contextSize = getContextSizeForModel(parsed.body?.model);
+      const contextSize = getContextSizeForModel(parsed);
       const cwData = buildContextWindowEvent(usage, contextSize);
       if (cwData) sendEventToClients(clients, 'context_window', cwData);
     }

package/server/lib/v2/adapter.js

@@ -27,16 +27,16 @@
 // (sessionId, seq) tie-break — field-equivalent to v1's "teammate writes the
 // leader's file".
 
-import { existsSync, readdirSync, readFileSync, statSync, openSync, readSync, closeSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { join, dirname, basename } from 'node:path';
 import { reportSwallowed } from '../error-report.js';
 import { isMainAgentRequest } from '../interceptor-core.js';
-import { readPromptsHead, collectPromptsFromEvents } from '../user-prompt-extract.js';
-import { readSession, readJsonlTolerant, listSessionIds } from './replay.js';
+import { readSession } from './replay.js';
 import { iterateJsonlLines } from './jsonl-read.js';
 import { isDiscardableSession } from './session-select.js';
-import { blobPath, isSupportedWireFormat, dirSizeSync } from './layout.js';
+import { blobPath, isSupportedWireFormat } from './layout.js';
 import { SingleFlight } from './singleflight.js';
+import { listV2Sessions } from './session-list.js';
 
 // Same stamping rules as the v1 interceptor (KEEP IN SYNC: server/interceptor.js
 // requestEntry construction) — recomputed from the journal's url, not from kind,
@@ -1056,109 +1056,8 @@ export async function streamV2WindowedEntries(sessionDir, opts, onEntry) {
 
 // ─── session listing (spec §12, list entry pulled forward from S6a) ─────────
 
-/** Bounded head read: parse the FIRST JSONL line of a file without loading the
- *  whole thing (a main conversation's opening snapshot can be multi-MB; the
- *  list only wants a preview). Returns null on any shortfall. */
-function readFirstJsonLine(path, budget = 256 * 1024) {
-  let fd;
-  try {
-    fd = openSync(path, 'r');
-    const buf = Buffer.alloc(budget);
-    const n = readSync(fd, buf, 0, budget, 0);
-    const head = buf.toString('utf-8', 0, n);
-    const nl = head.indexOf('\n');
-    if (nl <= 0) return null; // no complete first line inside the budget
-    return JSON.parse(head.slice(0, nl));
-  } catch {
-    return null;
-  } finally {
-    if (fd !== undefined) { try { closeSync(fd); } catch { /* already closed */ } }
-  }
-}
-
-/**
- * Summarize every session under LOG_DIR/<project>/ for the log list (spec §12).
- * Deliberately cheap: journal lines only (small) + a bounded head read of the
- * main conversation's first epoch for the preview — conversation bodies are
- * never loaded. Teammate linkage is surfaced via `leader` so the caller can
- * fold those sessions into their leader's view instead of double-listing.
- * @returns {Array<{sid, dir, startTs, leader, turns, size, preview}>}
- */
-export function listV2Sessions(projectDir) {
-  const out = [];
-  for (const sid of listSessionIds(projectDir)) {
-    try {
-      const dir = join(projectDir, 'sessions', sid);
-      if (!existsSync(join(dir, 'journal.jsonl'))) continue;
-      let meta = null;
-      try { meta = JSON.parse(readFileSync(join(dir, 'meta.json'), 'utf-8')); } catch { /* tolerated — journal is self-describing */ }
-      if (meta && meta.wireFormat != null && !isSupportedWireFormat(meta.wireFormat)) {
-        // Reader version gate (spec §14): don't list a session this build
-        // can't read — a garbage preview/turn-count is worse than absence.
-        reportSwallowed('v2-read.unsupported-wire-format', new Error(`${sid}: wireFormat=${meta.wireFormat}`));
-        continue;
-      }
-
-      // turns = main requests that completed (journal two-phase fold). The
-      // journal sentinel is checked in the same pass: per §14 the per-file
-      // sentinel WINS over meta.json, and readSession/adapter refuse such a
-      // session — listing it would show a phantom row that opens empty.
-      const reqKind = new Map();
-      let turns = 0;
-      let sentinelVersion = null;
-      let hasMainOrTeammate = false;
-      for (const line of readJsonlTolerant(join(dir, 'journal.jsonl'))) {
-        if (line.ph === 'req') {
-          reqKind.set(line.seq, line.kind);
-          if (line.kind === 'main' || line.kind === 'teammate') hasMainOrTeammate = true;
-        }
-        else if (line.ph === 'done' && reqKind.get(line.seq) === 'main') {
-          turns++;
-          reqKind.delete(line.seq); // fold duplicate done lines (§14)
-        } else if (line.ph === 'meta' && typeof line.wireFormat === 'number' && !isSupportedWireFormat(line.wireFormat)) {
-          sentinelVersion = line.wireFormat;
-          break;
-        }
-      }
-      if (sentinelVersion != null) {
-        reportSwallowed('v2-read.unsupported-wire-format', new Error(`${sid}: wireFormat=${sentinelVersion} (journal sentinel)`));
-        continue;
-      }
-
-      // preview = ALL user prompts of the session, from the prompts.jsonl
-      // display cache (written by V2Writer / the converter; bounded head read
-      // so the list stays O(budget) per session). Sessions predating the
-      // cache fall back to the first epoch's first line — routed through the
-      // shared extractor so command/caveat chrome never leaks into the row.
-      let preview = readPromptsHead(join(dir, 'prompts.jsonl'));
-      if (preview.length === 0) {
-        const first = readFirstJsonLine(join(dir, 'conversations', 'main', 'e0.jsonl'));
-        if (first && Array.isArray(first.msgs)) {
-          preview = collectPromptsFromEvents([first]);
-        }
-      }
-
-      out.push({
-        sid,
-        dir,
-        startTs: (meta && meta.startTs) || '',
-        leader: (meta && meta.leader) || null,
-        turns,
-        size: dirSizeSync(dir),
-        preview,
-        // Discardable-session verdict. KEEP IN SYNC: session-select.js
-        // isDiscardableSession is the canonical rule; this fold pre-computes
-        // it for free over the FULL journal (the canonical scan is 8MB-
-        // budgeted — intentional asymmetry, a first main sits at the head).
-        // When the fold says discard, the canonical predicate CONFIRMS it:
-        // readJsonlTolerant swallows an I/O error (Windows EBUSY/EPERM lock)
-        // into zero lines, which must KEEP the session, not hide it — the
-        // canonical path carries that error→keep direction (ioErrorResult).
-        // Main-bearing sessions never pay the extra read; probe journals are
-        // ~3 lines.
-        discard: !(meta && meta.leader) && !hasMainOrTeammate && isDiscardableSession(dir, meta),
-      });
-    } catch { /* one unreadable session must not break the list */ }
-  }
-  return out;
-}
+// listV2Sessions is re-exported from session-list.js (P0-A row cache, 2026-07-31).
+// The full per-session summarization logic (incl. the readFirstJsonLine preview
+// fallback) moved there; this re-export keeps the public API unchanged for all
+// callers (log-management.js, routes/im.js, tests).
+export { listV2Sessions };

package/server/lib/v2/convert-manager.js

@@ -10,6 +10,7 @@
 import { Worker } from 'node:worker_threads';
 import { join } from 'node:path';
 import { readConvertState } from './convert.js';
+import { _invalidate as _invalidateMigrationStatus } from './migrate-prompt.js';
 
 let _running = null; // { project, logDir, worker, startedAt, progress }
 let _lastError = null; // last worker-level failure (state file may lag on hard crashes)
@@ -36,7 +37,12 @@ export function startConvert(logDir, project) {
   worker.on('message', (msg) => {
     if (!msg || !_running || _running.worker !== worker) return;
     if (msg.type === 'progress') _running.progress = msg.progress;
-    else if (msg.type === 'final' && msg.error) _lastError = msg.error;
+    else if (msg.type === 'final') {
+      if (msg.error) _lastError = msg.error;
+      // A finished conversion immediately changes what migrationStatus returns
+      // for this project — drop the memo so the next call re-scans.
+      _invalidateMigrationStatus(_running.logDir, msg.project);
+    }
   });
   worker.on('error', (err) => {
     _lastError = String(err && err.message || err);

package/server/lib/v2/migrate-prompt.js

@@ -5,10 +5,23 @@
 // pending unless the convert state marks it done AT ITS CURRENT SIZE (the
 // converter's trust rule, convert.js), because the converter never deletes
 // v1 sources ("files exist" alone is not "migration needed").
+//
+// P0-B (2026-07-31): 10s TTL memo per (logDir, project). migrationStatus is
+// called on every SSE connect (events.js), every list refresh (logs.js), and
+// every workspace boot — each call stat-scans ALL v1 files of ALL projects.
+// The memo collapses repeat calls to a Map lookup. `now` is injectable for
+// tests (same house style as singleflight.js). Invalidation hook: the convert
+// manager calls _invalidate() when its worker posts {type:'final'} (bypasses
+// the 1s progress throttle), so a finished conversion is reflected immediately.
 import { statSync } from 'node:fs';
 import { join } from 'node:path';
 import { listV1Files, listConvertibleProjects, readConvertState } from './convert.js';
 
+const TTL_MS = 10_000;
+/** @type {Map<string, {value: object, expiresAt: number}>} */
+const _memo = new Map();
+let _now = Date.now;
+
 /** Pending v1 files + bytes of ONE project dir. */
 function pendingOf(projectDir) {
   const state = readConvertState(projectDir);
@@ -36,6 +49,8 @@ function pendingOf(projectDir) {
 /**
  * Migration status of one project (plus how many OTHER projects also have
  * pending v1 logs — the prompt mentions `ccv convert --all` for those).
+ * Memoized for TTL_MS per (logDir, project); see module header for the
+ * invalidation contract.
  * @param {string} logDir - LOG_DIR root
  * @param {string} project - project directory name ('' → not pending)
  * @returns {{pending: boolean, files: number, totalBytes: number, otherProjects: number}}
@@ -43,6 +58,9 @@ function pendingOf(projectDir) {
 export function migrationStatus(logDir, project) {
   const empty = { pending: false, files: 0, totalBytes: 0, otherProjects: 0 };
   if (!logDir || !project) return empty;
+  const cacheKey = `${logDir}\0${project}`;
+  const cached = _memo.get(cacheKey);
+  if (cached && _now() < cached.expiresAt) return cached.value;
   try {
     const { files, totalBytes } = pendingOf(join(logDir, project));
     let otherProjects = 0;
@@ -50,8 +68,28 @@ export function migrationStatus(logDir, project) {
       if (p === project) continue;
       if (pendingOf(join(logDir, p)).files > 0) otherProjects++;
     }
-    return { pending: files > 0, files, totalBytes, otherProjects };
+    const value = { pending: files > 0, files, totalBytes, otherProjects };
+    _memo.set(cacheKey, { value, expiresAt: _now() + TTL_MS });
+    return value;
   } catch {
     return empty;
   }
 }
+
+/** Drop the memo for one (or all) projects — called by the convert manager
+ *  when a conversion worker finishes, and by tests. */
+export function _invalidate(logDir, project) {
+  if (logDir === undefined) { _memo.clear(); return; }
+  _memo.delete(`${logDir}\0${project}`);
+}
+
+/** Test hook: replace the clock (pass `() => t`); call without args to restore. */
+export function _setNowForTest(fn) {
+  _now = fn || Date.now;
+}
+
+/** Test hook: drop all memoized entries. */
+export function _resetForTest() {
+  _memo.clear();
+  _now = Date.now;
+}