.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
topbar.tsxapps/web/src/components/layout/topbar.tsxraw← layout18,838 B← Back to the app
1"use client";
2 
3import { forwardRef, useEffect, useRef, useState } from "react";
4import Link from "next/link";
5import { useParams, useRouter } from "next/navigation";
6import {
7  Bell,
8  ChevronRight,
9  Code2,
10  Command,
11  Eye,
12  History,
13  Menu,
14  MoreHorizontal,
15  Search,
16  Share2,
17  Star
18} from "lucide-react";
19import { useWorkspace } from "@/hooks/use-workspace";
20import { useDuplicatePage, usePage, usePageVersions, useToggleFavorite, usePageWatch, useToggleWatch } from "@/hooks/use-pages";
21import { useNotifications } from "@/hooks/use-notifications";
22import { HistoryPopover } from "@/components/editor/history-popover";
23import { VersionCompareDialog } from "@/components/editor/version-compare-dialog";
24import type { PageVersion } from "@/lib/types";
25import { StatusChip } from "@/components/collaboration/StatusChip";
26import { toast, useUiStore } from "@/stores/ui-store";
27import { cn } from "@/lib/utils";
28import { pageApi, isApiError } from "@/lib/api";
29 
30/** T-180 — trigger a browser download for the page's markdown export.
31 *  Reads the body + filename from the raw response (the server signs the
32 *  filename into Content-Disposition) and uses the house blob/anchor pattern. */
33async function downloadPageMarkdown(pageId: string) {
34  try {
35    const res = await pageApi.exportMarkdown(pageId);
36    const text = await res.text();
37    const cd = res.headers.get("content-disposition") ?? "";
38    const m = /filename="?([^";]+)"?/.exec(cd);
39    const filename = m?.[1] || `${pageId}.md`;
40    const blob = new Blob([text], { type: "text/markdown;charset=utf-8" });
41    const url = URL.createObjectURL(blob);
42    const a = document.createElement("a");
43    a.href = url;
44    a.download = filename;
45    document.body.appendChild(a);
46    a.click();
47    a.remove();
48    URL.revokeObjectURL(url);
49    toast("success", "Exported as Markdown", filename);
50  } catch (e) {
51    toast("error", "Export failed", isApiError(e) ? e.message : e instanceof Error ? e.message : String(e));
52  }
53}
54 
55/**
56 * Top bar: breadcrumb (workspace / … / page), share, favorite (star),
57 * history (version list popover) and a "more" menu.
58 */
59export function Topbar() {
60  const params = useParams<{ workspace: string; id?: string }>();
61  const workspaceSlug = params?.workspace ?? "default";
62  const pageId = params?.id ?? null;
63  const router = useRouter();
64 
65  const { data: workspace } = useWorkspace(workspaceSlug);
66  const { data: page } = usePage(pageId ?? "");
67  const versions = usePageVersions(pageId ?? "");
68  const favorite = useToggleFavorite();
69  // T-138: recursive duplicate (blocks + child pages + database snapshot).
70  const duplicatePage = useDuplicatePage(workspace?.id ?? "");
71  const watchQuery = usePageWatch(pageId ?? "");
72  const toggleWatch = useToggleWatch();
73  const watching = watchQuery.data?.watching ?? false;
74  const { unreadCount, isLoading: notificationsLoading } = useNotifications();
75 
76  const [historyOpen, setHistoryOpen] = useState(false);
77  const [compareVersion, setCompareVersion] = useState<PageVersion | null>(null);
78  const [moreOpen, setMoreOpen] = useState(false);
79  const moreRef = useRef<HTMLDivElement>(null);
80  // a11y (P8): ARIA menu-button pattern — the trigger's node ref (to restore
81  // focus on close) and the menu's node ref (arrow-key navigation + focus).
82  const moreTriggerRef = useRef<HTMLButtonElement>(null);
83  const moreMenuRef = useRef<HTMLDivElement>(null);
84  const toggleSidebar = useUiStore((s) => s.toggleSidebar);
85  const setMobileNav = useUiStore((s) => s.setMobileNav);
86  const setSearchDialog = useUiStore((s) => s.setSearchDialog);
87  const setCommandPalette = useUiStore((s) => s.setCommandPalette);
88  const setMove = useUiStore((s) => s.setMove);
89 
90  // Breakpoint-aware toggle: mobile (<768px) opens the OVERLAY drawer
91  // (docs/product/ux-requirements.md); desktop toggles the in-flow column.
92  const onToggleSidebar = () => {
93    if (typeof window !== "undefined" && window.matchMedia("(min-width: 768px)").matches) {
94      toggleSidebar();
95    } else {
96      setMobileNav(!useUiStore.getState().mobileNavOpen);
97    }
98  };
99 
100  // a11y (P8) — WAI-ARIA menu-button pattern for the "More" menu:
101  //  - while open: move focus to the first item; ArrowUp/Down wrap through
102  //    the items, Home/End jump, Escape closes and returns focus to the
103  //    trigger, and click-outside closes (existing behavior).
104  //  - the trigger carries aria-expanded + aria-haspopup="menu".
105  const closeMoreMenu = (restoreFocus = true) => {
106    setMoreOpen(false);
107    if (restoreFocus) moreTriggerRef.current?.focus();
108  };
109 
110  useEffect(() => {
111    if (!moreOpen) return;
112    const first = moreMenuRef.current?.querySelector<HTMLButtonElement>("[role='menuitem']");
113    first?.focus();
114    const onClick = (e: MouseEvent) => {
115      if (moreRef.current && !moreRef.current.contains(e.target as Node)) setMoreOpen(false);
116    };
117    const onKeyDown = (e: KeyboardEvent) => {
118      if (e.key === "Escape") {
119        e.stopPropagation();
120        closeMoreMenu();
121        return;
122      }
123      if (e.key === "Tab") {
124        // keep the focus trap: Tab inside a menu re-focuses within it
125        e.preventDefault();
126        return;
127      }
128      const items = Array.from(
129        moreMenuRef.current?.querySelectorAll<HTMLButtonElement>("[role='menuitem']") ?? []
130      );
131      const idx = items.indexOf(document.activeElement as HTMLButtonElement);
132      if (e.key === "ArrowDown") {
133        e.preventDefault();
134        items[(idx + 1) % items.length]?.focus();
135      } else if (e.key === "ArrowUp") {
136        e.preventDefault();
137        items[(idx - 1 + items.length) % items.length]?.focus();
138      } else if (e.key === "Home") {
139        e.preventDefault();
140        items[0]?.focus();
141      } else if (e.key === "End") {
142        e.preventDefault();
143        items[items.length - 1]?.focus();
144      }
145    };
146    document.addEventListener("mousedown", onClick);
147    document.addEventListener("keydown", onKeyDown);
148    return () => {
149      document.removeEventListener("mousedown", onClick);
150      document.removeEventListener("keydown", onKeyDown);
151    };
152    // closeMoreMenu is stable-enough (it only calls setState + ref.focus);
153    // re-adding the listener on `moreOpen` changes is what we want.
154    // eslint-disable-next-line react-hooks/exhaustive-deps
155  }, [moreOpen]);
156 
157  const crumbs: { label: string; href?: string }[] = [{ label: workspace?.name ?? workspaceSlug }];
158  if (page) crumbs.push({ label: page.title || "Untitled", href: `/w/${workspaceSlug}/page/${page.id}` });
159 
160  return (
161    <header className="flex h-11 shrink-0 items-center justify-between gap-2 border-b border-border bg-background/80 px-3 backdrop-blur">
162      {/* Sidebar toggle (drawer on mobile, in-flow column on desktop) */}
163      <button
164        type="button"
165        onClick={onToggleSidebar}
166        className="shrink-0 rounded-md p-1.5 text-foreground/70 hover:bg-accent hover:text-foreground"
167        aria-label="Toggle sidebar"
168      >
169        <Menu className="size-4" aria-hidden />
170      </button>
171 
172      {/* Breadcrumb */}
173      <nav aria-label="Breadcrumb" className="flex min-w-0 items-center gap-1 text-sm">
174        {crumbs.map((crumb, i) => (
175          <span key={i} className="flex min-w-0 items-center gap-1">
176            {i > 0 ? <ChevronRight className="size-3.5 shrink-0 text-muted-foreground" aria-hidden /> : null}
177            {crumb.href ? (
178              <Link href={crumb.href} className="truncate hover:text-foreground text-foreground/80">
179                {crumb.label}
180              </Link>
181            ) : (
182              <span className="truncate text-foreground/80">{crumb.label}</span>
183            )}
184          </span>
185        ))}
186      </nav>
187 
188      {/* Actions */}
189      <div className="flex shrink-0 items-center gap-1">
190        {/* Source browser: read-only browse of the full repository (code,
191            task specs, roadmap, changelog). Served at /source/ by a local
192            read-only viewer service — a separate origin-free route, no app
193            state involved. */}
194        <a
195          href="/source/"
196          target="_blank"
197          rel="noopener noreferrer"
198          data-testid="source-link"
199          className="flex h-7 items-center gap-1.5 rounded-md px-2 text-sm text-foreground/80 hover:bg-accent hover:text-foreground"
200          aria-label="Browse source (read-only)"
201        >
202          <Code2 className="size-4" aria-hidden />
203          <span className="hidden sm:inline">Source</span>
204        </a>
205        {/* Connection status chip (TASK-0095 R2): Live / Reconnecting… / Offline. */}
206        <StatusChip />
207        {/* Global search (TASK-0098) — opens the ⌘K dialog; the bare
208            meta/ctrl+k binding lives in workspace-shell.tsx. */}
209        <button
210          type="button"
211          data-testid="search-button"
212          className="flex h-7 items-center gap-1.5 rounded-md px-2 text-sm text-foreground/80 hover:bg-accent hover:text-foreground"
213          aria-label="Search (Command K)"
214          onClick={() => setSearchDialog(true)}
215        >
216          <Search className="size-4" aria-hidden />
217          <span className="hidden md:inline">Search</span>
218          <kbd className="hidden md:inline rounded border border-border bg-background px-1 py-0.5 text-[10px] text-muted-foreground" aria-hidden>
219            ⌘K
220          </kbd>
221        </button>
222        {/* Command palette (TASK-0122): ⌘K was reassigned to the search
223            dialog (TASK-0098), which left the palette with NO trigger —
224            its "Ask AI" action was unreachable. This button restores the
225            only entry point (the palette's own ⌘K-style keyboard nav is
226            internal once open). */}
227        <button
228          type="button"
229          data-testid="command-palette-button"
230          className="flex h-7 items-center gap-1.5 rounded-md px-2 text-sm text-foreground/80 hover:bg-accent hover:text-foreground"
231          aria-label="Command palette"
232          onClick={() => setCommandPalette(true)}
233        >
234          <Command className="size-4" aria-hidden />
235          <span className="hidden md:inline">Commands</span>
236        </button>
237        {/* Notification bell (TASK-0094 R5) — global (works outside a page
238            too). The unread count is the API's authoritative figure, bumped
239            live by the `notification.push` frame (useNotifications). */}
240        <button
241          type="button"
242          data-testid="notification-bell"
243          className="relative flex h-7 items-center gap-1.5 rounded-md px-2 text-sm text-foreground/80 hover:bg-accent hover:text-foreground"
244          aria-label={
245            unreadCount > 0
246              ? `${unreadCount} unread notification${unreadCount === 1 ? "" : "s"}`
247              : "Notifications"
248          }
249          onClick={() => router.push(`/w/${workspaceSlug}/notifications`)}
250        >
251          <Bell className="size-4" aria-hidden />
252          {unreadCount > 0 ? (
253            <span
254              className="inline-flex min-w-4 items-center justify-center rounded-full bg-primary px-1 text-[10px] font-semibold leading-4 text-primary-foreground"
255              aria-hidden
256            >
257              {unreadCount > 99 ? "99+" : unreadCount}
258            </span>
259          ) : null}
260          {notificationsLoading ? (
261            <span className="sr-only">loading notification count</span>
262          ) : null}
263        </button>
264 
265        {page ? (
266          <>
267            <TopbarButton
268              label="Share page"
269              onClick={() => window.open(`/w/${workspaceSlug}/page/${page.id}/share`, "_self")}
270            >
271              <Share2 className="size-4" aria-hidden />
272              <span className="hidden sm:inline">Share</span>
273            </TopbarButton>
274 
275            {/* T-157: watchlist — get notified when this page changes. Mirrors
276                the favorite button (own query + active visual, no toast). */}
277            <TopbarButton
278              data-testid="page-watch-button"
279              label={watching ? "Stop watching this page" : "Watch this page"}
280              onClick={() => void toggleWatch.mutate({ id: page.id, watching })}
281              active={watching}
282              aria-pressed={watching}
283            >
284              <Eye className={cn("size-4", watching && "fill-sky-400 text-sky-500")} aria-hidden />
285            </TopbarButton>
286 
287            <TopbarButton
288              label={page.favorite ? "Remove from favorites" : "Add to favorites"}
289              onClick={() => void favorite.mutate(page.id)}
290              active={page.favorite}
291            >
292              <Star className={cn("size-4", page.favorite && "fill-amber-400 text-amber-500")} aria-hidden />
293            </TopbarButton>
294 
295            <div className="relative">
296              <TopbarButton label="Page history" onClick={() => setHistoryOpen((v) => !v)} active={historyOpen}>
297                <History className="size-4" aria-hidden />
298              </TopbarButton>
299              {historyOpen ? (
300                <HistoryPopover
301                  versions={versions.data ?? []}
302                  isLoading={versions.isLoading}
303                  pageId={page.id}
304                  onClose={() => setHistoryOpen(false)}
305                  onCompare={(v) => {
306                    setHistoryOpen(false);
307                    setCompareVersion(v);
308                  }}
309                  // EDIT gate for "Snapshot now" (same role check as
310                  // page-view's `canGenerate`; VIEW users see the list only).
311                  canEdit={(workspace?.role ?? "").toLowerCase() !== "guest"}
312                />
313              ) : null}
314            </div>
315 
316            <div className="relative" ref={moreRef}>
317              <TopbarButton
318                ref={moreTriggerRef}
319                label="More actions"
320                data-testid="page-more-menu"
321                aria-haspopup="menu"
322                aria-expanded={moreOpen}
323                onClick={() => (moreOpen ? closeMoreMenu(false) : setMoreOpen(true))}
324                active={moreOpen}
325              >
326                <MoreHorizontal className="size-4" aria-hidden />
327              </TopbarButton>
328              {moreOpen ? (
329                <div
330                  ref={moreMenuRef}
331                  className="absolute right-0 z-40 mt-1 w-44 rounded-md border border-border bg-popover p-1 shadow-lg"
332                  role="menu"
333                >
334                  <MenuItem
335                    label="Copy link"
336                    onClick={() => {
337                      void navigator.clipboard.writeText(window.location.href).catch(() => undefined);
338                      setMoreOpen(false);
339                    }}
340                  />
341                  <MenuItem
342                    label="Rename…"
343                    onClick={() => setMoreOpen(false)}
344                    shortcut="—"
345                  />
346                  <MenuItem
347                    label="Move to…"
348                    onClick={() => {
349                      setMoreOpen(false);
350                      if (page && workspace) {
351                        setMove(true, { pageId: page.id, workspaceId: workspace.id, title: page.title || "Untitled" });
352                      }
353                    }}
354                  />
355                  <MenuItem
356                    label="Duplicate"
357                    onClick={() => {
358                      setMoreOpen(false);
359                      if (page) {
360                        // Server defaults the copy's title to "<title> (copy)";
361                        // land on the copy (a fresh read — the page query is
362                        // cached, so no stale title).
363                        void duplicatePage
364                          .mutateAsync({ id: page.id, parentId: page.parentId ?? null })
365                          .then((copy) => {
366                            toast("success", "Page duplicated", copy.title || "Untitled (copy)");
367                            router.push(`/w/${workspaceSlug}/page/${copy.id}`);
368                          })
369                          .catch((e: unknown) =>
370                            toast("error", "Duplicate failed", e instanceof Error ? e.message : String(e))
371                          );
372                      }
373                    }}
374                  />
375                  <MenuItem
376                    label="Export as Markdown…"
377                    onClick={() => {
378                      setMoreOpen(false);
379                      if (page) void downloadPageMarkdown(page.id);
380                    }}
381                  />
382                  {/* Version history (tests/README.md `page-more-history`,
383                      the spec's "⋯ menu → History" path — opens the
384                      HistoryPopover, `page-versions` + `page-version-entry`). */}
385                  <MenuItem
386                    label="History"
387                    testId="page-more-history"
388                    onClick={() => {
389                      setMoreOpen(false);
390                      setHistoryOpen(true);
391                    }}
392                  />
393                  <MenuItem
394                    label="Delete page"
395                    destructive
396                    onClick={() => setMoreOpen(false)}
397                  />
398                </div>
399              ) : null}
400            </div>
401          </>
402        ) : null}
403      </div>
404      {compareVersion && page ? (
405        <VersionCompareDialog
406          pageId={page.id}
407          toVersion={compareVersion}
408          versions={versions.data ?? []}
409          onClose={() => setCompareVersion(null)}
410        />
411      ) : null}
412    </header>
413  );
414}
415 
416const TopbarButton = forwardRef<
417  HTMLButtonElement,
418  React.ButtonHTMLAttributes<HTMLButtonElement> & { label: string; active?: boolean }
419>(({ label, active, children, ...props }, ref) => (
420  <button
421    ref={ref}
422    type="button"
423    title={label}
424    aria-label={label}
425    className={cn(
426      "flex h-7 items-center gap-1.5 rounded-md px-2 text-sm text-foreground/80 hover:bg-accent hover:text-foreground",
427      active && "bg-accent text-foreground"
428    )}
429    {...props}
430  >
431    {children}
432  </button>
433));
434TopbarButton.displayName = "TopbarButton";
435 
436function MenuItem({
437  label,
438  destructive,
439  shortcut,
440  testId,
441  onClick
442}: {
443  label: string;
444  destructive?: boolean;
445  shortcut?: string;
446  testId?: string;
447  onClick: () => void;
448}) {
449  return (
450    <button
451      type="button"
452      role="menuitem"
453      data-testid={testId}
454      onClick={onClick}
455      className={cn(
456        "flex w-full items-center justify-between rounded px-2 py-1.5 text-left text-sm hover:bg-accent",
457        destructive ? "text-red-600" : "text-foreground/90"
458      )}
459    >
460      <span>{label}</span>
461      {shortcut ? <span className="text-xs text-muted-foreground">{shortcut}</span> : null}
462    </button>
463  );
464}
465