Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
docs: record pending ingress deployment (#117)
AAA213b419bee7e
diff --git a/docs/deployment.md b/docs/deployment.mdindex 09f5bc6d..f0fccf1b 100644--- a/docs/deployment.md+++ b/docs/deployment.md@@ -20,20 +20,21 @@ 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 `22119b907d3cf03ce8b06d6fb4596ce1a26fedd7`+Production currently runs exact `16f6eab27bdfb1c15cdbd814a35864f4f18be767`on the existing shared public IP, with local/public health 200 and SQLite v3-integrity. The 660,626-byte artifact has SHA-256-`3cbd8f6be82fa615fa2861ff1be0eba6c98f3f7d9acb73a0ba5c21a2ff4c661c`.-The 2026-08-20T22:17:43Z UTC cutover held the deployment lock for 1,696 ms;-local health returned 508 ms after service stop (479 ms after the symlink+integrity. The 1,027,423-byte artifact has SHA-256+`74e0274ab11a162cb9dd4be1c34bb6b639e2ea76005969c30ae3a1daa656742f`.+The 2026-08-20T23:44:57Z UTC cutover held the deployment lock for 10,238 ms;+local health returned 641 ms after service stop (570 ms after the symlinkswitch). Screener, LiveKit, coturn, and nginx are active/running with-`NRestarts=0`. SQLite v3 contains five rooms including room `1`, with the+observed `NRestarts=0`. SQLite v3 contains five rooms including room `1`, with theservice owner/mode and database hash preserved. `SITE_ACCESS_PASSWORD`,`/api/site-access`, and the nginx limiter replaced their retired Host-admissionnames in the prior access cutover; this release preserved the environment hashand the old endpoint remains 404. Exact-`fd76277b05d491af8840b28f3132b7ff445d3cbe`-is the immediate rollback target.+`22119b907d3cf03ce8b06d6fb4596ce1a26fedd7`+is the immediate rollback target; exact `fd76277b05d491af8840b28f3132b7ff445d3cbe`+remains a secondary rollback.The selected-edge UDP tuple is configured with TTL 120, but no real TURN/SFUmedia canary was triggered; this remains a bounded configuration smoke, notbroad-rollout media acceptance.@@ -495,6 +496,27 @@ or performance canary ran. This deploys the `q,h` guard and preserves exact`fd76277b05d491af8840b28f3132b7ff445d3cbe` as the rollback release; the one-SFU-root functional evidence remains the separate localhost Chrome run.+The pending Host-ingress retry cutover used exact source+`16f6eab27bdfb1c15cdbd814a35864f4f18be767` and immutable artifact+`screener-16f6eab27bdfb1c15cdbd814a35864f4f18be767-20260820T233516Z-git.tar.gz`+(1,027,423 bytes, SHA-256+`74e0274ab11a162cb9dd4be1c34bb6b639e2ea76005969c30ae3a1daa656742f`).+Fresh `npm ci` plus the exact-source gate passed typecheck, both builds, and 30+test files/445 tests. The one lock-held cutover completed at+2026-08-20T23:45:02.296255986Z; the lock was held for 10,237.892 ms,+stop-to-health took 640.561 ms, and symlink-to-health took 570.188 ms. The new+release and exact `22119b907d3c` rollback share zero regular-file inodes.++Environment, nginx, LiveKit, coturn, nftables, listener, and SQLite hashes were+unchanged. SQLite v3 retained five rooms including room `1` with owner/mode+`screener:screener`/0600. Local/public health, root, room `1`, the built asset,+site-access status, and the retired-endpoint 404 passed; all four services were+active/running with their observed `NRestarts=0`. Backup+`/opt/screener/backups/16f6eab27bdf-precutover-20260820T234457Z` retains the+prior environment, database, and exact current target. This deploys the one-use+initial/active Host-ingress selected retry; no browser, SFU media, TURN relay,+or performance canary ran, so TURN transport remains unproved.+Enabling persistence does not migrate rooms that existed only in memory. Thedeployment restart invalidates those temporary links; the first subsequentlycreated persistent room receives ID `1`.diff --git a/docs/project-memory.md b/docs/project-memory.mdindex eca22a19..9f8839b1 100644--- a/docs/project-memory.md+++ b/docs/project-memory.md@@ -25,7 +25,7 @@ Last updated: 2026-08-21- Keep experiments bounded: the standard representation sequence is below; native RTP relay, encoded-object striping, and FEC remain separate.- ADR-0006's historical browser-bridge canary remains no-go; VP8 stays default. Browser H.264 rendered 298/299; Native WGC/MF rendered 203 with PID/LUID-correlated `VideoEncode`. Downloaded use, multi-viewer/endurance/public proof remain open.- Mobile Web Host unsupported. Android 14+ source has video and default-off selected-UID playback audio; no mic/system fallback. Device A/V, rotation and SFU remain open. iOS deferred; TV output is P2.-- ADR-0005 accepts direct/peer UDP, bounded SFU roots, then selected-edge TURN. Source grants one revision/publication/share/session-bound retry to initial or active Host ingress. Production has the tuple but no SFU/TURN media canary; participant-wide TURN stays rejected and ordinary peers stay STUN-only.+- ADR-0005 accepts direct/peer UDP, bounded SFU roots, then selected-edge TURN. Production grants one revision-bound, one-use retry for initial/active Host ingress. The deployed tuple/control path have no production SFU/TURN media canary; participant-wide TURN stays rejected and ordinary peers stay STUN-only.- The controller is process-enabled, not room-allowlisted: `PEER_ASSISTED_MEDIA=true` gives every normal room the same direct/peer -> SFU -> selected-edge path with per-room state. Room `1` is historical smoke. Preserve sticky P2P, mobile leaves and break-before-make; recovery gets one attempt per layer (ICE restart, same-parent rebuild, alternate peer, then SFU), never three identical retries.- C+B quality reparenting is edge-local and cooldown-bound; no score, timer, or global parent penalty.- Flagship media is UDP; HTTPS/WSS stays TLS/TCP; the old release remains rollback-only.@@ -42,9 +42,9 @@ Last updated: 2026-08-21## Current Implementation- The repository is one npm package using Node.js 24, React, TypeScript, Vite, native WebRTC, `ws`, Zod, Vitest, and separate coturn.-- Production is exact `22119b907d3cf03ce8b06d6fb4596ce1a26fedd7` at `https://share.bonfire.icu`; its 660,626-byte artifact SHA-256 is `3cbd8f6be82fa615fa2861ff1be0eba6c98f3f7d9acb73a0ba5c21a2ff4c661c`. The 2026-08-20T22:17:43Z cutover took 1,696 ms lock/508 ms stop-health/479 ms switch-health. Rollback is exact `fd76277b05d491af8840b28f3132b7ff445d3cbe`.-- Source is ahead; Android exact `b8b6994efe4da3a773e16cec370e2a5ce7cbbf93` and pending Host-ingress retry are not deployed.-- The current Screener, LiveKit, coturn, and nginx services are active/running with `NRestarts=0`; local and public health are 200. SQLite v3 is intact with five rooms including room `1`, and the DB owner/mode remain `screener:screener`/0600.+- Production is exact `16f6eab27bdfb1c15cdbd814a35864f4f18be767` at `https://share.bonfire.icu`; its 1,027,423-byte artifact SHA-256 is `74e0274ab11a162cb9dd4be1c34bb6b639e2ea76005969c30ae3a1daa656742f`. The 2026-08-20T23:44:57Z cutover took 10,238 ms lock/641 ms stop-health/570 ms switch-health. Immediate rollback is exact `22119b907d3cf03ce8b06d6fb4596ce1a26fedd7`; exact `fd76277b05d491af8840b28f3132b7ff445d3cbe` remains secondary.+- `main` is ahead only in Native/test evidence; Android and Native senders stay source-only. Host-ingress retry is deployed.+- The four services are active/running with observed `NRestarts=0`; local/public health are 200. SQLite v3 has five rooms including room `1`, with DB owner/mode `screener:screener`/0600.- Production ICE remains ordinary STUN-only. `PEER_ASSISTED_MEDIA=true` enables the controller for every normal room, and selected-edge TURN is configured for the single UDP tuple with TTL 120; the coturn daemon and nginx/LiveKit/firewall/listener baselines were unchanged. No production SFU/TURN media canary or quality claim is implied.- Production requires the independent site-access secret through `SITE_ACCESS_PASSWORD`. Its stateless cookie authorizes creation/Host and permits code-only Viewer attempts; valid private fragment grants remain direct. Public-watch accepts site access plus code, while private code-only entry additionally requires the room password. The env, endpoint, cookie, and nginx limiter naming migrated atomically; anonymous failures stay neutral, and there are no accounts/JWT/session rows.- 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.@@ -68,7 +68,7 @@ These are measurement gates, not performance claims.- Sustainable count by hardware, quality, network, and route: finish instrumented `1/3/5/8`, then pass a 20-viewer matrix before changing the accepted target default to 20.- Whether ADR-0004 passes fanout, re-encoding, depth-four latency, reparenting, silent-partition, and mobile-leaf gates.-- Whether source-complete selected-edge passes forced relay, expiry/failure, mobile, 1-GiB resource and relay-bandwidth gates. Coturn's bearer is non-revocable until expiry; application guards and TTL only bound reuse. Performance comparison and the retained matrix follow functional landing; Media TCP is out of scope.+- Whether selected-edge passes forced relay, expiry/failure, mobile, 1-GiB resource and bandwidth gates. Coturn's bearer is non-revocable until expiry; application guards and TTL only bound reuse. Performance comparison and the retained matrix follow functional landing; Media TCP is out of scope.- Exact mobile lifecycle behavior.- Project license and distribution model, which determines whether GPL/AGPL sources can move beyond study-only use.- Initial deployment regions and expected mainland China, Hong Kong, and overseas network mix.diff --git a/docs/status.md b/docs/status.mdindex cf3e9281..8065335b 100644--- a/docs/status.md+++ b/docs/status.md@@ -4,8 +4,8 @@ Last updated: 2026-08-21## Phase-Production is exact `22119b907d3cf03ce8b06d6fb4596ce1a26fedd7` at `https://share.bonfire.icu`; its 660,626-byte artifact SHA-256 is `3cbd8f6be82fa615fa2861ff1be0eba6c98f3f7d9acb73a0ba5c21a2ff4c661c`.-Cutover: 1,696 ms lock/508 ms stop-health; SQLite v3/five rooms/four healthy zero-restart services. Android exact `b8b6994efe4da3a773e16cec370e2a5ce7cbbf93` and pending ingress are not deployed.+Production at `https://share.bonfire.icu` is exact `16f6eab27bdfb1c15cdbd814a35864f4f18be767`; artifact 1,027,423 bytes, SHA-256 `74e0274ab11a162cb9dd4be1c34bb6b639e2ea76005969c30ae3a1daa656742f`.+Cutover: 10,238 ms lock/641 ms stop-health/570 ms switch-health; SQLite v3/five rooms/four active services, observed `NRestarts=0`. Initial Host-ingress retry is deployed; Android remains source-only.Ordinary ICE is STUN-only; all rooms use the bounded peer/SFU-UDP controller and selected-edge UDP TTL 120. Room `1` is historical smoke; production SFU/TURN media remains unverified.Web names/audio hint are deployed. Native WGC/MF/package is source-only; Web defaults VP8.@@ -36,13 +36,13 @@ Flagship; parallel; min run/smoke/rollback; benchmark later. Active UI/config/lo- Native Win11 audio is source-only/default-off: target isolation was 4018x and one Viewer got 495 Opus packets. Download, game sync, Win10, and other routes remain open.- Access protocol/config/HTTP/storage/SQLite/signaling focused tests pass, including commit-first teardown and v1 rollback.- Native wire/session tests enforce at most two authoritative children, no presence-created edge, stale-revision ignore, and one bounded unsupported-route failure per revision.-- Source adds initial/active selected Host ingress and peer last-mile. Focused route/signaling tests pass exactly-once prepare retry, cleanup and rollback with ordinary peers STUN-only; no relay media ran.+- Production includes initial/active selected Host ingress and peer last-mile; focused tests cover exactly-once retry, cleanup, rollback, and ordinary STUN-only. No relay media ran.- Host names, the window-audio hint, all-room routing, and all-room Host selected ingress are active; the stale restart assertion is historical only.-- Exact `22119b9` passed typecheck, both builds and 30 files/440 tests. Deploy preserved environment, ingress/media/firewall/listener/SQLite hashes, v3/five rooms/room `1`, route settings, services and local/public/route/asset 200s. Site access stayed required, the retired endpoint remained 404, and no TURN/SFU session ran. Rollback is exact `fd76277b05d491af8840b28f3132b7ff445d3cbe`.+- Exact `16f6eab` passed typecheck, both builds and 30 files/445 tests. Deploy preserved all recorded config/network/SQLite hashes; DB, routes, services, endpoints, site access, and old-endpoint 404 passed. It triggered no TURN/SFU session. Rollback is exact `22119b907d3cf03ce8b06d6fb4596ce1a26fedd7`; `fd76277b05d491af8840b28f3132b7ff445d3cbe` remains secondary.## Unverified Boundaries-- The `22119b9` deployment proves process/config health, not a retained production SFU frame, retry/failback, selected UDP pair, admission rescue, edge cap, quality, or resource deltas; game-share load/blur remains unclassified.+- The `16f6eab` deploy proves process/config health only; production SFU frames, initial/active retry/failback, relay pair, admission rescue, caps, quality, and resource evidence remain open. Game-share load/blur is unclassified.- Mobile Web Host unsupported; Viewer leaf-only. Android 14+ direct source/default-off selected-UID audio passed six protocol tests/`assembleDebug`. No device/audible claim; mediaProjection-only background, opt-out/silence/A-V, SFU/rotation remain open. iOS deferred; TV output P2.- Silent partitions can wait 30 to 60 seconds for heartbeat detection before the default 5-second grace; this remains unverified.- The former release reportedly sustained bandwidth-limited blur on a capable LAN; Host refresh recovered while Viewer refresh did not. The new deployment has not yet reproduced or cleared it.