.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
ai-panel.tsxapps/web/src/components/ai/ai-panel.tsxraw← ai22,395 B← Back to the app
1"use client";
2 
3/**
4 * TASK-0122 — Ask AI panel.
5 *
6 * A right-side drawer (desktop) / bottom sheet (mobile < 768 px) mounted at
7 * the workspace shell, so every entry point (page header, block menu,
8 * database header, search page, command palette) can open it with a
9 * resource context. It is a thin view over `useAiStream` (the streaming
10 * conversation hook) + `aiApi`.
11 *
12 * a11y (mirrors search-dialog.tsx): role="dialog" aria-modal, a focus trap
13 * (Tab wraps inside), Escape closes, focus is restored to the trigger on
14 * close, and a live region announces the streaming state to screen readers.
15 *
16 * Pinned e2e contract (tests/e2e/specs/ai.spec.ts — do not rename):
17 *   ai-panel                 the drawer (role=dialog)
18 *   ai-history-item          a conversation row in the history list
19 *   ai-history-new           the "New chat" button
20 *   ai-message-user          a user bubble
21 *   ai-message-assistant     an assistant bubble
22 *   ai-message-live          the in-flight assistant bubble (streaming)
23 *   ai-tool-call             a tool-call card
24 *   ai-error-banner          the error / budget banner
25 *   ai-retry                 the banner's Retry button
26 *   ai-input                 the composer input
27 *   ai-send                  the send button
28 *   ai-stop                  the stop button (visible while streaming)
29 *   ai-close                 the close button
30 */
31import { useCallback, useEffect, useRef, useState } from "react";
32import {
33  AlertTriangle,
34  Loader2,
35  MessageSquarePlus,
36  Pencil,
37  RotateCcw,
38  Sparkles,
39  Square,
40  Trash2,
41  X
42} from "lucide-react";
43import { useWorkspace } from "@/hooks/use-workspace";
44import { useAiStream, type AiBannerError } from "@/hooks/use-ai-stream";
45import { useUiStore } from "@/stores/ui-store";
46import { formatRelativeTime } from "@/lib/utils";
47import type { AiMessage } from "@/lib/ai";
48 
49/* --------------------------------------------------------------- helpers */
50 
51/** Local (file-private) mobile breakpoint — mirrors form-responses-view. */
52function useIsMobile(): boolean {
53  const [match, setMatch] = useState(false);
54  useEffect(() => {
55    const mq = window.matchMedia("(max-width: 767px)");
56    setMatch(mq.matches);
57    const onChange = (e: MediaQueryListEvent) => setMatch(e.matches);
58    mq.addEventListener("change", onChange);
59    return () => mq.removeEventListener("change", onChange);
60  }, []);
61  return match;
62}
63 
64const budgetBanner = (b: AiBannerError): boolean =>
65  b.code === "AI_BUDGET_EXCEEDED" || b.code === "AI_BUDGET_MONTHLY_EXCEEDED";
66 
67/* -------------------------------------------------------------- component */
68 
69export function AiPanel() {
70  const open = useUiStore((s) => s.aiPanelOpen);
71  const context = useUiStore((s) => s.aiPanelContext);
72  const setOpen = useUiStore((s) => s.setAiPanel);
73  const slug = useUiStore((s) => s.searchWorkspaceSlug);
74  const { data: workspace } = useWorkspace(slug);
75 
76  const isMobile = useIsMobile();
77  const ai = useAiStream(workspace?.id ?? null, context);
78 
79  const [draft, setDraft] = useState("");
80  const [historyOpen, setHistoryOpen] = useState(true);
81  /** Inline rename (the row id being edited) + its draft text. */
82  const [renameId, setRenameId] = useState<string | null>(null);
83  const [renameDraft, setRenameDraft] = useState("");
84  /** Delete confirm (spec: "delete with confirm dialog"). */
85  const [deleteId, setDeleteId] = useState<string | null>(null);
86 
87  const panelRef = useRef<HTMLDivElement>(null);
88  const inputRef = useRef<HTMLTextAreaElement>(null);
89  const scrollRef = useRef<HTMLDivElement>(null);
90  const triggerRef = useRef<HTMLElement | null>(null);
91 
92  /* ------------------------------------------------------------ reset */
93  useEffect(() => {
94    if (open) {
95      setDraft("");
96      requestAnimationFrame(() => inputRef.current?.focus());
97    }
98  }, [open]);
99 
100  /* ------------------------------------------------------ focus + keys */
101 
102  const close = useCallback(() => {
103    ai.stop();
104    setOpen(false);
105    requestAnimationFrame(() => {
106      triggerRef.current?.focus();
107      triggerRef.current = null;
108    });
109  }, [ai, setOpen]);
110 
111  useEffect(() => {
112    if (!open) return;
113    const onKey = (e: KeyboardEvent) => {
114      if (e.key === "Escape") {
115        e.stopPropagation();
116        if (deleteId) {
117          setDeleteId(null); // the confirm dialog takes the first Escape
118        } else {
119          close();
120        }
121      }
122    };
123    window.addEventListener("keydown", onKey);
124    return () => window.removeEventListener("keydown", onKey);
125  }, [open, close, deleteId]);
126 
127  // Focus trap (Tab wraps inside the panel).
128  useEffect(() => {
129    if (!open) return;
130    const onKey = (e: KeyboardEvent) => {
131      if (e.key !== "Tab") return;
132      const panel = panelRef.current;
133      if (!panel) return;
134      const focusables = panel.querySelectorAll<HTMLElement>('button, textarea, input, [tabindex]:not([tabindex="-1"])');
135      if (focusables.length === 0) return;
136      const first = focusables[0];
137      const last = focusables[focusables.length - 1];
138      if (!first || !last) return;
139      if (e.shiftKey && document.activeElement === first) {
140        e.preventDefault();
141        last.focus();
142      } else if (!e.shiftKey && document.activeElement === last) {
143        e.preventDefault();
144        first.focus();
145      }
146    };
147    window.addEventListener("keydown", onKey);
148    return () => window.removeEventListener("keydown", onKey);
149  }, [open]);
150 
151  // Record the last focused element (the trigger) so close() can restore it.
152  useEffect(() => {
153    if (!open) return;
154    const prev = document.activeElement as HTMLElement | null;
155    triggerRef.current = prev;
156  }, [open]);
157 
158  // Auto-scroll to the newest message / live bubble.
159  useEffect(() => {
160    const el = scrollRef.current;
161    if (el) el.scrollTop = el.scrollHeight;
162  }, [ai.messages.length, ai.live?.content, ai.pendingUser, open]);
163 
164  /* ----------------------------------------------------------- actions */
165 
166  const doSend = useCallback(() => {
167    const text = draft.trim();
168    if (!text || ai.streaming) return;
169    setDraft("");
170    void ai.send(text);
171  }, [draft, ai]);
172 
173  if (!open) return null;
174 
175  const noWorkspace = !workspace?.id;
176 
177  const renderErrorBanner = () => {
178    if (!ai.banner) return null;
179    const b = ai.banner;
180    const showRetry = b.retryable && !ai.streaming;
181    return (
182      <div
183        data-testid="ai-error-banner"
184        role="alert"
185        className="mx-3 mt-2 flex items-start gap-2 rounded-md border border-amber-300 bg-amber-50 px-3 py-2 text-xs text-amber-900 dark:border-amber-700 dark:bg-amber-950/40 dark:text-amber-200"
186      >
187        <AlertTriangle className="mt-0.5 size-3.5 shrink-0" aria-hidden />
188        <div className="min-w-0 flex-1">
189          <p className="font-medium">
190            {budgetBanner(b) ? "Monthly AI budget reached" : b.code === "RATE_LIMITED" ? "Sending too fast" : "Something went wrong"}
191          </p>
192          <p className="mt-0.5 break-words">{b.message}</p>
193          {budgetBanner(b) ? (
194            <p className="mt-1 text-[11px] opacity-80">
195              Your workspace has hit its monthly token limit. Ask an admin to raise it in Settings → AI.
196            </p>
197          ) : null}
198        </div>
199        {showRetry ? (
200          <button
201            type="button"
202            data-testid="ai-retry"
203            onClick={() => void ai.retry()}
204            className="inline-flex shrink-0 items-center gap-1 rounded border border-amber-400 px-2 py-1 font-medium hover:bg-amber-100 dark:hover:bg-amber-900/40"
205          >
206            <RotateCcw className="size-3" aria-hidden />
207            Retry
208          </button>
209        ) : null}
210      </div>
211    );
212  };
213 
214  const renderMessage = (m: AiMessage, live = false) => {
215    const isUser = m.role === "user";
216    const id = live ? "ai-message-live" : isUser ? "ai-message-user" : "ai-message-assistant";
217    return (
218      <div
219        key={live ? "live" : m.id}
220        data-testid={id}
221        className={isUser ? "flex justify-end" : "flex justify-start"}
222      >
223        <div
224          className={
225            "max-w-[85%] whitespace-pre-wrap break-words rounded-lg px-3 py-2 text-sm " +
226            (isUser
227              ? "bg-primary text-primary-foreground"
228              : "border border-border bg-muted/40 text-foreground")
229          }
230        >
231          {m.content}
232          {live ? <span className="ml-0.5 inline-block h-3 w-1.5 animate-pulse bg-foreground/60 align-middle" aria-hidden /> : null}
233        </div>
234      </div>
235    );
236  };
237 
238  const showComposer = !noWorkspace;
239 
240  return (
241    <div className="fixed inset-0 z-[80] flex justify-end" role="presentation">
242      <div className="absolute inset-0 bg-black/20" aria-hidden onClick={close} />
243      <div
244        ref={panelRef}
245        data-testid="ai-panel"
246        role="dialog"
247        aria-modal="true"
248        aria-label="Ask AI"
249        className={
250          "relative flex flex-col bg-background shadow-2xl " +
251          (isMobile
252            ? "inset-x-0 bottom-0 max-h-[85vh] rounded-t-xl border-t border-border"
253            : "inset-y-0 right-0 w-[420px] border-l border-border")
254        }
255      >
256        {/* Header */}
257        <div className="flex shrink-0 items-center justify-between border-b border-border px-3 py-2.5">
258          <div className="flex min-w-0 items-center gap-2">
259            <Sparkles className="size-4 shrink-0 text-primary" aria-hidden />
260            <h2 className="text-sm font-semibold">Ask AI</h2>
261            {/* Context badge: the bound resource title (page/database). */}
262            {context?.label ? (
263              <span
264                data-testid="ai-context-badge"
265                className="max-w-[45%] truncate rounded-full border border-border bg-muted/60 px-2 py-0.5 text-[10px] text-muted-foreground"
266                title={context.label}
267              >
268                {context.label}
269              </span>
270            ) : null}
271          </div>
272          <div className="flex items-center gap-1">
273            <button
274              type="button"
275              data-testid="ai-history-new"
276              onClick={ai.startNew}
277              className="inline-flex items-center gap-1 rounded-md px-2 py-1 text-xs text-foreground/80 hover:bg-accent hover:text-foreground"
278              aria-label="Start a new chat"
279            >
280              <MessageSquarePlus className="size-3.5" aria-hidden /> New
281            </button>
282            <button
283              type="button"
284              data-testid="ai-close"
285              onClick={close}
286              className="rounded-md p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground"
287              aria-label="Close Ask AI"
288            >
289              <X className="size-4" aria-hidden />
290            </button>
291          </div>
292        </div>
293 
294        {/* History (collapsed list at the top) */}
295        <div className="shrink-0 border-b border-border">
296          <button
297            type="button"
298            onClick={() => setHistoryOpen((v) => !v)}
299            aria-expanded={historyOpen}
300            className="flex w-full items-center justify-between px-3 py-1.5 text-[11px] uppercase tracking-wide text-muted-foreground hover:bg-accent"
301          >
302            <span>Conversations</span>
303            <span aria-hidden>{historyOpen ? "▾" : "▸"}</span>
304          </button>
305          {historyOpen ? (
306            <div className="max-h-32 overflow-y-auto px-1 pb-1">
307              {ai.conversations.length === 0 ? (
308                <p className="px-2 py-1 text-xs text-muted-foreground">No conversations yet.</p>
309              ) : (
310                <ul>
311                  {ai.conversations.map((c) => (
312                    <li key={c.id} className="group flex items-center gap-1">
313                      {renameId === c.id ? (
314                        <input
315                          data-testid="ai-history-rename"
316                          autoFocus
317                          value={renameDraft}
318                          onChange={(e) => setRenameDraft(e.target.value)}
319                          onBlur={() => {
320                            void ai.renameConversation(c.id, renameDraft);
321                            setRenameId(null);
322                          }}
323                          onKeyDown={(e) => {
324                            if (e.key === "Enter") {
325                              e.preventDefault();
326                              void ai.renameConversation(c.id, renameDraft);
327                              setRenameId(null);
328                            } else if (e.key === "Escape") {
329                              e.stopPropagation();
330                              setRenameId(null);
331                            }
332                          }}
333                          aria-label="Rename conversation"
334                          className="min-w-0 flex-1 rounded-md border border-primary bg-background px-2 py-1 text-xs outline-none"
335                        />
336                      ) : (
337                        <button
338                          type="button"
339                          data-testid="ai-history-item"
340                          onClick={() => void ai.openConversation(c.id)}
341                          onDoubleClick={() => {
342                            setRenameId(c.id);
343                            setRenameDraft(c.title ?? "");
344                          }}
345                          className={
346                            "min-w-0 flex-1 truncate rounded-md px-2 py-1.5 text-left text-xs hover:bg-accent " +
347                            (ai.activeId === c.id ? "bg-accent font-medium" : "text-foreground/90")
348                          }
349                          aria-current={ai.activeId === c.id ? "true" : undefined}
350                        >
351                          {c.title?.trim() ? c.title : "New chat"}
352                          <span className="ml-1 text-[10px] text-muted-foreground">{formatRelativeTime(c.updatedAt)}</span>
353                        </button>
354                      )}
355                      <button
356                        type="button"
357                        onClick={() => {
358                          setRenameId(c.id);
359                          setRenameDraft(c.title ?? "");
360                        }}
361                        className="rounded p-1 text-muted-foreground opacity-0 hover:bg-accent hover:text-foreground group-hover:opacity-100"
362                        aria-label={`Rename conversation ${c.title ?? "new"}`}
363                      >
364                        <Pencil className="size-3" aria-hidden />
365                      </button>
366                      <button
367                        type="button"
368                        data-testid="ai-history-delete"
369                        onClick={() => setDeleteId(c.id)}
370                        className="rounded p-1 text-muted-foreground opacity-0 hover:bg-accent hover:text-foreground group-hover:opacity-100"
371                        aria-label={`Delete conversation ${c.title ?? "new"}`}
372                      >
373                        <Trash2 className="size-3" aria-hidden />
374                      </button>
375                    </li>
376                  ))}
377                </ul>
378              )}
379            </div>
380          ) : null}
381        </div>
382 
383        {/* Messages */}
384        <div ref={scrollRef} className="min-h-0 flex-1 space-y-2 overflow-y-auto p-3">
385          {noWorkspace ? (
386            <p className="text-xs text-muted-foreground" role="status">
387              Open a workspace to ask questions.
388            </p>
389          ) : ai.messagesLoading ? (
390            <p className="flex items-center gap-2 text-xs text-muted-foreground" role="status">
391              <Loader2 className="size-3.5 animate-spin" aria-hidden /> Loading…
392            </p>
393          ) : ai.messages.length === 0 && !ai.live && !ai.pendingUser ? (
394            <div className="mt-10 text-center text-xs text-muted-foreground">
395              <Sparkles className="mx-auto mb-2 size-6" aria-hidden />
396              <p>Ask anything about this workspace.</p>
397              <p className="mt-1">AI answers cite the pages and databases you link.</p>
398            </div>
399          ) : (
400            <>
401              {ai.messages.map((m) => renderMessage(m))}
402              {ai.pendingUser ? renderMessage({ id: ai.pendingUser.id, role: "user", content: ai.pendingUser.content, createdAt: "" }) : null}
403              {ai.live && ai.live.content !== "" ? (
404                renderMessage(
405                  { id: "live", role: "assistant", content: ai.live.content, createdAt: "" },
406                  true
407                )
408              ) : ai.live && ai.live.content === "" && ai.streaming ? (
409                <div data-testid="ai-message-live" className="flex justify-start">
410                  <div className="flex items-center gap-2 rounded-lg border border-border bg-muted/40 px-3 py-2 text-xs text-muted-foreground">
411                    <Loader2 className="size-3.5 animate-spin" aria-hidden /> Thinking…
412                  </div>
413                </div>
414              ) : null}
415              {ai.live && ai.live.toolCalls.length > 0 ? (
416                <div className="space-y-1">
417                  {ai.live.toolCalls.map((t) => (
418                    <div
419                      key={t.id}
420                      data-testid="ai-tool-call"
421                      className="flex items-center gap-2 rounded-md border border-border bg-background px-2 py-1 text-[11px] text-muted-foreground"
422                    >
423                      <Sparkles className="size-3" aria-hidden />
424                      <span className="font-mono">{t.name}</span>
425                      <span className="truncate" aria-hidden>
426                        {JSON.stringify(t.arguments)}
427                      </span>
428                    </div>
429                  ))}
430                </div>
431              ) : null}
432            </>
433          )}
434        </div>
435 
436        {/* Error banner */}
437        {renderErrorBanner()}
438 
439        {/* Delete confirm (spec: "delete with confirm dialog") — a nested
440            dialog inside the panel (shares its focus trap). */}
441        {deleteId ? (
442          <div
443            data-testid="ai-delete-confirm"
444            role="alertdialog"
445            aria-label="Delete conversation?"
446            className="absolute inset-0 z-10 flex items-center justify-center bg-black/30 p-6"
447          >
448            <div className="w-full max-w-xs rounded-lg border border-border bg-background p-4 shadow-xl">
449              <p className="text-sm font-medium">Delete this conversation?</p>
450              <p className="mt-1 text-xs text-muted-foreground">
451                The messages will be soft-deleted (purged after 30 days). This cannot be undone from the UI.
452              </p>
453              <div className="mt-3 flex justify-end gap-2">
454                <button
455                  type="button"
456                  onClick={() => setDeleteId(null)}
457                  className="rounded-md border border-border px-3 py-1.5 text-xs hover:bg-accent"
458                >
459                  Cancel
460                </button>
461                <button
462                  type="button"
463                  data-testid="ai-delete-confirm-yes"
464                  autoFocus
465                  onClick={() => {
466                    const id = deleteId;
467                    setDeleteId(null);
468                    void ai.removeConversation(id);
469                  }}
470                  className="rounded-md bg-destructive px-3 py-1.5 text-xs font-medium text-destructive-foreground hover:opacity-90"
471                >
472                  Delete
473                </button>
474              </div>
475            </div>
476          </div>
477        ) : null}
478 
479        {/* Screen-reader streaming state */}
480        <div className="sr-only" role="status" aria-live="polite">
481          {ai.streaming ? "AI is replying" : ai.banner ? "Error: " + ai.banner.message : ""}
482        </div>
483 
484        {/* Composer */}
485        {showComposer ? (
486          <div className="shrink-0 border-t border-border p-2.5">
487            {context && (context.pageId || context.databaseId) ? (
488              <p className="mb-1.5 truncate px-1 text-[10px] text-muted-foreground" data-testid="ai-context-note">
489                <Sparkles className="mr-0.5 inline size-2.5" aria-hidden />
490                {context.databaseId ? "Answering about this database" : "Answering about this page"}
491                {context.label ? ` — ${context.label}` : ""}
492              </p>
493            ) : null}
494            <div className="flex items-end gap-2">
495              <textarea
496                ref={inputRef}
497                data-testid="ai-input"
498                value={draft}
499                onChange={(e) => setDraft(e.target.value)}
500                onKeyDown={(e) => {
501                  if (e.key === "Enter" && !e.shiftKey) {
502                    e.preventDefault();
503                    doSend();
504                  }
505                }}
506                rows={2}
507                placeholder="Ask anything…  (Enter to send, Shift+Enter for a new line)"
508                aria-label="Ask AI message"
509                className="min-h-[52px] w-full resize-none rounded-md border border-border bg-background px-3 py-2 text-sm outline-none placeholder:text-muted-foreground focus:border-primary"
510              />
511              {ai.streaming ? (
512                <button
513                  type="button"
514                  data-testid="ai-stop"
515                  onClick={ai.stop}
516                  className="flex h-10 w-10 shrink-0 items-center justify-center rounded-md bg-primary text-primary-foreground hover:opacity-90"
517                  aria-label="Stop generating"
518                >
519                  <Square className="size-4" aria-hidden />
520                </button>
521              ) : (
522                <button
523                  type="button"
524                  data-testid="ai-send"
525                  onClick={doSend}
526                  disabled={!draft.trim()}
527                  className="flex h-10 w-10 shrink-0 items-center justify-center rounded-md bg-primary text-primary-foreground hover:opacity-90 disabled:opacity-40"
528                  aria-label="Send message"
529                >
530                  <Sparkles className="size-4" aria-hidden />
531                </button>
532              )}
533            </div>
534          </div>
535        ) : null}
536      </div>
537    </div>
538  );
539}
540