Skip to main content

CheckReport

Struct CheckReport 

Source
pub struct CheckReport { /* private fields */ }
Expand description

The outcome of dive check.

Implementations§

Source§

impl CheckReport

Source

pub fn result(&self) -> Option<&CheckResult>

The safety checker’s result, including a safety stop in final/short checking. Temporal holds/violations use Self::temporal_result.

Source

pub fn diagnostic_witness(&self) -> Option<&DiagnosticWitness>

Separate original initial-state diagnostic context. This is not a formal counterexample; its named cause and deciding replay need independent proof.

Source

pub fn temporal_result(&self) -> Option<&Report>

The validated temporal result, when final/short checking ran. Safety stops are exposed through Self::result instead.

Source

pub fn temporal_failure(&self) -> Option<&Failure>

The typed temporal failure, when temporal checking stopped without a verdict: its crate::temporal::Error, stage and available evidence.

Source

pub fn verdict(&self) -> &'static str

The verdict’s name in the JSON document.

Source

pub fn exit_code(&self) -> u8

The historical API profile’s exit code (see exit).

This remains native for the dive profile and TLC for the TLC profile. The CLI’s independent default is selected with Self::exit_code_for.

Source

pub fn exit_code_for(&self, convention: ExitConvention) -> u8

Selects a process status without changing the evaluator’s profile.

TLC statuses come from the deciding class, not its reported message. Refusal/resource 3 and internal error 4 are preserved in both conventions. This does not establish parity of an unverified class or model result.

Source

pub fn to_json_with_exit_convention(&self, convention: ExitConvention) -> Value

Reports an explicitly selected physical status and its convention.

The underlying evaluator settings and deciding class are unchanged. Native statuses with TLC evaluation are labeled tlc+overrides. Self::to_json retains its historical API document.

Source

pub fn render_human_with_exit_convention( &self, convention: ExitConvention, ) -> String

Human output with the resolved physical status and compatibility label. Self::render_human retains its historical API output.

Source

pub fn to_json(&self) -> Value

The JSON document (schema CHECK_SCHEMA_VERSION). check_kind names the safety or temporal request/report family; it does not assert that checking ran or that capture completed. Final/short safety failures retain the temporal family and their actual execution evidence:

{ "schema_version": 3, "command": "check", "file", "config",
  "verdict": "success" | "invariant-violation" | "property-violation"
           | "action-property-violation" | "deadlock" | "assumption-failure"
           | "postcondition-failure" | "assertion-failure" | "overflow"
           | "evaluation-error" | "incomplete-state" | "model-error"
           | "rejected" | "unsupported" | "resource-limit" | "stopped"
           | "internal-error",
  "property": string | null, "message": string | null,
  "error_site": string | null,
  "tlc": { "code", "name", "exit_status", "reported", "verified" } | null,
  "statistics": { "generated", "distinct", "left_on_queue", "depth",
                  "initial_generated", "reported_by_tlc" } | null,
  "counterexample": { "length", "ending": "finite",
                      "states": [ { "index", "label", "action",
                                    "values": { var: TLC JSON }, "text" } ],
                      "trace": dive-trace document | null } | null,
  "diagnostic_witness": { "trace": native-v2 named cause document }, // optional
  "collision": { "store", "scheme", "optimistic", "actual", "assumption" } | null,
  "output": [ string ], "warnings": [ { "code", "message" } ],
  "diagnostics": [ ... ], "notes": [ string ],
  "stopped": { "resource": "time" | "memory" | "states" | "depth", "limit", "observed", "elapsed_ms",
               "unit": "ms" | "bytes" | "states" | "levels", "phase", "hint" }   (only when stopped),
  "options": { "profile", "int", "choose_order", "explore_order",
               "comparisons", "warnings", "store", "fingerprint",
               "seed", "seed_source", "deadlock_flag",
               "budget": { "time_limit_ms", "time_limit_source",
                           "max_memory_bytes", "max_memory_source", "max_states", "max_depth", "scope" },
               "workers": { "requested", "used", "sequential", "reason",
                            "chaos" } },
  "elapsed_ms" }

tlc is how TLC classifies the result: code decides TLC’s exit status, and reported is the code of the error message TLC prints first (an invariant that fails to evaluate is reported as TLC_INVARIANT_EVALUATION_FAILED, for example); verified: false means dive does not yet reproduce TLC’s error class at that site and does not claim it. reported_by_tlc is false where TLC prints no statistics (a stop while generating initial states). Explicit final-only schema 3 also declares the schedule/selection, fixed entry/work bounds and actual failure stage. Periodic traces include all configured property names and a stuttering ending or one-based lasso target; independent replay precedes any private-certified temporal violation.

Source

pub fn render_human(&self) -> String

The TLC-style text report (see dive_runtime::render_human), preceded by the run’s options and the Print output.

Trait Implementations§

Source§

impl Debug for CheckReport

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.