Struct PhaseContext 

pub struct PhaseContext<'a> {

    pub config: &'a Config,
    pub registry: &'a AgentRegistry,
    pub logger: &'a Logger,
    pub colors: &'a Colors,
    pub timer: &'a mut Timer,
    pub developer_agent: &'a str,
    pub reviewer_agent: &'a str,
    pub review_guidelines: Option<&'a ReviewGuidelines>,
    pub template_context: &'a TemplateContext,
    pub run_context: RunContext,
    pub execution_history: ExecutionHistory,
    pub executor: &'a dyn ProcessExecutor,
    pub executor_arc: Arc<dyn ProcessExecutor>,
    pub repo_root: &'a Path,
    pub workspace: &'a dyn Workspace,
    pub workspace_arc: Arc<dyn Workspace>,
    pub run_log_context: &'a RunLogContext,
    pub cloud_reporter: Option<&'a dyn CloudReporter>,
    pub cloud: &'a CloudConfig,
}

Shared context for all pipeline phases.

This struct holds references to all the shared state that phases need to access. It is passed by mutable reference to each phase function.

Phase Name Convention

When working with phase names (e.g., for log file naming), use lowercase identifiers with underscores for multi-word phases. The canonical phase names are:

• "planning" - Planning phase
• "analysis" - Analysis sub-phase of development (when role == AgentRole::Analysis)
• "developer" - Development phase (when role == AgentRole::Developer)
• "reviewer" - Review phase
• "commit" - Commit message generation phase
• "final_validation" - Final validation phase
• "finalizing" - Finalizing phase
• "complete" - Complete phase
• "awaiting_dev_fix" - Awaiting dev fix phase
• "interrupted" - Interrupted phase

These phase names are used for log file naming under .agent/logs-<run_id>/agents/ (e.g., planning_1.log, developer_2_a1.log).

When adding new phases or extending the phase system, maintain this lowercase convention for consistency.

Fields

config: &'a Config

Configuration settings for the pipeline.

registry: &'a AgentRegistry

Agent registry for looking up agent configurations.

logger: &'a Logger

Logger for output and diagnostics.

colors: &'a Colors

Terminal color configuration.

timer: &'a mut Timer

Timer for tracking elapsed time.

developer_agent: &'a str

Name of the developer agent.

reviewer_agent: &'a str

Name of the reviewer agent.

review_guidelines: Option<&'a ReviewGuidelines>

Review guidelines based on detected project stack.

template_context: &'a TemplateContext

Template context for loading user templates.

run_context: RunContext

Run context for tracking execution lineage and state.

execution_history: ExecutionHistory

Execution history for tracking pipeline steps.

executor: &'a dyn ProcessExecutor

Process executor for external process execution.

executor_arc: Arc<dyn ProcessExecutor>

Arc-wrapped executor for spawning into threads (e.g., idle timeout monitor).

repo_root: &'a Path

Repository root path for explicit file operations.

This eliminates CWD dependencies by providing an explicit path for all file operations. Code should use repo_root.join("relative/path") instead of Path::new("relative/path").

workspace: &'a dyn Workspace

Workspace for explicit path resolution and file operations.

Provides convenient methods for file operations and path resolution without depending on the current working directory.

This uses trait object (&dyn Workspace) for proper dependency injection:

• Production code passes &WorkspaceFs (real filesystem)
• Tests can pass &MemoryWorkspace (in-memory storage)

workspace_arc: Arc<dyn Workspace>

Arc-wrapped workspace for spawning into threads (e.g., file activity monitor).

run_log_context: &'a RunLogContext

Run log context for per-run log path resolution.

Provides paths to all log files under the per-run directory (.agent/logs-<run_id>/). This ensures all logs from a single pipeline invocation are grouped together for easy debugging.

cloud_reporter: Option<&'a dyn CloudReporter>

Cloud reporter for progress updates (None in CLI mode).

When cloud mode is disabled, this is None and no cloud reporting occurs. When enabled, this is Some(&dyn CloudReporter) for API communication.

cloud: &'a CloudConfig

Cloud configuration.

When cloud mode is disabled (enabled=false), all cloud-specific logic is skipped throughout the pipeline.

Implementations

impl PhaseContext<'_>

pub const fn record_developer_iteration(&mut self)

Record a completed developer iteration.

pub const fn record_reviewer_pass(&mut self)

Record a completed reviewer pass.