HTTP API: convergence

Konvergence repozitáře: každé držení a jediný verdikt nad nimi.

use majordomus_cli::convergence::{ConvergenceReport, SCHEMA};

let empty = ConvergenceReport {
    schema: SCHEMA.into(),
    repository: "/tmp/r".into(),
    trunk: Some("master".into()),
    holdings: vec![],
    tallies: Default::default(),
    at_risk: 0,
    converged: true,
};
// the verdict is the one word a gate reads; the count is what a person reads next to it
assert!(empty.converged && empty.at_risk == 0);
assert_eq!(serde_json::to_value(&empty).unwrap()["schema"], "convergence/v1");

Odkud je dosažitelná práce, kterou držení nese.

Pořadí je pořadí bezpečnosti: vše nad Disposition::LocalOnly je dosažitelné někým, kdo není worker, který to vytvořil.

use majordomus_cli::convergence::Disposition;

// declared in the order of safety, so the derived order says which is worse
assert!(Disposition::Integrated < Disposition::Published);
assert!(Disposition::Published < Disposition::LocalOnly);
assert_eq!(serde_json::to_string(&Disposition::LocalOnly).unwrap(), "\"local_only\"");

Jedna věc držící práci a co je známo o tom, odkud je ta práce dosažitelná.

use majordomus_cli::convergence::{Disposition, Holding, HoldingKind};

let branch = Holding {
    kind: HoldingKind::Branch,
    identity: "feature/x".into(),
    disposition: Disposition::LocalOnly,
    evidence: "abc123 is on no remote-tracking ref of this checkout".into(),
    remedy: "git push -u origin feature/x".into(),
    at_risk: true,
};
// an at-risk holding always carries the command that would move it out of danger
assert!(branch.at_risk && !branch.remedy.is_empty());
// and a reachable one carries none, so the field is left out of the document
let safe = Holding { disposition: Disposition::Published, remedy: String::new(), at_risk: false, ..branch };
assert!(!serde_json::to_string(&safe).unwrap().contains("remedy"));

Co za věc práci drží.

use majordomus_cli::convergence::HoldingKind;

// the word a report and a persisted record use; renaming a variant must not rename it
assert_eq!(HoldingKind::Worktree.as_str(), "worktree");
assert_eq!(serde_json::to_string(&HoldingKind::Stash).unwrap(), "\"stash\"");