67 Commits

Author	SHA1	Message	Date
Siavash Sameni	3220bd6151	fix: T3.2 status board — Committed → Pending Review	2026-05-12 06:14:07 +04:00
Siavash Sameni	e73f8a7150	T3.3: SignalMessage version field	2026-05-12 06:11:59 +04:00
Siavash Sameni	1b4f7b0772	T3.2: Document timestamp_ms monotonic across rekey + test	2026-05-11 21:19:03 +04:00
Siavash Sameni	f3398adb95	T3.1: RoomManager concurrency — Arc<RwLock<Room>> per room	2026-05-11 21:12:04 +04:00
Siavash Sameni	54c1a35186	T2.3-T2.6: BWE guard, relay conformance Tier A/B/C, Prometheus metrics	2026-05-11 20:50:22 +04:00
Siavash Sameni	3de56cf1f9	T2.2: BandwidthEstimator with cwnd/REMB target_send_bps	2026-05-11 19:16:25 +04:00
Siavash Sameni	fe1f9484bd	T2.1: Add SignalMessage::TransportFeedback	2026-05-11 19:06:45 +04:00
Siavash Sameni	0ef1f574ff	T1.8: Per-stream anti-replay window with configurable size	2026-05-11 16:56:09 +04:00
Siavash Sameni	b1c5837495	T1.7: Move QualityReport trailer inside AEAD payload	2026-05-11 16:42:25 +04:00
Siavash Sameni	6f81487778	T1.6: Protocol version negotiation in handshake	2026-05-11 15:53:04 +04:00
Siavash Sameni	5cdb50160a	T1.5.2: Workspace clippy hygiene + document pre-existing debt	2026-05-11 12:59:14 +04:00
Siavash Sameni	30d26fc7f6	T1.5.1: Remove unwrap() from encode_compact	2026-05-11 12:57:35 +04:00
Siavash Sameni	c93d302656	T1.5: Migrate emit/parse sites to v2 wire format	2026-05-11 12:37:32 +04:00
Siavash Sameni	9680b6ff34	T1.4.1: Add rustdoc on MiniHeaderV2 and MiniFrameContextV2 public items	2026-05-11 11:38:04 +04:00
Siavash Sameni	6b15b8f97c	T1.1.2: Address review — fix remaining stale 272 audio tests references	2026-05-11 11:35:15 +04:00
Siavash Sameni	6385b93391	T1.2.1: Add rustdoc on MediaType variants and methods	2026-05-11 11:33:58 +04:00
Siavash Sameni	6eb94f079d	T1.1.1: Address review — add rustdoc on impl MediaHeaderV2 constants and methods	2026-05-11 11:32:00 +04:00
Siavash Sameni	5580b794a4	T1.1.2: Refresh stale test-count figures in docs	2026-05-11 11:29:18 +04:00
Siavash Sameni	7c9ede9227	T1.1.1: Add rustdoc on MediaHeaderV2 fields	2026-05-11 11:22:21 +04:00
Siavash Sameni	e8866c6632	T1.4: Add v2 MiniHeader with seq_delta	2026-05-11 11:18:15 +04:00
Siavash Sameni	8c6e88ea68	T1.3: Widen CodecId wire representation to u8	2026-05-11 11:11:42 +04:00
Siavash Sameni	ffb92237be	T1.2: Add MediaType enum	2026-05-11 11:09:43 +04:00
Siavash Sameni	6af0539a72	T1.1: Add v2 MediaHeader type	2026-05-11 11:00:51 +04:00
Siavash Sameni	7b4bce69d5	docs: update all docs for hard NAT detection + relay wiring ... - PROGRESS.md: hard NAT Phase A, relay cross-wiring, 588 tests - ARCHITECTURE.md: hard NAT port prediction diagram + pattern table - PRD-p2p-direct.md: Phase 8.6 split into a/b/c/d with status - PRD-hard-nat.md: Phase A done, B signal ready, effort table updated - PRD-netcheck.md: port_allocation field + probe documented Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-14 11:33:12 +04:00
Siavash Sameni	ee14862376	docs: add PRD for hard NAT traversal (port prediction + birthday attack) ... 4-phase design: A. Port allocation pattern detection (sequential vs random) B. Sequential port prediction (~80% success, <2s) C. Birthday attack for random NATs (98% success, ~10s) D. Hybrid waterfall with background relay-to-direct upgrade Taskmaster tasks #84-87 added. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-14 11:20:19 +04:00
Siavash Sameni	f83361895e	docs: add PRDs for Phase 8 Tailscale-inspired features ... 5 new PRDs: - PRD-public-stun.md — RFC 5389 STUN client - PRD-portmap.md — NAT-PMP/PCP/UPnP port mapping - PRD-ice-regather.md — Mid-call ICE re-gathering - PRD-netcheck.md — Network diagnostic - PRD-relay-selection.md — Region-based relay selection Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-14 11:08:46 +04:00
Siavash Sameni	8fcf1be341	feat(nat): Tailscale-inspired STUN/ICE + port mapping + mid-call re-gathering (#28) ... Phase 8: 5 new modules bringing NAT traversal close to Tailscale's approach. - stun.rs: RFC 5389 STUN client — public server reflexive discovery, XOR-MAPPED-ADDRESS parsing, parallel probe with retry, STUN fallback in desktop try_reflect_own_addr() - portmap.rs: NAT-PMP (RFC 6886) + PCP (RFC 6887) + UPnP IGD port mapping — gateway discovery, acquire/release/refresh lifecycle, new PeerCandidates.mapped candidate type in dial order - ice_agent.rs: candidate lifecycle — gather(), re_gather(), apply_peer_update() with monotonic generation counter, CandidateUpdate signal message forwarded by relay - netcheck.rs: comprehensive diagnostic — NAT type, IPv4/v6, port mapping availability, relay latencies, CLI --netcheck - relay_map.rs: RTT-sorted relay map, preferred() selection, populate_from_ack() for RegisterPresenceAck.available_relays Relay: CallRegistry stores + cross-wires caller/callee_mapped_addr into CallSetup.peer_mapped_addr. Region config + available_relays populated from federation peers in RegisterPresenceAck. Desktop: place_call/answer_call call acquire_port_mapping() and fill caller/callee_mapped_addr. STUN+relay combined NAT detection. 571 tests pass (66 new), 0 regressions, 0 warnings. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-14 10:17:17 +04:00
Siavash Sameni	4471797edf	docs: update all PRDs and PROGRESS to current state (2026-04-13) ... Updated 6 PRDs with implementation status: - PRD-adaptive-quality: P2P quality done, bandwidth probing remains - PRD-protocol-analyzer: all 5 phases documented - PRD-relay-concurrency: DashMap + clone-before-send done - PRD-p2p-direct: P2P adaptive quality update - PRD-engine-dedup: all phases done - PROGRESS.md: test count 372+, 3 new change sections Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 16:40:56 +04:00
Siavash Sameni	ba12aae439	refactor: extract shared engine helpers, federation clone-before-send, constants ... Engine deduplication (PRD-engine-dedup.md): - build_call_config(): shared CallConfig construction (was 23 lines × 2) - codec_to_profile(): shared CodecId → QualityProfile mapping (was 19 lines × 2) - run_signal_task(): shared signal handler (was 48 lines × 2) - Net -39 lines from engine.rs, 6 duplicated blocks → single-line calls Quick wins from REFACTOR-codebase-audit.md: - 6 magic number constants extracted (CAPTURE_POLL_MS, RECV_TIMEOUT_MS, etc.) - DRED_POLL_INTERVAL moved from 2 local defs to 1 module-level const - federation.rs: forward_to_peers, broadcast_signal, send_signal_to_peer now clone peer list and release lock before sending (was holding Mutex across async I/O — last lock-during-send pattern eliminated) - main.rs: close_transport() helper replaces 12 silent .ok() calls with debug-level logging 314 tests passing, 0 regressions. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 15:22:44 +04:00
Siavash Sameni	fdb78e08bd	docs: full codebase refactoring audit with prioritized suggestions ... Comprehensive analysis across all 8 crates + Tauri engine covering: - engine.rs: 35% duplication between Android/desktop (350+ lines) - SignalMessage: 36 variants mixing orthogonal concerns - federation.rs: zero test coverage on 1,132 lines of complex logic - peer_links: lock held across async sends (last lock-during-I/O) - Magic numbers, error handling, CLI parsing, unsafe docs - Priority matrix: 10 items ranked by effort/impact/risk Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 12:35:59 +04:00
Siavash Sameni	3a51db998a	docs: relay concurrency refactor guide + PRD update for DashMap ... REFACTOR-relay-concurrency.md: complete post-DashMap analysis with current lock inventory, 4 prioritized suggestions (clone-before-send, peer_links DashMap, quality atomics, arc-swap snapshots), decision matrix, and concurrency diagram. PRD-relay-concurrency.md: updated to recommend DashMap as primary approach (was Option A per-room locks). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 12:27:26 +04:00
Siavash Sameni	a52b011fb5	feat(relay): replace global Mutex<RoomManager> with DashMap sharding ... Eliminates the single-lock bottleneck for media forwarding. Before: all participants across all rooms competed for one Mutex. Now rooms are stored in DashMap (64 internal shards with per-shard RwLocks). Changes: - RoomManager.rooms: HashMap → DashMap<String, Room> - Per-room quality tracking (qualities, current_tier moved into Room) - Arc<Mutex<RoomManager>> → Arc<RoomManager> everywhere - 20 .lock().await sites removed across room.rs, main.rs, federation.rs, ws.rs - federation forward_to_peers: clone peer list, release lock, then send - ACL uses std::sync::Mutex (rarely accessed, non-async) Concurrency improvement: - Before: 100 rooms × 10 people = 1000 tasks → 1 Mutex - After: distributed across 64 DashMap shards, ~15 tasks per shard avg - Rooms are fully independent — room A never blocks room B 314 tests passing, 0 regressions. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 12:17:57 +04:00
Siavash Sameni	2514151a89	docs: PRD for relay concurrency — per-room lock sharding ... Full analysis of relay lock contention with precise inventory of every lock acquisition in the hot path. Evaluates 4 design options: A) Per-room Arc<Mutex<Room>> (recommended — 100x improvement for multi-room) B) DashMap (good but less explicit) C) Channel-based fan-out (over-engineered for current scale) D) Snapshot-on-change via arc-swap (best perf, more complex) Phase 1: per-room locks, Phase 2: federation lock fix, Phase 3: quality tracking out of critical path. Estimated 1.5-2.5 days total. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 12:01:21 +04:00
Siavash Sameni	f265fd772d	docs: relay concurrency model, Opus6k fix, build script fixes ... - ARCHITECTURE.md: new "Relay Concurrency Model" section documenting threading, shared state locking table, scaling characteristics, and the RoomManager Mutex as primary bottleneck - PROGRESS.md: Opus6k frame starvation fix, build script fixes - PRD-dred-integration.md: Opus6k frame starvation bug documentation Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 11:54:37 +04:00
Siavash Sameni	d9e7e72978	docs: update PROGRESS, PRDs for completed tasks #9, #11, #12, #27 ... - PROGRESS.md: add 2026-04-13 section with 5-tier quality, QualityDirective handling, debug tap enhancements, dual_path fix, keystore sync - PRD-coordinated-codec.md: Phase 3 marked complete (client directive handling) - PRD-adaptive-quality.md: milestone table updated with Done/Pending status Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 11:34:01 +04:00
Siavash Sameni	ea5fc17c34	fix(relay): debug tap signal logging, dual_path test regression, PRD updates ... - Add log_signal() and log_event() to DebugTap for RoomUpdate, QualityDirective, join/leave lifecycle events (task #11) - Fix dual_path.rs Phase 7 regression: add missing ipv6_endpoint arg to 3 race() call sites - Update PRDs to reflect actual implementation status: mark adaptive quality, coordinated codec, P2P, network awareness, protocol analyzer - Update PROGRESS.md with QualityDirective gap and dual_path regression Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 09:54:52 +04:00
Siavash Sameni	d249b32ee5	test+docs: add tests for QualityDirective, ParticipantQuality; update docs ... - QualityDirective signal roundtrip tests (with/without reason) - ParticipantQuality unit tests (initial tier, degradation, weakest-link) - Updated PROGRESS.md with desktop adaptive quality, relay coordinated switching, Oboe state polling entries - Updated ARCHITECTURE.md SFU fan-out rules with QualityDirective - Updated PRD-coordinated-codec.md with implementation status - 312 tests passing across all modified crates Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-12 19:56:46 +04:00
Siavash Sameni	766c9df442	feat(dred): continuous DRED tuning, PMTUD, extended Opus6k window ... - DredTuner: maps live network metrics (loss/RTT/jitter) to continuous DRED duration every ~500ms instead of discrete tier-locked values. Includes jitter-spike detection for pre-emptive Starlink-style boost. - Opus6k DRED extended from 500ms to 1040ms (max libopus 1.5 supports) - PMTUD: quinn MtuDiscoveryConfig with upper_bound=1452, 300s interval - TrunkedForwarder respects discovered MTU (was hard-coded 1200) - QuinnPathSnapshot exposes quinn internal stats + discovered MTU - AudioEncoder trait: set_expected_loss() + set_dred_duration() methods - PathMonitor: sliding-window jitter variance for spike detection - Integrated into both Android and desktop send tasks in engine.rs - 14 new tests (10 tuner unit + 4 encoder integration) - Updated ARCHITECTURE.md, PROGRESS.md, PRD-dred-integration, PRD-mtu Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-12 19:38:37 +04:00
Siavash Sameni	300ea66d13	docs: update DESIGN, ARCHITECTURE, PRDs, PROGRESS for BT + network + build changes ... Reflects the current reality: setCommunicationDevice API 31+, deferred MODE_IN_COMMUNICATION, BT-mode Oboe (bt_active flag), per-arch builds, Hangup call_id fix, and network monitoring integration. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-12 17:39:59 +04:00
Siavash Sameni	4c1ad841e1	feat(android): Bluetooth audio routing + network change detection + per-arch APK builds ... Bluetooth: wire existing AudioRouteManager SCO support through both app variants. Replace binary speaker toggle with 3-way route cycling (Earpiece → Speaker → Bluetooth). Tauri side adds JNI bridge functions (start/stop/query SCO, device availability) and Oboe stream restart. Network awareness: integrate Android ConnectivityManager to detect WiFi/cellular transitions and feed them to AdaptiveQualityController via lock-free AtomicU8 signaling. Enables proactive quality downgrade and FEC boost on network handoffs. Build: add --arch flag to build-tauri-android.sh supporting arm64, armv7, or all (separate per-arch APKs for smaller tester binaries). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-12 16:07:41 +04:00
Siavash Sameni	56e3417063	docs: add PRD for DRED integration and Opus-tier FEC simplification ... Plans the libopus 1.5.2 upgrade (audiopus → opusic-c/opusic-sys), DRED enablement with tiered durations (100/200/500ms studio/normal/degraded), removal of RaptorQ and Opus inband FEC from the Opus tiers, jitter buffer lookahead/backfill refactor, and runtime escape hatch for rollout safety. RaptorQ + current ratios preserved on Codec2 tiers (no DRED there). Includes pre-flight verification findings: opusic-c Decoder inner pointer is inaccessible (requires unified opusic-sys DecoderHandle), libopus 1.5 DRED API semantics clarified against xiph/opus opus.h, wire-format backward compat verified on both live receive paths. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-10 19:57:01 +04:00
Siavash Sameni	a5c00fe5cb	docs: add BRANCH-desktop-audio-rewrite.md and update ARCH/ADMIN/USER_GUIDE ... Documents the feat/desktop-audio-rewrite branch story end-to-end: - Purpose: shared codebase with android-rewrite via Tauri, platform- specific audio backends via target-dep sections + feature flags - Audio backend matrix: CPAL baseline + macOS VPIO + Windows WASAPI AudioCategory_Communications - Recent work: desktop direct calling feature with history dedup, macOS VPIO integration, Windows cross-compile via cargo-xwin, the libopus/clang-cl vendored audiopus_sys fix, icon.ico generation, and the WASAPI communications capture backend (task #24) - Build pipelines: native cargo on macOS/Linux, Docker on SepehrHomeserverdk for Windows, Hetzner Cloud alternative - Testing procedures for direct calling parity and Windows AEC A/B - Known quirks: vendor path relative, cargo-xwin override.cmake clobber, WebView2 runtime prerequisite, 2024 edition unsafe lint warnings Also appends shared-doc sections (identical on both branches): - ARCHITECTURE.md: "Audio Backend Architecture (Platform Matrix)" - ADMINISTRATION.md: "Build Pipelines" - USER_GUIDE.md: "Direct 1:1 Calling" and "Windows AEC Variants" Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-10 15:20:21 +04:00
Siavash Sameni	2288c1ae07	feat: direct calling UI for desktop Tauri app + merge android branch ... Tauri backend: - register_signal: persistent _signal connection, presence registration - place_call: send DirectCallOffer by fingerprint - answer_call: accept/reject incoming calls - get_signal_status: poll signal state Frontend: - Mode toggle: "Room" vs "Direct Call" - Register button → registers on relay signal channel - Incoming call panel with Accept/Reject - Fingerprint input + Call button - Auto-connect to media room on CallSetup event Also merges feat/android-voip-client into desktop branch: - Federation fixes, time-based dedup, FEC stale blocks - Direct calling protocol types - ACL + SAS verification Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-09 06:42:47 +04:00
Siavash Sameni	54a4d91f3e	docs: add --event-log, --version-check, and federation troubleshooting to admin guide ... Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-09 04:43:37 +04:00
Siavash Sameni	b9f4e7f102	feat: include git hash in ntfy build notifications + MTU PRD ... ntfy messages now show: "WZP Linux [abc1234] ready!" and "WZP Android [abc1234] done! APK: url" so you can verify which commit was built without checking relay version remotely. Also added PRD-mtu-discovery.md for QUIC Path MTU Discovery. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-08 14:26:13 +04:00
Siavash Sameni	af4c89f5f0	docs: PRD for delegated trust in relay federation ... Addresses the trust gap where a hub relay can forward media from unknown relays without the receiving relay's consent. Introduces delegate=true flag on [[trusted]] entries: when set, the relay accepts media forwarded through the trusted peer from relays it vouches for. Without delegate, only direct media is accepted. Covers: FederationTrustChain signal, origin authorization checks, TTL for chain depth limiting, anti-spam properties. 5 phases, ~3 days. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-08 10:00:21 +04:00
Siavash Sameni	d9b2e0fd53	docs: comprehensive documentation — design, architecture, admin, user guide ... 4 files, 2,511 lines covering the entire WarzonePhone project: DESIGN.md (591 lines): system overview, codec system (9 variants), FEC (RaptorQ), transport (QUIC/quinn), security (Ed25519/X25519/ ChaCha20/HKDF/BIP39/TOFU), federation (global rooms), jitter buffer. Mermaid diagrams for audio pipelines and crate dependencies. ARCHITECTURE.md (874 lines): 15 mermaid diagrams — system overview, encode/decode pipelines, relay SFU, federation topology/protocol, signal handshake, client architectures (desktop/android/CLI), wire format tables (MediaHeader/MiniHeader/QualityReport), project tree. ADMINISTRATION.md (587 lines): relay deployment (binary/Docker/systemd), complete TOML config reference, CLI flags table, federation setup (peers/trusted/global_rooms), 3 example configs, Prometheus metrics, auth, identity persistence, 12-item troubleshooting guide. USER_GUIDE.md (459 lines): all clients — desktop (settings, quality slider, key warning, shortcuts), Android (8-level quality slider, server management, identity backup), CLI (flags table, 8 usage patterns). Identity system, quality profiles when-to-use guide. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-08 08:21:13 +04:00
Siavash Sameni	898c1ea32b	docs: PRDs for P2P direct calls and coordinated codec switching ... PRD-p2p-direct.md: STUN-based NAT traversal for direct QUIC connections between clients. True E2E with mutual TLS cert pinning via identity fingerprints. Hybrid mode: try P2P, fall back to relay. 4 phases: STUN discovery, hole punching, P2P adaptive quality, seamless relay-to-P2P migration. PRD-coordinated-codec.md: Relay acts as quality judge — monitors per-participant loss/RTT/jitter, sends quality directives. Downgrade is immediate (match weakest link), upgrade is consensual (all participants must agree, synchronized switch at agreed timestamp). Covers asymmetric encoding in SFU and P2P→relay backporting strategy. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-08 08:12:12 +04:00
Siavash Sameni	da84ed332c	docs: PRD for protocol analyzer — relay debug tap + full analyzer tool ... Two tools: 1. --debug-tap on relay: logs packet header metadata (seq, codec, ts, FEC, repair, size) per room without decryption. 0.5 day effort. 2. wzp-analyzer standalone: joins room as observer, decodes audio, shows TUI with per-participant waveforms + quality stats + FEC recovery rates. Capture/replay and HTML reports. 5-8 days total. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-08 05:57:27 +04:00
Siavash Sameni	b97f32ce46	docs: PRD for relay federation (multi-relay mesh) + identity fix ... Documents the relay TLS identity bug (cert regenerates on restart because server_config() creates a new keypair every time, ignoring the persisted Ed25519 seed) and the full federation design: - YAML config with mutual peer trust (url + fingerprint) - QUIC connections between peers, fingerprint verification - Room bridging: media forwarding for shared room names - Merged participant presence across relays - Helpful log message for unconfigured peer connection attempts - No transcoding, no re-encryption, no central coordinator Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-07 21:33:05 +04:00