Piik/docs/todo.md

Current TODO Ledger

Last reviewed: 2026-08-27

Only Now is executable. Observations, old branches, experiments, and parked topics are not implementation authority.

Now

1. Correct native-edge convergence. Require persistent degraded evidence, keep ordinary quality moves P2P-only, reserve SFU quality work for multi-edge Host fanout relief, require same-Viewer SFU non-regression before commit, and retain sanitized route-event evidence for the canary.

Parked Repository Work

1. Bounded mechanism simplification. Remove only the proved zero-consumer or duplicate owners: coarse mediaAssignment wire residue, legacy SFU room-name acceptance, orphan scripts/browser-codec-preflight.ts, and the access gate's test-title scan. Keep the production src/client/webrtc/video-codec-preflight.ts, live internal media-assignment helpers, and destructive-path safety gates.

Parked Product Work

1. Broader quality optimization. Weighted/global optimization, parent-wide prediction, startup-limited inference, and alternative SFU policies remain unaccepted. Reopen only from exact path evidence; do not add a score, all-pairs probe, periodic rebalancer, or ordinary SFU preference.
2. Mobile Viewer lifecycle. Run Android Chrome and iOS Safari matrices for autoplay, background audio, foreground recovery, lock/page reclamation, rotation, network migration, and relay survival.
3. Representative network acceptance. Complete public-network direct, Browser relay, SFU, recovery, Pause/Resume, screen-audio, real-game A/V, two-room SFU, 20-Viewer endurance, and all-UDP-blocked bounded failure.
4. Whole-product UI and bilingual decision. Review copy, responsive hierarchy, visual consistency, restrained motion, rendering cost, terminal navigation, and Chinese/English scope once media behavior stabilizes.
5. Client-input security review. Audit HTTP/WebSocket schema, auth, authorization, rate/body/resource bounds, errors, logs, and secrets without adding a parallel security framework.
6. Public-server package. Package the exact Web/signaling, STUN/SFU, proxy, secrets, health, and recovery contract for a user-owned server.
7. Fully local package. Package Host capture, application server, and local state for Windows/macOS/Linux with honest TLS, gateway, NAT, and firewall limits.
8. Native Host and shared encode. Revisit Windows first only after capture, hardware encode, audio, RTP feedback, resources, packaging, licensing, and Browser interoperability are proved.
9. Platform output. Revisit AirPlay/Cast only when a target Browser and physical receiver prove the live MediaStream contract.

Decision Needed

• Choose the repository and distribution license before public release or package distribution. GPL/AGPL implementations remain research-only until then.