ralph-agent-loop 0.3.1

A Rust CLI for managing AI agent loops with a structured JSON task queue
Documentation 
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
45
46
47
48
49
50
51
52
53
54

//! Refactoring task generation for `ralph task refactor` subcommand.
//!
//! Responsibilities:
//! - Handle `refactor` and `build-refactor` commands.
//! - Scan repository for large files exceeding threshold.
//! - Generate refactoring tasks for flagged files.
//!
//! Not handled here:
//! - Task building from natural language (see `build.rs`).
//! - Template-based task creation (see `template.rs`).
//!
//! Invariants/assumptions:
//! - Threshold defaults to 1000 LOC per AGENTS.md guidelines.
//! - Supports batching modes for grouping related files.
//! - Dry-run mode previews tasks without inserting into queue.

use anyhow::Result;

use crate::agent;
use crate::cli::task::args::TaskBuildRefactorArgs;
use crate::commands::task as task_cmd;
use crate::config;

/// Handle the `refactor` and `build-refactor` commands.
pub fn handle(
    args: &TaskBuildRefactorArgs,
    force: bool,
    resolved: &config::Resolved,
) -> Result<()> {
    let overrides = agent::resolve_agent_overrides(&agent::AgentArgs {
        runner: args.runner.clone(),
        model: args.model.clone(),
        effort: args.effort.clone(),
        repo_prompt: args.repo_prompt,
        runner_cli: args.runner_cli.clone(),
    })?;

    task_cmd::build_refactor_tasks(
        resolved,
        task_cmd::TaskBuildRefactorOptions {
            threshold: args.threshold,
            path: args.path.clone(),
            dry_run: args.dry_run,
            batch: args.batch.into(),
            extra_tags: args.tags.clone().unwrap_or_default(),
            runner_override: overrides.runner,
            model_override: overrides.model,
            reasoning_effort_override: overrides.reasoning_effort,
            runner_cli_overrides: overrides.runner_cli,
            force,
            repoprompt_tool_injection: agent::resolve_rp_required(args.repo_prompt, resolved),
        },
    )
}