chore: remove backend code nothing references

Found with knip (exports, types, class members) and confirmed by a text
search of src, test, scripts and packages before each removal.

- Per-CLI get<Cli>NotFoundMessage() (nine of them) with their message
  constants: missingCliMessage() builds that text from the registry now.
- Registry leftovers: renderCliCommand, asCliId, cliIds, isCliRunnable,
  createCliResolverForTest, profileExists, and two name lists that only
  repeated schema enums.
- A task-description cache in Session that was written on every chunk of
  terminal output (one regex pass per line) and never read since the
  subagent watcher takes descriptions from transcripts. The cache module,
  its pattern and both parse methods go with it.
- Session.parentAgentId / childAgentIds: never set by anything, so the two
  optional SessionState fields were never on the wire.
- Unreferenced methods on TmuxManager (pipe-pane pair, syncMouseMode),
  RespawnController, StateStore.recoverFromBackup (load() already falls
  back to the .bak file), TeamWatcher, SseStreamManager and the AI
  checkers' getErrorVerdict.
- updateCaseEnvVars: the settings.local.json env path that envOverrides
  replaced.
- Re-exports in the utils, cli-registry, routes and prompts barrels that
  no importer used, and unused test helpers (MockStateStore, the mobile
  throttle helpers and others).

Eight mobile tests imported the WebServer type from a path that does not
exist (../src instead of ../../src); type-only, so nothing failed.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>

src/utils/antigravity-cli-resolver.ts

@@ -9,11 +9,7 @@
 
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import {
-  createCliExecutableResolver,
-  formatCliNotFoundMessage,
-  type CliResolverHost,
-} from './cli-executable-resolver.js';
+import { createCliExecutableResolver, type CliResolverHost } from './cli-executable-resolver.js';
 
 /** Common directories where the Antigravity CLI binary may be installed */
 /**
@@ -23,9 +19,6 @@ import {
  */
 const ANTIGRAVITY_SEARCH_DIRS = (): string[] => (getCli('antigravity')?.discovery.searchDirs ?? []).map(expandHome);
 
-const ANTIGRAVITY_NOT_FOUND =
-  'Antigravity CLI not found. Install with: curl -fsSL https://antigravity.google/cli/install.sh | bash';
-
 function createAntigravityResolver(host?: CliResolverHost, now?: () => number) {
   return createCliExecutableResolver({ binary: 'agy', searchDirs: ANTIGRAVITY_SEARCH_DIRS, now }, host);
 }
@@ -53,7 +46,3 @@ export function resolveAntigravityDir(): string | null {
 export function isAntigravityAvailable(): boolean {
   return resolveAntigravityDir() !== null;
 }
-
-export function getAntigravityNotFoundMessage(): string {
-  return formatCliNotFoundMessage(ANTIGRAVITY_NOT_FOUND, antigravityResolver.diagnostics());
-}

src/utils/claude-cli-resolver.ts

@@ -12,7 +12,7 @@ import { execFileSync } from 'node:child_process';
 import { delimiter, join } from 'node:path';
 import { homedir } from 'node:os';
 import { EXEC_TIMEOUT_MS } from '../config/exec-timeout.js';
-import { createCliExecutableResolver, formatCliNotFoundMessage } from './cli-executable-resolver.js';
+import { createCliExecutableResolver } from './cli-executable-resolver.js';
 
 /** Common directories where the Claude CLI binary may be installed */
 const CLAUDE_SEARCH_DIRS = [
@@ -24,7 +24,6 @@ const CLAUDE_SEARCH_DIRS = [
 ];
 
 const claudeResolver = createCliExecutableResolver({ binary: 'claude', searchDirs: CLAUDE_SEARCH_DIRS });
-const CLAUDE_NOT_FOUND = 'Claude CLI not found. Install it with: curl -fsSL https://claude.ai/install.sh | bash';
 
 /**
  * Returns true if the Claude CLI binary can be located (via `which` or one of
@@ -46,10 +45,6 @@ export function findClaudeDir(): string | null {
   return claudeResolver.resolve()?.directory ?? null;
 }
 
-export function getClaudeNotFoundMessage(): string {
-  return formatCliNotFoundMessage(CLAUDE_NOT_FOUND, claudeResolver.diagnostics());
-}
-
 /**
  * Returns an absolute path to the `claude` binary, falling back to the bare
  * name `'claude'` when it cannot be located (so PATH resolution still gets a

src/utils/cli-launcher.ts

@@ -82,26 +82,6 @@ export async function resolveCliLaunchError(mode: string, rawConfig?: Record<str
   return resolveCliBinDir(mode) === null ? missingCliMessage(mode) : null;
 }
 
-/**
- * Is this CLI actually usable? For an ordinary CLI that is exactly "its binary resolved".
- * For a launcher it is that AND whatever its profile demands.
- *
- * ⚠️ A named-but-unimplemented profile fails CLOSED. In practice `schema.ts` rejects such an
- * entry at load time, so this is the second line of defence rather than the first — but the
- * direction matters: offering a Run that always fails is worse than reporting unavailable.
- */
-export function isCliRunnable(id: string): boolean {
-  const entry = getCli(id);
-  if (!entry) return false;
-  // No binary to find (`shell`): tmux-manager resolves the login shell in code.
-  const resolved = entry.discovery.binaries.length === 0 ? true : resolveCliBinDir(id) !== null;
-  const profileName = entry.discovery.launcherProfile;
-  if (profileName === undefined) return resolved;
-  const profile = LAUNCHER_PROFILES[profileName];
-  if (!profile) return false;
-  return resolved && profile.isRunnable();
-}
-
 /**
  * The launcher's default target, for the `launcherDefaultTarget` engine value. Null for
  * every non-launcher CLI, which is what makes the corresponding launch arg drop out.

src/utils/cli-resolver.ts

@@ -172,20 +172,6 @@ function createRegistryResolver(
   };
 }
 
-/**
- * Build an isolated resolver for `entry` around an injected probe, host and clock — the
- * test seam. Omitting `probe` keeps the ambient, VITEST-gated one, which is exactly what
- * the hermeticity tests exercise.
- */
-export function createCliResolverForTest(
-  entry: CliEntry,
-  probe?: CliCandidateProbe,
-  host?: CliResolverHost,
-  now?: () => number
-): RegistryResolver {
-  return createRegistryResolver(entry, probe ?? probeCliCandidate, host, now);
-}
-
 /**
  * One memoized resolver per id, for the process lifetime — the same caching the per-CLI
  * modules already do for themselves, just keyed by id so generic code holding only a

src/utils/codex-cli-resolver.ts

@@ -10,7 +10,7 @@
 import { spawn } from 'node:child_process';
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import { createCliExecutableResolver, formatCliNotFoundMessage } from './cli-executable-resolver.js';
+import { createCliExecutableResolver } from './cli-executable-resolver.js';
 import { parseCodexRateLimitsResponse, type StatusTelemetry } from '../usage-telemetry.js';
 
 /**
@@ -22,7 +22,6 @@ const CODEX_SEARCH_DIRS = (): string[] => (getCli('codex')?.discovery.searchDirs
 
 const CODEX_BINARY = process.platform === 'win32' ? 'codex.exe' : 'codex';
 const codexResolver = createCliExecutableResolver({ binary: CODEX_BINARY, searchDirs: CODEX_SEARCH_DIRS });
-const CODEX_NOT_FOUND = 'Codex CLI not found. Install with: npm install -g @openai/codex';
 
 /**
  * Finds the directory containing the `codex` binary.
@@ -47,10 +46,6 @@ export function isCodexAvailable(): boolean {
   return resolveCodexDir() !== null;
 }
 
-export function getCodexNotFoundMessage(): string {
-  return formatCliNotFoundMessage(CODEX_NOT_FOUND, codexResolver.diagnostics());
-}
-
 type CodexRateLimitsRequest = (binaryPath: string, clientVersion: string) => Promise<unknown>;
 
 const APP_SERVER_TIMEOUT_MS = 10_000;

src/utils/copilot-cli-resolver.ts

@@ -17,11 +17,7 @@ import { execFileSync } from 'node:child_process';
 import { EXEC_TIMEOUT_MS } from '../config/exec-timeout.js';
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import {
-  createCliExecutableResolver,
-  formatCliNotFoundMessage,
-  type CliResolverHost,
-} from './cli-executable-resolver.js';
+import { createCliExecutableResolver, type CliResolverHost } from './cli-executable-resolver.js';
 
 /**
  * Directories probed after `which`, read from this CLI's registry entry so the spawn
@@ -36,8 +32,6 @@ const COPILOT_SEARCH_DIRS = (): string[] => (getCli('copilot')?.discovery.search
  */
 export const COPILOT_VERSION_REGEX = /GitHub Copilot CLI (\d+\.\d+\.\d+)/;
 
-const COPILOT_NOT_FOUND = 'GitHub Copilot CLI not found. Install with: npm install -g @github/copilot';
-
 /**
  * Run `copilot --version` on a candidate path and return the trimmed version when
  * it is the GitHub Copilot CLI. Returns null for anything else — a missing
@@ -125,10 +119,6 @@ export function isCopilotAvailable(): boolean {
   return resolveCopilotDir() !== null;
 }
 
-export function getCopilotNotFoundMessage(): string {
-  return formatCliNotFoundMessage(COPILOT_NOT_FOUND, copilotResolver.diagnostics());
-}
-
 /**
  * Version reported by the resolved `copilot` binary, or null when copilot is
  * unavailable. Surfaced through `GET /api/copilot/status` so a misresolution is

src/utils/deepseek-cli-resolver.ts

@@ -31,7 +31,7 @@
  */
 
 import { execFileSync } from 'node:child_process';
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { EXEC_TIMEOUT_MS } from '../config/exec-timeout.js';
@@ -379,11 +379,6 @@ export function getDeepSeekCliVersion(): string | null {
   return deepSeekResolver.resolve()?.metadata ?? null;
 }
 
-/** Does the named profile exist and can it drive a pane? */
-export function profileExists(name: string): boolean {
-  return existsSync(join(resolveDshHome(), 'profiles', name, 'package.json'));
-}
-
 /**
  * Why a DeepSeek session cannot start, or null when it can.
  *

src/utils/gemini-cli-resolver.ts

@@ -9,7 +9,7 @@
 
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import { createCliExecutableResolver, formatCliNotFoundMessage } from './cli-executable-resolver.js';
+import { createCliExecutableResolver } from './cli-executable-resolver.js';
 
 /** Common directories where the Gemini CLI binary may be installed */
 /**
@@ -20,7 +20,6 @@ import { createCliExecutableResolver, formatCliNotFoundMessage } from './cli-exe
 const GEMINI_SEARCH_DIRS = (): string[] => (getCli('gemini')?.discovery.searchDirs ?? []).map(expandHome);
 
 const geminiResolver = createCliExecutableResolver({ binary: 'gemini', searchDirs: GEMINI_SEARCH_DIRS });
-const GEMINI_NOT_FOUND = 'Gemini CLI not found. Install with: npm install -g @google/gemini-cli';
 
 /**
  * Finds the directory containing the `gemini` binary.
@@ -38,7 +37,3 @@ export function resolveGeminiDir(): string | null {
 export function isGeminiAvailable(): boolean {
   return resolveGeminiDir() !== null;
 }
-
-export function getGeminiNotFoundMessage(): string {
-  return formatCliNotFoundMessage(GEMINI_NOT_FOUND, geminiResolver.diagnostics());
-}

src/utils/grok-cli-resolver.ts

@@ -23,11 +23,7 @@ import { execFileSync } from 'node:child_process';
 import { EXEC_TIMEOUT_MS } from '../config/exec-timeout.js';
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import {
-  createCliExecutableResolver,
-  formatCliNotFoundMessage,
-  type CliResolverHost,
-} from './cli-executable-resolver.js';
+import { createCliExecutableResolver, type CliResolverHost } from './cli-executable-resolver.js';
 
 /** Common directories where the Grok CLI binary may be installed */
 /**
@@ -49,8 +45,6 @@ const GROK_SEARCH_DIRS = (): string[] => (getCli('grok')?.discovery.searchDirs ?
  */
 export const GROK_VERSION_REGEX = /(?:^|\s)(\d+\.\d+\.\d+)/;
 
-const GROK_NOT_FOUND = 'Grok CLI not found. Install with: curl -fsSL https://x.ai/cli/install.sh | bash';
-
 /**
  * Run `grok --version` on a candidate path and return the version token when it
  * looks like the coding agent. Returns null for anything else: a missing
@@ -137,10 +131,6 @@ export function isGrokAvailable(): boolean {
   return resolveGrokDir() !== null;
 }
 
-export function getGrokNotFoundMessage(): string {
-  return formatCliNotFoundMessage(GROK_NOT_FOUND, grokResolver.diagnostics());
-}
-
 /**
  * Version reported by the resolved `grok` binary, or null when grok is
  * unavailable. Surfaced through `GET /api/grok/status` so a misresolution is

src/utils/index.ts

@@ -12,7 +12,7 @@ export { Debouncer, KeyedDebouncer } from './debouncer.js';
 export { startEventLoopMonitor } from './event-loop-monitor.js';
 export type { EventLoopMonitorHandle } from './event-loop-monitor.js';
 export { StaleExpirationMap } from './stale-expiration-map.js';
-export { isProcessRunning, waitForProcessesExit, PROCESS_EXIT_POLL_MS } from './process-exit-wait.js';
+export { waitForProcessesExit } from './process-exit-wait.js';
 export {
   ANSI_ESCAPE_PATTERN_FULL,
   ANSI_ESCAPE_PATTERN_SIMPLE,
@@ -30,59 +30,13 @@ export { assertNever } from './type-safety.js';
 export { toSingleLine } from './single-line.js';
 export { wrapWithNice } from './nice-wrapper.js';
 export { resolveLocalShell, loginShellArgs } from './shell-resolver.js';
-export {
-  findClaudeDir,
-  getAugmentedPath,
-  getClaudeCliVersion,
-  getClaudeBinaryPath,
-  getClaudeNotFoundMessage,
-} from './claude-cli-resolver.js';
+export { getAugmentedPath, getClaudeCliVersion, getClaudeBinaryPath } from './claude-cli-resolver.js';
 export { spawnPtyWithHelperRepair } from './node-pty-repair.js';
-export { resolveOpenCodeDir, getOpenCodeNotFoundMessage } from './opencode-cli-resolver.js';
-export {
-  resolveCodexDir,
-  resolveCodexBinaryPath,
-  isCodexAvailable,
-  getCodexNotFoundMessage,
-  readCodexPlanUsage,
-} from './codex-cli-resolver.js';
-export { resolveGeminiDir, isGeminiAvailable, getGeminiNotFoundMessage } from './gemini-cli-resolver.js';
-export {
-  resolveAntigravityDir,
-  isAntigravityAvailable,
-  getAntigravityNotFoundMessage,
-} from './antigravity-cli-resolver.js';
-export { resolvePiDir, isPiAvailable, getPiCliVersion, getPiNotFoundMessage } from './pi-cli-resolver.js';
-export { resolveGrokDir, isGrokAvailable, getGrokCliVersion, getGrokNotFoundMessage } from './grok-cli-resolver.js';
-export {
-  resolveDeepSeekDir,
-  isDeepSeekAvailable,
-  isDeepSeekRunnable,
-  getDeepSeekCliVersion,
-  getDeepSeekNotFoundMessage,
-  listDeepSeekProfiles,
-  resolveDefaultDeepSeekProfile,
-  isLaunchableProfile,
-  resolveDshHome,
-  profileExists,
-} from './deepseek-cli-resolver.js';
-export type { DeepSeekProfile, DeepSeekProfileKind } from './deepseek-cli-resolver.js';
-export { compileFileQuery, matchFileQuery } from './file-query.js';
-export type { FileQueryMatcher } from './file-query.js';
-export { resolveOmpDir, isOmpAvailable, getOmpNotFoundMessage, getOmpCliVersion } from './omp-cli-resolver.js';
-export {
-  resolveCopilotDir,
-  isCopilotAvailable,
-  getCopilotNotFoundMessage,
-  getCopilotCliVersion,
-} from './copilot-cli-resolver.js';
-export { readCopilotPlanUsage, resolveCopilotToken } from './copilot-plan-usage.js';
 export {
   boundedPathExists,
   describeUnknownPath,
   probePath,
   probePathKind,
   isNearStalledPath,
-  unknownPathReason,
 } from './bounded-path-probe.js';
-export type { PathProbeState, PathProbeKind, PathProbeOptions } from './bounded-path-probe.js';
+export type { PathProbeOptions } from './bounded-path-probe.js';

src/utils/omp-cli-resolver.ts

@@ -17,11 +17,7 @@ import { execFileSync } from 'node:child_process';
 import { EXEC_TIMEOUT_MS } from '../config/exec-timeout.js';
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import {
-  createCliExecutableResolver,
-  formatCliNotFoundMessage,
-  type CliResolverHost,
-} from './cli-executable-resolver.js';
+import { createCliExecutableResolver, type CliResolverHost } from './cli-executable-resolver.js';
 
 /**
  * Directories probed after `which`, read from this CLI's registry entry so the spawn
@@ -42,8 +38,6 @@ const OMP_SEARCH_DIRS = (): string[] => (getCli('omp')?.discovery.searchDirs ??
  */
 export const OMP_VERSION_REGEX = /(?:^|\s)omp\/(\d+\.\d+\.\d+)/;
 
-const OMP_NOT_FOUND = 'OMP CLI not found. Install with: curl -fsSL https://omp.sh/install | sh';
-
 /**
  * Run `omp --version` on a candidate path and return the trimmed version when
  * it looks like the coding agent. Returns null for anything else — a missing
@@ -125,10 +119,6 @@ export function isOmpAvailable(): boolean {
   return resolveOmpDir() !== null;
 }
 
-export function getOmpNotFoundMessage(): string {
-  return formatCliNotFoundMessage(OMP_NOT_FOUND, ompResolver.diagnostics());
-}
-
 /**
  * Version reported by the resolved `omp` binary, or null when omp is
  * unavailable. Surfaced through `GET /api/omp/status` so a misresolution is

src/utils/opencode-cli-resolver.ts

@@ -9,7 +9,7 @@
 
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import { createCliExecutableResolver, formatCliNotFoundMessage } from './cli-executable-resolver.js';
+import { createCliExecutableResolver } from './cli-executable-resolver.js';
 
 /** Common directories where the OpenCode CLI binary may be installed */
 /**
@@ -20,7 +20,6 @@ import { createCliExecutableResolver, formatCliNotFoundMessage } from './cli-exe
 const OPENCODE_SEARCH_DIRS = (): string[] => (getCli('opencode')?.discovery.searchDirs ?? []).map(expandHome);
 
 const openCodeResolver = createCliExecutableResolver({ binary: 'opencode', searchDirs: OPENCODE_SEARCH_DIRS });
-const OPENCODE_NOT_FOUND = 'OpenCode CLI not found. Install with: curl -fsSL https://opencode.ai/install | bash';
 
 /**
  * Finds the directory containing the `opencode` binary.
@@ -39,7 +38,3 @@ export function resolveOpenCodeDir(): string | null {
 export function isOpenCodeAvailable(): boolean {
   return resolveOpenCodeDir() !== null;
 }
-
-export function getOpenCodeNotFoundMessage(): string {
-  return formatCliNotFoundMessage(OPENCODE_NOT_FOUND, openCodeResolver.diagnostics());
-}

src/utils/pi-cli-resolver.ts

@@ -19,11 +19,7 @@ import { execFileSync } from 'node:child_process';
 import { EXEC_TIMEOUT_MS } from '../config/exec-timeout.js';
 import { getCli } from '../config/cli-registry/registry.js';
 import { expandHome } from './cli-resolver.js';
-import {
-  createCliExecutableResolver,
-  formatCliNotFoundMessage,
-  type CliResolverHost,
-} from './cli-executable-resolver.js';
+import { createCliExecutableResolver, type CliResolverHost } from './cli-executable-resolver.js';
 
 /** Common directories where the Pi CLI binary may be installed */
 /**
@@ -48,8 +44,6 @@ const PI_SEARCH_DIRS = (): string[] => (getCli('pi')?.discovery.searchDirs ?? []
  */
 export const PI_VERSION_REGEX = /(?:^|\s)(\d+\.\d+\.\d+)/;
 
-const PI_NOT_FOUND = 'Pi CLI not found. Install with: npm install -g --ignore-scripts @earendil-works/pi-coding-agent';
-
 /**
  * Run `pi --version` on a candidate path and return the trimmed version when it
  * looks like the coding agent. Returns null for anything else — a missing
@@ -132,10 +126,6 @@ export function isPiAvailable(): boolean {
   return resolvePiDir() !== null;
 }
 
-export function getPiNotFoundMessage(): string {
-  return formatCliNotFoundMessage(PI_NOT_FOUND, piResolver.diagnostics());
-}
-
 /**
  * Version reported by the resolved `pi` binary, or null when pi is unavailable.
  * Surfaced through `GET /api/pi/status` so a misresolution is diagnosable from the UI.