ubiquitous-invention/plans/Plan-daily-driver-finish/Epic-shipping-the-shell/Task-smoke-test-collab-editor.md

kind	slug	title	plan_slug	epic_slug	status	priority	tenant_id	owner	cursor_todo_id	updated_at
task	smoke-test-collab-editor	Smoke-test TipTap + Yjs + Hocuspocus across two browsers on deployed stack	daily-driver-finish	shipping-the-shell	ready	P1	global	unassigned	null	2026-06-01

Task summary

The TipTap + Yjs + Hocuspocus stack works in dev. Before declaring Echodo daily-usable, verify two browsers on the deployed collab service can edit the same document without drift, disconnect, or auth issues.

Description

This is a verification task, not a feature task. It has two parts: build a checklist, run the checklist, document the result.

Pre-flight

• Deploy must be up. CT 102 (Postgres/Redis), CT 107 (Coolify web), collab service running and reachable.
• A test workspace must exist with at least one document object.
• Two browsers with different sign-ins (use credentials provider for both — fastest path).

Checklist

1. Browser A opens the document. Verify cursor appears and TipTap loads.
2. Browser B opens the same document. Verify B sees A's content.
3. A types a paragraph. B should see it within ~200ms.
4. B types in a different paragraph simultaneously. Both should converge without lost characters.
5. A goes offline (devtools network → offline), types, comes back online. Yjs should reconcile A's offline edits.
6. Kill the Hocuspocus process; clients should reconnect when it comes back (verify in apps/collab-server/src/index.ts logs).
7. Close both browsers. Reopen. Verify content persisted in Postgres (Hocuspocus database extension).

Output

Write the result up as a comment block in apps/collab-server/README.md (create if missing) — a one-screen "verified on $DATE against $COMMIT_SHA, here's what works" note. Future operators need to know whether this stack is trusted or risky.

If you find a regression

Don't fix it in this task. File a follow-up task in the same epic and flag the issue clearly. This task is verification; fixes are scoped separately so the verification has a clean before/after.

Subtasks

• Verify deploy is live on CT 107 with collab server reachable.
• Run the 7-step checklist above.
• Write the result block in apps/collab-server/README.md.
• File any regression follow-ups as new tasks under this epic.

Agent-side prep (already done)

The pieces an agent can verify without a live deploy + two browsers were checked as Path A landed:

• pnpm lint && pnpm type-check is green across all 6 packages, including @tasks/collab-server. apps/collab-server/tsconfig.json was cleaned up in commit 1c9deea (removed vestigial rootDir/declaration/outDir/etc.).
• The auth changes that landed in commit 875b1cf (Authentik SSO, case-insensitive emails, first-signin workspace provisioning) and subsequent Path-A commits do not touch the Hocuspocus auth path in apps/collab-server/src/index.ts. The session model the collab server reads from is unchanged.
• Workspace home, AI chat, and landing-route changes are all confined to apps/web and don't import or affect anything under apps/collab-server.

So the static health is fine. What's left is the live multi-browser test against the deployed stack, which has to be driven by an operator with the homelab credentials and two browser sessions in hand.

Owner or assignee

Unassigned

Status

ready

Estimation

S

Acceptance criteria

• All 7 checklist items pass, or any failures are filed as separate tasks.
• Result block exists in apps/collab-server/README.md with date and commit SHA.

Links to related Epic / Plan

• Epic: ./Epic-shipping-the-shell.md
• Plan: ../Plan-daily-driver-finish.md