31e877d1d0
Path-A task 5/5 is verification-only and requires the deployed homelab stack + two browser sessions — outside an agent session's reach. Documented in the task file what's been verified automatically (lint + type-check, including @tasks/collab-server, all green; no Path-A changes touched the collab server) and what still needs hands-on testing against the deploy. Leaves the task in `ready` status until an operator runs the live 7-step checklist. Co-authored-by: Cursor <cursoragent@cursor.com>
84 lines
3.6 KiB
Markdown
84 lines
3.6 KiB
Markdown
---
|
|
kind: task
|
|
slug: smoke-test-collab-editor
|
|
title: Smoke-test TipTap + Yjs + Hocuspocus across two browsers on deployed stack
|
|
plan_slug: daily-driver-finish
|
|
epic_slug: shipping-the-shell
|
|
status: ready
|
|
priority: P1
|
|
tenant_id: global
|
|
owner: unassigned
|
|
cursor_todo_id: null
|
|
updated_at: "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`
|