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

use super::adapter::{AdrTomlAdapter, WorkTomlAdapter};
use super::matching::MatchOptions;
use super::rules as edit_rules;
use super::toml_target::tick_toml_field;
use super::{ArtifactType, plan_mutation_target, reject_match_flags_for_indexed_target};
use crate::config::Config;
use crate::diagnostic::{Diagnostic, DiagnosticCode, DiagnosticResult};
use crate::write::WriteOp;

const TICK_UNSUPPORTED_ARTIFACT_ERROR: &str = "Tick only works for work items and ADRs: {id}";
const ADR_TICK_STATUS_ERROR: &str =
    "ADR tick status must be one of: accepted, considered, rejected";
const WORK_TICK_STATUS_ERROR: &str =
    "Work item tick status must be one of: done, pending, cancelled";

pub fn tick_item(
    config: &Config,
    id: &str,
    field: &str,
    opts: &MatchOptions,
    status: crate::TickStatus,
    op: WriteOp,
) -> DiagnosticResult<Vec<Diagnostic>> {
    let plan = plan_mutation_target(id, field, edit_rules::Verb::Tick)?;
    let artifact = plan.artifact;
    let target = &plan.target;
    reject_match_flags_for_indexed_target(id, target, opts)?;

    let status_str = match (artifact, status) {
        (ArtifactType::Adr, crate::TickStatus::Accepted) => "accepted",
        (ArtifactType::Adr, crate::TickStatus::Considered) => "considered",
        (ArtifactType::Adr, crate::TickStatus::Rejected) => "rejected",
        (ArtifactType::Adr, _) => {
            return Err(Diagnostic::new(
                DiagnosticCode::E0820InvalidFieldValue,
                ADR_TICK_STATUS_ERROR,
                id,
            ));
        }
        (ArtifactType::WorkItem, crate::TickStatus::Done) => "done",
        (ArtifactType::WorkItem, crate::TickStatus::Pending) => "pending",
        (ArtifactType::WorkItem, crate::TickStatus::Cancelled) => "cancelled",
        (ArtifactType::WorkItem, _) => {
            return Err(Diagnostic::new(
                DiagnosticCode::E0820InvalidFieldValue,
                WORK_TICK_STATUS_ERROR,
                id,
            ));
        }
        (ArtifactType::Rfc | ArtifactType::Clause | ArtifactType::Guard, _) => {
            return Err(Diagnostic::new(
                DiagnosticCode::E0813SupersedeNotSupported,
                TICK_UNSUPPORTED_ARTIFACT_ERROR.replace("{id}", id),
                id,
            ));
        }
    };
    let ticked_text = match artifact {
        ArtifactType::Adr => tick_toml_field::<AdrTomlAdapter>(
            config,
            id,
            target,
            opts,
            op,
            ArtifactType::Adr,
            status_str,
        )?,
        ArtifactType::WorkItem => tick_toml_field::<WorkTomlAdapter>(
            config,
            id,
            target,
            opts,
            op,
            ArtifactType::WorkItem,
            status_str,
        )?,
        ArtifactType::Rfc | ArtifactType::Clause | ArtifactType::Guard => {
            unreachable!("handled above")
        }
    };

    if !op.is_preview() {
        crate::ui::ticked(&ticked_text, status_str);
    }

    Ok(vec![])
}