get_waveform_summary

Focus on one grouped failure and return log plus waveform context

Auto-build a Verdi KDB from the parsed compile log (vericom + elabcom). Use when the simulator is Xcelium (xrun) and the NPI backend reports no KDB. Output is cached under TRACEWEAVECACHEDIR (default ~/.cache/traceweave/kdb/<hash>/); cache hits skip re-running Verdi. With TRACEWEAVENPIEXECUTION=lsf,

Stream compile evidence and build the full testbench hierarchy server-side without retaining raw source bodies; return a slim payload (project, stats, depth-2 tree skeleton, interfaces, ambiguousbasenames, buildmetrics, hierarchyhandle). For split VCS flows, pass ordered supplementarycompilelogs onc

Compare two simulation runs by paths or by basesnapshotid / newsnapshotid. If only newlogpath is supplied after an earlier parsesimlog of the same path, TraceWeave uses the previous parsed snapshot as the baseline.

Trace a waveform signal back to likely RTL driver logic

List the consumers (fanout) of a signal — module-input ports, RHS uses, always-block sensitivity

Read-only summary of cached session data and suggested next calls; mirrors parsesimlog's protocolsymptomhint so a scoreboard failure surfaces the protocol-health pointer at session start

Extract raw log context around a specific line

Bounded, tool-neutral discovery of local formal projects, role-labeled logs, and exported VCD/FSDB files. formaltool accepts auto or jaspergold; optional explicit artifact paths must remain inside formalroot. The coverage receipt describes discovery completeness only, and the result intentionally co

Query a signal value at a specific timestamp

Retrieve transitions for a signal over the strict closed interval [starttimeps, endtimeps]; FSDB and VCD never mix an earlier timestamp into transitions. The last value-change strictly before the window is exposed separately as predecessor, which clocked samplers use to classify a transition at the

Retrieve context around a failure timestamp. transitionsinwindow is a strict closed-window list; prewindowtransitions contains only earlier value changes, capped by extratransitions and ordered chronologically on both FSDB and VCD. Flags a valueatcenter that is a sub-cycle transient (a combinational

Sample signals cycle-by-cycle on a clock edge

Discover compile logs, sim logs, waveforms, simulator, and cases. Optional explicit simlog / wavefile / compilelog overrides win over auto-discovery; omitted fields are still discovered (anchored at the simlog/wavefile directory)

Parse and normalize runtime failures into grouped summaries and failureevents; also returns logsnapshotid so same-path reruns can be compared after the simulator overwrites the log. Its candidatepreviouslogs are evidence-backed simulation siblings selected from bounded head/tail samples; compile/ela

Return the default next debug target

Scan compiled RTL/TB sources for structural risk patterns in a lock-free cancellable worker; returns eligiblefilecount, filesscanned, coveragestatus, and coveragewarnings so zero or partial source coverage cannot be mistaken for a clean scan

Resolve full hierarchical signal paths. keyword accepts a single string or a list of keywords (max 16) — pass a list to batch several lookups in one call (one result entry per keyword, in input order) instead of issuing consecutive single-keyword searches. Each result also carries direction (input/o

Find a structural connectivity path between two signals. Trusted NPI evidence wins; otherwise the bounded dual-endpoint Source Graph follows supported IR bindings and combinational dependencies. Only complete coverage can establish notconnected; an inconclusive negative falls through to unsupportedr

Trace X/Z propagation upstream through trusted NPI -> one bounded Source Graph artifact -> whole-trace Static. Wave locks cover only waveform reads. Any backend switch or proved scope expansion discards the partial chain and restarts at the original signal, so one returned chain never mixes backend