Skip to content

Cloud workspaces and tasks become shared records: presence, sharing, descriptions, comments, labels, mentions - #7932

Merged
saddlepaddle merged 5 commits into
mainfrom
saddlepaddle/cloud-presence
Sep 29, 2026
Merged

saddlepaddle merged 5 commits into
mainfrom
saddlepaddle/cloud-presence

Conversation

@saddlepaddle

@saddlepaddle saddlepaddle commented Sep 29, 2026 •

Copy link
Copy Markdown
Collaborator

What this does

Cloud workspaces

  • The sidebar's cloud section shows presence and a hover card. Its context menu has: open details, rename, save as environment, add task / project / label, copy link or id, and groups.
  • A list page grouped by calendar day, by person, or not at all. Sort and filters are kept per viewer.
  • A record page per workspace:
    • an editable markdown description, which the box's agent can write via superset workspaces description set or when someone clicks Generate;
    • the initial prompt with its attachments;
    • an activity timeline;
    • labels, project, repositories, pull requests, pages and suggestions;
    • a share popover.
  • Private ("only you") boxes stay invisible to everyone else, including through save-as-environment.
  • Workspace creation now also records who created it, keeps the prompt's files, and links tasks. This lives in the shared startCloudWorkspace, so boxes that automations start get it too.

Tasks and projects

  • Task and project record pages with Tiptap descriptions and comments (one level of replies; deleting a root comment deletes its thread).
  • Inline images and files are stored as stable references and re-signed per hour on read.
  • An activity timeline covering title, description, status, priority, assignee, project, labels and workspace links.
  • Labels move to the workspace model: a task_label_assignments join on the shared task_labels table.
  • @-mentions for people, tasks and pull requests in every editor, saved as markdown links.

Performance

  • Task lists sort on created_at + interval '0 seconds' so Postgres filters by organization first. With the plain column it walked the global created_at index: 99.6s for a 93k-task org, now 0.2–0.4s warm, and 35ms for a small org. Row order is unchanged.
  • Mention search sorts by updated_at for the same reason.

Risks checked before merge

Risk Finding
tRPC procedures removed or renamed that shipped clients call None. Every router change is an addition; changes to existing procedures only add optional inputs or extra output fields. The listPage cursor is unchanged ({ createdAt, id }).
Task flows people use today Existing task labels stop showing (a deliberate start-clean decision; the jsonb column is kept, unread, and gets dropped next release). Linear no longer imports labels. Label names are lowercased, as workspace labels already were. Everything else in create, update, list and paging keeps its shape.
Database load Task lists got much cheaper (above). Mention search takes about 200ms warm per keystroke on the largest org (2.2s cold). Each task read adds a label-name subquery that looks up by primary key.
Migration 0131 One squashed migration: new tables, three ADD VALUEs, and new columns on cloud_workspaces. It never alters tasks itself; foreign keys from the new tables briefly lock tasks, auth.users and auth.organizations.
Migration under load Rehearsed 3/3 on a fresh production branch with pgbench (24 clients reading auth.users, auth.organizations, cloud_workspaces and tasks while updating tasks, with production lock_timeout=5s / statement_timeout=60s). It applied in 4–5s each run with no lock timeouts, deadlocks or client errors.
Sandbox permissions Adds cloudWorkspace.setDescription to the box allowlist. A box can only set its own description.

Verification

  • bun run typecheck, bun run lint, check:i18n (all 16 locales complete) and check:plugins pass.
  • Tests: desktop renderer 6286, api 218, cli 297 and db 14 pass. trpc: 414 pass; 7 deriveSandboxCredentials tests fail locally only, because a signing key is missing.
  • End to end against the dev stack on a production-copy branch:
    • 20 API checks: labels, all activity types, comment threads, projects, mention search, workspace record endpoints, save-as-environment preview, file routes (401 without auth, 404 for bad ids).
    • 20 UI checks, driven over CDP: sidebar menu and hover card, list grouping and its saved setting, record page, share, not-found state, task rename and label and comment with a mention chip, Create workspace, project page, the New task dialog's @ menu, automations.
    • Comment image upload works end to end.
    • The dev CLI plus realtime path: workspaces description set reached an open page within 2s.
    • Zero console errors throughout.
  • Not tested: creating a real box from the dev stack. It needs production-encrypted GitHub credentials, so it's covered by typecheck and review only.

After merge

  • Next release: drop tasks.labels.
  • Watch Neon CPU and query times on task list and mention search.

Summary by cubic

Cloud workspaces and tasks become shared records with presence, sharing, descriptions, comments, labels, and @-mentions across the app.

New Features

  • Cloud workspaces gain presence-augmented sidebar rows, a list page grouped by day or person, and a record page with description, prompt, timeline, labels, project, and a share popover.
  • Task and project record pages add Tiptap descriptions, one-level comment threads, inline images, and activity timelines covering title, status, priority, assignee, project, and labels.
  • @-mentions for people, tasks, and pull requests in every editor, stored as markdown links.
  • Task lists and mention search sort by an expression so Postgres filters by organization first: a 93k-task org dropped from 99.6s to 0.2–0.4s.
  • The task page's Create workspace now opens the Run in Workspace popover for that task directly; it no longer detours through New Workspace. Choosing Cloud there offers the org's startable environments and cloud agents and creates the workspace with the task linked.
  • The Japanese relative-time format test now checks the fallback instead of ICU's exact strings, which differ between ICU builds.

Migration

  • Existing task labels stop showing; the jsonb column stays unread and drops next release, and Linear no longer imports labels. Label names are lowercased.
  • Migration 0131 adds the new tables, enum values, and columns on cloud_workspaces; it was rehearsed under load and applies in 4–5s without lock timeouts.

Written for commit 5388a27. Summary will update on new commits.

Review in cubic

Also in this PR: Create workspace and Run in Workspace

  • The task page's Create workspace opens the same Run in Workspace popover the task list uses, for this one task. Pick device, environment or project, and agent, then confirm. It no longer detours through the New Workspace page.
  • Choosing Cloud in Run in Workspace works now. It used to leave Run disabled ("Host is offline"), because the cloud host id isn't a machine. It now offers the org's startable environments in place of a project and the cloud agents in place of the host's, and creates each workspace through cloudWorkspace.create with the task linked.
  • Verified in the dev app: the button opens the popover and stays on the task page, Cloud shows the environment, and Run creates the box with the "created" and task-linked activity. The box then stops at decryptAgentCredential in dev, because the production-encrypted agent credentials can't be decrypted locally; that's dev-only.

…descriptions, comments, labels, mentions

Cloud workspaces
- Sidebar cloud section with presence, hover cards, and a context menu (open details, rename,
  save as environment, add task / project / label, copy link or id, groups).
- A list page grouped by calendar day, person, or none, with sort and filters kept per viewer.
- A record page per workspace: editable markdown description (the box's agent can write it via
  `superset workspaces description set`, or on Generate), initial prompt with attachments,
  activity timeline, labels, project, repositories, pull requests, pages, suggestions, and a
  share popover. Private ("only you") boxes stay invisible to everyone else, including through
  save-as-environment.
- Creating a workspace records who created it, keeps the prompt's files, and links tasks; this now
  lives in the shared start path, so automation-started boxes get it too.

Tasks and projects
- Task and project record pages with Tiptap descriptions and comments (one level of replies;
  deleting a root removes its thread), inline images and files stored as stable refs that are
  re-signed per hour on read, and an activity timeline (title, description, status, priority,
  assignee, project, labels, workspace links).
- Labels move to the workspace model: a task_label_assignments join on the shared task_labels
  table. Existing jsonb labels are intentionally not carried over, and Linear no longer writes
  labels. tasks.labels stays in the table, unread, until the next release drops it. CLI, SDK and
  MCP keep taking and returning label names (now lowercased, as workspace labels already were).
- @-mentions for people, tasks and pull requests in every editor, saved as markdown links.

Performance
- Task lists sort on created_at through an expression so Postgres filters by organization first;
  with the plain column it walked the global created_at index (99.6s for a 93k-task org, now
  0.2-0.4s warm). Mention search sorts by updated_at for the same reason.

Migration 0131 is one squashed migration: new tables, three enum values, and new columns on
cloud_workspaces. Rehearsed three times on a production branch under pgbench load (24 clients
reading auth.users, auth.organizations, cloud_workspaces and tasks while updating tasks): applied
in 4-5s each run with no lock timeouts, deadlocks, or client errors.
@coderabbitai

coderabbitai Bot commented Sep 29, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Warning

Review details and warnings were omitted to fit the comment limit.

@github-actions

github-actions Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

🧹 Preview Cleanup Complete

The following preview resources have been cleaned up:

  • ✅ Neon database branch

Thank you for your contribution! 🎉

…un tasks in the cloud

The task page's Create workspace becomes a split button: the button still opens New Workspace
with the task linked, and its chevron opens the same Run in Workspace popover the task list uses,
for the one task. The popover moves to tasks/components since both surfaces share it.

Choosing Cloud in that popover used to leave Run disabled ("Host is offline": the cloud host id
is not a machine). It now offers the organization's startable environments in place of a project
and the cloud agents in place of the host's, and creates each workspace through
cloudWorkspace.create with the task linked, seeding the cloud list like the New Workspace screen.
…tself

Pick device, environment or project, and agent, then confirm; it no longer detours through the New Workspace page. The split chevron goes away with it.
@saddlepaddle
saddlepaddle merged commit 4e72e57 into main Sep 29, 2026
20 checks passed
Kitenite added a commit that referenced this pull request Oct 1, 2026
* docs: weekly update for PRs merged 2026-09-23 to 2026-09-30

Source of truth: live Notion SOP "Weekly Docs Update (automation SOP)".
Window: merged:>=2026-09-23 (139 PRs). PRs through the morning of 09-23
were covered by #7771.

Changes
- Pages: no auto-open on publish (#7790); page links and URL links split
  into their own settings (#7916, #7962, #7946); Listening agents menu with
  per-row stop and Add listening agent (#7724, #7820, #7919); globe on the
  Share button (#7766); Report on public pages (#7886); agents offer a page
  (#7759). Files: pages.mdx, cli/cli-reference.mdx.
- Settings moves: Links replaced by Browser and Files & Editor (#7916,
  #7962). Files: editor.mdx, terminal-integration.mdx, customization.mdx.
- Editor: inline rename and drag to move (#7692), Auto Save (#7693, #7916),
  open and save files outside the workspace (#7897, #7982), Copy as Markdown
  (#7591), per-pane error screen (#7983). File: editor.mdx.
- Terminal copy follows Ghostty's whitespace rules (#7868).
  File: terminal-integration.mdx.
- Agents: UFO (#7898); GPT-6 Astra, Sonnet 5.5, retiring GPT-5.5, retired
  GPT-5.4/5.3 Codex (#7783, #7894, #7935). Files: agent-integration.mdx,
  cli/cli-reference.mdx.
- Host: superset start --daemon --auto-update and update-lock permission
  errors (#7735, #7952). Files: cli/host-server.mdx, cli/cli-reference.mdx.
- Removed the mcp CLI section and the Connected Service Plugins section:
  #7776 made plugins/mcp internal, the Plugins page is staff-flagged, and
  apps/docs/AGENTS.md keeps internal commands out. Files: skills.mdx,
  cli/cli-reference.mdx.
- Slack page unfurls and details panel (#7817, #7821, #7914, #7957).
  File: use-with-slack.mdx.
- Workspaces: instant creation with background naming (#7518); recoverable
  project deletion (#7896). File: workspaces.mdx.
- Shortcuts: prev/next workspace includes Pinned and wraps (#7851); ⌘B
  collapses the sidebar to a rail (#7964). File: keyboard-shortcuts.mdx.
- Ship controls and open-in button moved to the right sidebar strip (#7958).
  Files: diff-viewer.mdx, use-with-ide.mdx.

Deliberately skipped
- Cloud workspaces/environments/sandboxes (flag-gated, AGENTS.md rule):
  #7784 #7795 #7824 #7840 #7844 #7845 #7847 #7849 #7850 #7858 #7861 #7863
  #7874 #7911 #7913 #7918 #7922 #7931 #7932 #7937 #7956 #7961 #7969 #7981
  #7637 #7794 #7789 #7838 (its CLI docs already shipped in the PR).
- Staff-only plugins: #7912 Sentry plugin, #7716, #7727, #7955.
- Already documented in their own PRs: #7917, #7921.
- Removed feature never documented: #7796 Google Calendar triggers.
- Agents chip remove/revert/default-off, never documented: #7870 #7871 #7872.
- Billing/backend policy with no docs surface: #7947, #7812, #7786, #7792,
  #7798, #7761, #7948, #7949, #7951, #7827.
- Reverted security trio: #7828 #7829 #7830 (reverted by #7834).
- Fixes restoring expected behavior: #7683 #7696 #7707 #7743 #7751 #7756
  #7764 #7765 #7781 #7788 #7791 #7823 #7825 #7833 #7837 #7852 #7857 #7860
  #7864 #7865 #7869 #7873 #7897-covered #7903 #7938 #7980 #7943 #7964-chrome.
- Mobile (no docs page): #7746 #7747 #7748 #7749 #7750 #7782 #7793 #7810
  #7814 #7816 #7889 #7968.
- Marketing, internal docs, CI, version bumps: #7651 #7744 #7752 #7771 #7774
  #7776-infra #7777 #7785 #7811 #7818 #7822 #7826 #7834 #7884 #7885 #7895
  #7909 #7933 #7934 #7942 #7944 #7965 #7966.

Validation: bun run --cwd apps/docs typecheck, bun run lint:fix,
bun run lint (exit 0), Vale on 13 changed files (0 errors, 0 warnings),
git diff --check.

* chore: log weekly docs update follow-ups

* docs: tighten review findings in the weekly update

Only the page creator can stop or add listening agents. On focus change also
saves on window blur, and Auto Save pauses on conflicts. Taken-down pages do
not unfurl. Model picker coverage matches agent-models.ts.

This branch was previously deployed

1 inactive deployment
preview — 5388a276 Deployed Sep 29, 2026 by saddlepaddle via Deploy API #10552
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant