Expand description
Public wire DTO for shipshape release verify — the read-only reconcile report
(ADR-0002 §1, ADR-0003 state table).
release verify reads a journaled run and reconciles each published or
CI-delegated target against its destination. It never mutates the repo,
journal, registry, GitHub Release, or Homebrew tap. The result is emitted under the
canonical {schema_version, data, warnings} envelope, so it carries no
document version of its own (crate::SCHEMA_VERSION versions the envelope).
§The Unknown discipline
Every per-target outcome is a VerifyOutcome; a reconcile that could not
be performed (a registry outage, an unresolvable package, or a failed
read-only destination query) is VerifyOutcome::Unknown, never
VerifyOutcome::Missing. This follows the same
tri-state presence discipline shipshape audit uses. An outage must never be
read as “the release did not land”.
Structs§
- Delegated
JobFailure - One failed or cancelled job from a terminal delegated workflow run.
- Delegated
Run - Exact GitHub Actions run evidence for a delegated target.
- Reconcile
Report - The read-only reconcile report for one journaled run — the body of
shipshape release verify’s success envelope. - Reconcile
Summary - Rollup counts across all reconciled targets — the four
VerifyOutcomeclasses plus the total, so a caller branches onconflicts/missingwithout re-tallyingReconcileReport::targets. - Target
Reconcile - One published or delegated target reconciled against its destination.
Enums§
- Delegated
RunStatus - Machine-readable state of a GitHub Actions run that owns a delegated publish.