Changelog #

0.5.0 #

Added AllocationAttribution class and attributeAllocationsToCallers() that cross-references CPU samples with memory class deltas to attribute allocations to the functions on the stack during heap growth.
Added lineForFunction() helper that extracts line numbers from VM profile function data, enabling line-level source annotation.
Added isAsyncOverhead getter to ProfileFrame for identifying dart:async frames, supporting the --collapse-async feature.
Added extra field to ActiveProfileRegion and ProfileRegionResult for tool-specific metadata that persists in session artifacts.
Memory class attribution now exposes AllocationAttribution data through PreparedRegionPresentation.allocAttribution.

Added live Flutter frame timing analysis with jank attribution and timeline hotspot reporting.
Added top-level timeline as a first-class alias for frame timing analysis.
Added a dedicated flutter:timeline alias for frame timing analysis while keeping flutter:frame-profile as a compatibility alias.
Added flutter drive launch support for profiled Flutter app launches.
flutter attach launches now default to 15s and skip DTD because attach mode does not use region markers.
Added Flutter widget tree capture helpers, including project-only filtering that preserves project widgets nested under framework wrappers.
Added Flutter memory snapshot capture helpers for CLI and agent workflows.
Added WidgetInspectorQueryService for calling generic Flutter widget inspector service extensions, enabling getSelectedWidget, getProperties, getChildren, getParentChain, getDetailsSubtree, and getLayoutExplorerNode queries.
Frame analysis now resets shader jank tracking per-frame instead of accumulating across the entire profile window, producing more accurate per-frame jank attribution.
Replaced navigation_stack export with widget_inspector_query; removed route stack navigation support since ext.flutter.inspector.show routes were removed upstream.
Various documentation updates, fixture formatting, and test expectation improvements.

Added inherited-stdio process IO mode for terminal UI and alternate-screen profiling targets.
Added deterministic VM-service discovery for inherited-stdio Dart launches and Flutter run launches.
Added optional interrupt signal handling so hosts can finalize available diagnostics before stopping an interrupted target.
Reduced shutdown polling overhead by backing off exit-pause probes and adding bounded VM-service request timeouts during final capture.

Added bare Dart file launch support by expanding file paths to dart run <file>.
Improved short-lived Dart process profiling by holding isolates at exit long enough to capture final whole-session CPU and memory snapshots.

Added memory class artifact inspection helpers for stored session, region, and raw memory profile artifacts.
Added memory class comparison filters for minimum live bytes and class count limits.
Added optional DTD disabling for attach sessions when region markers are not needed or the tooling daemon cannot start.
Normalized artifact output directories to fully resolved paths and kept relative paths anchored against the profiled working directory.
Allowed artifact readers to summarize per-profile artifact directories such as overall/ and regions/<id>/ in addition to summary.json files.
Improved package detection for local checkout file://.../<package>/lib/... CPU frames so package filters work outside .pub-cache.

Initial release of the pure-Dart profiler backend.
Added launch and attach flows for Dart and Flutter VM-service targets.
Added CPU summaries, call trees, method tables, memory summaries, and artifact readers.
Added hotspot, comparison, method inspection, and trend analysis helpers.