Internal read-only viewer adapter over the shared TraceLog query layer.
The sibling viewer delegates here so it does not create a competing trace parser, query model, or source authorization boundary. Inspection artifacts are loaded and validated once at Viewer startup; requests receive an opaque immutable grant and never reopen the configured path.
Summary
Functions
Builds a semantic conversation from the pinned, already validated records.
Returns the pinned run's authorized workflow execution-error records.
Returns the pinned run's dedicated explicit-failure-value records.
Pins one artifact only after validating it against an immutable path source.
Returns the pinned run's exact effective prelude sources.
Constructs a bounded TraceLog for the source and executes one query.
Types
@opaque inspection_grant()
@type inspection_trace_source() :: {:file | :directory | :private_file | :private_directory, binary()}
Functions
@spec conversation(inspection_grant(), binary()) :: {:ok, map()} | {:error, atom()}
Builds a semantic conversation from the pinned, already validated records.
@spec execution_errors(inspection_grant(), binary()) :: {:ok, map()} | {:error, atom()}
Returns the pinned run's authorized workflow execution-error records.
@spec explicit_failure_values(inspection_grant(), binary()) :: {:ok, map()} | {:error, atom()}
Returns the pinned run's dedicated explicit-failure-value records.
@spec pin_inspection(binary(), inspection_trace_source()) :: {:ok, inspection_grant()} | {:error, atom() | PtcRunner.Kernel.InspectionArtifact.unsupported_schema_error()}
Pins one artifact only after validating it against an immutable path source.
@spec preludes(inspection_grant(), binary()) :: {:ok, map()} | {:error, atom()}
Returns the pinned run's exact effective prelude sources.
@spec query(PtcRunner.Kernel.TraceLog.source(), atom(), map()) :: {:ok, map()} | {:error, atom()}
Constructs a bounded TraceLog for the source and executes one query.