Repository navigation
Releases: julia-script/effect-inspect
Releases · julia-script/effect-inspect
Release list
v0.3.1
v0.3.0
Minor Changes
- c5efb18:
summary.result.memoryplaces process-wide memory in time:peakHeapAtMs, first/last sample times, sampling cadence (medianIntervalMs,maxGapMswithmaxGapFromMs/maxGapToMs) andspansActiveAtPeak, the innermost spans active when the heap peaked. AmemorySamplingGapnotice reports a gap between samples over 10× the median, with possible causes phrased as possibilities.spangainsprocessMemory: the process-wide samples within the span's interval. Additive;apiVersionstays 1. - 3904603:
summarynow leads with what an interrupted or disconnected run left unfinished. A top-levelnoticesarray states easy-to-miss facts (spans without a recorded end, how the session ended, thatlongestranks completed spans only, collector eviction).result.unfinishedlists the innermost open spans — the last recorded position on each open chain — with their open ancestors, beforelongest. Every per-session response gainstermination(stateactive/ended/unknown,lastObservedMs,endedAtMs,unobservedTailMs).spans --sort duration|outsideChildreninterleaves open spans by a lower bound instead of listing them last. Additive;apiVersionstays 1.
Patch Changes
- ff10e18: Root
--helpgains a JSON SHAPE section: the top-level keys of a query response, a reminder that context keys (completeness,termination, ...) are siblings ofresult, and the most-used key paths. Each per-session command's help points to its field lists and says to readsummary'snoticesfirst.
v0.2.0
Minor Changes
- 27fffee: Let a launcher choose the session ID before starting an instrumented program, through the
sessionIdlayer option or theEFFECT_INSPECT_SESSION_IDenvironment variable; a random UUID remains the default. The ID survives reconnects, while a different run reusing an ID the collector already holds is refused and counted as a conflict instead of being merged into the original trace. Collision refusal needs the updated collector; older collectors still merge runs that reuse an ID. - 1a9a75e: The collector now answers read-only trace queries over HTTP on its port (
POST /api/v1/query,GET /api/v1/export?sessionId=ID): session discovery, a run summary, filtered spans, one span with its ancestry, children and events, and correlated logs. Answers are bounded JSON that name the exact session and time reference, report recorded loss or unknown completeness, and refuse a session whose ID another run reused. Saved traces answer the same queries offline, and an exported trace keeps the collector's loss counters in an optional header field that older builds ignore. - a2aba7c: New query commands for coding agents:
summary,spans,span,logs,exportandsessions. Launch an instrumented program withEFFECT_INSPECT_SESSION_ID=my-run-001, then query exactly that run with--session my-run-001, or a saved trace with--file PATHand no collector. Each command prints one bounded JSON document on stdout (--jsonfor one compact line), a diagnostic on stderr on failure, and a distinct exit code per outcome.exportwrites a lossless.eitracewithout overwriting an existing file unless--force. Root and per-command--helpdocument the workflow, flags, JSON fields, errors and exit codes. The interactive--wizardglobal flag is no longer offered.