adb-ready 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -9,6 +9,21 @@ deprecation policy in [Stability and versioning](./docs/stability.md).
 
 ## [Unreleased]
 
+## [1.0.3] - 2026-10-01
+
+### Fixed
+
+- Allow large APK and split-APK installs up to five minutes by default instead
+  of inheriting the five-second probe timeout, while preserving an explicit
+  `--timeout` override.
+- Recover the same remembered wireless target for `--last` after a local ADB
+  server restart or Wireless debugging port rotation, verifying hardware
+  identity before accepting a newly advertised endpoint.
+- Explain when foreground launch verification is blocked by the Android lock
+  screen instead of returning only a generic launch-postcondition failure.
+- Isolate runtime-smoke remembered-target state so repository verification can
+  never overwrite a developer's real `--last` target with a fixture device.
+
 ## [1.0.2] - 2026-09-30
 
 ### Changed
@@ -551,7 +566,8 @@ deprecation policy in [Stability and versioning](./docs/stability.md).
   explainable configuration precedence.
 - Human, plain, JSON, and NDJSON output across Node, Bun, and Deno entrypoints.
 
-[Unreleased]: https://github.com/Adam014/adb-ready/compare/v1.0.2...HEAD
+[Unreleased]: https://github.com/Adam014/adb-ready/compare/v1.0.3...HEAD
+[1.0.3]: https://github.com/Adam014/adb-ready/compare/v1.0.2...v1.0.3
 [1.0.2]: https://github.com/Adam014/adb-ready/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/Adam014/adb-ready/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/Adam014/adb-ready/compare/v0.9.0...v1.0.0

package/dist/cli.js

@@ -3304,7 +3304,7 @@ import process15 from "node:process";
 // package.json
 var package_default = {
   name: "adb-ready",
-  version: "1.0.2",
+  version: "1.0.3",
   description: "Agent-ready Android CLI for reliable ADB sessions, app automation, and verified evidence.",
   private: false,
   type: "module",
@@ -45756,6 +45756,7 @@ async function runDev(options, config4 = {}, dependencies = {}, signal) {
 }
 
 // src/app/app-commands.ts
+var DEFAULT_APP_INSTALL_TIMEOUT_MS = 5 * 60000;
 function plannedArgs(ready, config4, args) {
   return [
     ...config4.adbHost === undefined ? [] : ["-H", config4.adbHost],
@@ -46030,7 +46031,9 @@ async function launchApp(ready, applicationId, explicitActivity, commandId, prob
   }
   const activeValue = active?.value;
   if (active === undefined || !succeeded(active.process) || activeValue?.applicationId !== applicationId) {
-    problems.push(problem("APP_LAUNCH_UNVERIFIED", "app.lifecycle", `${applicationId} did not become the foreground app.`, "ADB accepted the launch request, but the foreground postcondition was not met.", commandId, [
+    const lockState = await ready.client.targetCommand(ready.target, "app-launch-lock-state", "Reading Android lock-screen state after launch", ["shell", "dumpsys", "window", "policy"], parseAndroidLockState, signal, { maxBufferBytes: 4 * 1024 * 1024 });
+    const targetIsLocked = succeeded(lockState.process) && lockState.value === "locked";
+    problems.push(problem("APP_LAUNCH_UNVERIFIED", "app.lifecycle", `${applicationId} did not become the foreground app.`, targetIsLocked ? "ADB launched the app, but Android is locked. Unlock the selected target, then retry." : "ADB accepted the launch request, but the foreground postcondition was not met.", commandId, [
       {
         source: "adb.activity",
         field: "foreground",
@@ -46038,7 +46041,14 @@ async function launchApp(ready, applicationId, explicitActivity, commandId, prob
           applicationId: activeValue.applicationId,
           activity: activeValue.activity
         }
-      }
+      },
+      ...targetIsLocked ? [
+        {
+          source: "adb.window-policy",
+          field: "lockState",
+          value: "locked"
+        }
+      ] : []
     ]));
     return;
   }
@@ -46148,7 +46158,9 @@ async function runApp(request, config4 = {}, dependencies = {}, signal) {
       ...request.replace === true ? ["-r"] : [],
       ...request.grantRuntimePermissions === true ? ["-g"] : [],
       ...artifacts
-    ], (output) => output.trim(), signal);
+    ], (output) => output.trim(), signal, {
+      ...config4.timeoutWasDefault === true ? { timeoutMs: DEFAULT_APP_INSTALL_TIMEOUT_MS } : config4.timeoutMs === undefined ? {} : { timeoutMs: config4.timeoutMs }
+    });
     if (!succeeded(installed.process) || !/\bSuccess\b/u.test(installed.value)) {
       problems.push(operationProblem("app-install", installed, current.commandId));
       return finish2(current, null, problems);
@@ -50569,6 +50581,7 @@ function commandConfig(loaded, bound, selector, transportId) {
     ...values.adbHost === undefined ? {} : { adbHost: values.adbHost },
     ...values.adbPort === undefined ? {} : { adbPort: values.adbPort },
     timeoutMs: values.timeoutMs,
+    timeoutWasDefault: loaded.provenance.timeoutMs?.source === "default",
     uiTimeoutMs: loaded.provenance.timeoutMs?.source === "default" ? 15000 : values.timeoutMs,
     ...values.targetAliases === undefined ? {} : { targetAliases: values.targetAliases },
     ...bound?.transportId !== undefined ? { targetTransportId: bound.transportId } : bound !== undefined ? { targetSelector: bound.serial } : transportId !== undefined ? { targetTransportId: transportId } : selector === undefined ? {} : { targetSelector: selector }
@@ -60772,6 +60785,7 @@ async function runCliInternal(argv, io, dependencies = {}, signal) {
     ...values2.adbHost === undefined ? {} : { adbHost: values2.adbHost },
     ...values2.adbPort === undefined ? {} : { adbPort: values2.adbPort },
     timeoutMs: values2.timeoutMs,
+    timeoutWasDefault: loaded.config.provenance.timeoutMs?.source === "default",
     uiTimeoutMs: loaded.config.provenance.timeoutMs?.source === "default" ? 15000 : values2.timeoutMs,
     ...options.device === undefined ? {} : { targetSelector: options.device },
     ...options.transportId === undefined ? {} : { targetTransportId: options.transportId },
@@ -60922,16 +60936,42 @@ async function runCliInternal(argv, io, dependencies = {}, signal) {
   }
   const offlineDevPlan = (options.command === "dev" || options.command === "run") && options.dryRun;
   let preparedSelection;
-  if (options.command === "app" && (options.appAction !== "resolve" || options.select) || options.command === "apps" || options.command === "capture" || (options.command === "dev" || options.command === "run") && !offlineDevPlan || options.command === "inspect" || options.command === "logs" || options.command === "open" || options.command === "ui" || options.command === "ports") {
+  if (options.command === "app" && (options.appAction !== "resolve" || options.select) || options.command === "apps" || options.command === "capture" || options.command === "devices" && options.remembered || (options.command === "dev" || options.command === "run") && !offlineDevPlan || options.command === "inspect" || options.command === "logs" || options.command === "open" || options.command === "ui" || options.command === "ports") {
     let inventory = await runDevices(config4, commandDependencies, signal);
     let selectable = inventory.result.data?.targets.filter((target) => target.transports.some(({ stable, state }) => stable && state === "device")) ?? [];
-    if ((options.command === "dev" || options.command === "run") && selectable.length === 0 && !options.dryRun) {
-      const acquisition = planTargetAcquisition({
+    if ((options.command === "dev" || options.command === "run" || options.remembered) && selectable.length === 0 && !options.dryRun) {
+      let acquisition = planTargetAcquisition({
         ...config4.targetSelector === undefined ? {} : { selector: config4.targetSelector },
         ...values2.targetAliases === undefined ? {} : { aliases: values2.targetAliases },
         ...lastTarget === undefined ? {} : { remembered: lastTarget },
         services: inventory.result.data?.discovery.mdns.services ?? []
       });
+      if (acquisition.kind === "ambiguous" && options.remembered && lastTarget?.hardwareSerial !== undefined) {
+        const services = inventory.result.data?.discovery.mdns.services ?? [];
+        const endpoints = [
+          ...new Set(services.flatMap((service) => (service.serviceType === "legacy" || service.serviceType === "connect" && service.knownDevice !== false) && service.endpoint.version === 4 ? [service.endpoint.serial] : []))
+        ];
+        for (const candidate of endpoints) {
+          const verified = await runConnect(candidate, {
+            ...config4,
+            endpointWasDiscovered: true,
+            discoveredEndpointCandidates: [candidate]
+          }, commandDependencies, signal);
+          const data = verified.result.data;
+          if (verified.result.ok && data !== null && "serial" in data && data.hardwareSerial === lastTarget.hardwareSerial) {
+            acquisition = {
+              kind: "connect",
+              endpoint: data.serial,
+              candidates: [data.serial],
+              discovered: true,
+              reason: "remembered-identity"
+            };
+            break;
+          }
+          if (signal?.aborted === true)
+            break;
+        }
+      }
       if (acquisition.kind === "connect") {
         const connected = await runConnect(acquisition.endpoint, acquisition.discovered ? {
           ...config4,
@@ -60974,11 +61014,13 @@ async function runCliInternal(argv, io, dependencies = {}, signal) {
     } else {
       preparedSelection = selected2.result.data.selected;
       const transport = preparedSelection.transport;
-      if (options.avdName !== undefined || transport.transportId === undefined) {
-        config4.targetSelector = transport.serial;
-        delete config4.targetTransportId;
-      } else {
-        config4.targetTransportId = transport.transportId;
+      if (options.command !== "devices") {
+        if (options.avdName !== undefined || transport.transportId === undefined) {
+          config4.targetSelector = transport.serial;
+          delete config4.targetTransportId;
+        } else {
+          config4.targetTransportId = transport.transportId;
+        }
       }
     }
   }
@@ -61628,4 +61670,4 @@ try {
   process16.removeListener("SIGTERM", abort);
 }
 
-//# debugId=EEFE4EA2C406032664756E2164756E21
+//# debugId=2A90A8EB1D4EFD3D64756E2164756E21

package/docs/apps-and-evidence.md

@@ -66,8 +66,14 @@ created them, then pass those `.apk` files explicitly.
 
 - Installation accepts one ordinary APK or an explicit complete split APK set.
   `.apks`, `.aab`, and implicit downloads are not accepted yet.
+- APK installation allows up to five minutes by default so large artifacts can
+  cross a real wireless ADB connection. An explicit global `--timeout` still
+  overrides that installation default.
 - Install, launch, stop, restart, and explicit deep-link handlers are checked
   after ADB accepts the request.
+- When Android accepts a launch but the selected target remains behind its lock
+  screen, ADB Ready reports the locked state and asks you to unlock and retry;
+  it never attempts to bypass the device lock.
 - `restart` is a verified stop followed by a verified launch.
 - Add `--activity .MainActivity` only when Android cannot resolve a launchable
   activity.

package/docs/targets-and-wireless.md

@@ -31,6 +31,12 @@ adb-ready devices --last
 `--device` accepts an exact ADB serial or a configured alias. `--transport-id`
 disambiguates duplicate transports. `--last` resolves the last verified target
 identity; it does not silently choose an unrelated visible device.
+If a local ADB server restart drops the stable wireless transport, `--last`
+first reconnects the exact remembered endpoint when discovery still advertises
+it, then verifies the target again. If Wireless debugging rotates the endpoint,
+ADB Ready probes only already-known connect services and accepts a replacement
+only after its hardware identity matches the remembered target. It never
+substitutes an unrelated device.
 
 An exact serial, serial-backed alias, or transport ID also bounds target-side
 identity inspection to that transport. ADB Ready does not query unrelated

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adb-ready",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Agent-ready Android CLI for reliable ADB sessions, app automation, and verified evidence.",
   "private": false,
   "type": "module",

package/schema/agent-tools-v1.json

@@ -1,7 +1,7 @@
 {
   "title": "ADB Ready agent tool contract",
   "schemaVersion": 1,
-  "packageVersion": "1.0.2",
+  "packageVersion": "1.0.3",
   "protocolVersion": "2025-11-25",
   "transport": "stdio",
   "tools": [

package/skills/adb-ready/SKILL.md

@@ -3,7 +3,7 @@ name: adb-ready
 description: Prepare, automate, debug, and verify one Android target through the ADB Ready MCP server. Use for Android development sessions, app lifecycle work, UI automation, failure evidence, screenshots, and agent-driven device checks.
 ---
 
-<!-- Generated by adb-ready 1.0.2; do not edit. -->
+<!-- Generated by adb-ready 1.0.3; do not edit. -->
 
 # ADB Ready
 
@@ -51,4 +51,4 @@ Use the typed `adb-ready` MCP tools. Do not replace them with generic shell or r
 - `session`: 12 tools
 - `ui`: 29 tools
 
-Contract: ADB Ready 1.0.2, agent schema v1.
+Contract: ADB Ready 1.0.3, agent schema v1.