Skip to main content

Module reconcile

Module reconcile 

Source
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§

DelegatedJobFailure
One failed or cancelled job from a terminal delegated workflow run.
DelegatedRun
Exact GitHub Actions run evidence for a delegated target.
ReconcileReport
The read-only reconcile report for one journaled run — the body of shipshape release verify’s success envelope.
ReconcileSummary
Rollup counts across all reconciled targets — the four VerifyOutcome classes plus the total, so a caller branches on conflicts/missing without re-tallying ReconcileReport::targets.
TargetReconcile
One published or delegated target reconciled against its destination.

Enums§

DelegatedRunStatus
Machine-readable state of a GitHub Actions run that owns a delegated publish.