v1.2.0

Minor Changes

• #174 8a2497f - diff gains --format json|toon (and the hidden --json alias): the same field-by-field
  comparison, comparability warnings, gated regressions and per-span slice deltas as the human report,
  serialized as a DiffView (a GroupDiffView for a run-group diff). Human output and
  --fail-on-regression exit codes are unchanged. New exported types: DiffView, DiffMetricRow,
  GroupDiffView, DiffOutput.

  CLI help polish: the top-level tagline names all three targets and CPU self-time; --help and
  record --help gain quick-start epilogs; query events --kind lists the missing gc; query get
  accepts the shared --json alias; --breakdown/--deep help notes their mutual exclusivity and
  where to read the result.

• #176 20e64af - Surface framework facts without drilling:

  • query spans overview rows now carry a compact addons.react (version + build), so a bulk consumer reads framework identity off the overview instead of opening each span. The full per-span facts (commit counts, server phases) stay on query span.
  • Recordings now stamp meta.framework ("off" | "auto"), so a deliberate --framework off run is distinguishable from an auto run that detected no framework (both carry no Span.addons).

• #177 1bb07a4 - Three polish fixes: README links to non-shipped repo files (AGENTS.md, docs/, ...) are now absolute
  GitHub URLs, so they resolve on the npm page and in an installed package. The blame docs now state
  that a sampled --breakdown forced-blame count is a sampling-frequency signal, never comparable to
  --deep's exact flush count. The built-in --url load flow stamps a meta.notes entry (and tags the
  query span run line) when the boot did near-zero work, the tell of a consent/region shell measured
  in place of the app; note-tier only, never a gate.

• #172 dc97fda - Complete the public type surface so every type named inside an exported type is itself importable (no more hand-rolling a shape the package already describes). New root exports include CaptureMode, TargetLane, WorkloadLane, Measured, CpuBreakdown/CpuSlice/CpuJsSlice, LayoutShift(+Source/Rect), EngineSoftNav, SoftNavRoute(+Lcp)/SoftNavVerdict/SoftNavAgreement, ThrashReport/ThrashStep/DirtiedByWrite/DirtiedByWriteRollup/FirefoxDirtiedByReport, WorkloadIdentity, SourceMapDiagnostics/SourceMapFailure, FrameFloor/WallMultipleFloor/WorkSignalFloor, SpanCountsEntry, RawProfileNode/RawCallFrame/GeckoSlice, and the driver StepOpts/Until.

  Narrowed the closed-union output fields from string to their real unions: RecordingMeta.capture and GroupSpanMember.mode to the capture-mode union, and SpansResult/SpanAnatomy/GroupSpanStitch target to "chrome" | "firefox" | "node". Reading these fields now yields the exact literal type instead of a bare string.

• #175 11173d5 - Label floored trusted-click driver steps on --breakdown. A trusted page.click carries ~8ms of
  input dispatch inside the step window, so a floored cheap step's wall (~41ms) lands off any exact
  frame multiple and the old wall-multiple check missed it. query span/query spans now read a
  step's flooring off its reconciling bar (sub-frame real work in an idle-dominated window), so a
  sub-frame interaction is no longer read as real work.

  The frameFloor JSON field carries a basis discriminator: { basis: "wall-multiple", floorMs, multiple } for a bench/in-page/measure wall and INP, or { basis: "work-signal", floorMs, workMs }
  for a driver step. Exported as FrameFloor (union) with WallMultipleFloor/WorkSignalFloor.

Patch Changes

• #170 8ab7390 - Driver reliability fixes:

  • INP no longer under-reports on a slow environment. The end-of-step flush now drains every in-page observer's takeRecords() (INP, LoAF, layout-shift, LCP, soft-nav) before reading, and waits (bounded) for the Event Timing entry on a step that dispatched a trusted interaction. An entry queued-but-undispatched at the read instant was silently lost, reading INP lower and letting a real regression slip past assert --max-inp.
  • A mid-step hard navigation no longer hard-fails the record. When a step's action triggers a navigation that commits during the default settle, the settle re-attaches to the new document instead of dying with "Execution context was destroyed".
  • SIGINT/SIGTERM/SIGHUP now clean up. A killed run SIGKILLs its Chrome process and unlinks its temp files instead of orphaning them, then re-raises the signal.