Skip to content

armgit / Piik

Public Imported from GitHub
0

Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

docs(browser): record v12 source boundary

AAAe558676544c6
diff --git a/docs/adr/0002-memory-resident-protected-rooms.md b/docs/adr/0002-memory-resident-protected-rooms.md
index ef948195..4065e4cc 100644
--- a/docs/adr/0002-memory-resident-protected-rooms.md
+++ b/docs/adr/0002-memory-resident-protected-rooms.md
@@ -169,15 +169,13 @@ the generic `SERVER_ERROR`. None of those paths is folded into
## Implementation Status
-Production runs exact deployed application/runtime revision
-`c4962f54443ad5f98bc65861195a3d9c74a48996`, release `c4962f5`; canonical
-`main` contains the same runtime code. Current source and production run the
-strict `screener-v11` wire and implement allocation, leases, orthogonal
-grant/code admission, rotate/revoke, password policy, local profile replay,
-restart loss, and browser-storage privacy. They still use the previous
-time-bearing 256-bit grant and neutral `ROOM_ACCESS_DENIED` result. The accepted
-22-character room-lived grant and `ROOM_NOT_FOUND` split belong to one strict
-`screener-v12` replacement and are not yet implemented or deployed.
+Canonical `main` contains exact source implementation
+`064db16c1b6d25fd24b7057b7e2fca172002e3c4` on the strict `screener-v12`
+wire. It implements the 22-character room-incarnation grant, exact digest
+validation, rotate/revoke, browser-storage privacy, and the `ROOM_NOT_FOUND`
+split without a v11 parser. Production remains exact deployed revision
+`c4962f54443ad5f98bc65861195a3d9c74a48996`, release `c4962f5`, on strict
+`screener-v11`; the v12 source has not been deployed.
Exact release and operational evidence remain owned by deployment and
verification status.
diff --git a/docs/adr/0005-automatic-hybrid-media-routing.md b/docs/adr/0005-automatic-hybrid-media-routing.md
index f0eaea2e..4df901b0 100644
--- a/docs/adr/0005-automatic-hybrid-media-routing.md
+++ b/docs/adr/0005-automatic-hybrid-media-routing.md
@@ -2,7 +2,9 @@
- Status: The route model is accepted and deployed in exact release `c4962f5`,
including Browser SFU ICE-server isolation and owner physical fallback proof;
- removal of the product diagnostic-download UI is accepted for v12 and pending.
+ exact source `064db16c1b6d25fd24b7057b7e2fca172002e3c4` removes the product
+ diagnostic-download UI for v12 while retaining the Host-only acceptance
+ snapshot, but that source is not deployed.
- Date: 2026-08-20
- Last updated: 2026-08-24
diff --git a/docs/project-memory.md b/docs/project-memory.md
index 489385df..24e74357 100644
--- a/docs/project-memory.md
+++ b/docs/project-memory.md
@@ -28,19 +28,19 @@ Last updated: 2026-08-24
## Current Source And Production
-- Production and canonical `main` run exact deployed application/runtime revision `c4962f54443ad5f98bc65861195a3d9c74a48996`, release `c4962f5`, on the single strict `screener-v11` Browser wire; auxiliary branches or older worktrees do not supersede canonical `main`.
+- Production is exact revision `c4962f54443ad5f98bc65861195a3d9c74a48996`, release `c4962f5`, on strict `screener-v11`. Canonical `main` contains source implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4` on strict `screener-v12`.
- Current source and production admit up to `20` Viewers and implement the uniform `1/2/3` endpoint cap, exact prepare candidate, first-decoded-frame commit, strict rollback revision, decoded-progress stall, a two-stage direct/SFU operation deadline, and one event-driven room controller. A short-lived exact-generation decoded-frame observer proves only the pending candidate inside the existing total deadline; the periodic stats sampler remains responsible for active-path diagnostics and stalls. Ordinary peer ICE is STUN-only and the sole application fallback is SFU/UDP; stale TURN environment keys fail startup. SFU admission uses exact publication and Viewer-subscription handles with explicit no-default ingress/egress capacities and a listener-fenced dedicated LiveKit owner. Browser SFU publisher/subscriber connects use fresh empty ICE-server options; the owner physically verified deployed SFU fallback media after release `c4962f5`, closing the prior core-route hold.
-- Current source and production use random four-digit memory rooms, dormant leases, exact-Host resume, restart loss, local preference replay, orthogonal grants/code entry, and no SQLite runtime. They still use the time-bearing 256-bit grant and neutral missing-room denial. Accepted `screener-v12` makes grants 22-character/room-lived, adds `ROOM_NOT_FOUND`, removes product diagnostic-download buttons, and compacts invitation UI; it is not implemented or deployed.
+- Both use random four-digit memory rooms, dormant leases, exact-Host resume, restart loss, local preference replay, orthogonal grants/code entry, and no SQLite runtime. V12 source uses a 22-character room-incarnation grant, `ROOM_NOT_FOUND`, no diagnostic-file export, and a compact UI showing the complete shorter URL. Production v11 retains the prior grant and UI until an authorized atomic release.
- Exact production artifacts, services, ports, and any change-scoped infrastructure recovery boundary are owned by [deployment](./deployment.md) and indexed by [status](./status.md).
-- Current source and production require v11, fix Browser direct, browser-relay, and SFU media to VP8, leave video `contentHint` unset, and contain no codec UI, quality state, wire field, fallback media codec, or share-lifetime codec branch. Both use `shareGeneration`-fenced Pause/Resume and implement live 64/128/256 kbps audio-ceiling mutation, typed first-frame Viewer presentation, privacy-safe on-demand route diagnostics, neutral room-code denial, responsive entry controls, exactly three recommended profiles with `1080p30` as default and advanced-only `854x480`.
+- Current source requires v12 and production requires v11; both fix Browser direct, browser-relay, and SFU media to VP8, leave video `contentHint` unset, and contain no codec UI, quality state, wire field, fallback media codec, or share-lifetime codec branch. Both use `shareGeneration`-fenced Pause/Resume and implement live 64/128/256 kbps audio-ceiling mutation, typed first-frame Viewer presentation, exactly three recommended profiles with `1080p30` as default, and advanced-only `854x480`. Current source additionally binds Host and SFU publisher audio metrics to the exact current sender track.
- Browser SFU subscribers reconcile eligible Host screen publications across connect/activate event ordering, participant/track arrival, and reconnect. Production LiveKit logs only warn/error, and the application service has a bounded same-host LiveKit readiness preflight.
-- Browser SFU ICE-server isolation implementation `ae09c760adec76fd26da611d4928486d105c6d3b` passed TypeScript, all 605 Web tests in 45 files, both production builds, repository hygiene, independent review, deployment postflight, and owner physical SFU fallback proof.
+- Browser v12 implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4` passed TypeScript, 604 Web tests, both builds, the 255-test SFU gate, Chrome access/privacy and 20-Viewer gates, repository hygiene, review, and responsive visual checks. It is not deployed; the earlier SFU fix retains owner physical proof.
- Chrome loopback, cap2/cap3, short resource, recovery, MBB, and A/V fixtures are bounded evidence only. They do not establish quality, resource limits, or product policy.
## Current Priority
-1. Bind audio stats to the exact current audio track across ordinary Host and SFU publisher reports, then physically validate the `1 kbps` report and live audio ceilings without confusing a configured ceiling with observed bitrate.
-2. Implement the single `screener-v12` room/UI contract: room-lived 22-character grant, explicit `ROOM_NOT_FOUND`, no product diagnostic-download buttons, and compact copy-first Host invitation controls.
+1. After explicit owner instruction, deploy the exact strict-v12 source atomically and run bounded postflight plus invitation/access/direct/SFU smoke checks.
+2. Physically validate the corrected `1 kbps` audio observation and live audio ceilings with audible content across direct, browser-relay, and SFU paths.
3. Then physically validate exact direct, browser-relay, and SFU codec behavior on the deployed Browser release and finish real-network route acceptance. Browser VP8 hardware acceleration and mobile Viewer lifecycle remain Accepted Later; Native/executable, distribution, and repository-wide simplification remain later phases.
The desktop Host background/minimized report is deferred until it reproduces on current production with a real game and synchronized media plus CPU/GPU evidence. The bounded current-Chrome screening found no immediate Host-page lifecycle drop, and removal of the old harmful `contentHint = "motion"` remains a plausible confound rather than a proven background fix. Mobile Viewer playback and assigned-relay survival remain a separate lifecycle gate.
diff --git a/docs/session-handoff.md b/docs/session-handoff.md
index e0a2a8b9..b1b73de8 100644
--- a/docs/session-handoff.md
+++ b/docs/session-handoff.md
@@ -48,18 +48,19 @@ Current high-signal boundary:
boundary specifically requires them.
- ADR-0002 owns the room model: one process-memory RoomStore, random free
four-digit codes, configurable 24-hour dormant leases, restart loss, local
- Host preference replay, and open/password/disabled code entry. Accepted next
- wire `screener-v12` replaces the current time-bearing grant with one 22-character
- room-lived opaque grant, adds `ROOM_NOT_FOUND`, removes product diagnostic
- download buttons, and compacts Host invitation controls; the Host-only
- bounded snapshot remains for acceptance tooling. Current source and production remain
- v11 until that batch is implemented and deployed atomically. Neither source
- nor production uses SQLite; exact release operations and change-scoped
- infrastructure recovery are owned by deployment.
+ Host preference replay, and open/password/disabled code entry. Canonical
+ `main` contains exact v12 source implementation
+ `064db16c1b6d25fd24b7057b7e2fca172002e3c4`: a 22-character room-lived
+ opaque grant, `ROOM_NOT_FOUND`, exact-current audio stats, no product
+ diagnostic download, and complete shorter invitation URLs. The Host-only
+ bounded snapshot remains for acceptance tooling. Production stays exact
+ `c4962f5` on v11 until an explicitly authorized atomic application release.
+ Neither source nor production uses SQLite; exact release operations and
+ change-scoped infrastructure recovery are owned by deployment.
- Browser display video must leave `contentHint` unset; audio keeps `music`.
- Browser video is fixed VP8 across direct, browser-relay, and SFU paths; the
- current strict v11 source and production have no codec UI/state/wire or
- fallback media codec. Automated source gates and deployment postflight passed,
+ Browser video is fixed VP8 across direct, browser-relay, and SFU paths; strict
+ v12 source and v11 production have no codec UI/state/wire or fallback media
+ codec. Automated source gates and the existing deployment postflight passed,
but no physical direct, browser-relay, or SFU codec path has been verified.
- Ordinary browser ICE owns direct reachability. Do not build port prediction,
guessed candidates, NAT classification, TCP probes, quality scores, or
diff --git a/docs/status.md b/docs/status.md
index f4ccab07..c28e7c45 100644
--- a/docs/status.md
+++ b/docs/status.md
@@ -17,21 +17,20 @@ This is the current execution index. Git history owns completed timelines; [veri
## Current Source
-- Canonical root `main` is the integration truth; auxiliary branches and older worktrees do not supersede it. Current source equals deployed application revision `c4962f54443ad5f98bc65861195a3d9c74a48996`, keeps strict Browser `screener-v11`, rejects every other wire before room authority, and includes Browser SFU ICE-server isolation implementation `ae09c760adec76fd26da611d4928486d105c6d3b`.
-- Current source implements one Host plus up to `20` Viewers, one steady outbound media-copy cap for every non-server endpoint (default `2`, static `1/2/3`), and the process-memory room model with random four-digit codes, a default 24-hour dormant lease, exact-Host resume, restart loss, local Host preference replay, independent token invitations, `open | password | disabled` code entry, and no SQLite runtime.
+- Canonical root `main` is the integration truth; auxiliary branches and older worktrees do not supersede it. Current source contains exact implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4` on the single strict Browser `screener-v12` wire and rejects every other wire before room authority. Production remains the older exact v11 revision stated above.
+- Current source implements one Host plus up to `20` Viewers, one steady outbound media-copy cap for every non-server endpoint (default `2`, static `1/2/3`), and the process-memory room model with random four-digit codes, a default 24-hour dormant lease, exact-Host resume, restart loss, local Host preference replay, `open | password | disabled` code entry, and no SQLite runtime. Its Viewer grant is one 22-character opaque value bound to the exact room incarnation; unallocated/reclaimed/expired code-only entry returns `ROOM_NOT_FOUND` without a password prompt.
- One event-driven controller owns the committed graph and at most one room-serial child operation. It uses one deterministic candidate list/cursor and one total direct-then-SFU deadline; exact admission and physical resources remain charged through drain, and the pending candidate commits only after an exact-generation decoded-frame proof. A short-lived 100 ms stats observer proves only that candidate inside the existing deadline, while the 2-second sampler remains responsible for active-path diagnostics and decoded-frame stalls. Healthy edges remain sticky and current-path quality does not authorize reparenting.
- Ordinary peer ICE is STUN-only and the only application fallback is the dedicated LiveKit SFU over UDP. SFU generations use explicit no-default ingress/egress capacities, exact `reserved | committed | draining` accounting, delete-plus-absence release, one Host publication, and exact Viewer subscription handles. No Screener TURN, ICE/TCP, media TCP, or TLS-relayed media route exists.
- Current Browser SFU publisher and subscriber connects supply fresh `autoSubscribe: false` plus `rtcConfig: { iceServers: [] }` options. Ordinary peers retain deployment STUN; LiveKit signaling candidates, server-side public-IP discovery, route deadlines, ports, and retry behavior are unchanged.
-- Current source leaves video `contentHint` unset and keeps audio `contentHint = "music"`. Browser direct and browser-relay offers contain VP8 as their only media codec, and SFU publication explicitly uses VP8 with no backup codec. Codec UI, quality state, wire fields, fallback media codecs, and share-lifetime codec branches are absent. Live 64/128/256 kbps audio-ceiling mutation and ordinary `shareGeneration`-fenced Pause/Resume remain unchanged.
-- Current source implements typed first-frame Viewer presentation and recovery, Chinese user-facing route/access failures, privacy-safe failed-page export, authenticated Host-only on-demand route snapshots, neutral `ROOM_ACCESS_DENIED` room-code admission, and responsive entry controls.
+- Current source leaves video `contentHint` unset and keeps audio `contentHint = "music"`. Browser direct and browser-relay offers contain VP8 as their only media codec, and SFU publication explicitly uses VP8 with no backup codec. Codec UI, quality state, wire fields, fallback media codecs, and share-lifetime codec branches are absent. Live 64/128/256 kbps audio-ceiling mutation remains unchanged; ordinary Host and SFU publisher metrics now select the exact current audio sender track and reset their baseline when that identity changes or disappears.
+- Current source implements typed first-frame Viewer presentation and recovery, Chinese user-facing route/access failures, local connection details without a diagnostic-file export, authenticated Host-only on-demand route snapshots for automatic acceptance, explicit missing-room presentation, and responsive entry controls. The Host invitation surface shows and copies the complete shorter URL and retains independent rotate/revoke, room-code, policy, and password controls.
- Recommended quality remains exactly `1080p60`, `1080p30`, and `720p30`; current source defaults to `1080p30`. Advanced resolution adds `480p` as `854x480` without adding a fourth preset, and advanced FPS and bitrate remain independent.
-- Exact v11 implementation `f5a295c52e0ac7d18e5a7949217861c7aa74e9c9` plus SFU isolation implementation `ae09c760adec76fd26da611d4928486d105c6d3b` are integrated into deployed revision `c4962f54443ad5f98bc65861195a3d9c74a48996`. Repository hygiene, TypeScript, all 605 Web tests, client/server builds, the 254-test SFU gate, deployment postflight, and owner physical SFU fallback proof passed. Exact results are owned by [verification status](./verification-status.md).
-- Accepted next source is one strict `screener-v12` contract with exact-current audio-track statistics, a 22-character room-lived Viewer grant, explicit `ROOM_NOT_FOUND`, no product diagnostic-download buttons, and a compact Host invitation surface. The Host-only bounded snapshot remains for automatic acceptance. None of that v12 batch is implemented or deployed at this checkpoint.
+- Exact v12 source implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4` passed repository hygiene, TypeScript, all 604 Web tests in 45 files, both production builds, the 255-test SFU gate, the Chrome access/privacy gate, a 20-Viewer Chrome loopback, focused independent review, and desktop/narrow/mobile invitation and missing-room visual checks. It is not deployed. Exact evidence boundaries are owned by [verification status](./verification-status.md).
## Current Milestone
-1. Fix the reported screen-audio `1 kbps` readout by binding ordinary Host and SFU publisher stats to the exact current audio track, then physically validate live audio ceilings.
-2. Implement the accepted `screener-v12` grant/access/UI contract: 22-character room-lived grant, `ROOM_NOT_FOUND`, no product diagnostic-download buttons, and compact copy-first Host invitation controls.
+1. After explicit owner instruction, release the exact v12 source atomically and verify stale-wire rejection, health, invitation/access behavior, and unchanged direct/SFU operation; no deployment has occurred at this checkpoint.
+2. Physically validate the corrected live screen-audio statistics and 64/128/256 kbps ceilings with known audible content across direct, browser-relay, and SFU paths.
3. Physically verify fixed-VP8/no-video-hint direct, browser-relay, and SFU paths from actual codec, capture, outbound, and decoded stats.
4. Finish representative ICE/STUN/SFU acceptance including mobile networks. Browser port prediction, NAT classification, TCP probing, fake page keepalive, and quality-driven reparenting remain outside the accepted model.
@@ -41,7 +40,7 @@ This is the current execution index. Git history owns completed timelines; [veri
- The desktop Host background/minimized report is deferred until a current-production real-game reproduction supplies synchronized media and CPU/GPU evidence. Mobile Viewer background playback and relay survival remain a separate Accepted Later lifecycle gate.
- Open PR #192 and the Native stack are evidence/research, not pending product releases. Native senders, capture helpers, shared-encode executables, and their test binaries are outside the current Browser milestone and are not built or run.
- Deployed surfaces and retained candidates that still need product decisions are indexed only in [the TODO ledger](./todo.md); do not extend or roll them back automatically.
-- Room lifetime, authorization/storage semantics, restart loss, entry/presentation, and Browser v11 remain aligned between source and production. The accepted v12 room/access/UI change stays source-pending until implemented and later deployed atomically. The prior application-only cutover reused unchanged infrastructure and configuration and does not maintain a full rollback/configuration backup; any future infrastructure or irreversible-state change requires recovery scoped to the surfaces it actually changes.
+- Room lifetime, authorization/storage semantics, restart loss, and routing remain aligned, while current source is strict v12 and production remains strict v11 until an explicitly authorized atomic application release. The prior application-only cutover reused unchanged infrastructure and configuration and does not maintain a full rollback/configuration backup; any future infrastructure or irreversible-state change requires recovery scoped to the surfaces it actually changes.
- Real SFU recovery, heterogeneous networks, mobile lifecycle, audio/A-V device behavior, and endurance/resource measurements remain external acceptance evidence, not blockers for unrelated reversible work.
## Current Hold
diff --git a/docs/todo.md b/docs/todo.md
index 96cbe1d7..c8878f89 100644
--- a/docs/todo.md
+++ b/docs/todo.md
@@ -6,8 +6,8 @@ Only items in **Now** are executable after their stated decision gate. A branch
## Now
-1. **Fix and physically validate live screen-audio statistics.** Bind ordinary Host and SFU publisher audio stats to the exact current sender track, merge the SFU video/audio reports, and reset the baseline when the audio identity changes or disappears. Then reproduce the reported `1 kbps` state with known audible content and switch the 64/128/256 kbps ceilings across direct, browser-relay, and SFU paths while checking sender/receiver counters, route continuity, audible result, and A/V synchronization. A real muted/idle track may legitimately use about 1 kbps; do not multiply the value or display the configured ceiling as observed bitrate.
-2. **Implement the accepted Browser v12 room/access/UI contract.** Replace the time-bearing 256-bit Viewer grant with a 22-character 128-bit opaque grant whose digest belongs to the exact room incarnation, remove independent grant expiry fields, add `ROOM_NOT_FOUND` for unallocated/reclaimed/expired code-only entry without a password prompt, remove Host/Viewer diagnostic-download buttons and browser file export, and show the shorter full URL in a compact copy-first Host invitation layout. Preserve the Host-only bounded route snapshot used by automatic acceptance, plus copy-room-code, `open | password | disabled`, password, rotate, revoke, fragment/sessionStorage privacy, and strict atomic wire replacement; do not retain a v11 parser or add a short-link store.
+1. **Deploy Browser v12 only after explicit owner instruction.** Current source implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4` already contains the strict v12 grant/access/UI and exact-audio-stat changes; production remains exact `c4962f5` on v11. A release must switch server and Browser assets atomically, reject stale v11 before room authority, run bounded health/postflight checks, and verify the shorter complete invitation URL, rotate/revoke, code-only missing-room result, direct media, and SFU fallback. This is an application-only release unless its scope is explicitly expanded.
+2. **Physically validate live screen-audio statistics.** The source fix binds ordinary Host and SFU publisher audio stats to the exact current sender track, merges SFU video/audio reports, and resets the baseline when audio identity changes or disappears. After deployment, reproduce the reported `1 kbps` state with known audible content and switch the 64/128/256 kbps ceilings across direct, browser-relay, and SFU paths while checking sender/receiver counters, route continuity, audible result, and A/V synchronization. A real muted/idle track may legitimately use about 1 kbps; do not multiply the value or display the configured ceiling as observed bitrate.
3. **Physically validate fixed Browser VP8 with no video hint.** Production exact deployed application/runtime revision `c4962f54443ad5f98bc65861195a3d9c74a48996`, release `c4962f5`, runs strict v11, VP8-only direct/browser-relay offers, VP8 SFU publication with no backup codec, unset video `contentHint`, and no codec UI/state/wire. Confirm actual codec, capture, outbound, and decoded stats on direct, browser-relay, and SFU paths; automated gates and the owner SFU connectivity proof do not close the full codec gate.
4. **Finish real-network route acceptance.** Measure standard ICE/STUN direct paths, peer relay, SFU ingress/subscription, exact first-frame commit and rollback, relay-ingress repair with subtree retention, disconnect/capacity drain, Pause/Resume, and bounded explicit failure across representative IPv4/IPv6 NATs and mobile networks. Include an all-UDP-blocked case to establish the current failure boundary. Do not add port prediction, NAT classification, TCP probes, guessed candidates, route scores, or quality-driven reparenting.
diff --git a/docs/verification-status.md b/docs/verification-status.md
index d204d527..5023397b 100644
--- a/docs/verification-status.md
+++ b/docs/verification-status.md
@@ -18,6 +18,7 @@ Capacity and routing entries below describe the exact tested source or release o
## Retained Functional Evidence
+- Exact v12 source implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4` passed repository hygiene, TypeScript typecheck, all 604 Web tests in 45 files, client and server production builds, the 255-test SFU admission gate in 10 files, the explicit-Chrome access/privacy gate, and the Chrome 20-Viewer loopback gate. Independent reviews found no remaining blocker. Real Chrome checks at 1440, 600, and 390 CSS pixels showed the complete 53-character local invitation URL without overflow; the 390-pixel room-password control stayed collapsed until requested and its editor fit when opened. A missing well-formed room showed `房间不存在或已过期`, no password control, and no horizontal overflow. This validates the current source contract and responsive surface only; it is not deployment, physical screen-audio, public-network, or real-SFU evidence.
- Exact v11 implementation `f5a295c52e0ac7d18e5a7949217861c7aa74e9c9`, integrated with the SFU isolation fix into deployed application/runtime revision `c4962f54443ad5f98bc65861195a3d9c74a48996` and canonical `main`, passed TypeScript typecheck, all 605 Web tests in 45 files, client and server production builds, the 254-test SFU gate in 10 files, and the access/privacy gate with explicit Chrome. This validates source structure, strict-wire behavior, fixed-VP8 path configuration, build output, and the covered Browser gate only; it does not provide full physical direct/browser-relay/SFU codec evidence.
- Exact Browser SFU ICE-server-isolation implementation `ae09c760adec76fd26da611d4928486d105c6d3b` passed repository hygiene, TypeScript typecheck, all 605 Web tests in 45 files, client and server production builds, three independent code reviews, focused 95-test publisher/subscriber and ordinary-peer isolation coverage, deployment postflight, and owner physical SFU fallback media proof. This establishes the reported production connection fix without turning candidate type/count into an invariant; full route/codec/network acceptance remains open.
- A fresh canonical `main@c4962f5` background gate passed repository hygiene, all 605 Web tests, both production builds, the 254-test SFU admission suite, and the Chrome 151 20-Viewer 720p30/30-second local route gate. All 20 Viewers advanced decoded frames, Host and relays stayed within endpoint cap `2`, no orphan SFU publication appeared, and all four current-child timing distributions contained 20 values. The browser gate uses deterministic canvas and does not start LiveKit, so it proves local direct/browser-relay control and media behavior only; it is not physical capture or SFU evidence.
@@ -35,11 +36,11 @@ Capacity and routing entries below describe the exact tested source or release o
- Routing: exact v10 local direct loopback remains historical evidence for admission-20 initial ingress and exact-candidate first-frame commit timing on that source. Current v11 production still needs physical direct, browser-relay, and SFU codec verification, together with route rollback, direct-stage exhaustion and SFU admission, relay-ingress reparent with subtree retention, disconnect/effective-capacity drain, pause/resume, and bounded failure on real browser/media paths. Silent control partitions may wait 30 to 60 seconds for heartbeat detection before the default five-second grace; a non-paused decoded-frame stall may invalidate only that exact child edge.
- Quality: production startup blur remains unclassified. One same-`balanced` local A/B retained route/PC/SSRC/track while 720p rose to 1080p, but natural ramp prevents causal, production, or SFU conclusions. Correlate Host capture/encode/send with Viewer receive/decode before changing policy.
- Host background: deferred until the report reproduces on exact production with a continuously changing real game or replay, a separate direct wired Viewer, synchronized capture/outbound/inbound plus CPU/GPU evidence, and repeated focused/unfocused/hidden/minimized windows. The current-Chrome Browser `getDisplayMedia()` WPF-window screening did not observe an immediate Host-page media drop, and the old harmful `contentHint = "motion"` release remains a plausible confound rather than a proven background cause. Current evidence authorizes no keepalive, Wake Lock, timer, codec switch, route change, or Native fallback.
-- Relay resources: current v11 source and production expose the authenticated `1/2/3` endpoint-cap boundary, and retained v10 local loopback evidence covers 20 Viewers at cap `2` only for that source. CPU/GPU/upload and heterogeneous-network measurements remain diagnostics, not authority to change the contract.
+- Relay resources: current source and production expose the authenticated `1/2/3` endpoint-cap boundary, and retained v10 local loopback evidence covers 20 Viewers at cap `2` only for that source. CPU/GPU/upload and heterogeneous-network measurements remain diagnostics, not authority to change the contract.
- Room scale: current source and production admit 20 Viewers plus one Host, and the retained v10 local Browser convergence gate covers that bound on direct loopback. A real public-network 1:20 session, quality, and sustained resource matrix remain open.
- SFU: production uses one Host publication with exact Viewer subscriptions and no fixed root-count or room-wide lease rule. Browser SFU PCs use the accepted empty-external-ICE-server rule and owner physical media proof closed the reported connection hold. Real LiveKit lifecycle/JWT replay, shaped packet-flow, BWE downshift/recovery, resource use, SFU-fed first-child behavior, and broader heterogeneous-network acceptance remain open. Use Linux `tc` or an authorized 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 deployed v11 Viewer stage, local stats/export plumbing, identity-bound relayed-detail retention, export freshness guards, and on-demand Host route snapshot remain current until the accepted v12 batch removes product download buttons and browser file export. The Host-only bounded snapshot stays for automatic acceptance. 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. All retained fields diagnose and have no recovery authority; they do not by themselves prove hardware encode, synchronization quality, or route quality.
+- Audio: current v12 source selects the exact active ordinary Host or SFU publisher audio sender and resets samples across track changes or absence. Physical verification of the 64/128/256 kbps settings, negotiated/observed bitrate, audible music quality, route changes, and game A/V synchronization remains open. Bitrate settings are ceilings, not quality proof, and a muted/idle Opus track may legitimately remain near 1 kbps.
+- Observability: current v12 source keeps local connection details but removes Host/Viewer diagnostic downloads and Browser file-export plumbing; production v11 retains its old surface until deployment. The Host-only bounded snapshot stays for automatic acceptance. 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. All retained 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: exact v11 implementation passed the access/privacy gate with explicit Chrome. Production passed atomic v11 application cutover/postflight plus stale-v10 rejection before authority. Restart-wide room loss, password-profile creation, grant/code orthogonality, rotate/revoke, memory-only runtime, and exact current journal/nginx sentinel checks retain their focused evidence. Headful same-browser preference replay and the isolated VM/IP clean-port matrix remain open; shared-IP smoke cannot approve them.
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 18a50b0d..fe1dbfbf 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"
@@ -2,7 +2,7 @@
## 2026-08-18 14:45
-状态:production 与 canonical `main` 运行精确 deployed application/runtime revision `c4962f54443ad5f98bc65861195a3d9c74a48996`、release `c4962f5` 和严格 `screener-v11`,包含 Browser SFU ICE-server isolation implementation `ae09c760adec76fd26da611d4928486d105c6d3b`;owner 已在生产实测 SFU fallback 成功取得画面。Browser display video 不设置 `contentHint`、audio 保留 `music`,唯一视频媒体 codec 为 VP8,UI、quality state/wire 和分享生命周期均没有 codec 分支。Pause/Resume 继续由当前 Host session 和 `shareGeneration` 约束。22 字符 room-lived Viewer grant、`ROOM_NOT_FOUND`、产品诊断下载移除与紧凑邀请 UI 已接受为单一 `screener-v12`,但尚未实现或部署。
+状态:canonical `main` 包含精确 source implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4` 和严格 `screener-v12`;production 仍运行精确 revision `c4962f54443ad5f98bc65861195a3d9c74a48996`、release `c4962f5` 与严格 `screener-v11`,v12 尚未部署。源码已实现 22 字符 room-lived Viewer grant、`ROOM_NOT_FOUND`、产品诊断下载移除、完整短 URL 邀请 UI、收敛的房间密码控件与 exact-current audio stats。源码和生产均固定 Browser VP8,video 不设置 `contentHint`、audio 保留 `music`,且无 codec UI/state/wire 或分享生命周期分支;Pause/Resume 继续由当前 Host session 和 `shareGeneration` 约束。Owner 已在生产实测现有 SFU fallback 成功取得画面。
## 目标与边界
@@ -360,7 +360,7 @@ Token-free SFU standby prewarm 保持可选且不创建 participant、publicatio
## 当前交付边界
-- Production 与 canonical `main` 运行精确 deployed application/runtime revision `c4962f54443ad5f98bc65861195a3d9c74a48996`、release `c4962f5`,包含 Browser SFU ICE-server-isolation implementation `ae09c760adec76fd26da611d4928486d105c6d3b`。两者使用严格单一 `screener-v11` wire;Browser 固定 VP8 且 video 不设置 `contentHint`,codec selector、quality-state/wire 字段与分享生命周期 codec 分支不存在。短 room-lived grant、明确 missing-room 结果、产品诊断下载移除与紧凑邀请 UI 仍是 accepted `screener-v12` design,尚未实现或部署。
+- Canonical `main` 包含精确 source implementation `064db16c1b6d25fd24b7057b7e2fca172002e3c4`,使用严格单一 `screener-v12` wire,并已实现短 room-lived grant、明确 missing-room 结果、产品诊断下载移除、完整短 URL 邀请 UI 与 exact-current audio stats。Production 仍运行精确 deployed application/runtime revision `c4962f54443ad5f98bc65861195a3d9c74a48996`、release `c4962f5` 和严格 `screener-v11`,v12 尚未部署。源码与生产均固定 Browser VP8 且 video 不设置 `contentHint`,codec selector、quality-state/wire 字段与分享生命周期 codec 分支不存在。
- Pause/Resume 由当前 Host session 和 `shareGeneration` 约束。Host 后台性能和 VP8 hardware acceleration 分别按受控根因证据诊断;标准 ICE/SFU 按真实异构网络验收。
- 当前发布面只包含 Web Host、Viewer 和 browser relay。Native sender、capture helper、shared-encode executable 与两个分发包仍由各自后续决策和物理证据驱动,不属于当前 Browser release。