ralph-agent-loop 0.4.0

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! Review prompt loading and rendering (code review, completion checklist, iteration checklist,
//! phase2 handoff).
//!
//! Responsibilities: load review-related templates, render task-scoped content, and apply
//! project-type guidance for code review prompts.
//! Not handled: worker phase prompt composition, queue updates, or RepoPrompt instruction injection.
//! Invariants/assumptions: required placeholders are present and task IDs are non-empty where needed.

use super::registry::{PromptTemplateId, load_prompt_template, prompt_template};
use super::util::{
    apply_project_type_guidance_if_needed, ensure_no_unresolved_placeholders,
    ensure_required_placeholders,
};
use crate::contracts::{Config, ProjectType};
use anyhow::{Result, bail};

pub(crate) fn load_completion_checklist(repo_root: &std::path::Path) -> Result<String> {
    load_prompt_template(repo_root, PromptTemplateId::CompletionChecklist)
}

pub(crate) fn load_code_review_prompt(repo_root: &std::path::Path) -> Result<String> {
    load_prompt_template(repo_root, PromptTemplateId::CodeReview)
}

pub(crate) fn load_phase2_handoff_checklist(repo_root: &std::path::Path) -> Result<String> {
    load_prompt_template(repo_root, PromptTemplateId::Phase2HandoffChecklist)
}

pub(crate) fn load_iteration_checklist(repo_root: &std::path::Path) -> Result<String> {
    load_prompt_template(repo_root, PromptTemplateId::IterationChecklist)
}

pub(crate) fn render_completion_checklist(
    template: &str,
    task_id: &str,
    config: &Config,
    parallel_worker_mode: bool,
) -> Result<String> {
    let template_meta = prompt_template(PromptTemplateId::CompletionChecklist);
    let id = task_id.trim();
    if id.is_empty() {
        bail!("Missing task id: completion checklist requires a non-empty task id.");
    }

    let expanded = super::util::expand_variables(template, config)?;
    let run_mode = if parallel_worker_mode {
        "parallel-worker"
    } else {
        "normal"
    };
    let rendered = expanded
        .replace("{{TASK_ID}}", id)
        .replace("{{RUN_MODE}}", run_mode);
    ensure_no_unresolved_placeholders(&rendered, template_meta.label)?;
    Ok(rendered)
}

pub(crate) fn render_phase2_handoff_checklist(template: &str, config: &Config) -> Result<String> {
    let template_meta = prompt_template(PromptTemplateId::Phase2HandoffChecklist);
    let expanded = super::util::expand_variables(template, config)?;
    ensure_no_unresolved_placeholders(&expanded, template_meta.label)?;
    Ok(expanded)
}

pub(crate) fn render_iteration_checklist(
    template: &str,
    task_id: &str,
    config: &Config,
) -> Result<String> {
    let template_meta = prompt_template(PromptTemplateId::IterationChecklist);
    let id = task_id.trim();
    if id.is_empty() {
        bail!("Missing task id: iteration checklist requires a non-empty task id.");
    }

    let expanded = super::util::expand_variables(template, config)?;
    let rendered = expanded.replace("{{TASK_ID}}", id);
    ensure_no_unresolved_placeholders(&rendered, template_meta.label)?;
    Ok(rendered)
}

pub(crate) fn render_code_review_prompt(
    template: &str,
    task_id: &str,
    project_type: ProjectType,
    config: &Config,
) -> Result<String> {
    let template_meta = prompt_template(PromptTemplateId::CodeReview);
    ensure_required_placeholders(template, template_meta.required_placeholders)?;

    let id = task_id.trim();
    if id.is_empty() {
        bail!("Missing task id: code review prompt requires a non-empty task id.");
    }

    let expanded = super::util::expand_variables(template, config)?;
    let mut rendered = apply_project_type_guidance_if_needed(
        &expanded,
        project_type,
        template_meta.project_type_guidance,
    );

    rendered = rendered.replace("{{TASK_ID}}", id);

    ensure_no_unresolved_placeholders(&rendered, template_meta.label)?;

    Ok(rendered)
}