.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
editor.spec.tstests/e2e/specs/editor.spec.tsraw← specs24,775 B← Back to the app
1/**
2 * AI Software Factory — E2E: Block Editor (Phase 4)
3 *
4 * The canonical editor interaction suite. Slash commands, block types, the
5 * ⋮ context menu ("turn into" / delete), copy/paste, and reload persistence.
6 *
7 * T-194 — rewritten against the REAL editor surface (the pre-rewrite spec
8 * asserted a surface that never existed: an `<h1>` tag for headings, a
9 * `drag-handle-{id}` testid, a `context-menu-turn-heading1` id, a
10 * `toggle-handle-{id}` caret, `slash-menu-item-heading1`, block-level
11 * Backspace demotion, and block-level undo/redo — none of which the app
12 * implements, so the suite was red across the board). This rewrite drives
13 * the surface the app actually ships and asserts type/content changes
14 * SERVER-side (the read API is the source of truth — headings and quotes
15 * render as styled Tiptap contenteditables, not semantic tags), per AGENTS
16 * rule 29.
17 *
18 * Fresh-page typing surface (T-194 design decision — recorded conflict,
19 * rule 29): a freshly created page carries exactly ONE block, the seeded
20 * title (`properties.isTitle`). The render loop does NOT draw the title in
21 * the body (the header's `page-title` contenteditable is the canonical
22 * title and self-syncs). So the body of a fresh page is an empty canvas +
23 * the `new-block` trailing area — clicking it creates + focuses the first
24 * real paragraph (`onTrailingAreaClick` → `createSibling`), which is where
25 * typing and "/" begin. The recommended "server seeds an initial empty
26 * paragraph" was deliberately NOT taken: it would flip `contentBlockCount`
27 * to 1 and hide the TASK-0126 Home AI card on every fresh page, and would
28 * leave a stray empty leading block in the AI/template/import/duplicate
29 * flows (all of which call `pages.create` then populate). The existing
30 * `new-block` surface already provides a first-class fresh-page entry.
31 *
32 * Selector convention (tests/README.md): locate INTERACTIVE elements by
33 * `data-testid` only. (Text/role locators for controls are banned — they
34 * couple to copy and break on i18n. Reading rendered content text for an
35 * ASSERTION is allowed and used in the pinned green specs.)
36 *   data-testid="editor-root"               editor container
37 *   data-testid="block-{id}"                a top-level block row
38 *   data-testid="new-block"                 trailing "keep typing" area
39 *   data-testid="slash-menu" / "-item-{id}" slash palette + items
40 *   data-testid="block-context-menu"        right-click menu on a block
41 *   data-testid="context-menu-turn-into"    "Turn into…" button
42 *   data-testid="context-menu-turn-{type}"  a "Turn into" target type
43 *   data-testid="context-menu-delete"       the Delete menu item
44 *   data-testid="todo-checkbox-{id}"        checkbox on a TODO block
45 *   data-testid="toggle-chevron-{id}"       toggle open/close caret
46 *   data-testid="column-list" / "column-{n}" columns container + cell
47 *   data-testid="code-block-pre"            rendered (non-edit) code block
48 *
49 * Keyboard (the documented, implemented set):
50 *   "/" (in an EMPTY block) → slash menu
51 *   Enter (text block)      → new sibling paragraph below
52 *   Enter (toggle title)    → new CHILD inside the toggle
53 */
54import { test, expect } from "../fixtures";
55import type { APIRequestContext, Page } from "@playwright/test";
56 
57interface BlockRow {
58  id: string;
59  parentId: string | null;
60  type: string;
61  content: unknown;
62  properties: unknown;
63}
64 
65interface BlocksResponse {
66  data: BlockRow[];
67}
68 
69/**
70 * Top-level block rows. The `[data-block-id]` guard excludes
71 * `block-context-menu` (which also starts with the `block-` prefix) — only
72 * real rows carry both attributes.
73 */
74function rows(page: Page) {
75  return page.locator('[data-testid^="block-"][data-block-id]');
76}
77 
78/** Create a page under a workspace (BARE `{ id }` body — no wrapper). */
79async function createPage(
80  api: APIRequestContext,
81  wsId: string,
82  title: string,
83): Promise<string> {
84  const res = await api.post(`/api/v1/workspaces/${wsId}/pages`, {
85    data: { title },
86  });
87  expect(res.status(), await res.text()).toBe(201);
88  return ((await res.json()) as { id: string }).id;
89}
90 
91/** Top-level CONTENT blocks (the seeded title block is excluded). */
92async function contentBlocks(
93  api: APIRequestContext,
94  pageId: string,
95): Promise<BlockRow[]> {
96  const res = await api.get(`/api/v1/pages/${pageId}/blocks`);
97  expect(res.status()).toBe(200);
98  const body = (await res.json()) as BlocksResponse;
99  return body.data.filter(
100    (b) => b.parentId === null && !(b.properties as { isTitle?: boolean })?.isTitle,
101  );
102}
103 
104/** Every live block on the page (all parents) — for nested/count asserts. */
105async function allBlocks(api: APIRequestContext, pageId: string): Promise<BlockRow[]> {
106  const res = await api.get(`/api/v1/pages/${pageId}/blocks?depth=all`);
107  expect(res.status()).toBe(200);
108  return ((await res.json()) as BlocksResponse).data;
109}
110 
111/** The server-stored text of a block (`{ text }` / html string / `{}`). */
112function blockText(b: BlockRow): string {
113  const c = b.content as { text?: unknown } | string | null;
114  if (typeof c === "string") return c.replace(/<[^>]*>/g, "");
115  if (c && typeof c === "object" && typeof c.text === "string") return c.text;
116  return "";
117}
118 
119/** Wait for a given number of top-level rows to render. */
120async function expectRowCount(page: Page, n: number) {
121  await expect(rows(page)).toHaveCount(n, { timeout: 5_000 });
122}
123 
124/** Wait until the top-level row count has been unchanged for ~450 ms. Used
125 *  after async insert/delete sequences (slash pick, Enter, TASK-0136 auto-
126 *  delete) so the count/id we read next is stable. Gives up silently at the
127 *  timeout (the caller's own assertions then apply). */
128async function waitStableRows(page: Page, timeout = 8_000) {
129  const start = Date.now();
130  let prev = await rows(page).count();
131  let stable = 0;
132  for (;;) {
133    if (Date.now() - start > timeout) return;
134    await page.waitForTimeout(150);
135    const c = await rows(page).count();
136    stable = c === prev ? stable + 1 : 0;
137    prev = c;
138    if (stable >= 3) return;
139  }
140}
141 
142/**
143 * Press Enter in the focused text block (creates an empty sibling below)
144 * and leave the caret in it. The create→re-render→focus round-trip is async,
145 * and a TASK-0136 auto-delete of an earlier EMPTY sibling can be in flight
146 * (or a stale refetch can briefly resurrect a deleted row), so a fixed
147 * `before+1` count is racy — instead identify the new sibling by its fresh
148 * `data-block-id` (it is the new last row) and settle before clicking.
149 */
150async function enterNewBlock(page: Page) {
151  await waitStableRows(page);
152  const lastIdBefore = await rows(page).last().getAttribute("data-block-id");
153  await page.keyboard.press("Enter");
154  await expect
155    .poll(async () => {
156      const n = await rows(page).count();
157      if (n === 0) return false;
158      return (await rows(page).last().getAttribute("data-block-id")) !== lastIdBefore;
159    }, { timeout: 8_000 })
160    .toBe(true);
161  await waitStableRows(page);
162  await rows(page).last().locator("[contenteditable]").first().click();
163}
164 
165/**
166 * Pick a slash command from a focused EMPTY block and leave the caret in the
167 * created block.
168 *
169 * The slash trigger only fires in a block whose text STARTS with "/" — so
170 * the caller must have an empty, focused block (the one `openFreshPage` or a
171 * prior `enterNewBlock` created). That block (the "anchor") is always the LAST
172 * row; the pick clears it (→ it auto-deletes on blur via TASK-0136) and
173 * inserts the new block AFTER it. Row-count arithmetic is racy here (the count
174 * oscillates `before → before+1 → before` across the insert + anchor delete),
175 * so instead we wait for the new block by its identity: a fresh
176 * `data-block-id` that differs from the anchor's. The anchor stays the last
177 * row until the new one renders, so the last row's id flips exactly once.
178 */
179async function slashCommand(page: Page, itemId: string, focusNew = true) {
180  const anchorId = await rows(page).last().getAttribute("data-block-id");
181  await page.keyboard.type("/");
182  await expect(page.getByTestId("slash-menu")).toBeVisible({ timeout: 5_000 });
183  await page.getByTestId(`slash-menu-item-${itemId}`).click();
184  if (!focusNew) return; // structural blocks (divider, code, columns, …)
185  await expect
186    .poll(async () => {
187      const n = await rows(page).count();
188      if (n === 0) return false;
189      return (await rows(page).last().getAttribute("data-block-id")) !== anchorId;
190    }, { timeout: 8_000 })
191    .toBe(true);
192  await rows(page).last().locator("[contenteditable]").first().click();
193}
194 
195/**
196 * Open a fresh page and leave the caret in a real, focused paragraph:
197 * `new-block` click → the trailing area creates + focuses the first block.
198 * Returns the page id. (A fresh page has no `block-*` rows in the body —
199 * the seeded title is not rendered — so this must NOT click a first block.)
200 */
201async function openFreshPage(
202  authPage: Page,
203  api: APIRequestContext,
204  wsId: string,
205): Promise<string> {
206  const pageId = await createPage(api, wsId, "Editor Test Page");
207  await authPage.goto(`/w/${wsId}/page/${pageId}`);
208  await expect(authPage.getByTestId("editor-root")).toBeVisible({ timeout: 20_000 });
209  // No body blocks yet (title-only page; the title is not rendered in body).
210  expect(await rows(authPage).count()).toBe(0);
211  // Enter the trailing area → creates + focuses the first paragraph.
212  await authPage.locator("#workspace-main").getByTestId("new-block").click();
213  await expectRowCount(authPage, 1);
214  // Settle the caret in the (single) new row's editor.
215  await rows(authPage).first().locator("[contenteditable]").click();
216  return pageId;
217}
218 
219test.describe("Block Editor — Phase 4 (T-194)", () => {
220  test("type a paragraph and it persists", async ({ authPage, api, freshWorkspace }) => {
221    const ws = await freshWorkspace("Editor WS");
222    const pageId = await openFreshPage(authPage, api, ws.id);
223    await authPage.keyboard.type("Hello from the editor");
224    // The block row renders the typed text…
225    await expect(rows(authPage).first()).toContainText("Hello from the editor");
226    // …and it round-trips to the server (1 content block, text intact).
227    await expect
228      .poll(async () => {
229        const blocks = await contentBlocks(api, pageId);
230        return blocks.length === 1 ? blockText(blocks[0]!) : "";
231      }, { timeout: 10_000 })
232      .toBe("Hello from the editor");
233  });
234 
235  test("slash menu: /h1 creates a heading", async ({ authPage, api, freshWorkspace }) => {
236    const ws = await freshWorkspace("Editor WS");
237    const pageId = await openFreshPage(authPage, api, ws.id);
238    await slashCommand(authPage, "h1");
239    await authPage.keyboard.type("A Heading One");
240    // Headings render as a styled contenteditable (NOT an <h1> tag): assert
241    // the change server-side (type HEADING_1) + the text is visible.
242    await expect
243      .poll(async () => {
244        const b = (await contentBlocks(api, pageId)).find((x) => x.type === "HEADING_1");
245        return b ? blockText(b) : "";
246      }, { timeout: 10_000 })
247      .toBe("A Heading One");
248    await expect(authPage.getByText("A Heading One")).toBeVisible();
249  });
250 
251  test("slash menu: /todo creates a checkable checkbox block", async ({
252    authPage,
253    api,
254    freshWorkspace,
255  }) => {
256    const ws = await freshWorkspace("Editor WS");
257    const pageId = await openFreshPage(authPage, api, ws.id);
258    await slashCommand(authPage, "todo");
259    await authPage.keyboard.type("Buy milk");
260    const checkbox = authPage.getByTestId(/todo-checkbox-/).first();
261    await expect(checkbox).toBeVisible({ timeout: 5_000 });
262    // Initially unchecked; checking it persists server-side (props.checked).
263    await expect(checkbox).toHaveAttribute("aria-checked", "false");
264    await checkbox.click();
265    await expect
266      .poll(async () => {
267        const b = (await contentBlocks(api, pageId)).find((x) => x.type === "TODO");
268        return (b?.properties as { checked?: boolean })?.checked ?? false;
269      }, { timeout: 10_000 })
270      .toBe(true);
271    await expect(checkbox).toHaveAttribute("aria-checked", "true");
272  });
273 
274  test("slash menu: /quote /callout /code create their blocks", async ({
275    authPage,
276    api,
277    freshWorkspace,
278  }) => {
279    const ws = await freshWorkspace("Editor WS");
280    const pageId = await openFreshPage(authPage, api, ws.id);
281 
282    // Each command is typed in its own EMPTY block (the slash trigger needs
283    // the text to START with "/"), so Enter opens a fresh sibling between them.
284    await slashCommand(authPage, "quote");
285    await authPage.keyboard.type("A quote");
286    await enterNewBlock(authPage);
287 
288    await slashCommand(authPage, "callout");
289    await authPage.keyboard.type("A callout");
290    await enterNewBlock(authPage);
291 
292    // Code is NOT a contenteditable: it is a <pre> + an Edit/Save overlay, so
293    // the text is entered through the edit textarea, then read back from the
294    // rendered <pre> (the non-edit overlay).
295    await slashCommand(authPage, "code", false);
296    await expect(authPage.getByLabel("Edit code")).toBeVisible({ timeout: 5_000 });
297    await authPage.getByLabel("Edit code").click();
298    await authPage.getByLabel("Code", { exact: true }).fill("const x = 1;");
299    // Commit via Escape (the documented save path; the Save button label
300    // flip is flaky right after a rapid block sequence).
301    await authPage.keyboard.press("Escape");
302    await expect(authPage.getByTestId("code-block-pre")).toContainText("const x = 1;");
303 
304    // All three types persist server-side with their text.
305    await expect
306      .poll(async () => {
307        const blocks = await contentBlocks(api, pageId);
308        const quote = blocks.find((b) => b.type === "QUOTE");
309        const callout = blocks.find((b) => b.type === "CALLOUT");
310        const code = blocks.find((b) => b.type === "CODE");
311        return (
312          !!quote && blockText(quote) === "A quote" &&
313          !!callout && blockText(callout) === "A callout" &&
314          !!code && blockText(code).includes("const x = 1;")
315        );
316      }, { timeout: 10_000 })
317      .toBe(true);
318  });
319 
320  test("slash menu: /divider inserts a divider", async ({
321    authPage,
322    api,
323    freshWorkspace,
324  }) => {
325    const ws = await freshWorkspace("Editor WS");
326    const pageId = await openFreshPage(authPage, api, ws.id);
327    await authPage.keyboard.type("above");
328    await enterNewBlock(authPage); // fresh empty sibling (caret settled)
329    await slashCommand(authPage, "divider", false);
330    // A divider is a non-text block: the <hr> renders.
331    await expect(authPage.locator("hr")).toBeVisible({ timeout: 5_000 });
332    await expect
333      .poll(async () => (await contentBlocks(api, pageId)).some((b) => b.type === "DIVIDER"))
334      .toBe(true);
335  });
336 
337  test("slash menu: /toggle creates a collapsible block with a child", async ({
338    authPage,
339    api,
340    freshWorkspace,
341  }) => {
342    const ws = await freshWorkspace("Editor WS");
343    const pageId = await openFreshPage(authPage, api, ws.id);
344    await slashCommand(authPage, "toggle");
345    await authPage.keyboard.type("Toggle me");
346    // Enter in the toggle TITLE creates a CHILD inside (Notion semantics).
347    await authPage.keyboard.press("Enter");
348    // The toggle is the only top-level row; its child editor is the LAST
349    // contenteditable within it (the title editor comes first).
350    const toggleRow = rows(authPage).last();
351    await expect(toggleRow.locator("[contenteditable]")).toHaveCount(2, { timeout: 5_000 });
352    const child = toggleRow.locator("[contenteditable]").last();
353    await child.click();
354    await authPage.keyboard.type("hidden child");
355    await expect(child).toContainText("hidden child");
356 
357    // The chevron reports expanded; collapse HIDES the child (a controlled
358    // <details> keeps it in the DOM — assert visibility, not presence).
359    const chevron = authPage.getByTestId(/toggle-chevron-/).first();
360    await expect(chevron).toHaveAttribute("aria-expanded", "true");
361    await chevron.click();
362    await expect(chevron).toHaveAttribute("aria-expanded", "false");
363    await expect(child).toBeHidden();
364    await chevron.click();
365    await expect(chevron).toHaveAttribute("aria-expanded", "true");
366    await expect(child).toBeVisible();
367 
368    // Server: the toggle has exactly one child paragraph.
369    await expect
370      .poll(async () => {
371        const all = await allBlocks(api, pageId);
372        const toggle = all.find((b) => b.type === "TOGGLE");
373        return all.filter((b) => b.parentId === toggle?.id).length;
374      }, { timeout: 10_000 })
375      .toBe(1);
376  });
377 
378  test("slash menu: /columns creates an editable 2-column grid", async ({
379    authPage,
380    api,
381    freshWorkspace,
382  }) => {
383    const ws = await freshWorkspace("Editor WS");
384    const pageId = await openFreshPage(authPage, api, ws.id);
385    await slashCommand(authPage, "columns", false);
386    // The container + the two server-seeded column cells appear (async child
387    // load — poll). `^column-\d` excludes the `column-list` container itself.
388    await expect(authPage.getByTestId("column-list")).toBeVisible({ timeout: 10_000 });
389    await expect
390      .poll(async () => authPage.getByTestId(/^column-\d/).count(), { timeout: 10_000 })
391      .toBe(2);
392    // The first column holds an editable paragraph — type into it.
393    await authPage.locator('[data-testid="column-1"] [contenteditable]').first().click();
394    await authPage.keyboard.type("left column");
395    await expect(authPage.getByTestId("column-list")).toContainText("left column");
396    // Server: column_list + two column children (a grid, not a dead end).
397    await expect
398      .poll(async () => (await allBlocks(api, pageId)).filter((b) => b.type === "COLUMN").length, {
399        timeout: 10_000,
400      })
401      .toBe(2);
402  });
403 
404  test("context menu: delete a block", async ({ authPage, api, freshWorkspace }) => {
405    const ws = await freshWorkspace("Editor WS");
406    const pageId = await openFreshPage(authPage, api, ws.id);
407    // Two content blocks.
408    await authPage.keyboard.type("keep me");
409    await enterNewBlock(authPage);
410    await authPage.keyboard.type("remove me");
411    await expectRowCount(authPage, 2);
412    // Right-click the second block → Delete. (The app deletes a SELECTION via
413    // the menu — there is no block-level Backspace/undo keyboard path.)
414    await rows(authPage).nth(1).click({ button: "right" });
415    const menu = authPage.getByTestId("block-context-menu");
416    await expect(menu).toBeVisible({ timeout: 5_000 });
417    await menu.getByTestId("context-menu-delete").click();
418    // The row is gone; the surviving block + its text remain.
419    await expectRowCount(authPage, 1);
420    await expect(rows(authPage).first()).toContainText("keep me");
421    await expect
422      .poll(async () => (await contentBlocks(api, pageId)).map(blockText), { timeout: 10_000 })
423      .toEqual(["keep me"]);
424  });
425 
426  test("slash menu search filters commands", async ({
427    authPage,
428    api,
429    freshWorkspace,
430  }) => {
431    const ws = await freshWorkspace("Editor WS");
432    await openFreshPage(authPage, api, ws.id);
433    await authPage.keyboard.type("/");
434    const menu = authPage.getByTestId("slash-menu");
435    await expect(menu).toBeVisible({ timeout: 5_000 });
436    // Filter to a single match; unrelated commands drop out.
437    await authPage.keyboard.type("div");
438    await expect(menu.getByTestId("slash-menu-item-divider")).toBeVisible({ timeout: 5_000 });
439    await expect(menu.getByTestId("slash-menu-item-todo")).toHaveCount(0);
440  });
441 
442  test("context menu: turn into heading 1", async ({
443    authPage,
444    api,
445    freshWorkspace,
446  }) => {
447    const ws = await freshWorkspace("Editor WS");
448    const pageId = await openFreshPage(authPage, api, ws.id);
449    await authPage.keyboard.type("Turn me");
450    await rows(authPage).first().click({ button: "right" });
451    const menu = authPage.getByTestId("block-context-menu");
452    await expect(menu).toBeVisible({ timeout: 5_000 });
453    // Open the "Turn into…" submenu, then pick Heading 1.
454    await menu.getByTestId("context-menu-turn-into").click();
455    await authPage.getByTestId("context-menu-turn-heading_1").click();
456    // The conversion is server-persisted (type HEADING_1); text survives.
457    await expect
458      .poll(async () => {
459        const b = (await contentBlocks(api, pageId))[0];
460        return b && b.type === "HEADING_1" ? blockText(b) : "";
461      }, { timeout: 10_000 })
462      .toBe("Turn me");
463    await expect(authPage.getByText("Turn me")).toBeVisible();
464  });
465 
466  test("copy / paste a paragraph (plain-text native paste)", async ({
467    authPage,
468    api,
469    freshWorkspace,
470  }) => {
471    const ws = await freshWorkspace("Editor WS");
472    const pageId = await openFreshPage(authPage, api, ws.id);
473    await authPage.keyboard.type("Copyable line");
474    await enterNewBlock(authPage); // empty sibling, caret settled
475    // Synthetic plain-text paste on the FOCUSED editor: ProseMirror's native
476    // paste handler inserts at the caret (the window handler only hijacks
477    // structural/HTML + the app's internal payload — plain text passes
478    // through). Dispatching on the contenteditable (not the window) is what
479    // lets the editor's own handler see it; real Ctrl+C/V would need clipboard
480    // permissions the fixture contexts don't grant.
481    await authPage.evaluate(() => {
482      const dt = new DataTransfer();
483      dt.setData("text/plain", "Copyable line");
484      const evt = new ClipboardEvent("paste", {
485        clipboardData: dt,
486        bubbles: true,
487        cancelable: true,
488      });
489      (document.activeElement as HTMLElement).dispatchEvent(evt);
490    });
491    // Two blocks, both carrying the text.
492    await expectRowCount(authPage, 2);
493    await expect
494      .poll(async () => {
495        const blocks = await contentBlocks(api, pageId);
496        return blocks.length === 2 && blocks.every((b) => blockText(b) === "Copyable line");
497      }, { timeout: 10_000 })
498      .toBe(true);
499  });
500 
501  test("empty-block cleanup on blur", async ({ authPage, api, freshWorkspace }) => {
502    const ws = await freshWorkspace("Editor WS");
503    const pageId = await openFreshPage(authPage, api, ws.id);
504    // Type a block, Enter (creates an EMPTY sibling, caret in it), then
505    // click back into the first block: the empty sibling loses focus while
506    // still empty → it is auto-deleted (TASK-0136), page back to one block.
507    await authPage.keyboard.type("first line");
508    await enterNewBlock(authPage);
509    await expectRowCount(authPage, 2);
510    // Click into the first (non-empty) block → the empty one blurs + cleans.
511    await rows(authPage).first().locator("[contenteditable]").click();
512    await expect
513      .poll(async () => (await contentBlocks(api, pageId)).length, { timeout: 10_000 })
514      .toBe(1);
515    await expectRowCount(authPage, 1);
516  });
517 
518  test("reload preserves blocks (ordering + count survive)", async ({
519    authPage,
520    api,
521    freshWorkspace,
522  }) => {
523    const ws = await freshWorkspace("Editor WS");
524    const pageId = await openFreshPage(authPage, api, ws.id);
525    await authPage.keyboard.type("persist A");
526    await enterNewBlock(authPage);
527    await authPage.keyboard.type("persist B");
528    await expectRowCount(authPage, 2);
529    // Settle: block content is debounced into a ~500 ms batch flush and a
530    // hard reload won't run the unmount flush — so wait until BOTH blocks are
531    // server-persisted before reloading, or the second (unflushed) block
532    // would be lost.
533    await expect
534      .poll(async () => (await contentBlocks(api, pageId)).map(blockText), { timeout: 10_000 })
535      .toEqual(["persist A", "persist B"]);
536 
537    await authPage.reload();
538    await expect(authPage.getByTestId("editor-root")).toBeVisible({ timeout: 20_000 });
539 
540    // Both blocks render, in order (read the contenteditable's own text —
541    // the row also carries gutter/handle markup). Tiptap re-hydrates the
542    // editors after the query resolves, so poll until BOTH texts are present
543    // (a naive read can catch a row before its editor content mounts).
544    const blockRows = rows(authPage);
545    await expect(blockRows).toHaveCount(2, { timeout: 10_000 });
546    await expect
547      .poll(async () =>
548        Promise.all(
549          [0, 1].map(
550            async (i) =>
551              ((await blockRows.nth(i).locator("[contenteditable]").first().textContent()) ?? "").trim(),
552          ),
553        ),
554      { timeout: 10_000 })
555      .toEqual(["persist A", "persist B"]);
556 
557    // The server carries both content blocks in order (the title block is
558    // excluded — it is not body content).
559    expect((await contentBlocks(api, pageId)).map(blockText)).toEqual([
560      "persist A",
561      "persist B",
562    ]);
563  });
564});
565