.github/9
ISSUE_TEMPLATE/3bug_report.md config.yml feature_request.md
workflows/3ci.yml clean-clone.yml release.yml
CODEOWNERS dependabot.yml pull_request_template.md
apps/630
api/250
src/243
common/30
__tests__/3authorize.test.ts bigint-serialization.interceptor.test.ts files-limits.test.ts
filters/1all-exceptions.filter.ts
guards/3auth.guard.ts internal-service.guard.ts rate-limit.guard.ts
interceptors/2actor-context.interceptor.ts bigint-serialization.interceptor.ts
middleware/2idempotency.test.ts idempotency.ts
pipes/1zod-validation.pipe.ts
actor-context.ts audit.service.ts cache.test.ts cache.ts cookies.ts core.module.ts deprecation.ts email.service.ts errors.ts event-bus.ts log-scrubber.test.ts log-scrubber.ts logger.ts permission-cache-bridge.ts prisma.service.ts redis.service.ts trace-metadata.ts types.ts
config/1env.ts
lib/11
__tests__/5crypto.test.ts filter-builder.test.ts jwt.test.ts pagination.test.ts positions.test.ts
authorize.ts crypto.ts filter-builder.ts jwt.ts pagination.ts positions.ts
modules/197
ai/28
__tests__/4ai-writing.test.ts database-ai.test.ts generate-executor.test.ts prompts.test.ts
generator/4executor.ts generate.controller.ts generate.dto.ts generate.service.ts
ai-chat.service.ts ai-rate-limit.ts ai-writing.controller.ts ai-writing.dto.ts ai-writing.service.ts ai.controller.ts ai.module.ts ai.service.ts budget-guard.service.ts database-ai.controller.ts database-ai.dto.ts database-ai.service.ts db-prompts.ts dto.ts gateway-provider.ts ledger.service.ts prompts.ts rag.controller.ts rag.dto.ts rag.service.ts
api-keys/3api-keys.controller.ts api-keys.module.ts api-keys.service.ts
audit/2audit-log.controller.ts audit.module.ts
auth/4auth.controller.ts auth.module.ts auth.service.ts dto.ts
automations/5automations.controller.ts automations.module.ts automations.service.ts dto.ts webhook-incoming.controller.ts
blocks/5
__tests__/1batch-version-cas.test.ts
block.service.ts blocks.controller.ts blocks.module.ts dto.ts
comments/4comments.controller.ts comments.module.ts comments.service.ts dto.ts
databases/9
__tests__/3normalize-select-options.test.ts option-id-canonicalization.test.ts record-open-query-shape.test.ts
database.service.ts databases.controller.ts databases.module.ts dto.ts property-cache-schema.ts query.service.ts
docs/2docs.controller.ts docs.module.ts
files/10
__tests__/1quota.test.ts
dto.ts files.controller.ts files.module.ts files.service.ts quota.ts record.ts s3.ts uploads.controller.ts uploads.service.ts
forms/18debug.controller.ts form.dto.ts forms.controller.ts forms.module.ts forms.service.ts markdown.test.ts markdown.ts optional-auth.guard.ts public-forms.controller.ts public-forms.service.ts question.dto.ts questions.service.ts rate-limit.ts recaptcha.ts slug.ts submissions.controller.ts submissions.service.ts submit-schema.ts
health/3health.controller.ts health.module.ts health.service.ts
integrations/3integrations.controller.ts integrations.module.ts integrations.service.ts
internal/12
__tests__/2flush-query-shape.test.ts internal.endpoints.test.ts
ai-test-seam.controller.ts ai-test-seam.dto.ts ai-test-seam.service.ts internal.controller.ts internal.dto.ts internal.module.ts internal.service.ts test-seam.controller.ts test-seam.dto.ts test-seam.service.ts
notifications/3notifications.controller.ts notifications.module.ts notifications.service.ts
oauth/6
__tests__/1oauth.scopes.test.ts
oauth.controller.ts oauth.module.ts oauth.service.ts scopes.ts token-keys.ts
org/15audit.service.ts embed-preview.controller.ts guards.ts members.service.ts org-admin.controller.ts org-policy.service.ts org.module.ts overview.service.ts policy-effective.controller.ts policy.schema.ts policy.test.ts retention.service.ts totp.test.ts totp.ts two-factor.service.ts
orgs/5dto.ts orgs.controller.ts orgs.module.ts orgs.service.ts util.ts
pages/4dto.ts page.service.ts pages.controller.ts pages.module.ts
scim/15
__tests__/3email-mapping.test.ts etag.test.ts filters.test.ts
etag.ts filters.ts groups.service.ts schemas.ts scim-admin.controller.ts scim-admin.service.ts scim-auth.guard.ts scim-auth.service.ts scim-errors.ts scim.controller.ts scim.module.ts users.service.ts
search/4
__tests__/1search.service.test.ts
search.controller.ts search.module.ts search.service.ts
sessions/3sessions.controller.ts sessions.module.ts sessions.service.ts
share/3share.controller.ts share.module.ts share.service.ts
sso/16
__tests__/4enforcement.test.ts oidc.verify.test.ts provisioning.test.ts saml.validate.test.ts
enforcement.ts oidc.controller.ts oidc.service.ts oidc.ts provisioning.service.ts saml.controller.ts saml.ts schemas.ts sso-admin.controller.ts sso-admin.service.ts sso-secrets.ts sso.module.ts
teams/4dto.ts teams.controller.ts teams.module.ts teams.service.ts
users/4dto.ts users.controller.ts users.module.ts users.service.ts
webhooks/3webhooks.controller.ts webhooks.module.ts webhooks.service.ts
workspaces/4dto.ts workspaces.controller.ts workspaces.module.ts workspaces.service.ts
types/1xmldom.d.ts
app.module.ts constants.ts main.ts
_probe_rawbody.cjs .env.example Dockerfile package.json README.md tsconfig.json vitest.config.ts
realtime/33
src/17auth.ts comments.ts config.ts event-source.ts http-store.ts index.ts metrics.ts notifications.ts page-updated-source.ts presence.ts prisma-store.ts protocol.ts rate-limit.ts room-key.ts rooms.ts server.ts update-log.ts
test/11auth.test.ts config.test.ts event-source.test.ts http-store.test.ts metrics-merge.test.ts page-updated-source.test.ts presence.test.ts protocol.test.ts rate-limit.test.ts rooms.test.ts task-0094-builders.test.ts
.env.example Dockerfile package.json README.md tsconfig.json
web/255
src/244
app/45
__tests__/1theme-tokens.test.ts
(app)/26
w/25
[workspace]/25
ask/1page.tsx
databases/1
[id]/1page.tsx
favorites/1page.tsx
files/1page.tsx
notifications/1page.tsx
page/4
[id]/4
[block]/1page.tsx
share/1page.tsx
layout.tsx page.tsx
search/1page.tsx
settings/10
appearance/1page.tsx
automations/3
[id]/1page.tsx
new/1page.tsx
page.tsx
billing/1page.tsx
developers/1page.tsx
members/1page.tsx
permissions/1page.tsx
teams/1page.tsx
page.tsx
shared/1page.tsx
templates/1page.tsx
trash/1page.tsx
layout.tsx page.tsx
layout.tsx
(auth)/4
login/1page.tsx
register/1page.tsx
reset-password/1page.tsx
layout.tsx
api/2
metrics/1route.ts
v1/1
health/1route.ts
f/1
[slug]/1page.tsx
health/1
ready/1route.ts
org/2
[orgId]/2
admin/2
integrations/1page.tsx
page.tsx
share/1
[id]/1page.tsx
error.tsx global-error.tsx globals.css layout.tsx not-found.tsx page.tsx providers.tsx
components/118
admin/10
org-admin/8ApiKeysTab.tsx AuditTab.tsx MembersTab.tsx OverviewTab.tsx PoliciesTab.tsx RetentionTab.tsx WebhooksTab.tsx WorkspacePicker.tsx
ScimCard.tsx SsoTabs.tsx
ai/6ai-panel.tsx ask-ai-submenu.tsx db-ai-dialog.tsx generate-page-dialog.tsx writing-actions-menu.tsx writing-diff.tsx
automations/5action-editor.tsx condition-editor.tsx lib.ts run-history.tsx trigger-editor.tsx
collaboration/6CursorLayer.tsx OfflineBanner.tsx PresenceBar.tsx README.md ReviewFailedDialog.tsx StatusChip.tsx
comments/3comment-panel.tsx comment-thread.tsx mention-input.tsx
database/27
__tests__/2cell-editor.test.tsx cell-renderer.test.tsx
AiExtractDialog.tsx AiFormulaDialog.tsx AiGenerateDialog.tsx board-view.tsx buttons-panel.tsx calendar-view.tsx cell-editor.tsx cell-renderer.tsx chart-view.tsx database-page-view.tsx database-toolbar.tsx database-view-renderer.tsx db-embedded.tsx filter-builder.tsx form-builder-view.tsx formula-editor.tsx gallery-view.tsx group-builder.tsx list-view.tsx property-editor.tsx record-header.tsx record-panel.tsx sort-builder.tsx table-view.tsx timeline-view.tsx
dialogs/7
__tests__/1move-to-dialog.test.tsx
create-dialog.tsx dialog.tsx file-permissions-dialog.tsx invite-dialog.tsx move-to-dialog.tsx share-dialog.tsx
editor/19
__tests__/3code-block-text.test.ts code-block.test.tsx expandable.test.tsx
block-card.tsx block-renderer.tsx block-save-queue.ts block-toolbar.tsx context-menu.tsx expandable.tsx history-popover.tsx inline-editor.tsx insert-dialog.tsx page-canvas.tsx page-spinner.tsx page-view.tsx selection-toolbar.tsx slash-menu.tsx template-dialog.tsx type-menu.tsx
files/4FileBlock.tsx FileBrowser.tsx FilePicker.tsx PreviewModal.tsx
form/4form-field.tsx form-renderer.tsx form-responses-view.tsx form-view.tsx
layout/8
__tests__/1page-tree-icon.test.tsx
command-palette.tsx factory-logo.tsx page-tree-node.tsx sidebar.tsx theme-provider.tsx topbar.tsx workspace-shell.tsx
mentions/3
__tests__/1mention-model.test.ts
mention-model.ts MentionPopup.tsx
search/3ask-ai-search.tsx results-list.tsx search-dialog.tsx
settings/10
api-keys/4ApiKeyCreateDialog.tsx ApiKeyRevealDialog.tsx ApiKeyTable.tsx ScopesBadge.tsx
webhooks/5CurlExamples.tsx DeliveryInspector.tsx EventExplorer.tsx OverviewTab.tsx WebhooksTab.tsx
settings-shell.tsx
ui/3confirm-dialog.tsx form.tsx toaster.tsx
hooks/21
__tests__/4realtime-frame-handler.test.ts use-blocks.test.ts use-database-options.test.ts use-workspace.test.tsx
realtime-frame-handler.ts use-ai-stream.ts use-auth.ts use-blocks.ts use-database.ts use-db-ai-stream.ts use-forms.ts use-members.ts use-mention-sources.ts use-notifications.ts use-offline-status.ts use-pages.ts use-presence-announcer.ts use-presence-toasts.ts use-presence.ts use-realtime.ts use-workspace.ts
lib/50
__tests__/21ai-database.test.ts ai-generate.test.ts ai-sse.test.ts ai-writing.test.ts api-keys.test.ts api-members.test.ts auth-refresh.test.ts auth-store.test.ts batch-queue-drop.test.ts block-content.test.ts clipboard-import.test.ts code-highlight.test.ts offline-status.test.ts presence-announcer.test.ts presence-color.test.ts presence-cursor.test.ts presence-emitter.test.ts realtime-url.test.ts search.test.ts utils.test.ts writing-diff.test.ts
files/7
__tests__/2picker.test.ts upload.test.ts
api.ts picker.ts upload-store.ts upload.ts use-file-uploads.ts
ai-database.ts ai.ts api-keys.ts api.ts auth-store.ts batch-queue.ts block-content.ts clipboard-import.ts code-highlight.ts constants.ts offline-status.ts org-admin.ts presence-announcer.ts presence-color.ts presence-cursor.ts presence-editor-views.ts presence-emitter.ts query-client.ts realtime.ts search.ts types.ts utils.ts
stores/8
__tests__/1block-patch-store.test.ts
block-patch-store.ts comment-pill-store.ts database-store.ts editor-store.ts offlineQueue.ts presence-store.ts ui-store.ts
instrumentation.ts middleware.ts
.env.example Dockerfile next-env.d.ts next.config.mjs package.json postcss.config.mjs README.md tailwind.config.ts tsconfig.json tsconfig.tsbuildinfo vitest.config.ts
worker/92
src/87
__tests__/13ai-embedding.test.ts ai-request.test.ts ai-usage-budget.test.ts audit-export.test.ts email-decision.test.ts encrypt.test.ts health-search-index-lag.test.ts mime.test.ts retention.test.ts s3-sign.test.ts search-index.test.ts smtp.test.ts webhook-sign.test.ts
health/1server.ts
lib/12
__tests__/1clamav.test.ts
clamav.ts encrypt.ts job-otel.ts mime.ts notify.ts prisma.ts redis-stream.ts redis.ts s3.ts sharp.ts smtp.ts
processors/56
automations/28
__tests__/3condition-evaluator.spec.ts executors.spec.ts run-pipeline.spec.ts
executors/17assign-user.ts call-integration.ts change-status.ts classify.ts create-notification.ts create-page.ts email-cap.ts helpers.ts integration-registry.ts permission.ts record-write.ts registry.ts run-ai-action.ts send-email.ts send-webhook.ts types.ts update-record.ts
condition-evaluator.ts dead-letter.ts log.ts matcher.ts pipeline.ts run-state.ts schedule.ts watchdog.ts
files/15
__tests__/4errors.test.ts scan-gate.test.ts status.test.ts temp.test.ts
steps/4finalize.ts metadata.ts scan.ts thumbnails.ts
cleanup.ts errors.ts generateThumbs.ts processor.ts status.ts temp.ts types.ts
search-index/4builders.ts grants.ts index.ts processor.ts
ai-embedding.ts ai.processor.ts audit-export.ts automations.processor.ts email-decision.processor.ts email.processor.ts maintenance.processor.ts retention.ts webhooks.processor.ts
config.ts events.ts index.ts logger.ts queues.ts
.env.example Dockerfile package.json README.md tsconfig.json
docs/73
api/17ai.md authentication.md automations.md blocks.md comments.md databases.md files.md forms.md openapi.yaml org-admin.md pages.md scim.md search.md sso.md versioning.md webhooks.md workspaces.md
architecture/10ai-architecture.md automation.md backend-architecture.md database-architecture.md frontend-architecture.md realtime-architecture.md search-architecture.md security-architecture.md storage.md system-architecture.md
database/2database-architecture.md redis-keys.md
development/8admin-guide.md coding-standards.md deployment.md development-guide.md files-pipeline.md perf-report.md performance.md testing.md
product/4functional-requirements.md non-functional-requirements.md product-requirements.md ux-requirements.md
requirements/1requirements-matrix.md
security/5audit-report.md files.md forms.md license-allowlist.md security-architecture.md
tasks/16phase-00-foundation.md phase-01-authentication.md phase-02-workspace.md phase-03-pages.md phase-04-editor.md phase-05-databases.md phase-06-relations.md phase-07-collaboration.md phase-08-search.md phase-09-files.md phase-10-forms.md phase-11-automation.md phase-12-ai.md phase-13-api.md phase-14-enterprise.md phase-15-production.md
ui/9ai.md automations.md design-system.md developers.md files.md forms.md org-admin.md scim.md sso.md
support-matrix.md
infrastructure/71
caddy/1Caddyfile
docker/6
init/101-extensions.sql
opensearch/1init-indices.json
.env.docker docker-compose.yml opensearch-init.sh README.md
kubernetes/40
observability/20
alertmanager/1alertmanager.yaml
grafana/8
dashboards/6ai.json api-overview.json infra.json realtime.json search.json workers-queues.json
provisioning/2
dashboards/1dashboards.yaml
datasources/1datasource.yaml
prometheus/3alerts.yaml recording-rules.yaml scrape.yaml
scripts/1sync-sources.mjs
alertmanager.yaml grafana.yaml kustomization.yaml namespace.yaml node-exporter.yaml otel-collector.yaml prometheus.yaml
postgres/7configmap.yaml cronjob-backup.yaml cronjob-opensearch-snapshot.yaml pgbouncer.yaml replica.yaml statefulset.yaml walg-iam-policy.yaml
api.yaml configmap.yaml ingress.yaml kustomization.yaml namespace.yaml networkpolicy.yaml pdb.yaml README.md realtime.yaml redis.yaml secret.example.yaml web.yaml worker.yaml
nginx/2nginx.conf README.md
observability/14
alertmanager/1alertmanager.yaml
grafana/8
dashboards/6ai.json api-overview.json infra.json realtime.json search.json workers-queues.json
provisioning/2
dashboards/1dashboards.yaml
datasources/1datasource.yaml
prometheus/3alerts.yaml recording-rules.yaml scrape.yaml
scripts/1dashboard-completeness.mjs
README.md
terraform/8compute.tf data.tf main.tf network.tf outputs.tf README.md security.tf variables.tf
packages/289
ai/24
src/20
providers/7anthropic.ts google.ts http.ts index.ts openai-compatible.ts rag.test.ts writing.test.ts
schemas/2database.ts generate.ts
adapters.test.ts config.test.ts config.ts gateway.test.ts gateway.ts index.ts tools.test.ts tools.ts types.ts usage.test.ts usage.ts
package.json README.md tsconfig.json vitest.config.ts
auth/11
src/7index.ts passwords.test.ts passwords.ts sessions.test.ts sessions.ts tokens.test.ts tokens.ts
package.json README.md tsconfig.json vitest.config.ts
collaboration/17
src/13awareness.ts codec.test.ts codec.ts index.ts lww.test.ts lww.ts mapping.ts offline.ts outbox.test.ts outbox.ts provider.test.ts provider.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
config/7
src/4eslint.base.js index.ts prettier.base.json tsconfig.base.json
package.json README.md tsconfig.json
database-client/5
src/2index.test.ts index.ts
package.json README.md tsconfig.json
database-engine/33
src/29
filter/2filter.test.ts index.ts
formula/8evaluator.ts formula.test.ts functions.ts index.ts lexer.ts parser.ts types.ts validate.ts
query/6group.ts index.ts paginate.ts pivot.ts query.test.ts sort.ts
relations/2index.ts relations.test.ts
rollups/2index.ts rollups.test.ts
values/5dates.ts index.ts registry.ts types.ts values.test.ts
views/3buttons.ts index.ts views.test.ts
index.ts
package.json README.md tsconfig.json vitest.config.ts
editor/25
src/21
marks/1highlight.ts
nodes/2equation.ts mention.ts
autosave.test.ts autosave.ts clipboard.test.ts clipboard.ts codec.test.ts codec.ts context-menu.test.ts context-menu.ts diff.test.ts diff.ts factory.ts history.test.ts history.ts index.ts positions.ts slash.test.ts slash.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
observability/20
src/16
__tests__/8db-redis-metrics.test.ts metrics.test.ts otel.test.ts pino-otel.test.ts prometheus.test.ts resource.test.ts scrubber.test.ts traceparent.test.ts
index.ts metrics.ts otel.ts pino-otel.ts prometheus.ts resource.ts scrubber.ts traceparent.ts
package.json README.md tsconfig.json vitest.config.ts
permissions/11
src/7index.ts levels.test.ts levels.ts resolve.test.ts resolve.ts rules.test.ts rules.ts
package.json README.md tsconfig.json vitest.config.ts
search/22
src/18chunking.test.ts chunking.ts client.test.ts client.ts embeddings.test.ts embeddings.ts hybrid.test.ts hybrid.ts index.ts indexer.test.ts indexer.ts mapping.test.ts mapping.ts queries.test.ts queries.ts rrf.test.ts rrf.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
shared/61
src/57
dto/17ai.dto.ts auth.dto.test.ts auth.dto.ts block.dto.ts browser-safety.test.ts comment.dto.ts database.dto.test.ts database.dto.ts file.dto.ts formula-ast.ts index.ts notification.dto.ts page.dto.ts search.dto.ts share.dto.ts webhook.dto.ts workspace.dto.ts
events/8audit-catalog.test.ts audit-catalog.ts audit-csv.test.ts audit-csv.ts audit-scope.test.ts audit-scope.ts catalog.test.ts catalog.ts
realtime/6comment-events.ts frames.test.ts frames.ts notification-policy.ts notification-prefs.ts task-0094.test.ts
automation.test.ts automation.ts constants.ts crypto.test.ts crypto.ts env.ts errors.ts events.test.ts events.ts forms.test.ts forms.ts index.ts markdown.test.ts markdown.ts mentions.test.ts mentions.ts net.test.ts net.ts positions.test.ts positions.ts presence.test.ts presence.ts security-headers.ts webhook-delivery.test.ts webhook-delivery.ts webhook-events.ts
package.json README.md tsconfig.json vitest.config.ts
storage/16
src/12client.test.ts client.ts index.ts keys.test.ts keys.ts mime.test.ts mime.ts presign.test.ts presign.ts thumbnails.test.ts thumbnails.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
ui/37
src/33
components/19avatar.tsx badge.tsx button.tsx checkbox.tsx command.tsx context-menu.tsx dialog.tsx dropdown-menu.tsx empty-state.tsx index.ts popover.tsx separator.tsx skeleton.tsx slider.tsx spinner.tsx switch.tsx tabs.tsx toast.tsx tooltip.tsx
color.ts command-filter.test.ts command-filter.ts focus.test.ts focus.ts formatters.test.ts formatters.ts index.ts theme.test.ts theme.ts toast-store.test.ts toast-store.ts tokens.test.ts tokens.ts
package.json README.md tsconfig.json vitest.config.ts
prisma/16
migrations/13
20260927000000_init/1migration.sql
20260928000000_search_documents_content_hash/1migration.sql
20260929000000_workspace_usage_storage_bytes/1migration.sql
20260930000000_form_submitted_notification_type/1migration.sql
20261001000000_ai_phase12/1migration.sql
20261002000000_webhooks_secret_encrypted_dlq/1migration.sql
20261002111436_webhook_delivery_latency/1migration.sql
20261002120000_org_admin_2fa_retention_unique/1migration.sql
20261002215124_audit_export/1migration.sql
20261003210000_perf_indexes_hot_paths/1migration.sql
20261004004500_perf_indexes_hot_paths_2/1migration.sql
migration_lock.toml README.md
schema.prisma seed.ts verify.ts
scripts/7backup-health.ts docs-completeness.mjs generate-openapi.mjs minio-init.ts opensearch-reindex.ts storage-orphans.ts verify-clean-clone.sh
tests/169
e2e/63
.auth/1user.json
fixtures/7
files/6clip.mp4 clip.wav clip.webm hero-1400.png note.docx note.txt
realtime.ts
mocks/2oidc-issuer.ts saml-idp.ts
playwright-report/3
data/2a6557bae9c2714a658968d4eb8534195c08ebda8.png e3092d07d00a16063e46385c02a559a9054fa847.webm
index.html
reports/1files-security.json
specs/34ai-database.spec.ts ai-generate.spec.ts ai-rag.spec.ts ai-security.spec.ts ai-writing.spec.ts ai.spec.ts api-keys.spec.ts appearance-theme.spec.ts auth.spec.ts automation.spec.ts collab-two-tab.spec.ts comments.spec.ts databases.spec.ts default-workspace-alias.spec.ts developers.spec.ts editor.spec.ts files.spec.ts final-flow.spec.ts forms.spec.ts oauth.spec.ts org-admin.spec.ts pages.spec.ts performance.spec.ts presence-cursors.spec.ts qa-paste-toggle.spec.ts realtime.spec.ts scim.spec.ts search-index-lag.spec.ts search.spec.ts sharing.spec.ts sso.spec.ts task-0094-comments-notifications.spec.ts webhooks.spec.ts workspace.spec.ts
test-results-final-flow/3
final-flow-Release-v1-0-fi-6c06b-w-state-carries-sequential--chromium-desktop/2test-failed-1.png trace.zip
.last-run.json
utils/4api.ts dnd.ts search-lag.ts wait.ts
.gitignore fixtures.ts global-setup.ts package.json playwright.config.ts playwright.final-flow.config.ts README.md tsconfig.json
fixtures/1
files/1make-sparse.ts
integration/60
ai-capability/2ai-app.capability.test.ts gateway.capability.test.ts
drill/2seed-drill.mjs verify-restore.mjs
fixtures/5
files/5clip.mp4 clip.wav doc.pdf hero-1400.png note.txt
helpers/3api.ts containers.ts seed.ts
realtime/11control-channel.test.ts convergence.test.ts flush-rebase-http.test.ts handshake.test.ts heartbeat-limits.test.ts lifecycle.test.ts presence.test.ts rebase.test.ts resume.test.ts rt-helpers.ts task-0094-fanout.test.ts
ai-chat.integration.test.ts ai-database.integration.test.ts ai-generate.integration.test.ts ai-rag.integration.test.ts ai-writing.integration.test.ts api-keys.integration.test.ts audit-completeness.integration.test.ts audit-export-s3.integration.test.ts auth.integration.test.ts automation-pipeline.integration.test.ts automations.integration.test.ts blocks.integration.test.ts cache-invalidation.integration.test.ts comments.integration.test.ts databases.integration.test.ts files-lifecycle.integration.test.ts files-pipeline.integration.test.ts files-security.integration.test.ts files.integration.test.ts forms-responses.integration.test.ts forms.integration.test.ts oauth.integration.test.ts openapi.contract.test.ts org-admin.integration.test.ts package.json pages.integration.test.ts permissions.integration.test.ts README.md replica-routing.integration.test.ts retention-engine.integration.test.ts scim.integration.test.ts search.integration.test.ts sso.integration.test.ts tsconfig.json vitest.config.ts webhooks.integration.test.ts workspace.integration.test.ts
performance/28
fixtures/1search-100k.ts
helpers/2seed-100k.mjs seed-1k-load.mjs
reports/7api-load-smoke.json database-load-smoke.json editor-local.json realtime-load.json search-full.json search-last.json search-reduced.json
api-load.js api.js archive.tar database-load.js database.js editor-local.mjs extract-100k-env.mjs package.json README.md realtime-1k.js realtime-load.js realtime.js run-realtime-load.sh search-search.k6.js search-summary.json seed-100k.mjs threshold-breach-demo.js verify-zero-op-loss.mjs
security/16
helpers/1app.ts
audit-report.test.ts auth-paths.test.ts deps.test.ts formula-fuzz.test.ts gitleaks-config.test.ts headers.test.ts images.test.ts oracle.ts package.json permission-fuzz.test.ts rate-limits.test.ts README.md tsconfig.json upload-abuse.test.ts vitest.config.ts
README.md
.dockerignore .env .env.bak-task0125 .env.example .eslintrc.json .gitignore .npmrc .prettierignore .prettierrc.json AGENTS.md ARCHITECTURE.md CHANGELOG.md CONTRIBUTING.md gitleaks.toml LICENSE package.json pnpm-lock.yaml pnpm-workspace.yaml PRODUCT-SPEC.md README.md ROADMAP.md SECURITY.md tsconfig.json turbo.json
realtime-load.jstests/performance/realtime-load.jsraw← performance21,492 B← Back to the app
1/**
2 * AI Software Factory — k6: realtime 10k load (TASK-0135, the §26 matrix).
3 *
4 * Scenario (the spec, verbatim):
5 *   - connect   10,000 concurrent ws over 5 min (100 rooms × 100 conns,
6 *               jittered join), then held 15 min steady state.
7 *   - edit      all 10k send block-edit (Yjs update) ops, 200 msg/s aggregate
8 *               (rate-limited per-conn: 200/10000 = 0.02 msg/s = 1 op/50 s).
9 *   - presence  1,000 presence identities, join/leave churn 10/min.
10 *   - (verify)  a dedicated room the zero-dropped-op hash check targets.
11 *
12 * Thresholds (staging-hard):
13 *   op_ack_ms           p(95) < 200 ms   (client-observed send-update → ack)
14 *   connect_ms          p(95) < 1 000 ms (connect → hello)
15 *   protocol_errors     count  < 1       (0 FORBIDDEN / bad_update / error)
16 *   ws_unexpected_closes rate  < 0.005   (disconnects < 0.5%, excl. the
17 *                                          scripted clean close at deadline)
18 *
19 * Zero-dropped Yjs ops (the spec's "final doc state hash equals the
20 * sequential-replay hash") is a HOST-SIDE check, not a k6 threshold — k6's
21 * goja VM has no Yjs to hash a doc. `run-realtime-load.sh` (this dir) does it:
22 * the k6 `verify-writers` scenario sends a fixed, known set of Yjs updates to
23 * the `page:verify` room; the runner connects, full-syncs that room, and asserts
24 * the server's final doc state hashes to the same value as a fresh Yjs doc with
25 * exactly those updates applied in order. A lost update changes the hash.
26 *
27 * Protocol (the real TASK-0091 contract — packages/shared frames.ts), reusing
28 * tests/performance/realtime-1k.js conventions:
29 *   connect:  <K6_REALTIME_URL>/realtime?token=<jwt>&room=page:<pageId>
30 *             header: X-Forwarded-For: 10.100.<a>.<b>   (per-VU identity)
31 *   hello:    {type:"hello", connId, canEdit, serverTime, roomPeers}
32 *   update:   binary 0x01 + YjsUpdate  → server logs it and replies
33 *   ack:      {type:"ack", seq}         (the op-ack — measured here)
34 *   awareness: binary 0x02 + JSON state
35 *   ping:     {type:"ping", ts}         → {type:"ping-pong", ts}
36 *
37 * Why 10,000 distinct identities + distinct source IPs (MANDATORY): the
38 * server caps 100 live sockets/user + 10/user control + 30/min connect per
39 * source IP. One shared token can never reach 10,000 (the 101st is 429). Each
40 * VU mints its own HS256 JWT (k6/crypto) for a distinct seeded user id and
41 * presents a per-socket X-Forwarded-For, so the server must run
42 * REALTIME_TRUST_PROXY=1. The identities + EDIT grants come from the seeder
43 * (helpers/seed-1k-load.mjs with K6_USERS=10000 + K6_PAGE_IDS = 100 rooms).
44 *
45 * Env:
46 *   K6_REALTIME_URL    ws base (default ws://localhost:4001)
47 *   K6_JWT_SECRET      shared HS256 secret (required — must match the server)
48 *   K6_WORKSPACE_ID    the loaded workspace (required)
49 *   K6_PAGE_IDS        100 room page ids, comma-separated (required)
50 *   K6_VUS             total edit VUs (default 10000)
51 *   K6_RAMP_SECONDS    ramp 0→VUS (default 300 = 5 min)
52 *   K6_HOLD_SECONDS    steady state (default 900 = 15 min)
53 *   K6_PRESENCE_VUS    presence identities (default 1000)
54 *   K6_OP_ACK_P95_MS   op-ack p95 budget (default 200)
55 *   K6_CONNECT_P95_MS  connect p95 budget (default 1000)
56 *   K6_STRICT          "1" hard (default) / "0" report-only (trivially-true
57 *                      thresholds; the run still prints real values)
58 *
59 * Run (staging):  K6_STRICT=1 … run-realtime-load.sh
60 * Run (smoke):    K6_PROFILE=smoke pnpm --dir tests/performance realtime-load
61 */
62import ws from "k6/ws";
63import crypto from "k6/crypto";
64import encoding from "k6/encoding";
65import { sleep } from "k6";
66import { Trend, Rate, Counter } from "k6/metrics";
67 
68const OP_ACK_MS = new Trend("op_ack_ms", true);
69const CONNECT_MS = new Trend("connect_ms", true);
70const RTT_MS = new Trend("rtt_ms", true);
71const joinFailures = new Rate("join_failures");
72const protocolErrors = new Counter("protocol_errors");
73const unexpectedCloses = new Rate("ws_unexpected_closes");
74const updateAcks = new Counter("update_acks");
75const presenceJoins = new Counter("presence_joins");
76 
77const WS_URL = __ENV.K6_REALTIME_URL || "ws://localhost:4001";
78const SECRET = __ENV.K6_JWT_SECRET || "";
79const WORKSPACE_ID = __ENV.K6_WORKSPACE_ID || "";
80const PAGE_IDS = String(__ENV.K6_PAGE_IDS || "").split(",").filter(Boolean);
81const SMOKE = __ENV.K6_PROFILE === "smoke";
82const STRICT = (__ENV.K6_STRICT || "1") !== "0";
83 
84const VUS = parseInt(__ENV.K6_VUS || (SMOKE ? "100" : "10000"), 10);
85const RAMP_SECONDS = parseInt(__ENV.K6_RAMP_SECONDS || (SMOKE ? "10" : "300"), 10);
86const HOLD_SECONDS = parseInt(__ENV.K6_HOLD_SECONDS || (SMOKE ? "20" : "900"), 10);
87const PRESENCE_VUS = parseInt(__ENV.K6_PRESENCE_VUS || (SMOKE ? "10" : "1000"), 10);
88const OP_ACK_P95_MS = parseInt(__ENV.K6_OP_ACK_P95_MS || "200", 10);
89const CONNECT_P95_MS = parseInt(__ENV.K6_CONNECT_P95_MS || "1000", 10);
90 
91// 200 msg/s aggregate across VUS ⇒ per-VU cadence (rate-limited per-conn).
92const MSG_INTERVAL_MS = Math.max(100, Math.round((VUS * 1000) / 200));
93// Presence churn: 10 join/leave cycles per minute fleet-wide. A small active
94// set of `PRESENCE_ACTIVE` VUs (constant-vus) each runs one join→awareness→
95// leave cycle per minute; each wave draws PRESENCE_ACTIVE DISTINCT identities
96// (see presenceChurn), advancing the pool by that many — so all PRESENCE_VUS
97// identities are exercised over the run. Smoke caps the pool to 10 (the
98// seeded smoke fixture has 100 load users; the pool only needs a slice).
99const PRESENCE_ACTIVE = 10;
100 
101// The zero-dropped-op verify room + its fixed update set (host-replayed).
102// A dedicated seeded page id for the verify room (the server only joins
103// rooms for real pages). The runner/seeder creates it (K6_PAGES includes
104// load-p-verify); overridable.
105const VERIFY_ROOM = __ENV.K6_VERIFY_PAGE_ID || "load-p-verify";
106// 4 valid Yjs updates (base64) — each inserts a distinct marker into the Y.Text
107// "k6". Re-applying is an idempotent no-op, but a LOST one is not: the final
108// doc is missing that insert, so its state hash differs from the replay.
109// (Same regenerated set as realtime-1k.js — see its header note.)
110const YJS_UPDATES = [
111  "AQGCprqECwAEAQJrNhlrNiBsb2FkIHVwZGF0ZSB2YXJpYW50IDAgAA==",
112  "AQHgk6jsCgAEAQJrNhlrNiBsb2FkIHVwZGF0ZSB2YXJpYW50IDEgAA==",
113  "AQGf2MjCBAAEAQJrNhlrNiBsb2FkIHVwZGF0ZSB2YXJpYW50IDIgAA==",
114  "AQHzmP0+AAQBAms2GWs2IGxvYWQgdXBkYXRlIHZhcmlhbnQgMyAA",
115];
116const BINARY_KIND = { Update: 0x01, Awareness: 0x02 };
117 
118/** base64url for JWT segments (no padding). */
119function b64url(input) {
120  return input.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
121}
122 
123/**
124 * Mint an access JWT (HS256, shared secret) — the exact claims shape
125 * @factory/auth/tokens + apps/realtime/src/auth.ts accept: sub, workspaces[],
126 * iat, exp (unix seconds), jti. (Reused from realtime-1k.js.)
127 */
128function mintToken(sub, workspaces) {
129  const nowSec = Math.floor(Date.now() / 1000);
130  const header = b64url(encoding.b64encode(JSON.stringify({ alg: "HS256", typ: "JWT" }), "base64"));
131  const claims = b64url(
132    encoding.b64encode(
133      JSON.stringify({
134        sub: sub,
135        workspaces: workspaces,
136        iat: nowSec,
137        exp: nowSec + 900,
138        jti: `k6-${sub}-${nowSec}`,
139      }),
140      "base64",
141    ),
142  );
143  const sig = b64url(crypto.hmac("sha256", SECRET, `${header}.${claims}`, "base64"));
144  return `${header}.${claims}.${sig}`;
145}
146 
147/** binary 0x01 + a valid Yjs update → ArrayBuffer for ws.sendBinary. */
148function updateFrame(variant) {
149  const bytes = encoding.b64decode(YJS_UPDATES[variant % YJS_UPDATES.length], "base64");
150  const out = new Uint8Array(bytes.length + 1);
151  out[0] = BINARY_KIND.Update;
152  out.set(bytes, 1);
153  return out.buffer;
154}
155 
156/** binary 0x02 + a small awareness state. */
157function awarenessFrame(userId) {
158  const payload = JSON.stringify({
159    user: { id: userId, name: "k6", color: "slate" },
160    cursor: { x: (userId.length * 7) % 800, y: (userId.length * 13) % 600 },
161  });
162  const data = encoding.b64encode(payload, "utf8");
163  const out = new Uint8Array(data.length + 1);
164  out[0] = BINARY_KIND.Awareness;
165  out.set(data, 1);
166  return out.buffer;
167}
168 
169export function setup() {
170  if (!SECRET) throw new Error("setup: K6_JWT_SECRET is required (the shared HS256 secret)");
171  if (!WORKSPACE_ID) throw new Error("setup: K6_WORKSPACE_ID is required (the seeder prints it)");
172  if (PAGE_IDS.length === 0) throw new Error("setup: K6_PAGE_IDS is required (100 room page ids)");
173  if (!SMOKE && PAGE_IDS.length < 100) {
174    throw new Error(`setup: full profile needs 100 room page ids, got ${PAGE_IDS.length}`);
175  }
176  return { ok: true };
177}
178 
179/**
180 * The 10k edit scenario: connect (jittered), hold, send Yjs update ops at the
181 * per-conn rate-limited cadence, clean close. Measures connect_ms + op_ack_ms.
182 */
183export function editLoad() {
184  const vu = __VU;
185  // 4-digit ids — the seeder (helpers/seed-1k-load.mjs) creates
186  // k6-load-u-0000 … k6-load-u-9999 (10,000 fit exactly in 4 digits).
187  const pad4 = String(vu - 1).padStart(4, "0");
188  const userId = `k6-load-u-${pad4}`;
189  const ip = `10.100.${Math.floor((vu - 1) / 256)}.${(vu - 1) % 256}`;
190  // 100 rooms × 100 conns: VU i → room (i-1) mod 100.
191  const roomIdx = (vu - 1) % Math.max(1, Math.min(100, PAGE_IDS.length));
192  const pageId = PAGE_IDS[roomIdx];
193  const token = mintToken(userId, [WORKSPACE_ID]);
194 
195  // Real thundering-herd de-correlation: a per-VU 0..~1.05 s pre-DELAY (an
196  // actual sleep, not a timestamp offset) so the 100 conns of a room don't all
197  // hit the upgrade in the same instant. The ramp already spreads joins; this
198  // adds room-level de-correlation. connectStart is the TRUE connect time
199  // (after the delay) so CONNECT_MS (connect→hello) is a real, non-negative
200  // latency.
201  sleep((vu % 7) * 0.15);
202  const connectStart = Date.now();
203 
204  const url = `${WS_URL}/realtime?token=${encodeURIComponent(token)}&room=${encodeURIComponent(`page:${pageId}`)}`;
205  const holdMs = Math.max(1000, HOLD_SECONDS * 1000);
206  let joined = false;
207  let lastSentTs = 0; // for op-ack (one outstanding update per VU at this rate)
208  const sentTs = {};
209 
210  // NOTE: ws.connect's return value is NOT used for success detection. On
211  // k6 v0.57 the returned object has no reliable `.Status` (measured
212  // `undefined` on a successful join, and property access on the native
213  // value throws in goja) — so `resp.Status !== 101` would false-positive
214  // (or throw) on every HEALTHY join. The only robust success signal is the
215  // server's `hello` frame, which it sends only after the full auth + room +
216  // permission chain resolves. `joined` (set in the on-message handler below)
217  // is therefore the join-success oracle; `!joined` after the hold = a join
218  // failure (covers 401/403/400/429 upgrade rejects AND the 500-permission
219  // path, which upgrades OK but never sends hello).
220  ws.connect(
221    url,
222    { headers: { "x-forwarded-for": ip } },
223    (socket) => {
224      socket.on("message", (raw) => {
225        let msg;
226        try {
227          msg = JSON.parse(raw);
228        } catch {
229          return;
230        }
231        switch (msg.type) {
232          case "hello":
233            joined = true;
234            CONNECT_MS.add(Date.now() - connectStart); // connect → hello
235            if (msg.canEdit !== true) protocolErrors.add(1); // VIEW hello = wiring bug
236            break;
237          case "ack":
238            // op-ack: the client-observed latency of a sent update.
239            updateAcks.add(1);
240            if (lastSentTs) OP_ACK_MS.add(Date.now() - lastSentTs);
241            break;
242          case "ping-pong":
243            if (typeof msg.ts === "number" && sentTs[msg.ts]) {
244              RTT_MS.add(Date.now() - msg.ts);
245              delete sentTs[msg.ts];
246            }
247            break;
248          case "error":
249            protocolErrors.add(1);
250            break;
251          // sync.state / doc.persisted / … — ignore.
252        }
253      });
254      socket.on("binaryMessage", () => {}); // relayed updates/awareness
255      socket.on("close", () => {
256        // "Unexpected" = we HAD a good join (hello arrived) and the socket
257        // dropped before the hold window. A failed join (rejected upgrade, or
258        // the 500-permission path — no hello) is a join_failure, not an
259        // unexpected close, so gate on `joined`.
260        if (joined && Date.now() < connectStart + holdMs - 5000) unexpectedCloses.add(1);
261      });
262      socket.on("error", () => protocolErrors.add(1));
263 
264      // The rate-limited 200 msg/s aggregate: one op per MSG_INTERVAL_MS,
265      // alternating update / awareness / ping (the block-edit op is the update).
266      let tick = 0;
267      socket.setInterval(() => {
268        const r = Math.random();
269        if (r < 0.6) {
270          lastSentTs = Date.now();
271          socket.sendBinary(updateFrame(tick));
272        } else if (r < 0.8) {
273          socket.sendBinary(awarenessFrame(userId));
274        } else {
275          const ts = Date.now();
276          sentTs[ts] = true;
277          socket.send(JSON.stringify({ type: "ping", ts: ts }));
278        }
279        tick += 1;
280      }, MSG_INTERVAL_MS);
281 
282      socket.setTimeout(() => {
283        if (joined) socket.close(1000); // scripted clean close (not a disconnect)
284      }, holdMs);
285    },
286  );
287 
288  // HOLD the VU. k6 v0.57's ws.connect is NON-BLOCKING: it returns as soon as
289  // the upgrade is initiated, so without an explicit hold the iteration
290  // returns instantly and k6 fires the next one — a tight connect-retry loop
291  // (measured: ~1,068 iters/s, 42k joins in a 30 s smoke). The socket's
292  // setInterval (edit cadence) + setTimeout (scripted close at holdMs) keep
293  // the connection alive and drive the metrics; each 1 s sleep YIELDS to the
294  // socket event loop (k6 timers need the VU to yield), so the edit cadence
295  // keeps ticking. The socket's own close ends this iteration (k6 returns a
296  // VU to the pool when its socket closes).
297  const editDeadline = Date.now() + holdMs + 5_000; // grace past the scripted close
298  while (Date.now() < editDeadline) sleep(1);
299 
300  // Join-failure detection — the `hello` oracle (see the note above ws.connect).
301  // No hello by the end of the hold = the join never established (bad token /
302  // 403 / 429 / 400, or the 500-permission path that upgrades but never
303  // sends hello). On a healthy post-fix server this stays ~0; on the current
304  // buggy server it is ~1.0 (the dev report prints it without blocking).
305  if (!joined) joinFailures.add(1);
306}
307 
308/**
309 * Presence churn: 10 active VUs, each a join→awareness→leave cycle once a
310 * minute (10/min fleet), round-robining the PRESENCE_VUS identity pool.
311 */
312export function presenceChurn() {
313  const cycle = __ITER + 1;
314  // 10 active VUs × one cycle per minute = 10 join/leave cycles per minute
315  // fleet-wide. The `+ (__VU - 1)` offset makes each wave draw 10 DISTINCT
316  // identities (constant-vus gives every VU its own __ITER, so without the
317  // offset all 10 VUs of a wave would reuse the same identity); each wave
318  // advances the pool by PRESENCE_ACTIVE, so all PRESENCE_VUS identities are
319  // exercised over the run.
320  const userIdx = ((cycle - 1) * PRESENCE_ACTIVE + (__VU - 1)) % PRESENCE_VUS;
321  // Presence identities reuse the seeded load-user pool (k6-load-u-XXXX —
322  // they carry the workspace EDIT grant; a k6-pres-u-* id would have no user
323  // row and 403 the join).
324  const pad4 = String(userIdx).padStart(4, "0");
325  const userId = `k6-load-u-${pad4}`;
326  const ip = `10.100.${200 + Math.floor(userIdx / 256)}.${userIdx % 256}`;
327  const pageId = PAGE_IDS[userIdx % PAGE_IDS.length];
328  const token = mintToken(userId, [WORKSPACE_ID]);
329 
330  const url = `${WS_URL}/realtime?token=${encodeURIComponent(token)}&room=${encodeURIComponent(`page:${pageId}`)}`;
331  // joined is the join-success oracle (hello frame) — see the note in
332  // editLoad. Presence joins are short; a join that never hellos within the
333  // 5 s dwell is a join_failure.
334  let joined = false;
335  ws.connect(
336    url,
337    { headers: { "x-forwarded-for": ip } },
338    (socket) => {
339      socket.on("message", (raw) => {
340        let msg;
341        try {
342          msg = JSON.parse(raw);
343        } catch {
344          return;
345        }
346        if (msg.type === "hello") {
347          joined = true;
348          presenceJoins.add(1);
349          socket.sendBinary(awarenessFrame(userId));
350        } else if (msg.type === "error") {
351          protocolErrors.add(1);
352        }
353      });
354      socket.on("binaryMessage", () => {});
355      // Short presence dwell (5 s) then leave — the join/leave churn.
356      socket.setTimeout(() => {
357        if (joined) socket.close(1000);
358      }, 5000);
359    },
360  );
361 
362  // HOLD the VU (ws.connect is non-blocking on k6 v0.57 — same as editLoad):
363  // hold ~7 s past the scripted 5 s presence dwell, then let the next cycle
364  // draw a fresh identity.
365  const presenceDeadline = Date.now() + 7_000;
366  while (Date.now() < presenceDeadline) sleep(1);
367  if (!joined) joinFailures.add(1);
368}
369 
370/**
371 * The zero-dropped-op verify writers: a small set of VUs in the dedicated
372 * `page:verify` room, each sending the 4 known Yjs updates exactly once. The
373 * host runner (run-realtime-load.sh) full-syncs this room and asserts its doc
374 * state hash == a fresh doc replayed with these 4 updates (loss ⇒ mismatch).
375 */
376export function verifyWriters() {
377  // Reuse the first seeded load users (k6-load-u-0000… — they exist in both
378  // the 100-user smoke seed and the 10,000-user full seed and carry the
379  // workspace EDIT grant).
380  const userId = `k6-load-u-${String(__VU - 1).padStart(4, "0")}`;
381  const ip = `10.100.250.${__VU}`;
382  const token = mintToken(userId, [WORKSPACE_ID]);
383  const url = `${WS_URL}/realtime?token=${encodeURIComponent(token)}&room=${encodeURIComponent(`page:${VERIFY_ROOM}`)}`;
384  // joined is the join-success oracle (hello frame) — see the note in
385  // editLoad. A verify writer that never hellos sends no updates (the update
386  // send is gated on `joined`), so the host-side hash check would already
387  // catch the loss; this metric records the join failure explicitly.
388  let joined = false;
389  ws.connect(
390    url,
391    { headers: { "x-forwarded-for": ip } },
392    (socket) => {
393      socket.on("message", (raw) => {
394        let msg;
395        try {
396          msg = JSON.parse(raw);
397        } catch {
398          return;
399        }
400        if (msg.type === "hello") joined = true;
401        else if (msg.type === "error") protocolErrors.add(1);
402      });
403      socket.on("binaryMessage", () => {});
404      socket.on("close", () => {});
405      // Send all 4 verify updates once the room is joined, then hold.
406      socket.setTimeout(() => {
407        if (!joined) return;
408        for (let v = 0; v < YJS_UPDATES.length; v++) {
409          socket.sendBinary(updateFrame(v));
410        }
411      }, 2000);
412      socket.setTimeout(() => {
413        if (joined) socket.close(1000);
414      }, Math.max(4000, HOLD_SECONDS * 1000));
415    },
416  );
417 
418  // HOLD the VU (ws.connect is non-blocking on k6 v0.57): hold through the
419  // scripted close (max(4 s, HOLD) + the 2 s send delay) so this VU's verify
420  // updates are actually delivered before the iteration ends.
421  const verifyDeadline = Date.now() + Math.max(4000, HOLD_SECONDS * 1000) + 5_000;
422  while (Date.now() < verifyDeadline) sleep(1);
423  if (!joined) joinFailures.add(1);
424}
425 
426const HARD_THRESHOLDS = {
427  op_ack_ms: [`p(95)<${OP_ACK_P95_MS}`],
428  connect_ms: [`p(95)<${CONNECT_P95_MS}`],
429  // A load run that establishes ZERO connections has measured nothing — the
430  // op-ack / connect Trends stay empty (avg 0) and would otherwise pass the
431  // p95 budgets vacuously while 100% of handshakes fail. Gate on the
432  // establishment rate so the hard tier actually requires healthy joins.
433  // (Soft is `rate<=1` = always-pass, so report-only runs stay green.)
434  join_failures: ["rate<0.001"],
435  protocol_errors: ["count<1"],
436  ws_unexpected_closes: ["rate<0.005"],
437};
438// Report-only (K6_STRICT=0): thresholds that can NEVER fail, so the dev/main
439// tier always stays green while the summary still prints the real values.
440// NOTE: k6 Rate thresholds are a FRACTION (0..1), so `rate<=1` is the true
441// "always-pass" bound (a 100% failure rate is exactly 1.0, which would fail
442// `rate<1` — that red-on-soft bug is what the `<=` fixes).
443const SOFT_THRESHOLDS = {
444  op_ack_ms: ["avg<1e15"],
445  connect_ms: ["avg<1e15"],
446  join_failures: ["rate<=1"],
447  protocol_errors: ["count<1e15"],
448  ws_unexpected_closes: ["rate<=1"],
449};
450 
451export const options = {
452  scenarios: {
453    // 10k concurrent over RAMP (5 min), held HOLD (15 min) steady.
454    edit: {
455      executor: "ramping-vus",
456      startVUs: 0,
457      stages: [
458        { duration: `${RAMP_SECONDS}s`, target: VUS },
459        { duration: `${HOLD_SECONDS}s`, target: VUS },
460      ],
461      gracefulStop: "10s",
462      exec: "editLoad",
463    },
464    // Presence churn 10/min (PRESENCE_ACTIVE VUs × 1 cycle/min).
465    presence: {
466      executor: "constant-vus",
467      startTime: "0s",
468      duration: `${RAMP_SECONDS + HOLD_SECONDS}s`,
469      vus: PRESENCE_ACTIVE,
470      exec: "presenceChurn",
471    },
472    // Zero-dropped-op verify writers (dedicated room).
473    verify: {
474      executor: "constant-vus",
475      startTime: "0s",
476      duration: `${RAMP_SECONDS + HOLD_SECONDS + 10}s`,
477      vus: SMOKE ? 1 : 4,
478      exec: "verifyWriters",
479    },
480  },
481  thresholds: STRICT ? HARD_THRESHOLDS : SOFT_THRESHOLDS,
482  summaryTrendStats: ["avg", "min", "med", "p(90)", "p(95)", "p(99)", "max"],
483};
484