adb_utils

• feat(sync): implemented the native LIST protocol command in AdbSync to read remote directories.
• feat(models): introduced the strongly typed AdbDirEntry model with built-in Unix file-mode decoding (permissionsOctal/permissionsString, isDirectory, isFile, isLink) and safe UTC timestamps.
• test: added a dedicated unit-test suite at test/sync_list_test.dart to validate model parsing and mock socket-server protocol exchanges (success, sentinel filtering, and FAIL/error handling).

• fix(phantom): replaced Logcat-based dynamic port discovery with a deterministic file handshake in app-private storage (context.filesDir/phantom_ports.json).
• fix(phantom): the Dart client now reads and cleans the handshake file using run-as com.example.phantom_agent to avoid sandbox permission errors on /data/local/tmp and /tmp.
• fix(phantom): instrumentation now starts asynchronously without relying on shell redirection, improving compatibility across real devices and emulators.
• test(phantom): updated phantom_client_test.dart expectations for run-as file polling and cleanup.
• chore(phantom): refreshed embedded Phantom APK artifacts and regenerated phantom_binaries.dart.

• feat(logging): added structured Smart Logs with package:logging, including hierarchical loggers per device/Phantom serial and configurable global logging bootstrap.
• feat(observability): added contextual telemetry (FINE, INFO, WARNING, SEVERE) for shell execution, Phantom startup, dynamic-port discovery, and TCP forwarding.
• feat(shell-smart-trace): non-zero shell2 exit codes now emit SEVERE smart traces with command, exit code, and sanitized output.
• fix(phantom): hardened dynamic port discovery with Logcat cleanup, polling retries/fallbacks, and improved resilience in noisy multi-device environments.
• fix(tests): stabilized integration suites by isolating destructive scenarios, improving environment gating, and converting transient infrastructure failures into contextual skips where appropriate.
• docs: synchronized adb_utils and phantom_agent documentation with the dynamic-port architecture (ServerSocket(0) + adb forward) and updated troubleshooting guidance.

• feat(phantom): embedded Phantom APK binaries in Dart source through Base64, removing the runtime dependency on local APK paths.
• feat(phantom): refactored PhantomClient.startAgent() to install embedded binaries through safe temporary files created at runtime.
• feat(phantom): added the AdbDevice.phantom extension for ergonomic usage (await device.phantom.startAgent();).
• build(tooling): added tool/generate_base64_apks.dart to regenerate lib/src/phantom/phantom_binaries.dart.
• docs: updated the README, docs, and examples for the new no-path Phantom startup flow.

(doc) adding a wealth of documentation and examples for the community…

• docs: updated documentation to reflect the latest changes in release 0.4.2.
• example: added examples.

(chore) deploy 0.4.0 version.

• feat(phantom): added PhantomClient.startVideoStream() for raw H.264 streaming.
  • Automatically configures adb forward tcp:9009 -> tcp:9009.
  • Opens a native Socket on 127.0.0.1:9009 and returns it as Stream<List<int>>.
  • Added API docs clarifying the stream contains raw H.264 NAL units.
• feat(reporting): added automated HTML test reporting utilities.
  • Added TestResult model (lib/src/reporting/test_result.dart).
  • Added HtmlReporter (lib/src/reporting/html_reporter.dart) with summary cards and failure evidence blocks (mensagemErro + stackTrace in <pre><code>).
  • Added sequential test wrapper TestRunner (lib/src/reporting/test_runner.dart).
  • Exported reporting APIs in lib/adb_utils.dart.
  • Added demo runner at bin/test_runner.dart that writes report.html.
• test(reporting): dart test now generates report.html automatically.
  • Added test/helpers/reporting_test.dart to capture per-test results and failures.
  • Integrated reporting helper in unit and integration suites:
    • test/adb_utils_test.dart
    • test/phantom_client_test.dart
    • test/integration/server_test.dart
    • test/integration/device_test.dart
• test(phantom): added coverage for startVideoStream() forwarding and byte streaming behavior.

Co-authored-by: Copilot [email protected]

• chore: apply dart format across project files required by CI/release workflow.

Co-authored-by: Copilot [email protected]

• feat(ui_hierarchy): added typed UI hierarchy model and package export.
  • Added UiHierarchy, UiNode, and Bounds in lib/src/models/ui_hierarchy.dart.
  • Exported ui_hierarchy.dart from the main barrel (adb_utils.dart).
• feat(phantom): added dumpWindowHierarchy() to parse XML directly into UiHierarchy.
• security: hardened shell/socket surfaces.
  • Added package-name validation in appInfo() and uninstall().
  • Added URL validation/sanitization in openBrowser().
  • Added Phantom socket connect/response timeouts, response size cap, empty-response check, and strict port-range validation.
• test: added security-focused tests and hierarchy parsing coverage.
• docs: updated README with Phantom + UiHierarchy usage.

Co-authored-by: Copilot [email protected]

• feat(phantom): added PhantomClient to orchestrate UiAutomator agent lifecycle and TCP communication.
  • Added startAgent(targetApkPath, agentApkPath) with APK push, install, force-stop, background instrumentation start, and port forwarding.
  • Added JSON socket communication flow with robust chunked response handling.
  • Added dumpWindow() and clickByText() high-level actions.
• test(phantom): added focused unit tests for startAgent, JSON payload exchange, dumpWindow(), and clickByText().
• chore(phantom): added bundled APK artifacts for the phantom flow:
  • lib/src/phantom/apks/agent.apk
  • lib/src/phantom/apks/target.apk

• feat(adb_sync): fully implemented file transfer operations via the ADB SYNC protocol.
  • Added pull(): download files using memory-efficient streaming.
  • Added readBytes() and readText(): read remote file contents directly into memory.
  • Added stat(): query remote file size, mode, and modification time.

• fix: apply dart format to app_info.dart and adb_utils_test.dart

• added AppInfo.fromDumpsys to get more detailed information about the app, such as version and permissions. This is useful for users who want to know more about the apps installed on their devices.
• added AdbDevice.appInfo to retrieve the AppInfo for a given package name.