feat(sidebar): merge tasks panel into collapsible sidebar with VM groups

[tlgimenes]

Summary

Merge the narrow icon rail and the org-wide tasks panel into a single collapsible sidebar. Tasks are grouped client-side by virtual_mcp_id, with Decopilot pinned first and the rest ordered by most-recent task. The collapsed state turns each group into an avatar in the rail with a hover popover preview.

• Single sidebar (SidebarProvider defaultOpen={true}); today's narrow rail is now the collapsed state of the same surface.
• Top fixed buttons: Home, Browse agents (existing + popover), Connections, Balance (CreditChip when applicable).
• TaskGroup accordion: per-group header (chevron · avatar · title · hover +) and body of TaskRows. TaskRow keeps its 2-line layout (title + branch · time) and status/archive hover; the avatar moved to the group header.
• Filter section header keeps Search; member + type filters fold into a single ⋯ dropdown.
• Collapsed rail: each VM group is just an avatar; hover opens a HoverCard showing the same accordion body and +.
• pluginRootSidebarItems, pinnedViews, and the Workflows sidebar entry are removed from the sidebar render path.
• Footer simplified to Inbox · Settings · Account (Credits + Connections moved to top actions).

Spec: `docs/superpowers/specs/2026-05-25-sidebar-tasks-merge-design.md`
Plan: `docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md`

Test plan

• `bun run check` (all workspaces)
• `bun run lint` — 0 warnings, 0 errors
• `bun run fmt:check` clean
• `bun test apps/mesh/src/web/components/sidebar` — 6/6
• Manual: expanded sidebar renders top actions, Tasks section, group accordion (Decopilot pinned), task row 2-line layout, filter button stays neutral on first mount
• Manual: collapsed rail + hover popover (no `SidebarTrigger` placed yet — toggle via `Cmd/Ctrl+B` shadcn default)
• Manual: mobile sheet renders `StudioSidebarMobile` as a single full-width panel

Known follow-ups (not blocking)

• Top action buttons (Home / Browse / Connections / Credits) render icon-only in expanded state — `SidebarNavigationItem` and the top-actions buttons pass only `{icon}` to `SidebarMenuButton`. Adding labels next to icons is a small follow-up.
• No `SidebarTrigger` placed in the toolbar; only `Cmd/Ctrl+B` toggles the sidebar.
• Dead `?tasks=0|1` URL machinery (`TasksPanelStateProvider`, `useTasksPanelState`, `HomeTasksToggle`) still flips a query param that no longer drives UI — to remove in a cleanup PR.
• `SidebarAgentsSection` still exported from `agents-section.tsx` but no callers; the file mostly hosts `PinAgentPopover` (re-exported as `BrowseAgentsButton`).
• `text-blue-500` raw token in `TaskRow` automation badge.

🤖 Generated with Claude Code

---

Summary by cubic

Merged the org-wide tasks panel into a single collapsible, drag‑resizable sidebar with VM groups, and added a Home Next‑Actions row powered by MCP prompts. Adopted a full‑width header shell, kept sidebar width consistent across org routes, and removed the old “Up next” and welcome‑thread flows.

• New Features

  • Home Next‑Actions row: cards start a new agent thread and autosend an MCP prompt; dialog cards open client flows (storefront, GitHub, monitoring). Backed by GET /api/:org/home-next-actions, useHomeNextActions, and useStartThreadFromPrompt (args dialog + tests). Prompts declare arguments with argsSchema; Brand setup collects optional website, with optional goal/problem for landing/store prompts. Prompt mentions from home, icebreakers, and / now share the same editable rich chip.
  • Task groups: stable per‑org order persisted; collapsed rail shows hover popover previews; optional status grouping with unified archive‑on‑hover and permanent archive in status view; group/thread utils covered by tests.
  • Sidebar: drag‑resizable width (240–400px) with desktop handle and double‑click reset, persisted across org‑shell routes; top actions (Home, Browse agents, Connections, Credits); header with search, a group‑by toggle (agent ↔ status), a filter button, and a compact BrowseAgentsButton; added a separator above task actions. Group‑by emits tasks_panel_group_by_changed.

• Refactors and Fixes

  • Removed legacy surfaces/APIs: tasks workspace/panel and ?tasks param, suggested-actions, studio-pack-checklists, studio-pack-welcome, and the in‑chat NextAction chip. Stopped creating welcome threads.
  • Studio Pack onboarding via prompts: added studio-pack-onboarding prompt set; per‑agent selectedPrompts whitelists written on install and backfilled on existing installs; dropped welcome‑message plumbing.
  • Query keys: added homeNextActions; removed old checklist/suggested‑actions keys and the prompt‑connection map key. Dropped prompt‑icon lookup in / picker; args dialog now shows title/meta and argument descriptions.
  • UI polish: TaskRow supports agent icon with compact 2xs avatar, inline automation badge, and unified archive‑on‑hover; account/org name shown in account popover; Next‑Actions row widened and wraps on desktop.
  • Infra: MCP clients in @decocms/mesh-sdk keep connections alive for 60s to avoid reconnects on brief unmounts; SidebarProvider in @deco/ui supports controlled open/onOpenChange and desktop toggling.
  • Autosend fix: setTaskId now accepts { autosend }, and useStartThreadFromPrompt sets it so the first user message sends when a home prompt opens a new thread.
  • Cleanup: removed unused appendToTiptapDoc util.

^{Written for commit 2fe089e. Summary will update on new commits. Review in cubic}

[github-actions]

🧪 Benchmark

Should we run the Virtual MCP strategy benchmark for this PR?

React with 👍 to run the benchmark.

Reaction	Action
👍	Run quick benchmark (10 & 128 tools)

Benchmark will run on the next push after you react.

[github-actions]

Release Options

Suggested: Minor (2.356.0) — based on feat: prefix

React with an emoji to override the release type:

Reaction	Type	Next Version
👍	Prerelease	2.355.2-alpha.1
🎉	Patch	2.355.2
❤️	Minor	2.356.0
🚀	Major	3.0.0

Current version: 2.355.1

Note: If multiple reactions exist, the smallest bump wins. If no reactions, the suggested bump is used (default: patch).

[cubic-dev-ai]

4 issues found across 21 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="apps/mesh/src/web/components/sidebar/top-actions.tsx">

<violation number="1" location="apps/mesh/src/web/components/sidebar/top-actions.tsx:34">
P2: Error boundary never resets after first failure. Credit chip can disappear until full remount. Add a reset path so transient query errors can recover.</violation>
</file>

<file name="apps/mesh/src/web/components/sidebar/task-groups/task-groups-list.tsx">

<violation number="1" location="apps/mesh/src/web/components/sidebar/task-groups/task-groups-list.tsx:140">
P2: Collapsed mode skips infinite-scroll sentinel. More task groups never load there. Reuse the same scroll ref + sentinel in collapsed branch.</violation>
</file>

<file name="docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md">

<violation number="1" location="docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md:734">
P2: handleArchive navigates to next task from unfiltered sortedThreads. With member/type filters active this can land on a task invisible in the current filtered view.</violation>

<violation number="2" location="docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md:760">
P1: Missing await on navigate before createNewTask. The navigate sets virtualmcpid in the URL so createNewTask can read it, but without await the create uses the stale URL.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

P1: Missing await on navigate before createNewTask. The navigate sets virtualmcpid in the URL so createNewTask can read it, but without await the create uses the stale URL.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md, line 760:

<comment>Missing await on navigate before createNewTask. The navigate sets virtualmcpid in the URL so createNewTask can read it, but without await the create uses the stale URL.</comment>

<file context>
@@ -0,0 +1,1833 @@
+        }),
+      });
+    }
+    createNewTask();
+  };
+
</file context>

[cubic-dev-ai]

P2: Error boundary never resets after first failure. Credit chip can disappear until full remount. Add a reset path so transient query errors can recover.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At apps/mesh/src/web/components/sidebar/top-actions.tsx, line 34:

<comment>Error boundary never resets after first failure. Credit chip can disappear until full remount. Add a reset path so transient query errors can recover.</comment>

<file context>
@@ -0,0 +1,141 @@
+  static getDerivedStateFromError(): { hasError: boolean } {
+    return { hasError: true };
+  }
+  override componentDidCatch(_error: Error, _info: ErrorInfo): void {}
+  override render(): ReactNode {
+    if (this.state.hasError) return null;
</file context>

[cubic-dev-ai]

P2: Collapsed mode skips infinite-scroll sentinel. More task groups never load there. Reuse the same scroll ref + sentinel in collapsed branch.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At apps/mesh/src/web/components/sidebar/task-groups/task-groups-list.tsx, line 140:

<comment>Collapsed mode skips infinite-scroll sentinel. More task groups never load there. Reuse the same scroll ref + sentinel in collapsed branch.</comment>

<file context>
@@ -0,0 +1,275 @@
+
+  const isCollapsed = sidebarState === "collapsed";
+
+  if (isCollapsed) {
+    return (
+      <div className="flex flex-col min-h-0 px-1 py-1 gap-0.5 overflow-y-auto">
</file context>

[cubic-dev-ai]

P2: handleArchive navigates to next task from unfiltered sortedThreads. With member/type filters active this can land on a task invisible in the current filtered view.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md, line 734:

<comment>handleArchive navigates to next task from unfiltered sortedThreads. With member/type filters active this can land on a task invisible in the current filtered view.</comment>

<file context>
@@ -0,0 +1,1833 @@
+    const wasActive = task.id === activeTaskId;
+    hide(task.id);
+    if (!wasActive) return;
+    const next = sortedThreads.find((t) => t.id !== task.id);
+    if (next) {
+      setTaskId(next.id, next.virtual_mcp_id);
</file context>

[cubic-dev-ai]

1 issue found across 17 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="apps/mesh/src/web/components/sidebar/top-actions.tsx">

<violation number="1" location="apps/mesh/src/web/components/sidebar/top-actions.tsx:34">
P2: Error boundary never resets after first failure. Credit chip can disappear until full remount. Add a reset path so transient query errors can recover.</violation>
</file>

<file name="apps/mesh/src/web/components/sidebar/task-groups/task-groups-list.tsx">

<violation number="1" location="apps/mesh/src/web/components/sidebar/task-groups/task-groups-list.tsx:140">
P2: Collapsed mode skips infinite-scroll sentinel. More task groups never load there. Reuse the same scroll ref + sentinel in collapsed branch.</violation>
</file>

<file name="docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md">

<violation number="1" location="docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md:734">
P2: handleArchive navigates to next task from unfiltered sortedThreads. With member/type filters active this can land on a task invisible in the current filtered view.</violation>

<violation number="2" location="docs/superpowers/plans/2026-05-25-sidebar-tasks-merge.md:760">
P1: Missing await on navigate before createNewTask. The navigate sets virtualmcpid in the URL so createNewTask can read it, but without await the create uses the stale URL.</violation>
</file>

<sub>Tip: Review your code locally with the cubic CLI to iterate faster.

Re-trigger cubic</sub>

[cubic-dev-ai]

You're iterating quickly on this pull request. To help protect your rate limits, cubic has paused automatic reviews on new pushes for now—when you're ready for another review, comment @cubic-dev-ai review.