qqq-cli 0.4.0

Local-first task queue for coding agent sessions
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use serde::Serialize;
use serde_json::{Map, Value};
use std::{
    fmt,
    path::PathBuf,
    sync::atomic::{AtomicBool, Ordering},
};

static JSON_OUTPUT: AtomicBool = AtomicBool::new(false);

pub fn set_json_output(enabled: bool) {
    JSON_OUTPUT.store(enabled, Ordering::Relaxed);
}

pub fn json_output() -> bool {
    JSON_OUTPUT.load(Ordering::Relaxed)
}

#[derive(Clone, Copy, Debug, Serialize)]
#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
pub enum Code {
    TaskNotFound,
    OwnershipMismatch,
    InvalidTransition,
    InvalidArgument,
    InvalidFilter,
    DbBusy,
    ContentConflict,
    ProjectNotFound,
    ConfigError,
    IoError,
    EditorError,
    DispatchError,
    DatabaseError,
    CommandError,
}

#[derive(Debug)]
pub struct Info {
    pub code: Code,
    pub message: String,
    pub details: Map<String, Value>,
    human: String,
}

impl Info {
    pub fn new(code: Code, message: impl Into<String>) -> Self {
        let message = message.into();
        Self {
            code,
            human: message.clone(),
            message,
            details: Map::new(),
        }
    }

    pub fn detail(mut self, name: &str, value: impl Into<Value>) -> Self {
        self.details.insert(name.into(), value.into());
        self
    }

    pub fn human(mut self, message: impl Into<String>) -> Self {
        self.human = message.into();
        self
    }

    pub fn missing_task(id: i64) -> Self {
        Self::new(Code::TaskNotFound, format!("Task {id} not found")).detail("task_id", id)
    }

    pub fn invalid_argument(argument: &str, message: impl Into<String>) -> Self {
        Self::new(Code::InvalidArgument, message).detail("argument", argument)
    }

    pub fn transition(
        id: i64,
        actual: &str,
        expected: &[&str],
        message: impl Into<String>,
    ) -> Self {
        Self::new(Code::InvalidTransition, message)
            .detail("task_id", id)
            .detail("actual_status", actual)
            .detail("expected_statuses", expected.to_vec())
    }
}

impl fmt::Display for Info {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        formatter.write_str(&self.human)
    }
}
impl std::error::Error for Info {}

#[derive(Debug)]
pub struct Recovery {
    pub local_draft: PathBuf,
    pub current_text: Option<PathBuf>,
    pub attachments_manifest: Option<PathBuf>,
}

impl fmt::Display for Recovery {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            formatter,
            "local draft kept at {}",
            self.local_draft.display()
        )
    }
}
impl std::error::Error for Recovery {}