jjj 0.3.1

Distributed project management and code review for Jujutsu
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

use super::event::EventType;

fn default_true() -> bool {
    true
}

fn default_problem_label() -> String {
    "jjj".to_string()
}

/// GitHub integration configuration
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GitHubConfig {
    /// Enable GitHub integration (None = auto-detect, Some(false) = disabled)
    #[serde(default)]
    pub enabled: Option<bool>,

    /// Override repository: "owner/repo"
    #[serde(default)]
    pub repo: Option<String>,

    /// Opt-in: automatically create issues/PRs on local operations
    #[serde(default)]
    pub auto_push: bool,

    /// Import "Request Changes" reviews as critiques
    #[serde(default = "default_true")]
    pub sync_critiques: bool,

    /// Import "Approve" reviews
    #[serde(default = "default_true")]
    pub sync_lgtm: bool,

    /// Auto-close linked GitHub issue when `problem solve` runs.
    /// Finer-grained than `auto_push` (which also controls issue/PR creation).
    #[serde(default)]
    pub auto_close_on_solve: bool,

    /// Label applied to synced GitHub issues
    #[serde(default = "default_problem_label")]
    pub problem_label: String,

    /// Map GitHub issue labels to jjj priority (e.g., "urgent" → "critical", "important" → "high")
    #[serde(default)]
    pub label_priority: HashMap<String, String>,
}

impl Default for GitHubConfig {
    fn default() -> Self {
        Self {
            enabled: None,
            repo: None,
            auto_push: false,
            sync_critiques: true,
            sync_lgtm: true,
            auto_close_on_solve: false,
            problem_label: default_problem_label(),
            label_priority: HashMap::new(),
        }
    }
}

/// Built-in automation actions and the generic "shell" escape hatch.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum AutomationAction {
    Shell,
    GithubPr,
    GithubMerge,
    GithubClose,
    GithubIssue,
    GithubSync,
}

/// A single automation rule: when event `on` fires, execute `action`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AutomationRule {
    /// Event type to match (e.g., `EventType::SolutionSubmitted`)
    pub on: EventType,

    /// Action to perform: built-in name or `Shell`
    pub action: AutomationAction,

    /// Shell command template (required when action = Shell)
    #[serde(default)]
    pub command: Option<String>,

    /// Enable/disable without removing the rule (default: true)
    #[serde(default = "default_true")]
    pub enabled: bool,
}

/// Project-wide configuration stored in config.toml
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ProjectConfig {
    /// Project name
    #[serde(default)]
    pub name: Option<String>,

    /// Default reviewers
    #[serde(default)]
    pub default_reviewers: Vec<String>,

    /// Custom settings
    #[serde(default)]
    pub settings: HashMap<String, String>,

    /// GitHub integration settings
    #[serde(default)]
    pub github: GitHubConfig,

    /// Automation rules — fire actions on jjj events
    #[serde(default)]
    pub automation: Vec<AutomationRule>,
}