ralph-agent-loop 0.3.1

//! Task updater prompt loading and rendering.
//!
//! Responsibilities: load the task updater template and render task IDs and field updates.
//! Not handled: task persistence, queue mutations, or phase-specific prompt composition.
//! Invariants/assumptions: required placeholders exist and task IDs are non-empty.

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, escape_placeholder_like_text,
};
use crate::contracts::{Config, ProjectType};
use anyhow::{Result, bail};

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

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

    if task_id.trim().is_empty() {
        bail!(
            "Missing task ID: task ID must be non-empty. Provide a valid task ID for the task updater."
        );
    }

    let expanded = super::util::expand_variables(template, config)?;
    let base = apply_project_type_guidance_if_needed(
        &expanded,
        project_type,
        template_meta.project_type_guidance,
    );
    let mut rendered = base.clone();
    rendered = rendered.replace("{{TASK_ID}}", task_id.trim());
    let safe_task_id = escape_placeholder_like_text(task_id.trim());
    let mut rendered_for_validation = base;
    rendered_for_validation = rendered_for_validation.replace("{{TASK_ID}}", safe_task_id.trim());
    ensure_no_unresolved_placeholders(&rendered_for_validation, template_meta.label)?;
    Ok(rendered)
}