Implementation tracker
The single list of findings and work items, with status, verification and external requirements.
Last updated: 2026-11-14. This table is the source of truth for status. Details: completed, remaining tasks, blockers, changelog. Security items link to the findings register. Device and deployed-environment checks are itemized in testing completion criteria.
Statuses: Completed (implemented and verified), Partially Completed, Pending, Blocked (needs something outside this repository), Not Applicable. Priority: P0 blocks production, P1 needed for launch quality, P2 improvement.
Findings from the 2026-11-13 audit
| ID | Description | Category | Priority | Status | Code | Implementation | Verification | External requirement |
|---|---|---|---|---|---|---|---|---|
| SEC-01 | Scanned attachment could be replaced through the still-valid upload URL | Security | P0 | Completed | Yes | Quarantine upload key; publish scanned bytes (ADR 020) | Regression test fails before, passes after | Apply bucket lifecycle rule |
| SEC-02 | Spoofable client-IP header bypassed per-IP sign-in limits | Security | P0 | Completed | Yes | Single CLIENT_IP_HEADER; last XFF entry | Unit tests | Confirm ingress overwrites the header |
| SEC-03 | Unbounded concurrent scrypt (memory/thread-pool exhaustion) | Security | P1 | Completed | Yes | FIFO limit of 2 derivations | Unit test; console-auth tests | none |
| SEC-04 | API responses without CSP | Security | P2 | Completed | Yes | default-src 'none'; frame-ancestors 'none' | API suite | none |
| SEC-05 | Static sites without HSTS; docs without CSP | Security | P2 | Completed | Yes | _headers for console and docs | Docs export served with CSP, no violations | HSTS preload optional |
| SEC-06 | Scanner image not built or scanned in CI | Supply chain | P1 | Partially Completed | Yes | Image job matrix (api, scanner) | Not yet run in hosted CI | CI run |
| SEC-07 | No statement/idle-transaction timeouts for the runtime role | Reliability | P1 | Pending | Yes | database-grants.sql role settings | SQL review | Re-run grants on each database |
| SEC-08 | Mutable ClamAV image tag | Supply chain | P2 | Partially Completed | Yes | 1.4.6 pinned by digest in both Compose files (status) | Scanner real-engine suite (local) | Operator review of the digest |
| SEC-09 | Dev-only esbuild advisory via drizzle-kit | Dependencies | P2 | Completed | Yes | pnpm override to esbuild 0.25.12 | pnpm audit clean; drizzle-kit generate/check unchanged | none |
| SEC-10 | Per-event socket revalidation cost | Performance | P2 | Not Applicable | No | Kept deliberately (immediate revocation) | Review | Revisit when scaling out |
| SEC-11 | Console CSP allows any HTTPS connect target | Security | P2 | Pending | No | n/a | n/a | Set the API origin per deployment |
| CSS-01 | App stylesheets migrated to Tailwind with a shared brand theme | Styling | P2 | Completed | Yes | ADR 018, CSS audit | Builds; every class has a CSS rule; browser checks desktop/mobile | none |
| CSS-02 | Docs landing page overflowed horizontally | Bug | P2 | Completed | Yes | Glow limited to viewport; overflow-x: clip | Browser scroll width | none |
| SDK-01 | Call participants, connection quality and device selection in the SDK | SDK | P1 | Completed | Yes | CallSession.participants, onParticipantsChange, listDevices, switchDevice; useCallParticipants | Unit tests (client, React) | none |
| DOC-01 | Documentation scattered across overlapping status pages | Documentation | P1 | Completed | Yes | New sections (ADR 019) | Content tests; export link check | none |
| DOC-02 | Environment variable reference incomplete | Documentation | P0 | Completed | Yes | Environment variables | Compared with every config.ts, scanner, Vite and script read | none |
| DOC-03 | No external prerequisites list, production checklist or scanner deploy steps | Documentation | P0 | Completed | Yes | Prerequisites, production checklist, deployment handbook | Review against scripts and templates | none |
| DOC-04 | Stale claims (recording and native "not available", console Access-only, attachments unscanned) | Documentation | P2 | Completed | Yes | Index, landing page, architecture, security pages updated | Review | none |
Documentation and console upgrade (2026-11-14)
Program status and decisions: Program status. Audit: docs and console audit.
| ID | Description | Category | Priority | Status | Code | Implementation | Verification | External requirement |
|---|---|---|---|---|---|---|---|---|
| CON-01 | Generated HTTP and SDK references, env-var drift check, type-checked guide examples | Documentation | P1 | Completed | Yes | scripts/gen-*.mjs, apps/docs/snippets | apps/docs tests and typecheck in CI | — |
| CON-02 | Append-only audit log, refused-change and export auditing | Security | P0 | Completed | Yes | Migration 0002, admin middleware | console-admin.test.ts | — |
| CON-03 | Calls, livestreams, participants and live state in the console | Console | P1 | Completed | Yes | modules/admin/calls.routes.ts, Calls tab | API tests, Playwright | — |
| CON-04 | Hourly usage, overview dashboard and analytics | Console | P1 | Completed | Yes | Migration 0004, analytics.routes.ts, Overview/Analytics | API tests against rollup rows, Playwright | — |
| CON-05 | Console accessibility (WCAG 2.x AA) | Accessibility | P1 | Completed | Yes | Brand contrast tokens, labelled dialogs | axe in Playwright (light theme) | — |
| CON-06 | Platform operator role and infrastructure views | Console | P1 | Blocked | No | — | — | Decision PD-1 |
| CON-07 | MFA and step-up re-authentication | Security | P1 | Blocked | No | — | — | Decision PD-2 |
| CON-08 | Latency, error-rate, CPU/memory and socket metrics in the console | Observability | P2 | Blocked | No | — | — | Monitoring backend (PD-5) |
| CON-09 | Kotlin (Dokka) and Swift (DocC) generated references | Documentation | P3 | Pending | No | — | — | Gradle/Xcode in the docs build |
Carried-over work
| ID | Description | Category | Priority | Status | Code | Next step / dependency |
|---|---|---|---|---|---|---|
| NAT-01 | Compile and test Android media layer, sample, React Native Android | SDK | P1 | Partially Completed | Yes | ./gradlew build passes (2026-11-13); React Native Android needs a host app build |
| NAT-02 | Compile and test iOS media layer, SwiftUI example, React Native iOS | SDK | P1 | Partially Completed | Yes | swift build passes for macOS; iOS CallKit/PushKit, example and React Native iOS need Xcode |
| NAT-03 | Native media on physical devices | Verification | P1 | Blocked | Unknown | Devices and staging |
| PUSH-01 | Real FCM/APNs delivery and CallKit/Android incoming-call UI | Verification | P1 | Blocked | Unknown | Product credentials and devices |
| REC-01 | Real Egress recording and HLS output | Feature | P1 | Blocked | Unknown | Decide Egress host and CPU budget |
| LOAD-01 | Staging load tests, including 300 livestream viewers | Verification | P0 | Blocked | No | Staging environment; generators on separate machines |
| OPS-01 | Backup restore drill, rollback, real alert delivery | Operations | P0 | Blocked | No | Deployed staging |
| INFRA-01 | Provision and verify DigitalOcean/Cloudflare with real credentials | Infrastructure | P0 | Blocked | No | Accounts and DNS records for lynkoria.com (prerequisites, zone checklist); origin lock is in code |
| PUB-01 | npm, Maven Central and SwiftPM publishing | Release | P1 | Blocked | No | Registry and namespace decisions (ADR 013) |
| ARCH-01 | Multi-replica API (Socket.IO adapter, cross-node revocation) | Scalability | P1 | Completed | Yes | Redis Streams adapter (ADR 021); two-instance test. Capacity across replicas: LOAD-01 |
| ARCH-02 | HLS/CDN delivery for audience-scale livestreams | Scalability | P2 | Pending | Yes | Depends on REC-01 (Egress) |
| FEAT-01 | Waiting rooms / lobby admission | Feature | P2 | Pending | Yes | Product requirement; product backends can gate token issuance today |
| FEAT-02 | Durable offline send queue in client SDKs | Feature | P2 | Pending | Yes | Apps retry failed sends; clientMessageId already deduplicates |
| FEAT-03 | AR filters, masks, beauty effects | Feature | P2 | Not Applicable | No | Client-side responsibility (ADR 017, remaining tasks) |
| DEP-01 | Self-hosted single-host Docker Compose for non-DigitalOcean deployments | Deployment | P2 | Pending | Yes | App Platform is the supported target; scanner already has production Compose |
| SCAN-01 | Rescan attachments uploaded before scanning | Security | P2 | Blocked | Maybe | Decision: accept they are not served, or build a backfill |
| DEC-01 | E2EE recording, Fidescript media isolation, retention, multi-device | Decisions | P1 | Blocked | Maybe | Product/security decisions (ADRs) |
| TEST-01 | Clean-project installs of every npm, Maven and SwiftPM artifact | Release | P1 | Partially Completed | Yes | npm: scripts/clean-install-check.sh in CI; Maven local publish in CI; RN, Compose and SwiftUI host apps pending |
| TEST-02 | Real Egress container test in local Compose | Verification | P2 | Pending | Test | Can start now |