adb-ready 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -9,6 +9,54 @@ breaking changes.
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-09-27
+
+### Added
+
+- Add the project-local `bun what` command browser for contributors who want
+  to discover and launch repository tasks without scanning `package.json`.
+- Add balanced, fast, and strict semantic UI acquisition profiles with
+  observation timing, freshness, stability, filtering, truncation, and
+  framework-limitation metadata; reject empty and continuously unstable UI
+  hierarchies instead of returning a silent false success.
+- Add bounded `compare_ui` hierarchy diffs for agents, reporting semantic nodes
+  that were added, removed, updated, or moved while refusing stale,
+  cross-target, partial, differently filtered, or display-incompatible bases.
+- Add capability-detected Unicode, emoji, RTL, CJK, and multiline UI input
+  through an already enabled ADBKeyBoard IME, configurable per-code-point
+  pacing, exact prior-IME restoration, and explicit pre-mutation failures when
+  the target cannot meet the requested input contract.
+- Add protected CLI stdin and MCP environment-variable input so secrets stay
+  out of host process arguments, operation plans, terminal output, retained
+  results, journals, screenshots, and AI context, with documented Android-side
+  trust boundaries.
+- Add guarded keyboard status and dismissal using agreeing InputMethodManager
+  and WindowInsets signals, plus exact PermissionController runtime-permission
+  inspection and responses with fresh post-action verification across CLI and
+  MCP. Unknown or ambiguous system UI now fails closed instead of pressing or
+  tapping speculatively.
+- Add decoded and checksum-verified PNG evidence with source-pixel crops,
+  proportional dimension limits, capture provenance, and truncation metadata;
+  MCP image results now default to a context-safe 1024×1024 and 4 MiB base64 budget
+  with an explicit full-resolution opt-in.
+- Add `inspect failures` and `inspect_failures` to correlate bounded,
+  package-scoped ApplicationExitInfo, crash-buffer, ANR, React Native, native,
+  and permitted DropBox evidence while reporting unavailable Android sources
+  and excluding unrelated process failures.
+- Add discoverable `debug`, `session`, `ui`, and backward-compatible `full` MCP
+  profiles, a config-independent capabilities tool/resource, and namespaced
+  safety, sensitivity, target-binding, and profile metadata generated into the
+  public agent contract.
+- Generate and package a version-matched task-first Agent Skill from the real
+  MCP tool contract, then install it atomically with project-scoped Codex,
+  Claude Code, Cursor, or VS Code setup without overwriting custom content.
+- Document durable start/get/stop development handles as the cross-client
+  compatibility path while keeping the MCP Tasks extension unadvertised until
+  negotiated interoperability is proven in two supported clients.
+- Add target-locked Maestro and Android CLI verifier adapters, bounded native
+  report/screenshot/video/log retention, and structured verifier outcome
+  categories without translating either tool's test or Journey format.
+
 ## [0.5.1] - 2026-09-25
 
 ### Added
@@ -423,7 +471,8 @@ breaking changes.
   explainable configuration precedence.
 - Human, plain, JSON, and NDJSON output across Node, Bun, and Deno entrypoints.
 
-[Unreleased]: https://github.com/Adam014/adb-ready/compare/v0.5.1...HEAD
+[Unreleased]: https://github.com/Adam014/adb-ready/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/Adam014/adb-ready/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/Adam014/adb-ready/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/Adam014/adb-ready/compare/v0.4.1...v0.5.0
 [0.4.1]: https://github.com/Adam014/adb-ready/compare/v0.4.0...v0.4.1

package/README.md

@@ -86,11 +86,12 @@ to reveal an action.
 - [**Operate the app**](./docs/apps-and-evidence.md#app-lifecycle) — resolve,
   install, launch, restart, deep-link, and inspect the project app.
 - [**Verify the UI**](./docs/ui-automation.md) — find semantic elements, act
-  by intent—including labels inside clickable containers and content-directed
-  scrolling—assert state, audit effective accessibility labels, and capture the
+  by intent—including international text, protected input, keyboard state, and
+  runtime-permission dialogs—assert state, audit accessibility, and capture the
   screen.
 - [**Debug with evidence**](./docs/logs-and-context.md) — keep focused logs,
-  session history, screenshots, recordings, and redacted context together.
+  correlated crash/ANR/native findings, session history, screenshots,
+  recordings, and redacted context together.
 - [**Automate a real device**](./docs/automation.md#run-one-bounded-verification)
   — gate a finite command on readiness and return stable results, reports, and
   artifacts.
@@ -106,16 +107,20 @@ Windsurf, or another MCP client:
 npx adb-ready agent setup codex
 ```
 
+Setup writes the project MCP bridge and a version-matched Agent Skill. Use
+`--mcp-profile debug`, `session`, or `ui` to expose only the tools needed for
+that job; `full` remains the default.
+
 Then ask for the outcome you want:
 
 > Start this Expo app on my Android phone, wait until the login screen is
 > actually ready, verify my change, and keep the failure evidence.
 
 The local MCP server gives agents typed tools for target readiness, durable
-development sessions, app lifecycle, semantic UI, logs, screenshots, and saved
-evidence. Every result is schema-validated and checked against fresh device
-state. Agents do not receive a generic shell, unrestricted raw ADB, or app
-removal.
+development sessions, app lifecycle, semantic UI, correlated failure evidence,
+screenshots, and saved diagnostics. Every result is schema-validated, annotated
+for safety, and checked against fresh device state. Agents do not receive a
+generic shell, unrestricted raw ADB, or app removal.
 
 [Connect an AI agent in minutes →](./docs/agent-integration.md)
 
@@ -178,12 +183,13 @@ Or make the target and deployment part of the same bounded job:
 
 ```bash
 npx adb-ready run --avd Pixel_9_API_36 --deploy --variant debug -- \
-  maestro '--device={target.serial}' test .maestro/smoke.yaml
+  maestro test .maestro/smoke.yaml
 ```
 
 Each executed run retains a redacted evidence bundle with its result,
-timeline, problems, focused logcat, native verifier output, AI context, JUnit
-XML, and GitHub step summary. Existing matching emulators are reused; only an
+timeline, problems, focused logcat, native verifier output and artifacts, AI
+context, JUnit XML, and GitHub step summary. Maestro and Android CLI primitives
+are pinned to the leased target automatically. Existing matching emulators are reused; only an
 emulator started by that run is stopped. Scripts also get deterministic JSON
 and NDJSON contracts: