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

//! Pending-migration warning helpers.
//!
//! Purpose:
//! - Detect and report unapplied migrations during `ralph init`.
//!
//! Responsibilities:
//! - Build a migration context from resolved config.
//! - Print a warning when migrations are pending.
//! - Treat unavailable migration context as a non-fatal condition.
//!
//! Scope:
//! - Warning/reporting logic only; migration execution lives in `crate::migration`.
//!
//! Usage:
//! - Called by the initialization workflow after files are created or validated.
//!
//! Invariants/assumptions:
//! - Missing migration context should not fail initialization.
//! - Warning text remains human-readable for direct CLI invocation.

use anyhow::Result;
use colored::Colorize;

use crate::config;

/// Check for pending migrations and display a warning if any exist.
pub(super) fn check_pending_migrations(resolved: &config::Resolved) -> Result<()> {
    use crate::migration::{self, MigrationCheckResult};

    let ctx = match migration::MigrationContext::from_resolved(resolved) {
        Ok(ctx) => ctx,
        Err(e) => {
            log::debug!("Could not create migration context: {}", e);
            return Ok(());
        }
    };

    match migration::check_migrations(&ctx)? {
        MigrationCheckResult::Current => {}
        MigrationCheckResult::Pending(migrations) => {
            eprintln!();
            eprintln!(
                "{}",
                format!("⚠ Warning: {} migration(s) pending", migrations.len()).yellow()
            );
            eprintln!("Run {} to apply them.", "ralph migrate --apply".cyan());
        }
    }

    Ok(())
}