1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
//! Review and fix pass orchestration.
//!
//! This module implements the review-fix cycle that validates code changes and
//! addresses identified issues. It provides two main pass types:
//!
//! - **Review Pass**: Validates code changes and extracts issues to ISSUES.md
//! - **Fix Pass**: Applies fixes for identified issues and validates results
//!
//! ## Architecture
//!
//! Both passes follow a similar pattern:
//! 1. Generate prompt (with checkpoint replay support)
//! 2. Invoke agent with appropriate configuration
//! 3. Extract and validate XML output
//! 4. Update execution history with results
//!
//! ## Usage
//!
//! The example below uses `ignore` because it requires extensive setup (context, workspace, agents).
//! For complete working examples, see the integration tests in `tests/integration_tests/workflows/review.rs`.
//!
//! ```ignore
//! // Import from the public re-export location
//! use ralph_workflow::phases::review::{run_review_pass, run_fix_pass};
//!
//! // Run a review pass
//! let result = run_review_pass(ctx, j, "review", &review_prompt, Some("reviewer-agent"))?;
//! if result.issues_found {
//! // Run a fix pass to address issues
//! let fix_result = run_fix_pass(ctx, j, context_level, None, Some("reviewer-agent"))?;
//! }
//! ```
//!
//! ## See Also
//!
//! - `phases::review::validation` - Post-flight validation logic
//! - `phases::review::xml_processing` - XML extraction and validation
pub use run_fix_pass;
pub use run_review_pass;