pub struct RunArtifact {
pub artifact_id: String,
pub name: Option<String>,
pub media_kind: MediaKind,
pub media_type: Option<String>,
pub lineage: ArtifactLineage,
pub versions: Vec<ArtifactVersion>,
pub retention: RetentionPolicy,
pub created_at: DateTime<Utc>,
}Expand description
A run-produced output made operable: the plane’s only persisted entity.
Keyed by content address (artifact_id), tenant-scoped at the
metadata layer. Bytes are deliberately not tenant-namespaced —
content addressing makes byte storage global (two tenants producing
identical bytes share one object) — and the metadata layer is the
only path that lists or resolves, so a shared address grants no
cross-tenant read path.
Fields§
§artifact_id: StringThe content address: lowercase hex SHA-256 of the bytes, exactly
the ArtifactRef rule. Identity is integrity.
name: Option<String>The logical name (weekly-report) versions accumulate under, or
None for an address-only artifact: produced, referenced,
retained, expired. The naming rules are the registry’s
(MAX_ARTIFACT_NAME_LEN, no @, no /, no control
characters), for the same reason: names ride in keys that tenant
prefixes and environment tags already punctuate. Absent from the
wire when unnamed — an address-only artifact carries no
placeholder.
media_kind: MediaKindThe media class (drives preview eligibility, Wave 2).
media_type: Option<String>The producer-declared media type (image/png,
text/csv), preserved verbatim: the runtime records the claim,
it cannot certify it. Absent when the producer declared none.
lineage: ArtifactLineageWhere these bytes came from (run, effect, event). Recorded at commit, never edited.
versions: Vec<ArtifactVersion>The name’s version sequence, oldest first, append-only — present exactly for named artifacts. Wave 1 writes one entry (the committed object itself); Wave 2’s accumulation appends.
retention: RetentionPolicyThe declared retention. Journaled with the commit; shortening it later is a governance act, not housekeeping.
created_at: DateTime<Utc>When the artifact was committed.