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
55
56
57
58
59
60
61
62

//! Git operations module.
//!
//! This module provides a comprehensive set of git operations for Ralph,
//! organized into focused submodules:
//!
//! - `error`: Error types and classification
//! - `status`: Status parsing and path tracking
//! - `lfs`: Git LFS detection and validation
//! - `commit`: Commit and push operations
//! - `clean`: Repository cleanliness validation
//!
//! # Invariants
//! - All operations use `-c core.fsmonitor=false` to avoid fsmonitor issues
//! - Error types are Send + Sync for anyhow compatibility
//! - LFS operations gracefully handle repositories without LFS
//!
//! # What this does NOT handle
//! - General file system operations (use std::fs or anyhow)
//! - Non-git version control systems

pub mod branch;
pub mod clean;
pub mod commit;
pub mod error;
pub(crate) mod github_cli;
pub mod issue;
pub mod lfs;
pub mod pr;
pub mod status;
pub mod workspace;

// Re-export commonly used items for convenience within the crate.
pub(crate) use branch::current_branch;
pub use clean::{
    RALPH_RUN_CLEAN_ALLOWED_PATHS, repo_dirty_only_allowed_paths, require_clean_repo_ignoring_paths,
};
pub use commit::{
    abort_rebase, add_paths_force, commit_all, fetch_branch, is_ahead_of_upstream,
    is_behind_upstream, list_conflict_files, push_current_branch, push_head_to_branch,
    push_upstream, push_upstream_allow_create, push_upstream_with_rebase, rebase_onto,
    restore_tracked_paths_to_head, revert_uncommitted, upstream_ref,
};
pub use error::GitError;
pub(crate) use issue::{
    GITHUB_ISSUE_SYNC_HASH_KEY, compute_issue_sync_hash, create_issue, edit_issue,
    normalize_issue_metadata_list, parse_issue_number,
};
pub use lfs::{check_lfs_health, filter_modified_lfs_files, has_lfs, list_lfs_files};
// PR-related functions kept for potential non-parallel use, but unused in direct-push mode
#[allow(unused_imports)]
pub(crate) use pr::{
    MergeState, PrInfo, PrLifecycle, check_gh_available, create_pr, merge_pr, pr_lifecycle_status,
    pr_merge_status,
};
pub use status::{
    ensure_paths_unchanged, ignored_paths, is_path_ignored, snapshot_paths, status_paths,
    status_porcelain,
};
// NEW: workspace-based isolation (clone workspaces).
pub(crate) use workspace::{
    WorkspaceSpec, create_workspace_at, origin_urls, remove_workspace, workspace_root,
};