Expand description
Verification control-plane artifact types and scheduling logic.
This crate defines the canonical schema types for verification cases,
check plans, attempts, control receipts, ledger entries, and governance
review artifacts (effect, delegation, release-gate, continuity). It also
provides scheduling, promotion-eligibility, and ledger-replay functions
consumed by forge-pilot and the verification pipeline crates.
Re-exports§
pub use v14::ComparabilityMatrixV1;pub use v14::DecisionTraceV1;pub use v14::DisputeBundleV1;pub use v14::ExperimentCaseV1;pub use v14::RefuterResultV1;pub use v14::COMPARABILITY_MATRIX_V1_SCHEMA;pub use v14::DECISION_TRACE_V1_SCHEMA;pub use v14::DISPUTE_BUNDLE_V1_SCHEMA;pub use v14::EXPERIMENT_CASE_V1_SCHEMA;pub use v14::REFUTER_RESULT_V1_SCHEMA;pub use BoundaryRepairRecord as RepairRecord;pub use CheckPlan as ExecutionPlan;pub use VerificationCase as ControlCase;
Modules§
- v14
- V14 experimental verification artifact types.
Structs§
- Boundary
Repair Record - Record of a single field-level repair applied to a boundary artifact.
- Budget
Debit - Budget lineage for one debit against a turn’s execution envelope.
- Budget
Lineage - Budget and retry lineage for a scheduled verification plan.
- Case
Region - Scope and location metadata for a verification case target.
- Cheap
Check Status V1 - Status of a single cheap-check preflight evaluation.
- Check
Plan - A check plan specifying the verification method, promotion class, and proof profile for a case.
- Continuity
Review Case V1 - A review case for continuity incidents (outage, recovery, exception handling).
- Control
Receipt - An immutable receipt recording a control-plane action with full provenance.
- Degradation
Marker - A marker indicating degraded verification quality and whether it blocks promotion.
- Delegation
Review Case V1 - A review case for authority delegation decisions.
- Dispatch
Decision - Per-turn dispatch truth: which backend ran and why.
- Effect
Block Receipt V1 - Receipt emitted when an effect action is blocked by policy or budget constraints.
- Effect
Review Case V1 - A review case for an effect-system action (intent, preflight, commit decision).
- Ledger
Entry - A sequenced, timestamped entry in the verification case ledger.
- Proof
Profile V1 - Proof profile describing evidence admissibility, cheap-check status, and remaining obligations.
- Queue
Hop - A single queue-to-queue hop in the scheduler routing chain.
- Receipt
Budget Context - Budget context attached to a control receipt for cost and time tracking.
- Region
Artifact Transport - Transport record for an artifact crossing between compiled verification regions.
- Release
Gate Case V1 - A review case for release-gate decisions.
- Replayed
Case State - Aggregate state reconstructed by replaying a verification case ledger.
- Retry
Decision - Queryable retry lineage for a turn or tool family.
- Rollback
Decision - Canonical rollback/compensation requirement for a turn.
- Scheduler
Decision - Scheduler decision record preserving budget, degradation, and routing lineage for a plan.
- Syndrome
Route Record - Routing record linking a syndrome to a repair candidate and its blast radius.
- Tool
Exposure - Tool
Exposure Decision V1 - Explicit per-turn tool exposure, including the empty set.
- V25Citation
Context - Constitutional citation context attached to governance review artifacts.
- V25Control
Obligation Refs - Obligation references attached to a governance review artifact.
- Verification
Attempt - A single execution attempt within a verification case and plan.
- Verification
Case - A single verification case tracking a governance issue from open to closed.
Enums§
- Boundary
Artifact Kind - Kind of artifact subject to boundary repair.
- Cheap
Check Kind V1 - Kind of lightweight preflight check in the cheap-check ladder.
- Check
Method - Verification method used by a check plan to evaluate a case.
- Constitutional
Context Status - Completeness status of the constitutional context payload on a review artifact.
- Continuity
Review Final State V1 - Terminal state of a continuity review case.
- Control
Action Kind - Kind of action recorded in a control receipt.
- Control
Retry Owner V1 - Which subsystem owns retry responsibility for a control action.
- Delegation
Review Decision State V1 - Terminal decision state of a delegation review case.
- Dispatch
Path Kind - How a turn ultimately dispatched after planning completed.
- Effect
Block Reason V1 - Reason an effect action was blocked.
- Effect
Review Final State V1 - Terminal state of an effect review case.
- Execution
Stop Reason - Terminal reason why a turn stopped.
- Ledger
Event - An event in the verification case ledger.
- Promotion
Class - Priority tier for promotion eligibility (P0 = highest).
- Region
Artifact Kind - Kind of artifact transported between compiled regions.
- Release
Gate Final State V1 - Terminal state of a release-gate review case.
- Reversibility
Class - How difficult it is to reverse a promoted verification result.
- Terminal
Disposition - Terminal outcome of a closed verification case.
- Verification
Attempt State - Execution state of a verification attempt.
- Verification
Case Class - Classification of the issue that opened a verification case.
- Verification
Case Lifecycle State - Lifecycle state of a verification case from open to closed.
- Verification
Workload Class - Scheduler workload class used for budgeting and queue routing.
Constants§
- BOUNDARY_
REPAIR_ RECORD_ V1_ SCHEMA - BUDGET_
DEBIT_ V1_ SCHEMA - CHECK_
PLAN_ V1_ SCHEMA - CONTINUITY_
REVIEW_ CASE_ V1_ SCHEMA - CONTROL_
CASE_ V1_ SCHEMA - CONTROL_
RECEIPT_ V1_ SCHEMA - DELEGATION_
REVIEW_ CASE_ V1_ SCHEMA - DISPATCH_
DECISION_ V1_ SCHEMA - EFFECT_
BLOCK_ RECEIPT_ V1_ SCHEMA - EFFECT_
REVIEW_ CASE_ V1_ SCHEMA - EXECUTION_
PLAN_ V1_ SCHEMA - LEDGER_
ENTRY_ V1_ SCHEMA - REGION_
ARTIFACT_ TRANSPORT_ V1_ SCHEMA - RELEASE_
GATE_ CASE_ V1_ SCHEMA - REPAIR_
RECORD_ V1_ SCHEMA - RETRY_
DECISION_ V1_ SCHEMA - ROLLBACK_
DECISION_ V1_ SCHEMA - ROLLBACK_
RECORD_ V1_ SCHEMA - SCHEDULER_
DECISION_ V1_ SCHEMA - SYNDROME_
ROUTE_ RECORD_ V1_ SCHEMA - TOOL_
EXPOSURE_ V1_ SCHEMA - VERIFICATION_
ATTEMPT_ V1_ SCHEMA - VERIFICATION_
CASE_ V1_ SCHEMA
Functions§
- infer_
workload_ class - Maps a check method onto the scheduler workload class used for budgeting and routing.
- interpret_
promotion_ eligibility - Combines policy, calibration, degradation, budget, and method outcome into promotion eligibility.
- interpret_
rollback_ requirement - Returns true when a refuted artifact must be rolled back from an already promoted state.
- replay_
case - Replays a case ledger in sequence order and reconstructs the terminal aggregate state.
- retry_
owner_ label - Converts retry ownership into the stable label used on control-plane artifacts.
- schedule_
check_ plan - Builds the scheduler decision record that preserves budget and degradation lineage.