mobile-debug-mcp 0.34.0 → 0.36.0

package/docs/specs/026-code-structure-and-quality-gates/plan.md

@@ -0,0 +1,191 @@
+# Plan: code structure and quality gates
+
+[Intent](intent.md) · [Specification](spec.md) · [Verification metadata](verification.json)
+
+Status: complete — implementation and required local verification passed.
+Additional environment coverage remains explicitly unrun below.
+The maintainer approved the specification with “ok, lets do it” on 2026-10-30,
+and subsequently requested the folder cleanup and ArchUnitTS trial.
+
+
+## Implementation
+
+- [x] Capture complete public tool definitions and existing structural metrics.
+- [x] Add structural/type/boundary checks to lint and CI, with per-symbol legacy
+  ceilings and rejection of growth, stale entries, duplicate identities and
+  inline suppression. No baseline rewrite command runs in lint or CI.
+- [x] Extract shared runtime action-result/trace helpers and selector/condition
+  contracts, preserving server compatibility exports.
+- [x] Extract typed element, control-value, geometry, label and UI-change helpers;
+  bounded handle storage; injected subtree lookup and adjustment verification;
+  adjustment planning/results; and readable-state comparison.
+- [x] Complete the thin `ToolsInteract` facade: adjustment, resolution, polling,
+  assertion and legacy wait orchestration now live in typed services meeting
+  default limits without legacy exceptions. Existing handler/test seams remain.
+- [x] Consolidate clock/delay dependencies across interaction polling services;
+  production timer and readiness-budget semantics remain intact, with deterministic
+  injected-clock coverage for stability, retries, deadlines and trace timestamps.
+- [x] Split typed tool definitions by capability and retain exact registration order.
+- [x] Split server handler orchestration by capability and separate action
+  dispatch, conditional rejection, verification, evidence and journey phases.
+- [x] Share target-selection and execution-control contracts across TypeScript,
+  runtime validation and public schemas without changing permissive legacy parsing.
+- [x] Organise interaction helpers by responsibility and place network
+  observations under `observe/network/`.
+- [x] Add the explicitly approved ArchUnitTS development checks, including
+  negative controls for dynamic imports, re-exports, aliases and runtime cycles.
+- [x] Type debugger session/event/result boundaries, validate worker messages and
+  separate command targeting, execution and error recovery. The refactored
+  session manager meets default limits without exceptions.
+- [x] Add quality-gate failure cases, public contract baseline, and focused
+  helper/injection/protocol compatibility tests.
+- [x] Document limits, ownership and exception review; verify this checkpoint.
+
+## First-stage verification — 2026-10-30
+
+| Criterion | Check | Result |
+| --- | --- | --- |
+| Contract parity | Complete before/after definitions and checked-in compatibility fixture | **Pass**: all 52 tool definitions, schemas, defaults, descriptions and order unchanged |
+| Gate correctness | Size, complexity, nesting, types, boundaries, suppression and baseline fixtures | **Pass**: includes move/rename rejection, type-declaration isolation, obsolete entries and reductions |
+| Interaction compatibility | Existing interaction/server tests plus helper, scope, state-comparison and injected-verification tests | **Pass** for extracted behaviour; remaining orchestration refactor is pending |
+| Debugger lifecycle | Session/native/guard/protocol unit tests | **Pass**: serialization, stop references, event concurrency, expiry boundaries and cleanup |
+| Maintainer checks | `npm run verify` | **Pass**: lint, quality gate, build, 78 unit files and plugin consistency on Node 23.11.0 |
+| Native suite | `MCP_DEBUGGER_DEVICE=emulator-5554 npm run test:device` | **Pass**: 9 device files; Android debugger fixture, Android/iOS observation and correlation, Android Perfetto journeys |
+| Java/package | `javac --release 17 --add-modules jdk.jdi`; built worker preparation; `npm pack --dry-run --json` | **Pass**: shell Java 23; package includes worker source, protocol, runtime and definition modules |
+| Docs | Relative links/anchors, JSON and whitespace checks | **Pass** |
+
+The first device attempt failed before app interaction because the test's build
+fingerprint still referenced the removed `worker/` directory. Updated that
+fingerprint to `src/debugger/java/`; the complete rerun passed without weakening
+assertions or changing fixture behaviour.
+
+Android debugger evidence uses emulator-5554, API 36, server 0.34.0 over MCP
+stdio. It covers explicit attach, exact source stops, stack/known locals,
+into/over/out, stale references, resume with UI evidence, paused-operation guards,
+detach and forwarding ownership. Its complete dist/Java fingerprint is in the
+linked metadata. The fixture and owned resources were removed. The optional
+60-second expiry extension was **unrun**; deterministic expiry checks passed.
+
+Correlation journeys pin the Android emulator and the iPhone 17 Pro simulator
+(iOS 26.4). They launch Settings, capture referenced screenshots/logs/trees and
+check freshness and unavailable references. No settings or app data changed;
+Settings remains foreground. Older standalone observation wrappers use automatic
+target selection; their results do not establish which physical device was read.
+Perfetto checks pin the emulator and remove device/host trace artifacts.
+
+Real-device adjustable-control convergence is **unrun**: the current automated
+fixtures do not provide that journey. Adjustment behaviour has existing mock-
+adapter coverage and new injected-verification tests. Physical-device debugger,
+local Node 18, JDK 17 runtime execution, and hosted CI remain **unrun**. Existing
+CI retains Node 18 and Java 17; successful local checks do not establish hosted
+results or installed/published-package behaviour.
+
+## ToolsInteract continuation — 2026-10-30
+
+The maintainer requested continuing until the class met the 300-line limit.
+The class now contains **189 counted lines**, in a 267-line file, with no legacy
+exceptions. All 41 refactored interaction modules meet default file, function,
+complexity, nesting, type and dependency rules. A permanent unit check rejects
+exceptions for these modules, including future nested directories.
+
+The facade composes observation and input dependencies and preserves existing
+entrypoints. Adjustment stages cover resolution, planning, semantic strategies,
+coordinate/gesture fallback and verification. Candidate search separates scoring,
+ancestor preference and result construction. UI waits and assertions separate
+state, observation, stability and result handling. Legacy wait modes retain their
+baseline collection, polling and failure-snapshot behaviour.
+
+| Check | Result |
+| --- | --- |
+| `npm run verify` | **Pass**: lint, quality gate, build, 81 unit files, plugin consistency |
+| Default interaction budgets | **Pass**: 41 modules; no interaction-facade/service exceptions |
+| Public tool definitions | **Pass**: all 52 definitions unchanged against the captured fixture |
+| Native suite | **Pass**: 10 device files, including the new interaction journey |
+| Package dry run | **Pass**: Java source and all runtime/service modules included |
+| Documentation/JSON/whitespace | **Pass** |
+
+[Continuation verification metadata](verification-thin-facade.json) records native
+results and their build identities. Android API 36 emulator verification through
+the built MCP server covers clickable waits, resolved-handle taps, selector taps,
+visible assertions and stable enabled-state assertions on the isolated fixture.
+Fresh hierarchy assertions establish Result 43 and enabled=true; dispatch alone
+is not used as success evidence. The fixture is removed in `finally`, and the
+suite subsequently leaves system Settings foreground. Debugger, Android/iOS
+observation/correlation and Android trace journeys also pass. General older
+observation wrappers still use automatic device targeting.
+
+The earlier [verification record](verification.json) is retained for the first
+checkpoint. At that point the class was 2,161 counted lines; it is superseded by
+the current facade result above. Legacy exceptions elsewhere fell from 205 to
+162 without transferring exceptions to extracted code. Real-device adjustable
+control convergence and interactive iOS navigation remain **unrun**; existing
+mock/native-adapter and injected-strategy tests establish those covered contracts,
+not device outcomes. Hosted CI, local Node 18 and physical-device journeys remain
+separate from the passing local/emulator checks.
+
+## Final implementation continuation — 2026-10-30
+
+The central server handler is now a 159-line registration/dispatch module.
+Capability handlers cover management, observations, interactions, input, journeys
+and diagnostics. Action execution separates budgeted delivery, conditional
+rejection, result normalization, verification and serialization. Journey execution
+separates assertions, step dispatch, shared light-verification evidence, compact
+results and final response construction. These modules meet default quality limits
+without exceptions; 26 obsolete server allowances were removed, leaving 136
+reviewed legacy allowances elsewhere.
+
+Target fields, mutually exclusive target validation, wait controls and execution
+modes now have shared contracts. Existing legacy argument readers and control
+clamping/error semantics are retained. The complete 52-tool compatibility fixture
+still passes. Interaction services receive optional clocks; default composition
+uses the existing wall clock and delays, including readiness-aware budget delays.
+No process-global clock replacement is required by the new timing tests.
+
+The Android fixture now contains a labelled SeekBar, closing the adjustable-control
+convergence coverage gap. The updated journey has passed convergence and a fresh
+hierarchy assertion for the displayed value. Final checks and their results
+are recorded in [final verification metadata](verification-final.json).
+
+Earlier verification tables and metadata are dated checkpoints; they do not
+represent the final source layout or coverage. No commit, push, release or
+publication was performed. Existing unrelated edits and user removals were
+preserved.
+
+### Final verification results
+
+| Check | Result |
+| --- | --- |
+| `npm run verify` on Node 18.20.8 | **Pass**: lint, structural and architecture gates, build, 83 unit files and plugin consistency |
+| `npm run test:device` on Node 23.11.0 | **Pass**: all 10 device files; Android debugger, selector/wait/assertion/adjustment journeys, Android/iOS observation and correlation, Android Perfetto |
+| Public contract fixture | **Pass**: all 52 definitions unchanged |
+| Worker Java compilation | **Pass**: `javac --release 17 --add-modules jdk.jdi` on Java 23 |
+| Package dry run | **Pass**: all 121 compiled TypeScript modules and Java worker source included |
+| Documentation and whitespace | **Pass**: relative links/anchors, metadata JSON and diff checks |
+
+The final complete dist/Java build fingerprint is
+`2791c7ff502e7e60c9e053307ffb8afe3ad100afcbb4a7e68df5c85efa8d3041`.
+Trace-specific fingerprints cover a different subset of modules and are retained
+in the metadata as separate records. The Android interaction fixture starts at
+25 and verifies adjustment toward 75 within tolerance 5, followed by a fresh
+hierarchy assertion of the displayed value. Both fixture journeys remove their
+owned app/build data; Perfetto removes owned traces and host artifacts. System
+Settings remains foreground after observation checks without settings changes.
+
+Review identified and corrected an asynchronous error-handling difference while
+extracting debugger guards. A regression test now verifies that device-resolution
+failures retain the existing MCP error envelope. The final full Node 18 and native
+runs were repeated after that correction; the fingerprint above matches the final
+build.
+
+Hosted CI, physical-device interaction/debugger journeys, interactive iOS
+navigation/state/adjustment, the optional extended debugger expiry device journey,
+and execution under a JDK 17 runtime remain **unrun**. The metadata records the
+scope and reason for each. These are additional environment coverage limits,
+not passing device evidence or remaining implementation tasks. Local Node 18 and
+Android adjustable-control convergence are now verified, superseding those
+unrun entries in earlier checkpoints.
+
+## Follow-on maintenance
+
+See the [codebase health cleanup](health-plan.md) for subsequent debt removal,
+Node 22 support and verification. The results above describe the original change.

package/docs/specs/026-code-structure-and-quality-gates/spec.md

@@ -0,0 +1,138 @@
+# Specification: code structure and quality gates
+
+[Documentation](../../README.md) · [Approved intent](intent.md) · [Development process](../process.md)
+
+Date: 2026-10-30. Status: approved on 2026-10-30.
+The maintainer approved the intent with “looks good” on 2026-10-30.
+
+## Outcome and compatibility
+
+Make the interaction implementation and debugger lifecycle easier to change and
+review, and prevent new structural debt through failing local and CI checks.
+This is an internal refactor: preserve tool names, schemas, accepted and rejected
+inputs, defaults, error codes, response content blocks, targeting, retries,
+deadlines, cancellation, observation freshness, pause guards, and resource cleanup.
+Preserve exported handler entrypoints and existing test seams during migration.
+No new capabilities, dependencies, transport changes, or framework migration.
+
+## Module boundaries
+
+Replace the large interaction implementation with a thin `ToolsInteract` facade
+and cohesive modules under `src/interact/`:
+
+- Shared types and pure UI helpers: normalized elements, selectors, bounds,
+  identities, control values, and resolution results.
+- Target resolution and a bounded resolved-element store: matching, actionable
+  ancestors, ambiguity, handle freshness, and existing retention policy.
+- Control adjustment: numeric planning/quantization, gesture strategy, and bounded
+  adjustment orchestration as separate responsibilities.
+- Synchronization: screen/UI change detection, polling and stability checks.
+- Assertions: screen, visibility and readable-state verification.
+
+Keep native input in existing Android/iOS adapters. Extracted services receive
+narrow typed dependencies for observations, native delivery, clocks/delays, and
+resolved-element access. Production composition supplies existing implementations;
+unit tests can supply fakes without modifying unrelated static methods. Do not
+create one universal service interface or move the monolith into another class.
+The facade retains compatibility by forwarding calls through these services.
+
+Move action-result and trace construction out of `server/common.ts` into a shared
+runtime module. Domain services must not depend on MCP registration, handlers, or
+serialization. Add an import-boundary check preventing such dependencies in the
+extracted modules; compatibility re-exports may remain in the server layer.
+
+Group server handlers and definitions by capability, with a central registration
+index. For contracts touched by the extraction, define selector, targeting and
+execution-control shapes once and reuse them in schema construction, runtime
+validation and TypeScript types where compatible. Preserve existing validation
+strictness and errors; do not replace permissive legacy parsing with strict
+schemas incidentally. Keep documentation handwritten, backed by parity checks.
+
+In `DebuggerSessions`, replace untyped stop/event/result boundaries with explicit
+unions and validated worker-message shapes. Extract event buffering, expiry and
+cleanup helpers where cohesive. Expand compressed transitions into readable
+steps; preserve serialization, ownership, suspension and uncertain-outcome rules.
+Java worker protocol and source behaviour remain unchanged.
+
+## Enforced quality limits
+
+Use the installed ESLint and TypeScript tooling, with no new package dependency.
+Run structural checks as part of `npm run lint`, so both `npm run verify` and
+existing CI enforce them. Failures must exit nonzero, regardless of `--quiet`.
+
+| Metric | Default for production TypeScript |
+| --- | --- |
+| File length | 500 nonblank, noncomment lines |
+| Class length | 300 nonblank, noncomment lines |
+| Function/method length | 80 nonblank, noncomment lines |
+| Cyclomatic complexity | 20, using ESLint's classic calculation |
+| Nested control-flow depth | 4, using ESLint's calculation |
+| Explicit `any` | No new occurrences |
+
+Count classes, methods, declarations, expressions and arrow functions using syntax
+trees, not regular expressions. Use consistent counting in checks and diagnostics.
+Java source receives the 500-line file limit; class/function/complexity/type rules
+apply to TypeScript only. Test fixtures are outside production structural limits;
+existing lint still applies to tests. Do not apply mechanical production limits
+to large fixture tables or self-running test scripts.
+
+Record necessary legacy exceptions in a versioned, reviewed baseline with file,
+rule, stable symbol identity and current metric ceiling. File metrics use a
+file identity; explicit-any exceptions identify their enclosing symbol and count.
+New files and symbols receive no inherited allowance. Existing exceptions cannot
+exceed their recorded ceilings; unrelated improvements cannot offset regression
+elsewhere. Renames or moved code do not automatically inherit exceptions.
+
+The checker must reject missing or duplicate identities and obsolete entries;
+reductions require lowering or deleting the corresponding baseline entry. No
+automatic baseline rewrite in lint, verification or CI. Any explicit maintenance
+command only proposes changes for review; it cannot silently accept debt.
+Disallow inline suppression of these gates in production files. Exceptions belong
+in the reviewed baseline, with a reason. Extracted interaction modules and the
+refactored debugger session manager must meet defaults without new exceptions.
+Do not add suppression comments, compress code, or invent trivial wrappers to
+satisfy limits.
+
+## Acceptance and verification
+
+- `ToolsInteract` becomes a facade within the default file/class/function limits;
+  control adjustment is divided by responsibility, not merely relocated.
+- Extracted interfaces have no explicit `any`; schemas and handler types reuse
+  shared definitions, and domain imports respect the new boundary.
+- Deterministic tests establish that new/moved oversized classes and functions,
+  complex/nested functions, explicit-any additions, forbidden imports and inline
+  suppressions fail; valid code and unchanged legitimate baseline debt pass.
+  Cover growth, identity collision, stale entries and reductions in the baseline.
+- Capture public tool definitions before refactoring and compare after it. Exercise
+  handler input/error and response parity, timeout/cancellation, ambiguity, stale
+  handles, conditional rejection, pause guards, and ownership/cleanup. Normalize
+  only nondeterministic identifiers and timestamps in comparisons.
+- Existing unit coverage and new focused injection/contract tests pass, followed
+  by `npm run verify`. Use Node 18 as the CI compatibility target; record actual
+  local Node/JDK versions. Check Java compilation and npm package contents.
+- Run `npm run test:device` and focused selector/adjustment/wait/debugger journeys
+  on available fixtures. Record device/server identity, expected and observed
+  outcomes, cleanup, and pass/fail/blocked/unrun status separately by platform.
+  Missing devices or fixtures must be reported, not replaced with claims based
+  on mocked adapters.
+
+## Risks and rollout
+
+The main risks are changed observation order, circular imports, lost receiver
+binding, global state ownership, stricter accidental validation, and timeout or
+cleanup drift. Implement in reviewable steps with focused checks after each;
+retain public adapters until parity is established. Update the contribution guide
+with limits, exception review and module ownership. Record remaining legacy debt
+without describing the entire repository as fully refactored.
+
+## Approval
+
+The maintainer accepted this specification with “ok, lets do it” on 2026-10-30.
+Implementation is authorised within this scope; see the [plan](plan.md).
+
+## Subsequent maintainer decision — architectural checks
+
+On 2026-10-30 the maintainer approved trying ArchUnitTS with “ok, lets try it”.
+This explicitly extends the original dependency constraint to permit the pinned
+`archunit` development dependency. Its checks complement the existing structural
+limits and preserve the existing test runner and production dependencies.

package/docs/specs/026-code-structure-and-quality-gates/verification-final.json

@@ -0,0 +1,200 @@
+{
+  "date": "2026-10-30",
+  "scope": "Spec 026 final server/contracts/clock continuation and approved architectural-check extension",
+  "status": "pass",
+  "maintainer": {
+    "command": "PATH=/tmp/mobile-debug-node18/node_modules/node/bin:$PATH npm run verify",
+    "status": "pass",
+    "node": "v18.20.8",
+    "unit_files": 83
+  },
+  "device": {
+    "command": "MCP_INTERACTION_DEVICE=emulator-5554 MCP_DEBUGGER_DEVICE=emulator-5554 ADB_PATH=/Users/clivejefferies/Library/Android/sdk/platform-tools/adb npm run test:device",
+    "status": "pass",
+    "node": "v23.11.0",
+    "device_files": 10,
+    "records": [
+      {
+        "status": "PASS",
+        "build_sha256": "2791c7ff502e7e60c9e053307ffb8afe3ad100afcbb4a7e68df5c85efa8d3041",
+        "device": "emulator-5554",
+        "api": "36",
+        "runtime": "v23.11.0",
+        "transport": "MCP stdio",
+        "extended": false
+      },
+      {
+        "status": "PASS",
+        "server": {
+          "name": "mobile-debug-mcp",
+          "version": "0.34.0"
+        },
+        "device": "emulator-5554",
+        "api": "36",
+        "runtime": "v23.11.0",
+        "journey": "clickable wait, resolved-handle tap, visible assertion, selector journey and stable enabled-state assertion and labelled SeekBar convergence",
+        "evidence": "Result 43, enabled=true and adjusted slider label established by fresh hierarchy assertions",
+        "cleanup": "Owned fixture removed in finally; no other app data or device settings changed",
+        "build_sha256": "2791c7ff502e7e60c9e053307ffb8afe3ad100afcbb4a7e68df5c85efa8d3041"
+      },
+      {
+        "status": "PASS",
+        "server": {
+          "name": "mobile-debug-mcp",
+          "version": "0.34.0"
+        },
+        "platform": "android",
+        "device": "emulator-5554",
+        "osVersion": "16",
+        "startingApp": "com.android.settings",
+        "actionId": "7f4de94a-1b4b-4da5-9abb-4ba60c379bfd",
+        "phases": {
+          "dispatchStarted": 1793393215121,
+          "dispatchCompleted": 1793393215463,
+          "screenshotStarted": 1793393216323,
+          "screenshotCompleted": 1793393216648
+        },
+        "screenshot": "captured",
+        "logs": "captured",
+        "uiTree": "captured",
+        "disabledComponents": "omitted",
+        "foreignReference": "unavailable",
+        "cleanup": "No settings, app data or streams changed; Settings remains foreground. No content artifacts saved."
+      },
+      {
+        "status": "PASS",
+        "server": {
+          "name": "mobile-debug-mcp",
+          "version": "0.34.0"
+        },
+        "platform": "ios",
+        "device": "F9243BAF-62A8-4990-8A99-17F527F56FDA",
+        "osVersion": "iOS 26.4",
+        "startingApp": "com.apple.Preferences",
+        "actionId": "25de0b20-a80b-4b8d-bc2b-80e5fa468698",
+        "phases": {
+          "dispatchStarted": 1793393224322,
+          "dispatchCompleted": 1793393224681,
+          "screenshotStarted": 1793393225133,
+          "screenshotCompleted": 1793393225638
+        },
+        "screenshot": "captured",
+        "logs": "captured",
+        "uiTree": "captured",
+        "disabledComponents": "omitted",
+        "foreignReference": "unavailable",
+        "cleanup": "No settings, app data or streams changed; Settings remains foreground. No content artifacts saved."
+      },
+      {
+        "status": "PASS",
+        "build_sha256": "39f8d1143f53a0c84330e8c204835b38f2fd337d2e949cca50344f94654ff063",
+        "runtime": "v23.11.0",
+        "server": {
+          "name": "mobile-debug-mcp",
+          "version": "0.34.0"
+        },
+        "device": "emulator-5554",
+        "osVersion": "16",
+        "starting_state": "System Settings fixture",
+        "journey": "start Settings, assert baseline Settings-owned resource visible in UI tree; explicit trace association",
+        "trace_id": "827af8fb-4f35-4571-bdf0-1d69a2c02df8",
+        "correlation_id": "a5633929-8d66-4f65-8634-f6ffc2fd1704",
+        "phases": {
+          "capture_started_at_ms": 1793393260410,
+          "capture_completed_at_ms": 1793393266930
+        },
+        "artifact_bytes": 1115506,
+        "content": {
+          "packets": 249,
+          "ftrace_bundles": 232,
+          "events": 26658,
+          "compact_sched_bundles": 232,
+          "validation": "local protobuf structure, trace config duration and timestamped ftrace/compact scheduler content; not full Perfetto analysis"
+        },
+        "durationContent": {
+          "packets": 52,
+          "ftrace_bundles": 36,
+          "events": 2849,
+          "compact_sched_bundles": 36,
+          "validation": "local protobuf structure, trace config duration and timestamped ftrace/compact scheduler content; not full Perfetto analysis"
+        },
+        "cancel": "PASS",
+        "expired_journey": "PASS",
+        "active_shutdown": "PASS",
+        "cleanup": "Device capture files removed; test host artifacts removed in finally. No settings or app data changed. Settings remains foreground."
+      }
+    ]
+  },
+  "contracts": {
+    "status": "pass",
+    "tool_definitions": 52,
+    "comparison": "Complete captured public fixture: names, schemas, defaults, descriptions and registration order"
+  },
+  "quality": {
+    "status": "pass",
+    "legacy_allowances_remaining": 136,
+    "server_handler_physical_lines": 159,
+    "new_server_and_interaction_exceptions": 0,
+    "architecture_rules": 4,
+    "architecture_dependency_edges": 549,
+    "runtime_cycles": 0
+  },
+  "deterministic_timing": {
+    "status": "pass",
+    "coverage": [
+      "stable UI wait",
+      "retry/backoff and inclusive deadlines",
+      "screen fingerprint confirmation",
+      "search expiry",
+      "state assertion stability and trace timestamps"
+    ],
+    "global_timer_replacement": false
+  },
+  "review": {
+    "status": "pass",
+    "notes": [
+      "Capability extraction preserves central registration and handler/test seams.",
+      "Removed 26 obsolete server debt allowances without transferring them.",
+      "Preserved legacy input permissiveness and exact execution-control clamping/error semantics.",
+      "Corrected and regression-tested the extraction of device-resolution errors into the existing MCP error envelope.",
+      "Production readiness delays and native input adapters remain in use."
+    ]
+  },
+  "java": {
+    "status": "pass",
+    "command": "javac --release 17 --add-modules jdk.jdi -d /tmp/mobile-debug-spec026-java17 src/debugger/java/DebuggerWorker.java",
+    "local_java": "23",
+    "production_worker_source_changed": false
+  },
+  "package": {
+    "status": "pass",
+    "command": "npm pack --dry-run --json",
+    "compiled_modules": 121,
+    "worker_source_included": true,
+    "installed_or_published_package_tested": false
+  },
+  "unrun": [
+    {
+      "check": "Hosted CI",
+      "reason": "Local verification ran on the CI Node 18 target; no commit or push was requested."
+    },
+    {
+      "check": "Physical-device interaction/debugger journeys",
+      "reason": "The isolated native fixture journeys target emulator-5554; general observation wrappers can select connected devices automatically."
+    },
+    {
+      "check": "Interactive iOS navigation/state and adjustable-control journeys",
+      "reason": "No isolated iOS interaction fixture is provided; iOS screenshot/log/tree and correlated-evidence checks are covered separately."
+    },
+    {
+      "check": "Optional 60-second debugger expiry device extension",
+      "reason": "Default debugger journey ran without the opt-in extension; deterministic expiry coverage passed."
+    },
+    {
+      "check": "JDK 17 runtime execution",
+      "reason": "The worker was compiled with --release 17 on Java 23; native fixture execution uses the configured Android Studio JBR."
+    }
+  ],
+  "build_sha256": "2791c7ff502e7e60c9e053307ffb8afe3ad100afcbb4a7e68df5c85efa8d3041",
+  "build_fingerprint_scope": "All files under dist/ and src/debugger/java/, sorted recursively, hashing each repository-relative path and file bytes."
+}