Expand description
Producer-side release planning and finalized artifact evidence.
Re-exports§
pub use digest::*;
Modules§
- digest
- The single producer-side file-digest authority.
Structs§
- Bound
Command - Exact source command associated with a logical output.
- Build
Attempt - Result of a single bounded build attempt.
- Build
Binding - A Cargo package and binary target explicitly bound to a logical contract slot.
- Build
Bindings V1 - Strict producer-side BuildBindings schema version 1.
- Build
Cancellation - Cloneable caller cancellation flag for bounded builder work.
- Build
Error - Failure from producer build planning or execution.
- Candidate
Artifact - Candidate bytes produced for a declared logical output.
- Candidate
Smoke Binding - One fixed-argument smoke invocation for an exact logical candidate.
- Command
Spec - Explicit shell-free process command. Executable and argv are separate OS arguments.
- Core
Error - Manifest construction failure. Paths and file contents are intentionally omitted.
- Finalization
Request - Identity and target evidence aggregated into one local release.
- Finalization
Target Input - One target’s exact build and qualification evidence to finalize.
- Finalized
Release - Completed local output root and manifest, returned only after complete validation.
- Finalized
Release Input - Caller-supplied identity and finalized file inventory for one release.
- Finalized
Target Input - Explicit mapping of one target’s expanded contract filenames to local finalized files.
- Host
Requirement - Provider-neutral OS/architecture capability required of a host.
- Interpreter
Command Spec - Explicit shell-free interpreter command for a bounded consumer-validator run.
- Pack
Config - Strict PackConfig v1 document.
- Planned
Target - One selected target’s canonical policy and contract-derived artifact form.
- Process
Evidence - Bounded process evidence with no environment dump.
- Qualification
Bindings V1 - Strict producer-side qualification bindings schema version 1.
- Qualification
Error - Qualification binding validation or execution setup error.
- Qualification
Evidence - Complete bounded evidence for one release target qualification attempt.
- Qualification
Process Evidence - One bounded process result without output contents or environment values.
- Qualification
Request - All explicit producer-side inputs required to qualify one planned target.
- Qualification
Runtime - Bounded QEMU runtime input. The executable and flags are fixed by the target mapping.
- Qualified
Candidate Evidence - Exact candidate byte and structural identity observed for qualification.
- Release
Plan - Canonically ordered pure release planning result.
- Target
Policy - One target policy in PackConfig v1.
- Target
Qualification Binding - Qualification settings for one canonical planned target.
- Toolchain
Requirement - Explicit compiler/toolchain requirements; no version is inferred from the host.
Enums§
- Archive
Encoding - Explicit archive encoding accepted by the local finalizer.
- Build
Strategy - Explicit finite build strategy. Planning never executes either strategy.
- Candidate
Architecture - Supported executable CPU architectures.
- Candidate
Format - Supported executable file formats checked structurally.
- Command
Outcome - Command exit classification.
- Compatibility
Floor - Explicit compatibility floor for produced binaries.
- Exact
TagSafety Error - Why an exact release tag was refused for safety reasons.
- Floor
Applicability Error - Why a declared compatibility floor does not apply to a target.
- Floor
Unverified Reason - Why a declared compatibility floor could not be independently verified.
- Floor
Verification Status - The verification status of a declared compatibility floor.
- Host
Arch - Host CPU architecture family.
- HostOs
- Host operating system family.
- Logical
Output Selector - Contract logical location for one Cargo-produced executable.
- Planned
Asset Form - Contract-derived release artifact form.
- Qualification
- Qualification classification stored as intent, not proof.
- Qualification
Failure - Bounded reason for failed qualification.
- Qualification
Method - Actual qualification method, distinct from requested policy.
- Qualification
Status - Typed qualification outcome; a built candidate can never imply Passed by itself.
- Sha256
Error - Why a SHA-256 hex digest string was refused.
- Support
Tier - Support and release gating tier.
Functions§
- build_
manifest - Build and hash a complete schema-v1 manifest from explicitly supplied files.
- cargo_
command - Construct the only supported Cargo command for a planned logical output.
- discover_
candidate - Resolve and validate exactly the Cargo release output path.
- execute_
target - Execute one target using explicit bindings, private target storage, and exact output discovery.
- execute_
target_ cancellable - Execute a target with explicit caller cancellation and bounded cleanup.
- finalize_
release - Finalize candidate bytes under an initially absent, caller-selected private directory.
- floor_
status_ admissible - Whether a floor verification status is admissible for a declared floor and build strategy.
- host_
matches_ target - Whether a host requirement matches a canonical target triple.
- planned_
floor_ status - The floor verification status a plan states for its declared floor.
- private_
target_ dir - Establish a caller-owned absolute work root and a unique target directory.
- qualify_
target - Execute M003 qualification using actual local host facts.
- run_
bounded_ cancellable - Run a process with a deadline and caller cancellation, cleaning up its process group.
- run_
git_ bounded - Run a bounded
gitprocess group that must echo exactlyexpectedon stdout. - run_
git_ tag_ bounded - Verify an exact local tag peels to the expected commit using bounded git.
- run_
interpreter_ bounded - Run a bounded consumer-validator interpreter process group.
- validate_
exact_ tag_ safety - Whether an exact release tag is safe to handle.
- validate_
floor_ applicability - Whether the declared compatibility floor applies to a target triple and a build strategy.
- validate_
policy - Validate one target policy against its canonical target triple.
- validate_
sha256_ hex - Validate one SHA-256 hex digest against the canonical acceptance set.