From 76afbff2b1d5062f1c3b2b306b0966c4db7c2824 Mon Sep 17 00:00:00 2001 From: ntsd Date: Sun, 22 Nov 2026 03:18:47 +0700 Subject: [PATCH] docs(openwiki): sync architecture documentation for hotcode-dev-zerohub-share Task: zf-z-832a47cb --- client/src/zeroHub.test.ts | 6 +- client/src/zeroHub.ts | 5 +- openwiki/.claims/architecture/overview.json | 16 ++--- .../architecture/signaling-protocol.json | 12 ++-- .../operations/development-testing.json | 14 +++-- openwiki/.claims/quickstart.json | 18 +++--- openwiki/.claims/subsystems/client-sdk.json | 46 +++++++++----- .../.claims/subsystems/server-signaling.json | 60 +++++++++---------- openwiki/.last-update.json | 4 +- openwiki/.page-manifest.json | 48 +++++++-------- openwiki/architecture/overview.md | 13 ++-- openwiki/architecture/signaling-protocol.md | 2 +- openwiki/operations/development-testing.md | 30 ++++++---- openwiki/quickstart.md | 13 ++-- openwiki/subsystems/client-sdk.md | 21 +++++-- openwiki/subsystems/server-signaling.md | 10 +++- 16 files changed, 175 insertions(+), 143 deletions(-) diff --git a/client/src/zeroHub.test.ts b/client/src/zeroHub.test.ts index a3e09d5..f2669ca 100644 --- a/client/src/zeroHub.test.ts +++ b/client/src/zeroHub.test.ts @@ -181,11 +181,7 @@ describe("hub entry points — awaitable connect contract", () => { (c) => c.joinOrCreateIPHub({ p: 1 }, { m: 1 }), "/v1/ip-hubs/join-or-create", ], - [ - "joinIPHub", - (c) => c.joinIPHub("h", { p: 1 }), - "/v1/ip-hubs/join", - ], + ["joinIPHub", (c) => c.joinIPHub("h", { p: 1 }), "/v1/ip-hubs/join"], [ "createRandomHub", (c) => c.createRandomHub({ p: 1 }, { m: 1 }), diff --git a/client/src/zeroHub.ts b/client/src/zeroHub.ts index bc3a30b..a8b24a0 100644 --- a/client/src/zeroHub.ts +++ b/client/src/zeroHub.ts @@ -1821,10 +1821,7 @@ export class ZeroHubClient { * (`myPeerId`, `peers`, `hubInfo`) is populated when the `onHubInfo` * callback fires. */ - public joinIPHub( - hubId: string, - peerMetadata?: PeerMetadata - ): Promise { + public joinIPHub(hubId: string, peerMetadata?: PeerMetadata): Promise { return this.openHubConnection("/v1/ip-hubs/join", hubId, peerMetadata); } diff --git a/openwiki/.claims/architecture/overview.json b/openwiki/.claims/architecture/overview.json index c945ebe..77b59b1 100644 --- a/openwiki/.claims/architecture/overview.json +++ b/openwiki/.claims/architecture/overview.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "pageVersion": "sha256:e9db173c388e72be8c0b253d786fe2b53fa5d7f314a263fe701e47e187481398", + "pageVersion": "sha256:955078203a2f4d5830cb4d98a814b223c2de8ce0e5ea7716da8d6f5763ac3a47", "claims": [ { "id": "claim_937b0d08bd3849b4b3ddd56a5664ca43", @@ -85,8 +85,8 @@ "statement": "Hub creation on the Go server is performed through the atomic CreateHubIfAbsent primitive on zerohub.ZeroHub (run under a cross-mode collision lock), so concurrent create requests for the same hub ID collapse to a single hub: the race winner creates and the rest receive ErrHubAlreadyExists (surfaced as HTTP 409) instead of orphaning a hub.", "evidence": [ { - "resource": "repo://server/pkg/handler/claim_hub_for_create.go#L17-L41", - "version": "repo-lines-v1:sha256:0df50966e728cd57dee498be7041584b96ca0552697e3f1393b4bfc57eacbf54:eyJzZWxlY3RlZExpbmVDb3VudCI6MjUsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImRiOGYyYzQ3NjI5ZDk4NGMyNDllZTc4YTc4OGMwZWFmZWFlODBhNGQ1Njg5NzkzZGY1OTFiNjk0YWE2YTAwZmEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjY3Y2RhODJkYTYwNjIzOGUwNWU2MjM5OTU2OWM1ZWUwMzk5MzQxOTY0OGFlNWQ0M2EyYmY4Y2Q2MzQ3ZjgyNjMiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjdkZDRhMWY1NTMwNzMxYzQzNmYzNmFkMWZjZDMwMDFhMDI3MzVjNThkYTYwMDllMTYzMDQ2YTMwODMzYWNmZjYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjoyLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjY4OWIwODJmZTUwMmNjYzllMjhiOTg4OGNkNzg4NWExMTk5ODgyMWMwMjQ2NmY2NDc2YWQwZjk3ZTRlNTJhMWUifQ" + "resource": "repo://server/pkg/handler/claim_hub_for_create.go#L19-L43", + "version": "repo-lines-v1:sha256:a815783dc924d8784560c6d4c563f0ca8cfe4ca7ddcefb5b510f7728344b07cc:eyJzZWxlY3RlZExpbmVDb3VudCI6MjUsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjNkMTMwNDk3NDJiOGY4YTk3ODJkY2FlYzNmZGZkYzM0MjE5OTdiZjIyNzI2OTc3MzUyOTUxZTQyMjYwYWMyYTIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6Ijc4ODBlYWU4MGIwNjZkYjVjMTU1ZGQ1YjZmYmRiNzYyZjY1ODgyMzFkYzBkODgxMTkwN2VhYTdkNWIzZDUzYjQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" }, { "resource": "repo://server/pkg/zerohub/zerohub.go#L88-L104", @@ -99,18 +99,18 @@ "statement": "The Go signaling server validates hub-endpoint query parameters before the WebSocket handshake via the shared validateHubCreateParams helper: a missing/empty/whitespace id or non-JSON hubMetadata is rejected with HTTP 400 and an oversized id/hubMetadata with 413; peerMetadata is size- and shape-checked at Upgrade. An empty-id request can no longer create a junk hub under the empty-string key and oversized or malformed metadata is not stored or re-broadcast.", "evidence": [ { - "resource": "repo://server/pkg/handler/validation.go#L79-L113", - "version": "repo-lines-v1:sha256:fe3a5f349af90f44bdbb749e4d8d78828ef7ca2c30dce2f7d1285982907cced2:eyJzZWxlY3RlZExpbmVDb3VudCI6MzUsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImYzZmRkOTQyMWQ2NjQ2YTI2YzFhNmEyZmRlMmVlNWVlNGE0ZWQ2YTg5MDkxZWRiMTliM2JlMWE2NDA2ZjVkOTciLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjE0YzI0NWI2ODUwOTEzOWE4MmViMDJlZjBlNTdlZGY4ZjU4OGFjYmJmZDg5Nzc0NmE3MWYxNmJjZDBjNDBjNGYiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImQwNGYxOTFhY2UxM2JlNWU3Yjk5ZTgyNWQ0MTc3MDBhZTg1MTJmNzRkODUxYTQyNWI2YjE1ZDRlZmI2MGM2OGYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImVjZjFjNjUwMzI4ZjcyYmM2MGIwZjUwMWU2ODVkYzdjODYwYjU3ZGU4M2JlM2ExNDI5NmFhY2I4MGJjNjAzOTcifQ" + "resource": "repo://server/pkg/handler/validation.go#L79-L121", + "version": "repo-lines-v1:sha256:82ca2c2700b4d7a041cf1922b64667008609621876bcc370d2284c13c9b78cdd:eyJzZWxlY3RlZExpbmVDb3VudCI6NDMsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImYzZmRkOTQyMWQ2NjQ2YTI2YzFhNmEyZmRlMmVlNWVlNGE0ZWQ2YTg5MDkxZWRiMTliM2JlMWE2NDA2ZjVkOTciLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImQwNGYxOTFhY2UxM2JlNWU3Yjk5ZTgyNWQ0MTc3MDBhZTg1MTJmNzRkODUxYTQyNWI2YjE1ZDRlZmI2MGM2OGYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjE0ZDkwNjc1ZDlmM2ZiNjJjZTEyMzFmMTY3ODU5MmNlNDY5N2E3NjcxODYyNzEwMWMxY2ZiMWJjZjAxODgzYmYifQ" }, { - "resource": "repo://server/pkg/handler/websocket.go#L80-L105", - "version": "repo-lines-v1:sha256:ce602dd435b9d480f7b710706f3c4f8ea0f4c2f4633a8f4ad38168add19a7f08:eyJzZWxlY3RlZExpbmVDb3VudCI6MjYsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQwMTcyMTkzNTU1YmExZjAwMjhhNzllZTZhZjc2N2UwNzUxZTdlYTk2OWQ1NDYzZTE1MDhiYzJlNWJkNmI5OWMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjY3Y2RhODJkYTYwNjIzOGUwNWU2MjM5OTU2OWM1ZWUwMzk5MzQxOTY0OGFlNWQ0M2EyYmY4Y2Q2MzQ3ZjgyNjMiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImFiZGMwNGY2Mzc4NGNlYzM0ZWM3MTk2ODYyZGQwYTIwZGYxNjgyNzAxNGM4Mzg4NTUxYTA4OTUzMzk1OTI0MWQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjA5NGIxOGE0OWNlZmYyNTFmZWYzMzgyYTE3MWUyZDQ2MTcxM2E4NWE5NjFlMTZkN2FkZjY4NGI4MjQyMmMwM2MifQ" + "resource": "repo://server/pkg/handler/websocket.go#L85-L115", + "version": "repo-lines-v1:sha256:10a7ab09d26a79af4586a916054d0f406ae0b78da7d3ae360847921208e3fc40:eyJzZWxlY3RlZExpbmVDb3VudCI6MzEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjhiNWRiZWIyMTE2NTE4MmUyMzhiYmFjOGU1NDE1NjdjNmZkN2Y1NzA3NGMxNjRhZTk2NjY0NDJmOTYwNmI2NDEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjY3Y2RhODJkYTYwNjIzOGUwNWU2MjM5OTU2OWM1ZWUwMzk5MzQxOTY0OGFlNWQ0M2EyYmY4Y2Q2MzQ3ZjgyNjMiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImIzNjJiMGJmNjFlMjQyMGVkYmI2ZTZkMzUyYzkyMDQ2OWIwNzBiYjQ3ZDYxM2I1NzEzMDZkZDFmMDFmNmU1Y2YiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjA5NGIxOGE0OWNlZmYyNTFmZWYzMzgyYTE3MWUyZDQ2MTcxM2E4NWE5NjFlMTZkN2FkZjY4NGI4MjQyMmMwM2MifQ" } ] } ], "verification": { "by": "openwiki/0.6.0", - "at": "2026-11-20T15:09:12.940Z" + "at": "2026-11-21T16:26:45.303Z" } } diff --git a/openwiki/.claims/architecture/signaling-protocol.json b/openwiki/.claims/architecture/signaling-protocol.json index b9c1bfb..1c1b2c9 100644 --- a/openwiki/.claims/architecture/signaling-protocol.json +++ b/openwiki/.claims/architecture/signaling-protocol.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "pageVersion": "sha256:d163eb51d54a69283dc907799e29306ae58efe22135e7574246485a18ebbe7a3", + "pageVersion": "sha256:4347e9dbc853706f354395a069e7ca255004d62e81ebdfffa4c04886c1dea213", "claims": [ { "id": "claim_d5e17f0a4db84690bce7a57930a4a2e7", @@ -79,22 +79,22 @@ "statement": "When autoAnswer is false the incoming offerMessage is surfaced to the application through the onOffer callback (peer in AnswerPending, guarded on the peer still existing in the peers map) and the application completes the exchange by calling sendAnswer(peer.id, offerSdp); when autoAcceptAnswer is false the incoming answerMessage is surfaced through the onAnswer callback (peer in AcceptPending, same guard) and the application calls acceptAnswer(peer.id, answerSdp). Both sendOffer and sendAnswer delegate the ICE-candidate wait-and-send to the shared armSendOnIceReady(peerId, rtcConn, sendOnce) helper, whose single isSent guard makes the SDP send exactly once across the onicecandidate-completion and waitIceCandidatesTimeout fallback paths, with the per-peer timer handle tracked in iceTimeouts[peerId] and re-armed (prior handle cleared) on each call.", "evidence": [ { - "resource": "repo://client/src/zeroHub.ts#L1656-L1762", - "version": "repo-lines-v1:sha256:ef8eaba0fa647878eac16ce1becb992e19cc99022ac730a130f7b605dad872ec:eyJzZWxlY3RlZExpbmVDb3VudCI6MTA3LCJmaXJzdFNlbGVjdGVkTGluZUhhc2giOiI0ZjJhMmY5OTZmMDhlNjgwYmQyOTIxMzVhNmZhNDk3OGJkYTI2ZTYwMmQ4NGYzM2NiMWQ1OTQ3NzVkNDMwNGI1IiwibGFzdFNlbGVjdGVkTGluZUhhc2giOiIyN2U1Nzg4ZDVkOWQ3M2QyNGE4MWRiYzBhNWE3NGJmYTgyYzljM2IzYWY5OWU1MmFmNzk2ZTkwYjQ2OGE4YTNkIiwicHJlY2VkaW5nQ29udGV4dExpbmVDb3VudCI6MywicHJlY2VkaW5nQ29udGV4dEhhc2giOiIxZGIzZTdjZDBjM2E2MjMwNDc2NjgxNjFkMTA0ZTk5ZDg2MjA5Y2EzZTc3NTRhMjViMTE5YTQ5MDc4NzgwNDI2IiwiZm9sbG93aW5nQ29udGV4dExpbmVDb3VudCI6MywiZm9sbG93aW5nQ29udGV4dEhhc2giOiIzMzM2MjVkMDMzMTIyZjgzYTM0MDE5YTgyMDJhOTdmNTEwZjg2NmViY2MwMDVmN2MxMjA0MjBmNmMyNWZmZTA2In0" + "resource": "repo://client/src/zeroHub.ts#L1650-L1732", + "version": "repo-lines-v1:sha256:80f95c980069345d7da66abb940f4949642f036b0d0f96a105738a93123e32c9:eyJzZWxlY3RlZExpbmVDb3VudCI6ODMsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjE3YjQ1OWIzYTViYzNkYmUwMTBlNzE1YzlkNTQzNzE2ZTQ0MDdmNWZjNDc5OGMwYjE1ODFmMDViMTYxYzE0YjAiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjI3ZTU3ODhkNWQ5ZDczZDI0YTgxZGJjMGE1YTc0YmZhODJjOWMzYjNhZjk5ZTUyYWY3OTZlOTBiNDY4YThhM2QiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImQ5MzE0Y2FiNTJmOTlmOWJiNWI3OTllOWFmOTI4MmEzZTYyN2E4NWEzZDQwZDdjZDg4NDY0YmQ2MWI3Nzk1NDkiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjMzMzYyNWQwMzMxMjJmODNhMzQwMTlhODIwMmE5N2Y1MTBmODY2ZWJjYzAwNWY3YzEyMDQyMGY2YzI1ZmZlMDYifQ" }, { "resource": "repo://client/src/zeroHub.ts#L248-L266", "version": "repo-lines-v1:sha256:c1da00f1ddb1d4ac05046285fff6a9b4b7cdf79ac17bf805e0d90ca07e5a930f:eyJzZWxlY3RlZExpbmVDb3VudCI6MTksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjM1NDI5NmQzMmM5ODZhZTcyMDg1ZDYzNWM1MmIzNTk3YTVjNjYxOTY1ZTY1OWMyNjNmNGE0ODQ5NDQyOTIxMmMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImM2YzgzNDE0ZDExMDlkYzE0ZTczYTIwOTdkZjYwOGZkZDUyM2Q2Njg5NDJjM2ZjYjY0NzNiZjYyOGU4ZGM3N2EiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjQyODM5ZmUxZjM0OWE0MzcwZjYwNWQyOGE2YjZjYzcxMzM2NzIyMDNkMDJhMTEwNzY3ZTYxMjgzNjkyNDNhZjIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjUzNTVhMzNhMDI0N2FkMDIyNzg0ZDMzMDE2MGU3NDJmNTRhOWI3ZWFmZTc0MzcyZmEwMjMxZmY0MzQ5NjQ3YzYifQ" }, { - "resource": "repo://client/src/zeroHub.ts#L846-L898", - "version": "repo-lines-v1:sha256:db67bd49d635f293dc88e924d7f83470509db9bd37250f8dc7ac32c1a1e957f2:eyJzZWxlY3RlZExpbmVDb3VudCI6NTMsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImViZjllMDBlNmNkN2ZjNjkwOWU0YjA1ZmE1MGJmNjQzYmYxZDE5NDg1MWNjODg5YzI3ZDdhOTFkN2FmZDdkODYiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjdkNTk4YTZkNTZhZDVhY2NiMzg2YTViOTJmOWQ4NTFhYmE5NDRjNWNjZmRlMWM3NTkwZWFmZTQ2ZjNkMGJkMTUiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImI2MDUyNWZiOWRmYzQ3MmEzZTUzMjJhYzNhYWNhNTliM2I3Zjg0ZTAzYzZjYTBjNTRlYmI2YTdhMDlhODExNTIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImY0OTllODhhNDBmMjhhOTYxOTg2OTUyOWEzZDZlYmZiZWM5YzMzMTcwOGQ0ODIwOTUyNjQwOWFkMGM0Zjg3MzcifQ" + "resource": "repo://client/src/zeroHub.ts#L833-L871", + "version": "repo-lines-v1:sha256:6ff6ad85c8bea01218fac487d1ef282c4a607b0f51137a466b2b516d5b64c0f1:eyJzZWxlY3RlZExpbmVDb3VudCI6MzksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQzY2ZmODU0ZWZjODliNzY3NDlkZjc3ZDAwM2I2M2FkNThmMmI5NGQ0OGQzYzUxZTFmYjE0Yjk5OWYwY2I5NDAiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjliNjJmNjBkODU5MGE1NzljZjQ2ZjhkNjczNzhjNGM1NzJiOTYyY2VjY2RiOTBjN2E1ZjdiNDJiOTYwNzgyYTQiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjE4MjgyY2NmNGIxN2JkYWQ1MDJkODAwMmYyYzBjNDFmMWM2MzkyN2Q1Y2I5YjlmNjhlMmUxNmI3NDEyYTRmMDgiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjFkNTlkYzgyNzhlMjU2NDgyZTVmNTIzNGViYzc2MGNhMmQ4OGUzNzI2ODg5Y2YxMDNlNmU2MjcyODBlNjRlZWMifQ" } ] } ], "verification": { "by": "openwiki/0.6.0", - "at": "2026-11-20T15:09:12.940Z" + "at": "2026-11-21T16:26:45.303Z" } } diff --git a/openwiki/.claims/operations/development-testing.json b/openwiki/.claims/operations/development-testing.json index 3f2197e..0dba190 100644 --- a/openwiki/.claims/operations/development-testing.json +++ b/openwiki/.claims/operations/development-testing.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "pageVersion": "sha256:afa6b86843a0dbff84c4a1aa8c43c020a270101a5e166d4b484580cc1e271535", + "pageVersion": "sha256:9cfe6a7f382aac37d8b5223ccd2ede542dcee2cc6b9e0de9fbc18548b88982ed", "claims": [ { "id": "claim_9b265d25c6ea46ffb5cbb15403e8cd85", @@ -28,11 +28,15 @@ }, { "id": "claim_2c2b053579db481d9a8df809eea0b057", - "statement": "The E2E test/ suite is driven via `cd test && npm test`, whose pretest step runs the tsc typecheck, build:harness, and the unit-harness esbuild script to produce test/dist/harness.js and test/dist/unit-harness.js; invoking npx playwright test directly makes the specs fail with ENOENT on their missing harness bundles.", + "statement": "The E2E test/ suite is driven via `cd test && npm test`, whose pretest step runs the tsc typecheck then a single parameterized build:harness esbuild script (test/scripts/build-harness.mjs) that produces both test/dist/harness.js and test/dist/unit-harness.js; invoking npx playwright test directly makes the specs fail with ENOENT on their missing harness bundles.", "evidence": [ { "resource": "repo://test/package.json#L7-L12", - "version": "repo-lines-v1:sha256:1f7463db41187db93844b0868087f55297f2eda179f9c1ae0664d536fd99801b:eyJzZWxlY3RlZExpbmVDb3VudCI6NiwiZmlyc3RTZWxlY3RlZExpbmVIYXNoIjoiMzQ4MzNkNTk0OWMwM2E0MGNhOTUyNDkxNjEwYTY2NTk2NDRiM2FhNDY2MzYyZjc5OTAyMGRiZjE5ODE1NDdkYiIsImxhc3RTZWxlY3RlZExpbmVIYXNoIjoiNGQ1Y2QyZmI0ZjNkZjg4NDUxNTI1NWIzOTUyM2YyZjhiNTQ3MmJlZWE5ZjU2NmZmY2EyMDRkYjgwMjU2MTA0MSIsInByZWNlZGluZ0NvbnRleHRMaW5lQ291bnQiOjMsInByZWNlZGluZ0NvbnRleHRIYXNoIjoiMmFkNTI4ZGJmZmQzNTRkNjhjM2Q3Y2E1MzdhOWZhMDE5N2IzNmY2MDVjM2RiZjIzZWJjNThmZDI2ZjA1ZDYxMSIsImZvbGxvd2luZ0NvbnRleHRMaW5lQ291bnQiOjMsImZvbGxvd2luZ0NvbnRleHRIYXNoIjoiM2YxZjE3ZDg5ZmRhNjdhOWQzNzEzZWZmYmM0YjgwMjkxMTc1NWI0Yzc4YWRmZjZlNWRlZDIzODI5ZTlkOGIzNyJ9" + "version": "repo-lines-v1:sha256:24298a5e91cd8e0f1ced3a17a212ca18b00ecbdd74caa9ee3d2e5f9bd88b878d:eyJzZWxlY3RlZExpbmVDb3VudCI6NiwiZmlyc3RTZWxlY3RlZExpbmVIYXNoIjoiMzQ4MzNkNTk0OWMwM2E0MGNhOTUyNDkxNjEwYTY2NTk2NDRiM2FhNDY2MzYyZjc5OTAyMGRiZjE5ODE1NDdkYiIsImxhc3RTZWxlY3RlZExpbmVIYXNoIjoiNGQ1Y2QyZmI0ZjNkZjg4NDUxNTI1NWIzOTUyM2YyZjhiNTQ3MmJlZWE5ZjU2NmZmY2EyMDRkYjgwMjU2MTA0MSIsInByZWNlZGluZ0NvbnRleHRMaW5lQ291bnQiOjMsInByZWNlZGluZ0NvbnRleHRIYXNoIjoiMmFkNTI4ZGJmZmQzNTRkNjhjM2Q3Y2E1MzdhOWZhMDE5N2IzNmY2MDVjM2RiZjIzZWJjNThmZDI2ZjA1ZDYxMSIsImZvbGxvd2luZ0NvbnRleHRMaW5lQ291bnQiOjMsImZvbGxvd2luZ0NvbnRleHRIYXNoIjoiM2YxZjE3ZDg5ZmRhNjdhOWQzNzEzZWZmYmM0YjgwMjkxMTc1NWI0Yzc4YWRmZjZlNWRlZDIzODI5ZTlkOGIzNyJ9" + }, + { + "resource": "repo://test/scripts/build-harness.mjs", + "version": "repo-file-v1:sha256:c17b773083cdaac20dd4fd955685d75cf89e092a19c391c253a4b54ef42e3fe0" } ] }, @@ -104,13 +108,13 @@ }, { "resource": "repo://test/unit-harness/index.ts", - "version": "repo-file-v1:sha256:4b9bdf4c7d5bb0b131ccaf581fe630d66a2d4261476a96b45b58230a36424ef7" + "version": "repo-file-v1:sha256:cd37527a44ed824fcf43d1e2dea79030dd73a5ae09c76f90f316b4cb0ea8f08d" } ] } ], "verification": { "by": "openwiki/0.6.0", - "at": "2026-11-20T15:09:12.940Z" + "at": "2026-11-21T16:26:45.303Z" } } diff --git a/openwiki/.claims/quickstart.json b/openwiki/.claims/quickstart.json index 92cbecf..f6b95b0 100644 --- a/openwiki/.claims/quickstart.json +++ b/openwiki/.claims/quickstart.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "pageVersion": "sha256:984a8acd4470194459c1d20515d0ba0e18c04525a2b1397e445f47ed6e2258f0", + "pageVersion": "sha256:9e667d665f1b5a5a5d20392a7125ffa7c3c392fdd003a4a809475783353c8fb6", "claims": [ { "id": "claim_29b96b61359846dd9149060c8b57d3a3", @@ -38,11 +38,11 @@ "evidence": [ { "resource": "repo://server/pkg/config/config.go#L27-L45", - "version": "repo-lines-v1:sha256:d34de20c4cbb0894574fdc50f2b71a2fd616e53d0e917c51088a349bba641e0e:eyJzZWxlY3RlZExpbmVDb3VudCI6MTksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjlmYWJkYTI2NGU5MDhhNDg0NmRmZDlhNDliNGE5ZDA5ZDgzYzY0ODI1ZmZhODY3YzllOTE5MTY5Zjk3NGY0NzgiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjgxMjhlMTE0YTBiZjg5YjE4ZmUyODM2Zjc5MzI0ODJmMDJjODc1MTQ5MGVkZDczMmI3ODAzNzdiYzk4NmQ5NjUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjcyNTgxYmMxYzdjNDljOWJiZjI1OTZhNDJmZmQ2MDdkY2NmOWYzMTg1ZDJmNmQ0MjI1ODg3MDAwNDdiOTA4ZWEifQ" + "version": "repo-lines-v1:sha256:34d580a9e44be49b8977c8567aafb11548751e39e811cec9be98ec47cb5cf486:eyJzZWxlY3RlZExpbmVDb3VudCI6MTksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImY5ODBhZWM0MzZiMWNmN2Y0M2Y1YmZkNTQyYjJkOWFiNWMyMDkxYWZjMWI5YjgyZDlhM2I5MjE5ZmY4MThhODQiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjczMWIxNjVlYmE2ODc4NGVjMjU5ZmQ3Yzg0YzJiNWJhMjIxMTYyYzc4NjY0OGYyZGUzY2NhOTkwNWZjNTQ0OTgiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjE5YWVjMDEyOGVmMzczMjU2M2YzM2QyNzFlZTY5MjllMGI5OTFhODM2YTAxMWZlZTJiYjEwYWEwZTE2YWUxYzciLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjY0YmM3YWM5MjA0MDJlM2JmOTQ3NTQ0MDQzZDM4NTBkYjQwMGQ2ZDc4M2IzNjA4OGM3YTdmZDEzMmMyMDc0OWIifQ" }, { - "resource": "repo://server/pkg/handler/handler.go#L155-L168", - "version": "repo-lines-v1:sha256:2947573de4270d3c8eacbf28d620c59408701070d5be0820837c238de7e47bf0:eyJzZWxlY3RlZExpbmVDb3VudCI6MTQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjZhOWEwMDI2OTVhY2JmNjViMTU3ZDY1NzlmNjQyNzkxYWQ4NDgwMWU3ZGE4MjY2OTU5MzcxMjg5NTA1MzMzMDEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjVmN2FmODVhOTk1ZWY1YmY3ZWQ5MmIxMGJjOWM4Y2I3ZWJkYjBkZjQ4NzEzYzM0NDg5MjI5ZTBiNjc4OTliMTgiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImIzNmI0MGIxYTY4YTUzNjJlYTk5ODNlNGM3ZjZjMmQwYWQwMTJhMzc3YWQ5N2I5MTg1Mzc2NDk3NGZlMWFkYjcifQ" + "resource": "repo://server/pkg/handler/handler.go#L149-L162", + "version": "repo-lines-v1:sha256:4f9fab459ef4fc93563cff9854deb4866869dd16276516f1aeb0f54a071aaae8:eyJzZWxlY3RlZExpbmVDb3VudCI6MTQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjlhNDQyNDQ1Mzc4ZTc3ZTMxMzliODkxMzc1OGRlN2IyMjNiMjcxNzBmMWQ3ZGM1MGRhMzcxNWQyMDc3Y2JhNmIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjhkYWU1N2Q4YjMzYjc3NmMyZmM0M2NlNDA1Nzk1MDRkMGJjOGVhNjJhNDNjMDJjNTgyYTJlNWJhYWYzYzZjYWQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImIzNmI0MGIxYTY4YTUzNjJlYTk5ODNlNGM3ZjZjMmQwYWQwMTJhMzc3YWQ5N2I5MTg1Mzc2NDk3NGZlMWFkYjcifQ" } ] }, @@ -62,25 +62,25 @@ "evidence": [ { "resource": "repo://test/harness/index.ts", - "version": "repo-file-v1:sha256:63e2c55f19f41220ccbad6e44aa61bc53a6f993f977811b5abac2573ac704178" + "version": "repo-file-v1:sha256:a6a602d2da48a65421eba0f7e6ae657d67984fb2d4042255174087702b525df8" }, { "resource": "repo://test/package.json", - "version": "repo-file-v1:sha256:85683518c82c046f227b61a2a7a504eefe77c0f983ecf44a4e4f04e5d590deb3" + "version": "repo-file-v1:sha256:9ec75b10c948edd69991f5be5a637d35464fc0243afb729a87b6ac4babf91d01" }, { "resource": "repo://test/playwright.config.ts", - "version": "repo-file-v1:sha256:2971c4c0273d8dd02ce6772aedd5df79e828ee2b93a7fbded39e22447a4a633d" + "version": "repo-file-v1:sha256:79c00c5572251ffa1958870f3d976f2c30dec90666880125bba6aa8470475c90" }, { "resource": "repo://test/unit-harness/index.ts", - "version": "repo-file-v1:sha256:4b9bdf4c7d5bb0b131ccaf581fe630d66a2d4261476a96b45b58230a36424ef7" + "version": "repo-file-v1:sha256:cd37527a44ed824fcf43d1e2dea79030dd73a5ae09c76f90f316b4cb0ea8f08d" } ] } ], "verification": { "by": "openwiki/0.6.0", - "at": "2026-11-20T15:09:12.940Z" + "at": "2026-11-21T16:26:45.303Z" } } diff --git a/openwiki/.claims/subsystems/client-sdk.json b/openwiki/.claims/subsystems/client-sdk.json index 5614939..30c366e 100644 --- a/openwiki/.claims/subsystems/client-sdk.json +++ b/openwiki/.claims/subsystems/client-sdk.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "pageVersion": "sha256:1d9852ca4b2464a2a66fff67f85b6a16c988b2bbaf85b3d3525633df764d628a", + "pageVersion": "sha256:bde0656666e0d821916f63ca8c779cb47e1318377c46e2d9d742f21a76b43e88", "claims": [ { "id": "claim_f8eee7b4d94d405e8ae1cd7638c1d8cf", @@ -38,15 +38,15 @@ }, { "id": "claim_bd4128b0cd9d456c8ec9c4355a36c977", - "statement": "SFUTopology routes all P2P traffic through a single SFU peer (the numerically lowest peer ID by default, or an explicitly set one — peer IDs are sequential decimal strings, so election sorts parseInt(id, 10) rather than lexicographically); the SFU offers to every client and non-SFU peers connect only to the SFU, trading a single point of failure for better large-group scalability. P2P drops are recovered only from the SFU side by re-sending an offer; an explicitly configured SFU is never re-elected.", + "statement": "SFUTopology routes all P2P traffic through a single SFU peer (the numerically lowest peer ID by default, or an explicitly set one - peer IDs are sequential decimal strings, so election sorts parseInt(id, 10) rather than lexicographically); the SFU offers to every client and non-SFU peers connect only to the SFU, trading a single point of failure for better large-group scalability. P2P drops are recovered only from the SFU side by re-sending an offer; an explicitly configured SFU is never re-elected.", "evidence": [ { - "resource": "repo://client/src/topology/sfuTopology.ts#L183-L193", - "version": "repo-lines-v1:sha256:778dd7b3661c146e3facf8c67f662266cab6ffd8e4960dc18d98d634fb3512a0:eyJzZWxlY3RlZExpbmVDb3VudCI6MTEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImYxNjUzMDAyZDYxNTQwMGEyNTlmZjZlYTIyOTljYzk1NDJkOGY3ZGI0OTdkNjZhZGQ1YTZlNjM1OWZhY2E4ODIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImU2YjA0NDkxNDY5NzIyZTgzNjNhOTRlNDA0NDUzOGUwMTNhMmEyMTdlMzZiMWU1NjhiYTYwYWNiN2I0YzhmMmUiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjY5ODdjZWNjY2U4NzFjMWVmMzg3NWFjYTJjMDMyZjhlYTU4NGE2OTA1MDNhMTJkOWViNmE0NTBmZGQ0ZGJiOWUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjI5NjZiYjQwZWNlZmY2NDJlNzUzYTJhMDM5ODA5NjcwNjdjMGMzNDdmYjdkODZiMDc2MjdiZDZmMmM3OTc2MDEifQ" + "resource": "repo://client/src/topology/sfuTopology.ts#L184-L204", + "version": "repo-lines-v1:sha256:7353c73c7da290e587490c663c3df7c149cbbd5a4460848521bf76468313ead1:eyJzZWxlY3RlZExpbmVDb3VudCI6MjEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjMxM2Q4MjU2YWQzMzk3Y2VlNmE4ZDlkMGY2MGNmNzdlM2I2OGI0NTQyYjZjNGUzMGZhYzQ0ODQ1YTEwMWI1MzQiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImQxNzQ4NTE3NzAyZTg3NWRkNWUyOWI3YmIwMjdhZjQ4MjI3NjcwY2I4YTQ4OGEyOTc0MGY1ZTlhYTg2OTAwMjUiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImQwMGI5NzZlNGM5OTMxYzVlMmJlYjBjMTI5MzAxMTA5YmE1ZWQ0NjYzY2VhMDAzODFkODZiNjAxYTlmNTNkNTEiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6Ijk3ZDg2MzJlNTRlOTI5OGFiYjk1ODcyN2UyZDUxNDA4YWJhZjEzNjYwMzUzNzkxMDE0MGFiZjY1YjMwYWI2MTMifQ" }, { - "resource": "repo://client/src/topology/sfuTopology.ts#L64-L137", - "version": "repo-lines-v1:sha256:0f24bd273414e0aa111c54b83b3b107e7d27c075f4d4d8ebe7ced10580690192:eyJzZWxlY3RlZExpbmVDb3VudCI6NzQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjRmMmEyZjk5NmYwOGU2ODBiZDI5MjEzNWE2ZmE0OTc4YmRhMjZlNjAyZDg0ZjMzY2IxZDU5NDc3NWQ0MzA0YjUiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImQxNzQ4NTE3NzAyZTg3NWRkNWUyOWI3YmIwMjdhZjQ4MjI3NjcwY2I4YTQ4OGEyOTc0MGY1ZTlhYTg2OTAwMjUiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImJkNWQ4ZjU0MGU2ODE1YzdmMDA1ODA0ZjgwYTYyODM5ZmU5NjlkOTAyOGY1YTcxNGFiOWFkNmYyZjQ5OTRiM2IiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImU0NTI2YTNjODkzOTQ1NjJmNDQ1YjBmNTI3M2M4MjJlMTJjZDY3MTZjOWFmMmE5YWJkNTc4MWU2YTI3YzQxMjIifQ" + "resource": "repo://client/src/topology/sfuTopology.ts#L88-L116", + "version": "repo-lines-v1:sha256:4f8220281cebdf96bf279b4f0f70b728d70d0ff8bbeb247802a2ead3eb29d3ba:eyJzZWxlY3RlZExpbmVDb3VudCI6MjksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImJkNjgyNWJiZjFlNjkxMzY2NTQxNWI2ZjE0MGZkYzI2Y2U1MWJmMzc4NDViNmRmNWVkYzU0MTZkZmFhNzI1ODgiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjI3ZTU3ODhkNWQ5ZDczZDI0YTgxZGJjMGE1YTc0YmZhODJjOWMzYjNhZjk5ZTUyYWY3OTZlOTBiNDY4YThhM2QiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjE1NmQ1NWMyMmU5ZTUxYWVhYWNlNmJkYmY2YThmZTJhOTU0NWM1MDc5YzBkOTEzNDllNjQxZWExMTE0Yjg0NGYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjcwMzAwMjRmMzg2MTg5NjE2ZDBlODE0NTkxY2QwM2Q1ODhhNmYyN2Q4OTk3MzNkNWI3MjQ2OGMzZDI1OTJhZjIifQ" } ] }, @@ -59,8 +59,8 @@ "version": "repo-lines-v1:sha256:1ab3bbd354239e5a7d671aca886480c5a7ee271dcd426625bb1c3e61edcd7936:eyJzZWxlY3RlZExpbmVDb3VudCI6MTYsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6Ijg4NmEyMTNkZWMxMzQxODI2MDgyZGJjZDcwZmRlMzc5YjNiNTA3ZWRmZDJlY2ZhMGFmM2ZkYzE2MzVjNzM4OTMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImU2YjA0NDkxNDY5NzIyZTgzNjNhOTRlNDA0NDUzOGUwMTNhMmEyMTdlMzZiMWU1NjhiYTYwYWNiN2I0YzhmMmUiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjI3NjBkNzA4NDczNzBjYWU3NWFjNWY1MDFjM2UxMGRmZTJmY2RjNThjMjE0NjI2MmU4ZjA5Nzk0MjFhZDkwYmQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImU5ODYzMzZjZjJkZmFkZDMxNzZiZTRlMGMwNzdjNTQ5NGRmMjE1NzEzNjJlMjZmMGQ3MGMyNmJhZTUwYzMzNTAifQ" }, { - "resource": "repo://client/src/topology/peerSetup.ts#L25-L115", - "version": "repo-lines-v1:sha256:d2575b83b179c30c09f238bee6c7795f9e8727ce92b0dc710b6b78b4f6f7d81c:eyJzZWxlY3RlZExpbmVDb3VudCI6OTEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjZhOWRkNTFmNzY3Nzg4MTlhM2Y3ZjcyMTQzNzBiYTFjZmY2MzI1NjJlNDJiMTljYWM1ZjA3ZjdiMmMxMDEyNWMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjUzMjI1NGRjMjFjZjVmZjUzY2I1NWFiOWFiZDY2MjliNDJlZTQ5ZjA2NjM2YjE3Yjc3ZWRkNmI0MGNhNmU4NDgiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" + "resource": "repo://client/src/topology/peerSetup.ts#L41-L127", + "version": "repo-lines-v1:sha256:2a47f2d5722588078ff2e944d026cccf4f2b17b817ee70f3747869cf68516feb:eyJzZWxlY3RlZExpbmVDb3VudCI6ODcsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjZhOWRkNTFmNzY3Nzg4MTlhM2Y3ZjcyMTQzNzBiYTFjZmY2MzI1NjJlNDJiMTljYWM1ZjA3ZjdiMmMxMDEyNWMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjUzMjI1NGRjMjFjZjVmZjUzY2I1NWFiOWFiZDY2MjliNDJlZTQ5ZjA2NjM2YjE3Yjc3ZWRkNmI0MGNhNmU4NDgiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" } ] }, @@ -120,11 +120,11 @@ }, { "id": "claim_3d7994bff5cc4ef1aa3bd7aaf510d9a3", - "statement": "All four hub connection entrypoints (createRandomHub, joinRandomHub, joinStaticHub, joinOrCreateIPHub) funnel into the private openHubConnection helper, which stores any supplied metadata, builds a URL from getWS(host, tls) with id/hubMetadata/peerMetadata query params as applicable, and calls connectToZeroHub. The former createHub/joinHub/joinOrCreateHub (named-hub) and createPermanentHub/joinPermanentHub entrypoints no longer exist — named hubs are now 'static hubs' whose creation is an admin-gated plain-HTTP endpoint — and joinIPHub was removed because a client-supplied id can never resolve to an IP hub.", + "statement": "All five hub connection entrypoints (createRandomHub, joinRandomHub, joinStaticHub, joinIPHub, joinOrCreateIPHub) funnel into the private openHubConnection helper, which builds a URL from getWS(host, tls) with id/hubMetadata/peerMetadata query params as applicable, and calls connectToZeroHub. The former createHub/joinHub/joinOrCreateHub (named-hub) and createPermanentHub/joinPermanentHub entrypoints no longer exist - named hubs are now 'static hubs' whose creation is an admin-gated plain-HTTP endpoint. joinIPHub(hubId) joins an existing IP-keyed hub by its derived id (the id published in hubInfo after a peer created the hub via joinOrCreateIPHub).", "evidence": [ { - "resource": "repo://client/src/zeroHub.ts#L1812-L1913", - "version": "repo-lines-v1:sha256:0edd2cf6792b4f7b4438e3c69d1032162355429c19ee4ac65231d78726abbc91:eyJzZWxlY3RlZExpbmVDb3VudCI6MTAyLCJmaXJzdFNlbGVjdGVkTGluZUhhc2giOiJhY2ZhN2RmMWFkYTZmYTUyZThmMjg2Mzc0MDFlM2ViYzU4ODZjOGNhYzIzYzBkMjRhNTMwNDc4YjdmZWYxZmM5IiwibGFzdFNlbGVjdGVkTGluZUhhc2giOiIyN2U1Nzg4ZDVkOWQ3M2QyNGE4MWRiYzBhNWE3NGJmYTgyYzljM2IzYWY5OWU1MmFmNzk2ZTkwYjQ2OGE4YTNkIiwicHJlY2VkaW5nQ29udGV4dExpbmVDb3VudCI6MywicHJlY2VkaW5nQ29udGV4dEhhc2giOiJjNWY4ZDQxMWM2MzY1MzczYWM4ZjZkMmRlY2M0NjQ3MDc5OWE2MjM0ZTY2YjM3ZTE2Y2MwYjQyYjFmOWFkZTNjIiwiZm9sbG93aW5nQ29udGV4dExpbmVDb3VudCI6MywiZm9sbG93aW5nQ29udGV4dEhhc2giOiIzNzkyOWU5MWUwZjk5YzNlODI1ZGU2OWI0MzVmYjY0ODRkMWIwYTFkZjJmNDY1NjFhYmYxYTI5ZjA0MTg4Yjg4In0" + "resource": "repo://client/src/zeroHub.ts#L1782-L1901", + "version": "repo-lines-v1:sha256:7d81e5e6afa47954d392f03261d23aa650d69c4639f8f9b2528bd40d8ea4b6d4:eyJzZWxlY3RlZExpbmVDb3VudCI6MTIwLCJmaXJzdFNlbGVjdGVkTGluZUhhc2giOiJhY2ZhN2RmMWFkYTZmYTUyZThmMjg2Mzc0MDFlM2ViYzU4ODZjOGNhYzIzYzBkMjRhNTMwNDc4YjdmZWYxZmM5IiwibGFzdFNlbGVjdGVkTGluZUhhc2giOiIyN2U1Nzg4ZDVkOWQ3M2QyNGE4MWRiYzBhNWE3NGJmYTgyYzljM2IzYWY5OWU1MmFmNzk2ZTkwYjQ2OGE4YTNkIiwicHJlY2VkaW5nQ29udGV4dExpbmVDb3VudCI6MywicHJlY2VkaW5nQ29udGV4dEhhc2giOiJjNWY4ZDQxMWM2MzY1MzczYWM4ZjZkMmRlY2M0NjQ3MDc5OWE2MjM0ZTY2YjM3ZTE2Y2MwYjQyYjFmOWFkZTNjIiwiZm9sbG93aW5nQ29udGV4dExpbmVDb3VudCI6MywiZm9sbG93aW5nQ29udGV4dEhhc2giOiIzNzkyOWU5MWUwZjk5YzNlODI1ZGU2OWI0MzVmYjY0ODRkMWIwYTFkZjJmNDY1NjFhYmYxYTI5ZjA0MTg4Yjg4In0" } ] }, @@ -199,8 +199,8 @@ "statement": "With autoAnswer: false, the offerMessage branch does not call sendAnswer; it moves the peer to AnswerPending and then invokes the public onOffer(peer, offerSdp) callback (guarded on the peer existing in the peers map) so the application completes the exchange via sendAnswer(peer.id, offerSdp). With autoAcceptAnswer: false, the answerMessage branch likewise moves the peer to AcceptPending and invokes the public onAnswer(peer, answerSdp) callback so the application completes the exchange via acceptAnswer(peer.id, answerSdp).", "evidence": [ { - "resource": "repo://client/src/zeroHub.ts#L840-L901", - "version": "repo-lines-v1:sha256:7cdf88a6b09e213116646c15766262bd6acfddd2a0d6babbe7fc1841e4a5608c:eyJzZWxlY3RlZExpbmVDb3VudCI6NjIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjNlYjI4OTJlMDY2NDc5ZGFiODk2MDdjNWZhZWU4MmQ2YzczN2EzYzg2YzgzNDhlNzJkZjQ4NjJlZGExOWY5MmEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjliNjJmNjBkODU5MGE1NzljZjQ2ZjhkNjczNzhjNGM1NzJiOTYyY2VjY2RiOTBjN2E1ZjdiNDJiOTYwNzgyYTQiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjVmMmNjNzg1OGY1MjFkMzlmNDViNjg3MDQ4NDU4MGIzMjVhYzJjNDA5ZTIyNmQyMGFmYThmNzczMjM0OGUwZjciLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjFkNTlkYzgyNzhlMjU2NDgyZTVmNTIzNGViYzc2MGNhMmQ4OGUzNzI2ODg5Y2YxMDNlNmU2MjcyODBlNjRlZWMifQ" + "resource": "repo://client/src/zeroHub.ts#L832-L871", + "version": "repo-lines-v1:sha256:1a9581ddf9f58fdffacd118a1f9c5c870c65ea8f10f1b24f5dc0640e4559e4a6:eyJzZWxlY3RlZExpbmVDb3VudCI6NDAsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjhmMDliMjYxNDlhNzI0Y2E5ZGQ0ODJkOGZhMTc4YThiOGZhMDA0NzAzMjBhOGVlY2Y0YzRlZDU4Njk5ZTExNTAiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjliNjJmNjBkODU5MGE1NzljZjQ2ZjhkNjczNzhjNGM1NzJiOTYyY2VjY2RiOTBjN2E1ZjdiNDJiOTYwNzgyYTQiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImY5YjkwNTMxZjllOWE2ODFlNDAzZDRlMzk0OGVmZjE0NDM0OTM4ZWFmNGQxNTFmZDdhZjYzMDk0ZjA3Y2M4MGUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjFkNTlkYzgyNzhlMjU2NDgyZTVmNTIzNGViYzc2MGNhMmQ4OGUzNzI2ODg5Y2YxMDNlNmU2MjcyODBlNjRlZWMifQ" } ] }, @@ -213,8 +213,8 @@ "version": "repo-lines-v1:sha256:dcdeb950e92cdb991ae5eb0fd3970da02acf1ca13e0c0783b2b4393a28ed51a6:eyJzZWxlY3RlZExpbmVDb3VudCI6MTUsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjZkZmYzMTljNDkxOTM3M2MzZjE0MzJkZDRkNWRkNjNjYjQ3NjY5ZmVjNmIxNTA3YzBkZTRhMDRkYmRmOWM5MTUiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImIzNDQ0OTEwOGY5MjQ2Mzc3NzU3YmM4M2JhYWNmYjI1YjMyZGVhNGIyZDFhMzk5ZWMwYzIyNjhlZTYyY2E1ZjMiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6Ijk3ZWNmMWYwZjI4N2RhZTJlMjMzNWFkYTNlMDBjZGIyYzU4MGY4MWE5MjNmMjdmY2I5NzI4NTE0MWZmMTc3NGEiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjdiMTYyNWY2OGFiOWFmZmQyNDVhMzNmMzQ1Y2NkZjY1MDQzYTYzYWY0ZjdjOGViZjVlMDVlYzI0ZmJiNjc1ZjUifQ" }, { - "resource": "repo://client/src/zeroHub.ts#L856-L899", - "version": "repo-lines-v1:sha256:a7f8e1dc97c0724979fd6eddb4596437d2b784a155c2f2fb793a4eaf9caf643a:eyJzZWxlY3RlZExpbmVDb3VudCI6NDQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjkyZGVkNzc1YTRhNjUwYjFhZjYwNjljMmUyMTllOTNmODg1NTBiNzNlNzIxOWFkMWU1ZDFjMWYzNzExNGI0YjciLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6Ijg4MDA1ZDU3MTA2YTM2MmViMDAwZGFmM2RhNDY3NGM4MmI1MThmZjVhMmUyZjY3ZWU4ZTc1N2EzMzNjMmFmNjYiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImQyMDA1MjI4NWFlN2ExNTYzNDM5MTNhM2U0NjIwYjQ1ZDc2OTA0MDhmNTRhZjhlMGRkODY1MzgxODAyYTkwYmYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjNhNmUyNWE0N2EyOWE4NTMyMWNiN2IxYjk0ZDIxNTZlOTNkMzZmODdmNDRjY2QyMGM4ZmMwOTk1YTYxZjVkMGUifQ" + "resource": "repo://client/src/zeroHub.ts#L832-L871", + "version": "repo-lines-v1:sha256:1a9581ddf9f58fdffacd118a1f9c5c870c65ea8f10f1b24f5dc0640e4559e4a6:eyJzZWxlY3RlZExpbmVDb3VudCI6NDAsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjhmMDliMjYxNDlhNzI0Y2E5ZGQ0ODJkOGZhMTc4YThiOGZhMDA0NzAzMjBhOGVlY2Y0YzRlZDU4Njk5ZTExNTAiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjliNjJmNjBkODU5MGE1NzljZjQ2ZjhkNjczNzhjNGM1NzJiOTYyY2VjY2RiOTBjN2E1ZjdiNDJiOTYwNzgyYTQiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImY5YjkwNTMxZjllOWE2ODFlNDAzZDRlMzk0OGVmZjE0NDM0OTM4ZWFmNGQxNTFmZDdhZjYzMDk0ZjA3Y2M4MGUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjFkNTlkYzgyNzhlMjU2NDgyZTVmNTIzNGViYzc2MGNhMmQ4OGUzNzI2ODg5Y2YxMDNlNmU2MjcyODBlNjRlZWMifQ" } ] }, @@ -227,10 +227,24 @@ "version": "repo-lines-v1:sha256:2cd9b789a4617a04c14baca6d98062af4291d3c3ee967e16eb83b94f9f6de6a1:eyJzZWxlY3RlZExpbmVDb3VudCI6MzIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjlmMzcwZTFkOGE3YjU2OTU3NGNkZjc2Y2I1NDY0OWQzNTcwM2YwNzY4ZjUwM2VlZGRlMGIyNmU1Yjg2MjA0MjIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6Ijg5Njc1MjBiODgxNmU5Yjk4ZGFkMmQyMjU0YzIwZGI3NDBhMGEwZGI3N2JmMzcwMzY1MDk4M2NjOTU3ZWM0YjYiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImI3ZTY5Y2NmZDcwN2MzODY3YzQ2ZWYxYTZmODU5NGIwZGExMDk0YjFmMDE2YTk2MDZlMDViZjJmMGM2MDJiOGUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImI0YWUwZWU0OTEwMTU1NDQ3YjkxZDBmNDRhYTIxZjE2MzI5YTNlNTk4ZGIwNTdkZjE2MWVkYTQ2MDZiYzYyMWIifQ" } ] + }, + { + "id": "claim_9b407866e7434332beed8c7c50594856", + "statement": "User-supplied callbacks are isolated from the signaling dispatch by shared guarded-call helpers: the private safeInvoke in zeroHub.ts wraps every user callback (onPeerStatusChange, onPeerError, onHubInfo, onOffer, onAnswer, onZeroHubError, and topology.onPeerStatusChange), and the module-level guardCallback in peerSetup.ts wraps the user-facing onDataChannel and onTrack callbacks, so a throwing handler is logged and isolated instead of aborting the event handler that invoked it.", + "evidence": [ + { + "resource": "repo://client/src/topology/peerSetup.ts#L5-L19", + "version": "repo-lines-v1:sha256:43637e49d49dcacf8947045815045d1b21e07a3bb2cbda78addc130f56457d72:eyJzZWxlY3RlZExpbmVDb3VudCI6MTUsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImVhZjIyY2YwNzMyNTkyYzI0NzE0MWNiZTYxZWZhMTEwMTI2MTJmNWEzMTIyYjlhZjliYmFmNTJmNTcyNGQxOTQiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjhhZGNmZTFlOTYzNzM2MzZkNjViNmZiYzZkMWVlOTIzYjE1MzM4MDhmMTBiZjgwMTVlNjcwNmQwNWU4ODI3MDAiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjYxMjJlNWQxYzY4MWQwNTM2ZTJiNDljMjJkNmE0N2Q4MTE4MjQ5MTk1Y2NmYTJiNDEyMjgzOTMyMGQwZjViN2EifQ" + }, + { + "resource": "repo://client/src/zeroHub.ts#L443-L454", + "version": "repo-lines-v1:sha256:7006afa6c758c3ed27a3b1645a1c80b8a7ce90024ea73cc205a4c02357adb540:eyJzZWxlY3RlZExpbmVDb3VudCI6MTIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjRmMmEyZjk5NmYwOGU2ODBiZDI5MjEzNWE2ZmE0OTc4YmRhMjZlNjAyZDg0ZjMzY2IxZDU5NDc3NWQ0MzA0YjUiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjI3ZTU3ODhkNWQ5ZDczZDI0YTgxZGJjMGE1YTc0YmZhODJjOWMzYjNhZjk5ZTUyYWY3OTZlOTBiNDY4YThhM2QiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjFkYjNlN2NkMGMzYTYyMzA0NzY2ODE2MWQxMDRlOTlkODYyMDljYTNlNzc1NGEyNWIxMTlhNDkwNzg3ODA0MjYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImQwNjA5NzQ3MDYzMGQwZDdjOTFhZTNjYTg2ZWQ2NGQwODBhNWZkYmRhMTcwZDk5Njg0YjZiMjUwNWZlZDE5YTMifQ" + } + ] } ], "verification": { "by": "openwiki/0.6.0", - "at": "2026-11-20T15:09:12.940Z" + "at": "2026-11-21T16:26:45.303Z" } } diff --git a/openwiki/.claims/subsystems/server-signaling.json b/openwiki/.claims/subsystems/server-signaling.json index e4c9b9a..c7a9435 100644 --- a/openwiki/.claims/subsystems/server-signaling.json +++ b/openwiki/.claims/subsystems/server-signaling.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "pageVersion": "sha256:98cbb4940e4957cfe32aa59d9f472f3125cc4294d346ed1ca1b81fb90f2adb5a", + "pageVersion": "sha256:9d310c510b156c3fec1b35536862fb9edf8b2da2a0b57caa112c2107ab13b216", "claims": [ { "id": "claim_1d82fd64055a4062925029c4ae4e6575", @@ -31,8 +31,8 @@ "statement": "handler.NewHandler refuses to start when APP_CLIENT_SECRET is empty, because the admin endpoint would otherwise be open to unauthenticated requests.", "evidence": [ { - "resource": "repo://server/pkg/handler/handler.go#L155-L168", - "version": "repo-lines-v1:sha256:2947573de4270d3c8eacbf28d620c59408701070d5be0820837c238de7e47bf0:eyJzZWxlY3RlZExpbmVDb3VudCI6MTQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjZhOWEwMDI2OTVhY2JmNjViMTU3ZDY1NzlmNjQyNzkxYWQ4NDgwMWU3ZGE4MjY2OTU5MzcxMjg5NTA1MzMzMDEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjVmN2FmODVhOTk1ZWY1YmY3ZWQ5MmIxMGJjOWM4Y2I3ZWJkYjBkZjQ4NzEzYzM0NDg5MjI5ZTBiNjc4OTliMTgiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImIzNmI0MGIxYTY4YTUzNjJlYTk5ODNlNGM3ZjZjMmQwYWQwMTJhMzc3YWQ5N2I5MTg1Mzc2NDk3NGZlMWFkYjcifQ" + "resource": "repo://server/pkg/handler/handler.go#L149-L162", + "version": "repo-lines-v1:sha256:4f9fab459ef4fc93563cff9854deb4866869dd16276516f1aeb0f54a071aaae8:eyJzZWxlY3RlZExpbmVDb3VudCI6MTQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjlhNDQyNDQ1Mzc4ZTc3ZTMxMzliODkxMzc1OGRlN2IyMjNiMjcxNzBmMWQ3ZGM1MGRhMzcxNWQyMDc3Y2JhNmIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjhkYWU1N2Q4YjMzYjc3NmMyZmM0M2NlNDA1Nzk1MDRkMGJjOGVhNjJhNDNjMDJjNTgyYTJlNWJhYWYzYzZjYWQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImIzNmI0MGIxYTY4YTUzNjJlYTk5ODNlNGM3ZjZjMmQwYWQwMTJhMzc3YWQ5N2I5MTg1Mzc2NDk3NGZlMWFkYjcifQ" } ] }, @@ -79,12 +79,12 @@ "statement": "The server applies an in-package token-bucket rate limiter (rateLimitMiddleware in pkg/handler/ratelimit.go) at 60 requests/minute with continuous refill, answering 429 to excess requests; keys idle longer than 2 minutes are reclaimed by a sweep running at most every 32s. It is keyed by the socket peer address (IP:port, unspoofable) by default, or by the outermost X-Forwarded-For IP only when APP_TRUST_PROXY is set (which must only be enabled behind a proxy that strips or replaces that header). The separate clientIP() helper, which drops the port so all connections from one client IP share a hub, derives the hub ID for IP-keyed hubs, so behind a trusted proxy the IP-hub ID tracks the real client IP rather than the proxy socket address.", "evidence": [ { - "resource": "repo://server/pkg/handler/handler.go#L189-L241", - "version": "repo-lines-v1:sha256:145e3a1827df611976450bc8c970aaec380f1d3c79ae03dd11125521a40b5b08:eyJzZWxlY3RlZExpbmVDb3VudCI6NTMsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImIzODA5ZDUyMzI5OTc0MjcyMDMxNTBkZmNkY2VhZWIxNjYwYzM3ZWVjNjE1M2JjMzBkYTI5ZjhmY2VmOWQyYmEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImU5ZDc3NTNjM2ZmNjlmNmI5ZTliOGM5ZmRkMzQwMzQ3ZTk0MTNmNDU5YWQ2ZGQ5NTRhNmMzYWZkYmI4Zjg0ZDIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjBkODFhN2ZhYTI3MGUwOGVhNGFlMmQ3MGEwZWU5NmJiY2U4YjVjMWUyOGUwZGJlYWVlN2ZmNDc4NDc3YjRlNjkifQ" + "resource": "repo://server/pkg/handler/handler.go#L183-L236", + "version": "repo-lines-v1:sha256:c28b77802d6fd44553e005dac5f3189f3a9062fa994ac99aec815f6a2bbe9948:eyJzZWxlY3RlZExpbmVDb3VudCI6NTQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImE2NjAyZmUzMTVhNTBlYzA0MzVmZTlkYTM4MzcwMDJmZTIxZDUwMjdhOTdjZjcwZDJkNDczNjA3NWRlZTAwOGEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjAxYmE0NzE5YzgwYjZmZTkxMWIwOTFhN2MwNTEyNGI2NGVlZWNlOTY0ZTA5YzA1OGVmOGY5ODA1ZGFjYTU0NmIiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImU5ZDc3NTNjM2ZmNjlmNmI5ZTliOGM5ZmRkMzQwMzQ3ZTk0MTNmNDU5YWQ2ZGQ5NTRhNmMzYWZkYmI4Zjg0ZDIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImZmYTBiNjQxYjFhNWRiNTBkMTg3MjI5YjUzZGMyM2FmMDRlOGY3ZGU5ZTNlNWJlNmZjZWM1NzNkYTBmY2U2ZGMifQ" }, { "resource": "repo://server/pkg/handler/join_or_create_hub_ip.go#L15-L35", - "version": "repo-lines-v1:sha256:632fce18f03e3c54e330994f05848cb1b34a6ca79c3f079624ef4f1a72ecf22b:eyJzZWxlY3RlZExpbmVDb3VudCI6MjEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImY1NmQzOGRmYmYzODk4OWRiMmNjOTA1ODY4YWJiNGJiZGUzNWJlNzZiNzk2MDRhMzI0ZjA4NTlkZjE1NGQxYmUiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjFhZmUyZGY5MGIwMTk3NGM1N2Q3NmJkYmRkMjEwMDU4ZmNkNWUxZGE3MWM2MjljNzg1NDQ0NDY3ZGYwNjE5MzciLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImU3M2ZjZmEwZDFhOWE0M2NjOTMzOTBmNzkxOWUyOTlmMWZiNWU5NzQ5ZTg2ZWVkOGVjMjhiZDlkNjk3ZDBhOWQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjoxLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEifQ" + "version": "repo-lines-v1:sha256:f9da88112366f175472425253ba6204f68ad3bbaeaa6b05a4420b988ad8ec7b5:eyJzZWxlY3RlZExpbmVDb3VudCI6MjEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImY1NmQzOGRmYmYzODk4OWRiMmNjOTA1ODY4YWJiNGJiZGUzNWJlNzZiNzk2MDRhMzI0ZjA4NTlkZjE1NGQxYmUiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjFhZmUyZGY5MGIwMTk3NGM1N2Q3NmJkYmRkMjEwMDU4ZmNkNWUxZGE3MWM2MjljNzg1NDQ0NDY3ZGYwNjE5MzciLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImU3M2ZjZmEwZDFhOWE0M2NjOTMzOTBmNzkxOWUyOTlmMWZiNWU5NzQ5ZTg2ZWVkOGVjMjhiZDlkNjk3ZDBhOWQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjoxLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEifQ" }, { "resource": "repo://server/pkg/handler/ratelimit.go#L10-L25", @@ -101,16 +101,16 @@ "statement": "Zero-downtime migration: an authenticated /v1/admin/migrate?host= call first validates the host with validateBackupHost (a bare host or host:port, rejecting any scheme, //, path, query, fragment, userinfo, or out-of-range port with a 400 without touching state), then sets backupHost under a read-write mutex and atomically flips isMigrating; while migrating, create/join-or-create requests are rejected via ForwardMigrate, which upgrades the connection and sends a going-away close (code 1001) whose reason is the backup host so clients reconnect to the new host.", "evidence": [ { - "resource": "repo://server/pkg/handler/migrate.go#L131-L171", + "resource": "repo://server/pkg/handler/migrate.go#L128-L168", "version": "repo-lines-v1:sha256:dbbbd4fac8312d1feb73e67668086551b1958a728e14da9dc391754781034878:eyJzZWxlY3RlZExpbmVDb3VudCI6NDEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjIwZDc4NzcwYWMxOTBhNWE2NjQ3ZjIxOWIxMWNiMTlkOGFhY2I4N2NhMDY4N2IyOTRiNDIwNGRlZDczYzk4NzMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6Ijg0M2ZiODZlNTlmNmQzNGRmOWZiZWE5MjM2YzJiY2Y5MTgwYjBmYWQ3MGNjMjYyYWM2NGY5YWEzZTc1ZTVlY2MiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" }, { "resource": "repo://server/pkg/handler/migrate.go#L27-L58", - "version": "repo-lines-v1:sha256:25c4fe50355c2b330abb396e45bbb7fe563dcf54345deb8431d94c2beddf775a:eyJzZWxlY3RlZExpbmVDb3VudCI6MzIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQ4YmFmMmYwYzMzNjMxYTg3MThiZmQ5OTdhOGRkZmJjOTgyYzM2ZTQxOThmOTgwMWIwZTkzZTQyZTZjMWJiMjEiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjI5MmQ2ZjFlMTUyNmMyNmY0NTRmMWE4YWVkM2FlYjU4ODZhMGU4YTJkZjYxYjZjZTRmNDdkNzg5M2MyZmI1OGUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImI2NWQ2Yzc1NDdmOGJjZDg1NDEwMDZhZDYzMGI4YmE0NGMzNmZiNDAwNmJhOTMyMTM1ZWYxNDNiYzhjMGMwMTAifQ" + "version": "repo-lines-v1:sha256:4bad56a74e310faacad9bb09167dd47c12911b2a1ec2430b7bbdccbfa6ca91ab:eyJzZWxlY3RlZExpbmVDb3VudCI6MzIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjFiOWZjYjM4NDc2MDBhZGZkZjQxM2I4YmZmOTM5NWU2NDkzMWQyMDgwMzFkNzkyMGMzOTJkM2NkNmViZmZkYTkiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjI5MmQ2ZjFlMTUyNmMyNmY0NTRmMWE4YWVkM2FlYjU4ODZhMGU4YTJkZjYxYjZjZTRmNDdkNzg5M2MyZmI1OGUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjkyMmZjODU4YjUzODEwNGJiZWEyZmIzYThhOTFlZTg4MWIxY2VlNGRmNWExMmQ2ZTIxODM1ZGMwZjg5MmU2Y2YifQ" }, { "resource": "repo://server/pkg/handler/migrate.go#L60-L98", - "version": "repo-lines-v1:sha256:7bf88b7164614246a8b87c3a40cb13f76ca4b4e473bc86d6c9939d974d526310:eyJzZWxlY3RlZExpbmVDb3VudCI6MzksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjY5MDRhZDYxMTcwZjY2OTk4MDBmN2Y3MzRkNjQ1OWU0MTg4MzkzNzY1ZWMxMDdjMTIyMTU5Njc0OTAxNGRkZDYiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjE2MzFiNmUyY2EwN2Q4YmFmMGViNDRlNzQ5ZGJmNDkwYjM5MmUzYTUzNGVmNjEwMjI3NzExNDZjZGY5YWYxYTIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjFmNGZlMjA3YzY4MjkxOTZkYzkzZjMzMTcxYjlhYTM2Y2IzYTBiNmYzZjUwMWRmMTFmZDAwNjdiZTYxMDAzNTYifQ" + "version": "repo-lines-v1:sha256:7d107b4d95514da4580e6cb1713c4dd741ca03f2e85011a07788e1fe36999cd9:eyJzZWxlY3RlZExpbmVDb3VudCI6MzksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImQ4NDViZTViYmQzYTNiOTgxM2UzMzgyNzk5MzIxZmY5N2RiZDUyYjg4NDY5ZTBiYzM1ZjU3NjBmOGY5NzIxYTkiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImVlNjEyNDA2ZDE0ZWI0Zjc5NTdkNGY1NjE1OTBmYjFmNGYyMjkyNmQwMWZhZjc5MjViZTUwOGJhZjc2MGIxZWIiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjE2MzFiNmUyY2EwN2Q4YmFmMGViNDRlNzQ5ZGJmNDkwYjM5MmUzYTUzNGVmNjEwMjI3NzExNDZjZGY5YWYxYTIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6Ijc1NTA5YTg5NzllZjUwNGQ0MzkxNDFjNmE0OTUyNDdiM2RlMDEwOTE3ZGE0YjYxZWRhOWIwYzc5MWYzNjY4M2QifQ" } ] }, @@ -143,8 +143,8 @@ "statement": "CheckAdminAuth compares the base64-decoded Authorization header against APP_CLIENT_SECRET using crypto/subtle.ConstantTimeCompare, which closes the timing side-channel that a plain non-constant-time string comparison would leave open; on failure it writes a 401 JSON body and returns errAdminUnauthorized so callers perform no state mutation after an auth failure.", "evidence": [ { - "resource": "repo://server/pkg/handler/auth.go#L21-L38", - "version": "repo-lines-v1:sha256:7ecbbd4e0f945d8ceb6ef92a6c806cc98634b9e46c7c18665c324cd2ceb1900d:eyJzZWxlY3RlZExpbmVDb3VudCI6MTgsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjRkYTEyODNhOWRiNzAyMjc1YWUzMWZkZDBlMzRkMDIzNTMxYmM0NTIwNjE3ZWJiZDcxOWRiM2YyODRiMjE5MmQiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjQ0ZDgzYjgwYzM3NjNhMWIzM2ZjNGM4ZDk3ZjliM2NiMTI1ODZhYTk5NDQ3MTM3ZmY1YmM1OTYzMjNiMmVjODgiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjoxLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjAxYmE0NzE5YzgwYjZmZTkxMWIwOTFhN2MwNTEyNGI2NGVlZWNlOTY0ZTA5YzA1OGVmOGY5ODA1ZGFjYTU0NmIifQ==" + "resource": "repo://server/pkg/handler/auth.go#L18-L38", + "version": "repo-lines-v1:sha256:8a02579e0ee4ba30f05694e21573e2cdd853ada9b74fddf3bb3996fc7f649150:eyJzZWxlY3RlZExpbmVDb3VudCI6MjEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjdkNDZiMTE3NzdjYzc1MDhmYTM4MjVmNTNiMjhkYzJhODU0ZDUyZWQ4MWM5MWNhM2RiZTdmMjFkZWM5MzNiOWQiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjhiODMxYTNlMjI3ZjZjYzVmOGIwMGE1ZjUyMzE3MGJhMjZmZjI1MGUxNzFkMjY0ZDdlZGYxNGE1ODNkYTdlNjUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" } ] }, @@ -153,8 +153,8 @@ "statement": "/v1/status is a public read-only health and migration endpoint that answers with a static Access-Control-Allow-Origin: * plus Vary: Origin, a constant rather than a reflection of the request Origin header, because reflecting an arbitrary origin is the classic CORS anti-pattern and is unnecessary when the endpoint is open to all origins; the exposed status and backupHost data is considered public.", "evidence": [ { - "resource": "repo://server/pkg/handler/status.go#L7-L28", - "version": "repo-lines-v1:sha256:c51794d6b07f3deb1a52d71f056a69079608765b0827695d32d048e3a75858b5:eyJzZWxlY3RlZExpbmVDb3VudCI6MjIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjNjNTViMmViMzE4YzRhZTE3OTQxYmVjNjExMjQ3NjA2YWMxZTg1ZWYzZmIyMmJjNzNhMzZhM2E4MTRkZWZiZjMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjNmNWM4MTI2OTkyYmRiZjM1MjQyOGM3ODE4N2RmZjQyM2FlMDAxNDc0MTJhYjM3NGJlYjYxYTk0NWQ1OGVkZDIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" + "resource": "repo://server/pkg/handler/status.go#L9-L28", + "version": "repo-lines-v1:sha256:15f48c9217f5ee61b26afbe2251f9ec8f7ce1dbfe7dbbb7afddb97115189bc07:eyJzZWxlY3RlZExpbmVDb3VudCI6MjAsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImE3OTFhYzExNTYwYTExZTgzOGIyN2NmNTA0YTNhYzBjZDY0YWEyNDRjMzg4MTg4OTBlYzM2Y2RlMzhkMmQ3NjciLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImEzNzZjOTgzZTg1NjIxZDAwNmRhNTc2YWMyNmMzZTkxZjY0ZDE5ZTQ0ZDhjODdmMjljMjhmOTcxYzNmZTFjNTkiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" } ] }, @@ -163,8 +163,8 @@ "statement": "When the WebSocket upgrade does not fully succeed (a handshake error, or the up-front peerMetadata rejection that already wrote a 400/413 with responseWritten=true) AddPeer never ran, so the hub holds no peer for this request and is empty; CreateHubByID and JoinOrCreateHubByID therefore pass a rollback to the shared finishUpgradeFailure epilogue that calls zh.RemoveHubById on that hub to prevent an unbounded empty-hub leak on memory storage. JoinOrCreateHubByID removes the hub only when this call created it, since a pre-existing hub may hold live peers, and when responseWritten is true the already-written 400/413 is returned as nil instead of being overwritten by a 500.", "evidence": [ { - "resource": "repo://server/pkg/handler/create_hub_by_id.go#L8-L39", - "version": "repo-lines-v1:sha256:987c7492681e34c87df59ff2c7ede5a95021575420daff4e01a1264befb3c7b7:eyJzZWxlY3RlZExpbmVDb3VudCI6MzIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImM5MWY2Y2VhMDM3MmVhMmQyYWIyOTM0MjMzNjY5N2FlZjc2MzNkMzMwZGU2MzYxMDE3OTQ4Y2M1MGI5OGNhZmIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjY3Y2RhODJkYTYwNjIzOGUwNWU2MjM5OTU2OWM1ZWUwMzk5MzQxOTY0OGFlNWQ0M2EyYmY4Y2Q2MzQ3ZjgyNjMiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjNmNWM4MTI2OTkyYmRiZjM1MjQyOGM3ODE4N2RmZjQyM2FlMDAxNDc0MTJhYjM3NGJlYjYxYTk0NWQ1OGVkZDIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjUyYjE5MjJjZTExMzUyNGEzOWFkZGM5YzY3ZDBlNzBiZTFjNDdlNzNhODE1OTA0YjA3Y2RhZTc4YzU0NTg5YmEifQ" + "resource": "repo://server/pkg/handler/create_hub_by_id.go#L13-L42", + "version": "repo-lines-v1:sha256:946e33a72857e09f341cfbfcd5a4f0c3a763544d389aca22fa062a36c40f5200:eyJzZWxlY3RlZExpbmVDb3VudCI6MzAsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjdiMmZjYTgyMDdlYTI0MGNhMjI4YmI5MzJmODkyZDdkOWM2ZGEwNzI1MjgxNWNlYTZjOTk1YjBlZTg5YThlNDUiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjY5MThmYzU1OWQzYmQ3NmE1MmU3YjVlMTA4ZGUwYTcxZWIzZWQ2NTIzOGFjZmYyZjkxMTM2OTJmNTNmMWY3OWQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" }, { "resource": "repo://server/pkg/handler/join_or_create_hub_by_id.go#L44-L51", @@ -175,8 +175,8 @@ "version": "repo-lines-v1:sha256:43d758688c30b670b79d6bb331c42c6d15b08ec7a165023a5a5949ed73437ce7:eyJzZWxlY3RlZExpbmVDb3VudCI6MTYsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImYzYmY4NWM4NWU4YjBkMmY3MDRhOGIwNThhMWM0MThmNmNiMjAyNzkyOTJjODI1ZTA4ZWI5ZTI1MTM5ZWRkOGMiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImY3YjI3NmFkNjRlYmQ1OTU4ZDJhOTdhYWM4YzFhYjQ3ZTI4OTIxMjgyYzdmNGFhYjIyYjMxYjQzZWE2OGQ2NDgiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjMyOGE5MDg1OTUxZmI3ZDlmODdhYzQ4MTFkMjA4MjZhZmQ4NzhjYWFhMWY3M2E1NDExOGJmOWUzZWY1YmQwMzQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImYyOTY0MDc5YzNjNWM4MTUyMGVmMzNhMmI5ZDJlMTVhMWI4NGQ3MjgwZGI4NTkwZGNkNjU3NDdlM2UwMTJhNDAifQ" }, { - "resource": "repo://server/pkg/handler/websocket.go#L247-L265", - "version": "repo-lines-v1:sha256:fe7da2a377544cb54499153052c34cf9b6ed514a1910d1f8c88e189cd02cb423:eyJzZWxlY3RlZExpbmVDb3VudCI6MTksImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjJkMWU3ZmIyZDY3ODA5NjhhMWExMDI1MGUxODdlODhjNmIxNjNjN2Y0NjdkZTBmNzgyMGRiYWZmYmEwYjdjZWYiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6ImQzNmEwMTBkMjNmYmEwY2ZhNzVlZTdlZTA2ZTgwNzFmYmEyZTFiZmVhZjU5MzU0MWVlODFmYjA4ZjIzNjM0ZmUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" + "resource": "repo://server/pkg/handler/websocket.go#L247-L272", + "version": "repo-lines-v1:sha256:f9d87fe83a5f50f4051e93e3e6c5c7ced39b3bb743a16890b9f4250be88c5fef:eyJzZWxlY3RlZExpbmVDb3VudCI6MjYsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjVkMmNhY2YzZmYxNzk0YmE3ZWNiODVkYmE5YjQyMTQ3MTI2NzNmYmQwNWY5MGQzNGI3M2QzNjJlMjNhZmZkZWUiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjQxYWQ2NWNmNjhmOTc5YjE0NzViOTAzZWViYzI5NTFhYmU5OTg1MGZhM2UzODViMWQ3NTgzNmRmZjMyNGZkYWUiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" } ] }, @@ -186,19 +186,19 @@ "evidence": [ { "resource": "repo://server/pkg/config/config.go#L39-L44", - "version": "repo-lines-v1:sha256:c67150ec03f4820a0b7ba2c5b06f20808e73f6697724b3b3563f23a030ad0237:eyJzZWxlY3RlZExpbmVDb3VudCI6NiwiZmlyc3RTZWxlY3RlZExpbmVIYXNoIjoiNTUwNTZjNWRlNDRkOGYxOTQ2ZmNmNDk1MzA0MTQ0NDViMzU2OTg0OTZmMDQ0NmQzMmZiN2UzYmQ2MzRmZDlhNSIsImxhc3RTZWxlY3RlZExpbmVIYXNoIjoiOTQ4NjMzMmM3ZGNiN2JiMGI2Mjc1OGY3MmExZjM1ZjMyN2RkMmVkYzhkZDVlNGY2OGUxNWFkYzA2YzZlMjY1YSIsInByZWNlZGluZ0NvbnRleHRMaW5lQ291bnQiOjMsInByZWNlZGluZ0NvbnRleHRIYXNoIjoiY2RlNGE5NTU3MmVjOGYzZDlmZTlhZGY2MDEyMDdjMDQ3MmZmMmM4ZTZiZWIwYTI2YjhiYjY5ZTkzYzEzNjYyOSIsImZvbGxvd2luZ0NvbnRleHRMaW5lQ291bnQiOjMsImZvbGxvd2luZ0NvbnRleHRIYXNoIjoiMTA2OGM5MTdjZTEwN2VmMjMzM2U2YjhiYmQ4MDBlMDZlMWE2MThjNmNhNmRjYjU4ZGVhZmI4MDhlMzIwZjRiMSJ9" + "version": "repo-lines-v1:sha256:7cf2433c16aefc27796a8b20b6e7363b9b437d502057f87cf18199c2320bd000:eyJzZWxlY3RlZExpbmVDb3VudCI6NiwiZmlyc3RTZWxlY3RlZExpbmVIYXNoIjoiYWU5OTg4MTYyZGVkYjRhMjc3NTAwNDJkZTg5NjA4Zjc2NTk3MmNkOTA0MjA1ZmU5YzBkMmY1ZjQ0YTJhNzFmYyIsImxhc3RTZWxlY3RlZExpbmVIYXNoIjoiMDFiYTQ3MTljODBiNmZlOTExYjA5MWE3YzA1MTI0YjY0ZWVlY2U5NjRlMDljMDU4ZWY4Zjk4MDVkYWNhNTQ2YiIsInByZWNlZGluZ0NvbnRleHRMaW5lQ291bnQiOjMsInByZWNlZGluZ0NvbnRleHRIYXNoIjoiZTk5ZGQ2MGE4MjQ2MmQyODhhOGNhZDU2ZjI5NGJjYjAzMjIxNmNkNzBhYTY1MGVmNWU3YTMyMTgyODc0NWFiNSIsImZvbGxvd2luZ0NvbnRleHRMaW5lQ291bnQiOjMsImZvbGxvd2luZ0NvbnRleHRIYXNoIjoiNTlhM2YzZWFiNDJjZmVhMTcxOTE5YjI2NTU1ZTJhMDZhMmJjYmI2ZTRhYzZhMmUyN2I0OWViYzU1YjY3ZTE0NyJ9" }, { "resource": "repo://server/pkg/config/consts.go#L36-L46", "version": "repo-lines-v1:sha256:e33936044893c8739e0ffc7497fb4a14a01ab1394fcbcd52ab47edb580dfa691:eyJzZWxlY3RlZExpbmVDb3VudCI6MTEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjcyYzU5Mzc0M2VkNTM4M2I0YmJhNzQ5ZGEzNTRjNzY4ZGQ4YTFlNDRiM2Q3ZDI5MTBhMWNhMTNhMzk3ZmZiNjYiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjVmZWQyYzVjN2E4OTBjYjU1NzZmN2NmMGFkMDIyNzhmYjIzMTYxZjQ4ZWNmZGFmNDg3OGU3NTg2YTMxODRmOTAiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjVkMDA5OWJhZTdmM2EyOTk4N2I2NWJiOGY3OTMwOTY5MmI0ZjU1NDg2ZDhlNWY4MzkzZDBjYjM5MDg0NDViY2QiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjoxLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImZhZmJhMDUyN2MzOTUzYzRiNmUwZTViNTczOWJhODM2MTJmODA1M2JjZGM5NDY2NzMwMTkzY2QxZDU5MGI0MDgifQ" }, { - "resource": "repo://server/pkg/handler/websocket.go#L107-L114", - "version": "repo-lines-v1:sha256:6533ef29a9af0375e34c5465db2791b8b810f986f38789298c38ba70d81efcce:eyJzZWxlY3RlZExpbmVDb3VudCI6OCwiZmlyc3RTZWxlY3RlZExpbmVIYXNoIjoiMDQ1N2YzMTQyZTg3MWUyYTI3ODViZmViNzYwZmEwODcyOWUzZDU3OGU2OTY4YjM1ODBhZWUzYzMwYmUyZmU2NiIsImxhc3RTZWxlY3RlZExpbmVIYXNoIjoiOWYxMmMxOGJiM2UxOGFlODEzYjEzMTY2M2RkZTAxNDMwNzNiMmI1MjQ0Nzc0NDExNjUyNzE2NjhhMjE4Yjc0NSIsInByZWNlZGluZ0NvbnRleHRMaW5lQ291bnQiOjMsInByZWNlZGluZ0NvbnRleHRIYXNoIjoiMDQzNzMzNzk5ODI1YWI0YzA2N2QxNzQzYThiNDE2YzBkMDcwNjQ1MDljMWQ3MmM3M2QzZTllNTFhMjA5M2NkMSIsImZvbGxvd2luZ0NvbnRleHRMaW5lQ291bnQiOjMsImZvbGxvd2luZ0NvbnRleHRIYXNoIjoiZDRlODc4ODcyMjQwYWFkOTFjNjlhNGJiMTA4ZGU1ZGYwYTE4YWY4MjRjNjJkOWFiMDFlOTJlNmQzMDkxZjI4YSJ9" + "resource": "repo://server/pkg/handler/websocket.go#L119-L125", + "version": "repo-lines-v1:sha256:07a4210ae283693103ba14bac50cd72a8573aae0ff26e2649e9135679cf3ee04:eyJzZWxlY3RlZExpbmVDb3VudCI6NywiZmlyc3RTZWxlY3RlZExpbmVIYXNoIjoiMzQ1ODgwZjk2MGQwYjNiZGJhMzYzZGE0MTI0MmMyNzc5M2Q3NzFhYzNiMjc1ZjVjZDNhYjUzMzBmN2ZjZDUzOCIsImxhc3RTZWxlY3RlZExpbmVIYXNoIjoiMDFiYTQ3MTljODBiNmZlOTExYjA5MWE3YzA1MTI0YjY0ZWVlY2U5NjRlMDljMDU4ZWY4Zjk4MDVkYWNhNTQ2YiIsInByZWNlZGluZ0NvbnRleHRMaW5lQ291bnQiOjMsInByZWNlZGluZ0NvbnRleHRIYXNoIjoiMDk0YjE4YTQ5Y2VmZjI1MWZlZjMzODJhMTcxZTJkNDYxNzEzYTg1YTk2MWUxNmQ3YWRmNjg0YjgyNDIyYzAzYyIsImZvbGxvd2luZ0NvbnRleHRMaW5lQ291bnQiOjMsImZvbGxvd2luZ0NvbnRleHRIYXNoIjoiZGFmMmQ2YWIxY2VkOTBkNjE0MzQ5NzQxMWI5MmI5OWEwZDdjYmVjMDNlZjBkMTQ4OWE4NWRhYjhhZTcxMGFkMyJ9" }, { - "resource": "repo://server/pkg/handler/websocket.go#L32-L73", - "version": "repo-lines-v1:sha256:1c0318871909485439a85bb95f13735e78a5f6befb6ccb926eeff520d5aa8132:eyJzZWxlY3RlZExpbmVDb3VudCI6NDIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImRlZGQxN2RjNmZjNWEyMWE4Yjg2YTFhYmMzZTcxNTdjYmQyNmM1ZjM1ZDlkYjljYWYwMzMzYzc4ZGI5MTM0NDgiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjI2OWFlMTNmYTJjZDliNGFmYzIwYTcyYjJlMjRkOTQwNzU3ZDk2NmY4MGNlZmQwZmJhYzZjNjZlM2NlMzQ0NzIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImY1NzY4ODBhYTQ2MTVmMmI5ZTRjMWU1ZGEzODVjMDlhMDdlODg2N2M4NjNhZTIxN2MwNDY4ZWIyYmM3ZDYzZTYifQ" + "resource": "repo://server/pkg/handler/websocket.go#L22-L73", + "version": "repo-lines-v1:sha256:aef0c98a07405f75cced5b1373db82c43f3608d17cd3e7f00c538c9870d31456:eyJzZWxlY3RlZExpbmVDb3VudCI6NTIsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImM3MzdkMDMwYWI0NTAzOTFkMWExNzQ4Y2U5ODMxODQ3MjkyMTUwZDlmYmEzZDFkOWZjYzFmN2QxNjlmNDUzZjYiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjZhOTFlZDJlZDcwODk5Y2UwOTA2NWFjZDI3NDNhZWRiMTBiZTM1MzFkODk3ZTQ2OTNjODMxNzZiYmNjMTBkZTkiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImQxZmVhMzQyMWU1ZjM3MThjNjY5YzdiNWRiOWRiYzBkNDVjYjRjNTFkMDBhZmMzNzQxYjZjYjgzMDM5ZDMyNzIifQ" } ] }, @@ -207,16 +207,16 @@ "statement": "Every user-chosen-hub-ID path (CreateStaticHub, CreateHubByID, JoinOrCreateHubByID) holds h.hubIdCrossModeMu across the shared claimHubForCreate/claimGetOrCreateHub helpers, which probe the sibling hub modes' storage and claim the ID under one lock, answering 409 when a sibling already holds the ID; generated IDs (random UUID, IP FNV hash) also take the lock, but their probe always misses so the guard is a no-op there.", "evidence": [ { - "resource": "repo://server/pkg/handler/claim_hub_for_create.go#L13-L43", - "version": "repo-lines-v1:sha256:2976e2b93581e27c3093b88950dcda975c2a9ff63522558e7bf7a0f69bee0b80:eyJzZWxlY3RlZExpbmVDb3VudCI6MzEsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjgxMWFhM2FlNmMxOTc1NmM5MDVhZWZiMTQ1OGZlYjg5YjM4MWFjODQ3MmYxMDM2ODZlNDAzZjJkYzMwYTBiZTYiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjNmNWM4MTI2OTkyYmRiZjM1MjQyOGM3ODE4N2RmZjQyM2FlMDAxNDc0MTJhYjM3NGJlYjYxYTk0NWQ1OGVkZDIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" + "resource": "repo://server/pkg/handler/claim_hub_for_create.go#L19-L43", + "version": "repo-lines-v1:sha256:a815783dc924d8784560c6d4c563f0ca8cfe4ca7ddcefb5b510f7728344b07cc:eyJzZWxlY3RlZExpbmVDb3VudCI6MjUsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjNkMTMwNDk3NDJiOGY4YTk3ODJkY2FlYzNmZGZkYzM0MjE5OTdiZjIyNzI2OTc3MzUyOTUxZTQyMjYwYWMyYTIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6Ijc4ODBlYWU4MGIwNjZkYjVjMTU1ZGQ1YjZmYmRiNzYyZjY1ODgyMzFkYzBkODgxMTkwN2VhYTdkNWIzZDUzYjQiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjowLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6ImUzYjBjNDQyOThmYzFjMTQ5YWZiZjRjODk5NmZiOTI0MjdhZTQxZTQ2NDliOTM0Y2E0OTU5OTFiNzg1MmI4NTUifQ" }, { - "resource": "repo://server/pkg/handler/handler.go#L110-L129", - "version": "repo-lines-v1:sha256:eb603d35be316e68c2f66b0be7ee5f9f24ad5799c574e54264e64085f7be1cfe:eyJzZWxlY3RlZExpbmVDb3VudCI6MjAsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6ImJkODA1NWM1ZmI4YzU0NTZkOTVjYmQ4NGRhZWJiYWUyNGIyYjQ1NWRjMzI4NjMyOGJiYWJlMjYxYTc3NzkwMGYiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjI0NThlNWY0Mzc1YTdjYWU3NzczMzAyZDE4ZGNkZjhjNzBkZDMzMDViNDMwZjQzZjA0ZjU4OWI1NGUxYWViMTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjVkZjE2YTYzZjE5ZjhjNTEyMTIwNTFhYzVjYmQ0YTc5N2JmNmY0MTdkMTQ5NTJjMzliZmFlMDc1ODViOTY0OWMiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjU2ZjAzOWRkMDYzNzA1NjA1ZTdmOTNmNGRhYzI1ZDlhYTUxYzAzNDU5MTk4NGY2NTdiMWYzYTNkYzZkNzI2NDYifQ" + "resource": "repo://server/pkg/handler/handler.go#L100-L123", + "version": "repo-lines-v1:sha256:2ef0889ea5949c2fd5de732e34c39bf632efb69a0bdecf0aacb65afe4eb50888:eyJzZWxlY3RlZExpbmVDb3VudCI6MjQsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjBkNmEyNGIxZDU5ZGY3MjdiYTViNmM0MzE4NTUyNzk4YzcyMjAzNzJkNmFiYmM1OWU3YzAwMjhjNTRjMWY5ZmIiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjI0NThlNWY0Mzc1YTdjYWU3NzczMzAyZDE4ZGNkZjhjNzBkZDMzMDViNDMwZjQzZjA0ZjU4OWI1NGUxYWViMTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjM5ZDdjMWM2ZDc5NDk4MjkwNjg5YjYwZTU5ODg0MGQ0N2RmOTk3M2M1NzRlZTFlNGQyYmMzNmU3NGM4N2NjZTAiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjU2ZjAzOWRkMDYzNzA1NjA1ZTdmOTNmNGRhYzI1ZDlhYTUxYzAzNDU5MTk4NGY2NTdiMWYzYTNkYzZkNzI2NDYifQ" }, { "resource": "repo://server/pkg/handler/validation.go#L124-L141", - "version": "repo-lines-v1:sha256:de1decf171d4a326b289fdbdd78a7861720a2382c4a623ba4a76daf89c159540:eyJzZWxlY3RlZExpbmVDb3VudCI6MTgsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjY5ODI2NjJiMjBkZDkxYWNmNmE5ZDNlMTUxMGM1YWVmMmEzNWFlNjc4NzU0ZjljZWU3ZTUzYzc5OTBjMjhkMDkiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImJiZTEzZTYxYTc5OWE5ZDJjNjAwY2MzMDMxZGRiYzFkMzhmOTlkMTdlZTlmMjU2NjMxNjQ5YTlhY2EwN2MzZTgiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjI1MGM0ZjkxYTU3NGIzNjEyZjAwMWRkNWYyZWNmOGM5MDZkYjliNzFkMGUxMDQ2YzI5NzE1ZWY5ZDc4MzgyNWYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjRkNzFjNjJlOWRjODBkNDRlMWYxOGM4MjBiMDljMjRlYTEyNmFkZGUzN2VhNDc4M2U3YTZhYzc4YzNjYzE4YzkifQ" + "version": "repo-lines-v1:sha256:965d3175f9f0c9a0e0211ef495823fd5b24cc9a77aa464d3fd119840ea4a1ee3:eyJzZWxlY3RlZExpbmVDb3VudCI6MTgsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjY5ODI2NjJiMjBkZDkxYWNmNmE5ZDNlMTUxMGM1YWVmMmEzNWFlNjc4NzU0ZjljZWU3ZTUzYzc5OTBjMjhkMDkiLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6ImJiZTEzZTYxYTc5OWE5ZDJjNjAwY2MzMDMxZGRiYzFkMzhmOTlkMTdlZTlmMjU2NjMxNjQ5YTlhY2EwN2MzZTgiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjI1MGM0ZjkxYTU3NGIzNjEyZjAwMWRkNWYyZWNmOGM5MDZkYjliNzFkMGUxMDQ2YzI5NzE1ZWY5ZDc4MzgyNWYiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjRkNzFjNjJlOWRjODBkNDRlMWYxOGM4MjBiMDljMjRlYTEyNmFkZGUzN2VhNDc4M2U3YTZhYzc4YzNjYzE4YzkifQ" } ] }, @@ -229,8 +229,8 @@ "version": "repo-lines-v1:sha256:96542a0f520a019fc7345dd5bb66c7f2ce7e82c14a99f41bfb46193655fe602b:eyJzZWxlY3RlZExpbmVDb3VudCI6OSwiZmlyc3RTZWxlY3RlZExpbmVIYXNoIjoiNzIzNTlmY2VhMTcwOThiMDZhMDM2MWJkZDA0ZTk1ZmVjNTAxZjNiODVlMmVkMGZlNTNiYzRmMWViNDYyNzUzOCIsImxhc3RTZWxlY3RlZExpbmVIYXNoIjoiNjdjZGE4MmRhNjA2MjM4ZTA1ZTYyMzk5NTY5YzVlZTAzOTkzNDE5NjQ4YWU1ZDQzYTJiZjhjZDYzNDdmODI2MyIsInByZWNlZGluZ0NvbnRleHRMaW5lQ291bnQiOjMsInByZWNlZGluZ0NvbnRleHRIYXNoIjoiMTg2YzU5OWRjMjQzMWRjZTI0ZjcwNmNhNWNiYTFmMjgxZjU5NTk1NzFhZmEwNGMyMWI2ZjU1ZTkyYzUyMGQ4MiIsImZvbGxvd2luZ0NvbnRleHRMaW5lQ291bnQiOjMsImZvbGxvd2luZ0NvbnRleHRIYXNoIjoiZWVhYWZlYjdmNGNiYjVmY2JlNzY1ZDk0OWRhMjc3M2ZiOTMwNTA0M2IzZTM2OTg0MTY2MTk2ZTYyNWRlZGEzOCJ9" }, { - "resource": "repo://server/pkg/handler/migrate.go#L100-L115", - "version": "repo-lines-v1:sha256:e880561d49c330c8f36522e69d69cf9ed1db4ebabd2ea31a4a9047c64cc498cd:eyJzZWxlY3RlZExpbmVDb3VudCI6MTYsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjgyZTUzMzVkNmE0NmY2ODY5YWI2MDAxMzY5OGRhNDM4ZGUyOTcyZGM4OWE3MGZlNDI3MzVlYWExNGQzMjI1OTciLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjE2MzFiNmUyY2EwN2Q4YmFmMGViNDRlNzQ5ZGJmNDkwYjM5MmUzYTUzNGVmNjEwMjI3NzExNDZjZGY5YWYxYTIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjFjZWEwODg1YTg1YjM1YzE2NWI4ZTI5MWYwNmE2YTRjN2MxNjg4ZTk0NDdiNzIyNzQxMTQ2YmY0MDc0MjEzMzUifQ" + "resource": "repo://server/pkg/handler/migrate.go#L97-L112", + "version": "repo-lines-v1:sha256:6be30ae6fda418d4fc4ce71c55dd39dc07e16c77e3cc84da9cf1696644cfb0d9:eyJzZWxlY3RlZExpbmVDb3VudCI6MTYsImZpcnN0U2VsZWN0ZWRMaW5lSGFzaCI6IjgyZTUzMzVkNmE0NmY2ODY5YWI2MDAxMzY5OGRhNDM4ZGUyOTcyZGM4OWE3MGZlNDI3MzVlYWExNGQzMjI1OTciLCJsYXN0U2VsZWN0ZWRMaW5lSGFzaCI6IjQxMmNhMzQ1Y2NmNzViZjljMDgwNmJjZTY5NWJlOGRlODA4Yjc5OTg0MjUxYTdhNTRkMjAyY2Y2MTAxZGQ0NTEiLCJwcmVjZWRpbmdDb250ZXh0TGluZUNvdW50IjozLCJwcmVjZWRpbmdDb250ZXh0SGFzaCI6IjE2MzFiNmUyY2EwN2Q4YmFmMGViNDRlNzQ5ZGJmNDkwYjM5MmUzYTUzNGVmNjEwMjI3NzExNDZjZGY5YWYxYTIiLCJmb2xsb3dpbmdDb250ZXh0TGluZUNvdW50IjozLCJmb2xsb3dpbmdDb250ZXh0SGFzaCI6IjFjZWEwODg1YTg1YjM1YzE2NWI4ZTI5MWYwNmE2YTRjN2MxNjg4ZTk0NDdiNzIyNzQxMTQ2YmY0MDc0MjEzMzUifQ" }, { "resource": "repo://server/pkg/handler/status.go#L23-L25", @@ -241,6 +241,6 @@ ], "verification": { "by": "openwiki/0.6.0", - "at": "2026-11-20T15:09:12.940Z" + "at": "2026-11-21T16:26:45.303Z" } } diff --git a/openwiki/.last-update.json b/openwiki/.last-update.json index 57adb03..27fbf9d 100644 --- a/openwiki/.last-update.json +++ b/openwiki/.last-update.json @@ -1,7 +1,7 @@ { - "updatedAt": "2026-11-20T19:56:37.091Z", + "updatedAt": "2026-11-21T20:15:35.224Z", "command": "update", - "gitHead": "6e8eceda77cd2ea7d3266fa1238293995a65198b", + "gitHead": "add399a18306645a43363ee252c81300474202f5", "model": "host-agent/hermes", "status": "complete", "language": "en" diff --git a/openwiki/.page-manifest.json b/openwiki/.page-manifest.json index 131d496..2ddfb95 100644 --- a/openwiki/.page-manifest.json +++ b/openwiki/.page-manifest.json @@ -2,46 +2,46 @@ "schemaVersion": 1, "pages": { "/openwiki/architecture/overview.md": { - "pageVersion": "sha256:e9db173c388e72be8c0b253d786fe2b53fa5d7f314a263fe701e47e187481398", + "pageVersion": "sha256:955078203a2f4d5830cb4d98a814b223c2de8ce0e5ea7716da8d6f5763ac3a47", "completedBy": "hermes", - "completedRunId": "ce317b43-7dde-47c1-87e1-938392a159e3", - "gitHead": "6e8eceda77cd2ea7d3266fa1238293995a65198b", - "sourceFingerprint": "sha256:cecef9b96f8c3b95dcbe4b1e2a57a2eaf7f19501aad3477cbd3377ad79ef8729" + "completedRunId": "e45f3123-921d-47d8-add1-58f01a131910", + "gitHead": "add399a18306645a43363ee252c81300474202f5", + "sourceFingerprint": "sha256:0fdba516a746206169345c9399f7657f1f35e973875ec660a5a3be79ea62dc72" }, "/openwiki/architecture/signaling-protocol.md": { - "pageVersion": "sha256:d163eb51d54a69283dc907799e29306ae58efe22135e7574246485a18ebbe7a3", + "pageVersion": "sha256:4347e9dbc853706f354395a069e7ca255004d62e81ebdfffa4c04886c1dea213", "completedBy": "hermes", - "completedRunId": "ce317b43-7dde-47c1-87e1-938392a159e3", - "gitHead": "6e8eceda77cd2ea7d3266fa1238293995a65198b", - "sourceFingerprint": "sha256:cecef9b96f8c3b95dcbe4b1e2a57a2eaf7f19501aad3477cbd3377ad79ef8729" + "completedRunId": "e45f3123-921d-47d8-add1-58f01a131910", + "gitHead": "add399a18306645a43363ee252c81300474202f5", + "sourceFingerprint": "sha256:0fdba516a746206169345c9399f7657f1f35e973875ec660a5a3be79ea62dc72" }, "/openwiki/operations/development-testing.md": { - "pageVersion": "sha256:afa6b86843a0dbff84c4a1aa8c43c020a270101a5e166d4b484580cc1e271535", + "pageVersion": "sha256:9cfe6a7f382aac37d8b5223ccd2ede542dcee2cc6b9e0de9fbc18548b88982ed", "completedBy": "hermes", - "completedRunId": "ce317b43-7dde-47c1-87e1-938392a159e3", - "gitHead": "6e8eceda77cd2ea7d3266fa1238293995a65198b", - "sourceFingerprint": "sha256:cecef9b96f8c3b95dcbe4b1e2a57a2eaf7f19501aad3477cbd3377ad79ef8729" + "completedRunId": "e45f3123-921d-47d8-add1-58f01a131910", + "gitHead": "add399a18306645a43363ee252c81300474202f5", + "sourceFingerprint": "sha256:0fdba516a746206169345c9399f7657f1f35e973875ec660a5a3be79ea62dc72" }, "/openwiki/quickstart.md": { - "pageVersion": "sha256:984a8acd4470194459c1d20515d0ba0e18c04525a2b1397e445f47ed6e2258f0", + "pageVersion": "sha256:9e667d665f1b5a5a5d20392a7125ffa7c3c392fdd003a4a809475783353c8fb6", "completedBy": "hermes", - "completedRunId": "ce317b43-7dde-47c1-87e1-938392a159e3", - "gitHead": "6e8eceda77cd2ea7d3266fa1238293995a65198b", - "sourceFingerprint": "sha256:cecef9b96f8c3b95dcbe4b1e2a57a2eaf7f19501aad3477cbd3377ad79ef8729" + "completedRunId": "e45f3123-921d-47d8-add1-58f01a131910", + "gitHead": "add399a18306645a43363ee252c81300474202f5", + "sourceFingerprint": "sha256:0fdba516a746206169345c9399f7657f1f35e973875ec660a5a3be79ea62dc72" }, "/openwiki/subsystems/client-sdk.md": { - "pageVersion": "sha256:1d9852ca4b2464a2a66fff67f85b6a16c988b2bbaf85b3d3525633df764d628a", + "pageVersion": "sha256:bde0656666e0d821916f63ca8c779cb47e1318377c46e2d9d742f21a76b43e88", "completedBy": "hermes", - "completedRunId": "ce317b43-7dde-47c1-87e1-938392a159e3", - "gitHead": "6e8eceda77cd2ea7d3266fa1238293995a65198b", - "sourceFingerprint": "sha256:cecef9b96f8c3b95dcbe4b1e2a57a2eaf7f19501aad3477cbd3377ad79ef8729" + "completedRunId": "e45f3123-921d-47d8-add1-58f01a131910", + "gitHead": "add399a18306645a43363ee252c81300474202f5", + "sourceFingerprint": "sha256:0fdba516a746206169345c9399f7657f1f35e973875ec660a5a3be79ea62dc72" }, "/openwiki/subsystems/server-signaling.md": { - "pageVersion": "sha256:98cbb4940e4957cfe32aa59d9f472f3125cc4294d346ed1ca1b81fb90f2adb5a", + "pageVersion": "sha256:9d310c510b156c3fec1b35536862fb9edf8b2da2a0b57caa112c2107ab13b216", "completedBy": "hermes", - "completedRunId": "ce317b43-7dde-47c1-87e1-938392a159e3", - "gitHead": "6e8eceda77cd2ea7d3266fa1238293995a65198b", - "sourceFingerprint": "sha256:cecef9b96f8c3b95dcbe4b1e2a57a2eaf7f19501aad3477cbd3377ad79ef8729" + "completedRunId": "e45f3123-921d-47d8-add1-58f01a131910", + "gitHead": "add399a18306645a43363ee252c81300474202f5", + "sourceFingerprint": "sha256:0fdba516a746206169345c9399f7657f1f35e973875ec660a5a3be79ea62dc72" } } } diff --git a/openwiki/architecture/overview.md b/openwiki/architecture/overview.md index e5f0e02..7cd06a9 100644 --- a/openwiki/architecture/overview.md +++ b/openwiki/architecture/overview.md @@ -5,7 +5,7 @@ description: End-to-end explanation of how ZeroHub's Go signaling server, TypeSc tags: [architecture, webrtc, signaling, server, client, protobuf] verified: - by: openwiki/0.6.0 - at: 2026-11-20T15:09:12.940Z + at: 2026-11-21T16:26:45.303Z sources: - id: openwiki-source-df0d81c76704b851d02513e1 resource: repo://client/src/const.ts @@ -29,7 +29,7 @@ sources: resource: repo://server/pkg/storage/storage.go - id: openwiki-source-0eb2a9b2acf717d5c99e9894 resource: repo://server/pkg/zerohub/zerohub.go -generated: { by: "hermes", at: "2026-11-20T15:09:12.940Z" } +generated: { by: "hermes", at: "2026-11-21T16:26:45.303Z" } --- # Architecture Overview @@ -85,10 +85,11 @@ Signaling Server page for the routing table. ### 2. Hub join / create over HTTP→WebSocket A client calls one of the connection entrypoints — `createRandomHub`, -`joinRandomHub`, `joinStaticHub`, or `joinOrCreateIPHub` — each opening a -WebSocket to a mode-typed path (`/v1/random-hubs/create`, -`/v1/random-hubs/join`, `/v1/static-hubs/join`, `/v1/ip-hubs/join-or-create`) -with `id`, `peerMetadata`, and `hubMetadata` as query parameters. (Static hubs +`joinRandomHub`, `joinStaticHub`, `joinOrCreateIPHub`, or `joinIPHub` — +each opening a WebSocket to a mode-typed path +(`/v1/random-hubs/create`, `/v1/random-hubs/join`, `/v1/static-hubs/join`, +`/v1/ip-hubs/join-or-create`, `/v1/ip-hubs/join`) with `id`, `peerMetadata`, +and `hubMetadata` as query parameters. (Static hubs are additionally created out-of-band by an admin over plain HTTP at `/v1/static-hubs/create` — a JSON response, no WebSocket upgrade.) The handler authenticates where needed and validates the query params up front via the diff --git a/openwiki/architecture/signaling-protocol.md b/openwiki/architecture/signaling-protocol.md index 2a2a269..7ad8706 100644 --- a/openwiki/architecture/signaling-protocol.md +++ b/openwiki/architecture/signaling-protocol.md @@ -19,7 +19,7 @@ sources: generated: { by: "hermes", at: "2026-11-20T15:09:12.940Z" } verified: - by: openwiki/0.6.0 - at: 2026-11-20T15:09:12.940Z + at: 2026-11-21T16:26:45.303Z --- # Signaling Protocol & Peer Lifecycle diff --git a/openwiki/operations/development-testing.md b/openwiki/operations/development-testing.md index ece17b8..2157edc 100644 --- a/openwiki/operations/development-testing.md +++ b/openwiki/operations/development-testing.md @@ -12,6 +12,8 @@ sources: resource: repo://test/package.json - id: openwiki-source-bb910847e63080c9ced0e830 resource: repo://test/playwright.config.ts + - id: openwiki-source-e85623174fcaf46639032098 + resource: repo://test/scripts/build-harness.mjs - id: openwiki-source-36a6408534491a7638f8089e resource: repo://test/tests/unit-ice-candidate-send.spec.ts - id: openwiki-source-1c91996f1afbceb960c6d3b4 @@ -30,10 +32,10 @@ sources: resource: repo://test/tests/unit-ws-replacement.spec.ts - id: openwiki-source-801ca2739d5984913a9ac0eb resource: repo://test/unit-harness/index.ts -generated: { by: "hermes", at: "2026-11-20T15:09:12.940Z" } +generated: { by: "hermes", at: "2026-11-21T16:26:45.303Z" } verified: - by: openwiki/0.6.0 - at: 2026-11-20T15:09:12.940Z + at: 2026-11-21T16:26:45.303Z --- # Development & Testing @@ -109,13 +111,14 @@ via relative path `../../client/src/index`): - **Harness** (`test/harness/index.ts`) exposes a `window.ZeroHubHarness` that creates/joins hubs, logs peer status changes, and tracks data-channel state, keyed by `componentId`. Tests drive it via `page.evaluate`. -- **Specs** (`test/tests/`): seven E2E specs — `connect.spec.ts` - (create/join + peer status), `data-channel.spec.ts`, `concurrent.spec.ts`, - `disconnect.spec.ts`, `multihosts.spec.ts`, `static-hub.spec.ts` (out-of-band - admin HTTP create + `joinStaticHub` WebSocket against the live `:8081` backup - server), and `zz-migrate.spec.ts` (named last so its one-way migrate latch on - `:8080` runs after every other spec) — plus 23 `unit-*.spec.ts` specs - (e.g. `unit-sfu-election.spec.ts`, `unit-reconnect-error.spec.ts`, +- **Specs** (`test/tests/`): eight E2E specs — `connect.spec.ts` + (create/join + peer status), `data-channel.spec.ts`, `ip-hub.spec.ts`, + `concurrent.spec.ts`, `disconnect.spec.ts`, `multihosts.spec.ts`, + `static-hub.spec.ts` (out-of-band admin HTTP create + `joinStaticHub` + WebSocket against the live `:8081` backup server), and `zz-migrate.spec.ts` + (named last so its one-way migrate latch on `:8080` runs after every other + spec) — plus 22 `unit-*.spec.ts` specs + (e.g. `unit-peer-wiring.spec.ts`, `unit-sfu-election.spec.ts`, `unit-reconnect-error.spec.ts`, `unit-malformed-metadata.spec.ts`, `unit-reconnect-peer-prune.spec.ts`, `unit-ice-candidate-send.spec.ts`, `unit-manual-offer-handling.spec.ts`, `unit-manual-answer-handling.spec.ts`, `unit-migration-redirect.spec.ts`, @@ -144,10 +147,11 @@ via relative path `../../client/src/index`): - **Always run via `cd test && npm test`**, not `npx playwright test` directly. `npm test` triggers `pretest`, which runs the `tsc` typecheck - **and** `build:harness` (`test/dist/harness.js` for the E2E harness) **and** - the unit-harness bundle (`test/dist/unit-harness.js` for the unit specs), - both built via esbuild. Invoking Playwright directly makes the specs fail - with ENOENT on their missing harness bundles. + **and** a single parameterized `build:harness` esbuild script + (`test/scripts/build-harness.mjs`) that produces both `test/dist/harness.js` + (the E2E harness) and `test/dist/unit-harness.js` (the unit specs). + Invoking Playwright directly makes the specs fail with ENOENT on their + missing harness bundles. - The Playwright config runs **serially**: `workers: 1` and `fullyParallel: false` are always pinned (locally and on CI), with a 10s per-test timeout on Google Chrome only. `retries` is `2` under `CI=1` and diff --git a/openwiki/quickstart.md b/openwiki/quickstart.md index 4770dfc..06d21c7 100644 --- a/openwiki/quickstart.md +++ b/openwiki/quickstart.md @@ -24,10 +24,10 @@ sources: resource: repo://test/playwright.config.ts - id: openwiki-source-801ca2739d5984913a9ac0eb resource: repo://test/unit-harness/index.ts -generated: { by: "hermes", at: "2026-11-20T15:09:12.940Z" } +generated: { by: "hermes", at: "2026-11-21T16:26:45.303Z" } verified: - by: openwiki/0.6.0 - at: 2026-11-20T15:09:12.940Z + at: 2026-11-21T16:26:45.303Z --- # ZeroHub Quickstart @@ -45,8 +45,10 @@ orient, then follow the related pages for depth: storage fit together end to end. - **Signaling Protocol & Peer Lifecycle** — the protobuf wire format and the `PeerStatus` state machine. -- **Go Signaling Server** — the server subsystem in detail. -- **TypeScript Client SDK** — the `@zero-hub/client` SDK in detail. +- **Go Signaling Server** — the server subsystem in detail (including + IP-based hub routing via `JoinOrCreateHubIP`). +- **TypeScript Client SDK** — the `@zero-hub/client` SDK in detail (including + the `joinIPHub` client method for IP-keyed hubs). - **Development & Testing** — build, test, and proto-generation workflows. ## Monorepo layout @@ -153,7 +155,8 @@ negotiate over the server and establish a direct WebRTC data channel. `make test-all`. - **Run server unit tests**: `make server-test` (or `cd server && go test ./...`). - **Run E2E tests**: `cd test && npm test` (the `pretest` step type-checks and - builds both the E2E harness and the unit-spec harness via esbuild before + builds both the E2E harness and the unit-spec harness with the single + parameterized esbuild script (`test/scripts/build-harness.mjs`) before invoking Playwright; don't invoke `npx playwright test` directly). - **Factory precommit gate**: `./.zerofactory/precommit.sh` (format, build, test). diff --git a/openwiki/subsystems/client-sdk.md b/openwiki/subsystems/client-sdk.md index cf11bea..291f6d0 100644 --- a/openwiki/subsystems/client-sdk.md +++ b/openwiki/subsystems/client-sdk.md @@ -16,10 +16,10 @@ sources: resource: repo://client/src/utils.ts - id: openwiki-source-718b618612c033c4f36b3a45 resource: repo://client/src/zeroHub.ts -generated: { by: "hermes", at: "2026-11-20T15:09:12.940Z" } +generated: { by: "hermes", at: "2026-11-21T16:26:45.303Z" } verified: - by: openwiki/0.6.0 - at: 2026-11-20T15:09:12.940Z + at: 2026-11-21T16:26:45.303Z --- # TypeScript Client SDK @@ -59,7 +59,7 @@ connection is made until an entrypoint is called. All connection entrypoints funnel into the private `openHubConnection(path, hubId?, peerMetadata?, hubMetadata?)` helper, which -stores any supplied metadata on the client, builds a `URL` from +builds a `URL` from `getWS(host, tls)` (client/src/utils.ts — `wss://` when `tls`, else `ws://`) with `id`, `hubMetadata`, `peerMetadata` as query params, and calls `connectToZeroHub(url)`: @@ -70,6 +70,7 @@ with `id`, `hubMetadata`, `peerMetadata` as query params, and calls | `joinRandomHub(hubId, peerMetadata?)` | `/v1/random-hubs/join` | join an existing random hub by id | | `joinStaticHub(hubId, peerMetadata?)` | `/v1/static-hubs/join` | join a static (never-expires, named) hub; creation is an admin-gated plain-HTTP endpoint (`/v1/static-hubs/create`) deliberately NOT exposed on the SDK, because the browser WebSocket API cannot send the `Authorization` header | | `joinOrCreateIPHub(peerMetadata?, hubMetadata?)` | `/v1/ip-hubs/join-or-create` | IP-keyed join-or-create; the hub id is derived by the server from the caller's IP | +| `joinIPHub(hubId, peerMetadata?)` | `/v1/ip-hubs/join` | join an existing IP-keyed hub by its derived id (the id published in `hubInfo` after a peer created the hub via `joinOrCreateIPHub`) | All entry points return `Promise` — they resolve when the signaling WebSocket opens and reject when the connection attempt fails. The older @@ -77,9 +78,9 @@ WebSocket opens and reject when the connection attempt fails. The older `createPermanentHub`/`joinPermanentHub` entry points no longer exist: named hubs are now "static hubs" and creating one is not a client-side operation (browser WebSocket clients cannot carry the admin `Authorization` header). -The `joinIPHub(hubId)` entry point was also removed: an IP hub's id is derived -from the caller's IP by the server, so a client-supplied hub id can never -resolve to an IP hub. Use `joinOrCreateIPHub` instead. +`joinIPHub(hubId)` joins an existing IP-keyed hub by its derived id — the id +the server minted from the peer that first created the hub via +`joinOrCreateIPHub`, published to that peer in `hubInfo`. ## WebSocket lifecycle & message dispatch @@ -163,6 +164,14 @@ add or remove a peer can never diverge: gone. Used by `disconnect()`, the `peerDisconnectedMessage` broadcast, and the `hubInfoMessage` roster-prune pass. The caller emits the appropriate status first (it differs per path). +- **`safeInvoke(label, fn)`** — the shared user-callback isolation helper in + `zeroHub.ts`: every user-supplied callback (`onPeerStatusChange`, + `onPeerError`, `onHubInfo`, `onOffer`, `onAnswer`, `onZeroHubError`, and + the topology's `onPeerStatusChange`) is invoked through it, so a throwing + handler is isolated into an error log instead of aborting the signaling + dispatch that invoked it. The user-facing `onDataChannel`/`onTrack` + callbacks in `peerSetup.ts` are isolated the same way through the + module-level `guardCallback` helper. P2P-drop recovery: when a live peer's `RTCPeerConnection` reports `disconnected`/`failed` while the signaling socket is still up, diff --git a/openwiki/subsystems/server-signaling.md b/openwiki/subsystems/server-signaling.md index bbb885d..14ef9de 100644 --- a/openwiki/subsystems/server-signaling.md +++ b/openwiki/subsystems/server-signaling.md @@ -43,10 +43,10 @@ sources: resource: repo://server/pkg/storage/gache.go - id: openwiki-source-0eb2a9b2acf717d5c99e9894 resource: repo://server/pkg/zerohub/zerohub.go -generated: { by: "hermes", at: "2026-11-20T15:09:12.940Z" } +generated: { by: "hermes", at: "2026-11-21T16:26:45.303Z" } verified: - by: openwiki/0.6.0 - at: 2026-11-20T15:09:12.940Z + at: 2026-11-21T16:26:45.303Z --- @@ -146,7 +146,11 @@ and is joined before the upgrade callback returns so fasthttp can safely recycle the hijacked connection. **Upgrade-failure cleanup** plugs an orphaned-hub leak. `Upgrade` reports a -failed connection two ways: a non-nil error (a real handshake error) or +failed connection two ways: a non-nil error — classified by the shared +`wrapUpgradeError` helper, which turns a `websocket.HandshakeError` into a +`websocket handshake` error and everything else into a generic upgrade error +(`ForwardMigrate` routes its upgrade failures through the same helper, so +both upgrade paths report failures identically) — or `responseWritten=true` (the up-front `peerMetadata` rejection that already wrote a `400` for malformed JSON or `413` for an oversized value). `AddPeer` only runs inside the upgrade callback, so whenever `Upgrade` does not fully