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.

blocking_human_checkpoint_reported

Confirm whether captured stdout reports a human-blocking checkpoint, by searching for a **Gate:**-labeled line whose VALUE is exactly [HUMAN_GATE_VALUE] — see that constant’s doc comment for the live observation (2026-07-31) the matched rendering is built from.

checkpoint_reported_in_capture

Thin file-reading wrapper over blocking_human_checkpoint_reported: reads the phase’s captured stdout file (via stdout_path) and delegates. false for a missing capture file, never an error.

claude_session_id

Read the top-level session_id string from a Claude JSON result envelope (--output-format json). Returns None for plain-text stdout, a non-JSON-object envelope, an envelope with no session_id key, or a session_id of a non-string JSON type — never panics.

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.

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.

session_id_from_capture

Thin file-reading wrapper over claude_session_id: reads the phase’s captured stdout file (via stdout_path) and delegates. None for a missing capture file, never an Err — mirrors evaluate_layer1’s lossy-read convention (CR-01: one invalid UTF-8 byte from raw sh redirection must not silently disable this reader).

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.