init

docs/roadmap.md

@@ -0,0 +1,50 @@
+# MVP Roadmap
+
+## M0: Foundation
+
+- Repository metadata, license, contribution docs.
+- Android Gradle project and Rust workspace.
+- Domain model, engine interface, foreground service skeleton.
+- VSHP frame parser with unit tests.
+
+## M1: USB-First MVP
+
+- Android USB accessory transport.
+- Desktop USB host transport for Linux and Windows.
+- Encrypted pairing over USB with phone-side approval.
+- IPv4 TUN/Wintun virtual interface on desktop.
+- TCP, UDP, and DNS forwarding through the Android gateway.
+- Basic reconnection with session resume ticket.
+
+Acceptance:
+
+- A Windows or Linux laptop paired by USB can browse through the phone's active
+  VPN without manual proxy, route, DNS, or SSH setup.
+
+## M2: Desktop Productization
+
+- macOS utun support.
+- Installers and background service management.
+- Tray UI with connect/disconnect and status.
+- Peer revoke and rename UI on Android.
+- Crash-safe logs without traffic content.
+
+## M3: Wi-Fi and Hotspot
+
+- mDNS/DNS-SD discovery.
+- QR pairing for Wi-Fi.
+- LocalOnlyHotspot setup flow.
+- Automatic transport fallback between USB and Wi-Fi.
+
+## M4: Android Client
+
+- Android receiving-device app using its own `VpnService`.
+- QR pairing and one-tap connect.
+- Per-app include/exclude on receiving Android device.
+
+## M5: IPv6, Performance, and iOS
+
+- IPv6 upstream validation and route enablement.
+- MTU probing, MSS clamping, and adaptive buffers.
+- iOS Network Extension client.
+- Battery and throughput tuning on physical-device matrix.