@fenglimg/fabric-cli 2.0.0-rc.35 → 2.0.0-rc.37

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "2.0.0-rc.35",
+  "version": "2.0.0-rc.37",
+  "description": "Fabric CLI — installs the MCP server + skills + hooks for Claude Code, Cursor, and Codex CLI; runs doctor / knowledge maintenance.",
+  "license": "MIT",
+  "author": "wangzhichao <fenglimg90@gmail.com>",
+  "homepage": "https://github.com/fenglimg/fabric-v2#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fenglimg/fabric-v2.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/fenglimg/fabric-v2/issues"
+  },
+  "keywords": [
+    "fabric",
+    "mcp",
+    "cli",
+    "claude-code",
+    "cursor",
+    "codex-cli",
+    "ai-knowledge-management"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "type": "module",
   "bin": {
     "fabric": "dist/index.js"
@@ -9,7 +33,9 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "templates"
+    "templates",
+    "LICENSE",
+    "README.md"
   ],
   "dependencies": {
     "@clack/prompts": "^1.2.0",
@@ -19,8 +45,8 @@
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-typescript": "^0.23.2",
     "web-tree-sitter": "^0.26.8",
-    "@fenglimg/fabric-server": "2.0.0-rc.35",
-    "@fenglimg/fabric-shared": "2.0.0-rc.35"
+    "@fenglimg/fabric-server": "2.0.0-rc.37",
+    "@fenglimg/fabric-shared": "2.0.0-rc.37"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/templates/hooks/cite-policy-evict.cjs

@@ -35,18 +35,30 @@
  * fabric-hint and SessionStart knowledge-hint-broad (rc.33 W2 channel).
  */
 
-const { existsSync, mkdirSync, readFileSync, writeFileSync } = require("node:fs");
-const { dirname, join } = require("node:path");
-
-const FABRIC_DIR_REL = ".fabric";
-const FABRIC_CONFIG_FILE = "fabric-config.json";
-const EVICT_STATE_FILE = join(".fabric", ".cache", "cite-evict-state.json");
+// v2.0.0-rc.37 NEW-19: config + sidecar I/O now flow through shared libs so
+// the read-config-or-default and read/write-sidecar boilerplate lives in one
+// canonical place. Unguarded require mirrors knowledge-hint-broad's
+// banner-i18n import — the installer copies every lib/*.cjs alongside the hook.
+const { readConfigNumber } = require("./lib/config-cache.cjs");
+const { readJsonState, writeJsonState } = require("./lib/state-store.cjs");
+// v2.0.0-rc.37 NEW-30: client detect + stdin + channel-aware emit now flow
+// through the shared adapter (Claude Code stdout envelope vs Codex/Cursor
+// stderr). Replaces the local isClaudeCode + readStdinJson + inline emits.
+const { isClaudeCode, readStdinJson, emitContext } = require("./lib/client-adapter.cjs");
+
+// Sidecar basename resolved under .fabric/.cache/ by state-store.
+const EVICT_STATE_FILE_NAME = "cite-evict-state.json";
 
 // Default OFF (opt-in). Mirrors hint_broad_cooldown_hours and
 // archive_hint_cooldown_hours convention of "feature exists but inert until
 // user enables it." Schema in packages/shared/src/schemas/fabric-config.ts
 // caps at sensible bounds (positive int).
-const DEFAULT_CITE_EVICT_INTERVAL = 0;
+// v2.0.0-rc.37 NEW-18: default flipped 0 (opt-in OFF) → 10 (default ON every
+// 10 turns) so users get cite-policy nudges out-of-the-box. Operators on
+// short / scripted sessions can still set `cite_evict_interval: 0` in
+// .fabric/fabric-config.json to opt back out. Per-NEW-1 reminder body now
+// uses the simplified 2-state vocabulary ([applied] / [dismissed:<reason>]).
+const DEFAULT_CITE_EVICT_INTERVAL = 10;
 
 /**
  * Read .fabric/fabric-config.json#cite_evict_interval. Returns the parsed
@@ -55,18 +67,10 @@ const DEFAULT_CITE_EVICT_INTERVAL = 0;
  * defensive config-read pattern in knowledge-hint-broad.cjs readBroadCooldownHours.
  */
 function readEvictInterval(cwd) {
-  const configPath = join(cwd, FABRIC_DIR_REL, FABRIC_CONFIG_FILE);
-  if (!existsSync(configPath)) return DEFAULT_CITE_EVICT_INTERVAL;
-  try {
-    const parsed = JSON.parse(readFileSync(configPath, "utf8"));
-    const v = parsed && parsed.cite_evict_interval;
-    if (typeof v === "number" && Number.isInteger(v) && v >= 0) {
-      return v;
-    }
-  } catch {
-    // ignore — defensive default
-  }
-  return DEFAULT_CITE_EVICT_INTERVAL;
+  return readConfigNumber(cwd, "cite_evict_interval", DEFAULT_CITE_EVICT_INTERVAL, {
+    min: 0,
+    integer: true,
+  });
 }
 
 /**
@@ -75,33 +79,21 @@ function readEvictInterval(cwd) {
  * with turn_count=1).
  */
 function readEvictState(cwd) {
-  const path = join(cwd, EVICT_STATE_FILE);
-  if (!existsSync(path)) return null;
-  try {
-    const parsed = JSON.parse(readFileSync(path, "utf8"));
-    if (
+  return readJsonState(
+    cwd,
+    EVICT_STATE_FILE_NAME,
+    (parsed) =>
       parsed &&
       typeof parsed.session_id === "string" &&
       typeof parsed.turn_count === "number" &&
       Number.isInteger(parsed.turn_count) &&
-      parsed.turn_count >= 0
-    ) {
-      return parsed;
-    }
-  } catch {
-    // ignore — corrupted sidecar is treated as no prior state
-  }
-  return null;
+      parsed.turn_count >= 0,
+  );
 }
 
 function writeEvictState(cwd, sessionId, turnCount) {
-  const path = join(cwd, EVICT_STATE_FILE);
-  try {
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, JSON.stringify({ session_id: sessionId, turn_count: turnCount }));
-  } catch {
-    // best-effort — counter loss is acceptable, hook never blocks
-  }
+  // best-effort — counter loss is acceptable, hook never blocks
+  writeJsonState(cwd, EVICT_STATE_FILE_NAME, { session_id: sessionId, turn_count: turnCount });
 }
 
 /**
@@ -134,48 +126,20 @@ function evaluateCiteEvict(turnCount, interval) {
  * Returns a multi-line string ready for hookSpecificOutput.additionalContext.
  */
 function renderReminder(turnCount, interval) {
+  // v2.0.0-rc.37 NEW-1: cite policy simplified 4-state → 2-state.
+  // [applied] consolidates planned/recalled/chained-from; dismissed:<reason>
+  // unchanged. Old tags still parse for back-compat.
   return [
     `[fabric cite-evict] long-session reminder (turn ${turnCount}, interval ${interval}):`,
-    "Before edit / decide / propose plan, write KB: <id> (<≤8字 用法>) [planned|recalled|chained-from <id>|dismissed:<reason>] OR KB: none [<reason>].",
-    "Verify [recalled] via fab_plan_context → fab_get_knowledge_sections two-step (no fabricated ids).",
-    "decisions/pitfalls cite MUST end with contract: → <operator> [<operator>...] where operator ∈ {edit:<glob> !edit:<glob> require:<symbol> forbid:<symbol> skip:<reason>}.",
+    "Before edit / decide / propose plan, write KB: <id> (<≤8字 用法>) [applied|dismissed:<reason>] OR KB: none [<reason>].",
+    "Verify [applied] by actually fetching KB body via fab_recall(paths) or fab_plan_context → fab_get_knowledge_sections (no fabricated ids).",
+    "decisions/pitfalls [applied] cite MUST end with contract: → <operator> [<operator>...] where operator ∈ {edit:<glob> !edit:<glob> require:<symbol> forbid:<symbol> skip:<reason>}.",
     "skip reasons: sequencing | conditional | semantic | aesthetic | architectural | other:<text>.",
     "KB: none sentinels: [no-relevant] (queried but nothing matched) | [not-applicable] (pure exploration / read-only / user Q&A).",
     "Audit: fabric doctor --cite-coverage — this rule does not block work, only records.",
   ].join("\n");
 }
 
-/**
- * Detect Claude Code via CLAUDE_PROJECT_DIR env. Same single-bit signal used
- * by knowledge-hint-broad.cjs rc.33 W4 review-fix (Gemini High-1). Codex /
- * Cursor don't set this var.
- */
-function isClaudeCode() {
-  return (
-    typeof process.env.CLAUDE_PROJECT_DIR === "string" &&
-    process.env.CLAUDE_PROJECT_DIR.length > 0
-  );
-}
-
-async function readStdinJson() {
-  return new Promise((resolve) => {
-    let buffer = "";
-    process.stdin.on("data", (chunk) => {
-      buffer += chunk;
-    });
-    process.stdin.on("end", () => {
-      try {
-        resolve(JSON.parse(buffer));
-      } catch {
-        resolve(null);
-      }
-    });
-    process.stdin.on("error", () => resolve(null));
-    // Defensive timeout: if stdin never closes (host bug), give up after 1s.
-    setTimeout(() => resolve(null), 1000).unref();
-  });
-}
-
 async function main(env) {
   try {
     const cwd =
@@ -188,15 +152,45 @@ async function main(env) {
       return; // feature off — silent exit
     }
 
-    // Skip Claude Code-specific stdout envelope on Codex/Cursor. Counter
-    // bookkeeping also skipped — there's no fire path on those clients.
+    // Read stdin payload (Claude Code passes hook_event_name; Codex/Cursor
+    // SessionStart payloads are smaller but still JSON). Tests inject
+    // env.payload to bypass the stdin read.
+    const payload = env && env.payload !== undefined ? env.payload : await readStdinJson();
+
+    // v2.0.0-rc.37 NEW-21: SessionStart-mode parity for Codex/Cursor.
+    // When the hook fires on SessionStart (instead of UserPromptSubmit),
+    // emit ONE unconditional cite-policy reminder to stderr. This gives
+    // Codex/Cursor users the cite-contract nudge at session boot — lower
+    // cadence than Claude Code's per-prompt UserPromptSubmit window, but
+    // strictly better than 0 (rc.32 cite-coverage baseline 3.1% measured
+    // when Codex/Cursor had no cite-reminder surface at all).
+    const eventName =
+      payload && typeof payload.hook_event_name === "string"
+        ? payload.hook_event_name
+        : null;
+    const sessionStartMode =
+      (env && env.forceSessionStart === true) || eventName === "SessionStart";
+
+    const streams = (env && env.stdio) || {};
+
+    if (sessionStartMode) {
+      // One-shot stderr emit (knowledge-hint-broad convention). forceStderr
+      // pins stderr even on Claude Code — Codex/Cursor parse stderr; CC
+      // SessionStart also surfaces stderr to the user.
+      emitContext(renderReminder(/* turnCount = */ 0, interval), {
+        forceStderr: true,
+        streams,
+      });
+      return;
+    }
+
+    // Claude Code UserPromptSubmit path (unchanged from rc.34 TASK-06).
+    // Skip Claude Code-specific stdout envelope on Codex/Cursor when not
+    // in SessionStart mode (no UserPromptSubmit event registration there).
     if (!isClaudeCode() && !(env && env.forceClaudeCode === true)) {
       return;
     }
 
-    // Read stdin payload to learn session_id. Tests inject env.payload to
-    // bypass the stdin read; production reads JSON envelope from stdin.
-    const payload = env && env.payload !== undefined ? env.payload : await readStdinJson();
     const sessionId =
       payload && typeof payload.session_id === "string" && payload.session_id.length > 0
         ? payload.session_id
@@ -210,19 +204,14 @@ async function main(env) {
       return; // not on a window boundary — silent
     }
 
-    const reminder = renderReminder(turnCount, interval);
-    const out = (env && env.stdio && env.stdio.stdout) || process.stdout;
-    try {
-      const envelope = {
-        hookSpecificOutput: {
-          hookEventName: "UserPromptSubmit",
-          additionalContext: reminder,
-        },
-      };
-      out.write(`${JSON.stringify(envelope)}\n`);
-    } catch {
-      // best-effort
-    }
+    // Claude Code UserPromptSubmit: stdout JSON envelope. client:'cc' forces
+    // the envelope since the isClaudeCode/forceClaudeCode gate above already
+    // confirmed this is the Claude Code path.
+    emitContext(renderReminder(turnCount, interval), {
+      client: "cc",
+      eventName: "UserPromptSubmit",
+      streams,
+    });
   } catch {
     // Silent — never block user prompt on hook failure.
   }

package/templates/hooks/configs/README.md

@@ -37,6 +37,25 @@ envelope (was `{events: {Stop, SessionStart, PreToolUse}}` PascalCase, which
 Cursor rejects with "Config version must be a number; Config hooks must be an
 object").
 
+## Per-client schema comparison (v2.0.0-rc.37 NEW-29)
+
+Each host program enforces its own wire format — `fabric install` cannot
+serialize one shared shape across all three. Differences are pinned here
+side-by-side so anyone editing one config knows what the others require.
+
+| Axis                 | Claude Code                              | Codex CLI                                          | Cursor                                          |
+| -------------------- | ---------------------------------------- | -------------------------------------------------- | ----------------------------------------------- |
+| Settings file        | `.claude/settings.json`                  | `.codex/hooks.json`                                | `.cursor/hooks.json`                            |
+| Top-level envelope   | `hooks: { ... }` (no version)            | `events: { ... }` (no version)                     | `{ version: 1, hooks: { ... } }` (number, not string) |
+| Event-name case      | PascalCase: `Stop`, `SessionStart`, `PreToolUse`, `UserPromptSubmit` | PascalCase: `Stop`, `SessionStart`, `PreToolUse`     | camelCase: `stop`, `sessionStart`, `preToolUse` |
+| Per-entry shape      | Nested matcher: `[{matcher, hooks:[{type:"command", command}]}]` | Flat: `[{command, matcher?}]`                      | Flat: `[{command, matcher?, type?, timeout?, loop_limit?, failClosed?}]` |
+| Path interpolation   | `${CLAUDE_PROJECT_DIR}` (env var)        | `"$(git rev-parse --show-toplevel)"` (shell expansion) | project-relative (resolved by Cursor)           |
+| Cite-policy event    | `UserPromptSubmit` (per-prompt)          | `SessionStart` 2nd entry (rc.37 NEW-21 parity)     | `sessionStart` 2nd entry (rc.37 NEW-21 parity)  |
+
+Whenever a hook is added to one config, walk this table and add the equivalent
+entry to the other two — `fabric install` merges each into its respective
+target verbatim, so missing entries silently degrade the cross-client surface.
+
 ## fabric-hint.cjs script paths
 
 - Claude: `.claude/hooks/fabric-hint.cjs` (project-relative)

package/templates/hooks/configs/codex-hooks.json

@@ -8,6 +8,9 @@
     "SessionStart": [
       {
         "command": "\"$(git rev-parse --show-toplevel)/.codex/hooks/knowledge-hint-broad.cjs\""
+      },
+      {
+        "command": "\"$(git rev-parse --show-toplevel)/.codex/hooks/cite-policy-evict.cjs\""
       }
     ],
     "PreToolUse": [

package/templates/hooks/configs/cursor-hooks.json

@@ -5,7 +5,8 @@
       { "command": ".cursor/hooks/fabric-hint.cjs" }
     ],
     "sessionStart": [
-      { "command": ".cursor/hooks/knowledge-hint-broad.cjs" }
+      { "command": ".cursor/hooks/knowledge-hint-broad.cjs" },
+      { "command": ".cursor/hooks/cite-policy-evict.cjs" }
     ],
     "preToolUse": [
       {

package/templates/hooks/fabric-hint.cjs

@@ -55,6 +55,32 @@ try {
   citeContractReminder = null;
 }
 
+// v2.0.0-rc.37 NEW-30: shared client-protocol adapter. Guarded require (this
+// hook runs in arbitrary user repos); detectClient delegates the 3-tier
+// detection to the lib, falling back to env-only when the lib is absent.
+let clientAdapter = null;
+try {
+  clientAdapter = require("./lib/client-adapter.cjs");
+} catch {
+  clientAdapter = null;
+}
+
+// v2.0.0-rc.37 NEW-16: shared config + sidecar I/O for the per-signal dismiss
+// feature (config-level durable opt-out + session-scoped sidecar). Guarded
+// require (house style); dismiss simply doesn't fire if the lib is absent.
+let configCache = null;
+let stateStore = null;
+try {
+  configCache = require("./lib/config-cache.cjs");
+} catch {
+  configCache = null;
+}
+try {
+  stateStore = require("./lib/state-store.cjs");
+} catch {
+  stateStore = null;
+}
+
 // CONSTANTS — duplicated from packages/server/src/services/_shared.ts.
 // DRY violation accepted: this hook script runs in user repos WITHOUT
 // node_modules access, so it cannot import from @fenglimg/fabric-server.
@@ -929,6 +955,97 @@ function writeShownCache(projectRoot, cache) {
   }
 }
 
+// -----------------------------------------------------------------------------
+// v2.0.0-rc.37 NEW-16 — per-signal dismiss.
+//
+// Two suppression levers, both honoured at emit time (a chosen signal whose
+// type is dismissed exits silently, exactly like a cooldown hit):
+//   1. Durable opt-out — fabric-config.json#hint_dismiss_signals: string[].
+//      Mirrors the cite_evict_interval=0 opt-out convention; survives across
+//      sessions. The concrete user-actionable lever surfaced in the nudge.
+//   2. Session-scoped — .fabric/.cache/hint-dismiss-{sessionId}.json
+//      { dismissed: string[] }. Ephemeral; written by the agent when the user
+//      asks to silence a nudge type for the current session (Fabric's
+//      AI-driven write convention — no new CLI surface).
+//
+// The four signal types ('archive' / 'review' / 'import' / 'maintenance')
+// each have an independent cooldown ALREADY (signal-keyed SHOWN_CACHE for
+// A/B/C + the maintenance day-cooldown sidecar), so dismiss layers cleanly on
+// top of per-signal cadence without a physical 4-hook split (which would 4×
+// the per-Stop process spawn and break the deliberate single-nudge-per-turn
+// precedence model — KT-DEC-0007 anti-nag spirit).
+// -----------------------------------------------------------------------------
+
+const DISMISSABLE_SIGNALS = ["archive", "review", "import", "maintenance"];
+
+function sessionDismissFileName(sessionId) {
+  const safe = String(sessionId || "anonymous").replace(/[^A-Za-z0-9_.-]/g, "-");
+  return `hint-dismiss-${safe}.json`;
+}
+
+// Returns a Set of dismissed signal types (config-durable ∪ session sidecar).
+// Never throws — degrades to an empty set when libs are absent.
+function readDismissedSignals(projectRoot, sessionId) {
+  const dismissed = new Set();
+  try {
+    if (configCache && typeof configCache.readConfig === "function") {
+      const cfg = configCache.readConfig(projectRoot);
+      const list = cfg && cfg.hint_dismiss_signals;
+      if (Array.isArray(list)) {
+        for (const s of list) {
+          if (DISMISSABLE_SIGNALS.includes(s)) dismissed.add(s);
+        }
+      }
+    }
+  } catch {
+    // defensive
+  }
+  try {
+    if (stateStore && typeof stateStore.readJsonState === "function" && sessionId) {
+      const sidecar = stateStore.readJsonState(
+        projectRoot,
+        sessionDismissFileName(sessionId),
+        (p) => p && typeof p === "object" && Array.isArray(p.dismissed),
+      );
+      if (sidecar) {
+        for (const s of sidecar.dismissed) {
+          if (DISMISSABLE_SIGNALS.includes(s)) dismissed.add(s);
+        }
+      }
+    }
+  } catch {
+    // defensive
+  }
+  return dismissed;
+}
+
+// Persist a session-scoped dismiss set (additive merge). Exposed for the
+// agent-driven write path + tests; not auto-invoked by the hook. Never throws.
+function writeSessionDismiss(projectRoot, sessionId, signals) {
+  if (!stateStore || typeof stateStore.writeJsonState !== "function") return;
+  const fileName = sessionDismissFileName(sessionId);
+  const prior = stateStore.readJsonState(
+    projectRoot,
+    fileName,
+    (p) => p && typeof p === "object" && Array.isArray(p.dismissed),
+  );
+  const merged = new Set(prior && Array.isArray(prior.dismissed) ? prior.dismissed : []);
+  for (const s of Array.isArray(signals) ? signals : []) {
+    if (DISMISSABLE_SIGNALS.includes(s)) merged.add(s);
+  }
+  stateStore.writeJsonState(projectRoot, fileName, { dismissed: [...merged] });
+}
+
+// Bilingual one-line dismiss hint appended to every nudge so the user knows
+// the lever exists. Variant fold mirrors banner-i18n: zh-CN / zh-CN-hybrid →
+// Chinese; en / match-existing / unknown → English.
+function renderDismissOption(signal, variant) {
+  const zh = variant === "zh-CN" || variant === "zh-CN-hybrid";
+  return zh
+    ? `  (不想再看到此类提醒？在 .fabric/fabric-config.json 设 "hint_dismiss_signals": ["${signal}"]，或让我本会话关闭 ${signal} 提醒)`
+    : `  (Silence this nudge? Set "hint_dismiss_signals": ["${signal}"] in .fabric/fabric-config.json, or ask me to dismiss ${signal} for this session)`;
+}
+
 /**
  * v2.0.0-rc.7 T10: find the most recent doctor_run event ts in the ledger.
  * Returns the ts (epoch ms) of the newest doctor_run event, or null if none
@@ -1161,6 +1278,13 @@ function parseKbLine(raw) {
  * so omitting it leaves the event valid.
  */
 function detectClient() {
+  // Delegate the full 3-tier detection (env → CLAUDE_PROJECT_DIR → path
+  // heuristic, incl. .cursor) to the shared adapter. __dirname is passed so
+  // the path heuristic reflects THIS hook's location.
+  if (clientAdapter && typeof clientAdapter.detectClient === "function") {
+    return clientAdapter.detectClient(__dirname);
+  }
+  // Fallback (adapter lib absent): env override only.
   const envClient = process.env.FABRIC_HINT_CLIENT;
   if (typeof envClient === "string" && envClient.length > 0) {
     const normalised = envClient.trim().toLowerCase();
@@ -1168,14 +1292,6 @@ function detectClient() {
       return normalised;
     }
   }
-  // Path heuristic — __dirname is the directory containing this .cjs file
-  // when invoked normally (require.main === module).
-  try {
-    if (__dirname.includes(".claude/") || __dirname.includes(".claude\\")) return "cc";
-    if (__dirname.includes(".codex/") || __dirname.includes(".codex\\")) return "codex";
-  } catch {
-    // __dirname always defined for cjs modules; fall through defensively.
-  }
   return undefined;
 }
 
@@ -1722,6 +1838,21 @@ function main(env, stdio) {
 
     if (result === null) return;
 
+    // v2.0.0-rc.37 NEW-16: per-signal dismiss. A chosen signal whose type the
+    // user dismissed (config-durable or session sidecar) exits silently —
+    // same shape as a cooldown hit. Covers BOTH maintenance and A/B/C paths.
+    const sessionId =
+      stdinPayload && typeof stdinPayload.session_id === "string"
+        ? stdinPayload.session_id
+        : null;
+    if (readDismissedSignals(cwd, sessionId).has(result.signal)) {
+      return;
+    }
+    // Append the bilingual dismiss-option line so the lever is discoverable.
+    if (typeof result.reason === "string") {
+      result.reason = `${result.reason}\n${renderDismissOption(result.signal, variant)}`;
+    }
+
     // v2.0.0-rc.7 T10: Signal D uses its own cooldown sidecar (day-based,
     // see MAINTENANCE_HINT_LAST_EMIT_FILE). The A/B/C shared cooldown cache
     // uses hours, so we branch here to avoid mixing semantics.
@@ -1771,6 +1902,13 @@ module.exports = {
   readCooldownHours,
   readUnderseedThreshold,
   readArchiveEditThreshold,
+  // v2.0.0-rc.37 NEW-16: per-signal dismiss helpers (exported for tests +
+  // the agent-driven session-dismiss write path).
+  readDismissedSignals,
+  writeSessionDismiss,
+  sessionDismissFileName,
+  renderDismissOption,
+  DISMISSABLE_SIGNALS,
   // v2.0.0-rc.7 T5: session digest helpers (exported for unit testing).
   tryReadStdinJson,
   summarizeTranscript,