githubclaw 0.2.2

Near-autonomous AI agents that manage open-source projects end-to-end using GitHub as the single source of truth.
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

//! Tab definitions for the TUI.

use serde::{Deserialize, Serialize};

/// Available TUI tabs.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum Tab {
    IssueRequest,
    Monitoring,
}

impl Tab {
    pub fn title(&self) -> &'static str {
        match self {
            Self::IssueRequest => "Issue Request",
            Self::Monitoring => "Monitoring",
        }
    }

    pub fn all() -> &'static [Tab] {
        &[Tab::IssueRequest, Tab::Monitoring]
    }

    pub fn next(&self) -> Tab {
        match self {
            Self::IssueRequest => Self::Monitoring,
            Self::Monitoring => Self::IssueRequest,
        }
    }

    pub fn prev(&self) -> Tab {
        match self {
            Self::IssueRequest => Self::Monitoring,
            Self::Monitoring => Self::IssueRequest,
        }
    }
}

/// An issue awaiting interactive session (shown in Issue Request tab).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct IssueRequestItem {
    pub issue_number: u64,
    pub title: String,
    pub issue_type: String, // "Feature" or "Refactoring"
    pub vision_report_ready: bool,
}

/// An active agent session (shown in Monitoring tab).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentSessionItem {
    pub issue_number: u64,
    pub agent_type: String,
    pub status: AgentStatus,
    pub started_at: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum AgentStatus {
    Running,
    Queued,
    Completed,
    Failed,
    Idle,
}

impl AgentStatus {
    pub fn symbol(&self) -> &'static str {
        match self {
            Self::Running => ">>",
            Self::Queued => "..",
            Self::Completed => "ok",
            Self::Failed => "!!",
            Self::Idle => "--",
        }
    }
}

/// Agent execution timeline entry for session detail.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TimelineEntry {
    pub agent_type: String,
    pub status: AgentStatus,
    pub detail: String,
}