Complete first release candidate audit (#107)

tools/ci-matrix/src/main.rs

@@ -1,7 +1,7 @@
 use metacrate_ci_matrix::{
     audit, audit_api_surface, audit_artifacts, audit_dependencies, audit_documentation,
-    audit_provenance, load, run, workspace_root, write_api_baseline, write_documentation_report,
-    write_provenance_reports,
+    audit_provenance, audit_release_candidate, load, run, workspace_root, write_api_baseline,
+    write_documentation_report, write_provenance_reports,
 };
 use std::path::{Path, PathBuf};
 
@@ -53,6 +53,9 @@ fn execute() -> Result<(), Box<dyn std::error::Error>> {
         Some("artifact-audit") => {
             artifact_audit_command(&root, arguments)?;
         }
+        Some("release-candidate-audit") => {
+            release_candidate_audit_command(&root, arguments)?;
+        }
         Some("documentation-report") if arguments.next().is_none() => {
             write_documentation_report(&root)?;
             println!("documentation coverage report: updated");
@@ -98,7 +101,7 @@ fn execute() -> Result<(), Box<dyn std::error::Error>> {
         }
         _ => {
             return Err(
-                "usage: ci-matrix audit | run PROFILE --evidence FILE | dependency-audit --evidence FILE | artifact-audit --artifact-dir DIR --package-dir DIR --evidence FILE | documentation-report | documentation-audit --evidence FILE | api-baseline-write | api-audit --evidence FILE | provenance-report | provenance-audit --evidence FILE"
+                "usage: ci-matrix audit | run PROFILE --evidence FILE | dependency-audit --evidence FILE | artifact-audit --artifact-dir DIR --package-dir DIR --evidence FILE | release-candidate-audit --evidence FILE | documentation-report | documentation-audit --evidence FILE | api-baseline-write | api-audit --evidence FILE | provenance-report | provenance-audit --evidence FILE"
                     .into(),
             );
         }
@@ -106,6 +109,25 @@ fn execute() -> Result<(), Box<dyn std::error::Error>> {
     Ok(())
 }
 
+fn release_candidate_audit_command(
+    root: &Path,
+    mut arguments: impl Iterator<Item = String>,
+) -> Result<(), Box<dyn std::error::Error>> {
+    let flag = arguments
+        .next()
+        .ok_or("release-candidate-audit requires --evidence FILE")?;
+    let evidence = arguments
+        .next()
+        .ok_or("release-candidate-audit requires --evidence FILE")?;
+    if flag != "--evidence" || arguments.next().is_some() {
+        return Err("usage: ci-matrix release-candidate-audit --evidence FILE".into());
+    }
+    let evidence = absolute_or_rooted(root, &evidence);
+    audit_release_candidate(root, &evidence)?;
+    println!("first release candidate: ok ({})", evidence.display());
+    Ok(())
+}
+
 fn artifact_audit_command(
     root: &Path,
     mut arguments: impl Iterator<Item = String>,