aicodeman 0.2.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Claudeman Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,403 @@
+<p align="center">
+  <img src="docs/images/codeman-title.svg" alt="Codeman" height="60">
+</p>
+
+<h2 align="center">The missing control plane for AI coding agents</h2>
+
+<p align="center">
+  <em>Agent Visualization &bull; Zero-Lag Input Overlay &bull; Mobile-First UI &bull; Respawn Controller &bull; Multi-Session Dashboard </em>
+</p>
+
+<p align="center">
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-1e3a5f?style=flat-square" alt="License: MIT"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-18%2B-22c55e?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 18+"></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.5-3b82f6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript 5.5"></a>
+  <a href="https://fastify.dev/"><img src="https://img.shields.io/badge/Fastify-5.x-1e3a5f?style=flat-square&logo=fastify&logoColor=white" alt="Fastify"></a>
+  <img src="https://img.shields.io/badge/Tests-1435%20total-22c55e?style=flat-square" alt="Tests">
+</p>
+
+<p align="center">
+  <img src="docs/images/subagent-demo.gif" alt="Codeman — parallel subagent visualization" width="900">
+</p>
+
+---
+
+## Quick Start - Installation
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Ark0N/Codeman/master/install.sh | bash
+```
+
+This installs Node.js and tmux if missing, clones Codeman to `~/.codeman/app`, and builds it. You'll need at least one AI coding CLI installed — [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or [OpenCode](https://opencode.ai) (or both). After install:
+
+```bash
+codeman web
+# Open http://localhost:3000 — press Ctrl+Enter to start your first session
+```
+
+**Update to latest version:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/Ark0N/Codeman/master/install.sh | bash -s update
+```
+
+<details>
+<summary><strong>Run as a background service</strong></summary>
+
+**Linux (systemd):**
+```bash
+mkdir -p ~/.config/systemd/user && printf '[Unit]\nDescription=Codeman Web Server\nAfter=network.target\n\n[Service]\nType=simple\nExecStart=%s %s/dist/index.js web\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=default.target\n' "$(which node)" "$HOME/.codeman/app" > ~/.config/systemd/user/codeman-web.service && systemctl --user daemon-reload && systemctl --user enable --now codeman-web && loginctl enable-linger $USER
+```
+
+**macOS (launchd):**
+```bash
+mkdir -p ~/Library/LaunchAgents && printf '<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0"><dict><key>Label</key><string>com.codeman.web</string><key>ProgramArguments</key><array><string>%s</string><string>%s/dist/index.js</string><string>web</string></array><key>RunAtLoad</key><true/><key>KeepAlive</key><true/><key>StandardOutPath</key><string>/tmp/codeman.log</string><key>StandardErrorPath</key><string>/tmp/codeman.log</string></dict></plist>\n' "$(which node)" "$HOME/.codeman/app" > ~/Library/LaunchAgents/com.codeman.web.plist && launchctl load ~/Library/LaunchAgents/com.codeman.web.plist
+```
+</details>
+
+<details>
+<summary><strong>Windows (WSL)</strong></summary>
+
+```powershell
+wsl bash -c "curl -fsSL https://raw.githubusercontent.com/Ark0N/Codeman/master/install.sh | bash"
+```
+
+Codeman requires tmux, so Windows users need [WSL](https://learn.microsoft.com/en-us/windows/wsl/install). If you don't have WSL yet: run `wsl --install` in an admin PowerShell, reboot, open Ubuntu, then install your preferred AI coding CLI inside WSL ([Claude Code](https://docs.anthropic.com/en/docs/claude-code) or [OpenCode](https://opencode.ai)). After installing, `http://localhost:3000` is accessible from your Windows browser.
+</details>
+
+---
+
+## Mobile-Optimized Web UI
+
+The most responsive AI coding agent experience on any phone. Full xterm.js terminal with local echo, swipe navigation, and a touch-optimized interface designed for real remote work.
+
+<table>
+<tr>
+<td rowspan="8" width="320"><img src="docs/screenshots/mobile-keyboard-open.png" alt="Mobile — keyboard open" width="300"></td>
+<th>Terminal Apps</th>
+<th>Codeman Mobile</th>
+</tr>
+<tr><td>200-300ms input lag over remote</td><td><b>Local echo — instant feedback</b></td></tr>
+<tr><td>Tiny text, no context</td><td>Full xterm.js terminal</td></tr>
+<tr><td>No session management</td><td>Swipe between sessions</td></tr>
+<tr><td>No notifications</td><td>Push alerts for approvals and idle</td></tr>
+<tr><td>Manual reconnect</td><td>tmux persistence</td></tr>
+<tr><td>No agent visibility</td><td>Background agents in real-time</td></tr>
+<tr><td>Copy-paste slash commands</td><td>One-tap <code>/init</code></tr>
+</table>
+
+- **Swipe navigation** — left/right on the terminal to switch sessions (80px threshold, 300ms)
+- **Keyboard accessory bar** — `/init`, `/clear`, `/compact` quick-action buttons above the virtual keyboard. Destructive commands (`/clear`, `/compact`) require a double-press to confirm — first tap arms the button, second tap executes — so you never fire one by accident on a bumpy commute
+- **Smart keyboard handling** — toolbar and terminal shift up when keyboard opens (uses `visualViewport` API with 100px threshold for iOS address bar drift)
+- **Safe area support** — respects iPhone notch and home indicator via `env(safe-area-inset-*)`
+- **44px touch targets** — all buttons meet iOS Human Interface Guidelines minimum sizes
+- **Bottom sheet case picker** — slide-up modal replaces the desktop dropdown
+- **Native momentum scrolling** — `-webkit-overflow-scrolling: touch` for buttery scroll
+
+```bash
+codeman web --https
+# Open on your phone: https://<your-ip>:3000
+```
+
+> `localhost` works over plain HTTP. Use `--https` when accessing from another device, or use [Tailscale](https://tailscale.com/) (recommended) — it provides a private network so you can access `http://<tailscale-ip>:3000` from your phone without TLS certificates.
+
+---
+
+## Live Agent Visualization
+
+Watch background agents work in real-time. Codeman monitors agent activity and displays each agent in a draggable floating window with animated Matrix-style connection lines back to the parent session.
+
+<p align="center">
+  <img src="docs/images/subagent-spawn.png" alt="Subagent Visualization" width="900">
+</p>
+
+- **Floating terminal windows** — draggable, resizable panels for each agent with a live activity log showing every tool call, file read, and progress update as it happens
+- **Connection lines** — animated green lines linking parent sessions to their child agents, updating in real-time as agents spawn and complete
+- **Status & model badges** — green (active), yellow (idle), blue (completed) indicators with Haiku/Sonnet/Opus model color coding
+- **Auto-behavior** — windows auto-open on spawn, auto-minimize on completion, tab badge shows "AGENT" or "AGENTS (n)" count
+- **Nested agents** — supports 3-level hierarchies (lead session -> teammate agents -> sub-subagents)
+
+---
+
+## Zero-Lag Input Overlay
+
+When accessing your coding agent remotely (VPN, Tailscale, SSH tunnel), every keystroke normally takes 200-300ms to round-trip. Codeman implements a **Mosh-inspired local echo system** that makes typing feel instant regardless of latency.
+
+A pixel-perfect DOM overlay inside xterm.js renders keystrokes at 0ms. Background forwarding silently sends every character to the PTY in 50ms debounced batches, so Tab completion, `Ctrl+R` history search, and all shell features work normally. When the server echo arrives 200-300ms later, the overlay seamlessly disappears and the real terminal text takes over — the transition is invisible.
+
+- **Ink-proof architecture** — lives as a `<span>` at z-index 7 inside `.xterm-screen`, completely immune to Ink's constant screen redraws (two previous attempts using `terminal.write()` failed because Ink corrupts injected buffer content)
+- **Font-matched rendering** — reads `fontFamily`, `fontSize`, `fontWeight`, and `letterSpacing` from xterm.js computed styles so overlay text is visually indistinguishable from real terminal output
+- **Full editing** — backspace, retype, paste (multi-char), cursor tracking, multi-line wrap when input exceeds terminal width
+- **Persistent across reconnects** — unsent input survives page reloads via localStorage
+- **Enabled by default** — works on both desktop and mobile, during idle and busy sessions
+
+> Extracted as a standalone library: [`xterm-zerolag-input`](https://www.npmjs.com/package/xterm-zerolag-input) — see [Published Packages](#published-packages).
+
+---
+
+## Respawn Controller
+
+The core of autonomous work. When the agent goes idle, the Respawn Controller detects it, sends a continue prompt, cycles context management commands for fresh context, and resumes — running **24+ hours** completely unattended.
+
+```
+WATCHING → IDLE DETECTED → SEND UPDATE → /clear → /init → CONTINUE → WATCHING
+```
+
+- **Multi-layer idle detection** — completion messages, AI-powered idle check, output silence, token stability
+- **Circuit breaker** — prevents respawn thrashing when Claude is stuck (CLOSED -> HALF_OPEN -> OPEN states, tracks consecutive no-progress and repeated errors)
+- **Health scoring** — 0-100 health score with component scores for cycle success, circuit breaker state, iteration progress, and stuck recovery
+- **Built-in presets** — `solo-work` (3s idle, 60min), `subagent-workflow` (45s, 240min), `team-lead` (90s, 480min), `ralph-todo` (8s, 480min), `overnight-autonomous` (10s, 480min)
+
+---
+
+## Multi-Session Dashboard
+
+Run **20 parallel sessions** with full visibility — real-time xterm.js terminals at 60fps, per-session token and cost tracking, tab-based navigation, and one-click management.
+
+<p align="center">
+  <img src="docs/screenshots/multi-session-dashboard.png" alt="Multi-Session Dashboard" width="800">
+</p>
+
+### Persistent Sessions
+
+Every session runs inside **tmux** — sessions survive server restarts, network drops, and machine sleep. Auto-recovery on startup with dual redundancy. Ghost session discovery finds orphaned tmux sessions. Managed sessions are environment-tagged so the agent won't kill its own session.
+
+### Smart Token Management
+
+| Threshold | Action | Result |
+|-----------|--------|--------|
+| **110k tokens** | Auto `/compact` | Context summarized, work continues |
+| **140k tokens** | Auto `/clear` | Fresh start with `/init` |
+
+### Notifications
+
+Real-time desktop alerts when sessions need attention — `permission_prompt` and `elicitation_dialog` trigger critical red tab blinks, `idle_prompt` triggers yellow blinks. Click any notification to jump directly to the affected session. Hooks auto-configured per case directory.
+
+### Ralph / Todo Tracking
+
+Auto-detects Ralph Loops, `<promise>` tags, TodoWrite progress (`4/9 complete`), and iteration counters (`[5/50]`) with real-time progress rings and elapsed time tracking.
+
+<p align="center">
+  <img src="docs/images/ralph-tracker-8tasks-44percent.png" alt="Ralph Loop Tracking" width="800">
+</p>
+
+### Run Summary
+
+Click the chart icon on any session tab to see a timeline of everything that happened — respawn cycles, token milestones, auto-compact triggers, idle/working transitions, hook events, errors, and more.
+
+### Zero-Flicker Terminal
+
+Terminal-based AI agents (Claude Code's Ink, OpenCode's Bubble Tea) redraw the screen on every state change. Codeman implements a 6-layer anti-flicker pipeline for smooth 60fps output across all sessions:
+
+```
+PTY Output → 16ms Server Batch → DEC 2026 Wrap → SSE → Client rAF → xterm.js (60fps)
+```
+
+---
+
+## Remote Access — Cloudflare Tunnel
+
+Access Codeman from your phone or any device outside your local network using a free [Cloudflare quick tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/do-more-with-tunnels/trycloudflare/) — no port forwarding, no DNS, no static IP required.
+
+```
+Browser (phone/tablet) → Cloudflare Edge (HTTPS) → cloudflared → localhost:3000
+```
+
+**Prerequisites:** Install [`cloudflared`](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) and set `CODEMAN_PASSWORD` in your environment.
+
+```bash
+# Quick start
+./scripts/tunnel.sh start      # Start tunnel, prints public URL
+./scripts/tunnel.sh url        # Show current URL
+./scripts/tunnel.sh stop       # Stop tunnel
+./scripts/tunnel.sh status     # Service status + URL
+```
+
+The script auto-installs a systemd user service on first run. The tunnel URL is a randomly generated `*.trycloudflare.com` address that changes each time the tunnel restarts.
+
+<details>
+<summary><strong>Persistent tunnel (survives reboots)</strong></summary>
+
+```bash
+# Enable as a persistent service
+systemctl --user enable codeman-tunnel
+loginctl enable-linger $USER
+
+# Or via the Codeman web UI: Settings → Tunnel → Toggle On
+```
+
+</details>
+
+<details>
+<summary><strong>Authentication</strong></summary>
+
+1. First request → browser shows Basic Auth prompt (username: `admin` or `CODEMAN_USERNAME`)
+2. On success → server issues a `codeman_session` cookie (24h TTL, auto-extends on activity)
+3. Subsequent requests authenticate silently via cookie
+4. 10 failed attempts per IP → 429 rate limit (15-minute decay)
+
+**Always set `CODEMAN_PASSWORD`** before exposing via tunnel — without it, anyone with the URL has full access to your sessions.
+
+</details>
+
+---
+
+## SSH Alternative (`sc`)
+
+If you prefer SSH (Termius, Blink, etc.), the `sc` command is a thumb-friendly session chooser:
+
+```bash
+sc              # Interactive chooser
+sc 2            # Quick attach to session 2
+sc -l           # List sessions
+```
+
+Single-digit selection (1-9), color-coded status, token counts, auto-refresh. Detach with `Ctrl+A D`.
+
+---
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+Enter` | Quick-start session |
+| `Ctrl+W` | Close session |
+| `Ctrl+Tab` | Next session |
+| `Ctrl+K` | Kill all sessions |
+| `Ctrl+L` | Clear terminal |
+| `Ctrl+Shift+R` | Restore terminal size |
+| `Ctrl/Cmd +/-` | Font size |
+| `Escape` | Close panels |
+
+---
+
+## API
+
+### Sessions
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/sessions` | List all |
+| `POST` | `/api/quick-start` | Create case + start session |
+| `DELETE` | `/api/sessions/:id` | Delete session |
+| `POST` | `/api/sessions/:id/input` | Send input |
+
+### Respawn
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `POST` | `/api/sessions/:id/respawn/enable` | Enable with config + timer |
+| `POST` | `/api/sessions/:id/respawn/stop` | Stop controller |
+| `PUT` | `/api/sessions/:id/respawn/config` | Update config |
+
+### Ralph / Todo
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/sessions/:id/ralph-state` | Get loop state + todos |
+| `POST` | `/api/sessions/:id/ralph-config` | Configure tracking |
+
+### Subagents
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/subagents` | List all background agents |
+| `GET` | `/api/subagents/:id` | Agent info and status |
+| `GET` | `/api/subagents/:id/transcript` | Full activity transcript |
+| `DELETE` | `/api/subagents/:id` | Kill agent process |
+
+### System
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/events` | SSE stream |
+| `GET` | `/api/status` | Full app state |
+| `POST` | `/api/hook-event` | Hook callbacks |
+| `GET` | `/api/sessions/:id/run-summary` | Timeline + stats |
+
+---
+
+## Architecture
+
+```mermaid
+flowchart TB
+    subgraph Codeman["CODEMAN"]
+        subgraph Frontend["Frontend Layer"]
+            UI["Web UI<br/><small>xterm.js + Agent Windows</small>"]
+            API["REST API<br/><small>Fastify</small>"]
+            SSE["SSE Events<br/><small>/api/events</small>"]
+        end
+
+        subgraph Core["Core Layer"]
+            SM["Session Manager"]
+            S1["Session (PTY)"]
+            S2["Session (PTY)"]
+            RC["Respawn Controller"]
+        end
+
+        subgraph Detection["Detection Layer"]
+            RT["Ralph Tracker"]
+            SW["Subagent Watcher<br/><small>~/.claude/projects/*/subagents</small>"]
+        end
+
+        subgraph Persistence["Persistence Layer"]
+            SCR["Mux Manager<br/><small>(tmux)</small>"]
+            SS["State Store<br/><small>state.json</small>"]
+        end
+
+        subgraph External["External"]
+            CLI["AI CLI<br/><small>Claude Code / OpenCode</small>"]
+            BG["Background Agents<br/><small>(Task tool)</small>"]
+        end
+    end
+
+    UI <--> API
+    API <--> SSE
+    API --> SM
+    SM --> S1
+    SM --> S2
+    SM --> RC
+    SM --> SS
+    S1 --> RT
+    S1 --> SCR
+    S2 --> SCR
+    RC --> SCR
+    SCR --> CLI
+    SW --> BG
+    SW --> SSE
+```
+
+---
+
+## Development
+
+```bash
+npm install
+npx tsx src/index.ts web    # Dev mode
+npm run build               # Production build
+npm test                    # Run tests
+```
+
+See [CLAUDE.md](./CLAUDE.md) for full documentation.
+
+---
+
+## Published Packages
+
+### [`xterm-zerolag-input`](https://www.npmjs.com/package/xterm-zerolag-input)
+
+[![npm](https://img.shields.io/npm/v/xterm-zerolag-input?style=flat-square&color=22c55e)](https://www.npmjs.com/package/xterm-zerolag-input)
+
+Instant keystroke feedback overlay for xterm.js. Eliminates perceived input latency over high-RTT connections by rendering typed characters immediately as a pixel-perfect DOM overlay. Zero dependencies, configurable prompt detection, full state machine with 78 tests.
+
+```bash
+npm install xterm-zerolag-input
+```
+
+[Full documentation](packages/xterm-zerolag-input/README.md)
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+---
+
+<p align="center">
+  <strong>Track sessions. Visualize agents. Control respawn. Let it run while you sleep.</strong>
+</p>

package/dist/ai-checker-base.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @fileoverview Base Class for AI Checker Components
+ *
+ * Provides shared functionality for AI-powered checkers that spawn fresh Claude CLI
+ * sessions to analyze terminal output. This base class handles:
+ * - Mux session spawning and cleanup
+ * - Temp file management for output capture
+ * - Polling for completion markers
+ * - Cooldown management
+ * - Error handling and consecutive error tracking
+ * - Event emission for state changes
+ *
+ * Subclasses implement:
+ * - `muxNamePrefix`: Prefix for mux session names (e.g., 'codeman-aicheck-')
+ * - `doneMarker`: Completion marker in output file (e.g., '__AICHECK_DONE__')
+ * - `tempFilePrefix`: Prefix for temp files (e.g., 'codeman-aicheck')
+ * - `logPrefix`: Prefix for log messages (e.g., '[AiIdleChecker]')
+ * - `buildPrompt()`: Build the prompt from terminal buffer
+ * - `parseVerdict()`: Parse the verdict from AI output
+ * - `getPositiveVerdict()`: Return the "positive" verdict that doesn't trigger cooldown
+ * - `defaultConfig`: Default configuration values
+ *
+ * @module ai-checker-base
+ */
+import { EventEmitter } from 'node:events';
+/** Base configuration shared by all AI checkers */
+export interface AiCheckerConfigBase {
+    /** Whether the checker is enabled */
+    enabled: boolean;
+    /** Model to use for the check */
+    model: string;
+    /** Maximum characters of terminal buffer to send */
+    maxContextChars: number;
+    /** Timeout for the check in ms */
+    checkTimeoutMs: number;
+    /** Cooldown after negative verdict in ms */
+    cooldownMs: number;
+    /** Cooldown after errors in ms */
+    errorCooldownMs: number;
+    /** Max consecutive errors before disabling */
+    maxConsecutiveErrors: number;
+}
+/** Status values shared by all AI checkers */
+export type AiCheckerStatus = 'ready' | 'checking' | 'cooldown' | 'disabled' | 'error';
+/** Base result structure for all AI checkers */
+export interface AiCheckerResultBase<V extends string> {
+    verdict: V;
+    reasoning: string;
+    durationMs: number;
+}
+/** Base state structure for all AI checkers */
+export interface AiCheckerStateBase<V extends string> {
+    status: AiCheckerStatus;
+    lastVerdict: V | null;
+    lastReasoning: string | null;
+    lastCheckDurationMs: number | null;
+    cooldownEndsAt: number | null;
+    consecutiveErrors: number;
+    totalChecks: number;
+    disabledReason: string | null;
+}
+/**
+ * Abstract base class for AI-powered checkers.
+ * Handles spawning Claude CLI in a mux session to analyze terminal output.
+ *
+ * @template V - The verdict type (e.g., 'IDLE' | 'WORKING' | 'ERROR')
+ * @template C - The configuration type
+ * @template R - The result type
+ * @template S - The state type
+ */
+export declare abstract class AiCheckerBase<V extends string, C extends AiCheckerConfigBase, R extends AiCheckerResultBase<V>, S extends AiCheckerStateBase<V>> extends EventEmitter {
+    protected config: C;
+    protected sessionId: string;
+    protected _status: AiCheckerStatus;
+    protected lastVerdict: V | null;
+    protected lastReasoning: string | null;
+    protected lastCheckDurationMs: number | null;
+    protected cooldownEndsAt: number | null;
+    protected cooldownTimer: NodeJS.Timeout | null;
+    protected consecutiveErrors: number;
+    protected totalChecks: number;
+    protected disabledReason: string | null;
+    protected checkMuxName: string | null;
+    protected checkTempFile: string | null;
+    protected checkPromptFile: string | null;
+    protected checkPollTimer: NodeJS.Timeout | null;
+    protected checkTimeoutTimer: NodeJS.Timeout | null;
+    protected checkStartTime: number;
+    protected checkCancelled: boolean;
+    protected checkResolve: ((result: R) => void) | null;
+    /** Prefix for mux session names (e.g., 'codeman-aicheck-') */
+    protected abstract readonly muxNamePrefix: string;
+    /** Marker written to temp file when check is complete */
+    protected abstract readonly doneMarker: string;
+    /** Prefix for temp files (e.g., 'codeman-aicheck') */
+    protected abstract readonly tempFilePrefix: string;
+    /** Prefix for log messages (e.g., '[AiIdleChecker]') */
+    protected abstract readonly logPrefix: string;
+    /** Description for log messages (e.g., 'AI idle check', 'AI plan check') */
+    protected abstract readonly checkDescription: string;
+    /**
+     * Build the prompt to send to Claude.
+     * @param terminalBuffer - The trimmed and stripped terminal buffer
+     * @returns The complete prompt string
+     */
+    protected abstract buildPrompt(terminalBuffer: string): string;
+    /**
+     * Parse the verdict from Claude's output.
+     * @param output - The raw output from Claude (without done marker)
+     * @returns The parsed verdict and reasoning, or null if unparseable
+     */
+    protected abstract parseVerdict(output: string): {
+        verdict: V;
+        reasoning: string;
+    } | null;
+    /**
+     * Get the "positive" verdict that indicates success and doesn't trigger cooldown.
+     * For idle checker this is 'IDLE', for plan checker this is 'PLAN_MODE'.
+     */
+    protected abstract getPositiveVerdict(): V;
+    /**
+     * Get the "negative" verdict that triggers cooldown.
+     * For idle checker this is 'WORKING', for plan checker this is 'NOT_PLAN_MODE'.
+     */
+    protected abstract getNegativeVerdict(): V;
+    /**
+     * Get the error verdict value.
+     */
+    protected abstract getErrorVerdict(): V;
+    /**
+     * Create an error result.
+     */
+    protected abstract createErrorResult(reasoning: string, durationMs: number): R;
+    /**
+     * Create a success result.
+     */
+    protected abstract createResult(verdict: V, reasoning: string, durationMs: number): R;
+    constructor(sessionId: string, defaultConfig: C, config?: Partial<C>);
+    /** Get the current status */
+    get status(): AiCheckerStatus;
+    /** Get comprehensive state for UI display */
+    getState(): S;
+    /** Check if the checker is on cooldown */
+    isOnCooldown(): boolean;
+    /** Get remaining cooldown time in ms */
+    getCooldownRemainingMs(): number;
+    /**
+     * Run an AI check against the provided terminal buffer.
+     * Spawns a fresh Claude CLI in a tmux session, captures output to temp file.
+     *
+     * @param terminalBuffer - Raw terminal output to analyze
+     * @returns The verdict result
+     */
+    check(terminalBuffer: string): Promise<R>;
+    /**
+     * Cancel an in-progress check.
+     * Kills the mux session and cleans up.
+     */
+    cancel(): void;
+    /** Reset all state for a new cycle */
+    reset(): void;
+    /** Update configuration at runtime */
+    updateConfig(config: Partial<C>): void;
+    /** Get current config */
+    getConfig(): C;
+    private runCheck;
+    private parseOutput;
+    private cleanupCheck;
+    private handleError;
+    private startCooldown;
+    private clearCooldown;
+    private disable;
+    private log;
+}
+//# sourceMappingURL=ai-checker-base.d.ts.map

package/dist/ai-checker-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-checker-base.d.ts","sourceRoot":"","sources":["../src/ai-checker-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA4B3C,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvF,gDAAgD;AAChD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM;IACnD,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM;IAClD,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AASD;;;;;;;;GAQG;AACH,8BAAsB,aAAa,CACjC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,mBAAmB,EAC7B,CAAC,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAChC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,CAC/B,SAAQ,YAAY;IACpB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACpB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAG5B,SAAS,CAAC,OAAO,EAAE,eAAe,CAAW;IAC7C,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,IAAI,CAAQ;IACvC,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9C,SAAS,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACpD,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC/C,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAQ;IACtD,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAK;IACxC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAK;IAClC,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/C,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7C,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9C,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChD,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAQ;IACvD,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAQ;IAC1D,SAAS,CAAC,cAAc,EAAE,MAAM,CAAK;IACrC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAS;IAC1C,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAI5D,8DAA8D;IAC9D,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAElD,yDAAyD;IACzD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE/C,sDAAsD;IACtD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEnD,wDAAwD;IACxD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE9C,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAIrD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAE9D;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAEzF;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,CAAC;IAE1C;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;IAE9E;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;gBAEzE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,GAAE,OAAO,CAAC,CAAC,CAAM;IAQxE,6BAA6B;IAC7B,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,6CAA6C;IAC7C,QAAQ,IAAI,CAAC;IAab,0CAA0C;IAC1C,YAAY,IAAI,OAAO;IAKvB,wCAAwC;IACxC,sBAAsB,IAAI,MAAM;IAKhC;;;;;;OAMG;IACG,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAwD/C;;;OAGG;IACH,MAAM,IAAI,IAAI;IAmBd,sCAAsC;IACtC,KAAK,IAAI,IAAI;IAUb,sCAAsC;IACtC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAYtC,yBAAyB;IACzB,SAAS,IAAI,CAAC;YAMA,QAAQ;IAoGtB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,YAAY;IAgDpB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,GAAG;CAGZ"}