Crate stow_types 

Shared API and identity types for the stow workspace.

The crate contains the wire types CI, edge, scheduler, and CLI exchange over HTTP / D1, plus the identity newtypes (CrateName, CMetadata, TargetTriple, WireRustcVersion, FeaturesJson, DependencyCMetadataJson) that enforce the five-element artifact identity tuple at compile time.

Modules

api

HTTP wire types exchanged between the CLI, the edge worker, the scheduler Durable Object, and trusted CI.

artifact

Artifact classification and identity: rustc crate types, artifact kinds, the semantic ArtifactKey, and the bundle metadata CI records alongside each uploaded artifact.

bundle

OCI bundle layout: the media types and in-tar paths of a stow artifact bundle, plus the manifest wire types the CLI reads after signature verification.

capture

Rustc capture records shared between the capture wrapper and the build stage.

crate_info

Crate coordinates (CrateId) and the canonical FeatureSet used in artifact identity hashing.

error

The error type shared across stow crates, plus the Context extension trait that annotates foreign Results with stow-style context.

hash

Deterministic BLAKE3 hashing of ArtifactKey for analytics and display.

identity

Newtype wrappers for the five-element artifact identity carried over the wire and persisted in D1.

native_capture

Capture of a build script’s OUT_DIR products into NativeArtifacts.

platform

Toolchain and target descriptions: target triples, rustc versions, compile profiles, and panic strategy.

pow

Shared proof-of-work metric for the enqueue admission flow.

public_cache

Derivation of the stable artifact identity a crates.io-registry build maps to: the compile key, c_metadata, and extra_filename computed from a captured rustc invocation.

registry

GHCR OCI reference construction and parsing for stow artifacts.

rustc

Parser for the rustc command line the wrapper observes, plus helpers that decide cacheability and predict output paths from the parsed arguments.

trusted_builder

Identity of the one GitHub Actions workflow whose signatures the CLI trusts.

upload_plan

Upload planning: the PlannedArtifact list CI produces after a build, and the compile-key hash that binds a cached artifact to one exact rustc invocation identity.

versioning

Semver reasoning for cache coverage: which upgrade a client may accept silently, and which breaking line a version belongs to.

Macros

stow_error

Build an Error from a format!-style message.