` and canonical URL via `generateMetadata`. Browser tabs, history, and link previews all show the workspace name instead of a generic \"Dock\" fallback. Search-engine friendly for the public twin at `/p/*`, and cache-shared with the page's own Prisma lookup via React `cache()` so metadata generation costs zero extra DB round-trips.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`generateMetadata` + `page.tsx` share a single session lookup + single workspace lookup per request via React's `cache()` wrapper. Same goes for the dynamic OG image renderer that ships per-workspace unfurls. Three server-side callers, one round-trip.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mode seeding order clarified: URL `?m=` hint wins, then the workspace's persisted default mode, then table as the last-resort fallback. Doc-first workspaces linked without a mode param now paint the editor directly, no table-flash-then-doc flicker.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` refreshed: C2 moves from \"What's next\" to \"What shipped\". Workspace-detail paint budgets published — warm TTFB < 500ms, FCP < 900ms, LCP < 1500ms — with the staging-smoke tier that enforces them against real Vercel edge + real Neon on every deploy.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New contract-test suite (`tests/e2e/rsc-workspace-shell.spec.ts`) locks the observable shape: workspace name + row data inline in first-byte HTML, zero client-side `/api/workspaces` or `/rows` fetches on first load, canonical-slug redirects are server-side 307s, hydration completes without console errors, `?m=doc` seeds the doc panel without table flicker.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Two new server-side modules wired into the App Router path: `src/lib/auth-server.ts` (session-cookie auth for async server components, request-scoped cached) and `src/lib/workspace-loader.ts` (Prisma-direct loaders with typed errors for not-found / access-denied / canonical redirect, `import \"server-only\"` guard at top so the module cannot leak into a client bundle).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"No REST surface changes. Mutations still go through `/api/workspaces/:slug/*` endpoints — the migration replaced only the initial-load fetch waterfall, not the write path.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Four visibility tiers","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922352315-feature-visibility-tiers-1WeP50TnxeBBR0XpIUkYZbGjzkhv9L.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 25, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Public workspaces, indexable by Google, white-label on Scale.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Flip a workspace to Public or Unlisted and it renders at /p/{org}/{workspace} as a clean read-only page. No sidebar, no editor chrome, proper SEO metadata, and a site-wide sitemap. Pro hides the 'Made with Dock' footer; Scale swaps in your own logo on the top bar + the social-preview OG image.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Anonymous public-view route at `/p/{org}/{workspace}`. When a workspace is set to `public` or `unlisted`, anyone (signed in or not) can open that URL and read the content. Top bar = Dock mark + \"Sign in\" link. Footer = \"Made with Dock · open your own workspace\" with UTM attribution. No sidebar, no Activity panel, no Share button, no edit affordances.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The dashboard URL (`/{org}/{workspace}`) auto-redirects unauthenticated visitors to the public view when visibility allows it. Private / org-only workspaces still bounce to `/login` for non-members — nothing leaks. No change for authenticated members; they keep hitting the dashboard view.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read-only table and doc renderers. Table uses the existing `CellDisplay` so status pills, person avatars, links, checkboxes, dates render identically to the authed view. Doc uses TipTap with `editable: false` and the same extension set — hyperlinks, tables, task lists, code blocks, highlights all preserve formatting. Cursor is gone; text selection + copy still work.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public page branding — white-label settings at Settings → Organization → Public page branding. Pro ($19/mo): toggle off the \"Made with Dock\" footer. Scale ($49/mo): upload a custom logo (SVG / PNG / JPEG / WebP, 2 MB cap) that replaces the Dock mark on the top bar AND on the social-preview OG image, plus a website URL where the logo clicks through to.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/orgs/[slug]/branding` — returns `{ logoUrl, websiteUrl, hideDockBadge, effectivePlan, canHideBadge, canCustomBrand }` so the Settings UI can render the right controls per plan without a second /billing round-trip.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/orgs/[slug]/branding` — body `{ hideDockBadge?: boolean, websiteUrl?: string | null }`. Admin/owner only. Plan-gated with 402 Payment Required when the caller's plan can't unlock a field (e.g. Free trying to hide the badge returns `{ requires: \"pro\" }`).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/orgs/[slug]/logo` — multipart upload (2 MB cap), Scale-only. Persists to Vercel Blob at `org-logos/{orgId}/...`, writes the public URL to `Org.logoUrl`. Scoped to admins.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`DELETE /api/orgs/[slug]/logo` — clears the org's custom logo pointer. Blob stays (non-destructive) so a later upload + upgrade cycle doesn't lose your file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Three new columns on `orgs`: `logo_url`, `website_url`, `hide_dock_badge` (migration `20260502_org_public_branding`). All nullable / default-false; existing rows are untouched.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/guides/sharing` gets two new sections: \"Public pages: the anonymous reader view\" (covers the `/p/*` URL, what's hidden vs shown, SEO indexing behavior) and \"White-labeling (Pro + Scale)\" (the three controls + downgrade semantics).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/sitemap.xml` now dynamically enumerates every `public` workspace, capped at 50k URLs, revalidated every 5 minutes. Unlisted workspaces stay out of the sitemap AND ship `noindex,nofollow` — belt + suspenders so crawlers that find the URL anyway won't index.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Per-page SEO: `<title>`, `<meta description>` (first 200 chars of the doc body, stripped of markdown), `<link rel=canonical>` pointing at `/p/*`, and JSON-LD structured data (schema.org `Article` for doc-mode, `Dataset` for table-mode). Social unfurls continue to use the existing per-workspace OG renderer, which now stamps the custom logo for Scale-branded public pages.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"MCP server","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921725236-feature-mcp-server-F8y9OCFQw18hzN7hUzOMTH0HQ97HTD.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 24, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents can search the workspace now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"The keyword-search engine that powers ⌘K is now a first-class MCP tool. Agents connected via Claude Code, Cursor, Codex, etc. can call `search` with a query string and get ranked hits across workspace names, row cells, and doc sections, with a navigable URL per hit. Faster path than `list_workspaces` + iterate when the user names something.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`search` MCP tool — keyword match across workspaces, rows, and doc sections. Optional `kind` narrows to one surface (`workspace` / `row` / `doc-section`); default is `all`. Access-gated through the same `listAccessibleWorkspaceIds` check the REST endpoint uses, so hits from workspaces the caller can't open never surface. Shares the 120/min rate-limit bucket with `GET /api/search`.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dock's MCP surface is now **20 tools**. Full list updates ship in `/.well-known/mcp/server-card.json`, `/docs/mcp`, and `/llms-full.txt` automatically since all three read from the canonical `MCP_TOOLS` array. Agent clients hitting `tools/list` will see the new entry with no extra work.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Not yet embeddings — current implementation is case-insensitive substring match with hand-tuned scoring (1.0 exact workspace name → 0.5 row cell substring). pgvector upgrade is still phase-2 per the existing `lib/search.ts` docstring; the `SearchHit` shape is designed to swap scoring without changing the contract.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Virtualized tables, full memoization, and a plan for the cold-load fix.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Phase 3 of the dashboard perf effort. Row virtualization keeps scroll at 60fps regardless of workspace size. Every workspace-page handler is now memoized, so multiplayer sessions stop dragging the page. And the cold-first-visit fix (RSC + streaming) now has a scoped multi-phase plan so the next contributor can execute against a real spec.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"C1 — row list virtualization via `@tanstack/react-virtual`. Threshold-gated at 100 rows so sub-100 workspaces see zero behavior change. Above 100, only visible rows plus a 10-row overscan stay mounted; 60fps scroll regardless of total size. Every interaction — selection, drag-fill, clipboard, flash, keyboard nav, row-reorder DnD — preserved and tested. `tests/e2e/table-virtualization.spec.ts` locks the contract.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"C3 — full memoization audit. All 11 workspace-page handlers now wrap in `useCallback` with ref-backed state reads. SSE events that don't touch visible data skip re-rendering entirely. Collab typing stays smooth even with multiple agents + humans writing at once. Render-count regression tests keep the pattern from rotting.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/architecture/rsc-migration-plan` — full multi-phase scoping doc for C2, the last big cold-load perf lever. Next contributor (agent or human) can execute against the plan without re-deriving the decisions.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New dev dependency `@tanstack/react-virtual` — the only dep from this PR. Ships in the dashboard bundle, tree-shakes cleanly on non-workspace routes.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` updated: C1 + C3 moved from \"What's next\" to \"What else shipped\" with links to their test coverage. C2 pointer updated to the new architecture plan. \"Massive row counts\" caveat replaced with the narrower \"very long rows\" reality post-virtualization.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"status.trydock.ai tells the truth now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Per-capability probes so the status page flips red on any upstream failure — not just when the web layer dies. Workspaces & documents, Sign-in emails, Billing & upgrades, File uploads, and Live collaboration each have their own traffic light.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/db` — Neon reachability (`SELECT 1`, 2.5s timeout). PSP label: **Workspaces & documents**. Flips red the moment the database is unreachable, including Neon free-plan quota exhaustion.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/stripe` — Stripe reachability (`balance.retrieve`). PSP label: **Billing & upgrades**.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/email` — Resend reachability (`domains.list`). PSP label: **Sign-in emails**.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/blob` — Vercel Blob reachability. PSP label: **File uploads**.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All probes return sanitized error categories in the body (`timeout`, `auth`, `network`, `rate_limit`, `not_configured`, `unknown`) so nothing leaks through to the public URL. Response times shipped in `durationMs` so PSP can start graphing latency alongside uptime.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Status page component labels follow the Notion / Linear / GitHub convention: user-facing capability names, not vendor names. Users see what they can't do, not which SaaS is having a bad day.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Existing `/api/health` stays as-is — it's the deploy-verification liveness probe (DB-independent by design). Renamed in internal docs to make that scope explicit so no one points a product-health monitor at it again.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Closes the gap that hid the 2026-04-23 prod outage: Neon's Free-plan network-transfer cap was exceeded, every DB-backed route 500ed for 15 minutes, and the old `/api/health`-only monitor kept showing 100% uptime throughout. Won't happen again.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"The speed promise, documented and enforced.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Phase 2 of the dashboard perf effort: a public /docs/performance page pins the budgets we hold ourselves to, the workspace-page handlers get memoized so SSE events stop re-rendering the whole tree, and Vitest + Playwright gates block any PR that breaks the numbers we've published.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` — the full Dock speed promise, published. Budgets (FCP, LCP, CLS, long-task count), architecture split (website SSR vs dashboard SPA), what shipped, what's deferred, and what we're honest about not promising. Linked from the docs sidebar.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Render-count regression tests (Vitest) lock in the memoization pattern. If a future change breaks the `React.memo` bail on `TableView` or `DocView`, the unit tier goes red before the perf regression ships.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Paint-budget assertions in three places: `Playwright (nfr)` per PR, `Staging Smoke tier 1.5` after every staging deploy, `Prod Smoke` after every prod deploy. Warm-cache FCP <1400ms, LCP <2200ms. A breach blocks the staging→main promote or triggers Prod Rollback.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`TableView` and `DocView` now wrap in `React.memo`. When unrelated parent state changes (activity feed, presence, flash timers, transient toasts), the 2000-line sheet tree and the 500-line TipTap tree skip re-rendering entirely. Hot handlers (`handleAddRow`, `handleUpdateRow`, `handleDeleteRow`, `handleReorderRows`) are now `useCallback`-wrapped with ref-backed state so their references stay stable across row updates.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multiplayer typing feels the same whether 1 person is writing or 5 people + 2 agents are writing simultaneously. The page doesn't drag under live event load anymore.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vitest lands as the unit-test tier. New `npm run test:unit` + `npm run test:unit:watch` scripts. `npm run check` now runs the unit tier alongside typecheck + build + API tests. Wired into `TypeScript + lint` CI job so every PR runs it sub-second.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` is the canonical reference. Links from docs sidebar; referenced by every new perf-related CI test so failures trace back to the published contract.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Flat pricing","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922353263-feature-plans-ST6WgYJk1voE0KrTgeeGfKHntYNFd0.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 24, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Belong to more than one team? Switch in one click.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"You can be a member of many orgs on Dock — invite from a second team lands without forcing you out of your first. A new switcher at the top of the sidebar shows every org you belong to, and a view-mode setting lets you either see every workspace across every org in one rail (Combined) or focus down to just the active one (Focused). Accepting a new invite asks which way you want it.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Org switcher at the top of the sidebar. Renders as a colored initial disc + the active org's name + chevron; click opens a dropdown that lists every org you belong to with a check on the active one. Auto-hides for single-org users — no extra rail real estate when there's nothing to pick between. Switching writes `User.activeOrgId` via `PATCH /api/me/active-org`; passing `null` resets to your default org.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View-mode preference, set in Settings → Profile → Multi-org view. `Combined` (default) lists every workspace you can touch across all your orgs, with a \"via <slug>\" chip on foreign rows. `Focused` narrows the sidebar + `/workspaces` to your active org only; other orgs surface via the switcher. Persisted via `PATCH /api/me/view-mode`. Agents are single-org by construction and never see the toggle.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Invite-accept fork on `/join/[token]`. When the invitee already belongs to one or more other orgs, the page offers two buttons: \"Make this my active org\" flips `activeOrgId` in the same transaction as the `OrgMember` create, and \"Just add it, keep my current view\" leaves the active org untouched. First-time joiners and existing members skip the fork and see the original single-button flow.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces` targets your active org (fallback to default) instead of always landing in your home org. Creating a workspace from the sidebar after switching now puts it where the rail is pointed — with a stale-active-org guard that falls back to default if your membership was revoked between renders.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/me` gains `activeOrg`, `orgs[]` (every membership with `role`, `isDefault`, `isActive`), and `viewMode`. `activeOrg` falls back to `defaultOrg` when no preference is set, so callers can render the header without a null check. Agents get the same shape with `viewMode: \"focused\"` and a single-entry `orgs` array.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/me/active-org` — body `{ orgSlug: string | null }`. 403 if the caller isn't an `OrgMember` of the named slug; `null` resets to default. Users only — agents are single-org and get 403 here.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/me/view-mode` — body `{ viewMode: \"combined\" | \"focused\" }`. Users only.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/org-invites/[token]` accepts an optional `{ makeActive?: boolean }`. When `true`, the server sets `User.activeOrgId = invite.orgId` in the same transaction as the `OrgMember` create. Response now includes `madeActive: boolean` + `otherOrgCount: number` so the join UI can pick the right post-accept redirect.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces` honors `User.viewMode`. In Focused, the list is filtered at the DB layer to the active org only; no change in Combined mode.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The switcher's dropdown renders via a portal so it escapes the sidebar's scroll container and sits cleanly over the workspace canvas — no clip on collapsed-rail mode. Each org row shows a colored initial disc (stable hash by slug so two similarly-named orgs read as distinct) and a role badge (owner · admin · member · home).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Switching orgs refetches `/api/me` + `/api/workspaces` in parallel so the rail + foreign-workspace chips reconcile within one round-trip. No full route change, no scroll reset.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"MCP server","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921725236-feature-mcp-server-F8y9OCFQw18hzN7hUzOMTH0HQ97HTD.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"MCP v2. Agents can finally read, write, and retire docs.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Six new MCP tools close the biggest gaps on the agent side. Doc surface is first-class now — agents can read a brief, write a summary, and move on without leaving MCP. Row + workspace ergonomics caught up too: single-row fetch, schema inspection, member listing, and soft-delete, all matching the REST shapes so behavior is identical whether the call comes from the dashboard or an agent.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`get_doc(slug)` reads a workspace's TipTap doc body. Returns both the structured JSON (round-trip into `update_doc` to preserve formatting) and a plain-text extraction (lossy but easier for summarisation). Every workspace has a doc surface regardless of default-view mode, so this works everywhere.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`update_doc(slug, content)` replaces the doc body. Last-write-wins, no CRDT merge (Phase 4) — round-trip from `get_doc`, mutate, then write. Editor role gated. Emits `doc.updated` + `doc.heading_added` + `doc.mention_added` events identical to the dashboard editor's, so webhooks and the activity feed stay in lock-step whether the write came from an agent or a human.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`get_row(slug, rowId)` fetches one row by id. For agents that get a row id in a cue payload and shouldn't have to pull the whole table to look at it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`get_workspace_schema(slug)` returns the column definitions — key, label, type, position, and options for status/owner columns — so agents know exactly what keys `create_row` and `update_row` will accept before they try. Empty array on doc-first workspaces (columns auto-seed on first row).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`list_workspace_members(slug)` returns principals with access: users (id, name, email only when caller is in the same org) and agents (id, name, brandKey) plus each one's role. Lets an agent verify a workspace is actually shared before writing output.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`delete_workspace(slug)` soft-archives. Mirrors REST `DELETE /api/workspaces/:slug` exactly — rows, doc, activity preserved; restore from Settings · Archived; idempotent re-call returns the existing `archivedAt` without side effects. Editor role required.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MCP tool count: 13 → 19. See `/docs/mcp` for the full reference.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DocBody write path is now a shared helper (`src/lib/doc-write.ts`). REST `PUT /api/workspaces/:slug/doc` and MCP `update_doc` call the exact same diff + upsert + event-emit sequence, so drift between the two entry points is impossible.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New \"How attribution works\" section in `/docs/mcp` — three-row table mapping auth path (agent API key, OAuth bearer, session cookie) to how the resulting principal is stamped, plus a note on verifying with `get_recent_events`. Closes out a recurring confusion from agents that write via API key and then expect to see themselves in the activity feed (they already do, and always have).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent primer (`/docs/agent-prompt`) updated with new tool sections for Docs, refined Workspaces + Rows groups, and the new count.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Rename your org. Old URLs keep working. Forever.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Renaming your org no longer breaks the URLs you already shared. Every retired slug gets a permanent redirect to its owner, and no one else can ever claim it — so your brand never gets squatted, and every Slack message, bookmark, or doc link that points at your old handle still resolves. Three renames per rolling 90 days keeps the blast radius sane.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename persists via `PATCH /api/me/org` with the new `slug`. The outgoing slug lands in a new `OrgSlugAlias` table that owns the alias primary-key, so every `/acme/*` URL resolves to the renamed org forever with no expiry. `WorkspaceSlugAlias` writes stay — they handle the per-workspace paths as before.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Squat protection is structural. Signup's `uniqueSlug` isTaken union-probes `orgs ∪ org_slug_aliases ∪ RESERVED_ORG_SLUGS`, and the rename pre-check does the same. An aliased slug is as unavailable as a live one. Cascade-on-org-delete means aliases free up only if the org itself is hard-deleted, which we don't do today.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Original owner can reclaim. If an alias row's `orgId` matches the caller's org, the rename goes through: the inbound alias row is deleted, the outgoing slug is upserted into its place, and the rename-back completes in a single transaction.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/orgs/slug-availability?slug=<x>` — debounced live probe for the Settings rename input. Returns one of `available: true` or a typed reason: `taken_by_org` / `aliased` / `reserved` / `reclaimable_by_you` / `rate_limited` / `same_as_current` / `invalid`. Resolution order matches the PATCH endpoint exactly, so the UI never shows \"Available\" then 409s at save-time.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rolling rate limit: 3 renames per 90 days. The 4th `PATCH /api/me/org` returns 429 with `retryAfter` seconds until the oldest alias ages out of the window. The alias table is the audit source — no separate counter column, no drift risk.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Slug character bounds tightened from 3–60 to 3–32. Matches the per-peer convention (GitHub / Linear / Vercel org handles), fits cleanly in share cards and OG images, and leaves headroom for the `<slug>.trydock.ai` subdomain story. Existing slugs 33–60 chars are grandfathered — only new renames are bounded.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`slugs.ts::slugify()` truncation follows the new cap. `SLUG_MIN_LENGTH` and `SLUG_MAX_LENGTH` are now exported so client-side `maxLength` attributes and error copy read from the same source as server validation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Error copy for the rename form's \"unavailable\" state reads \"That slug isn't available. Try another.\" — we explicitly do NOT reveal whether the unavailability is live-org vs. retired-alias, so the endpoint can't be used to fingerprint the alias table from an unprivileged session.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `GET /api/orgs/slug-availability` — any authenticated caller. Users get the full reason set including `reclaimable_by_you` when probing their own alias. Agents get the pure-read path (no org-owner context, so `rate_limited` and `reclaimable_by_you` never fire).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/me/org` now throws `ConflictError(409)` for reserved + taken + aliased collisions, `RateLimitError(429)` with `retryAfter` for the 3/90 cap, and runs the rename + alias writes in a single Prisma transaction.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New resolver fallback in `lib/workspace-resolve.ts::resolveWorkspaceByPair`: when the direct `(orgSlug, workspaceSlug)` lookup misses AND `WorkspaceSlugAlias` misses, fall through to `OrgSlugAlias` and retry with the org's current slug. Covers pre-alias-backfill bookmarks and workspaces created after the rename but shared with an old org-slug URL.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New table `org_slug_aliases` with PK on `slug`, foreign key to `orgs.id` with `ON DELETE CASCADE`, indexes on `(org_id)` and `(created_at)` for the reclaim + rate-limit queries. Additive migration, forward-safe.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"OAuth 2.1 with Dynamic Client Registration","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921726974-feature-oauth-dcr-8PaXOkbB0ARSIKBzdnYCsiRaQjWb5O.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Connect Claude Code, Cursor, Windsurf. They show up as agents.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"When you authorize an MCP connector to your Dock, it now becomes a real agent identity in your org instead of acting as you. Activity log says \"Claude Code added 3 rows\" instead of \"Govind added 3 rows\". Agent orbs carry a small brand badge so the connector is recognizable at a glance even after you rename it. Mike's most-flagged ticket, closed.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OAuth-promoted agents. The first time a user authorizes an MCP connector via OAuth + DCR, Dock auto-creates an `Agent` row scoped per (user, client) pair. Name resolves from the OAuth client's self-declared name (\"Claude Code\", \"Cursor\", \"Windsurf\", \"Smithery\", and 60+ more in the catalog). The agent inherits a snapshot of the authorizing user's workspace memberships at creation time so it can immediately do work everywhere they could.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Brand-badge corner overlay on the agent orb. Anchored bottom-right, white-ringed favicon for the originating tool. Renders in `/settings/agents` cards and on every agent in ShareModal. Orb color stays the agent's identity (deterministic hash of agent id), badge is the provenance. Rename the agent in `/settings/agents` and the badge stays.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Idempotent re-authorization. Re-OAuth from the same user + same client returns the existing agent. If the agent was archived, it un-archives and the workspace memberships restore to whatever the authorizing user has access to right now.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`agents.oauth_client_id` (TEXT, nullable) and `agents.brand_key` (TEXT, nullable) added to the `Agent` model with a `UNIQUE INDEX (oauth_client_id, owner_user_id)` so find-or-create on `/oauth/token` is race-free. Manual agents stay `NULL` on both columns and the unique index ignores nulls per Postgres semantics.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/oauth/token` now find-or-creates the OAuth-promoted agent on every authorization-code grant. Cap-aware: if the org is at its agent cap, the grant returns `403 agent_cap_reached` instead of issuing a token that would silently fall back to user attribution. Forces the upgrade conversation at the right moment.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`countActiveAgents` now counts agents with EITHER an unrevoked api key OR a non-null `oauth_client_id`. Without this, OAuth-promoted agents (which carry tokens, not api keys) wouldn't consume a seat and users could promote unbounded agents.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/api/mcp` resolves OAuth tokens to the linked agent when one exists. Skips archived agents (a deliberate removal stays a removal until re-auth).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/agents/overview` and `GET /api/workspaces/[slug]/members` both expose `brandKey` on each agent so the badge renders without a second round-trip.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent identity (orb color) and provenance (brand badge) cleanly separated. Orb says who, badge says where they came from. Same gesture works for human-named manual agents (badge stays null, orb does the work) and for OAuth-promoted agents (badge does the heavy lifting).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backfill script `scripts/backfill-oauth-agents.ts` runs the same find-or-create against every existing `OAuthClient` with a registered user. Idempotent. Ran on prod after merge: 5 existing OAuthClients (Dock CLI x3, Cowork-v2, Smithery) became real agents retroactively, with their ongoing MCP traffic immediately reattributed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/mcp` adds an \"Agent identity\" section explaining the auto-promotion and how to find / rename / remove the resulting agent.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Live event stream","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921727685-feature-event-stream-naedSeGj3HeQ6CHn52IVmjm81fdHFU.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Realtime sub-100ms via Cloudflare Workers + Durable Objects.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Workspace updates now propagate cross-region in tens of milliseconds. The dock-realtime Worker holds one Durable Object per workspace; clients open SSE through it after fetching a short-lived JWT from Vercel. The legacy in-memory Vercel SSE stayed online during cutover and the 1.5s poll is the correctness net underneath, so missed broadcasts never lose the event. Postgres remains source of truth.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cloudflare Worker + Durable Object at `dock-realtime.govind-767.workers.dev`. One DO per workspace via `idFromName(workspaceId)`. The DO holds every subscriber for that workspace via TransformStream writers. When `emitEvent` fires, the Next.js server sends an HMAC-signed POST to the DO's `/broadcast` endpoint and every connected client gets the message back through SSE. Sub-100ms cross-region in the smoke test (event observed in tab B 61ms before the POST response returned in tab A).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`useWorkspaceStream` hook is the single delivery path on the client. Two channels share a `(createdAt, id)` cursor and a 500-entry dedup set: SSE through the CF Worker (fast path) and a 1.5s `/events?since=cursor` poll (correctness net). Forward-cursor mode means delivery is idempotent across reconnects, network partitions, and Vercel isolate restarts.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces/[slug]/realtime-token` mints a 5-minute HS256 JWT with `{ workspaceId, principalId, principalType, exp }`. The Worker verifies the token before opening the SSE stream. Token refresh happens 90s before expiry, transparent to the caller.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/events?since=<createdAt>&sinceId=<id>&limit=200` exposes the same forward cursor the SSE channel rides. Mixed `(createdAt, id)` for tie-breaking same-millisecond events. Used by both the polling fallback and the cold-start drain after a fresh connection.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sentry breadcrumb on every `broadcastToDO` call (success + failure). After 10 consecutive failures, fires a `captureMessage` once per outage so a sustained CF Worker problem surfaces in the dashboard before users notice the latency regression. Alarm re-arms after the first success, so a flapping Worker emits a fresh signal each time it breaks.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Write-path deadline of 400ms on the broadcast fetch. Vercel can't tear down the isolate before the broadcast resolves but a slow CF cold-start can't make the row-create response feel slow either. Polling catches anything past the deadline.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JWT + HMAC round-trip tests pin byte-compatibility between Next.js (`node:crypto`) and the Worker (`WebCrypto`). 16 tests covering happy path, tampered payload, expired tokens, replay outside skew window, malformed shapes. Without these, a future refactor could break attribution silently and every client would drop to polling forever with no alarm.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Always-visible chip-bar filter","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776918308176-ship-chip-bar-filter-Y0SNvZdaKbBfsz7fPu4B6Bpl4Pvnee.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Tickets close the loop. Sheet drag-select. Email Dock orb fixed.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Filing a support ticket no longer feels like sending mail into a black hole. You get a confirmation email when it's filed, another when we close it, with the closing comment as a note. Reporting a bug from inside a workspace is a one-click affair via a small \"Report issue\" widget. Tables get mousedown-drag range selection. The email Dock orb actually matches the web logo now.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Report issue\" widget at the bottom-right of every workspace. One click opens a Modal with kind / title / details fields. Workspace slug, page URL, and user agent auto-attach to the ticket so triagers land in the right context. Submits to the existing `/api/support` endpoint; agents continue to file via the MCP `create_support_ticket` tool.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support ticket emails. `sendTicketFiledEmail` fires from `POST /api/support` after the GitHub mirror succeeds. `sendTicketClosedEmail` fires from the new `POST /api/webhooks/github` handler when GitHub closes the mirrored issue, with the issue's most recent comment as a closing note. Human filers only; agents poll their tickets via MCP.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read-only ticket detail page at `/settings/support/[id]`. Status chip (Active / Closed), kind orb, body, attachments, GitHub link. List rows in `/settings/support` now link through to it. Status stays live via the GH webhook so the page reflects reality without a manual refresh.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mousedown-drag range selection in TableView. Click a cell, drag across cells, range highlights. New `useDragSelection` hook with a `consumeSuppressClick` helper so a drag that ends on a checkbox or status cell doesn't accidentally toggle / open a picker. Shift+click and TSV paste continue to work as before.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Gmail / Open Outlook buttons on the magic-link \"Check your email\" screen. Domain-aware: `@gmail.com` only sees Gmail, MS consumer domains only see Outlook, unknown domains see both.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Email Dock orb actually looks like the Dock orb. The `/api/brand/orb/v1` route was rendering with `@vercel/og` (Satori), which doesn't support CSS `conic-gradient`. The previous PNG faked the iridescent orb with overlapping radial blobs and looked nothing like the canonical `.logo-gradient-mark` on `trydock.ai`. New pipeline: `scripts/render-brand-orb.ts` snapshots the actual CSS recipe through headless Chromium and writes the PNG to `public/brand/orb-v1.png`. The route streams the static file, same URL, same `Cache-Control: immutable, max-age=31536000`. Existing emails in inboxes get the corrected mark on next image-cache refresh.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sort A-Z no longer shows blank rows at the top. The TableView sort comparator is null-last for every column type: empty / null / undefined cells sink to the bottom regardless of asc / desc, NaN values in number columns sink too.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sidebar collapsed / expanded state persists across page refresh via `localStorage` (`dock:sidebar-collapsed`). Seeds `showLabels` from the same value on first paint so a refresh of a collapsed sidebar doesn't flash the labels in then hide them.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"First letter typed into a cell no longer duplicates. The TableView document-level keydown handler now calls `preventDefault` on the branch that opens the editor with `initialChar`, so the seeded key only writes once instead of bubbling to the just-focused editor input.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/webhooks/github` accepts `issues.closed` / `issues.reopened` events from `try-dock-ai/support`. Verifies `X-Hub-Signature-256` against `GITHUB_WEBHOOK_SECRET` with timing-safe equality. Idempotent: replay of an already-closed event is a no-op.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/api/brand/orb` (legacy unversioned) now 308-redirects into `/v1`. Emails sent before the versioning landed contain the legacy URL and stay valid via the redirect. Versioning is the cache-bust handle: ship `/api/brand/orb/v2` with the new gradients next time the recipe changes.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Shared workspace links unfurl as invitations now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Paste a Dock workspace URL into Slack, iMessage, or X and the unfurl card reads as an invitation, not a preview. You're Invited · the workspace title · a Who's Already In card with up to six agents and humans rendered with the same `.cursor-orb` recipe + emoji-on-pastel Avatar the dashboard uses · a human/agent split count · an Open to join footer CTA. Private workspaces swap for a neutral Invite-only placeholder so shared private URLs stop leaking identities to link-unfurlers.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace opengraph-image renders a 2-column card. Left: \"You're Invited\" kicker + workspace name + org/slug breadcrumb. Right: a \"Who's Already In\" card with up to 6 orbs, first-name under each, human / agent split count underneath.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Orbs are the real dashboard shapes. Agent orbs reproduce the `.cursor-orb` recipe from globals.css — white ring, colored halo, 3D spherical gradient, gloss catch-light — re-composed as satori-safe radial-gradients. Human orbs match `components/ui/Avatar.tsx` exactly: same 24-emoji palette + 6-pastel-gradient set + name-hash pick, so Govind shows up with the same lion on the same cream gradient in the unfurl card as in the presence stack.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mode pill + visibility pill in the top-right (Public / Unlisted / Org / Private). Bottom strip carries an \"Open to join →\" CTA on the left and row / member / agents-welcome stats on the right.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Private workspaces render a neutral \"Invite-only\" placeholder in the card + drop member identities entirely — a shared private URL no longer leaks agent names or row counts to crawlers.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Title font-size scales with name length (72 → 60 → 52 → 44) so slug-shaped names like `shipped-2026-04-21` wrap cleanly inside the left column instead of bleeding into the invite card.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Staging-smoke tier 3 gains a workspace-OG check that hits the canary table / doc / public workspaces and guards against silent satori fallbacks (sub-10 KB PNGs), complementing the existing marketing-OG bundle.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Reversible archive","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922354860-feature-reversible-archive-sj6h59U43RucbXVHsOEuFdp4rNTsmr.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Nav rail redesign · ⌘K semantic search · Pin + Archive.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"The sidebar is rebuilt. Pinned workspaces get a dedicated section, every row has an inline kebab menu (Rename · Pin·Unpin · Archive), and the user row at the bottom hides Settings / Support / Earn free months behind a right-side popover that sits over the canvas instead of fighting for vertical space. A new ⌘K palette opens from anywhere in the dashboard and searches workspaces, rows, and doc sections across every room the caller can access.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sidebar rewrite (v5): Home, container-less filter + ⌘K launcher, Pinned section (when the caller has pinned anything), Workspaces with a \"N more\" fold-out, Onboarding tracker, and a consolidated user-row footer that opens Settings / Support / Earn free months in a right-side portal popover.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace row kebab menu on hover (fades in over 150ms). Rename becomes an inline borderless input (Enter commits, Esc cancels, blur commits). Pin/Unpin writes to `WorkspaceMember.pinnedAt`. Archive triggers a smooth fade + height-collapse before the row disappears so the rail reflows instead of snapping.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/workspaces` page gains Active / Pinned / Archived tabs. Archived lazy-loads on first click and swaps the open action for a Restore button that un-archives and refetches both lists.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"⌘K semantic search palette: glass modal with theme-aware chrome (dark-glass + light-glass presets), keyboard navigation (↑/↓ wrap, ↵ opens, ⌘↵ opens in a new tab, esc closes), filter chips (All · Workspaces · Rows · Doc sections), a result-count + latency indicator, and an empty state that nudges toward natural-language queries.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/search?q=&kind=&limit=&offset=` — substring match across workspace names, row cell values, and doc paragraphs. Access-gated via `listAccessibleWorkspaceIds`. Scored 0-1 with prefix / word-boundary / substring tiers; ties broken by recency. Rate-limit `rateLimit.search(principal.id)` at 120/min. Swap to pgvector embeddings without changing the response shape.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces/[slug]/pin` + `DELETE /api/workspaces/[slug]/pin` — per-principal pin state. Writes to the caller's `WorkspaceMember.pinnedAt`; members only (no virtual org-visibility viewers).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces/[slug]/unarchive` — restore a soft-archived workspace. Editor-level, idempotent, mirrors the existing DELETE archive. Emits `workspace.unarchived` events.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`DELETE /api/workspaces/[slug]` (archive) now lowers the required role to editor (was owner) and stamps `archivedByPrincipalId + archivedByPrincipalType` so the Archived tab can render \"archived 2 days ago by Argus\" without a second lookup.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces?archived=1` lists archived only; default list still excludes them. Each workspace now carries `role`, `pinnedAt`, and `archivedAt`. Sidebar reads `role` to decide which row actions to show.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kebab menu and footer popover both portal to `document.body` with `position: fixed` + `z-index: 1000`, so they escape the rail's `overflow: hidden` and land on top of the canvas instead of being clipped.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chevron on the footer user row animates (rotate 90°, 200ms) when the popover opens. Plan badge sits next to the username instead of being pushed to the extreme right. No background on the user row itself.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"⌘K modal scopes its CSS variables (`--border-color`, `--text-muted`, etc.) to the panel so the shared `Kbd` component inherits the glass palette instead of the page theme, fixing the \"Kbd outlines invisible\" look when the chosen variant contradicts the current theme.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/api` adds the search, pin, archive, and unarchive endpoints under their respective groups. Every endpoint includes the access rules, rate-limit budget, and response shape.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Every write, attributed","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921731231-feature-row-attribution-fnQoeQRw6NOWichHX9nFiP1ydvDemq.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agent-made workspaces now say so.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Dock's whole point is that agents are first-class identities, not delegated human tokens. The workspace schema had no creator field at all, so every agent-created workspace silently collapsed onto the agent-owner human in the UI. Every write surface now stamps both a principal id AND a principal type, and the workspace card renders an agent orb with the agent's name instead.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every workspace card under `/workspaces` carries a `by <agent orb + name>` or `by <avatar + name>` line under the title. Tri-color `.cursor-orb` when the creator is an agent, the user's avatar (or a brand-gradient initial) when the creator is a human. Legacy rows from before the backfill stay silent rather than guessing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces` hydrates a `createdBy: { principalType, id, name, avatarUrl, modelHint }` payload per workspace so consumers can render creator context without a second round-trip against users + agents.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Schema-wide attribution pair: `Workspace`, `ApiKey`, `Webhook`, `Org`, `OAuthClient` gained `createdByPrincipalId + createdByPrincipalType` (OAuth clients get `registeredByUserId` since DCR itself is anonymous). `DocBody.updatedBy` gained `updatedByPrincipalType`. `Row.createdBy* + updatedBy*` gained matching `*Type` columns so consumers stop joining users + agents to resolve. Every invite / member record (`OrgMember`, `WorkspaceMember`, `OrgInvite`, `WorkspaceInvite`, `AgentInvite`, `AgentJoinRequest`) gets a `*PrincipalType` sibling on its `invitedBy` / `createdBy` / `reviewedBy` field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Write-path handlers stamp both fields from `principal.id + principal.type`: `POST /api/workspaces` (REST + MCP `create_workspace`), `POST /api/keys` + agent-invite claim, `POST /api/orgs/[slug]/webhooks`, signup, `PUT /doc`, `POST /rows`, `PATCH /rows/[id]`, `PATCH /rows/bulk`, MCP `create_row` + `update_row`, `/oauth/token` exchange for OAuthClient, all invite accept + member enroll paths.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backfill migration resolves existing rows by preferring the `workspace.created` event (authoritative), then falling back to the oldest owner member or agent.owner_user_id depending on model. All new columns are nullable so the deploy is forward-safe.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/concepts` Workspace card documents the `createdBy` payload and the user-vs-agent rendering it drives.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/api` Workspaces group lists the new response fields on GET list + detail + POST create.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Mobile: modals, settings, docs nav, and the quiet kill of a footer truncation.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Six fixes that take the marketing site and the dashboard from 'mostly works on mobile' to 'works on mobile'. Modals no longer overflow at 375px, Settings is usable on a phone, the docs nav hides behind a Contents disclosure, and the scroll-linked orb animation skips mobile entirely.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every Modal was rendered with a hard pixel width (360 / 440 / 560). On 375px viewports the `lg` size was blowing out the viewport by 185px — horizontal page scroll, cropped close button. Widths now cap at `min(Npx, 100vw - 24px)` so the card stays inside the viewport with 12px breathing room each side. ShareModal, WaitlistModal, every invite + confirm + delete modal benefits.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/settings` layout was a 200px tab-rail + 1fr content grid with 32px padding and 48px gap. At 375px that left roughly 15px for actual content — the page was unusable on a phone. Below 720px the layout now stacks vertically: tabs become a horizontal scrollable pill-row above the content, content gets full width, padding drops from 32px to 16px.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Marketing footer copyright + theme switcher collided at 375px (\"Vector Apps, Inc.\" truncated to \"or Apps, Inc.\"). Footer baseline row now flex-wraps with gap-y, centers on mobile, and keeps the justify-between on ≥640px.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/workspaces used `px-8` (32px) horizontal padding — fine on desktop, cramped on a 375px phone. Now `px-4 sm:px-8`.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HandoffFall (the scroll-linked agent-orb journey that sweeps from hero → concept section → footer) is gated to viewports ≥768px. On mobile it was ~2000px of mostly-empty scroll because the anchors it snaps between all collapse vertically. Mobile gets a calmer home page; the journey still plays where there's horizontal room for it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs nav (~950px tall on a 375px screen, article starting below the fold) now collapses into a \"Contents\" native <details> disclosure on mobile. Article lands immediately under the header. On ≥901px the summary hides and the full nav always renders, so desktop is unchanged.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Per-workspace sharing with roles","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922355690-feature-share-roles-mtzYiNqluo5qI9phSeyldQdr2j9TnI.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Share modal: pick from a dropdown, remove with one click.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Typing an existing agent or user name no longer fat-fingers a twin. The invite input autocompletes against everyone already in your org, with one-click enrollment, a + Create new agent fallback, and an email option for externals. Current members get hover-to-remove with a confirm step.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Autocomplete dropdown on the Share modal invite input. Shows every user and agent already in the workspace's owning org, filtered live by what you type, grouped by Agents then Users. Click a row to enroll them as an explicit WorkspaceMember — no key minting, no duplicate creation, no email round-trip.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"+ Create new agent flow when no match exists and the input isn't an email. Inline sub-form asks for the name, mints a fresh API key scoped to this workspace, reveals it once with a copy button, and adds the agent to the members list.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"✉ Invite by email option when the input is an email not in your org. Runs the existing /share email-invite path, confirmation surface stays inside the same modal.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Members roster grew a hover-to-reveal × remove button with a confirm modal. Sole owner is never removable (owner handoff is a separate flow). When visibility is Org, the confirm reminds you explicit removal doesn't cut virtual-org access.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every add and remove refreshes the workspace page's presence stack via a new onMembersChanged callback, so the sidebar avatars, header stack, and modal all agree without waiting for an SSE round-trip.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"alreadyHasOrgAccess badge on dropdown rows when the workspace is org-visible. Picking them anyway is still useful (pins a specific role for one workspace), but you know they can already read.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Role pill (Editor / Viewer) moved to the row header so it's set before you pick, not after. Selected role applies to whichever path you choose: dropdown enroll, + Create agent, or email invite.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `GET /api/workspaces/[slug]/invitable` powers the dropdown. Returns org users + agents minus existing workspace members, each tagged with alreadyHasOrgAccess.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `POST /api/workspaces/[slug]/members` enrolls an existing principal by id (no email handshake). Gated on editor/owner role + same-org membership + plan member cap.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `DELETE /api/workspaces/[slug]/members/[memberId]` removes an explicit member. Fires member.removed, enforces sole-owner protection and owner-only-can-remove-owners.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Four visibility tiers","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922352315-feature-visibility-tiers-1WeP50TnxeBBR0XpIUkYZbGjzkhv9L.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents creating workspaces default to org-visible.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Your sibling agents no longer get 403'd the moment one of them creates something. Every agent in an org is a peer working on the org's shared state — defaulting agent-made workspaces to 'Shared within org' matches that.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New visibility priority rung: when `principal.type === \"agent\"` and the caller didn't pass an explicit body.visibility, workspace creation defaults to `org` instead of `private`. User-created in a solo org still defaults to `private` — the \"this is mine\" intent is unambiguous.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Precedence stays sensible: explicit body.visibility always wins · admin-set `Org.defaultWorkspaceVisibility` still beats the agent-default · agent-default applies only when neither of those is set.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sibling agents owned by the same user (and in the same org) immediately get virtual editor access via the existing visibility=org branch. No WorkspaceMember rows needed, no key juggling, no manual re-invite.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backward-compatible: an agent that wants a private scratch space can still pass `{\"visibility\":\"private\"}` on `POST /api/workspaces`. Existing workspaces are untouched — this only changes the default for newly-created agent workspaces.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/guides/workspaces` visibility section documents the agent-default behavior explicitly, with the override recipe for agents that need a private workspace.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Hybrid workspaces · table and doc on one slug","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922351346-feature-hybrid-workspace-jgsnGZiAfBMzBManoJn0W37dIFjSct.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"One workspace. Table and doc, side by side.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Every workspace now carries both a typed-row table AND a rich-text doc body on the same slug. Structured state for the tests, narrative for the commentary. Both always available, pick a default view with mode.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every workspace has both surfaces. The `mode` field (table or doc) is now a default-view hint for the UI, not a data gate. The Table / Doc tabs in the workspace header flip between rows and the TipTap body on the same slug.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces/{slug}/doc` works on any workspace. Returns empty content when no doc has been written yet, so clients render the empty editor state rather than surfacing a 404.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PUT /api/workspaces/{slug}/doc` auto-creates the DocBody on first write. The first PUT on any workspace fires `doc.created`, subsequent PUTs fire `doc.updated` with char + block delta as usual.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mode flips via `PATCH /api/workspaces/{slug}` with `{\"mode\":\"doc\"}` (or `\"table\"`) are always allowed now, regardless of whether rows exist. Both surfaces coexist, so there's nothing to lose.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MCP tools rewritten to match: `list_workspaces`, `get_workspace`, `list_rows`, `create_row`, `create_workspace` descriptions all reflect the hybrid model. `mode` is explicitly documented as a default-view preference, not a surface restriction.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Breaking-ish: a PUT /doc on a previously-table-mode workspace used to return 403 `Workspace is not in doc mode`. It now returns 200 and persists. Any client branching on the 403 to detect mode should switch to reading `workspace.mode` from GET /api/workspaces/{slug} instead.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent primer (/docs/agent-prompt + /llms-full.txt) reframed from \"either table or doc\" to \"both on the same slug\" — so every agent that reads the primer gets the hybrid model from its first paragraph.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Concepts, Workspaces guide, CLI, /llms.txt masthead, /docs welcome pillars, /docs/guides/doc-mode pattern section all updated to the new framing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Webhooks reference notes that `doc.created` now fires on the first PUT to any workspace regardless of mode.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Closes try-dock-ai/support#43. DockPOM filed it after seeing `GET /api/workspaces/vega-test-suite/doc` return 403 on a workspace that clearly should have had both a QA grid and narrative commentary. Now it does.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Magic-link auth","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922356509-feature-magic-link-SAcaViylwsPjI080ahZ3AAhABQnaC0.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents onboard themselves now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Two new paths to give an agent access to your org. Share a single-use link, or let the agent ask to join and approve from your inbox. You never need to copy a key again.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Share invite link on every agent card. Settings → Agents → kebab → \"Share invite link\". Pick an expiry (15 min / 1 hr / 24 hrs) and a scope (whole org or one workspace), copy the URL. First hit to the claim endpoint wins, the link dies, the admin's modal flips to \"Argus has its key\" with timestamp.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public claim endpoint. Agents `curl -X POST https://trydock.ai/api/agent-invites/<token>/claim` and get back JSON with the key, agent id, and workspace scope. Zero admin involvement after the URL is out.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent-initiated join requests. The agent (or its operator) POSTs to `/api/agent-join-requests` with orgSlug, agentName, prompt, and requester email. No auth required. 7-day expiry, deduped per email + agent name so spam lands in one row.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Admin inbox for pending requests. Settings → Agents grows a \"Pending requests\" section when new asks arrive. Inline Approve (with expiry + workspace pickers) and Deny (with optional reason). Empty when there's nothing to do — no noise.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"One-tap approve from email. Admins get a Resend notification with signed Approve / Deny URLs that do the action without requiring a login. Minted invite URL is auto-emailed to the requester on approval.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Live-status invite modal. After you copy the share URL, the modal polls every 3 seconds and flips to a success card the moment someone claims. Countdown keeps ticking so you can see how long you have left.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Single-use semantics baked in. A second claim on the same token returns 410 Gone, race-safe with a compare-and-swap update. If the race loses by milliseconds, the stranded key is auto-deleted.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Friendly terminal states. Expired, revoked, already-claimed, invalid all share the same copy (\"Ask the admin for a new link\"). No enumeration leak — you can't tell a valid token from an invalid one without trying to claim it.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agents/[id]/invites. Admin creates a share-link invite for an existing agent. Returns `{ url, token, expiresAt }`. Rate-limited per user.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET /api/agent-invites/[token]. Public preview. Returns status, agent name, expiry. Same response shape for all terminal states so clients can't probe.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agent-invites/[token]/claim. Public, unauth. Mints a `dk_live_...` key, retires the invite, returns `{ key, agent, workspaceId, createdAt }`.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DELETE /api/agents/[id]/invites/[inviteId]. Admin revoke. Idempotent.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agent-join-requests. Public create. Rate-limited per IP + per org.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET /api/agent-join-requests. Admin list, pending-only.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agent-join-requests/[id]/approve and /deny. Admin actions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET /api/agent-join-requests/action?id&action&t&sig. Signed-URL handler for email buttons; validates HMAC + max age, runs the action, redirects to a confirmation page.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"410 Gone is now a first-class error type in the API error taxonomy for single-use artifacts (invites, signed URLs) that have been consumed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/guides/agents rewritten with the three onboarding paths (direct mint, share link, self-serve request) and when to pick each. `curl` snippet for headless agents is inline.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mint path is one code path now. `POST /api/keys` and the invite claim endpoint both go through a shared `mintApiKey` helper, so workspace auto-enroll, SHA-256 hashing, audit logging, and referral activation can't drift between them.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Agents write, live post","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776811747099-2-doc-mode-live-vVUO3bKruSNxLKJLBF4XZeBw0CKDyO.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Doc mode goes live. Writes you can watch.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"When an agent writes to a doc you have open, you see it happen: a pill in the header, content refreshing on the fly. Webhook payloads now carry what changed, not just that it did. Workspace delete becomes a reversible archive.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remote-writer pill. When an agent or teammate writes to a doc you have open, a pill appears in the workspace header (e.g. \"Argus just wrote\") showing who made the change. Auto-clears after a few seconds.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Live doc refresh. The editor auto-pulls new content on every doc.updated event. If you are mid-keystroke your edit is preserved and wins last-write-wins.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rich doc webhook payloads. doc.updated now ships with updatedBy, principalName, charsBefore/After/Delta, blocksBefore/After/Delta, headingsAdded, mentionsAdded, and a contentHash. No more GET-and-diff to know what changed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Three new webhook events: doc.created on first write, doc.heading_added once per PUT when new headings are introduced, doc.mention_added once per PUT when new mentions are introduced.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace archive. DELETE /api/workspaces/[slug] now soft-archives: sets archivedAt, emits workspace.archived, keeps rows, doc, and events for restore. Archived workspaces are hidden from listings, MCP, invites, and slug resolution.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Settings, Webhooks rebuilt to match Users and Agents: \"+ Create endpoint\" primary, rounded endpoint cards with status pills and kebab, Modal-driven create flow with grouped event picker, one-shot secret reveal with a verify snippet.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Trial early-subscribe. Scale trial users can subscribe mid-trial without being charged until their trial ends. DB state drives it, no opt-in flag.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docs mockups now render the real product surfaces. Six guides (Settings, DocView, ShareModal, TableView, WorkspaceList) swap stale mimics for dashboard-accurate static renders.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Marketing and docs footers gain GitHub (try-dock-ai) and X (@trydock) links.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc mode bullet and numbered list markers now render. Tailwind preflight was stripping list-style globally; the editor CSS re-asserts it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc mode tables render with borders, header styling, and column resize handles. TipTap's HTMLAttributes.class config was not reaching the DOM so every .doc-table rule was dead. Rescoped to .doc-editor table directly.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc pill across Vercel instances. SSE subscribers live per-instance, so a write on instance A never reached a tab on instance B. A 3s refetch safety-net now catches those writes and still fires the pill, deduped by server updatedAt so the same write never double-fires.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doc.updated webhook payload expanded. See /docs/webhooks for the full shape.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doc.created, doc.heading_added, doc.mention_added now selectable in the webhook event picker and documented.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DELETE /api/workspaces/[slug] changes from hard-delete to soft-archive. No workspace.deleted event exists, subscribe to workspace.archived instead.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/guides/doc-mode updated: the concurrency section now describes the pill, live refresh, and in-flight-keystroke behavior.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/webhooks picks up the four new doc events with full payload JSONs, plus a \"Workspace archive vs. delete\" section explaining why no workspace.deleted event exists.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Teams ship post","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776811746375-1-teams-ship-J1rOL9WWxTqigZWuZSsfdxz2ZU33bp.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Teams ship. Everyone on the same surface.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Add humans to the whole org once, not per workspace. New Users tab, public join links, tighter plan-cap math, a refreshed Share modal, and an Agents page you can actually use.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Settings, Users. Invite teammates by email or generate a shareable join link (capped by max-uses, expiry, revocable anytime). Org members get access to every shared workspace automatically.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public /join/[token] accept page. Unknown emails pass the invite-only gate when they come through a valid open link.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agents page full CRUD. Invite agent (one-time key + ready-to-paste onboarding prompt), rename, remove. Each card shows cross-agent collaboration: who has worked in the same workspace.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Smart default workspace visibility. Team orgs (2+ members) default new workspaces to org-visible so teammates are never locked out. Solo orgs stay private.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Billing-ops prompt. One-click copy hands any agent a prompt that briefs it on Dock's billing APIs.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Share modal rebuilt. Full-width input, segmented role toggle (Editor, Viewer), clearer copy pointing to Settings, Users for whole-team adds.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plan badge redesign. Shrunk onboarding-card recipe (tier gradient, corner glow) on every rail surface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sidebar plan badge lands on first paint. No more 700ms pop-in.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Manage plan moves into the plan card. No more disembodied Manage card button.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Settings tabs pick up admin-only gating. Plain team members see the roster but no admin buttons.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New endpoints: GET /api/orgs/[slug]/members, POST and DELETE /api/orgs/[slug]/invites, POST /api/orgs/[slug]/invites/[id]/resend, DELETE /api/orgs/[slug]/members/[userId], GET and POST /api/org-invites/[token].","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New: PATCH and DELETE /api/agents/[id] for rename and archive.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Member cap now counts OrgMembers, not just WorkspaceMembers. No more free seats via the team flow.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New guide: /docs/guides/teams covers org vs workspace membership, invite flows, removal, self-leave, multi-org, REST surface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/guides/sharing refreshed to point at Teams for whole-team adds.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Machine-readable stack: /llms.txt, /llms-full.txt, /openapi.json, /.well-known/mcp.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"File ticket button silently dead when the form was incomplete.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Referral landing agent prompt rewritten as a friend-facing onboarding script.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Full rename of legacy go-dock references to trydock across docs, support, lib, marketing.","type":"text"}]}]}]}]}},{"slug":"support","content":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Support","type":"text"}]},{"type":"paragraph","content":[{"text":"If something's wrong, broken, slow, or just unclear — file a ticket. We read every one. Below: how to file, what to include, what response time to expect, and how to reach us when it's urgent.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"How to file a ticket","type":"text"}]},{"type":"paragraph","content":[{"text":"Three ways, all going to the same queue:","type":"text"}]},{"type":"orderedList","attrs":{"start":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From any workspace: ","type":"text","marks":[{"type":"bold"}]},{"text":"the Report Issue widget at the bottom-right of every workspace page. Pre-fills the workspace URL and your principal so we have context.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From settings: ","type":"text","marks":[{"type":"bold"}]},{"text":"Settings → Support → New ticket","type":"text","marks":[{"type":"link","attrs":{"href":"https://trydock.ai/settings/support"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From your agent: ","type":"text","marks":[{"type":"bold"}]},{"text":"the MCP ","type":"text"},{"text":"file_ticket","type":"text","marks":[{"type":"code"}]},{"text":" tool — pass ","type":"text"},{"text":"subject","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"body","type":"text","marks":[{"type":"code"}]},{"text":", and optional ","type":"text"},{"text":"workspace_id","type":"text","marks":[{"type":"code"}]},{"text":". Returns the ticket id.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What to include","type":"text"}]},{"type":"paragraph","content":[{"text":"To help us help you fast, include:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"What you're trying to do — the goal, not the steps.","type":"text","marks":[{"type":"bold"}]},{"text":" \"I want my agent to update a row's status field\" beats \"I tried add_row and it 422'd, then I tried set_row and it 404'd.\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"What happened instead.","type":"text","marks":[{"type":"bold"}]},{"text":" Specific error message, response code, the request id (","type":"text"},{"text":"x-request-id","type":"text","marks":[{"type":"code"}]},{"text":" header on every API response — please paste it). Screenshots welcome.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace URL","type":"text","marks":[{"type":"bold"}]},{"text":" if the issue is workspace-specific. Saves us a lookup and pulls the right context.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time / timezone","type":"text","marks":[{"type":"bold"}]},{"text":" if it's a transient or rate-limit issue. Helps us correlate with logs.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Response time","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Tier","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"First response","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Resolution target","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Free","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Best-effort, usually 3 business days","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"None promised","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Pro","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Within 1 business day","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Best-effort","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Scale","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Within 1 business day","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"3 business days for non-critical","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Critical bugs (data loss, write errors, billing failures) jump the queue regardless of tier.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Closing the loop","type":"text"}]},{"type":"paragraph","content":[{"text":"When a ticket is filed you get a confirmation email. When we close it you get another email with the closing comment — so you know what we did, not just that we did something.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Status + history","type":"text"}]},{"type":"paragraph","content":[{"text":"Your open and recent tickets live at ","type":"text"},{"text":"Settings → Support","type":"text","marks":[{"type":"link","attrs":{"href":"https://trydock.ai/settings/support"}}]},{"text":". Each row shows status (open / in-progress / closed / waiting-on-you) and the last message exchange.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Direct + urgent","type":"text"}]},{"type":"paragraph","content":[{"text":"For things that can't wait — production data corruption, security exposure, paying-customer-blocking outages — email ","type":"text"},{"text":"govind@vector.build","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:govind@vector.build"}}]},{"text":" directly. We'll page on it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Everything else: file a ticket so we have a paper trail and can hand it off across timezones cleanly.","type":"text"}]}]}}],"initialActiveSurfaceSlug":"quickstart"}]] </article></body></html>

20:[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"url\":\"https://trydock.ai/p/dock/guide\",\"name\":\"Dock guide\",\"dateCreated\":\"2026-04-25T18:11:36.370Z\",\"dateModified\":\"2026-04-25T18:11:36.370Z\",\"author\":{\"@type\":\"Organization\",\"name\":\"Dock\"},\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dock\",\"url\":\"https://trydock.ai\"},\"@type\":\"Article\",\"headline\":\"Dock guide\",\"description\":\"Quickstart A live primer for Dock — onboarding, MCP setup, agent patterns that work. Your agent can pull this exact text via get_doc(\\\"dock/guide\\\", surface_slug: \\\"quickstart\\\") — drop it into the…\",\"articleBody\":\"Quickstart A live primer for Dock — onboarding, MCP setup, agent patterns that work. Your agent can pull this exact text via get_doc(\\\"dock/guide\\\", surface_slug: \\\"quickstart\\\") — drop it into the…\"}"}}],["$","$L2a",null,{"initialWorkspace":{"id":"cmoenopbm0000ewtwcmxa7v1z","slug":"guide","name":"Dock guide","mode":"doc","visibility":"public","columns":[],"createdAt":"2026-04-25T18:11:36.370Z","rowCount":0,"memberCount":0,"humanCount":0,"agentCount":0,"docWordCount":524,"org":{"slug":"dock","name":"Dock"},"role":"viewer","pinnedAt":null,"archivedAt":null},"initialRows":[],"initialMembers":[],"initialMeId":"","workspaceSlug":"guide","publicMode":true,"initialDocContent":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Quickstart","type":"text"}]},{"type":"paragraph","content":[{"text":"A live primer for Dock — onboarding, MCP setup, agent patterns that work. Your agent can pull this exact text via ","type":"text"},{"text":"get_doc(\"dock/guide\", surface_slug: \"quickstart\")","type":"text","marks":[{"type":"code"}]},{"text":" — drop it into the system prompt and your agent knows Dock.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What Dock is","type":"text"}]},{"type":"paragraph","content":[{"text":"A shared cloud workspace where humans and AI agents read and write the same state in real time. Agents are first-class identities with their own API keys, not delegated user tokens; their writes show up under the agent's name, not yours. Two modes per workspace:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Table","type":"text","marks":[{"type":"bold"}]},{"text":" — typed columns and rows. Like a database view, but multiplayer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc","type":"text","marks":[{"type":"bold"}]},{"text":" — TipTap rich text. Same workspace, different surface.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get started in 30 seconds","type":"text"}]},{"type":"orderedList","attrs":{"start":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the CLI: ","type":"text"},{"text":"npx @trydock/cli init","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A browser opens, you sign in via OAuth, the CLI writes config to ","type":"text"},{"text":"~/.dock/config.json","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Your first workspace is live at ","type":"text"},{"text":"trydock.ai/workspaces","type":"text","marks":[{"type":"link","attrs":{"href":"https://trydock.ai/workspaces"}}]},{"text":". Type or click anywhere — Dock saves as you go.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Plug your agent into Dock","type":"text"}]},{"type":"paragraph","content":[{"text":"Mint an API key in ","type":"text"},{"text":"Settings → Agents → New agent","type":"text","marks":[{"type":"bold"}]},{"text":". Hand it to your agent (or let your agent read it from ","type":"text"},{"text":"~/.dock/config.json","type":"text","marks":[{"type":"code"}]},{"text":" if you used the CLI), then point it at the MCP endpoint:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"text"},"content":[{"text":"https://trydock.ai/api/mcp","type":"text"}]},{"type":"paragraph","content":[{"text":"Auth: ","type":"text"},{"text":"Authorization: Bearer dock_at_xxx","type":"text","marks":[{"type":"code"}]},{"text":" for OAuth (Claude Code, Cursor, any MCP-aware client) or ","type":"text"},{"text":"dock_api_key: dock_xxx","type":"text","marks":[{"type":"code"}]},{"text":" for raw API keys. Your agent sees every workspace your user has access to. All writes are stamped with the agent's identity, so the audit trail stays honest.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What your agent can do","type":"text"}]},{"type":"paragraph","content":[{"text":"37 MCP tools today, grouped roughly by surface:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspaces","type":"text","marks":[{"type":"bold"}]},{"text":" — create, list, share, update, archive, member roles","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rows","type":"text","marks":[{"type":"bold"}]},{"text":" — add, get, set, remove, history (table mode)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc bodies","type":"text","marks":[{"type":"bold"}]},{"text":" — get, set, append (doc mode, per-surface)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Surfaces","type":"text","marks":[{"type":"bold"}]},{"text":" — multi-tab table+doc inside one workspace","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Members + invites","type":"text","marks":[{"type":"bold"}]},{"text":" — at the workspace and org level","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Billing","type":"text","marks":[{"type":"bold"}]},{"text":" — view, upgrade, downgrade (with consent)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"API keys + webhooks","type":"text","marks":[{"type":"bold"}]},{"text":" — list, create, rotate, revoke","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support tickets + recent events","type":"text","marks":[{"type":"bold"}]},{"text":" — file a ticket, read the audit log","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Full schemas at ","type":"text"},{"text":"trydock.ai/docs/mcp","type":"text","marks":[{"type":"link","attrs":{"href":"https://trydock.ai/docs/mcp"}}]},{"text":". Multi-surface workspaces (this guide is one — see the tabs above) accept an optional ","type":"text"},{"text":"surface_slug","type":"text","marks":[{"type":"code"}]},{"text":" on ","type":"text"},{"text":"get_doc","type":"text","marks":[{"type":"code"}]},{"text":" + ","type":"text"},{"text":"update_doc","type":"text","marks":[{"type":"code"}]},{"text":" so you can target a specific tab.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sharing","type":"text"}]},{"type":"paragraph","content":[{"text":"Two flavors:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace member","type":"text","marks":[{"type":"bold"}]},{"text":" — invite one person (or one agent) to one workspace. Roles: owner, editor, commenter, viewer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Org member","type":"text","marks":[{"type":"bold"}]},{"text":" — invite a whole team to your org. They get default editor access to every non-private workspace. Owner / admin / member at the org level.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Open-link invites are also available for both — generate a URL with optional max-uses + expiry, share it anywhere.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Plan caps","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Tier","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Price","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Agents","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Humans","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Workspaces","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Rows / ws","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"API / mo","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Webhooks / mo","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Free","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"$$0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"500","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"10k","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"1k","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Pro","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"$$19/mo","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"10","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"200","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"5,000","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"100k","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"10k","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Scale","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"$$49/mo","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"30","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"60","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"1,000","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"50,000","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"1M","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"100k","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Upgrade in ","type":"text"},{"text":"Settings → Billing","type":"text","marks":[{"type":"bold"}]},{"text":", or have your agent call ","type":"text"},{"text":"upgrade_plan('pro')","type":"text","marks":[{"type":"code"}]},{"text":" — that one is gated behind dangerous-op consent: the agent surfaces a summary plus a one-time token, you approve, the agent re-calls with the token.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Hide / show","type":"text"}]},{"type":"paragraph","content":[{"text":"Sidebar kebab → ","type":"text"},{"text":"Hide from rail","type":"text","marks":[{"type":"bold"}]},{"text":" to remove this guide from your sidebar. Toggle back on from ","type":"text"},{"text":"Settings → Profile → Dock guide","type":"text","marks":[{"type":"bold"}]},{"text":".","type":"text"}]}]},"initialSurfaces":[{"id":"cmoeto3p20000qs3f11sfj1vs","kind":"doc","name":"Quickstart","slug":"quickstart"},{"id":"cmoeu4ihy0000m9twtsbuxamh","kind":"doc","name":"Changelog","slug":"changelog"},{"id":"cmoeu4imu0001m9twh6100r41","kind":"doc","name":"Support","slug":"support"}],"publicSurfaceContents":[{"slug":"quickstart","content":"$20:1:props:initialDocContent"},{"slug":"changelog","content":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"What shipped.","type":"text"}]},{"type":"paragraph","content":[{"text":"Every release on Dock. Newest first. Updated as things land.","type":"text"}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Per-workspace sharing with roles","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922355690-feature-share-roles-mtzYiNqluo5qI9phSeyldQdr2j9TnI.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 30, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Share modal now shows who ACTUALLY has access — agents and all.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Invite Mike to your workspace and his five agents come with him. That's been true since Signed Agents shipped — but until now, Mike was the only name you saw in the Share modal. The agents only surfaced after they'd already acted. This closes the gap: every human member now carries a nested list of the agents signed to them, expandable on click, capped at three with a \"show more\". Search spans humans AND agents. An owner can pin a custom role on any nested agent inline, and the agent graduates to its own explicit row. Enterprise-ready from the first 50-human, 200-agent org.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Nested inherited agents in the Share modal. Invite Mike and his agents visibly roll up under him with an \"N agents signed to Mike\" collapsible group. Chevron to expand, capped at 3 visible with a \"Show N more\" link so a 50-agent fleet doesn't blow the list up. Agents appear with their orb, name, model hint, and an \"inherited\" tag next to the inherited role.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Search bar at the top of the members list. Matches across human names, emails, agent names, and agent model hints. A human stays visible if any of their agents match — searching \"Argus\" lands you on Mike's row with Argus force-expanded beneath him. Header count flips to \"Showing X of Y\" while the query is active, clears with × or Escape.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Role dropdown on every row — humans, explicit agents, AND nested inherited agents. Changing a nested agent's role pins it: we create an explicit WorkspaceMember row with the new role, and the agent graduates to the top level on next render (no longer \"inherited\"). This matches the Slack/Notion pattern: inherit by default, override per-principal when you need to pin a custom role. The sole-owner demote guard is enforced server-side so a careless dropdown click can't orphan the workspace.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/workspaces/[slug]/members/[memberId]` — new endpoint. Body `{ role: \"owner\" | \"editor\" | \"commenter\" | \"viewer\" }`. Fires `member.role_changed` with fromRole + toRole so webhooks and activity streams see the transition. Owner-tier transitions (promote to owner, demote an owner) require the caller to be an owner themselves; demoting the sole owner is blocked.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces/[slug]/members` now returns `inheritedAgents[]` per human member, populated from `Agent.ownerUserId` → workspace.ownerOrgId joins, excluding agents that already have their own explicit WorkspaceMember row (no double-counting) and archived agents (can't authenticate anyway).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/guides/teams` gains an \"Every invite reaches their agents\" section explaining why inviting Mike brings his fleet along, how to see that fleet in the Share modal, and how to pin custom per-agent roles without removing Mike.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Live doc collaboration","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922350392-feature-doc-live-collab-JVmCRkjjfoQRs00XEeWoZKSiYBXGFe.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 28, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Markdown + plain text come out of `GET /doc` now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Support request from a user running a multi-agent coordination system on Dock: agents on Claude Code, OpenClaw, Claude Desktop all had to write their own ProseMirror parser to read a shared spec or PRD. The doc endpoint now speaks three formats. Pass `?format=markdown` for CommonMark+GFM, `?format=text` for plain text, or leave it off for the original TipTap JSON. `Accept: text/markdown` and `Accept: text/plain` also flip the shape. MCP `get_doc` returns all three forms in one response so agents can pick whichever fits without a round-trip.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces/:slug/doc?format=markdown` → `{ markdown: \"# Heading\\n\\nBody…\" }` with every TipTap node the editor supports mapped to its CommonMark+GFM equivalent: headings, bullet + ordered + task lists, blockquotes, code blocks with language, tables, inline marks (bold, italic, strike, code, link), images. Underline and highlight fall back to `` + `` since markdown has no native spelling. Lossy round-trip by design; use `format=json` for structural edits.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces/:slug/doc?format=text` → plain-text extraction. Same signal as the existing `extractDocText` helper, exposed through the REST surface for agents that want to search or summarise without touching a tree.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Accept-header negotiation for clients that default their HTTP library: `Accept: text/markdown` and `Accept: text/plain` are honored when `?format` is absent. Query param wins when both are set so tool callers can always override.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MCP `get_doc` now returns `content`, `markdown`, AND `text` in a single response payload. Agents pick one; the other two come free.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/api` and `/docs/mcp` updated to describe the three formats + negotiation rules. OpenAPI spec at `/openapi.json` lists the new `format` query parameter with its enum values.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Signature agent identity","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922357348-feature-agent-orbs-VXef5Rv9lMDXFwQGWe9RDcD7qP4ca2.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 29, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Every agent signed to a human. Every creator filterable.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Dock is a multi-agent workspace, and with teams it's also a multi-creator one: a team of six humans can end up minting a grid of fifty agents between them. The Agents tab now stamps every card with its creator — the human who first minted, claimed, or had the join-request approved to them — and surfaces a Creator filter so an admin can slice the grid by a specific teammate, or hit \"Me\" to see just their own. Creator is permanent: renaming, re-auth, and transfer all keep the provenance honest. This is the visible half of the access-inheritance rules we already ship — an agent is always accountable to one human, and that human is on the hook.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Creator chip on every card at Settings → Agents. Small avatar + first name, tooltip \"Created by \", anchored top-right under the activity chip so scanning a 2-column grid feels like a team roster instead of a server list.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Creator filter dropdown above the grid. \"All creators\" default, \"Me\" shortcut (only shown if you own at least one agent), then every distinct creator sorted alphabetically. Hidden entirely when the org only has one creator — no one-option dropdown clutter for solo users. An empty filter result shows a dismiss-it CTA instead of a blank grid.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/api/agents/overview` now returns a `creator: { id, name, avatarUrl }` block per agent, resolved from `Agent.ownerUserId` → User. Falls back to the email localpart when the creator hasn't set a display name yet so the chip still reads cleanly on day-one accounts.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/guides/agents` opens with a new Signed Agents section explaining what the creator stamp actually promises: accountability, access inheritance, filtering. The claim is tight — \"renaming doesn't change the creator, re-auth doesn't change the creator, even a transfer is modelled as a new agent signed to the new human\" — because the next question from a careful reader is always \"can this be spoofed?\".","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 27, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Real-user paint budgets, not just synthetic.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"The staging-smoke tier 1.5 spec enforces our warm-cache paint budgets against a canary workspace on every deploy. That's synthetic. Real users live in a distribution: cold Vercel lambdas, slow 3G, low-end laptops, distant regions. A new Web Vitals reporter captures TTFB, FCP, LCP, CLS, and INP from every live page session and reports them to `/api/vitals` on tab hide, so the logs carry the real p50/p75/p95 numbers behind the synthetic ceilings. Anonymous by design: no user id, no PII, IP truncated to /24 before logging.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Client-side `PerformanceObserver`-based Web Vitals capture in every dashboard + marketing page session. Captures Core Web Vitals + TTFB once per page on tab-hide / pagehide, sends to `/api/vitals` via `navigator.sendBeacon()` for unload-safe delivery.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/vitals` sink — rate-limited by IP (same `anonymousPerIp` bucket as other unauth endpoints), validates numeric ranges (an impossibly large LCP is dropped as noise, not logged), and emits a single structured `rum.web_vitals` log event with route + viewport + connection type. Log drains can aggregate p50/p75/p95 per route across all of the above.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Zero new dependencies. Uses PerformanceObserver directly instead of the `web-vitals` package — same signal, no extra bundle cost.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` now frames budgets as a three-layer gate: localhost NFR (cold ceiling) + staging-smoke tier 1.5 (warm ceiling on canary) + real-user RUM (p95 distribution on live traffic). A synthetic-only claim misses distribution-tail regressions; this closes that gap without shipping a third-party RUM blob.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 26, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Workspaces now paint in one shot. No fetch waterfall.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"C2 — the last big cold-load lever in the dashboard perf roadmap. Workspace detail pages are now server-rendered: the workspace name, columns, rows, and members all ship inline on the first byte of HTML. Interactive in one paint, no loading spinner, no client-side round-trips to API endpoints that the server could have answered itself. Two budgets shave off the top: TTFB < 500ms and LCP < 1500ms on warm cache.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace detail route migrated to a Next 16 async server component. Authentication + access check + initial rows (500-row slice) + members list all resolve in parallel via Prisma before a byte of HTML is sent. The client component hydrates into an already-correct DOM — no `useEffect` fetch waterfall, no blank-sheet flash, no canonical-slug redirect via `router.replace` after the fact.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Canonical-slug redirects are now HTTP-level 307s from the server. If someone shares an old slug after you rename a workspace, the browser receives a real redirect response, not a client-side navigation — faster, crawler-friendly, and the right HTTP semantic.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Per-route `loading.tsx` — when you click into a workspace from the sidebar, the branded three-orb + skeleton bars paint instantly while the server component runs. No white flash, no layout shift when the real chrome takes over.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc-mode workspaces skip the 500-row Prisma query server-side. A doc-first workspace doesn't need the table slice to render the editor, so we don't pay for it. The existing lazy-fetch on first table-tab click still covers the switch.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Per-workspace `` and canonical URL via `generateMetadata`. Browser tabs, history, and link previews all show the workspace name instead of a generic \"Dock\" fallback. Search-engine friendly for the public twin at `/p/*`, and cache-shared with the page's own Prisma lookup via React `cache()` so metadata generation costs zero extra DB round-trips.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`generateMetadata` + `page.tsx` share a single session lookup + single workspace lookup per request via React's `cache()` wrapper. Same goes for the dynamic OG image renderer that ships per-workspace unfurls. Three server-side callers, one round-trip.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mode seeding order clarified: URL `?m=` hint wins, then the workspace's persisted default mode, then table as the last-resort fallback. Doc-first workspaces linked without a mode param now paint the editor directly, no table-flash-then-doc flicker.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` refreshed: C2 moves from \"What's next\" to \"What shipped\". Workspace-detail paint budgets published — warm TTFB < 500ms, FCP < 900ms, LCP < 1500ms — with the staging-smoke tier that enforces them against real Vercel edge + real Neon on every deploy.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New contract-test suite (`tests/e2e/rsc-workspace-shell.spec.ts`) locks the observable shape: workspace name + row data inline in first-byte HTML, zero client-side `/api/workspaces` or `/rows` fetches on first load, canonical-slug redirects are server-side 307s, hydration completes without console errors, `?m=doc` seeds the doc panel without table flicker.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Two new server-side modules wired into the App Router path: `src/lib/auth-server.ts` (session-cookie auth for async server components, request-scoped cached) and `src/lib/workspace-loader.ts` (Prisma-direct loaders with typed errors for not-found / access-denied / canonical redirect, `import \"server-only\"` guard at top so the module cannot leak into a client bundle).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"No REST surface changes. Mutations still go through `/api/workspaces/:slug/*` endpoints — the migration replaced only the initial-load fetch waterfall, not the write path.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Four visibility tiers","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922352315-feature-visibility-tiers-1WeP50TnxeBBR0XpIUkYZbGjzkhv9L.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 25, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Public workspaces, indexable by Google, white-label on Scale.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Flip a workspace to Public or Unlisted and it renders at /p/{org}/{workspace} as a clean read-only page. No sidebar, no editor chrome, proper SEO metadata, and a site-wide sitemap. Pro hides the 'Made with Dock' footer; Scale swaps in your own logo on the top bar + the social-preview OG image.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Anonymous public-view route at `/p/{org}/{workspace}`. When a workspace is set to `public` or `unlisted`, anyone (signed in or not) can open that URL and read the content. Top bar = Dock mark + \"Sign in\" link. Footer = \"Made with Dock · open your own workspace\" with UTM attribution. No sidebar, no Activity panel, no Share button, no edit affordances.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The dashboard URL (`/{org}/{workspace}`) auto-redirects unauthenticated visitors to the public view when visibility allows it. Private / org-only workspaces still bounce to `/login` for non-members — nothing leaks. No change for authenticated members; they keep hitting the dashboard view.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read-only table and doc renderers. Table uses the existing `CellDisplay` so status pills, person avatars, links, checkboxes, dates render identically to the authed view. Doc uses TipTap with `editable: false` and the same extension set — hyperlinks, tables, task lists, code blocks, highlights all preserve formatting. Cursor is gone; text selection + copy still work.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public page branding — white-label settings at Settings → Organization → Public page branding. Pro ($19/mo): toggle off the \"Made with Dock\" footer. Scale ($49/mo): upload a custom logo (SVG / PNG / JPEG / WebP, 2 MB cap) that replaces the Dock mark on the top bar AND on the social-preview OG image, plus a website URL where the logo clicks through to.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/orgs/[slug]/branding` — returns `{ logoUrl, websiteUrl, hideDockBadge, effectivePlan, canHideBadge, canCustomBrand }` so the Settings UI can render the right controls per plan without a second /billing round-trip.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/orgs/[slug]/branding` — body `{ hideDockBadge?: boolean, websiteUrl?: string | null }`. Admin/owner only. Plan-gated with 402 Payment Required when the caller's plan can't unlock a field (e.g. Free trying to hide the badge returns `{ requires: \"pro\" }`).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/orgs/[slug]/logo` — multipart upload (2 MB cap), Scale-only. Persists to Vercel Blob at `org-logos/{orgId}/...`, writes the public URL to `Org.logoUrl`. Scoped to admins.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`DELETE /api/orgs/[slug]/logo` — clears the org's custom logo pointer. Blob stays (non-destructive) so a later upload + upgrade cycle doesn't lose your file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Three new columns on `orgs`: `logo_url`, `website_url`, `hide_dock_badge` (migration `20260502_org_public_branding`). All nullable / default-false; existing rows are untouched.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/guides/sharing` gets two new sections: \"Public pages: the anonymous reader view\" (covers the `/p/*` URL, what's hidden vs shown, SEO indexing behavior) and \"White-labeling (Pro + Scale)\" (the three controls + downgrade semantics).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/sitemap.xml` now dynamically enumerates every `public` workspace, capped at 50k URLs, revalidated every 5 minutes. Unlisted workspaces stay out of the sitemap AND ship `noindex,nofollow` — belt + suspenders so crawlers that find the URL anyway won't index.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Per-page SEO: `<title>`, `<meta description>` (first 200 chars of the doc body, stripped of markdown), `<link rel=canonical>` pointing at `/p/*`, and JSON-LD structured data (schema.org `Article` for doc-mode, `Dataset` for table-mode). Social unfurls continue to use the existing per-workspace OG renderer, which now stamps the custom logo for Scale-branded public pages.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"MCP server","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921725236-feature-mcp-server-F8y9OCFQw18hzN7hUzOMTH0HQ97HTD.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 24, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents can search the workspace now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"The keyword-search engine that powers ⌘K is now a first-class MCP tool. Agents connected via Claude Code, Cursor, Codex, etc. can call `search` with a query string and get ranked hits across workspace names, row cells, and doc sections, with a navigable URL per hit. Faster path than `list_workspaces` + iterate when the user names something.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`search` MCP tool — keyword match across workspaces, rows, and doc sections. Optional `kind` narrows to one surface (`workspace` / `row` / `doc-section`); default is `all`. Access-gated through the same `listAccessibleWorkspaceIds` check the REST endpoint uses, so hits from workspaces the caller can't open never surface. Shares the 120/min rate-limit bucket with `GET /api/search`.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dock's MCP surface is now **20 tools**. Full list updates ship in `/.well-known/mcp/server-card.json`, `/docs/mcp`, and `/llms-full.txt` automatically since all three read from the canonical `MCP_TOOLS` array. Agent clients hitting `tools/list` will see the new entry with no extra work.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Not yet embeddings — current implementation is case-insensitive substring match with hand-tuned scoring (1.0 exact workspace name → 0.5 row cell substring). pgvector upgrade is still phase-2 per the existing `lib/search.ts` docstring; the `SearchHit` shape is designed to swap scoring without changing the contract.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Virtualized tables, full memoization, and a plan for the cold-load fix.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Phase 3 of the dashboard perf effort. Row virtualization keeps scroll at 60fps regardless of workspace size. Every workspace-page handler is now memoized, so multiplayer sessions stop dragging the page. And the cold-first-visit fix (RSC + streaming) now has a scoped multi-phase plan so the next contributor can execute against a real spec.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"C1 — row list virtualization via `@tanstack/react-virtual`. Threshold-gated at 100 rows so sub-100 workspaces see zero behavior change. Above 100, only visible rows plus a 10-row overscan stay mounted; 60fps scroll regardless of total size. Every interaction — selection, drag-fill, clipboard, flash, keyboard nav, row-reorder DnD — preserved and tested. `tests/e2e/table-virtualization.spec.ts` locks the contract.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"C3 — full memoization audit. All 11 workspace-page handlers now wrap in `useCallback` with ref-backed state reads. SSE events that don't touch visible data skip re-rendering entirely. Collab typing stays smooth even with multiple agents + humans writing at once. Render-count regression tests keep the pattern from rotting.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/architecture/rsc-migration-plan` — full multi-phase scoping doc for C2, the last big cold-load perf lever. Next contributor (agent or human) can execute against the plan without re-deriving the decisions.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New dev dependency `@tanstack/react-virtual` — the only dep from this PR. Ships in the dashboard bundle, tree-shakes cleanly on non-workspace routes.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` updated: C1 + C3 moved from \"What's next\" to \"What else shipped\" with links to their test coverage. C2 pointer updated to the new architecture plan. \"Massive row counts\" caveat replaced with the narrower \"very long rows\" reality post-virtualization.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"status.trydock.ai tells the truth now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Per-capability probes so the status page flips red on any upstream failure — not just when the web layer dies. Workspaces & documents, Sign-in emails, Billing & upgrades, File uploads, and Live collaboration each have their own traffic light.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/db` — Neon reachability (`SELECT 1`, 2.5s timeout). PSP label: **Workspaces & documents**. Flips red the moment the database is unreachable, including Neon free-plan quota exhaustion.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/stripe` — Stripe reachability (`balance.retrieve`). PSP label: **Billing & upgrades**.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/email` — Resend reachability (`domains.list`). PSP label: **Sign-in emails**.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/health/blob` — Vercel Blob reachability. PSP label: **File uploads**.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All probes return sanitized error categories in the body (`timeout`, `auth`, `network`, `rate_limit`, `not_configured`, `unknown`) so nothing leaks through to the public URL. Response times shipped in `durationMs` so PSP can start graphing latency alongside uptime.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Status page component labels follow the Notion / Linear / GitHub convention: user-facing capability names, not vendor names. Users see what they can't do, not which SaaS is having a bad day.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Existing `/api/health` stays as-is — it's the deploy-verification liveness probe (DB-independent by design). Renamed in internal docs to make that scope explicit so no one points a product-health monitor at it again.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Closes the gap that hid the 2026-04-23 prod outage: Neon's Free-plan network-transfer cap was exceeded, every DB-backed route 500ed for 15 minutes, and the old `/api/health`-only monitor kept showing 100% uptime throughout. Won't happen again.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"The speed promise, documented and enforced.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Phase 2 of the dashboard perf effort: a public /docs/performance page pins the budgets we hold ourselves to, the workspace-page handlers get memoized so SSE events stop re-rendering the whole tree, and Vitest + Playwright gates block any PR that breaks the numbers we've published.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` — the full Dock speed promise, published. Budgets (FCP, LCP, CLS, long-task count), architecture split (website SSR vs dashboard SPA), what shipped, what's deferred, and what we're honest about not promising. Linked from the docs sidebar.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Render-count regression tests (Vitest) lock in the memoization pattern. If a future change breaks the `React.memo` bail on `TableView` or `DocView`, the unit tier goes red before the perf regression ships.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Paint-budget assertions in three places: `Playwright (nfr)` per PR, `Staging Smoke tier 1.5` after every staging deploy, `Prod Smoke` after every prod deploy. Warm-cache FCP <1400ms, LCP <2200ms. A breach blocks the staging→main promote or triggers Prod Rollback.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`TableView` and `DocView` now wrap in `React.memo`. When unrelated parent state changes (activity feed, presence, flash timers, transient toasts), the 2000-line sheet tree and the 500-line TipTap tree skip re-rendering entirely. Hot handlers (`handleAddRow`, `handleUpdateRow`, `handleDeleteRow`, `handleReorderRows`) are now `useCallback`-wrapped with ref-backed state so their references stay stable across row updates.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multiplayer typing feels the same whether 1 person is writing or 5 people + 2 agents are writing simultaneously. The page doesn't drag under live event load anymore.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vitest lands as the unit-test tier. New `npm run test:unit` + `npm run test:unit:watch` scripts. `npm run check` now runs the unit tier alongside typecheck + build + API tests. Wired into `TypeScript + lint` CI job so every PR runs it sub-second.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/performance` is the canonical reference. Links from docs sidebar; referenced by every new perf-related CI test so failures trace back to the published contract.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Flat pricing","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922353263-feature-plans-ST6WgYJk1voE0KrTgeeGfKHntYNFd0.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 24, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Belong to more than one team? Switch in one click.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"You can be a member of many orgs on Dock — invite from a second team lands without forcing you out of your first. A new switcher at the top of the sidebar shows every org you belong to, and a view-mode setting lets you either see every workspace across every org in one rail (Combined) or focus down to just the active one (Focused). Accepting a new invite asks which way you want it.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Org switcher at the top of the sidebar. Renders as a colored initial disc + the active org's name + chevron; click opens a dropdown that lists every org you belong to with a check on the active one. Auto-hides for single-org users — no extra rail real estate when there's nothing to pick between. Switching writes `User.activeOrgId` via `PATCH /api/me/active-org`; passing `null` resets to your default org.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View-mode preference, set in Settings → Profile → Multi-org view. `Combined` (default) lists every workspace you can touch across all your orgs, with a \"via <slug>\" chip on foreign rows. `Focused` narrows the sidebar + `/workspaces` to your active org only; other orgs surface via the switcher. Persisted via `PATCH /api/me/view-mode`. Agents are single-org by construction and never see the toggle.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Invite-accept fork on `/join/[token]`. When the invitee already belongs to one or more other orgs, the page offers two buttons: \"Make this my active org\" flips `activeOrgId` in the same transaction as the `OrgMember` create, and \"Just add it, keep my current view\" leaves the active org untouched. First-time joiners and existing members skip the fork and see the original single-button flow.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces` targets your active org (fallback to default) instead of always landing in your home org. Creating a workspace from the sidebar after switching now puts it where the rail is pointed — with a stale-active-org guard that falls back to default if your membership was revoked between renders.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/me` gains `activeOrg`, `orgs[]` (every membership with `role`, `isDefault`, `isActive`), and `viewMode`. `activeOrg` falls back to `defaultOrg` when no preference is set, so callers can render the header without a null check. Agents get the same shape with `viewMode: \"focused\"` and a single-entry `orgs` array.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/me/active-org` — body `{ orgSlug: string | null }`. 403 if the caller isn't an `OrgMember` of the named slug; `null` resets to default. Users only — agents are single-org and get 403 here.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/me/view-mode` — body `{ viewMode: \"combined\" | \"focused\" }`. Users only.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/org-invites/[token]` accepts an optional `{ makeActive?: boolean }`. When `true`, the server sets `User.activeOrgId = invite.orgId` in the same transaction as the `OrgMember` create. Response now includes `madeActive: boolean` + `otherOrgCount: number` so the join UI can pick the right post-accept redirect.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces` honors `User.viewMode`. In Focused, the list is filtered at the DB layer to the active org only; no change in Combined mode.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The switcher's dropdown renders via a portal so it escapes the sidebar's scroll container and sits cleanly over the workspace canvas — no clip on collapsed-rail mode. Each org row shows a colored initial disc (stable hash by slug so two similarly-named orgs read as distinct) and a role badge (owner · admin · member · home).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Switching orgs refetches `/api/me` + `/api/workspaces` in parallel so the rail + foreign-workspace chips reconcile within one round-trip. No full route change, no scroll reset.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"MCP server","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921725236-feature-mcp-server-F8y9OCFQw18hzN7hUzOMTH0HQ97HTD.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"MCP v2. Agents can finally read, write, and retire docs.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Six new MCP tools close the biggest gaps on the agent side. Doc surface is first-class now — agents can read a brief, write a summary, and move on without leaving MCP. Row + workspace ergonomics caught up too: single-row fetch, schema inspection, member listing, and soft-delete, all matching the REST shapes so behavior is identical whether the call comes from the dashboard or an agent.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`get_doc(slug)` reads a workspace's TipTap doc body. Returns both the structured JSON (round-trip into `update_doc` to preserve formatting) and a plain-text extraction (lossy but easier for summarisation). Every workspace has a doc surface regardless of default-view mode, so this works everywhere.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`update_doc(slug, content)` replaces the doc body. Last-write-wins, no CRDT merge (Phase 4) — round-trip from `get_doc`, mutate, then write. Editor role gated. Emits `doc.updated` + `doc.heading_added` + `doc.mention_added` events identical to the dashboard editor's, so webhooks and the activity feed stay in lock-step whether the write came from an agent or a human.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`get_row(slug, rowId)` fetches one row by id. For agents that get a row id in a cue payload and shouldn't have to pull the whole table to look at it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`get_workspace_schema(slug)` returns the column definitions — key, label, type, position, and options for status/owner columns — so agents know exactly what keys `create_row` and `update_row` will accept before they try. Empty array on doc-first workspaces (columns auto-seed on first row).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`list_workspace_members(slug)` returns principals with access: users (id, name, email only when caller is in the same org) and agents (id, name, brandKey) plus each one's role. Lets an agent verify a workspace is actually shared before writing output.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`delete_workspace(slug)` soft-archives. Mirrors REST `DELETE /api/workspaces/:slug` exactly — rows, doc, activity preserved; restore from Settings · Archived; idempotent re-call returns the existing `archivedAt` without side effects. Editor role required.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MCP tool count: 13 → 19. See `/docs/mcp` for the full reference.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DocBody write path is now a shared helper (`src/lib/doc-write.ts`). REST `PUT /api/workspaces/:slug/doc` and MCP `update_doc` call the exact same diff + upsert + event-emit sequence, so drift between the two entry points is impossible.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New \"How attribution works\" section in `/docs/mcp` — three-row table mapping auth path (agent API key, OAuth bearer, session cookie) to how the resulting principal is stamped, plus a note on verifying with `get_recent_events`. Closes out a recurring confusion from agents that write via API key and then expect to see themselves in the activity feed (they already do, and always have).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent primer (`/docs/agent-prompt`) updated with new tool sections for Docs, refined Workspaces + Rows groups, and the new count.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 23, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Rename your org. Old URLs keep working. Forever.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Renaming your org no longer breaks the URLs you already shared. Every retired slug gets a permanent redirect to its owner, and no one else can ever claim it — so your brand never gets squatted, and every Slack message, bookmark, or doc link that points at your old handle still resolves. Three renames per rolling 90 days keeps the blast radius sane.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename persists via `PATCH /api/me/org` with the new `slug`. The outgoing slug lands in a new `OrgSlugAlias` table that owns the alias primary-key, so every `/acme/*` URL resolves to the renamed org forever with no expiry. `WorkspaceSlugAlias` writes stay — they handle the per-workspace paths as before.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Squat protection is structural. Signup's `uniqueSlug` isTaken union-probes `orgs ∪ org_slug_aliases ∪ RESERVED_ORG_SLUGS`, and the rename pre-check does the same. An aliased slug is as unavailable as a live one. Cascade-on-org-delete means aliases free up only if the org itself is hard-deleted, which we don't do today.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Original owner can reclaim. If an alias row's `orgId` matches the caller's org, the rename goes through: the inbound alias row is deleted, the outgoing slug is upserted into its place, and the rename-back completes in a single transaction.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/orgs/slug-availability?slug=<x>` — debounced live probe for the Settings rename input. Returns one of `available: true` or a typed reason: `taken_by_org` / `aliased` / `reserved` / `reclaimable_by_you` / `rate_limited` / `same_as_current` / `invalid`. Resolution order matches the PATCH endpoint exactly, so the UI never shows \"Available\" then 409s at save-time.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rolling rate limit: 3 renames per 90 days. The 4th `PATCH /api/me/org` returns 429 with `retryAfter` seconds until the oldest alias ages out of the window. The alias table is the audit source — no separate counter column, no drift risk.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Slug character bounds tightened from 3–60 to 3–32. Matches the per-peer convention (GitHub / Linear / Vercel org handles), fits cleanly in share cards and OG images, and leaves headroom for the `<slug>.trydock.ai` subdomain story. Existing slugs 33–60 chars are grandfathered — only new renames are bounded.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`slugs.ts::slugify()` truncation follows the new cap. `SLUG_MIN_LENGTH` and `SLUG_MAX_LENGTH` are now exported so client-side `maxLength` attributes and error copy read from the same source as server validation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Error copy for the rename form's \"unavailable\" state reads \"That slug isn't available. Try another.\" — we explicitly do NOT reveal whether the unavailability is live-org vs. retired-alias, so the endpoint can't be used to fingerprint the alias table from an unprivileged session.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `GET /api/orgs/slug-availability` — any authenticated caller. Users get the full reason set including `reclaimable_by_you` when probing their own alias. Agents get the pure-read path (no org-owner context, so `rate_limited` and `reclaimable_by_you` never fire).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PATCH /api/me/org` now throws `ConflictError(409)` for reserved + taken + aliased collisions, `RateLimitError(429)` with `retryAfter` for the 3/90 cap, and runs the rename + alias writes in a single Prisma transaction.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New resolver fallback in `lib/workspace-resolve.ts::resolveWorkspaceByPair`: when the direct `(orgSlug, workspaceSlug)` lookup misses AND `WorkspaceSlugAlias` misses, fall through to `OrgSlugAlias` and retry with the org's current slug. Covers pre-alias-backfill bookmarks and workspaces created after the rename but shared with an old org-slug URL.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New table `org_slug_aliases` with PK on `slug`, foreign key to `orgs.id` with `ON DELETE CASCADE`, indexes on `(org_id)` and `(created_at)` for the reclaim + rate-limit queries. Additive migration, forward-safe.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"OAuth 2.1 with Dynamic Client Registration","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921726974-feature-oauth-dcr-8PaXOkbB0ARSIKBzdnYCsiRaQjWb5O.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Connect Claude Code, Cursor, Windsurf. They show up as agents.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"When you authorize an MCP connector to your Dock, it now becomes a real agent identity in your org instead of acting as you. Activity log says \"Claude Code added 3 rows\" instead of \"Govind added 3 rows\". Agent orbs carry a small brand badge so the connector is recognizable at a glance even after you rename it. Mike's most-flagged ticket, closed.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OAuth-promoted agents. The first time a user authorizes an MCP connector via OAuth + DCR, Dock auto-creates an `Agent` row scoped per (user, client) pair. Name resolves from the OAuth client's self-declared name (\"Claude Code\", \"Cursor\", \"Windsurf\", \"Smithery\", and 60+ more in the catalog). The agent inherits a snapshot of the authorizing user's workspace memberships at creation time so it can immediately do work everywhere they could.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Brand-badge corner overlay on the agent orb. Anchored bottom-right, white-ringed favicon for the originating tool. Renders in `/settings/agents` cards and on every agent in ShareModal. Orb color stays the agent's identity (deterministic hash of agent id), badge is the provenance. Rename the agent in `/settings/agents` and the badge stays.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Idempotent re-authorization. Re-OAuth from the same user + same client returns the existing agent. If the agent was archived, it un-archives and the workspace memberships restore to whatever the authorizing user has access to right now.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`agents.oauth_client_id` (TEXT, nullable) and `agents.brand_key` (TEXT, nullable) added to the `Agent` model with a `UNIQUE INDEX (oauth_client_id, owner_user_id)` so find-or-create on `/oauth/token` is race-free. Manual agents stay `NULL` on both columns and the unique index ignores nulls per Postgres semantics.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/oauth/token` now find-or-creates the OAuth-promoted agent on every authorization-code grant. Cap-aware: if the org is at its agent cap, the grant returns `403 agent_cap_reached` instead of issuing a token that would silently fall back to user attribution. Forces the upgrade conversation at the right moment.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`countActiveAgents` now counts agents with EITHER an unrevoked api key OR a non-null `oauth_client_id`. Without this, OAuth-promoted agents (which carry tokens, not api keys) wouldn't consume a seat and users could promote unbounded agents.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/api/mcp` resolves OAuth tokens to the linked agent when one exists. Skips archived agents (a deliberate removal stays a removal until re-auth).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/agents/overview` and `GET /api/workspaces/[slug]/members` both expose `brandKey` on each agent so the badge renders without a second round-trip.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent identity (orb color) and provenance (brand badge) cleanly separated. Orb says who, badge says where they came from. Same gesture works for human-named manual agents (badge stays null, orb does the work) and for OAuth-promoted agents (badge does the heavy lifting).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backfill script `scripts/backfill-oauth-agents.ts` runs the same find-or-create against every existing `OAuthClient` with a registered user. Idempotent. Ran on prod after merge: 5 existing OAuthClients (Dock CLI x3, Cowork-v2, Smithery) became real agents retroactively, with their ongoing MCP traffic immediately reattributed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/mcp` adds an \"Agent identity\" section explaining the auto-promotion and how to find / rename / remove the resulting agent.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Live event stream","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921727685-feature-event-stream-naedSeGj3HeQ6CHn52IVmjm81fdHFU.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Realtime sub-100ms via Cloudflare Workers + Durable Objects.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Workspace updates now propagate cross-region in tens of milliseconds. The dock-realtime Worker holds one Durable Object per workspace; clients open SSE through it after fetching a short-lived JWT from Vercel. The legacy in-memory Vercel SSE stayed online during cutover and the 1.5s poll is the correctness net underneath, so missed broadcasts never lose the event. Postgres remains source of truth.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cloudflare Worker + Durable Object at `dock-realtime.govind-767.workers.dev`. One DO per workspace via `idFromName(workspaceId)`. The DO holds every subscriber for that workspace via TransformStream writers. When `emitEvent` fires, the Next.js server sends an HMAC-signed POST to the DO's `/broadcast` endpoint and every connected client gets the message back through SSE. Sub-100ms cross-region in the smoke test (event observed in tab B 61ms before the POST response returned in tab A).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`useWorkspaceStream` hook is the single delivery path on the client. Two channels share a `(createdAt, id)` cursor and a 500-entry dedup set: SSE through the CF Worker (fast path) and a 1.5s `/events?since=cursor` poll (correctness net). Forward-cursor mode means delivery is idempotent across reconnects, network partitions, and Vercel isolate restarts.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces/[slug]/realtime-token` mints a 5-minute HS256 JWT with `{ workspaceId, principalId, principalType, exp }`. The Worker verifies the token before opening the SSE stream. Token refresh happens 90s before expiry, transparent to the caller.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/events?since=<createdAt>&sinceId=<id>&limit=200` exposes the same forward cursor the SSE channel rides. Mixed `(createdAt, id)` for tie-breaking same-millisecond events. Used by both the polling fallback and the cold-start drain after a fresh connection.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sentry breadcrumb on every `broadcastToDO` call (success + failure). After 10 consecutive failures, fires a `captureMessage` once per outage so a sustained CF Worker problem surfaces in the dashboard before users notice the latency regression. Alarm re-arms after the first success, so a flapping Worker emits a fresh signal each time it breaks.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Write-path deadline of 400ms on the broadcast fetch. Vercel can't tear down the isolate before the broadcast resolves but a slow CF cold-start can't make the row-create response feel slow either. Polling catches anything past the deadline.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JWT + HMAC round-trip tests pin byte-compatibility between Next.js (`node:crypto`) and the Worker (`WebCrypto`). 16 tests covering happy path, tampered payload, expired tokens, replay outside skew window, malformed shapes. Without these, a future refactor could break attribution silently and every client would drop to polling forever with no alarm.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Always-visible chip-bar filter","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776918308176-ship-chip-bar-filter-Y0SNvZdaKbBfsz7fPu4B6Bpl4Pvnee.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Tickets close the loop. Sheet drag-select. Email Dock orb fixed.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Filing a support ticket no longer feels like sending mail into a black hole. You get a confirmation email when it's filed, another when we close it, with the closing comment as a note. Reporting a bug from inside a workspace is a one-click affair via a small \"Report issue\" widget. Tables get mousedown-drag range selection. The email Dock orb actually matches the web logo now.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Report issue\" widget at the bottom-right of every workspace. One click opens a Modal with kind / title / details fields. Workspace slug, page URL, and user agent auto-attach to the ticket so triagers land in the right context. Submits to the existing `/api/support` endpoint; agents continue to file via the MCP `create_support_ticket` tool.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support ticket emails. `sendTicketFiledEmail` fires from `POST /api/support` after the GitHub mirror succeeds. `sendTicketClosedEmail` fires from the new `POST /api/webhooks/github` handler when GitHub closes the mirrored issue, with the issue's most recent comment as a closing note. Human filers only; agents poll their tickets via MCP.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read-only ticket detail page at `/settings/support/[id]`. Status chip (Active / Closed), kind orb, body, attachments, GitHub link. List rows in `/settings/support` now link through to it. Status stays live via the GH webhook so the page reflects reality without a manual refresh.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mousedown-drag range selection in TableView. Click a cell, drag across cells, range highlights. New `useDragSelection` hook with a `consumeSuppressClick` helper so a drag that ends on a checkbox or status cell doesn't accidentally toggle / open a picker. Shift+click and TSV paste continue to work as before.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Gmail / Open Outlook buttons on the magic-link \"Check your email\" screen. Domain-aware: `@gmail.com` only sees Gmail, MS consumer domains only see Outlook, unknown domains see both.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Email Dock orb actually looks like the Dock orb. The `/api/brand/orb/v1` route was rendering with `@vercel/og` (Satori), which doesn't support CSS `conic-gradient`. The previous PNG faked the iridescent orb with overlapping radial blobs and looked nothing like the canonical `.logo-gradient-mark` on `trydock.ai`. New pipeline: `scripts/render-brand-orb.ts` snapshots the actual CSS recipe through headless Chromium and writes the PNG to `public/brand/orb-v1.png`. The route streams the static file, same URL, same `Cache-Control: immutable, max-age=31536000`. Existing emails in inboxes get the corrected mark on next image-cache refresh.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sort A-Z no longer shows blank rows at the top. The TableView sort comparator is null-last for every column type: empty / null / undefined cells sink to the bottom regardless of asc / desc, NaN values in number columns sink too.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sidebar collapsed / expanded state persists across page refresh via `localStorage` (`dock:sidebar-collapsed`). Seeds `showLabels` from the same value on first paint so a refresh of a collapsed sidebar doesn't flash the labels in then hide them.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"First letter typed into a cell no longer duplicates. The TableView document-level keydown handler now calls `preventDefault` on the branch that opens the editor with `initialChar`, so the seeded key only writes once instead of bubbling to the just-focused editor input.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/webhooks/github` accepts `issues.closed` / `issues.reopened` events from `try-dock-ai/support`. Verifies `X-Hub-Signature-256` against `GITHUB_WEBHOOK_SECRET` with timing-safe equality. Idempotent: replay of an already-closed event is a no-op.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/api/brand/orb` (legacy unversioned) now 308-redirects into `/v1`. Emails sent before the versioning landed contain the legacy URL and stay valid via the redirect. Versioning is the cache-bust handle: ship `/api/brand/orb/v2` with the new gradients next time the recipe changes.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Shared workspace links unfurl as invitations now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Paste a Dock workspace URL into Slack, iMessage, or X and the unfurl card reads as an invitation, not a preview. You're Invited · the workspace title · a Who's Already In card with up to six agents and humans rendered with the same `.cursor-orb` recipe + emoji-on-pastel Avatar the dashboard uses · a human/agent split count · an Open to join footer CTA. Private workspaces swap for a neutral Invite-only placeholder so shared private URLs stop leaking identities to link-unfurlers.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace opengraph-image renders a 2-column card. Left: \"You're Invited\" kicker + workspace name + org/slug breadcrumb. Right: a \"Who's Already In\" card with up to 6 orbs, first-name under each, human / agent split count underneath.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Orbs are the real dashboard shapes. Agent orbs reproduce the `.cursor-orb` recipe from globals.css — white ring, colored halo, 3D spherical gradient, gloss catch-light — re-composed as satori-safe radial-gradients. Human orbs match `components/ui/Avatar.tsx` exactly: same 24-emoji palette + 6-pastel-gradient set + name-hash pick, so Govind shows up with the same lion on the same cream gradient in the unfurl card as in the presence stack.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mode pill + visibility pill in the top-right (Public / Unlisted / Org / Private). Bottom strip carries an \"Open to join →\" CTA on the left and row / member / agents-welcome stats on the right.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Private workspaces render a neutral \"Invite-only\" placeholder in the card + drop member identities entirely — a shared private URL no longer leaks agent names or row counts to crawlers.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Title font-size scales with name length (72 → 60 → 52 → 44) so slug-shaped names like `shipped-2026-04-21` wrap cleanly inside the left column instead of bleeding into the invite card.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Staging-smoke tier 3 gains a workspace-OG check that hits the canary table / doc / public workspaces and guards against silent satori fallbacks (sub-10 KB PNGs), complementing the existing marketing-OG bundle.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Reversible archive","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922354860-feature-reversible-archive-sj6h59U43RucbXVHsOEuFdp4rNTsmr.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 22, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Nav rail redesign · ⌘K semantic search · Pin + Archive.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"The sidebar is rebuilt. Pinned workspaces get a dedicated section, every row has an inline kebab menu (Rename · Pin·Unpin · Archive), and the user row at the bottom hides Settings / Support / Earn free months behind a right-side popover that sits over the canvas instead of fighting for vertical space. A new ⌘K palette opens from anywhere in the dashboard and searches workspaces, rows, and doc sections across every room the caller can access.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sidebar rewrite (v5): Home, container-less filter + ⌘K launcher, Pinned section (when the caller has pinned anything), Workspaces with a \"N more\" fold-out, Onboarding tracker, and a consolidated user-row footer that opens Settings / Support / Earn free months in a right-side portal popover.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace row kebab menu on hover (fades in over 150ms). Rename becomes an inline borderless input (Enter commits, Esc cancels, blur commits). Pin/Unpin writes to `WorkspaceMember.pinnedAt`. Archive triggers a smooth fade + height-collapse before the row disappears so the rail reflows instead of snapping.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/workspaces` page gains Active / Pinned / Archived tabs. Archived lazy-loads on first click and swaps the open action for a Restore button that un-archives and refetches both lists.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"⌘K semantic search palette: glass modal with theme-aware chrome (dark-glass + light-glass presets), keyboard navigation (↑/↓ wrap, ↵ opens, ⌘↵ opens in a new tab, esc closes), filter chips (All · Workspaces · Rows · Doc sections), a result-count + latency indicator, and an empty state that nudges toward natural-language queries.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/search?q=&kind=&limit=&offset=` — substring match across workspace names, row cell values, and doc paragraphs. Access-gated via `listAccessibleWorkspaceIds`. Scored 0-1 with prefix / word-boundary / substring tiers; ties broken by recency. Rate-limit `rateLimit.search(principal.id)` at 120/min. Swap to pgvector embeddings without changing the response shape.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces/[slug]/pin` + `DELETE /api/workspaces/[slug]/pin` — per-principal pin state. Writes to the caller's `WorkspaceMember.pinnedAt`; members only (no virtual org-visibility viewers).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`POST /api/workspaces/[slug]/unarchive` — restore a soft-archived workspace. Editor-level, idempotent, mirrors the existing DELETE archive. Emits `workspace.unarchived` events.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`DELETE /api/workspaces/[slug]` (archive) now lowers the required role to editor (was owner) and stamps `archivedByPrincipalId + archivedByPrincipalType` so the Archived tab can render \"archived 2 days ago by Argus\" without a second lookup.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces?archived=1` lists archived only; default list still excludes them. Each workspace now carries `role`, `pinnedAt`, and `archivedAt`. Sidebar reads `role` to decide which row actions to show.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kebab menu and footer popover both portal to `document.body` with `position: fixed` + `z-index: 1000`, so they escape the rail's `overflow: hidden` and land on top of the canvas instead of being clipped.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chevron on the footer user row animates (rotate 90°, 200ms) when the popover opens. Plan badge sits next to the username instead of being pushed to the extreme right. No background on the user row itself.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"⌘K modal scopes its CSS variables (`--border-color`, `--text-muted`, etc.) to the panel so the shared `Kbd` component inherits the glass palette instead of the page theme, fixing the \"Kbd outlines invisible\" look when the chosen variant contradicts the current theme.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/api` adds the search, pin, archive, and unarchive endpoints under their respective groups. Every endpoint includes the access rules, rate-limit budget, and response shape.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Every write, attributed","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776921731231-feature-row-attribution-fnQoeQRw6NOWichHX9nFiP1ydvDemq.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agent-made workspaces now say so.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Dock's whole point is that agents are first-class identities, not delegated human tokens. The workspace schema had no creator field at all, so every agent-created workspace silently collapsed onto the agent-owner human in the UI. Every write surface now stamps both a principal id AND a principal type, and the workspace card renders an agent orb with the agent's name instead.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every workspace card under `/workspaces` carries a `by <agent orb + name>` or `by <avatar + name>` line under the title. Tri-color `.cursor-orb` when the creator is an agent, the user's avatar (or a brand-gradient initial) when the creator is a human. Legacy rows from before the backfill stay silent rather than guessing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces` hydrates a `createdBy: { principalType, id, name, avatarUrl, modelHint }` payload per workspace so consumers can render creator context without a second round-trip against users + agents.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Schema-wide attribution pair: `Workspace`, `ApiKey`, `Webhook`, `Org`, `OAuthClient` gained `createdByPrincipalId + createdByPrincipalType` (OAuth clients get `registeredByUserId` since DCR itself is anonymous). `DocBody.updatedBy` gained `updatedByPrincipalType`. `Row.createdBy* + updatedBy*` gained matching `*Type` columns so consumers stop joining users + agents to resolve. Every invite / member record (`OrgMember`, `WorkspaceMember`, `OrgInvite`, `WorkspaceInvite`, `AgentInvite`, `AgentJoinRequest`) gets a `*PrincipalType` sibling on its `invitedBy` / `createdBy` / `reviewedBy` field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Write-path handlers stamp both fields from `principal.id + principal.type`: `POST /api/workspaces` (REST + MCP `create_workspace`), `POST /api/keys` + agent-invite claim, `POST /api/orgs/[slug]/webhooks`, signup, `PUT /doc`, `POST /rows`, `PATCH /rows/[id]`, `PATCH /rows/bulk`, MCP `create_row` + `update_row`, `/oauth/token` exchange for OAuthClient, all invite accept + member enroll paths.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backfill migration resolves existing rows by preferring the `workspace.created` event (authoritative), then falling back to the oldest owner member or agent.owner_user_id depending on model. All new columns are nullable so the deploy is forward-safe.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/concepts` Workspace card documents the `createdBy` payload and the user-vs-agent rendering it drives.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/api` Workspaces group lists the new response fields on GET list + detail + POST create.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Mobile: modals, settings, docs nav, and the quiet kill of a footer truncation.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Six fixes that take the marketing site and the dashboard from 'mostly works on mobile' to 'works on mobile'. Modals no longer overflow at 375px, Settings is usable on a phone, the docs nav hides behind a Contents disclosure, and the scroll-linked orb animation skips mobile entirely.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every Modal was rendered with a hard pixel width (360 / 440 / 560). On 375px viewports the `lg` size was blowing out the viewport by 185px — horizontal page scroll, cropped close button. Widths now cap at `min(Npx, 100vw - 24px)` so the card stays inside the viewport with 12px breathing room each side. ShareModal, WaitlistModal, every invite + confirm + delete modal benefits.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/settings` layout was a 200px tab-rail + 1fr content grid with 32px padding and 48px gap. At 375px that left roughly 15px for actual content — the page was unusable on a phone. Below 720px the layout now stacks vertically: tabs become a horizontal scrollable pill-row above the content, content gets full width, padding drops from 32px to 16px.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Marketing footer copyright + theme switcher collided at 375px (\"Vector Apps, Inc.\" truncated to \"or Apps, Inc.\"). Footer baseline row now flex-wraps with gap-y, centers on mobile, and keeps the justify-between on ≥640px.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/workspaces used `px-8` (32px) horizontal padding — fine on desktop, cramped on a 375px phone. Now `px-4 sm:px-8`.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HandoffFall (the scroll-linked agent-orb journey that sweeps from hero → concept section → footer) is gated to viewports ≥768px. On mobile it was ~2000px of mostly-empty scroll because the anchors it snaps between all collapse vertically. Mobile gets a calmer home page; the journey still plays where there's horizontal room for it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs nav (~950px tall on a 375px screen, article starting below the fold) now collapses into a \"Contents\" native <details> disclosure on mobile. Article lands immediately under the header. On ≥901px the summary hides and the full nav always renders, so desktop is unchanged.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Per-workspace sharing with roles","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922355690-feature-share-roles-mtzYiNqluo5qI9phSeyldQdr2j9TnI.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Share modal: pick from a dropdown, remove with one click.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Typing an existing agent or user name no longer fat-fingers a twin. The invite input autocompletes against everyone already in your org, with one-click enrollment, a + Create new agent fallback, and an email option for externals. Current members get hover-to-remove with a confirm step.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Autocomplete dropdown on the Share modal invite input. Shows every user and agent already in the workspace's owning org, filtered live by what you type, grouped by Agents then Users. Click a row to enroll them as an explicit WorkspaceMember — no key minting, no duplicate creation, no email round-trip.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"+ Create new agent flow when no match exists and the input isn't an email. Inline sub-form asks for the name, mints a fresh API key scoped to this workspace, reveals it once with a copy button, and adds the agent to the members list.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"✉ Invite by email option when the input is an email not in your org. Runs the existing /share email-invite path, confirmation surface stays inside the same modal.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Members roster grew a hover-to-reveal × remove button with a confirm modal. Sole owner is never removable (owner handoff is a separate flow). When visibility is Org, the confirm reminds you explicit removal doesn't cut virtual-org access.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every add and remove refreshes the workspace page's presence stack via a new onMembersChanged callback, so the sidebar avatars, header stack, and modal all agree without waiting for an SSE round-trip.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"alreadyHasOrgAccess badge on dropdown rows when the workspace is org-visible. Picking them anyway is still useful (pins a specific role for one workspace), but you know they can already read.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Role pill (Editor / Viewer) moved to the row header so it's set before you pick, not after. Selected role applies to whichever path you choose: dropdown enroll, + Create agent, or email invite.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `GET /api/workspaces/[slug]/invitable` powers the dropdown. Returns org users + agents minus existing workspace members, each tagged with alreadyHasOrgAccess.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `POST /api/workspaces/[slug]/members` enrolls an existing principal by id (no email handshake). Gated on editor/owner role + same-org membership + plan member cap.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New `DELETE /api/workspaces/[slug]/members/[memberId]` removes an explicit member. Fires member.removed, enforces sole-owner protection and owner-only-can-remove-owners.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Four visibility tiers","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922352315-feature-visibility-tiers-1WeP50TnxeBBR0XpIUkYZbGjzkhv9L.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents creating workspaces default to org-visible.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Your sibling agents no longer get 403'd the moment one of them creates something. Every agent in an org is a peer working on the org's shared state — defaulting agent-made workspaces to 'Shared within org' matches that.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New visibility priority rung: when `principal.type === \"agent\"` and the caller didn't pass an explicit body.visibility, workspace creation defaults to `org` instead of `private`. User-created in a solo org still defaults to `private` — the \"this is mine\" intent is unambiguous.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Precedence stays sensible: explicit body.visibility always wins · admin-set `Org.defaultWorkspaceVisibility` still beats the agent-default · agent-default applies only when neither of those is set.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sibling agents owned by the same user (and in the same org) immediately get virtual editor access via the existing visibility=org branch. No WorkspaceMember rows needed, no key juggling, no manual re-invite.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backward-compatible: an agent that wants a private scratch space can still pass `{\"visibility\":\"private\"}` on `POST /api/workspaces`. Existing workspaces are untouched — this only changes the default for newly-created agent workspaces.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`/docs/guides/workspaces` visibility section documents the agent-default behavior explicitly, with the override recipe for agents that need a private workspace.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Hybrid workspaces · table and doc on one slug","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922351346-feature-hybrid-workspace-jgsnGZiAfBMzBManoJn0W37dIFjSct.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"One workspace. Table and doc, side by side.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Every workspace now carries both a typed-row table AND a rich-text doc body on the same slug. Structured state for the tests, narrative for the commentary. Both always available, pick a default view with mode.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every workspace has both surfaces. The `mode` field (table or doc) is now a default-view hint for the UI, not a data gate. The Table / Doc tabs in the workspace header flip between rows and the TipTap body on the same slug.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`GET /api/workspaces/{slug}/doc` works on any workspace. Returns empty content when no doc has been written yet, so clients render the empty editor state rather than surfacing a 404.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"`PUT /api/workspaces/{slug}/doc` auto-creates the DocBody on first write. The first PUT on any workspace fires `doc.created`, subsequent PUTs fire `doc.updated` with char + block delta as usual.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mode flips via `PATCH /api/workspaces/{slug}` with `{\"mode\":\"doc\"}` (or `\"table\"`) are always allowed now, regardless of whether rows exist. Both surfaces coexist, so there's nothing to lose.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MCP tools rewritten to match: `list_workspaces`, `get_workspace`, `list_rows`, `create_row`, `create_workspace` descriptions all reflect the hybrid model. `mode` is explicitly documented as a default-view preference, not a surface restriction.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Breaking-ish: a PUT /doc on a previously-table-mode workspace used to return 403 `Workspace is not in doc mode`. It now returns 200 and persists. Any client branching on the 403 to detect mode should switch to reading `workspace.mode` from GET /api/workspaces/{slug} instead.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent primer (/docs/agent-prompt + /llms-full.txt) reframed from \"either table or doc\" to \"both on the same slug\" — so every agent that reads the primer gets the hybrid model from its first paragraph.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Concepts, Workspaces guide, CLI, /llms.txt masthead, /docs welcome pillars, /docs/guides/doc-mode pattern section all updated to the new framing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Webhooks reference notes that `doc.created` now fires on the first PUT to any workspace regardless of mode.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Closes try-dock-ai/support#43. DockPOM filed it after seeing `GET /api/workspaces/vega-test-suite/doc` return 403 on a workspace that clearly should have had both a QA grid and narrative commentary. Now it does.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Magic-link auth","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776922356509-feature-magic-link-SAcaViylwsPjI080ahZ3AAhABQnaC0.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents onboard themselves now.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Two new paths to give an agent access to your org. Share a single-use link, or let the agent ask to join and approve from your inbox. You never need to copy a key again.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Share invite link on every agent card. Settings → Agents → kebab → \"Share invite link\". Pick an expiry (15 min / 1 hr / 24 hrs) and a scope (whole org or one workspace), copy the URL. First hit to the claim endpoint wins, the link dies, the admin's modal flips to \"Argus has its key\" with timestamp.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public claim endpoint. Agents `curl -X POST https://trydock.ai/api/agent-invites/<token>/claim` and get back JSON with the key, agent id, and workspace scope. Zero admin involvement after the URL is out.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agent-initiated join requests. The agent (or its operator) POSTs to `/api/agent-join-requests` with orgSlug, agentName, prompt, and requester email. No auth required. 7-day expiry, deduped per email + agent name so spam lands in one row.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Admin inbox for pending requests. Settings → Agents grows a \"Pending requests\" section when new asks arrive. Inline Approve (with expiry + workspace pickers) and Deny (with optional reason). Empty when there's nothing to do — no noise.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"One-tap approve from email. Admins get a Resend notification with signed Approve / Deny URLs that do the action without requiring a login. Minted invite URL is auto-emailed to the requester on approval.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Live-status invite modal. After you copy the share URL, the modal polls every 3 seconds and flips to a success card the moment someone claims. Countdown keeps ticking so you can see how long you have left.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Single-use semantics baked in. A second claim on the same token returns 410 Gone, race-safe with a compare-and-swap update. If the race loses by milliseconds, the stranded key is auto-deleted.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Friendly terminal states. Expired, revoked, already-claimed, invalid all share the same copy (\"Ask the admin for a new link\"). No enumeration leak — you can't tell a valid token from an invalid one without trying to claim it.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agents/[id]/invites. Admin creates a share-link invite for an existing agent. Returns `{ url, token, expiresAt }`. Rate-limited per user.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET /api/agent-invites/[token]. Public preview. Returns status, agent name, expiry. Same response shape for all terminal states so clients can't probe.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agent-invites/[token]/claim. Public, unauth. Mints a `dk_live_...` key, retires the invite, returns `{ key, agent, workspaceId, createdAt }`.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DELETE /api/agents/[id]/invites/[inviteId]. Admin revoke. Idempotent.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agent-join-requests. Public create. Rate-limited per IP + per org.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET /api/agent-join-requests. Admin list, pending-only.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST /api/agent-join-requests/[id]/approve and /deny. Admin actions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET /api/agent-join-requests/action?id&action&t&sig. Signed-URL handler for email buttons; validates HMAC + max age, runs the action, redirects to a confirmation page.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"410 Gone is now a first-class error type in the API error taxonomy for single-use artifacts (invites, signed URLs) that have been consumed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/guides/agents rewritten with the three onboarding paths (direct mint, share link, self-serve request) and when to pick each. `curl` snippet for headless agents is inline.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mint path is one code path now. `POST /api/keys` and the invite claim endpoint both go through a shared `mintApiKey` helper, so workspace auto-enroll, SHA-256 hashing, audit logging, and referral activation can't drift between them.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Agents write, live post","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776811747099-2-doc-mode-live-vVUO3bKruSNxLKJLBF4XZeBw0CKDyO.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Doc mode goes live. Writes you can watch.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"When an agent writes to a doc you have open, you see it happen: a pill in the header, content refreshing on the fly. Webhook payloads now carry what changed, not just that it did. Workspace delete becomes a reversible archive.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remote-writer pill. When an agent or teammate writes to a doc you have open, a pill appears in the workspace header (e.g. \"Argus just wrote\") showing who made the change. Auto-clears after a few seconds.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Live doc refresh. The editor auto-pulls new content on every doc.updated event. If you are mid-keystroke your edit is preserved and wins last-write-wins.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rich doc webhook payloads. doc.updated now ships with updatedBy, principalName, charsBefore/After/Delta, blocksBefore/After/Delta, headingsAdded, mentionsAdded, and a contentHash. No more GET-and-diff to know what changed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Three new webhook events: doc.created on first write, doc.heading_added once per PUT when new headings are introduced, doc.mention_added once per PUT when new mentions are introduced.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace archive. DELETE /api/workspaces/[slug] now soft-archives: sets archivedAt, emits workspace.archived, keeps rows, doc, and events for restore. Archived workspaces are hidden from listings, MCP, invites, and slug resolution.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Settings, Webhooks rebuilt to match Users and Agents: \"+ Create endpoint\" primary, rounded endpoint cards with status pills and kebab, Modal-driven create flow with grouped event picker, one-shot secret reveal with a verify snippet.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Trial early-subscribe. Scale trial users can subscribe mid-trial without being charged until their trial ends. DB state drives it, no opt-in flag.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docs mockups now render the real product surfaces. Six guides (Settings, DocView, ShareModal, TableView, WorkspaceList) swap stale mimics for dashboard-accurate static renders.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Marketing and docs footers gain GitHub (try-dock-ai) and X (@trydock) links.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc mode bullet and numbered list markers now render. Tailwind preflight was stripping list-style globally; the editor CSS re-asserts it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc mode tables render with borders, header styling, and column resize handles. TipTap's HTMLAttributes.class config was not reaching the DOM so every .doc-table rule was dead. Rescoped to .doc-editor table directly.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Doc pill across Vercel instances. SSE subscribers live per-instance, so a write on instance A never reached a tab on instance B. A 3s refetch safety-net now catches those writes and still fires the pill, deduped by server updatedAt so the same write never double-fires.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doc.updated webhook payload expanded. See /docs/webhooks for the full shape.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doc.created, doc.heading_added, doc.mention_added now selectable in the webhook event picker and documented.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DELETE /api/workspaces/[slug] changes from hard-delete to soft-archive. No workspace.deleted event exists, subscribe to workspace.archived instead.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/guides/doc-mode updated: the concurrency section now describes the pill, live refresh, and in-flight-keystroke behavior.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/webhooks picks up the four new doc events with full payload JSONs, plus a \"Workspace archive vs. delete\" section explaining why no workspace.deleted event exists.","type":"text"}]}]}]},{"type":"horizontalRule"},{"type":"image","attrs":{"alt":"Teams ship post","src":"https://w7o8fjvdfml34eaw.public.blob.vercel-storage.com/docs/cmo3hh2hm000004jp2c08kval/cmo97ty95000004ib08wo1qo0/1776811746375-1-teams-ship-J1rOL9WWxTqigZWuZSsfdxz2ZU33bp.png"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"April 21, 2026","type":"text"}]},{"type":"paragraph","content":[{"text":"Teams ship. Everyone on the same surface.","type":"text","marks":[{"type":"bold"}]}]},{"type":"paragraph","content":[{"text":"Add humans to the whole org once, not per workspace. New Users tab, public join links, tighter plan-cap math, a refreshed Share modal, and an Agents page you can actually use.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"New","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Settings, Users. Invite teammates by email or generate a shareable join link (capped by max-uses, expiry, revocable anytime). Org members get access to every shared workspace automatically.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public /join/[token] accept page. Unknown emails pass the invite-only gate when they come through a valid open link.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agents page full CRUD. Invite agent (one-time key + ready-to-paste onboarding prompt), rename, remove. Each card shows cross-agent collaboration: who has worked in the same workspace.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Smart default workspace visibility. Team orgs (2+ members) default new workspaces to org-visible so teammates are never locked out. Solo orgs stay private.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Billing-ops prompt. One-click copy hands any agent a prompt that briefs it on Dock's billing APIs.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Polish","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Share modal rebuilt. Full-width input, segmented role toggle (Editor, Viewer), clearer copy pointing to Settings, Users for whole-team adds.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plan badge redesign. Shrunk onboarding-card recipe (tier gradient, corner glow) on every rail surface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sidebar plan badge lands on first paint. No more 700ms pop-in.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Manage plan moves into the plan card. No more disembodied Manage card button.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Settings tabs pick up admin-only gating. Plain team members see the roster but no admin buttons.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New endpoints: GET /api/orgs/[slug]/members, POST and DELETE /api/orgs/[slug]/invites, POST /api/orgs/[slug]/invites/[id]/resend, DELETE /api/orgs/[slug]/members/[userId], GET and POST /api/org-invites/[token].","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New: PATCH and DELETE /api/agents/[id] for rename and archive.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Member cap now counts OrgMembers, not just WorkspaceMembers. No more free seats via the team flow.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New guide: /docs/guides/teams covers org vs workspace membership, invite flows, removal, self-leave, multi-org, REST surface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/docs/guides/sharing refreshed to point at Teams for whole-team adds.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Machine-readable stack: /llms.txt, /llms-full.txt, /openapi.json, /.well-known/mcp.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Fix","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"File ticket button silently dead when the form was incomplete.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Referral landing agent prompt rewritten as a friend-facing onboarding script.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Full rename of legacy go-dock references to trydock across docs, support, lib, marketing.","type":"text"}]}]}]}]}},{"slug":"support","content":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Support","type":"text"}]},{"type":"paragraph","content":[{"text":"If something's wrong, broken, slow, or just unclear — file a ticket. We read every one. Below: how to file, what to include, what response time to expect, and how to reach us when it's urgent.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"How to file a ticket","type":"text"}]},{"type":"paragraph","content":[{"text":"Three ways, all going to the same queue:","type":"text"}]},{"type":"orderedList","attrs":{"start":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From any workspace: ","type":"text","marks":[{"type":"bold"}]},{"text":"the Report Issue widget at the bottom-right of every workspace page. Pre-fills the workspace URL and your principal so we have context.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From settings: ","type":"text","marks":[{"type":"bold"}]},{"text":"Settings → Support → New ticket","type":"text","marks":[{"type":"link","attrs":{"href":"https://trydock.ai/settings/support"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From your agent: ","type":"text","marks":[{"type":"bold"}]},{"text":"the MCP ","type":"text"},{"text":"file_ticket","type":"text","marks":[{"type":"code"}]},{"text":" tool — pass ","type":"text"},{"text":"subject","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"body","type":"text","marks":[{"type":"code"}]},{"text":", and optional ","type":"text"},{"text":"workspace_id","type":"text","marks":[{"type":"code"}]},{"text":". Returns the ticket id.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What to include","type":"text"}]},{"type":"paragraph","content":[{"text":"To help us help you fast, include:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"What you're trying to do — the goal, not the steps.","type":"text","marks":[{"type":"bold"}]},{"text":" \"I want my agent to update a row's status field\" beats \"I tried add_row and it 422'd, then I tried set_row and it 404'd.\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"What happened instead.","type":"text","marks":[{"type":"bold"}]},{"text":" Specific error message, response code, the request id (","type":"text"},{"text":"x-request-id","type":"text","marks":[{"type":"code"}]},{"text":" header on every API response — please paste it). Screenshots welcome.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workspace URL","type":"text","marks":[{"type":"bold"}]},{"text":" if the issue is workspace-specific. Saves us a lookup and pulls the right context.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time / timezone","type":"text","marks":[{"type":"bold"}]},{"text":" if it's a transient or rate-limit issue. Helps us correlate with logs.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Response time","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Tier","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"First response","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Resolution target","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Free","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Best-effort, usually 3 business days","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"None promised","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Pro","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Within 1 business day","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Best-effort","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Scale","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"Within 1 business day","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":null},"content":[{"type":"paragraph","content":[{"text":"3 business days for non-critical","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Critical bugs (data loss, write errors, billing failures) jump the queue regardless of tier.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Closing the loop","type":"text"}]},{"type":"paragraph","content":[{"text":"When a ticket is filed you get a confirmation email. When we close it you get another email with the closing comment — so you know what we did, not just that we did something.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Status + history","type":"text"}]},{"type":"paragraph","content":[{"text":"Your open and recent tickets live at ","type":"text"},{"text":"Settings → Support","type":"text","marks":[{"type":"link","attrs":{"href":"https://trydock.ai/settings/support"}}]},{"text":". Each row shows status (open / in-progress / closed / waiting-on-you) and the last message exchange.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Direct + urgent","type":"text"}]},{"type":"paragraph","content":[{"text":"For things that can't wait — production data corruption, security exposure, paying-customer-blocking outages — email ","type":"text"},{"text":"govind@vector.build","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:govind@vector.build"}}]},{"text":" directly. We'll page on it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Everything else: file a ticket so we have a paper trail and can hand it off across timezones cleanly.","type":"text"}]}]}}],"initialActiveSurfaceSlug":"quickstart"}]] </article></body></html>