BridgeLink v0.3.0

Added - 📶 WiFi Connection Support

• WiFi Device Connection: Connect Android devices wirelessly using ADB over TCP/IP
  • New --wifi flag for devices add command
  • Automated 3-step WiFi setup flow:
    1. Enable TCP/IP mode on USB-connected device
    2. Get device WiFi IP address automatically
    3. Connect via WiFi and create tunnel
  • Support for disconnecting USB cable after WiFi setup
  • WiFi connections use IP:port format (e.g., 192.168.1.15:5555)
• WiFi Utility Functions in bridgelink/utils/adb.py:
  • list_usb_devices() - Filter USB vs WiFi connections
  • get_device_ip_address() - Automatically get device WiFi IP
  • enable_tcpip_mode() - Enable ADB TCP mode on port 5555
  • connect_wifi() - Connect to device via WiFi
  • disconnect_wifi() - Disconnect WiFi connection
  • is_wifi_connection() - Detect connection type from serial
• Connection Mode Tracking: Track and display how devices are connected
  • New connection_mode field in device details (USB/WiFi)
  • Stored in backend database for each device
  • Auto-detected based on device serial format
  • Displayed in device list table
• Enhanced Device List Table:
  • New # column with serial numbering (1, 2, 3...)
  • New Mode column showing connection type (USB/WiFi)
  • Updated table headers: ['#', 'Serial', 'Model', 'Brand', 'Type', 'Mode', 'State', 'Auto-Act', 'Tunnel URL']
  • Help text explaining connection mode

Added - 📊 Enhanced Device Details Collection

• Comprehensive Device Information: Collect detailed hardware and software specs
  • Security patch level (ro.build.version.security_patch)
  • CPU architecture (ro.product.cpu.abi)
  • RAM capacity in GB (from /proc/meminfo)
  • Storage capacity in GB (from /data partition)
  • Screen resolution (from wm size)
  • Screen density DPI (from wm density)
• Backend Support: All new fields stored in backend device_details
  • Fields: security_patch, cpu, ram_gb, storage_gb, resolution, density_dpi, connection_mode
  • All optional for backward compatibility
  • Sent to backend on device add and activate

Added - 🎨 Colorful CLI Interface

• Beautiful Terminal Output: Interactive and colorful CLI experience
  • Green: Success messages and checkmarks (✅, ✓)
  • Red: Errors only (❌)
  • Yellow: Warnings, tips, and important info (💡, ⚠️)
  • Blue: Process steps and actions (📡, 🔧)
  • Cyan: Device identifiers, serials, IPs, URLs
  • Magenta: Tunnel URLs and important data
  • White: Labels and regular text
• Enhanced CLI Sections:
  • Colorized authentication messages
  • Colorized WiFi setup flow with step indicators
  • Colorized device information display
  • Colorized success messages with borders
  • Colorized dashboard URLs with underlines
  • Colorized health monitoring messages
  • Colorized security warnings (yellow, not red)
  • Colorized device list output

Added - 🌐 Dashboard Integration

• NativeBridge Dashboard URL: Show dashboard URL after device registration
  • Environment-aware URL mapping:
    • dev.api.nativebridge.io → trust-me-bro.nativebridge.io/dashboard/bridgelink
    • api.nativebridge.io → nativebridge.io/dashboard/bridgelink
  • Display dashboard URL after devices add and devices activate
  • Users can manage devices, start remote sessions, and control devices from dashboard
• New API Client Method: get_dashboard_url() for environment detection

Changed - 🔧 Backend API Updates

• DeviceDetails Model: Extended with new optional fields
  • Added: manufacturer, os_version, sdk, security_patch, cpu, ram_gb, storage_gb, resolution, density_dpi, connection_mode
  • Backward compatible (all new fields are optional)
• Field Compatibility: Support both old and new field names
  • Required fields: brand, android_version, sdk_version
  • Also send: manufacturer, os_version, sdk for consistency

Changed - ⚡ WiFi Support in Existing Features

• Tunnel Manager: Updated setup_adb_tcp() with is_wifi parameter
  • WiFi devices: Skip TCP mode enable, just forward port
  • USB devices: Enable TCP mode then forward port
• Connection Monitor: WiFi support in auto-activation
  • Detects WiFi vs USB connections using is_wifi_connection()
  • Handles WiFi reconnection in auto-activation flow
• Device Activate: Updates connection mode when activating devices
  • Ensures mode is current even if device was previously connected differently

Documentation

• Created docs/WIFI_CONNECTION_GUIDE.md: 800+ line comprehensive WiFi guide
  • WiFi connection overview and architecture
  • Step-by-step setup instructions
  • Usage examples for USB and WiFi workflows
  • Multi-device WiFi support guide
  • Troubleshooting common WiFi issues
  • API documentation for WiFi features
• Created ENHANCED_DEVICE_DETAILS.md: Device details collection documentation
• Created CLI_COLORS_ENHANCEMENT.md: Color scheme documentation
  • Color palette and usage guide
  • Visual examples and benefits
  • Terminal compatibility information
• Created BACKEND_API_UPDATE.md: Backend changes summary
• Updated README.md: Added WiFi connection section and dashboard information
• Updated docs/README.md: Added WiFi and dashboard documentation links

Fixed

• Security warnings now use yellow color instead of red (red reserved for errors only)
• Backend validation errors for missing brand and android_version fields
• Backend Pydantic model rejecting extra device detail fields
• Connection mode tracking across activate/deactivate cycles

BridgeLink v0.2.2

Changed - 🔧 Simplified Installation

• Deferred Tool Installation: ADB and bore are no longer installed during package installation
  • Tools are now installed via bridgelink setup command
  • Reduces installation complexity and Homebrew/PPA build issues
  • Users have explicit control over when tools are installed
• Homebrew Formula Simplified: Removed post_install hook
  • No longer auto-installs bore during brew install
  • Users run bridgelink setup after installation
  • Fixes Xcode dependency issues on macOS
• Updated Quick Start: All installation methods now include bridgelink setup step

Fixed

• Fixed Homebrew installation failing due to Xcode version check
• Fixed certifi SHA256 mismatch in Homebrew formula
• Fixed PPA name in README (now ppa:himanshukukreja/bridgelink)

Documentation

• Updated README with bridgelink setup in all installation methods
• Clarified that bridgelink setup installs ADB and bore

BridgeLink v0.2.0

Added - 🔄 Auto-Activation Feature

• Auto-Activation: Devices can now automatically reconnect when plugged back in!
  • New --auto-activate flag for devices add command
  • New set-auto-activate on/off command to toggle for existing devices
  • Auto-activation preference stored per device in backend (auto_activate field)
  • Connection monitor daemon automatically detects newly connected devices
  • Auto-creates tunnels and updates backend without manual intervention
• Connection Monitor Daemon: New background service for auto-activation
  • Polls ADB for newly connected devices every 1 second (fast!)
  • Automatically starts when auto-activation is enabled for any device
  • Processes only devices with auto_activate: true preference
  • Logs to ~/.bridgelink/connection_monitor.log
• New API Endpoints:
  • PATCH /v1/bridgelink/devices/{serial}/auto-activate - Toggle auto-activation
  • GET /v1/bridgelink/devices/auto-activate/candidates - Get eligible devices
• Enhanced Device Listing: Shows auto-activation status with 🔄 indicator
• Comprehensive Documentation: Added AUTO_ACTIVATION_FEATURE.md with:
  • Feature overview and architecture
  • Usage examples and workflows
  • API documentation
  • Testing scenarios
  • Security considerations

Changed - ⚡ Performance Improvements

• 5x Faster Disconnect/Reconnect Detection: Reduced polling interval from 5s to 1 second
  • Health monitor now polls every 1s (was 5s)
  • Connection monitor polls every 1s (was 5s)
  • Devices disconnect detection: ~1s (was ~5s)
  • Devices reconnect detection: ~1-2s total (was ~5-7s)
  • Full disconnect/reconnect cycle: ~2-3s (was ~10-12s)
• Updated user messaging to reflect "fast detection" in both monitors

Backend Changes

• Database Schema: Added auto_activate: boolean field to device documents
  • Defaults to false for backward compatibility
  • Preserved across device activations/deactivations
• Service Functions:
  • update_auto_activate() - Update auto-activation preference
  • get_auto_activate_devices() - Get inactive devices with auto-activation enabled
• Route Handlers: Updated device endpoints to support auto-activation field

CLI Changes

• Added bridgelink.daemon.connection_monitor module
• Added bridgelink.daemon.connection_monitor_runner module
• Added bridgelink.daemon.background_connection_monitor module
• Updated bridgelink.utils.api_client with auto-activation methods
• Enhanced devices list command with auto-activation column
• Auto-start connection monitor when auto-activation is enabled

Documentation

• Updated README.md with auto-activation feature and 1s polling
• Added AUTO_ACTIVATION_FEATURE.md (400+ lines comprehensive guide)
• Updated all timing references from 5s to 1s throughout documentation
• Added use cases and testing scenarios for auto-activation

Fixed

• Improved responsiveness of disconnect detection (5x faster)
• Better user experience with near-instant device state updates

BridgeLink v0.1.1

Added

• Automatic Background Health Monitoring: Devices are now automatically monitored for connectivity
  • Daemon automatically starts when first device is added
  • Polls device health every 5 seconds (reduced from 30s)
  • Auto-detects and deactivates disconnected devices
  • Platform-aware health checks (physical devices vs emulators)
  • Daemon automatically stops when all devices are deactivated
• Background daemon manager (background_monitor.py)
• Monitor runner process (monitor_runner.py)
• Health monitoring state persistence (~/.bridgelink/monitor.pid, monitor.log)

Changed

• Health monitoring polling interval reduced from 30s to 5s for faster disconnect detection
• Device add/activate commands now automatically start health monitor daemon
• Device deactivate/daemon stop commands now automatically stop daemon when no devices remain
• Updated user messaging to reflect automatic monitoring
• Removed manual monitor CLI commands (now fully automatic)

Fixed

• Import errors in health monitor module
• API client initialization requiring API key parameter

Documentation

• Added comprehensive Automatic Health Monitoring section to README.md
• Created ARCHITECTURE.md with complete system architecture and data flows
• Updated feature list to highlight automatic monitoring
• Added health monitoring benefits and example flows

BridgeLink v0.1.0

Release version 0.1.0

Installation

pip install bridgelink