Package com.tonic.analysis.execution.debug

Breakpoints, stepping and state inspection over a running interpreter.

Interface Summary

Interface	Description
DebugEventListener	Observer of debug session lifecycle, breakpoint, step, and exception events; every callback defaults to a no-op.
InstructionInterceptor	Debugger hook invoked around each interpreted instruction, method entry and exit, and thrown exception.

Class Summary

Class	Description
AbstractInterceptor	No-op base implementation of InstructionInterceptor whose callbacks all continue execution.
Breakpoint	Breakpoint location keyed by class, method, and pc, with mutable enablement, condition, and hit tracking.
BreakpointManager	Thread-safe registry of breakpoints indexed by key and by owning method for fast location checks.
DebugSession	Interactive stepping debugger over a BytecodeEngine, driving breakpoints, step modes, and state snapshots for listeners.
DebugState	Immutable snapshot of an interpreter's position, call stack and frame contents at one moment.
DebugState.Builder	Mutable accumulator for the fields of a DebugState.
LocalsSnapshot	An immutable slot-to-value view of a frame's locals, taken at one point in execution.
StackFrameInfo	Immutable snapshot of one execution frame's position, used to build stack traces after the frame itself is gone.
StackSnapshot	An immutable view of a frame's operand stack, taken at one point in execution.
ValueInfo	A debugger-facing description of one interpreter value: its tag, a printable rendering, and the underlying object.

Enum Summary

Enum	Description
DebugSessionState	Lifecycle state of a debug session: not yet started, executing, suspended at a breakpoint, or finished.
DebugState.Status	Lifecycle state of the interpreted run.
InterceptorAction	What an interceptor tells the interpreter to do after a callback: keep going, pause, or abort.
StepMode	How far the debugger runs before pausing again.