saccade 0.2.9

Visual-regression CLI for renderers and graphics code, built on NVIDIA FLIP
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

//! Offline blind packets and advisory disagreement aggregation.
use crate::agent::CliError;
use saccade_core::review_board;
use std::path::PathBuf;

#[derive(clap::Args)]
pub(crate) struct Args {
    #[command(subcommand)]
    operation: Operation,
}
#[derive(clap::Subcommand)]
enum Operation {
    /// Generate separate blind forms/files; keep trial.json private.
    Prepare {
        plan: PathBuf,
        /// A new directory whose parent exists.
        #[arg(long)]
        out: PathBuf,
    },
    /// Collect offline ballots; output must be outside the prepared bundle.
    Collect {
        trial: PathBuf,
        /// Returned ballot file; repeat for each rater. Omitted raters stay missing.
        #[arg(long = "ballot")]
        ballots: Vec<PathBuf>,
        /// New operator-only board directory; never distribute before voting closes.
        #[arg(long)]
        out: PathBuf,
    },
}
pub(crate) fn run(args: Args, json: bool) -> Result<u8, CliError> {
    let (mode, out, data) = match args.operation {
        Operation::Prepare { plan, out } => {
            let value = review_board::prepare(
                &review_board::read(&plan, review_board::PLAN_SCHEMA)?,
                &plan,
                &out,
            )?;
            ("review.board.prepare", out, value)
        }
        Operation::Collect {
            trial,
            ballots,
            out,
        } => {
            if ballots.len() > 32 {
                return Err(CliError::usage("at most 32 ballot files"));
            }
            let ballots = ballots
                .iter()
                .map(|p| review_board::read(p, review_board::BALLOT_SCHEMA))
                .collect::<Result<Vec<_>, _>>()?;
            let board = review_board::collect(&trial, &ballots, &out)?;
            let data = serde_json::json!({"trial_id":board["trial_id"],"report_id":board["report_id"],"items":board["items"].as_array().map_or(0, Vec::len),"raters":board["raters"].as_array().map_or(0, Vec::len),"agreement":board["agreement"],"approval_authority":false});
            ("review.board.collect", out, data)
        }
    };
    if json {
        let mut result = crate::local_cmd::base_result(mode);
        let artifact = out.join(if mode == "review.board.prepare" {
            "trial.json"
        } else {
            "saccade-review-board.v2.json"
        });
        result["artifact"] = crate::local_cmd::reference(&artifact)?;
        result["data"] = data;
        result["verdict"] = serde_json::json!("advisory");
        result["limits"] = serde_json::json!([
            "Votes and agreement statistics grant no baseline approval authority."
        ]);
        crate::emit(&format!("{}\n", serde_json::to_string(&result)?))?;
    } else {
        crate::emit(&format!(
            "{mode}: {} — advisory only; no baseline approval\n",
            out.display()
        ))?;
    }
    Ok(0)
}