adb-ready 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -9,6 +9,71 @@ 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
+
+- Add a first-device guide under Start that walks new users through USB,
+  Android 11+ Wireless debugging, or an existing emulator before handing off
+  to the normal verified devices, pairing, or connection workflow.
+
+### Fixed
+
+- Make interactive selection unmistakable with one directional cursor and a
+  high-contrast active row, while retaining explicit no-color and ASCII
+  fallbacks and removing distracting markers from inactive choices.
+- Group session launch, planning, bounded verification, wireless connection,
+  and pairing under one focused Start workflow instead of scattering entry
+  actions across unrelated top-level categories.
+
 ## [0.5.0] - 2026-09-21
 
 ### Fixed
@@ -406,7 +471,9 @@ 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.0...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
 [0.4.0]: https://github.com/Adam014/adb-ready/compare/v0.3.5...v0.4.0

package/README.md

@@ -71,6 +71,8 @@ them or require an ADB Ready account, hosted service, or model API key.
 
 Running `adb-ready` without a command opens the interactive workflow home.
 `adbr` is the shorter alias for the same CLI.
+New to Android device setup? Open **Start → Set up first device** for a guided
+USB, Wireless debugging, or emulator path.
 The home and its focused menus adapt to the detected terminal width and height,
 including narrow split panes and short terminals, without relying on scrolling
 to reveal an action.
@@ -84,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.
@@ -104,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)
 
@@ -176,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: