feat(track): record which devices are paired, and report it on upload

The app knew about bonded devices only in passing - syncPairedDevices marked
them tracked and threw the bond state away - so nothing downstream could tell
a paired device from one merely seen. Adds devices.paired (schema 17), set
from ACTION_BOND_STATE_CHANGED and from the bonded list at startup, and sends
it as a `paired` column on every uploaded row.

The flag is its own column rather than inferred from is_tracked, which answers
a different question: a device can be tracked without ever having been paired.

syncPairedDevices clears the flag before re-asserting it from getBondedDevices.
A device unpaired while the service was dead never broadcast BOND_NONE, so the
bonded list is the only reliable answer at startup, and without the clear such
a device would stay marked paired forever.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.gitignore

@@ -1 +1,4 @@
 /build
+.gradle
+/app/build
+local.properties

PROJECT_CONTEXT.md

@@ -0,0 +1,450 @@
+# BlueToothLogger Android Application - Technical Project Context
+
+## Project Overview
+
+**Project Name:** BlueToothLogger  
+**Package:** `com.wytehat.btlogger`  
+**Location:** `/Users/n0tst3v3/bletracker/BlueToothLogger`  
+**Type:** Bluetooth tracking and logging application with spatial analysis capabilities
+
+---
+
+## Core Classes and Inheritance
+
+| Class | Extends | Implements | Purpose |
+|-------|---------|------------|---------|
+| `MainActivity` | Activity | ItemActionListener | Main entry point, UI controller |
+| `BluetoothTrackingService` | Service | LocationListener | Background Bluetooth tracking |
+| `TrackerDatabase` | SQLiteOpenHelper | - | SQLite database wrapper |
+| `MapActivity` | Activity | - | Map visualization |
+| `DeviceManagerActivity` | Activity | - | Device management UI |
+| `LiveRangeFinderActivity` | Activity | LocationListener, SensorEventListener | Real-time signal finder |
+| `BluetoothRadarView` | View | - | Custom radar visualization |
+| `DeviceListAdapter` | BaseAdapter | - | List adapter for devices |
+
+---
+
+## BluetoothTrackingService - Technical Details
+
+### Constants
+```java
+public static final String ACTION_DATA_CHANGED = "com.wytehat.btlogger.DATA_CHANGED"
+public static final String ACTION_CONFIG_CHANGED = "com.wytehat.btlogger.CONFIG_CHANGED"
+public static final String ACTION_RANGE_MODE = "com.wytehat.btlogger.RANGE_MODE"
+private static final int NOTIFICATION_ID = 42
+private static final String CHANNEL_ID = "bluetooth_tracking"
+private static final String ALERT_CHANNEL_ID = "tracked_item_disconnects"
+```
+
+### Fields
+```java
+private TrackerDatabase db
+private LocationManager locationManager
+private BluetoothAdapter bluetooth
+private Location lastLocation
+private boolean receiverRegistered
+private boolean rangeModeActive
+private int phoneBattery = 100
+private final Handler handler = new Handler()
+private final HashMap<String, Long> lastPeriodicLog
+```
+
+### Key Methods
+```java
+public void onCreate()
+public int onStartCommand(Intent intent, int flags, int startId)
+public void onDestroy()
+public IBinder onBind(Intent intent)
+
+// Location callbacks
+public void onLocationChanged(Location location)
+public void onProviderDisabled(String provider)
+public void onProviderEnabled(String provider)
+public void onStatusChanged(String provider, int status, Bundle extras)
+
+// Bluetooth callbacks
+public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord)
+
+// Private methods
+private void loadLastLocation()
+private void configureLocation()
+private int shortestActiveInterval()
+private void stopLocation()
+private void captureFresh(String address, long eventTime)
+private TrackerDatabase.Fix currentFix()
+private TrackerDatabase.Fix fix(Location location)
+private void resolveVendor(String address, int companyId)
+private String bytesToHex(byte[] data)
+private int parseCompanyId(byte[] scanRecord)
+private String infer(DeviceRecord record)
+private void disconnectAll(String reason)
+private void syncPairedDevices()
+private void restartBackgroundScan()
+private boolean shouldBackgroundScan()
+private boolean isLocationEligible(DeviceRecord record, long now)
+private void notifyChanged()
+private boolean hasLocationPermission()
+private boolean hasBluetoothPermission()
+private String address(BluetoothDevice device)
+private String name(BluetoothDevice device)
+private Location newer(Location first, Location second)
+private void showDisconnectAlert(DeviceRecord record, String reason)
+private Notification buildNotification()
+```
+
+---
+
+## TrackerDatabase - Technical Details
+
+### Constants
+```java
+private static final String DB_NAME = "bluetooth_tracker.db"
+private static final int DB_VERSION = 15
+```
+
+### Inner Class: Fix
+```java
+public static class Fix {
+    public double latitude
+    public double longitude
+    public float accuracy
+    public Fix(double lat, double lon, float acc)
+}
+```
+
+### Key Methods
+```java
+public TrackerDatabase(Context context)
+public void onCreate(SQLiteDatabase db)
+public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)
+
+// Device tracking
+public synchronized void connected(String address, String broadcast, long time, Fix fix)
+public synchronized void disconnected(String address, String broadcast, long time, String reason)
+public synchronized void telemetry(String address, String broadcast, Integer battery, String vendor, String category, long time)
+public synchronized void recordObservation(String address, long time, int rssi, int txPower)
+public synchronized void updateLocation(String address, Fix fix, long time)
+
+// Profile and calibration
+public synchronized void updateProfile(String address, String title, String photo, String color, long time)
+public synchronized void updateCalibration(String address, int txPower, double exponent)
+
+// Range finding
+public synchronized void logRangeSample(String address, String sessionId, long time, int rssi, double distance)
+
+// Tracking settings
+public synchronized void updateTracking(String address, int minutes, String color)
+public synchronized void markTracked(String address, String broadcast)
+public synchronized void removeFromTracking(String address)
+public synchronized void setMapEnabled(String address, boolean enabled)
+public synchronized void setLiveEnabled(String address, boolean enabled)
+public synchronized void setTrackBroadcast(String address, boolean enabled)
+public synchronized void setShowTrail(String address, boolean shown)
+public synchronized void setLocationLocked(String address, boolean locked)
+public synchronized void setCustomName(String address, String name)
+public synchronized void setDetectedCategory(String address, String category)
+public synchronized void setCategory(String address, String category)
+public synchronized void setVendor(String address, String vendor)
+public synchronized void setManualVendor(String address, String vendor)
+
+// Lookups
+public synchronized String lookupOui(String address)
+public synchronized String lookupCompany(int companyId)
+
+// Queries
+public synchronized DeviceRecord get(String address)
+public synchronized List<DeviceRecord> all()
+public synchronized List<DeviceRecord> tracked()
+public synchronized List<LocationPoint> history(String address, long since)
+```
+
+---
+
+## MainActivity - Technical Details
+
+### Constants
+```java
+private static final int PERMISSIONS = 100
+private static final int CAMERA = 200
+```
+
+### Fields
+```java
+private TrackerDatabase db
+private DeviceListAdapter adapter
+private boolean registered
+private DeviceRecord editing
+private final Handler refreshHandler = new Handler()
+private final Runnable refreshLiveAvailability
+private final BroadcastReceiver updates
+```
+
+### Key Methods
+```java
+protected void onCreate(Bundle state)
+protected void onResume()
+protected void onPause()
+protected void onDestroy()
+
+// UI actions
+public void edit(DeviceRecord record)
+public void map(DeviceRecord record)
+public void live(DeviceRecord record)
+public void manage(DeviceRecord record)
+
+// Device operations
+private void removeTrackedItem(DeviceRecord record)
+private void toggleBroadcastTracking(DeviceRecord record)
+private void toggleTrail(DeviceRecord record)
+private void refind(DeviceRecord record)
+
+// Renaming and settings
+private void rename(DeviceRecord record)
+private void chooseTracking(DeviceRecord record)
+private void chooseColor(DeviceRecord record, int minutes)
+private void takePhoto()
+protected void onActivityResult(int request, int result, Intent data)
+private void showSettings()
+private void openNotificationSettings()
+private void openAppSettings(String instruction)
+private boolean isBatteryOptimizationDisabled()
+private void requestBackgroundProtection()
+private void showTrackingInformation()
+
+// Permissions
+public void onRequestPermissionsResult(int request, String[] permissions, int[] results)
+private void requestNeededPermissions()
+private void addPermission(List<String> list, String permission)
+private void reload()
+```
+
+---
+
+## LiveRangeFinderActivity - Technical Details
+
+### Implements
+```java
+implements LocationListener, SensorEventListener, ItemActionListener
+```
+
+### Key Methods
+```java
+protected void onCreate(Bundle savedState)
+protected void onPause()
+protected void onDestroy()
+
+// Location callbacks
+public void onLocationChanged(Location location)
+public void onProviderDisabled(String provider)
+public void onProviderEnabled(String provider)
+public void onStatusChanged(String provider, int status, Bundle extras)
+
+// Sensor callbacks
+public void onSensorChanged(SensorEvent event)
+public void onAccuracyChanged(Sensor sensor, int accuracy)
+
+// Bluetooth callbacks
+public void onScanResult(int callbackType, ScanResult result)
+public void onBatchScanResults(List<ScanResult> results)
+public void onScanFailed(int errorCode)
+
+// UI actions
+private void startSearch()
+private void stopSearch(String message)
+private void tagItemHere()
+private void startCalibration()
+private void updateRadar()
+private void updateRangeDisplay()
+private void updateDistanceDisplay()
+private void updateCalibrationDisplay()
+private void updateSearchDisplay()
+private void updateSearchStatus()
+private void updateSearchProgress()
+private void updateSearchResults()
+private void updateSearchSettings()
+private void updateSearchControls()
+private void updateSearchUI()
+```
+
+---
+
+## MapActivity - Technical Details
+
+### Implements
+```java
+implements LocationListener, SensorEventListener, ItemActionListener
+```
+
+### Key Methods
+```java
+protected void onCreate(Bundle state)
+protected void onResume()
+protected void onPause()
+protected void onDestroy()
+
+// Location callbacks
+public void onLocationChanged(Location location)
+public void onProviderDisabled(String provider)
+public void onProviderEnabled(String provider)
+public void onStatusChanged(String provider, int status, Bundle extras)
+
+// Sensor callbacks
+public void onSensorChanged(SensorEvent event)
+public void onAccuracyChanged(Sensor sensor, int accuracy)
+
+// Map operations
+private void updateMap()
+private void updateMarkers()
+private void updateTrails()
+private void updateCamera()
+private void updateLocation()
+private void updateRange()
+private void updateCalibration()
+private void updateSearch()
+private void updateSettings()
+private void updateUI()
+```
+
+---
+
+## DeviceManagerActivity - Technical Details
+
+### Key Methods
+```java
+protected void onCreate(Bundle state)
+protected void onPause()
+protected void onDestroy()
+
+// Bluetooth scanning
+private void startScan()
+private void stopScan()
+private void refreshCategoryOptions()
+private void updateRadar()
+
+// Device management
+private void toggleMap(DeviceRecord record, Button button)
+private void toggleTrack(DeviceRecord record, Button button)
+private void editSignal(DeviceRecord record)
+private void confirmRemoveSignal(SignalEntry entry)
+private void copyText(String label, String text)
+
+// Adapters
+private class SignalGridAdapter extends BaseAdapter
+private class PairedAdapter extends BaseAdapter
+```
+
+---
+
+## BluetoothRadarView - Technical Details
+
+### Extends
+```java
+extends View
+```
+
+### Key Features
+- Custom radar-like visualization
+- Radial gradient rendering
+- Touch event handling
+- Signal strength visualization
+
+---
+
+## Data Models
+
+### DeviceRecord
+```java
+public class DeviceRecord {
+    public String address
+    public String title
+    public String broadcast
+    public String category
+    public String vendor
+    public String color
+    public int trackingMinutes
+    public boolean mapEnabled
+    public boolean liveEnabled
+    public boolean trackBroadcast
+    public boolean showTrail
+    public boolean locationLocked
+    public int txPower
+    public double exponent
+    public long lastSeen
+    public long lastLocation
+    public int battery
+    public String photo
+}
+```
+
+### LocationPoint
+```java
+public class LocationPoint {
+    public String address
+    public double latitude
+    public double longitude
+    public float accuracy
+    public long time
+}
+```
+
+---
+
+## Key Android Components
+
+### Permissions Required
+- `BLUETOOTH` - Bluetooth scanning and discovery
+- `BLUETOOTH_ADMIN` - Bluetooth administration
+- `ACCESS_FINE_LOCATION` - Precise location access
+- `ACCESS_COARSE_LOCATION` - Approximate location access
+- `FOREGROUND_SERVICE` - Background service execution
+- `CAMERA` - Device photo capture
+- `RECEIVE_BOOT_COMPLETED` - Auto-start on boot
+
+### Services
+- `BluetoothTrackingService` - Foreground service for continuous tracking
+- `LocationManager` - GPS and network location services
+- `BluetoothAdapter` - Bluetooth scanning and discovery
+
+### Broadcast Receivers
+- `DATA_CHANGED` - Device data updates
+- `CONFIG_CHANGED` - Configuration changes
+- `RANGE_MODE` - Range finder mode changes
+- `BOOT_COMPLETED` - System boot completion
+
+---
+
+## Signal Processing Flow
+
+```
+Bluetooth Scan → LeScanCallback → RSSI Reading
+                                    ↓
+                          BluetoothTrackingService
+                                    ↓
+                          captureFresh() → Fix()
+                                    ↓
+                          TrackerDatabase.recordObservation()
+                                    ↓
+                          SpatialGradientEngine Analysis
+                                    ↓
+                          RangeStateMachine State Update
+                                    ↓
+                          MapActivity / BluetoothRadarView Update
+```
+
+---
+
+## Database Schema (Version 15)
+
+### Tables
+- `devices` - Device records and metadata
+- `locations` - GPS location history
+- `observations` - RSSI observations
+- `telemetry` - Battery and vendor info
+- `calibrations` - TX power and exponent
+- `range_samples` - Range finding data
+- `vendors` - Vendor lookup table
+- `categories` - Device categories
+
+---
+
+*Document generated from technical analysis of Java source files*