Add complete archive workflows to the default sidebar

BRANCH_DETAILS.md

@@ -0,0 +1,19 @@
+# Sidebar V2 Archive Controls
+
+Sidebar V2 preserves archive as a separate lifecycle from settle. Settled rows expose adjacent un-settle and archive buttons on hover or keyboard focus, while root conversation context menus expose archive for both settled and unsettled rows. Archive remains visible but disabled for a running conversation, and nested subagent rows continue to omit root lifecycle actions.
+
+The `Settled` section header includes an `Archive all` action. It applies to the complete settled partition in the current project scope, including rows behind settled-tail pagination, and remains available when the list begins with settled conversations. Individual, selected, and all-settled archive actions honor the shared archive-confirmation setting, use the existing optimistic visibility and archived-snapshot refresh path, preserve already archived results if a later bulk mutation or post-archive navigation fails, remove archived rows from any active selection, and report failures without implying that completed archive work was rolled back. Repeated individual archive triggers for the same thread are ignored while its archive flow is in flight.
+
+`SidebarV2.tsx` isolates the fork-owned integration in `SidebarV2SettledLifecycleControls` and `SidebarV2SettledDivider`. Shared lifecycle-button classes keep settle, un-settle, and archive affordances aligned with the upstream row surface tokens. Disabled archive controls retain pointer targeting so clicks cannot fall through to row navigation. The surrounding row structure, including tooltip wrapping, row sizing, filtering, and decorative environment/provider status semantics, remains upstream-owned. The settled divider remains an interactive list item rather than an aria-hidden separator because it contains `Archive all`.
+
+Primary files:
+
+- `apps/web/src/components/SidebarV2.tsx`
+- `apps/web/src/components/Sidebar.logic.ts`
+- `apps/web/src/components/Sidebar.logic.test.ts`
+- `apps/web/src/hooks/useThreadActions.ts`
+
+## Development Ports
+
+- Web: `5743`
+- Server/WebSocket: `13783`

apps/web/src/components/Sidebar.logic.test.ts

@@ -2,7 +2,9 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vite-plus/test"
 import {
   archiveSelectedThreadEntries,
   buildMultiSelectThreadContextMenuItems,
+  buildSidebarV2ThreadContextMenuItems,
   createThreadJumpHintVisibilityController,
+  filterArchivableSidebarThreads,
   getSidebarThreadIdsToPrewarm,
   getVisibleSidebarThreadIds,
   resolveAdjacentThreadId,
@@ -11,6 +13,7 @@ import {
   getProjectSortTimestamp,
   hasUnseenCompletion,
   isContextMenuPointerDown,
+  isThreadSessionRunning,
   isTrailingDoubleClick,
   orderItemsByPreferredIds,
   resolveProjectStatusIndicator,
@@ -22,6 +25,7 @@ import {
   resolveThreadStatusPill,
   shouldNavigateAfterProjectRemoval,
   shouldClearThreadSelectionOnMouseDown,
+  shouldShowSidebarV2SettledHeader,
   sortLogicalProjectsForSidebar,
   sortThreadsForSidebarV2,
   sortProjectsForSidebar,
@@ -162,6 +166,79 @@ describe("buildMultiSelectThreadContextMenuItems", () => {
   });
 });
 
+describe("buildSidebarV2ThreadContextMenuItems", () => {
+  it("offers archive for active and settled threads", () => {
+    const activeItems = buildSidebarV2ThreadContextMenuItems({
+      canUseLifecycleActions: true,
+      supportsSettlement: true,
+      isSettled: false,
+      isRunning: false,
+    });
+    const settledItems = buildSidebarV2ThreadContextMenuItems({
+      canUseLifecycleActions: true,
+      supportsSettlement: true,
+      isSettled: true,
+      isRunning: false,
+    });
+
+    expect(activeItems.map((item) => item.id)).toEqual([
+      "settle",
+      "archive",
+      "rename",
+      "mark-unread",
+      "delete",
+    ]);
+    expect(settledItems.map((item) => item.id)).toEqual([
+      "unsettle",
+      "archive",
+      "rename",
+      "mark-unread",
+      "delete",
+    ]);
+  });
+
+  it("keeps archive visible but disabled while a thread is running", () => {
+    const items = buildSidebarV2ThreadContextMenuItems({
+      canUseLifecycleActions: true,
+      supportsSettlement: true,
+      isSettled: false,
+      isRunning: true,
+    });
+
+    expect(items.find((item) => item.id === "archive")).toMatchObject({ disabled: true });
+  });
+});
+
+describe("shouldShowSidebarV2SettledHeader", () => {
+  it("shows above the first settled row even when the list starts settled", () => {
+    expect(shouldShowSidebarV2SettledHeader({ isSettled: true, previousIsSettled: false })).toBe(
+      true,
+    );
+  });
+
+  it("hides for active rows and later settled rows", () => {
+    expect(shouldShowSidebarV2SettledHeader({ isSettled: false, previousIsSettled: false })).toBe(
+      false,
+    );
+    expect(shouldShowSidebarV2SettledHeader({ isSettled: true, previousIsSettled: true })).toBe(
+      false,
+    );
+  });
+});
+
+describe("archive lifecycle guards", () => {
+  it("filters running threads from archive batches", () => {
+    const ready = { id: "ready", session: null };
+    const running = {
+      id: "running",
+      session: { status: "running", activeTurnId: "turn-running" },
+    };
+
+    expect(isThreadSessionRunning(running.session)).toBe(true);
+    expect(filterArchivableSidebarThreads([ready, running])).toEqual([ready]);
+  });
+});
+
 describe("resolveSidebarStageBadgeLabel", () => {
   it("returns Nightly for nightly primary server versions", () => {
     expect(

apps/web/src/components/Sidebar.logic.ts

@@ -95,6 +95,63 @@ export function buildMultiSelectThreadContextMenuItems(input: {
   ];
 }
 
+export type SidebarV2ThreadContextMenuItemId =
+  | "settle"
+  | "unsettle"
+  | "archive"
+  | "rename"
+  | "mark-unread"
+  | "delete";
+
+export function buildSidebarV2ThreadContextMenuItems(input: {
+  canUseLifecycleActions: boolean;
+  supportsSettlement: boolean;
+  isSettled: boolean;
+  isRunning: boolean;
+}): readonly ContextMenuItem<SidebarV2ThreadContextMenuItemId>[] {
+  return [
+    ...(input.supportsSettlement
+      ? [
+          input.isSettled
+            ? ({ id: "unsettle", label: "Un-settle thread" } as const)
+            : ({ id: "settle", label: "Settle thread" } as const),
+        ]
+      : []),
+    ...(input.canUseLifecycleActions
+      ? [{ id: "archive" as const, label: "Archive thread", disabled: input.isRunning }]
+      : []),
+    { id: "rename", label: "Rename thread" },
+    { id: "mark-unread", label: "Mark unread" },
+    ...(input.canUseLifecycleActions
+      ? [{ id: "delete" as const, label: "Delete", destructive: true, icon: "trash" as const }]
+      : []),
+  ];
+}
+
+export function shouldShowSidebarV2SettledHeader(input: {
+  isSettled: boolean;
+  previousIsSettled: boolean;
+}): boolean {
+  return input.isSettled && !input.previousIsSettled;
+}
+
+export function isThreadSessionRunning(
+  session: { readonly status: string; readonly activeTurnId?: unknown } | null | undefined,
+): boolean {
+  return session?.status === "running" && session.activeTurnId != null;
+}
+
+export function filterArchivableSidebarThreads<
+  T extends {
+    readonly session?:
+      | { readonly status: string; readonly activeTurnId?: unknown }
+      | null
+      | undefined;
+  },
+>(threads: readonly T[]): T[] {
+  return threads.filter((thread) => !isThreadSessionRunning(thread.session));
+}
+
 export interface ThreadStatusPill {
   label:
     | "Working"