Blockers
Everything outside the repository that prevents production deployment or verification.
Last updated: 2026-11-16. Each blocker lists what unblocks it and the evidence that closes it. The code paths exist; these need credentials, infrastructure, devices or decisions. How to set each item up is in prerequisites.
Infrastructure and credentials
| Blocker | Unblocked by | Done when |
|---|---|---|
| No provisioned staging or production (INFRA-01) | DigitalOcean and Cloudflare accounts, the one-time bootstrap and GitHub environments | The zone stack and a staging Deploy run succeed, a follow-up tofu plan shows no changes, and the production checklist passes |
| Managed database grants and timeouts not yet verified (SEC-07) | First OpenTofu deploy (terraform_data.database_grants) | Runtime role denies DDL and shows the 30 s timeout |
Bucket lifecycle (quarantine/ expiry) not yet verified (SEC-01) | First OpenTofu deploy (storage.tf) | get-bucket-lifecycle-configuration shows both rules |
| Scanner not deployed | First OpenTofu deploy (scanner.tf) | API uploads complete clean on staging; scanner signatures stay fresh |
| Ingress client-IP behavior unconfirmed (SEC-02) | Staging | Spoofed header ignored in audit and rate limiting |
| Cloudflare Access + session matching untested on a deployed console | Staging with Access | Mismatched identity rejected |
| Monitoring receivers | Monitoring backend and on-call contacts | A test alert reaches a person |
Verification that needs a deployed environment
| Blocker | Unblocked by | Done when |
|---|---|---|
| Media on real networks: UDP, TCP, TURN/TLS, screenshare, reconnect, viewer publish denial | Staging media node, two networks | Checks in the production checklist pass |
| Capacity: 300-viewer livestream, group calls, socket fan-out, database contention (LOAD-01) | Staging; written authorization for any production test | k6, fan-out and lk load-test results from separate generators recorded in load testing |
| Backup/PITR restore, secret restoration, API and media rollback (OPS-01) | Staging | Restore into an isolated cluster runs the API; rollback by digest succeeds |
Devices and toolchains
| Blocker | Unblocked by | Done when |
|---|---|---|
| React Native Android module not compiled (NAT-01; the SDK and sample now build) | A React Native host app build | ./gradlew assembleDebug passes in an app using @lynkoria/react-native |
iOS build of CallKit/PushKit code, SwiftUI example and React Native iOS (NAT-02; macOS swift build passes) | macOS with Xcode | xcodebuild for an iOS destination and an example app build pass |
| Swift realtime test skipped on Linux | macOS/iOS (Linux URLSession lacks WebSockets) | testRealtimeMessagingAndGapRecovery passes |
| Native media and incoming-call UI on devices (NAT-03, PUSH-01) | Physical Android and iOS devices | Items in testing completion criteria pass |
| Real push delivery (PUSH-01) | Each product's Firebase service account and APNs .p8 key | FCM and APNs deliveries reach devices |
Product and security decisions
| Decision | Owner | Done when |
|---|---|---|
| Where LiveKit Egress runs and its CPU budget (REC-01) | Eng lead, ops | A real composite, audio-only and HLS recording completes and downloads |
| Recording consent and retention per product (ADR 009) | Product, legal | Policy recorded |
| Recording E2EE calls (ADR 010) | Product, security | ADR updated (a visible trusted recorder is the only honest option) |
| Fidescript media isolation (ADR 008) | Security reviewer | Separate API/media stack decided before sensitive traffic |
| Message retention (ADR 012) | Product, legal | Per-product policy configured |
| Multi-device call behavior (ADR 006) | Product owners | Per-product setting chosen |
| Attachments uploaded before scanning (SCAN-01) | Security | Accept they are not served, or build a rescan backfill |
| Product authorization: contacts/blocks, incoming-call UX, presence visibility | Each product | Product backends enforce them before issuing tokens |
| Registry and namespaces for npm, Maven Central, SwiftPM (PUB-01, ADR 013) | Eng lead | First releases published with provenance |
| Console accounts before deploying the password sign-in release | Operator | pnpm admin:user create run for every existing console_roles email |
Accepted limits until addressed
One API instance by default (more are supported, ADR 021, but not load-tested) and one media node (no media high availability); usage counters can lose the last 15 seconds on a crash (not billing-grade); self-hosted LiveKit cannot revoke an issued 5-minute token, so hard bans end the room; disabling an environment does not disconnect active media.