govctl 0.9.3

Project governance CLI for RFC, ADR, and Work Item management
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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

use clap::Subcommand;

#[derive(Subcommand, Clone, Debug)]
pub(crate) enum LoopCommand {
    /// List persisted local loop states
    #[command(after_help = "\
EXAMPLES:
    govctl loop list
    govctl loop list open
    govctl loop list paused -n 5
    govctl loop list -o plain
    govctl loop list -o json

NOTES:
    - Reads local state from `.govctl/loops/<LOOP-ID>/state.toml`.
    - Lists loops by canonical loop ID in deterministic order.
    - Filter may be a loop lifecycle state, `open`, `resumable`, loop ID, or work item ID.
")]
    List {
        /// Optional lifecycle state, alias, loop ID, or work item ID filter
        filter: Option<String>,
        /// Limit number of results
        #[arg(short = 'n', long)]
        limit: Option<usize>,
        /// Output format
        #[arg(short = 'o', long, value_enum, default_value = "table")]
        output: crate::OutputFormat,
    },
    /// Start a loop for one or more explicit work items
    #[command(after_help = "\
EXAMPLES:
    govctl loop start WI-2026-04-06-001
    govctl loop start --id LOOP-2026-04-06-001 WI-2026-04-06-001 WI-2026-04-06-002

NOTES:
    - Resolves transitive `depends_on` dependencies before writing state.
    - Reuses an existing non-terminal loop with the same explicit work set when unambiguous.
")]
    Start {
        /// Optional loop ID; generated when omitted
        #[arg(long)]
        id: Option<String>,
        /// Explicit loop work item IDs
        #[arg(required = true, value_name = "WI-ID")]
        work_ids: Vec<String>,
    },
    /// Show persisted loop state
    #[command(after_help = "\
EXAMPLES:
    govctl loop show LOOP-2026-04-06-001
")]
    Show {
        /// Loop ID
        id: String,
    },
    /// Resume or inspect an existing non-terminal loop
    #[command(after_help = "\
EXAMPLES:
    govctl loop resume LOOP-2026-04-06-001

NOTES:
    - Resumes by explicit loop ID.
")]
    Resume {
        /// Loop ID
        id: String,
    },
    /// Recompute dependency closure for the current explicit work set
    #[command(after_help = "\
EXAMPLES:
    govctl loop replan LOOP-2026-04-06-001

NOTES:
    - Re-reads current work item files and preserves applicable loop item state.
")]
    Replan {
        /// Loop ID
        id: String,
    },
    /// Add a value to a loop field and replan when needed
    #[command(after_help = "\
EXAMPLES:
    govctl loop add LOOP-2026-04-06-001 work WI-2026-04-06-002
    govctl loop add LOOP-2026-04-06-001 wi WI-2026-04-06-002

NOTES:
    - `work` is the editable loop work item field.
    - `wi` is accepted as a shorthand field alias.
    - The resolved dependency closure is recomputed after changing work.
")]
    Add {
        /// Loop ID
        id: String,
        /// Loop field name (`work`; `wi` alias)
        field: String,
        /// Work item ID to add
        #[arg(value_name = "WI-ID")]
        value: String,
    },
    /// Remove a value from a loop field and replan when needed
    #[command(after_help = "\
EXAMPLES:
    govctl loop remove LOOP-2026-04-06-001 work WI-2026-04-06-002
    govctl loop remove LOOP-2026-04-06-001 wi WI-2026-04-06-002

NOTES:
    - `work` is the editable loop work item field.
    - `wi` is accepted as a shorthand field alias.
    - The resolved dependency closure is recomputed after changing work.
")]
    Remove {
        /// Loop ID
        id: String,
        /// Loop field name (`work`; `wi` alias)
        field: String,
        /// Work item ID to remove
        #[arg(value_name = "WI-ID")]
        value: String,
    },
    /// Advance the local round protocol for ready work items
    #[command(after_help = "\
EXAMPLES:
    govctl loop run LOOP-2026-04-06-001
    govctl loop run LOOP-2026-04-06-001 --max-rounds 2
    govctl loop run LOOP-2026-04-06-001 --work WI-2026-04-06-002

NOTES:
    - Opens a loop-level round when no open round exists.
    - Validates summary evidence when an open round exists.
    - Use --work to select target work items inside the loop when opening a round.
    - Does not change Work Item lifecycle state; use `govctl work move` explicitly.
")]
    Run {
        /// Loop ID
        id: String,
        /// Maximum rounds each work item may run before loop-level failure
        #[arg(long, default_value_t = 1)]
        max_rounds: u32,
        /// Work item IDs to target inside an existing explicit loop
        #[arg(long = "work", value_name = "WI-ID")]
        target_work_ids: Vec<String>,
    },
}