Skip to main content

Crate vyre_harness

Crate vyre_harness 

Source
Expand description

Universal Cat-A op harness registry + Region builder.

Registry Layering: This file defines the OpEntry registry for Tier-3 Cat-A compositions. It operates in parallel with the Tier-2.5 primitives registry (vyre-primitives::harness::OpEntry) and the Tier-2 hardware intrinsics registry (vyre-intrinsics::harness::OpEntry). For an architectural overview of this three-registry split, see vyre-harness/README.md.

Every Cat-A composition that participates in automated harness checks registers one OpEntry through inventory::submit!. The conform integration test at tests/universal_harness.rs discovers every entry and validates: program validity, wire round-trip, CSE stability, and (when available) CPU-oracle parity.

The crate also re-exports the Region builder used by every Cat-A library to wrap its produced Vec<Node> so optimizer passes treat the library call as an opaque unit by default. See region for wrap, wrap_anonymous, wrap_child, tag_program.

Re-exports§

pub use region::wrap;
pub use region::wrap_anonymous;
pub use region::wrap_child;

Modules§

fp_contract
Shared f32 backend-parity contract for Cat-A and conform gates.
region
Shared Region builder.

Macros§

vyre_op
Declarative op registration shorthand (ROADMAP S8 generator half).

Structs§

ConvergenceContract
Convergence contract for ops whose GPU body performs one iteration per dispatch and needs an external driver loop to reach fixpoint before byte-identity comparison.
FixpointContract
Fixpoint contract for dataflow ops whose GPU body performs one iteration per dispatch.
FixpointRegistration
Link-time registration binding a fixpoint contract to an op id.
OpEntry
Shared migration-compatible fixture descriptor for registered Cat-A programs.

Enums§

OpTier
Canonical operation tier used by harness, catalog, and matrix gates.

Functions§

all_entries
Return all registered operation entries.
classify_op_id
Classify an operation id by the canonical namespace contract.
convergence_contract
Look up the convergence contract registered for op_id, if any.
fixpoint_contract
Look up the fixpoint contract registered for op_id, if any.
reparent_program_children
Clone a program’s entry regions and attach them to a composing parent.
tag_program
Wrap an existing program under one canonical parent composition boundary.

Type Aliases§

ExpectedFn
Deterministic expected-output fixtures.
InputsFn
Deterministic fixture input cases.