adb-ready 0.3.3 → 0.3.5

package/CHANGELOG.md

@@ -9,12 +9,56 @@ breaking changes.
 
 ## [Unreleased]
 
+## [0.3.5] - 2026-09-12
+
+### Changed
+
+- Enforce at least 95% coverage of measurable executable lines added or
+  replaced by a pull request, in addition to the existing repository-wide
+  line and function coverage floors.
+- Keep external source maps available in local builds while excluding their
+  unreferenced payload from the published npm package.
+- Make the read-only real-ADB check report logical targets and raw transports
+  separately and fail when ADB returns an unrecognized device state.
+
+### Fixed
+
+- Preserve complete mDNS transport serials containing Bonjour collision
+  suffixes such as ` (2)`, preventing one physical device from appearing as a
+  second unknown target.
+- Classify connected `_adb-tls-connect._tcp` service transports as TLS even
+  when their mDNS serial contains a Bonjour collision suffix.
+
+## [0.3.4] - 2026-09-12
+
+### Added
+
+- Publish the verified LCOV report to Codecov through short-lived GitHub OIDC
+  credentials and show the measured `main` coverage in a live README badge.
+
+### Changed
+
+- Raise the authoritative LCOV line and function coverage floors from 90% to
+  95% with additional lifecycle, recovery, agent, configuration, persistence,
+  platform, terminal, and protocol boundary tests.
+
+### Fixed
+
+- Keep a development session running when optional local session history cannot
+  be initialized or finalized, while reporting the persistence gap as a warning.
+- Return a structured target-lease availability error when its per-user state
+  directory cannot be created instead of leaking an internal filesystem error.
+
 ## [0.3.3] - 2026-09-11
 
 ### Changed
 
 - Fail closed before npm publishing unless the immutable release tag already
   has a matching draft GitHub release.
+- Isolate the push-level permission needed to inspect that draft release in a
+  preflight job that never checks out or executes repository code.
+- Allow the audited workflow on protected `main` to promote an exact immutable
+  release tag, so release-infrastructure fixes never require moving that tag.
 - Document Deno's 24-hour minimum dependency age and the explicit override
   reserved for immediate post-publish verification.
 - Enforce 90% LCOV line and function coverage floors in the authoritative
@@ -218,7 +262,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.3.3...HEAD
+[Unreleased]: https://github.com/Adam014/adb-ready/compare/v0.3.5...HEAD
+[0.3.5]: https://github.com/Adam014/adb-ready/compare/v0.3.4...v0.3.5
+[0.3.4]: https://github.com/Adam014/adb-ready/compare/v0.3.3...v0.3.4
 [0.3.3]: https://github.com/Adam014/adb-ready/compare/v0.3.2...v0.3.3
 [0.3.2]: https://github.com/Adam014/adb-ready/compare/v0.3.1...v0.3.2
 [0.3.1]: https://github.com/Adam014/adb-ready/compare/v0.3.0...v0.3.1

package/README.md

@@ -9,7 +9,7 @@ verified evidence—for developers, agents, and CI.
 
 [![MCP](https://img.shields.io/badge/MCP-native-7c3aed)](./docs/agent-integration.md)
 [![CI](https://github.com/Adam014/adb-ready/actions/workflows/ci.yml/badge.svg)](https://github.com/Adam014/adb-ready/actions/workflows/ci.yml)
-[![Coverage](https://img.shields.io/badge/LCOV-%E2%89%A590%25-16a34a)](https://github.com/Adam014/adb-ready/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/Adam014/adb-ready/graph/badge.svg?branch=main)](https://app.codecov.io/gh/Adam014/adb-ready)
 [![npm](https://img.shields.io/npm/v/adb-ready?label=npm&color=1f9db5)](https://www.npmjs.com/package/adb-ready)
 [![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A522-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org/)
 [![Bun](https://img.shields.io/badge/Bun-tested-14151a?logo=bun&logoColor=white)](https://bun.sh/)

package/dist/cli.js

@@ -355,7 +355,7 @@ import process13 from "node:process";
 // package.json
 var package_default = {
   name: "adb-ready",
-  version: "0.3.3",
+  version: "0.3.5",
   description: "Agent-ready Android CLI for reliable ADB sessions, app automation, and verified evidence.",
   private: false,
   type: "module",
@@ -366,7 +366,7 @@ var package_default = {
   files: [
     "CHANGELOG.md",
     "COMPATIBILITY.md",
-    "dist",
+    "dist/cli.js",
     "docs",
     "examples",
     "LICENSE",
@@ -389,6 +389,7 @@ var package_default = {
     "ui:check": "bun run scripts/ui-playground.ts --all --non-interactive",
     test: "bun test",
     "test:coverage": "bun test --coverage && bun run scripts/coverage-check.mjs",
+    "test:coverage:diff": "bun run scripts/coverage-diff-check.mjs",
     "test:commands": "bun run build && bun run scripts/command-matrix.mjs",
     "test:package-managers": "bun run build && bun run scripts/package-manager-smoke.mjs",
     "test:integration": "bun test tests/integration",
@@ -34740,6 +34741,26 @@ function normalizeState(tokens) {
   }
   return { state: "unknown", consumed: candidate === undefined ? 0 : 1 };
 }
+function splitDeviceLine(line) {
+  const knownState = line.match(/^(.+?)\s+(no\s+permissions|bootloader|device|offline|recovery|sideload|unauthorized)(?:\s+(.*))?$/u);
+  if (knownState !== null) {
+    const serial2 = knownState[1]?.trim();
+    const state = knownState[2];
+    if (serial2 === undefined || serial2 === "" || state === undefined)
+      return;
+    const details = knownState[3]?.trim();
+    return {
+      serial: serial2,
+      tokens: [
+        ...state.split(/\s+/u),
+        ...details === undefined || details === "" ? [] : details.split(/\s+/u)
+      ]
+    };
+  }
+  const tokens = line.split(/\s+/u);
+  const serial = tokens.shift();
+  return serial === undefined || serial === "" ? undefined : { serial, tokens };
+}
 function parseAdbDevices(output) {
   const devices = [];
   let sawHeader = false;
@@ -34758,11 +34779,10 @@ function parseAdbDevices(output) {
     if (!sawHeader || line.startsWith("* daemon") || line.startsWith("adb server")) {
       continue;
     }
-    const tokens = line.split(/\s+/u);
-    const serial = tokens.shift();
-    if (serial === undefined || serial === "") {
+    const fields = splitDeviceLine(line);
+    if (fields === undefined)
       continue;
-    }
+    const { serial, tokens } = fields;
     const { state, consumed } = normalizeState(tokens);
     const details = tokens.slice(consumed);
     const properties = {};
@@ -37833,6 +37853,10 @@ function transportKind(device, services) {
     return services.some((service) => service.serviceType === "connect" && service.endpoint.serial === endpoint.serial) ? "tls" : "tcp";
   }
   if (isMdnsServiceSerial(device.serial)) {
+    if (/\._adb-tls-connect\._tcp(?:\.|$)/iu.test(device.serial))
+      return "tls";
+    if (/\._adb\._tcp(?:\.|$)/iu.test(device.serial))
+      return "tcp";
     return "unknown";
   }
   if (device.usb !== undefined || device.serial !== "") {
@@ -39234,7 +39258,10 @@ async function runDev(options, config4 = {}, dependencies = {}, signal) {
         projectRoot: options.sessionStore.projectRoot ?? options.cwd
       });
     } catch {
-      problems.push(commandProblem(ProblemCode.SessionPersistenceFailed, "session.persistence", "Session history could not be started.", "The development session can continue, but this run will not be available afterward.", context.commandId));
+      problems.push({
+        ...commandProblem(ProblemCode.SessionPersistenceFailed, "session.persistence", "Session history could not be started.", "The development session can continue, but this run will not be available afterward.", context.commandId),
+        severity: "warning"
+      });
     }
   }
   const complete = async (data) => {
@@ -39266,7 +39293,10 @@ async function runDev(options, config4 = {}, dependencies = {}, signal) {
         ...data?.preset === undefined ? {} : { preset: data.preset }
       });
       if (!persisted.ok) {
-        execution2.result.problems.push(commandProblem(ProblemCode.SessionPersistenceFailed, "session.persistence", persisted.message, "The development session completed, but its local history is incomplete.", context.commandId));
+        execution2.result.problems.push({
+          ...commandProblem(ProblemCode.SessionPersistenceFailed, "session.persistence", persisted.message, "The development session completed, but its local history is incomplete.", context.commandId),
+          severity: "warning"
+        });
       }
     }
     return execution2;
@@ -43274,7 +43304,15 @@ async function acquireTargetLease(request, options = {}) {
     throw new RangeError("target lease heartbeatIntervalMs must be non-negative and less than ttlMs");
   }
   const root = leaseDirectory(options);
-  await mkdir4(root, { recursive: true, mode: 448 });
+  try {
+    await mkdir4(root, { recursive: true, mode: 448 });
+  } catch {
+    return {
+      ok: false,
+      code: "TARGET_LEASE_UNAVAILABLE",
+      message: "ADB Ready could not create the target ownership lease."
+    };
+  }
   const canonicalRoot = await realpath4(path11.resolve(request.projectRoot)).catch(() => path11.resolve(request.projectRoot));
   const targetFingerprint = fingerprint3(request.targetIdentity);
   const projectFingerprint = fingerprint3(`root:${process11.platform === "win32" ? canonicalRoot.toLowerCase() : canonicalRoot}`);
@@ -49034,4 +49072,4 @@ try {
   process14.removeListener("SIGTERM", abort);
 }
 
-//# debugId=EF4B0DF694B2B23564756E2164756E21
+//# debugId=855CD3B5A014B04364756E2164756E21

package/docs/RELEASING.md

@@ -24,7 +24,8 @@ The workflow does not use a long-lived npm write token.
 Release evidence has three tiers:
 
 - **Every release:** the complete fixture, unit, integration, runtime, package,
-  documentation, privacy, and release-artifact verification gate must pass.
+  documentation, privacy, coverage, and release-artifact verification gate must
+  pass. Pull requests must also satisfy the 95% changed-line coverage gate.
 - **Device-behavior changes:** rerun every affected workflow on a real target
   and record the exact host, target, Android version, and transport. A
   documentation, metadata, or machine-output-only patch does not manufacture
@@ -79,12 +80,14 @@ Do not create or move the final tag until this rehearsal is green.
 
 1. Create a draft GitHub release for the exact `vVERSION` tag on the audited
    release commit.
-2. Dispatch the workflow itself from that immutable tag. Publish mode rejects a
-   branch-based workflow run even if its checkout input points to a tag:
+2. Dispatch the audited workflow from protected `main` while selecting the
+   immutable tag as the release target. Publish mode rejects every other branch,
+   requires the checkout to resolve to that exact tag commit, and also permits a
+   self-contained dispatch from the matching tag:
 
    ```bash
    gh workflow run release.yml \
-     --ref vVERSION \
+     --ref main \
      -f mode=publish \
      -f release_tag=vVERSION \
      -f ref=vVERSION

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adb-ready",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Agent-ready Android CLI for reliable ADB sessions, app automation, and verified evidence.",
   "private": false,
   "type": "module",
@@ -11,7 +11,7 @@
   "files": [
     "CHANGELOG.md",
     "COMPATIBILITY.md",
-    "dist",
+    "dist/cli.js",
     "docs",
     "examples",
     "LICENSE",
@@ -34,6 +34,7 @@
     "ui:check": "bun run scripts/ui-playground.ts --all --non-interactive",
     "test": "bun test",
     "test:coverage": "bun test --coverage && bun run scripts/coverage-check.mjs",
+    "test:coverage:diff": "bun run scripts/coverage-diff-check.mjs",
     "test:commands": "bun run build && bun run scripts/command-matrix.mjs",
     "test:package-managers": "bun run build && bun run scripts/package-manager-smoke.mjs",
     "test:integration": "bun test tests/integration",

package/schema/agent-tools-v1.json

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