@alumbwe/anvil 1.0.0 → 1.0.1

package/src/utils/terminal-watchdog.ts

@@ -1,366 +0,0 @@
-/**
- * Sacrificial watchdog process that resets the terminal if the CLI dies
- * without running its own cleanup (SIGKILL, native crash, group kill).
- *
- * The in-process handlers (renderer-cleanup.ts) cover catchable exits, and
- * the npm wrapper resets when it outlives the binary — but neither survives
- * `pkill -9 node`-style sweeps that take out the wrapper and binary together,
- * and dev/direct-binary runs have no wrapper at all. This covers those.
- *
- * POSIX:
- * - We spawn a detached `/bin/sh` whose stdin is a pipe from this process.
- *   `sh` isn't named node/bun/anvil/freebuff, so process-name kill sweeps
- *   miss it, and `detached` puts it in its own session so process-group kills
- *   miss it too.
- * - The watchdog blocks on `cat` until the pipe hits EOF — which only happens
- *   when this process is gone, however it died — then writes the reset
- *   sequences to its stdout, which is a dup of our stdout (the terminal).
- *   It must NOT open /dev/tty: being in its own session it has no controlling
- *   terminal, so that open fails with ENXIO. Writing to an inherited tty fd
- *   needs no controlling terminal.
- * - On clean shutdown the CLI first writes reset bytes synchronously to the
- *   controlling terminal, then SIGKILLs the watchdog. If that direct write
- *   fails, the watchdog remains armed and repairs the terminal after exit.
- *
- * Windows (closes the anvil#843 after-exit gap, where the hosting
- * terminal keeps sending mouse/focus VT input that the shell echoes as
- * `^[[<35;12;7M` gibberish):
- * - Bun/libuv put direct children in a kill-on-job-close job object, so a
- *   plain child — detached or not — is terminated the moment we die
- *   (oven-sh/bun#31603) and can never fire. Grandchildren of job members are
- *   NOT added to the job (silent-breakaway semantics), so we launch a
- *   short-lived PowerShell bootstrap (in the job; its death doesn't matter)
- *   that uses Start-Process -NoNewWindow to spawn the real watchdog outside
- *   the job, attached to our console.
- * - The pipe/EOF trick can't cross the bootstrap hop, so the watchdog
- *   detects our death with `Wait-Process -Id <our pid>` instead, then writes
- *   the reset sequences to its console stdout (ConPTY forwards the disable
- *   sequences to the hosting terminal).
- * - We hold no handle to the grandchild, so clean shutdown can't kill it.
- *   After a confirmed synchronous reset, stopTerminalWatchdog() drops a disarm
- *   file; the watchdog checks it after Wait-Process and exits silently.
- * - Windows PowerShell 5.1 always exists and is invoked by absolute path.
- *   Scripts are passed as plain -Command text so the command lines stay
- *   human-readable in process listings (encoded PowerShell spawned by a CLI
- *   is a classic EDR/AV malware heuristic). They are deliberately built
- *   without double quotes, which makes that quoting-safe — see
- *   spawnWindowsWatchdog.
- * - Arming takes a few hundred ms (PowerShell boot); deaths inside that
- *   window fall back to the pre-existing behavior (npm wrapper or nothing).
- */
-import { spawn } from 'child_process'
-import { closeSync, existsSync, openSync, rmSync, writeFileSync } from 'fs'
-import os from 'os'
-import path from 'path'
-
-import { AnalyticsEvent } from '@anvil/common/constants/analytics-events'
-
-import { TERMINAL_RESET_SEQUENCES } from './terminal-reset-sequences'
-import { getCliEnv } from './env'
-import { reportWindowsTerminalFailure } from './windows-terminal-health'
-
-import type { ChildProcess } from 'child_process'
-
-let watchdog: ChildProcess | null = null
-let disarmFilePath: string | null = null
-let armedFilePath: string | null = null
-let armMonitor: ReturnType<typeof setTimeout> | null = null
-
-const WINDOWS_ARM_TIMEOUT_MS = 10_000
-
-export type TerminalWatchdogFailure = {
-  stage: 'spawn' | 'bootstrap' | 'arming'
-  failureCode:
-    | 'enoent'
-    | 'eacces'
-    | 'eperm'
-    | 'exit_nonzero'
-    | 'terminated'
-    | 'timeout'
-    | 'unknown'
-}
-
-export function classifyTerminalWatchdogSpawnFailure(
-  error: unknown,
-): TerminalWatchdogFailure['failureCode'] {
-  const code =
-    error && typeof error === 'object' && 'code' in error
-      ? String((error as NodeJS.ErrnoException).code ?? '').toUpperCase()
-      : ''
-  if (code === 'ENOENT') return 'enoent'
-  if (code === 'EACCES') return 'eacces'
-  if (code === 'EPERM') return 'eperm'
-  return 'unknown'
-}
-
-function reportTerminalWatchdogFailure(failure: TerminalWatchdogFailure): void {
-  reportWindowsTerminalFailure(AnalyticsEvent.TERMINAL_WATCHDOG_FAILED, failure)
-}
-
-function clearArmMonitor(): void {
-  if (armMonitor) clearTimeout(armMonitor)
-  armMonitor = null
-  if (armedFilePath) {
-    try {
-      rmSync(armedFilePath, { force: true })
-    } catch {
-      // The external watchdog also removes this marker when it exits.
-    }
-  }
-  armedFilePath = null
-}
-
-/** Read-only watchdog state for local process diagnostics. */
-export function getTerminalWatchdogDiagnostics() {
-  const external = disarmFilePath !== null
-  const childIsRunning = Boolean(
-    watchdog?.pid && watchdog.exitCode === null && watchdog.signalCode === null,
-  )
-  return {
-    armed: childIsRunning || external,
-    external,
-    pid: !external && childIsRunning ? watchdog?.pid : undefined,
-  }
-}
-
-/** Reset payload with ESC as printf-compatible octal escapes. */
-function printfPayload(): string {
-  return TERMINAL_RESET_SEQUENCES.replace(/\x1b/g, '\\033')
-}
-
-function spawnPosixWatchdog(overrideFd: number | null): ChildProcess {
-  // `cat` holds until our death closes the pipe; the reset then goes to the
-  // watchdog's stdout (see stdio below). The payload contains no quotes, so
-  // embedding it in single quotes is safe.
-  const script = `cat >/dev/null 2>&1; printf '${printfPayload()}'`
-  return spawn('/bin/sh', ['-c', script, 'terminal-reset-watchdog'], {
-    detached: true,
-    stdio: ['pipe', overrideFd ?? 'inherit', 'ignore'],
-  })
-}
-
-/** Single-quote a string for PowerShell (only ' needs escaping, by doubling). */
-function psQuote(value: string): string {
-  return `'${value.replace(/'/g, "''")}'`
-}
-
-function spawnWindowsWatchdog(options: {
-  ttyPath?: string
-  disarmPath: string
-  armedPath: string
-  powershellPath?: string
-}): ChildProcess {
-  // The payload rides as a numeric byte array, which keeps the script free of
-  // double quotes and string interpolation (the no-`"` invariant the quoting
-  // below relies on) and avoids any Console.Out encoding translation, so the
-  // reset payload arrives byte-exact.
-  const payloadBytes = Array.from(
-    Buffer.from(TERMINAL_RESET_SEQUENCES, 'ascii'),
-  ).join(',')
-  // Tests observe a file instead of the console; production writes to the
-  // watchdog's stdout, which is the console (Start-Process -NoNewWindow
-  // without redirection leaves the grandchild on our console's handles).
-  const writeResets = options.ttyPath
-    ? `[System.IO.File]::WriteAllBytes(${psQuote(options.ttyPath)}, $b)`
-    : '$s=[Console]::OpenStandardOutput(); $s.Write($b, 0, $b.Length); $s.Flush()'
-  // The marker lets tests wait out the bootstrap hop and lets production
-  // report a bounded arming timeout without inspecting PowerShell output.
-  const armedMarker = `[System.IO.File]::WriteAllText(${psQuote(options.armedPath)}, 'armed'); `
-  const watchdogScript =
-    armedMarker +
-    `try { Wait-Process -Id ${process.pid} -ErrorAction Stop } catch {}; ` +
-    `if (Test-Path -LiteralPath ${psQuote(options.disarmPath)}) { ` +
-    `Remove-Item -LiteralPath ${psQuote(options.disarmPath)} -Force -ErrorAction SilentlyContinue ` +
-    `} else { ` +
-    `$b=[byte[]](${payloadBytes}); ` +
-    `${writeResets} }; ` +
-    `Remove-Item -LiteralPath ${psQuote(options.armedPath)} -Force -ErrorAction SilentlyContinue`
-
-  // Windows PowerShell 5.1 ships with every supported Windows; use the
-  // absolute path so a broken PATH can't take out the safety net.
-  const powershell =
-    options.powershellPath ??
-    path.join(
-      getCliEnv().SystemRoot ?? 'C:\\Windows',
-      'System32',
-      'WindowsPowerShell',
-      'v1.0',
-      'powershell.exe',
-    )
-
-  // Plain -Command (not -EncodedCommand) so the command lines are auditable
-  // in process listings — encoded PowerShell trips EDR/AV heuristics. This is
-  // quoting-safe because the watchdog script contains no `"` (paths are
-  // single-quoted, the payload is numeric): it survives as the one
-  // double-quoted region of the grandchild's argument string, which
-  // Start-Process passes verbatim (single pre-built -ArgumentList string). On
-  // the bootstrap's own command line those `"` are escaped as \" by spawn,
-  // which powershell.exe's argv tokenizer unescapes.
-  const watchdogArgs = `-NoProfile -NonInteractive -Command "${watchdogScript}"`
-  const bootstrapScript =
-    `Start-Process -FilePath ${psQuote(powershell)} ` +
-    `-ArgumentList ${psQuote(watchdogArgs)} -NoNewWindow`
-
-  return spawn(
-    powershell,
-    ['-NoProfile', '-NonInteractive', '-Command', bootstrapScript],
-    {
-      stdio: ['ignore', 'ignore', 'ignore'],
-    },
-  )
-}
-
-const isTruthy = (value: string | undefined): boolean =>
-  value === '1' || value?.toLowerCase() === 'true'
-
-/**
- * Start the watchdog. Call once, before the TUI renderer starts enabling
- * terminal modes. No-op when stdout isn't a TTY (unless an explicit ttyPath
- * is injected, e.g. in tests), or if already started.
- *
- * Also a no-op when ANVIL_NO_TERMINAL_WATCHDOG is set. This remains an
- * explicit escape hatch for Windows endpoint-security policies that reject the
- * out-of-job PowerShell grandchild used by the recovery path.
- *
- * @param options.ttyPath - Override the reset target (POSIX: the watchdog's
- *   stdout is pointed at this file; Windows: the watchdog writes the payload
- *   to this file and drops a `<ttyPath>.armed` marker once running). Tests
- *   inject a regular file here to observe what gets written.
- */
-export function startTerminalWatchdog(options?: {
-  ttyPath?: string
-  reportFailure?: (failure: TerminalWatchdogFailure) => void
-  /** Test-only override for exercising Windows spawn failures. */
-  windowsPowerShellPath?: string
-}): void {
-  if (watchdog) return
-  const env = getCliEnv()
-  if (isTruthy(env.ANVIL_NO_TERMINAL_WATCHDOG)) return
-  if (!options?.ttyPath && !process.stdout.isTTY) return
-
-  const reportFailure = options?.reportFailure ?? reportTerminalWatchdogFailure
-  let overrideFd: number | null = null
-  try {
-    let child: ChildProcess
-    if (process.platform === 'win32') {
-      const disarmPath = path.join(
-        os.tmpdir(),
-        `anvil-watchdog-disarm-${process.pid}-${Math.random().toString(36).slice(2)}`,
-      )
-      const armedPath = options?.ttyPath
-        ? `${options.ttyPath}.armed`
-        : `${disarmPath}.armed`
-      child = spawnWindowsWatchdog({
-        ttyPath: options?.ttyPath,
-        disarmPath,
-        armedPath,
-        powershellPath: options?.windowsPowerShellPath,
-      })
-      disarmFilePath = disarmPath
-      if (!options?.ttyPath) {
-        armedFilePath = armedPath
-      }
-    } else {
-      if (options?.ttyPath) {
-        overrideFd = openSync(options.ttyPath, 'w')
-      }
-      child = spawnPosixWatchdog(overrideFd)
-    }
-    let failureReported = false
-    const reportOnce = (failure: TerminalWatchdogFailure) => {
-      if (failureReported) return
-      failureReported = true
-      reportFailure(failure)
-    }
-    const fail = (failure: TerminalWatchdogFailure) => {
-      if (failureReported || watchdog !== child) return
-      watchdog = null
-      disarmFilePath = null
-      clearArmMonitor()
-      reportOnce(failure)
-    }
-    child.on('error', (error) => {
-      fail({
-        stage: 'spawn',
-        failureCode: classifyTerminalWatchdogSpawnFailure(error),
-      })
-    })
-    if (process.platform === 'win32') {
-      child.on('exit', (code, signal) => {
-        if (code === 0 || watchdog !== child) return
-        fail({
-          stage: 'bootstrap',
-          failureCode: signal ? 'terminated' : 'exit_nonzero',
-        })
-      })
-    }
-    // Don't let the watchdog (or our write end of its pipe) hold the event
-    // loop open — the CLI must still be able to exit naturally. stdin is a
-    // Socket at runtime; its unref isn't in the Writable type.
-    child.unref()
-    child.stdin?.on('error', () => {})
-    ;(child.stdin as { unref?: () => void } | null)?.unref?.()
-    watchdog = child
-    if (armedFilePath) {
-      const expectedMarker = armedFilePath
-      armMonitor = setTimeout(() => {
-        if (watchdog !== child) return
-        const armed = existsSync(expectedMarker)
-        clearArmMonitor()
-        if (!armed) {
-          reportOnce({ stage: 'arming', failureCode: 'timeout' })
-        }
-      }, WINDOWS_ARM_TIMEOUT_MS)
-      ;(armMonitor as { unref?: () => void }).unref?.()
-    }
-  } catch (error) {
-    disarmFilePath = null
-    clearArmMonitor()
-    if (process.platform === 'win32') {
-      reportFailure({
-        stage: 'spawn',
-        failureCode: classifyTerminalWatchdogSpawnFailure(error),
-      })
-    }
-    // Best-effort: no watchdog is the pre-existing behavior.
-  } finally {
-    if (overrideFd !== null) {
-      try {
-        closeSync(overrideFd) // the child holds its own dup
-      } catch {
-        // Ignore close errors
-      }
-    }
-  }
-}
-
-/**
- * Disarm the watchdog after the clean-shutdown path has synchronously restored
- * the terminal. Safe to call multiple times and synchronous, so it also works
- * inside a process 'exit' handler.
- */
-export function stopTerminalWatchdog(): void {
-  const child = watchdog
-  const disarm = disarmFilePath
-  if (!child && !disarm) return
-  watchdog = null
-  disarmFilePath = null
-  clearArmMonitor()
-  if (disarm) {
-    // Windows: the real watchdog is a grandchild we hold no handle to; it
-    // checks for this file after our death and stays silent when present.
-    try {
-      writeFileSync(disarm, '')
-    } catch {
-      // Best-effort; worst case the watchdog writes resets on a clean exit,
-      // which the terminal treats as no-ops.
-    }
-  }
-  if (child) {
-    try {
-      child.kill('SIGKILL')
-    } catch {
-      // Already dead — nothing to stop.
-    }
-  }
-}

package/src/utils/text-layout.ts

@@ -1,149 +0,0 @@
-import stringWidth from 'string-width'
-
-// Keep measurement logic centralised so components can share consistent wrap behavior.
-function measureLines(text: string, cols: number): number {
-  if (text.length === 0) return 1
-
-  let lines = 1
-  let current = 0
-  const tokens = text.split(/(\s+)/)
-
-  const emitHardWrap = () => {
-    lines += 1
-    current = 0
-  }
-
-  const appendSegment = (
-    segment: string,
-    { flushBeforeOversize = true }: { flushBeforeOversize?: boolean } = {},
-  ) => {
-    if (!segment) return
-
-    const segmentWidth = stringWidth(segment)
-    if (segmentWidth > cols) {
-      if (flushBeforeOversize && current > 0) emitHardWrap()
-      let acc = 0
-      for (const ch of Array.from(segment)) {
-        const w = stringWidth(ch)
-        if (acc + w > cols) {
-          emitHardWrap()
-          acc = 0
-        }
-        acc += w
-      }
-      current = acc
-      return
-    }
-
-    if (current + segmentWidth > cols) emitHardWrap()
-    current += segmentWidth
-  }
-
-  for (const token of tokens) {
-    if (!token) continue
-
-    if (token.includes('\n')) {
-      const parts = token.split('\n')
-      for (let i = 0; i < parts.length; i++) {
-        appendSegment(parts[i], { flushBeforeOversize: false })
-        if (i < parts.length - 1) emitHardWrap()
-      }
-      continue
-    }
-
-    appendSegment(token)
-  }
-
-  return lines
-}
-
-export function getLastNVisualLines(text: string, cols: number, n: number): { lines: string[]; hasMore: boolean } {
-  if (n <= 0 || cols <= 0) return { lines: [], hasMore: false }
-  const lines: string[] = []
-  if (!text) return { lines, hasMore: false }
-
-  const tokens = text.split(/(\s+)/)
-  let current = ''
-  let currentWidth = 0
-
-  const pushLine = () => {
-    lines.push(current)
-    current = ''
-    currentWidth = 0
-  }
-
-  const appendSegment = (segment: string) => {
-    if (!segment) return
-    const segWidth = stringWidth(segment)
-
-    if (segWidth > cols) {
-      for (const ch of Array.from(segment)) {
-        const w = stringWidth(ch)
-        if (currentWidth + w > cols) pushLine()
-        current += ch
-        currentWidth += w
-      }
-      return
-    }
-
-    if (currentWidth + segWidth > cols) pushLine()
-    current += segment
-    currentWidth += segWidth
-  }
-
-  for (const token of tokens) {
-    if (!token) continue
-    if (token.includes('\n')) {
-      const parts = token.split('\n')
-      for (let i = 0; i < parts.length; i++) {
-        appendSegment(parts[i])
-        if (i < parts.length - 1) pushLine()
-      }
-      continue
-    }
-    appendSegment(token)
-  }
-
-  if (current.length > 0 || lines.length === 0) pushLine()
-  const hasMore = lines.length > n
-  const lastLines = lines.slice(-n)
-  return { lines: lastLines, hasMore }
-}
-
-export function computeInputLayoutMetrics({
-  layoutContent,
-  cursorProbe,
-  cols,
-  maxHeight,
-  minHeight = 1,
-}: {
-  layoutContent: string
-  cursorProbe: string
-  cols: number
-  maxHeight: number
-  minHeight?: number
-}): { heightLines: number; gutterEnabled: boolean } {
-  const safeMaxHeight = Math.max(1, maxHeight)
-  const effectiveMinHeight = Math.max(
-    1,
-    Math.min(minHeight ?? 1, safeMaxHeight),
-  )
-  const totalLines = measureLines(layoutContent, cols)
-  const cursorLines = measureLines(cursorProbe, cols)
-
-  // Add bottom gutter when cursor is on line 2 of exactly 2 lines
-  const gutterEnabled =
-    totalLines === 2 && cursorLines === 2 && totalLines + 1 <= safeMaxHeight
-
-  const rawHeight = Math.min(
-    totalLines + (gutterEnabled ? 1 : 0),
-    safeMaxHeight,
-  )
-
-  const heightLines = Math.max(effectiveMinHeight, rawHeight)
-
-  return {
-    heightLines,
-    gutterEnabled,
-  }
-}

package/src/utils/theme-config.ts

@@ -1,141 +0,0 @@
-/**
- * Theme Configuration System
- *
- * Provides plugin system and customization support for themes
- */
-
-import type { ChatTheme } from '../types/theme-system'
-
-/**
- * Plugin interface for extending theme system
- * Plugins can modify themes at runtime
- */
-export interface ThemePlugin {
-  /** Unique plugin name */
-  name: string
-  /**
-   * Apply plugin modifications to a theme
-   * @param theme - The base theme
-   * @param mode - The detected light/dark mode
-   * @returns Partial theme to merge
-   */
-  apply: (
-    theme: ChatTheme,
-    mode: 'dark' | 'light',
-  ) => Partial<ChatTheme>
-}
-
-/**
- * Main theme configuration interface
- */
-export interface ThemeConfig {
-  /** Global color overrides applied to themes */
-  customColors?: Partial<ChatTheme>
-  /** Registered plugins for theme extensions */
-  plugins?: ThemePlugin[]
-}
-
-/**
- * Default theme configuration
- */
-export const defaultThemeConfig: ThemeConfig = {
-  customColors: {},
-  plugins: [],
-}
-
-/**
- * Active theme configuration
- * Can be modified at runtime for customization
- */
-export let themeConfig: ThemeConfig = defaultThemeConfig
-
-/**
- * Update the active theme configuration
- * @param config - New configuration (will be merged with defaults)
- */
-export const setThemeConfig = (config: Partial<ThemeConfig>): void => {
-  themeConfig = {
-    ...defaultThemeConfig,
-    ...config,
-    plugins: [...(defaultThemeConfig.plugins ?? []), ...(config.plugins ?? [])],
-  }
-}
-
-/**
- * Register a theme plugin
- * @param plugin - Plugin to register
- */
-export const registerThemePlugin = (plugin: ThemePlugin): void => {
-  if (!themeConfig.plugins) {
-    themeConfig.plugins = []
-  }
-  // Check if plugin already registered
-  if (themeConfig.plugins.some((p) => p.name === plugin.name)) {
-    console.warn(`Theme plugin "${plugin.name}" is already registered`)
-    return
-  }
-  themeConfig.plugins.push(plugin)
-}
-
-/**
- * Resolve 'default' color values to fallback colors
- * Components should never see 'default' - it's resolved during theme building
- */
-const resolveThemeColors = (theme: ChatTheme, mode: 'dark' | 'light'): void => {
-  const defaultFallback = mode === 'dark' ? '#ffffff' : '#000000'
-
-  const resolve = (value: string, fallback: string = defaultFallback): string => {
-    if (typeof value === 'string') {
-      const normalized = value.trim().toLowerCase()
-      if (normalized === 'default' || normalized.length === 0) {
-        return fallback
-      }
-      return value
-    }
-    return fallback
-  }
-
-  // Resolve all ThemeColor properties to actual colors
-  theme.foreground = resolve(theme.foreground)
-  theme.muted = resolve(theme.muted)
-  theme.inputFg = resolve(theme.inputFg)
-  theme.inputFocusedFg = resolve(theme.inputFocusedFg)
-}
-
-/**
- * Build a complete theme by applying custom colors and plugins
- * All 'default' color values are resolved to actual colors
- * @param baseTheme - The base theme to start from
- * @param mode - Current theme mode (dark or light)
- * @param customColors - Optional custom color overrides
- * @param plugins - Optional theme plugins to apply
- * @returns Complete theme with all customizations applied
- */
-export const buildTheme = (
-  baseTheme: ChatTheme,
-  mode: 'dark' | 'light',
-  customColors?: Partial<ChatTheme>,
-  plugins?: ThemePlugin[],
-): ChatTheme => {
-  // Start with cloned base theme (cloning handled by caller)
-  const theme = { ...baseTheme }
-
-  // Layer 1: Apply global custom colors
-  if (customColors) {
-    Object.assign(theme, customColors)
-  }
-
-  // Layer 2: Apply plugins
-  if (plugins) {
-    for (const plugin of plugins) {
-      const pluginOverrides = plugin.apply(theme, mode)
-      Object.assign(theme, pluginOverrides)
-    }
-  }
-
-  // Final step: Resolve all 'default' values to actual colors
-  resolveThemeColors(theme, mode)
-  theme.name = mode
-
-  return theme
-}