Android BLE Inspector

Step 1: Define the diagnostic contract

1. DEFINE scanner | advertisement viewer | GATT tree | characteristic read | controlled write | notify/indicate observation | standard decoder | local greeting peripheral | timing/race investigation | hardware interoperability.
2. IDENTIFY Android/device/OEM and peer matrix, supported roles, intended users, foreground-only lifecycle, permission profiles, scan power/time/filter policy, device identity/display policy, connection/GATT owners, safe operation set, write confirmation, raw-data sensitivity/retention, decoder source/version, and evidence to capture.
3. DEFAULT to read-only inspection. Enable writes, subscriptions, adapter mutation, or local peripheral behavior only through explicit visible user actions and capability checks.
4. READ references/article-audit.md before copying the supplied sample’s operation mutex, address deduplication, health parsers, advertisement sizing, name resolution, or adapter-name behavior.
5. ROUTE GATT connection/status failures to android-ble-gatt-status, platform lifecycle to android-ble, remote GATT serialization to android-ble-gatt-queue, local GATT server behavior to android-ble-gatt-server, logical schemas to ble-protocol-stack, and general Compose architecture to compose-multiplatform.

Completion: diagnostic questions, allowed radio mutations, ownership, data sensitivity, decoder authority, device matrix, and proof outputs are explicit.

Step 2: Inspect the project

RUN from the Android project root:

python3 scripts/inspect-project.py --root . --json