2026-01-25 02:55:43 +01:00
/**
* @fileoverview AI-Powered Plan Mode Checker for Auto-Accept
*
2026-02-18 12:51:35 +01:00
* Spawns a fresh Claude CLI session in a tmux session to analyze terminal output
* and determine if Claude Code is showing a plan mode approval prompt.
2026-01-25 02:55:43 +01:00
* Used as a confirmation gate before auto-accepting prompts.
*
* ## How It Works
*
* 1. Generate temp file path for output capture
2026-02-26 16:44:34 +01:00
* 2. Spawn tmux: `tmux new-session -d -s codeman-plancheck-<short> bash -c 'claude -p ...'`
2026-01-25 02:55:43 +01:00
* 3. Poll the temp file every 500ms for `__PLANCHECK_DONE__` marker
* 4. Parse the file content for PLAN_MODE/NOT_PLAN_MODE on the first line
2026-02-18 12:51:35 +01:00
* 5. Kill tmux session and delete temp file
2026-01-25 02:55:43 +01:00
*
* ## Error Handling
*
2026-02-18 12:51:35 +01:00
* - Tmux spawn fails: 30s cooldown, increment error counter
* - Check times out (60s): Kill session, 30s cooldown
2026-01-25 02:55:43 +01:00
* - Can't parse verdict: Treat as NOT_PLAN_MODE, 30s cooldown
* - 3 consecutive errors: Disable AI plan check
*
* @module ai-plan-checker
*/
2026-01-25 08:25:51 +01:00
import {
AiCheckerBase ,
type AiCheckerConfigBase ,
type AiCheckerResultBase ,
type AiCheckerStateBase ,
} from './ai-checker-base.js' ;
2026-03-07 07:33:44 +01:00
import {
AI_CHECK_MODEL ,
AI_PLAN_CHECK_MAX_CONTEXT ,
AI_PLAN_CHECK_TIMEOUT_MS ,
AI_PLAN_CHECK_COOLDOWN_MS ,
AI_PLAN_CHECK_ERROR_COOLDOWN_MS ,
AI_CHECK_MAX_CONSECUTIVE_ERRORS ,
} from './config/ai-defaults.js' ;
2026-01-25 02:55:43 +01:00
// ========== Types ==========
2026-04-23 11:57:00 +02:00
type AiPlanCheckConfig = AiCheckerConfigBase ;
2026-01-25 02:55:43 +01:00
export type AiPlanCheckVerdict = 'PLAN_MODE' | 'NOT_PLAN_MODE' | 'ERROR' ;
2026-02-27 13:16:23 +01:00
export type AiPlanCheckResult = AiCheckerResultBase < AiPlanCheckVerdict >;
2026-01-25 02:55:43 +01:00
2026-04-23 11:57:00 +02:00
type AiPlanCheckState = AiCheckerStateBase < AiPlanCheckVerdict >;
2026-01-25 02:55:43 +01:00
// ========== Constants ==========
const DEFAULT_PLAN_CHECK_CONFIG : AiPlanCheckConfig = {
enabled : true ,
2026-03-01 13:19:16 +01:00
model : AI_CHECK_MODEL ,
maxContextChars : AI_PLAN_CHECK_MAX_CONTEXT ,
2026-03-07 07:33:44 +01:00
checkTimeoutMs : AI_PLAN_CHECK_TIMEOUT_MS ,
cooldownMs : AI_PLAN_CHECK_COOLDOWN_MS ,
errorCooldownMs : AI_PLAN_CHECK_ERROR_COOLDOWN_MS ,
maxConsecutiveErrors : AI_CHECK_MAX_CONSECUTIVE_ERRORS ,
2026-01-25 02:55:43 +01:00
};
/** Pattern to match PLAN_MODE or NOT_PLAN_MODE as the first word(s) of output */
const VERDICT_PATTERN = /^\s*(PLAN_MODE|NOT_PLAN_MODE)\b/i ;
/** The prompt sent to the AI plan checker */
const AI_PLAN_CHECK_PROMPT = `Analyze this terminal output from a running Claude Code session. Determine if the terminal is currently showing a PLAN MODE APPROVAL PROMPT or not.
A plan mode approval prompt is a numbered selection menu that Claude Code shows when it wants the user to approve a plan before proceeding. It typically has these characteristics:
- A numbered list of options (e.g., "1. Yes", "2. No", "3. Type your own")
- A selection indicator arrow (❯ or >) pointing to one of the options
- Text asking for approval like "Would you like to proceed?" or "Ready to implement?"
- The prompt appears at the BOTTOM of the output (most recent content)
NOT a plan mode prompt:
- Claude actively working (spinners, "Thinking", tool execution)
- A completed response with no selection menu
- An AskUserQuestion/elicitation dialog (different format, free-text input)
- Network lag or mid-output pause
- Any state without a visible numbered selection menu
Terminal output (most recent at bottom):
---
{TERMINAL_BUFFER}
---
Answer with EXACTLY one of these on the first line: PLAN_MODE or NOT_PLAN_MODE
Then optionally explain briefly why.` ;
// ========== AiPlanChecker Class ==========
/**
* Manages AI-powered plan mode detection by spawning a fresh Claude CLI session
* to analyze terminal output and confirm plan mode approval prompts.
*/
2026-01-25 08:25:51 +01:00
export class AiPlanChecker extends AiCheckerBase <
AiPlanCheckVerdict ,
AiPlanCheckConfig ,
AiPlanCheckResult ,
AiPlanCheckState
> {
2026-02-26 16:44:34 +01:00
protected readonly muxNamePrefix = 'codeman-plancheck-' ;
2026-01-25 08:25:51 +01:00
protected readonly doneMarker = '__PLANCHECK_DONE__' ;
2026-02-26 16:44:34 +01:00
protected readonly tempFilePrefix = 'codeman-plancheck' ;
2026-01-25 08:25:51 +01:00
protected readonly logPrefix = '[AiPlanChecker]' ;
protected readonly checkDescription = 'AI plan check' ;
2026-01-25 02:55:43 +01:00
constructor ( sessionId : string , config : Partial < AiPlanCheckConfig > = {}) {
2026-01-25 08:25:51 +01:00
super ( sessionId , DEFAULT_PLAN_CHECK_CONFIG , config );
2026-01-25 02:55:43 +01:00
}
2026-01-25 08:25:51 +01:00
protected buildPrompt ( terminalBuffer : string ) : string {
return AI_PLAN_CHECK_PROMPT . replace ( '{TERMINAL_BUFFER}' , terminalBuffer );
2026-01-25 02:55:43 +01:00
}
2026-01-25 08:25:51 +01:00
protected parseVerdict ( output : string ) : { verdict : AiPlanCheckVerdict ; reasoning : string } | null {
2026-01-25 02:55:43 +01:00
const match = output . match ( VERDICT_PATTERN );
2026-01-25 08:25:51 +01:00
if ( ! match ) return null ;
2026-01-25 02:55:43 +01:00
const verdict = match [ 1 ]. toUpperCase () as 'PLAN_MODE' | 'NOT_PLAN_MODE' ;
const lines = output . split ( '\n' );
const reasoning = lines . slice ( 1 ). join ( '\n' ). trim () || `AI determined: ${ verdict } ` ;
2026-01-25 08:25:51 +01:00
return { verdict , reasoning };
}
protected getPositiveVerdict () : AiPlanCheckVerdict {
return 'PLAN_MODE' ;
}
protected getNegativeVerdict () : AiPlanCheckVerdict {
return 'NOT_PLAN_MODE' ;
}
protected getErrorVerdict () : AiPlanCheckVerdict {
return 'ERROR' ;
}
protected createErrorResult ( reasoning : string , durationMs : number ) : AiPlanCheckResult {
return { verdict : 'ERROR' , reasoning , durationMs };
}
protected createResult ( verdict : AiPlanCheckVerdict , reasoning : string , durationMs : number ) : AiPlanCheckResult {
2026-01-25 02:55:43 +01:00
return { verdict , reasoning , durationMs };
}
}