Module release 

Public wire DTOs for the release engine’s per-target adapter facts (ADR-0002).

These are the shapes an adapter produces and the coordinator journals and re-emits: the dry-run command plan, the build-artifact manifest, the publish receipt (a durable fact — the canonical ref/digest/URL captured at publish time, never re-derived later), and the read-only verify outcome that drives the resume/reconcile state table (ADR-0003).

Like every other ossctl wire surface these ride the CLI’s canonical envelope — a --json {schema_version, data, warnings} document or a --output=jsonl event stream — so they carry no document version of their own; crate::SCHEMA_VERSION versions the envelope they travel in. They are versioned independently of the internal domain types so ossctl-core can refactor adapter internals without a wire break (ADR-0001 §2). This is a hot file under the migration rule: a breaking change here bumps crate::SCHEMA_VERSION, never silently.

The Unknown discipline

VerifyOutcome mirrors the audit’s tri-state presence discipline: a remote reconcile that could not be performed (a registry outage, a package the RegistryQuery port cannot resolve) yields VerifyOutcome::Unknown, never VerifyOutcome::Missing. An outage must never be read as “the release did not land” — that is the one classification that would drive a dangerous re-publish of an already-published version.

Structs

BuildArtifacts

The result of an adapter’s build — the re-runnable artifact manifest.

DryRunReport

The result of an adapter’s dry_run — the re-runnable, side-effect-free preview of exactly what a real cut would do for this target.

PlannedCommand

One external command an adapter intends to run, captured as data rather than executed — the atom of a DryRunReport and the auditable record of what a build/publish step shelled out to.

PublishReceipt

A publish receipt — the durable fact captured the moment a target’s publish landed (ADR-0002 §1).

Enums

VerifyOutcome

The typed result of an adapter’s read-only verify — how the published receipt reconciles against what the registry currently holds (ADR-0002 §1).