Module artifact 

Generic content-addressed input artifacts inside an execution scope.

This module owns immutable artifact publication and integrity verification: deterministic naming, SHA-256 identity computation, deduplicating persistence, descriptor encoding, and strict load-time checks.

Boundary

Artifact handling is intentionally limited to bytes. The module does not own execution policy, storage stream formats, task scheduling, or scientific semantics. Callers map descriptors into their own provenance domain and pass them through ExecutionScope paths.

Structs

ArtifactDescriptor

Exact identity and execution-relative location of immutable bytes.

PersistedArtifact

Result of atomically publishing immutable content.

VerifiedArtifact

Verified canonical path and exact immutable bytes.

Enums

ArtifactDisposition

Whether publishing created new bytes or reused identical existing bytes.

ArtifactError

Failure while validating or publishing an immutable artifact.

ArtifactLoadError

Failure while locating or verifying a persisted artifact.

Functions

load_verified_artifact

Reads immutable bytes after path-containment and exact-digest verification.

persist_artifact

Atomically publishes exact bytes beneath scope/inputs using their SHA-256.