Struct PluginTracer 

pub struct PluginTracer { /* private fields */ }

The boundary-trace sink — the LspLogger analogue. Cheap to trace into (gate → push → publish); everything expensive is deferred to the off-thread drain.

Implementations

impl PluginTracer

pub fn new(default_level: TraceLevel, capacity: usize) -> Self

Construct a tracer with default_level and a per-ring capacity.

pub fn with_defaults() -> Self

Sensible defaults: Info (no per-call trace by default — design §7), 10k records / ring.

pub fn set_event_publisher( &self, publisher: Box<dyn Fn(PluginTraceRecord) + Send + Sync>, )

Install / replace the event publisher (wired at boot to the runtime bus).

pub fn set_default_level(&self, level: TraceLevel)

Set the default verbosity gate (:set plugin.trace-level=…). Republishes the new level to every hot-path gate whose plugin has no override, so the grammar trampoline picks it up on the next keystroke.

pub fn set_plugin_level(&self, plugin: u32, level: TraceLevel)

Override one plugin’s verbosity gate (a per-plugin :set / manager-view toggle). The hot-path seam reads this, so raising one plugin’s verbosity never touches another’s cost. Republishes to that plugin’s hot-path gate.

pub fn hot_gate(&self, plugin: u32) -> HotGate

The published hot-path gate for plugin — created (seeded to the plugin’s current effective level) on first request and cached, so repeated calls return clones of the same atomic. The sync grammar trampoline holds one and reads it once per guest call (design §4).

pub fn plugin_level(&self, plugin: u32) -> TraceLevel

The effective gate for plugin — its override, else the default.

pub fn trace(&self, record: PluginTraceRecord)

Append a record: gate by the plugin’s effective level, push to the per-plugin + global rings (bounded), then fire the publisher. A record above the gate is dropped before any ring work.

pub fn snapshot_plugin(&self, plugin: u32) -> Vec<PluginTraceRecord>

Snapshot one plugin’s ring (cheap clone), newest last — the seed for a per-plugin trace view.

pub fn snapshot_global(&self) -> Vec<PluginTraceRecord>

Snapshot the subsystem-wide ring — the seed for the shared trace view.

pub fn forget_plugin(&self, plugin: u32)

Drop a plugin’s ring + gate override (on unload — reclaim its trace memory). The global ring keeps its historical records.