Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
docs: record production 21d5 cutover (#184)
AAA27c11f5cda87
diff --git a/docs/adr/0005-automatic-hybrid-media-routing.md b/docs/adr/0005-automatic-hybrid-media-routing.mdindex aa3abdb0..dd8008d1 100644--- a/docs/adr/0005-automatic-hybrid-media-routing.md+++ b/docs/adr/0005-automatic-hybrid-media-routing.md@@ -437,11 +437,13 @@ unchanged severe or relative pair advances its own streak. Healthy or ambiguouscorrelated windows clear it. A Viewer or parent session,connection ID, route revision or parent identity change also resets it, as doesan evidence gap over five seconds. Severe and relative-FPS evidence each open at-most one peer-to-peer make-before-break attempt. The candidate is a Viewer whose-active upstream is peer or SFU, whose session/share/revision are current, and-whose effective relay capacity has one strict spare slot; Host remains excluded.-The candidate parent holds one provisional child `HostPeer` outside its active-child IDs/map. The old active edge and its connection ID remain authoritative+most one peer-to-peer make-before-break attempt. The candidate is either a Viewer+whose active upstream is peer or SFU, or the Host; its session/share/revision+must be current and its effective downstream budget must have one strict spare+slot. A Viewer candidate holds one provisional child `HostPeer` outside its+active child IDs/map; the Host owns an equivalent provisional child separately+from its active peers, SFU publication, and selected overlay, while Host2 remains+the physical-edge ceiling. The old active edge and its connection ID remain authoritativewhile the candidate uses a separate exact identity. The Viewer sends prepare-ready only after positive current-candidateRTP and decoded-frame progress plus a live video track; only then does the servercommit the planned topology and promote the same provisional PC plus candidate@@ -479,8 +481,8 @@ viewers cannot attach behind any healthy root, a later reviewed config mayadmit additional direct server-fed edges under a separate explicit egress cap;it never creates a third endpoint edge or unbounded whole-room fanout.-Sub-second media recovery remains a target after media failure detection. A-separate browser application challenge detects a silently partitioned signaling+Sub-second media recovery remains a target after media failure detection. The+deployed browser application challenge detects a silently partitioned signalingWebSocket on a bounded 5-second baseline plus two exact 2-second misses, thenreauthenticates on a new socket without asking ordinary P2P or duplicatesame-revision SFU media to close and without reporting `route-failed`. Existingdiff --git a/docs/deployment.md b/docs/deployment.mdindex 611cf8f9..4aed3255 100644--- a/docs/deployment.md+++ b/docs/deployment.md@@ -20,17 +20,17 @@ tracked coturn example remains `stun-only`; the shared host retains its olderauthenticated-relay daemon configuration and firewall range. The applicationdoes not pre-advertise TURN credentials to ordinary peers.-Production currently runs exact `aa870c51a57a51166a605c734cbb03263a72d12d`-from `/opt/screener/releases/aa870c51a57a`; immediate rollback is-`/opt/screener/releases/01a77ae331de`. Local and public health return 200;+Production currently runs exact `21d5cd9f7139e4a7719c5798bfc74a00f8bb5909`+from `/opt/screener/releases/21d5cd9f7139`; immediate rollback is+`/opt/screener/releases/aa870c51a57a`. Local and public health return 200;Screener, LiveKit, coturn, and nginx are active, and Screener reports`NRestarts=0`.The current release deploys the bounded pre-share health/WSS/STUN self-check,privacy-safe click-only diagnostic JSON export, room admission default eight-with explicit limits from one through sixteen, and peer-quality MBB. One-ordinary Viewer with a peer or SFU upstream may own the provisional child;-Host provisional children remain open. The endpoint-cap environment is unset,+with explicit limits from one through sixteen, bounded signaling-partition+recovery, and peer-quality MBB. An ordinary Viewer with a peer/SFU upstream or+the Host may own one separately budgeted provisional child. The endpoint-cap environment is unset,so the production default yields Host two and ordinary Browser Viewer one; thewire remains unchanged. The retained capacity-two/cap3 sixteen-Viewerand resource runs are historical ordinary-PC experiments only and do not define@@ -129,7 +129,7 @@ ICE. The accepted ladder is direct/peer UDP, then the revision-bound SFU/UDPvirtual parent, then optional authenticated TURN for one controller-selectedexceptional edge. LiveKit participants receive only revision-bound `sfu-config`URL/token messages and negotiate within LiveKit's separate ICE domain. The-selected-edge TURN config/wire is deployed in the current `aa870c51a57a` release with one+selected-edge TURN config/wire is deployed in the current `21d5cd9f7139` release with oneUDP URL and a 120-second credential TTL. It was not exercised by a real mediasession during this cutover.diff --git a/docs/project-memory.md b/docs/project-memory.mdindex 30569c02..bb9a754f 100644--- a/docs/project-memory.md+++ b/docs/project-memory.md@@ -28,7 +28,7 @@ Last updated: 2026-08-22- Mobile endpoints are Web Viewer-only. Current Android/iOS browsers do not expose Web Host capture; AirPlay/system mirroring is Viewer-local output.- ADR-0005: direct/peer UDP -> bounded SFU roots -> selected-edge TURN. The deployed controller caps each room at one `peer-selected` lease across negotiating and answered states; Host ingress is independent. Negotiation serializes with soft migration, while an answered exact lease is active transport and may coexist with unrelated soft MBB after route/session/share/topology/budget revalidation and carry-before-route authority. A pre-`ecc794d` exact-source/production-media canary proves active Host ingress only. Ordinary peers stay STUN-only.- `PEER_ASSISTED_MEDIA=true` covers all rooms. One-root healthy-SFU MBB is deployed with retained parent, media proof, Host2/browser1 overlap, cooldown and fresh two-window proof; it excludes `peer-selected`. Active-SFU loss uses normal recovery; the manual control keeps its route: peer restarts its edge, SFU reauthenticates signaling and rebuilds that subscriber. Capacity `0 -> 1`, multi-root/browser gates remain open.-- C+B stays edge-local: deployed MBB gives only the triggering child one attempt to an ordinary Viewer whose active upstream is peer or SFU while its old edge remains active; Host remains excluded. Current-generation RTP, decoded frames, and live video atomically promote the same provisional PC. A ready-then-failed identity survives until active/rollback, while session/share change or an unrelated authoritative failure aborts the soft probe. Failure, timeout, or no candidate keeps the old edge without SFU/TURN. Sibling MBB remains separate. No score.+- C+B stays edge-local: deployed MBB gives only the triggering child one attempt to a parent with one strict spare slot: an ordinary Viewer whose active upstream is peer/SFU, or the Host. The old edge stays active; current-generation RTP, decoded frames, and live video atomically promote the same provisional PC. Viewer and Host parents keep provisional children outside their active maps, with Host SFU publication and selected overlays charged to Host2. A ready-then-failed identity survives until active/rollback, while session/share change or an unrelated authoritative failure aborts the soft probe. Failure, timeout, or no candidate keeps the old edge without SFU/TURN. Sibling MBB remains separate. No score.- Flagship media is UDP; HTTPS/WSS stays TLS/TCP; the old release remains rollback-only.- Treat settings as ceilings and degradation as unclassified. Use correlated Host A+B/Viewer C and one-variable evidence; never force AV1, infer by UA, or create a composite score.- Screen audio: production Web capture requests speech processing off and ideal stereo. Share advanced settings offer 64/128/256 kbps sender ceilings, default 128, and lock the choice for the active share across P2P, browser relay, and SFU. Peer answers permit stereo up to 256 kbps; SFU keeps `forceStereo`, DTX off, and RED retained. Local Viewer details expose non-uploaded A/V playout, jitter-buffer, and concealment evidence. Target-browser/route proof remains open; voice and Native stay separate.@@ -43,12 +43,12 @@ Last updated: 2026-08-22## Current Implementation- The repository is one npm package using Node.js 24, React, TypeScript, Vite, native WebRTC, `ws`, Zod, Vitest, and separate coturn.-- Production: exact `aa870c51a57a51166a605c734cbb03263a72d12d`, release `aa870c51a57a`, Web wire `screener-v5`; `01a77ae331de` is the rollback release.+- Production: exact `21d5cd9f7139e4a7719c5798bfc74a00f8bb5909`, release `21d5cd9f7139`, Web wire `screener-v5`; `aa870c51a57a` is the rollback release.- Web keeps one SFU stream, clears unavailable video, exposes evidence-backed routes/transports and paused preview, and drops signals to a grace-retained offline current-edge target. Routing is automatic; entry/nickname UI is live; Native remains source-only.- Production rooms default to eight Viewers and accept an explicit admission limit from one through sixteen. The deployed release is Host2/ordinary Browser Viewer1 and accepts deployment 1/2 only as further tightening, without a UA/visibility split. The unchanged `0/1/2/3` relay-capacity wire is a future envelope, not current authority.-- Relay evidence is opt-in; direct proof and selected-pair addresses stay local, never in relayed evidence. The deployed pre-share self-check uses disposable health/WSS/STUN probes and reports configured SFU as unverified until a real route. Click-only diagnostic JSON uses a fixed privacy allowlist; neither path uploads or persists a report.+- Relay evidence is opt-in; direct proof, selected-pair addresses, and bounded same-pair STUN-response counters stay local, never in relayed evidence. The deployed pre-share self-check uses disposable health/WSS/STUN probes and reports configured SFU as unverified until a real route. Click-only diagnostic JSON uses a fixed privacy allowlist; neither path uploads or persists a report.- `screener`, LiveKit, coturn, and nginx are active; `screener` has `NRestarts=0`, local/public health are 200, and the endpoint-cap environment is unset so effective capacity is Host2/ordinary Browser Viewer1. SQLite v3 has five rooms, SHA-256 `aef724ae52c4107be8ec8791e72f8dcaa11b0ec849fb432d022e2cfb9cfe0974`, owner/mode `screener:screener`/0600.-- Production keeps ordinary ICE STUN-only, SFU roots <=2, selected-edge UDP TTL 120, and one `peer-selected` lease per room excluding Host ingress. Release `aa870c51a57a` deploys the root invariant and `dynacast: false`; real shaped LiveKit media, BWE, resource, SFU, TURN, and broader performance evidence remain open. Release `01a77ae331de` is retained for rollback. Earlier exact-`16f6eab` evidence proves active Host ingress only.+- Production keeps ordinary ICE STUN-only, SFU roots <=2, selected-edge UDP TTL 120, and one `peer-selected` lease per room excluding Host ingress. Release `21d5cd9f7139` deploys the root invariant, `dynacast: false`, Host-parent provisional probing, and the authenticated Web signaling-partition watchdog; real shaped LiveKit media, BWE, resource, SFU, TURN, and broader performance evidence remain open. Release `aa870c51a57a` is retained for rollback. Earlier exact-`16f6eab` evidence proves active Host ingress only.- Production requires independent `SITE_ACCESS_PASSWORD`: its stateless cookie authorizes creation/Host and code-only Viewer attempts; private grants stay direct, while public/private code entry needs site access alone/plus room password. Env/endpoint/cookie/nginx naming migrated atomically; failures remain neutral; there are no accounts/JWT/session rows. Local `gate:access-privacy` proves fragment isolation, site/grant transport-log absence, and raw room-password SQLite absence; room-password WebSocket/log ingress and live/headful evidence remain open.- Production uses nginx, Node.js 24.19.0, coturn 4.17.2, and LiveKit 1.13.5 on UDP 7882 (TCP fallback off). Ordinary peer ICE receives no TURN; the selected-edge tuple is configured only for the current controller edge, with no credential pre-advertised to ordinary peers. Coturn retains the old authenticated-relay ports. Services are healthy with zero restarts.- ADR-0005 rejects `PEER_ASSISTED_ROOM_IDS`; `PEER_ASSISTED_MEDIA=true` enables every room and ordinary peers stay STUN-only. Initial or active Host ingress may consume one bound relay-only grant; ready/abort clears it and failure restores peer baseline. Stale room-ID config fails startup. Production and source-only Native use `screener-v5`; Native does not subscribe to Web presence.diff --git a/docs/research/advanced-peer-distribution.md b/docs/research/advanced-peer-distribution.mdindex 5e2b58af..85ab0232 100644--- a/docs/research/advanced-peer-distribution.md+++ b/docs/research/advanced-peer-distribution.md@@ -214,10 +214,11 @@ limitation or at least 100 sent packets with remote loss divided by sent packetsat least 30%. Three consecutive windows of the same severe or relative kind arerequired. A healthy or incomplete correlated window, any Viewer/parent session,connection, route revision or parent change, or a gap over five seconds clears-the streak. Severe and relative-FPS quality evidence each tries one Viewer whose-active upstream is peer or SFU through make-before-break; Host is excluded, and-session/share/revision plus one strict effective-capacity slot are required-before breadth-first selection continues. No candidate, probe failure, or timeout keeps+the streak. Severe and relative-FPS quality evidence each tries one parent through+make-before-break: either a Viewer whose active upstream is peer/SFU or the Host.+Session/share/revision plus one strict effective-capacity slot are required+before breadth-first selection continues; Host accounting includes its active+children, SFU publication, selected overlay, and provisional child. No candidate, probe failure, or timeout keepsthe old edge without SFU, TURN, or an error. A started attempt spends a30-second room migrationbudget, so a new public Viewer identity cannot bypass it. Per-edge state clearsdiff --git a/docs/research/peer-assisted-media.md b/docs/research/peer-assisted-media.mdindex a0e5eb29..4e9257ab 100644--- a/docs/research/peer-assisted-media.md+++ b/docs/research/peer-assisted-media.md@@ -3,7 +3,7 @@- Research date: 2026-08-22- Scope: one game-screen broadcaster, explicit admission up to sixteen trustedviewers, with the retained resource/quality gate at eight-- Status: historical evidence plus the current bounded source candidate;+- Status: historical evidence plus the deployed bounded controller;accepted ADR-0005 owns automatic peer/SFU routing. Production later removedthe room-`1` rollout boundary; retained SFU media remains unverified.@@ -528,6 +528,8 @@ socket generation are ignored, and the server revalidates the currentauthenticated session before replying. A hidden document, a visibilityrestore, or an obviously late timer callback clears pending evidence and startsa fresh five-second baseline instead of declaring failure.+This response-only watchdog is deployed in release `21d5cd9f7139`; real silent+partition timing remains a production/browser evidence boundary.The response is socket-local, contains no room state, secret, candidate, or rawstatistics, is not logged, and is limited by the server to at most one responsediff --git a/docs/status.md b/docs/status.mdindex cc2f9327..0e96631c 100644--- a/docs/status.md+++ b/docs/status.md@@ -6,21 +6,21 @@ This file is the current execution index. Load [verification status](./verificat## Production-- `https://share.bonfire.icu` runs exact `aa870c51a57a51166a605c734cbb03263a72d12d`, release `aa870c51a57a`, wire `screener-v5`; `01a77ae331de` is the rollback release.+- `https://share.bonfire.icu` runs exact `21d5cd9f7139e4a7719c5798bfc74a00f8bb5909`, release `21d5cd9f7139`, wire `screener-v5`; `aa870c51a57a` is the rollback release.- `screener`, LiveKit, coturn, and nginx are active, local/public health return 200, and `screener` has `NRestarts=0`. SQLite remains schema v3 with five rooms and mode 0600.- Ordinary ICE is STUN-only. Production allows SFU roots <=2, one `peer-selected` lease across negotiating and answered states excluding Host ingress, selected UDP TTL 120, and room admission default eight with explicit limits from one through sixteen. `MAX_PEER_RELAY_DOWNSTREAM_EDGES` is unset, so effective downstream capacity is Host2/ordinary Browser Viewer1; active, provisional, selected, and Host SFU publication edges count. The wire remains `screener-v5`.-- Stable SFU, route/transport truth, pause notices, entry/nickname UI, selected-edge lease authority, corroborated bad-relay handling, Share audio presets, local media-path diagnostics, pre-share self-check, privacy-safe diagnostic export, and peer-quality MBB are live. An ordinary Viewer with a peer or SFU upstream may own one provisional child; Host provisional children and sibling MBB remain open. Native remains source-only.+- Stable SFU, route/transport truth, pause notices, entry/nickname UI, selected-edge lease authority, corroborated bad-relay handling, Share audio presets, local media-path diagnostics, pre-share self-check, privacy-safe diagnostic export, signaling-partition recovery, and peer-quality MBB are live. An ordinary Viewer with a peer/SFU upstream or the Host may own one separately budgeted provisional child; sibling MBB remains open. Native remains source-only.## Current Product Snapshot- Capture precedes room creation. Balanced, automatic codec, and 128 kbps screen audio are defaults; clarity/fluid, H.264/VP8, and 64/128/256 kbps audio are deployed next-share choices. Codec and audio quality lock during a share.- Local-only connection details expose current Host SFU sender evidence, actual codec/fmtp and encoder fields, media-source/encode FPS evidence, A/V playout/jitter/concealment evidence, and selected candidate endpoints. These fields do not enter quality signaling, server state, logs, persistence, or route selection.-- A source candidate additionally shows the selected pair's local cumulative STUN responses and a bounded same-pair sample delta. It is observation-only, is not deployed, and does not trigger recovery or upload the pair identity.+- Deployed local details additionally show the selected pair's cumulative STUN responses and a bounded same-pair sample delta. This remains observation-only and does not trigger recovery or upload the pair identity.- The deployed pre-share self-check uses disposable, no-room resources for health, WSS, and STUN `srflx` checks and treats configured SFU as unverified until a real route. Expanded connection details provide click-only, versioned JSON export; its fixed allowlist excludes candidate addresses/ports, participant and room identity, raw signaling, URLs, and credentials, and no report is uploaded or persisted.- Private fragment grants enter directly; code-only Viewers need site access and private rooms additionally need their password. Credentials remain unstored. Web names and presence are session-only; duplicate names alone show an ID suffix.- Rooms default to eight Viewers and accept an explicit admission limit from one through sixteen. Current source is server-authoritative and role-aware: Host physical media edges are bounded to two, ordinary Browser Viewer downstream edges to one, and upstream receive is free. Active/provisional/selected overlays count, as does Host SFU publication. Deployment values 1/2 may only tighten these limits; old/malicious Viewer advertisements 2/3 cannot lift them. Web assignment execution also truncates physical children to Host2/Viewer1 as defense-in-depth, and deployment limit one promotes an occupied Host branch root before reserving the SFU publication slot. The wire retains `0/1/2/3` only as a future envelope, and SFU roots remain separately bounded to two.- Production deploys the root <=2 controller/token invariant, Host-publication edge accounting, zero-child assignment/subscriber retention, and `dynacast: false` with ordered active `q,h`. Local `gate:sfu-root-invariants` proves that control-plane boundary; real shaped LiveKit packet flow, BWE downshift/recovery, and resource cost remain open.-- Relay quality handling compares fresh child FPS with parent input. Two-child corroboration is retained only for a future accepted capacity tier and is unreachable under the ordinary Browser Viewer1 release clamp. Deployed MBB keeps the triggering child's old edge while one ordinary Viewer with peer or SFU upstream and a strict spare slot owns the provisional child PC. Matching current-generation RTP, decoded frames, live video, revision, and identity promote that same PC; Host remains excluded. Failure, timeout, session/share change, or no candidate keeps the old edge without SFU/TURN. Sibling MBB remains open.+- Relay quality handling compares fresh child FPS with parent input. Two-child corroboration is retained only for a future accepted capacity tier and is unreachable under the ordinary Browser Viewer1 release clamp. Deployed MBB keeps the triggering child's old edge while an ordinary Viewer with peer/SFU upstream or the Host, each with a strict spare slot, owns a separate provisional child PC. Matching current-generation RTP, decoded frames, live video, revision, and identity promote that same PC; Host2 accounting includes its SFU publication and selected/provisional overlays. Failure, timeout, session/share change, or no candidate keeps the old edge without SFU/TURN. Sibling MBB remains open.- A generation-bound 15-second initial-connect deadline enters ICE restart. One-root healthy-SFU make-before-break is deployed but media-unverified; capacity `0 -> 1`, multi-root, browser, and mobile gates remain open.## Active Milestonediff --git a/docs/verification-status.md b/docs/verification-status.mdindex 3b0d7f1f..96968f81 100644--- a/docs/verification-status.md+++ b/docs/verification-status.md@@ -8,12 +8,12 @@ This is the demand-loaded ledger for cross-cutting validation evidence and open## Deployment Evidence-- Production runs exact `aa870c51a57a51166a605c734cbb03263a72d12d`, release `aa870c51a57a`, with `01a77ae331de` retained for rollback.+- Production runs exact `21d5cd9f7139e4a7719c5798bfc74a00f8bb5909`, release `21d5cd9f7139`, with `aa870c51a57a` retained for rollback.- Local/public health return 200; `screener`, LiveKit, coturn, and nginx are active; `screener` reports zero restarts. SQLite v3 has five rooms, SHA-256 `aef724ae52c4107be8ec8791e72f8dcaa11b0ec849fb432d022e2cfb9cfe0974`, owner `screener:screener`, and mode 0600.- Room admission defaults to eight and accepts explicit limits from one through sixteen. The endpoint-cap environment is unset, so the deployment default yields Host2/ordinary Browser Viewer1; active, provisional, selected, and Host SFU publication edges count. Ordinary peer ICE stays STUN-only, SFU roots stay <=2, and selected-edge UDP authority is bounded to one `peer-selected` lease per room excluding Host ingress.- The deployed SFU path enforces the controller/token root cap, Host-publication edge accounting, zero-child assignment/subscriber retention, and `dynacast: false`. The tagged local gate covers these invariants; real shaped LiveKit packet flow, BWE downshift/recovery, resources, and root-with-children behavior remain unverified.- Share audio presets and local-only Host SFU, codec/encoder, A/V, and selected-candidate diagnostics are deployed. Their target-browser field availability and actual media values remain unverified.-- The bounded pre-share self-check, privacy-safe local JSON export, and peer-quality MBB are deployed. An ordinary Viewer with a peer or SFU upstream may own the provisional child; Host provisional children and sibling MBB remain open. Real-route behavior remains part of the routing gate.+- The bounded pre-share self-check, privacy-safe local JSON export, signaling-partition recovery, and peer-quality MBB are deployed. An ordinary Viewer with a peer/SFU upstream or the Host may own a separately budgeted provisional child; sibling MBB remains open. Real-route behavior remains part of the routing gate.- Earlier exact-`16f6eab` evidence proves active Host ingress only; it does not prove the current release, initial Viewer ingress, healthy reselection, last-mile quality, or TURN performance.## Retained Functional Evidence@@ -33,7 +33,7 @@ This is the demand-loaded ledger for cross-cutting validation evidence and open- Relay resources: production is Host2/ordinary Browser Viewer1 and rejects any Viewer child2 regardless of advertised capacity. Two-child relay corroboration is therefore a future-capacity experiment, while the triggering child's edge-local MBB remains active. Relay CPU/GPU/upload cost and heterogeneous-network behavior remain unverified. Finish the role-aware matrix before the 20-viewer gate or any future capacity-tier change.- SFU: production deploys ordered `q,h`, roots <=2, and Dynacast off. Real zero-child shaped LiveKit packet flow, BWE downshift/recovery, resource cost, and root-with-children behavior remain open. Use Linux `tc` or a public canary for per-leaf shaping, never CDP throttling.- Audio: verify the 64/128/256 kbps Share settings, negotiated/observed bitrate, audible music quality, route changes, and game A/V synchronization. Bitrate settings are ceilings, not quality proof.-- Observability: the UI and local stats plumbing are deployed, but target-browser availability and actual values remain unverified for Host SFU sender evidence, codec/fmtp and encoder implementation/power efficiency, media-source and encoded FPS, A/V playout/jitter/concealment, and selected candidate endpoints. A source-only candidate adds bounded same-pair STUN-response observation without recovery authority. These fields diagnose; they do not by themselves prove hardware encode, synchronization quality, or route quality.+- Observability: the UI and local stats plumbing are deployed, but target-browser availability and actual values remain unverified for Host SFU sender evidence, codec/fmtp and encoder implementation/power efficiency, media-source and encoded FPS, A/V playout/jitter/concealment, selected candidate endpoints, and bounded same-pair STUN-response observation. These fields diagnose and have no recovery authority; they do not by themselves prove hardware encode, synchronization quality, or route quality.- Mobile: Android/iOS remain Viewer-only. Autoplay, rotation, iOS lock-screen/page reclamation, background reconnection, and network changes need device evidence. AirPlay/system mirroring is Viewer-local output, not a portable in-app WebRTC output contract.- Native: ADR-0006 has one-Viewer evidence only. Viewer2/FIFO, hardware diversity, endurance, downloaded-package/public-host, game A/V, and browser diversity remain open.- Access and operations: run headful/production checks for fragment consumption, rotate/revoke, and request/nginx/journal/SQLite leakage. The isolated VM/IP gate remains required before clean-port migration; shared-IP smoke cannot approve it.diff --git "a/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md" "b/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"index b234b665..36df2b79 100644--- "a/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"+++ "b/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"@@ -401,7 +401,7 @@ STUN-only;只有 controller-selected edge 可接收一次短期 grant。该边恢复目标按证据和成本逐级升级:短暂 `disconnected` 先观察同代 bytes/stats,`failed` 才执行一次 ICE restart;仍失败时重建一次相同 parent,再尝试不同的合格 peer parent,peer 候选耗尽后才申请 SFU。每个动作最多一次且成功即停,不实现“三次相同重试”。初始 `connecting`/`checking` 的软提示和硬窗口尚未实现;硬窗口必须先用移动网络实测确定,不能直接复用现有 3 秒恢复常量。Viewer SFU root 只刷新一次短期 grant,随后至多重建一次原 failed parent selected edge;Host publisher/global SFU failure 维持 bounded peer failback。Host 只保留当前 route revision 的 `connect | source | video-publish | sender-config | audio-publish | transport` 枚举阶段作为本地事件提示,不上传原始错误、URL、token、candidate 或地址。-当前 source candidate 实现一个由服务端确定的广度优先活动拓扑:Host 最多两个 child,普通 Browser Viewer 最多一个 child。服务器可在多个合格 parent 中选择,但每名 viewer 同时只有一个 active upstream,活动媒体图保持无环。新 viewer 加入或容量释放时只接纳等待节点;节点断开或当前 edge 失败时只重新分配失去 parent 的直接 subtree root,其 descendants 保持连接。客户端先关闭不再分配的旧 edge,再建立替代 edge;每次变更推进 route revision,stale signal/recovery 不得复活旧边。该规则不采集或组合 RTT、带宽、CPU、地理位置与质量评分,也不主动重平衡、多源接收或持续优化。没有 parent 时明确等待或拒绝,Host 不能创建第三条边,Browser Viewer 不能创建第二条边。+当前部署实现一个由服务端确定的广度优先活动拓扑:Host 最多两个 child,普通 Browser Viewer 最多一个 child。服务器可在多个合格 parent 中选择,但每名 viewer 同时只有一个 active upstream,活动媒体图保持无环。新 viewer 加入或容量释放时只接纳等待节点;节点断开或当前 edge 失败时只重新分配失去 parent 的直接 subtree root,其 descendants 保持连接。客户端先关闭不再分配的旧 edge,再建立替代 edge;每次变更推进 route revision,stale signal/recovery 不得复活旧边。该规则不采集或组合 RTT、带宽、CPU、地理位置与质量评分,也不主动重平衡、多源接收或持续优化。没有 parent 时明确等待或拒绝,Host 不能创建第三条边,Browser Viewer 不能创建第二条边。当前 Host2/Browser Viewer1 形成两条有界转发链;它满足发布资源边界,但不证明八人质量、更不证明 20 人能力。目标 20 人仍必须实测逐跳重编码、上行、延迟和故障半径,或使用受独立中央 egress cap 约束的 SFU 例外。未通过时保持当前默认八人,不增加 Host fanout 或绕过 Viewer 上限来凑容量。