Module agent_result 

Agent completion detection — parses DEVFLOW_RESULT markers and evaluates exit codes to determine whether a coding agent succeeded or failed.

Four-layer decision engine: 0. Run operator-authored external post-condition probes (authoritative failure)

1. Parse DEVFLOW_RESULT from agent stdout (authoritative for ordinary plans)
2. Exit code + commit count gate (reliable fallback)
3. Process gone + commits exist (last resort warning)

Structs

AgentResult

Parsed agent completion result.

Enums

AgentStatus

Agent completion status determined by DevFlow.

ResultError

Errors produced by agent result evaluation.

Verdict

The Validate stage’s self-reported verdict (13b verdict-vs-ran split).

Functions

agent_pid_path

Path to the file where the monitor records the launched agent’s PID.

archive_phase_files

Archive the prior stage’s stdout/exit captures into bounded per-phase history instead of wiping them outright, so a false-positive self-report can be diagnosed after the fact (16b). Replaces the old cleanup_phase_files, which deleted these files unconditionally.

detect_rate_limit

Detect agent-specific rate-limit output and return the retry description.

evaluate_agent_result

Full four-layer evaluation: returns the best available AgentResult.

evaluate_layer1

Layer 1: Try to detect agent result from the native per-adapter envelope or the DEVFLOW_RESULT marker in stdout.

evaluate_layer2

Layer 2: Use exit code + commit count to determine result.

evaluate_layer3

Layer 3: Last resort — agent process is gone, commits exist.

exit_code_path

Path to the exit code file for a given phase.

history_dir

Path to the archived-capture-history directory for a phase (16b).

parse_devflow_result

Search stdout for a DEVFLOW_RESULT marker.

stderr_path

Path where the agent’s stderr is captured for a given phase. Lives alongside stdout_path under .devflow/.

stdout_path

Path to the stdout file for a given phase.