handoff

Human-in-the-loop (HITL) checkpoint preparation formats phase review summaries and artifact data for human evaluation. It reads phase results, validates context health, and enforces safety checks before presenting the checkpoint to the reviewer.

Validate context health by reading phase results and checking the inv_context.json file. The system evaluates this data to maintain a consistent state and ensures all safety checks pass before allowing the workflow to proceed to the next phase.

Orchestrate phase transitions by evaluating phase gates after receiving results, such as after Phase 4. The system controls the investigation loop by deciding whether to continue investigating, converge on a result, or escalate based on validated context.

Phase handoff does not require external dependencies or components. It operates as a standalone workflow orchestration step that reads existing phase results and validates the inv_context.json file to manage internal state and audit trails.

Trigger a workflow handoff for human review when a phase reaches a gate, such as after Phase 4 results. This initiates the preparation of a HITL summary, allowing the reviewer to assess the audit trail and determine the next action.