PtcRunner.Kernel.InspectionQuery (PtcRunner v0.15.0)

Copy Markdown View Source

ETS-selected queries that verify dependency frames before returning a page.

Cursors bind the admission snapshot digest and the logical query identity. They do not rehash the complete evidence preimage. ETS supplies ordering, membership, cursor position, and exact omitted_count; only returned items and their join or turn dependencies are reread and verified.

Summary

Types

metrics()

@type metrics() :: %{
  postings_visited: non_neg_integer(),
  candidate_frames_verified: non_neg_integer(),
  hash_operations: non_neg_integer(),
  ranges: non_neg_integer(),
  bytes_read: non_neg_integer(),
  exact_count_work: non_neg_integer()
}

operation()

@type operation() ::
  :list_runs
  | :get_run
  | :turns
  | :model_exchanges
  | :capability_calls
  | :generated_sources
  | :effective_preludes
  | :provider_exchanges
  | :execution_prints
  | :execution_errors
  | :explicit_failure_values
  | :result

Functions

empty_metrics()

@spec empty_metrics() :: metrics()

operations()

@spec operations() :: [atom()]

run(snapshot, operation, arguments, max_result_bytes, metadata \\ %{})

@spec run(map(), atom(), map(), pos_integer(), map()) ::
  {:ok, map(), metrics()} | {:error, atom()}