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

//! CLI arguments for task follow-up proposal application.
//!
//! Purpose:
//! - CLI arguments for task follow-up proposal application.
//!
//! Responsibilities:
//! - Define nested `cueloop task followups ...` subcommands.
//! - Expose text vs JSON output selection for apply reports.
//! - Keep proposal-file path and source-task arguments typed for handlers.
//!
//! Not handled here:
//! - Proposal parsing, queue mutation, or persistence.
//! - Runner prompt guidance for when proposals should be created.
//!
//!
//! Usage:
//! - Used through the crate module tree or integration test harness.
//!
//! Invariants/assumptions:
//! - Missing `--input` means `.cueloop/cache/followups/<TASK_ID>.json`.
//! - `--task` names the source task that authorized the proposal.

use std::path::PathBuf;

use clap::{Args, Subcommand, ValueEnum};

#[derive(ValueEnum, Clone, Copy, Debug, Eq, PartialEq)]
pub enum TaskFollowupsFormatArg {
    Text,
    Json,
}

#[derive(Args, Clone)]
pub struct TaskFollowupsArgs {
    #[command(subcommand)]
    pub command: TaskFollowupsCommand,
}

#[derive(Subcommand, Clone)]
pub enum TaskFollowupsCommand {
    /// Apply a followups@v1 proposal into the queue.
    #[command(
        after_long_help = "Examples:\n cueloop task followups apply --task RQ-0135\n cueloop task followups apply --task RQ-0135 --dry-run\n cueloop task followups apply --task RQ-0135 --input /tmp/followups.json --format json"
    )]
    Apply(TaskFollowupsApplyArgs),
}

#[derive(Args, Clone)]
pub struct TaskFollowupsApplyArgs {
    /// Source task that produced the follow-up proposal.
    #[arg(long, value_name = "TASK_ID")]
    pub task: String,

    /// Read the followups@v1 proposal from this path.
    ///
    /// When omitted, CueLoop reads `.cueloop/cache/followups/<TASK_ID>.json`.
    #[arg(long, value_name = "PATH")]
    pub input: Option<PathBuf>,

    /// Preview created tasks without saving queue changes or removing the proposal.
    #[arg(long)]
    pub dry_run: bool,

    /// Output format for the apply report.
    #[arg(long, value_enum, default_value_t = TaskFollowupsFormatArg::Text)]
    pub format: TaskFollowupsFormatArg,
}