patchbay 0.8.0

Typed control channel into a running Dart or Flutter app: protocol, gated command admission, fact-sourced state, jobs and blobs.

Changelog

The four packages are versioned together. Generated by release_prep --apply from the English pub.dev summaries in the repository changelog. Do not edit this file directly.

0.8.0 - 2026-09-15

Patchbay 0.8.0 keeps patchbay launch sessions reachable after the launching terminal is killed, by recording the device-side VM Service endpoint beside the host-side DDS address. catalog gains an opt-in --view summary plus --namespace, --side-effect and --gate filters. Recovery hints now follow the selector domain of the request and stay silent when an older host makes the cause ambiguous. Breaking: 18 unreferenced public exports were removed. On iOS devices, closing the terminal window still ends the session, because flutter's iproxy exits with the process group. An iOS app suspended in the background for more than about 110 seconds also loses its session and needs the launcher restarted.

0.7.0 - 2026-09-10

Patchbay 0.7.0 adds a machine-readable recovery action class beside every stable rejection code, so agents learn thirteen next actions instead of hundreds of codes. Session liveness now asks the endpoint before declaring a record dead, and refusals no longer delete session records. Resource limits are classified per layer as protocol hard caps, configurable budgets or implementation defaults. The patchbay package now ships a release artifact strippability scan. Sessions started by patchbay launch still record the host-side DDS endpoint and remain unusable once the launching process exits; see the release notes.

0.6.0 - 2026-09-07

Patchbay 0.6.0 consolidates UI automation under ui perform, separates consumer, host and protocol Dart APIs, and centralizes output projection and gate execution. Existing CLI aliases remain deprecated until 1.0. Host integrations must migrate to the explicit host entry points. See the release notes for source migration and additive error details.

0.5.0 - 2026-08-28

Patchbay 0.5.0 is the onboarding and progressive-disclosure release: a minimal consumer entry that scales from read-only diagnostics to the full command surface, thin --view brief output with artifact spill for large payloads, hardened host boundaries, and new identifier-anchored UI capabilities.

Highlights

• BREAKING: the CLI public Dart API narrows from 203 symbols to a frozen 2 + 8 surface (patchbay_cli.dart plus opt-in patchbay_client.dart); consumers using the executable with --json are unaffected.
• BREAKING: minimum SDK floors raise to Flutter >=3.44.0 / Dart >=3.12.0 — a verified floor guarded by a blocking CI lane.
• Identifier-anchored pointer tap (ui.gesture.tap), occlusion admission for point actions, and ui.reveal driving lazily built lists with per-container authorization and tighten-only budgets.
• Domain-plane write commands now enforce their declared gates at host admission; session selection is workspace-affine, and externally launched apps register via patchbay session register / session unregister.
• Snapshot provider boundary hardened: non-JSON values, cycles, depth and byte budgets fail closed as providerProtocolViolation; audit delivery is strictly ordered and bounded; REPL terminal errors are line-delimited JSON.
• Session liveness upgraded to a three-state process-identity comparison with timezone-independent, payload-validated signatures; malformed records are quarantined instead of silently deleted.

0.4.1 - 2026-08-24

Patchbay 0.4.1 is an internal quality and architectural modularization release, decoupling high-churn core host, Flutter host, and CLI subsystems into focused domains while establishing strict structure ratchet budgets and release gates.

Highlights

• Modularized core ServiceHost, Flutter semantics/gesture bridges, CLI runners, and large test suites into clean domain directories.
• Introduced automated structure ratchet enforcement (tool/check_structure_ratchet.dart) capping production files at 800 lines and test files at 1,000 lines.
• Extracted PlatformProcessUtils abstraction for unified cross-platform process detection across macOS, Linux, and Windows.
• Added reproducible Pana scoring budget verification and release finalize automation.

0.4.0 - 2026-08-20

Patchbay 0.4.0 completes the observable automation loop for running Dart and Flutter applications while preserving explicit admission, lifecycle, and generation boundaries.

Highlights

• Added identifier-anchored press, drag, and fling gestures; navigation and UI waits; frame-aware capture and image diffs; snapshot revisions; bounded log and performance evidence; and durable, redacted debugging traces.
• Added generated command registration, strict request and response schemas, execution-evidence classifications, idempotent retries, and compatibility fixtures for 0.3 clients and hosts.
• Added supervised launcher sessions, Android permission state normalization, and an iOS XCUITest reference runner with fail-closed capability discovery.
• Expanded the example application and device precheck so protocol, CLI, host, direct transport, and Flutter bridge wiring are validated before consumer acceptance testing.