cueloop 0.8.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

//! Configuration enums for project type, git revert/publish mode, and scan prompt version.
//!
//! Purpose:
//! - Configuration enums for project type, git revert/publish mode, and scan prompt version.
//!
//! Responsibilities:
//! - Define simple enum types used across configuration.
//!
//! Not handled here:
//! - Complex config structs with merge behavior (see other config modules).
//!
//! Usage:
//! - Used through the crate module tree or integration test harness.
//!
//! Invariants/Assumptions:
//! - Keep behavior aligned with CueLoop's canonical CLI, machine-contract, and queue semantics.

use crate::contracts::enum_parse::snake_case_from_str;
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

/// Project type classification.
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ProjectType {
    #[default]
    Code,
    Docs,
}

/// Git revert mode for handling runner/supervision errors.
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum GitRevertMode {
    #[default]
    Ask,
    Enabled,
    Disabled,
}

snake_case_from_str! {
    GitRevertMode {
        Ask => "ask",
        Enabled => "enabled",
        Disabled => "disabled",
    }
    "git_revert_mode must be 'ask', 'enabled', or 'disabled'"
}

/// Git publish mode for post-run repository changes.
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum GitPublishMode {
    /// Leave the repository dirty after queue/done updates.
    #[default]
    Off,
    /// Create a local commit but do not push.
    Commit,
    /// Create a local commit and push it using CueLoop's guarded push flow.
    CommitAndPush,
}

impl GitPublishMode {
    pub const fn as_str(self) -> &'static str {
        match self {
            GitPublishMode::Off => "off",
            GitPublishMode::Commit => "commit",
            GitPublishMode::CommitAndPush => "commit_and_push",
        }
    }
}

snake_case_from_str! {
    GitPublishMode {
        Off => "off",
        Commit => "commit",
        CommitAndPush => "commit_and_push",
    }
    "git_publish_mode must be 'off', 'commit', or 'commit_and_push'"
}

/// Scan prompt version to use for scan operations.
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ScanPromptVersion {
    /// Version 1: Original rule-based scan prompts with fixed minimum task counts.
    V1,
    /// Version 2: Rubric-based scan prompts with quality-focused STOP CONDITION (default).
    #[default]
    V2,
}