From b16513ca633742b659d621c500fd800de9e52545 Mon Sep 17 00:00:00 2001
From: Peter Kirkham <peter@posthog.com>
Date: Fri, 29 May 2026 09:13:26 +0100
Subject: [PATCH 1/6] feat: home tab

---
 .../migrations/0007_remarkable_lord_tyger.sql |   6 +
 .../db/migrations/meta/0007_snapshot.json     | 629 ++++++++++++++++++
 .../src/main/db/migrations/meta/_journal.json |   9 +-
 .../repositories/home-workflow-repository.ts  |  60 ++
 apps/code/src/main/db/schema.ts               |   7 +
 apps/code/src/main/di/container.ts            |   9 +
 apps/code/src/main/di/tokens.ts               |   3 +
 .../src/main/services/workflow/backend.ts     |  81 +++
 .../services/workflow/default-workflow.ts     |  59 ++
 .../src/main/services/workflow/service.ts     | 111 ++++
 apps/code/src/main/trpc/router.ts             |   2 +
 apps/code/src/main/trpc/routers/workflow.ts   |  36 +
 apps/code/src/renderer/App.tsx                |   6 +
 .../src/renderer/components/MainLayout.tsx    |   3 +
 .../home/components/HomeActiveAgentsStrip.tsx |  91 +++
 .../home/components/HomeBoardView.tsx         |  64 ++
 .../home/components/HomeEmptyState.tsx        |  42 ++
 .../features/home/components/HomeView.tsx     | 306 +++++++++
 .../home/components/HomeWorkstreamCard.tsx    | 236 +++++++
 .../components/HomeWorkstreamDetailPanel.tsx  | 371 +++++++++++
 .../home/components/HomeWorkstreamRow.tsx     | 193 ++++++
 .../home/components/SituationChip.tsx         |  16 +
 .../home/config/ActionEditorPanel.tsx         | 172 +++++
 .../features/home/config/ConfigMap.tsx        | 286 ++++++++
 .../home/config/SituationOverviewPanel.tsx    | 155 +++++
 .../features/home/config/SituationStation.tsx | 143 ++++
 .../home/config/WorkflowMapArrows.tsx         | 106 +++
 .../features/home/config/workflowMapLayout.ts | 114 ++++
 .../features/home/fixtures/demoSnapshot.ts    | 423 ++++++++++++
 .../features/home/hooks/useBoundActions.ts    |  48 ++
 .../features/home/hooks/useHomeSnapshot.ts    | 211 ++++++
 .../home/hooks/useRunWorkstreamAction.ts      |  27 +
 .../features/home/hooks/useSkillsForPicker.ts |  14 +
 .../features/home/hooks/useWorkflow.ts        |  16 +
 .../features/home/stores/homeDemoStore.ts     |  23 +
 .../features/home/stores/homeUiStore.ts       |  28 +
 .../home/stores/workflowEditorStore.ts        | 169 +++++
 .../renderer/features/home/subscriptions.ts   |  20 +
 .../features/home/utils/boardColumns.ts       |  61 ++
 .../features/home/utils/situationDisplay.ts   |  48 ++
 .../sidebar/components/SidebarMenu.tsx        |  16 +-
 .../sidebar/components/items/HomeItem.tsx     | 104 +--
 .../sidebar/components/items/InboxItem.tsx    |  63 ++
 .../sidebar/components/items/NewTaskItem.tsx  |  38 ++
 .../features/sidebar/hooks/useSidebarData.ts  |   4 +
 .../src/renderer/stores/navigationStore.ts    |   9 +
 .../src/shared/types/workflow-classify.ts     | 114 ++++
 .../src/shared/types/workflow-validate.ts     |  60 ++
 apps/code/src/shared/types/workflow.ts        | 134 ++++
 docs/home-tab.md                              | 569 ++++++++++++++++
 docs/workflow-architecture.md                 | 230 +++++++
 .../agent/tsup.config.bundled_xsmisnp8nz.mjs  | 152 +++++
 52 files changed, 5815 insertions(+), 82 deletions(-)
 create mode 100644 apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql
 create mode 100644 apps/code/src/main/db/migrations/meta/0007_snapshot.json
 create mode 100644 apps/code/src/main/db/repositories/home-workflow-repository.ts
 create mode 100644 apps/code/src/main/services/workflow/backend.ts
 create mode 100644 apps/code/src/main/services/workflow/default-workflow.ts
 create mode 100644 apps/code/src/main/services/workflow/service.ts
 create mode 100644 apps/code/src/main/trpc/routers/workflow.ts
 create mode 100644 apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
 create mode 100644 apps/code/src/renderer/features/home/components/HomeBoardView.tsx
 create mode 100644 apps/code/src/renderer/features/home/components/HomeEmptyState.tsx
 create mode 100644 apps/code/src/renderer/features/home/components/HomeView.tsx
 create mode 100644 apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
 create mode 100644 apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
 create mode 100644 apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
 create mode 100644 apps/code/src/renderer/features/home/components/SituationChip.tsx
 create mode 100644 apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx
 create mode 100644 apps/code/src/renderer/features/home/config/ConfigMap.tsx
 create mode 100644 apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx
 create mode 100644 apps/code/src/renderer/features/home/config/SituationStation.tsx
 create mode 100644 apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx
 create mode 100644 apps/code/src/renderer/features/home/config/workflowMapLayout.ts
 create mode 100644 apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
 create mode 100644 apps/code/src/renderer/features/home/hooks/useBoundActions.ts
 create mode 100644 apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
 create mode 100644 apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
 create mode 100644 apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts
 create mode 100644 apps/code/src/renderer/features/home/hooks/useWorkflow.ts
 create mode 100644 apps/code/src/renderer/features/home/stores/homeDemoStore.ts
 create mode 100644 apps/code/src/renderer/features/home/stores/homeUiStore.ts
 create mode 100644 apps/code/src/renderer/features/home/stores/workflowEditorStore.ts
 create mode 100644 apps/code/src/renderer/features/home/subscriptions.ts
 create mode 100644 apps/code/src/renderer/features/home/utils/boardColumns.ts
 create mode 100644 apps/code/src/renderer/features/home/utils/situationDisplay.ts
 create mode 100644 apps/code/src/renderer/features/sidebar/components/items/InboxItem.tsx
 create mode 100644 apps/code/src/renderer/features/sidebar/components/items/NewTaskItem.tsx
 create mode 100644 apps/code/src/shared/types/workflow-classify.ts
 create mode 100644 apps/code/src/shared/types/workflow-validate.ts
 create mode 100644 apps/code/src/shared/types/workflow.ts
 create mode 100644 docs/home-tab.md
 create mode 100644 docs/workflow-architecture.md
 create mode 100644 packages/agent/tsup.config.bundled_xsmisnp8nz.mjs

diff --git a/apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql b/apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql
new file mode 100644
index 0000000000..f81209e20a
--- /dev/null
+++ b/apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql
@@ -0,0 +1,6 @@
+CREATE TABLE `home_workflow_config` (
+	`id` text PRIMARY KEY NOT NULL,
+	`version` integer NOT NULL,
+	`json` text NOT NULL,
+	`updated_at` text DEFAULT (CURRENT_TIMESTAMP) NOT NULL
+);
diff --git a/apps/code/src/main/db/migrations/meta/0007_snapshot.json b/apps/code/src/main/db/migrations/meta/0007_snapshot.json
new file mode 100644
index 0000000000..f0215de664
--- /dev/null
+++ b/apps/code/src/main/db/migrations/meta/0007_snapshot.json
@@ -0,0 +1,629 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "ebf61ecd-8a8d-4e18-9a0d-46f6634b381e",
+  "prevId": "805d2ed3-331d-4ba6-8379-30f926268064",
+  "tables": {
+    "archives": {
+      "name": "archives",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "branch_name": {
+          "name": "branch_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "checkpoint_id": {
+          "name": "checkpoint_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "archived_at": {
+          "name": "archived_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {
+        "archives_workspaceId_unique": {
+          "name": "archives_workspaceId_unique",
+          "columns": [
+            "workspace_id"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {
+        "archives_workspace_id_workspaces_id_fk": {
+          "name": "archives_workspace_id_workspaces_id_fk",
+          "tableFrom": "archives",
+          "tableTo": "workspaces",
+          "columnsFrom": [
+            "workspace_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "auth_preferences": {
+      "name": "auth_preferences",
+      "columns": {
+        "account_key": {
+          "name": "account_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "cloud_region": {
+          "name": "cloud_region",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_selected_project_id": {
+          "name": "last_selected_project_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {
+        "auth_preferences_account_region_idx": {
+          "name": "auth_preferences_account_region_idx",
+          "columns": [
+            "account_key",
+            "cloud_region"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "auth_sessions": {
+      "name": "auth_sessions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "refresh_token_encrypted": {
+          "name": "refresh_token_encrypted",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "cloud_region": {
+          "name": "cloud_region",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "selected_project_id": {
+          "name": "selected_project_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "scope_version": {
+          "name": "scope_version",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "default_additional_directories": {
+      "name": "default_additional_directories",
+      "columns": {
+        "path": {
+          "name": "path",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "home_workflow_config": {
+      "name": "home_workflow_config",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "version": {
+          "name": "version",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "json": {
+          "name": "json",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "repositories": {
+      "name": "repositories",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "path": {
+          "name": "path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "remote_url": {
+          "name": "remote_url",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "last_accessed_at": {
+          "name": "last_accessed_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {
+        "repositories_path_unique": {
+          "name": "repositories_path_unique",
+          "columns": [
+            "path"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "suspensions": {
+      "name": "suspensions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "branch_name": {
+          "name": "branch_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "checkpoint_id": {
+          "name": "checkpoint_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "suspended_at": {
+          "name": "suspended_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "reason": {
+          "name": "reason",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {
+        "suspensions_workspaceId_unique": {
+          "name": "suspensions_workspaceId_unique",
+          "columns": [
+            "workspace_id"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {
+        "suspensions_workspace_id_workspaces_id_fk": {
+          "name": "suspensions_workspace_id_workspaces_id_fk",
+          "tableFrom": "suspensions",
+          "tableTo": "workspaces",
+          "columnsFrom": [
+            "workspace_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "workspaces": {
+      "name": "workspaces",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "task_id": {
+          "name": "task_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "repository_id": {
+          "name": "repository_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "mode": {
+          "name": "mode",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "linked_branch": {
+          "name": "linked_branch",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "pinned_at": {
+          "name": "pinned_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "last_viewed_at": {
+          "name": "last_viewed_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "last_activity_at": {
+          "name": "last_activity_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "additional_directories": {
+          "name": "additional_directories",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'[]'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {
+        "workspaces_taskId_unique": {
+          "name": "workspaces_taskId_unique",
+          "columns": [
+            "task_id"
+          ],
+          "isUnique": true
+        },
+        "workspaces_repository_id_idx": {
+          "name": "workspaces_repository_id_idx",
+          "columns": [
+            "repository_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "workspaces_repository_id_repositories_id_fk": {
+          "name": "workspaces_repository_id_repositories_id_fk",
+          "tableFrom": "workspaces",
+          "tableTo": "repositories",
+          "columnsFrom": [
+            "repository_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "worktrees": {
+      "name": "worktrees",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "path": {
+          "name": "path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(CURRENT_TIMESTAMP)"
+        }
+      },
+      "indexes": {
+        "worktrees_workspaceId_unique": {
+          "name": "worktrees_workspaceId_unique",
+          "columns": [
+            "workspace_id"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {
+        "worktrees_workspace_id_workspaces_id_fk": {
+          "name": "worktrees_workspace_id_workspaces_id_fk",
+          "tableFrom": "worktrees",
+          "tableTo": "workspaces",
+          "columnsFrom": [
+            "workspace_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}
\ No newline at end of file
diff --git a/apps/code/src/main/db/migrations/meta/_journal.json b/apps/code/src/main/db/migrations/meta/_journal.json
index 98745d4e45..e36df25195 100644
--- a/apps/code/src/main/db/migrations/meta/_journal.json
+++ b/apps/code/src/main/db/migrations/meta/_journal.json
@@ -50,6 +50,13 @@
       "when": 1777639303535,
       "tag": "0006_youthful_warstar",
       "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "6",
+      "when": 1779956709103,
+      "tag": "0007_remarkable_lord_tyger",
+      "breakpoints": true
     }
   ]
-}
+}
\ No newline at end of file
diff --git a/apps/code/src/main/db/repositories/home-workflow-repository.ts b/apps/code/src/main/db/repositories/home-workflow-repository.ts
new file mode 100644
index 0000000000..db4e3a8911
--- /dev/null
+++ b/apps/code/src/main/db/repositories/home-workflow-repository.ts
@@ -0,0 +1,60 @@
+import { eq } from "drizzle-orm";
+import { inject, injectable } from "inversify";
+import { MAIN_TOKENS } from "../../di/tokens";
+import { homeWorkflowConfig } from "../schema";
+import type { DatabaseService } from "../service";
+
+// Persists the Home workflow row for `LocalWorkflowBackend`. Deletion plan
+// when workflow moves to PostHog: see `docs/workflow-architecture.md`.
+
+export interface PersistedWorkflowRow {
+  id: string;
+  version: number;
+  json: string;
+  updatedAt: string;
+}
+
+@injectable()
+export class HomeWorkflowRepository {
+  constructor(
+    @inject(MAIN_TOKENS.DatabaseService)
+    private readonly databaseService: DatabaseService,
+  ) {}
+
+  private get db() {
+    return this.databaseService.db;
+  }
+
+  findById(id: string): PersistedWorkflowRow | null {
+    const row = this.db
+      .select()
+      .from(homeWorkflowConfig)
+      .where(eq(homeWorkflowConfig.id, id))
+      .get();
+    return row ?? null;
+  }
+
+  upsert(row: PersistedWorkflowRow): void {
+    const existing = this.findById(row.id);
+    if (existing) {
+      this.db
+        .update(homeWorkflowConfig)
+        .set({
+          version: row.version,
+          json: row.json,
+          updatedAt: row.updatedAt,
+        })
+        .where(eq(homeWorkflowConfig.id, row.id))
+        .run();
+      return;
+    }
+    this.db.insert(homeWorkflowConfig).values(row).run();
+  }
+
+  delete(id: string): void {
+    this.db
+      .delete(homeWorkflowConfig)
+      .where(eq(homeWorkflowConfig.id, id))
+      .run();
+  }
+}
diff --git a/apps/code/src/main/db/schema.ts b/apps/code/src/main/db/schema.ts
index 8823ad2744..bc63fda6e2 100644
--- a/apps/code/src/main/db/schema.ts
+++ b/apps/code/src/main/db/schema.ts
@@ -114,3 +114,10 @@ export const authPreferences = sqliteTable(
     ),
   ],
 );
+
+export const homeWorkflowConfig = sqliteTable("home_workflow_config", {
+  id: text().primaryKey(),
+  version: integer().notNull(),
+  json: text().notNull(),
+  updatedAt: updatedAt(),
+});
diff --git a/apps/code/src/main/di/container.ts b/apps/code/src/main/di/container.ts
index b2e2379419..385f3c1e47 100644
--- a/apps/code/src/main/di/container.ts
+++ b/apps/code/src/main/di/container.ts
@@ -5,6 +5,7 @@ import { ArchiveRepository } from "../db/repositories/archive-repository";
 import { AuthPreferenceRepository } from "../db/repositories/auth-preference-repository";
 import { AuthSessionRepository } from "../db/repositories/auth-session-repository";
 import { DefaultAdditionalDirectoryRepository } from "../db/repositories/default-additional-directory-repository";
+import { HomeWorkflowRepository } from "../db/repositories/home-workflow-repository";
 import { RepositoryRepository } from "../db/repositories/repository-repository";
 import { SuspensionRepositoryImpl } from "../db/repositories/suspension-repository";
 import { WorkspaceRepository } from "../db/repositories/workspace-repository";
@@ -69,6 +70,8 @@ import { UIService } from "../services/ui/service";
 import { UpdatesService } from "../services/updates/service";
 import { UsageMonitorService } from "../services/usage-monitor/service";
 import { WatcherRegistryService } from "../services/watcher-registry/service";
+import { LocalWorkflowBackend } from "../services/workflow/backend";
+import { WorkflowService } from "../services/workflow/service";
 import { WorkspaceService } from "../services/workspace/service";
 import { MAIN_TOKENS } from "./tokens";
 
@@ -105,6 +108,7 @@ container.bind(MAIN_TOKENS.SuspensionRepository).to(SuspensionRepositoryImpl);
 container
   .bind(MAIN_TOKENS.DefaultAdditionalDirectoryRepository)
   .to(DefaultAdditionalDirectoryRepository);
+container.bind(MAIN_TOKENS.HomeWorkflowRepository).to(HomeWorkflowRepository);
 container.bind(MAIN_TOKENS.AgentAuthAdapter).to(AgentAuthAdapter);
 container.bind(MAIN_TOKENS.AgentService).to(AgentService);
 container.bind(MAIN_TOKENS.AuthService).to(AuthService);
@@ -153,6 +157,11 @@ container.bind(MAIN_TOKENS.TaskLinkService).to(TaskLinkService);
 container.bind(MAIN_TOKENS.InboxLinkService).to(InboxLinkService);
 container.bind(MAIN_TOKENS.NewTaskLinkService).to(NewTaskLinkService);
 container.bind(MAIN_TOKENS.WatcherRegistryService).to(WatcherRegistryService);
+// Backend choice = the single swap point between POC (local SQLite) and the
+// future PostHog-backed cloud workflow. See docs/workflow-architecture.md
+// and apps/code/src/main/services/workflow/backend.ts for the migration plan.
+container.bind(MAIN_TOKENS.WorkflowBackend).to(LocalWorkflowBackend);
+container.bind(MAIN_TOKENS.WorkflowService).to(WorkflowService);
 container.bind(MAIN_TOKENS.WorkspaceService).to(WorkspaceService);
 
 container.bind(MAIN_TOKENS.SettingsStore).toConstantValue(settingsStore);
diff --git a/apps/code/src/main/di/tokens.ts b/apps/code/src/main/di/tokens.ts
index 69ea894b37..f23393745b 100644
--- a/apps/code/src/main/di/tokens.ts
+++ b/apps/code/src/main/di/tokens.ts
@@ -37,6 +37,7 @@ export const MAIN_TOKENS = Object.freeze({
   DefaultAdditionalDirectoryRepository: Symbol.for(
     "Main.DefaultAdditionalDirectoryRepository",
   ),
+  HomeWorkflowRepository: Symbol.for("Main.HomeWorkflowRepository"),
 
   // Services
   AgentAuthAdapter: Symbol.for("Main.AgentAuthAdapter"),
@@ -84,4 +85,6 @@ export const MAIN_TOKENS = Object.freeze({
   WorkspaceService: Symbol.for("Main.WorkspaceService"),
   EnrichmentService: Symbol.for("Main.EnrichmentService"),
   UsageMonitorService: Symbol.for("Main.UsageMonitorService"),
+  WorkflowBackend: Symbol.for("Main.WorkflowBackend"),
+  WorkflowService: Symbol.for("Main.WorkflowService"),
 });
diff --git a/apps/code/src/main/services/workflow/backend.ts b/apps/code/src/main/services/workflow/backend.ts
new file mode 100644
index 0000000000..503907dd25
--- /dev/null
+++ b/apps/code/src/main/services/workflow/backend.ts
@@ -0,0 +1,81 @@
+import type { HomeWorkflowRepository } from "@main/db/repositories/home-workflow-repository";
+import { MAIN_TOKENS } from "@main/di/tokens";
+import { logger } from "@main/utils/logger";
+import { type WorkflowConfig, workflowConfig } from "@shared/types/workflow";
+import { inject, injectable } from "inversify";
+
+const log = logger.scope("workflow-backend");
+
+/**
+ * Single seam between `WorkflowService` and where the workflow config lives.
+ * Today: local SQLite ({@link LocalWorkflowBackend}). When PostHog gains
+ * cross-device workflow storage, a `CloudWorkflowBackend` replaces this
+ * binding — see `docs/workflow-architecture.md` for the migration plan.
+ *
+ * Stability contract for any implementation:
+ * - `version` is monotonic. `save` is the only caller that bumps it.
+ * - `load()` returns `null` for "no config yet" rather than throwing.
+ * - Implementations validate against `workflowConfig` and drop bad rows
+ *   on read (returning `null` so the service reseeds).
+ * - `delete()` is idempotent.
+ */
+export interface WorkflowBackend {
+  load(): Promise<WorkflowConfig | null>;
+  save(config: WorkflowConfig): Promise<void>;
+  delete(): Promise<void>;
+}
+
+const WORKFLOW_ID = "default";
+
+@injectable()
+export class LocalWorkflowBackend implements WorkflowBackend {
+  constructor(
+    @inject(MAIN_TOKENS.HomeWorkflowRepository)
+    private readonly repository: HomeWorkflowRepository,
+  ) {}
+
+  async load(): Promise<WorkflowConfig | null> {
+    const row = this.repository.findById(WORKFLOW_ID);
+    if (!row) return null;
+
+    let raw: unknown;
+    try {
+      raw = JSON.parse(row.json);
+    } catch (err) {
+      log.warn("Persisted workflow JSON is corrupt — dropping row", {
+        error: err instanceof Error ? err.message : String(err),
+      });
+      this.repository.delete(WORKFLOW_ID);
+      return null;
+    }
+
+    // Authoritative `version` + `updatedAt` come from the row, not the JSON
+    // body, so a stale field in the blob can't shadow the monotonic counter.
+    const parsed = workflowConfig.safeParse({
+      ...(typeof raw === "object" && raw !== null ? raw : {}),
+      version: row.version,
+      updatedAt: row.updatedAt,
+    });
+    if (!parsed.success) {
+      log.warn("Persisted workflow no longer matches schema — dropping row", {
+        error: parsed.error.message,
+      });
+      this.repository.delete(WORKFLOW_ID);
+      return null;
+    }
+    return parsed.data;
+  }
+
+  async save(config: WorkflowConfig): Promise<void> {
+    this.repository.upsert({
+      id: WORKFLOW_ID,
+      version: config.version,
+      json: JSON.stringify(config),
+      updatedAt: config.updatedAt,
+    });
+  }
+
+  async delete(): Promise<void> {
+    this.repository.delete(WORKFLOW_ID);
+  }
+}
diff --git a/apps/code/src/main/services/workflow/default-workflow.ts b/apps/code/src/main/services/workflow/default-workflow.ts
new file mode 100644
index 0000000000..8a34dcbf7a
--- /dev/null
+++ b/apps/code/src/main/services/workflow/default-workflow.ts
@@ -0,0 +1,59 @@
+import type { WorkflowConfig } from "@shared/types/workflow";
+
+// Seed config: applied on first run and on "Reset to default".
+export function buildDefaultWorkflow(): WorkflowConfig {
+  return {
+    id: "default",
+    version: 1,
+    updatedAt: new Date(0).toISOString(),
+    bindings: {
+      working: [
+        {
+          id: "create_pr",
+          label: "Create PR",
+          skillId: "create-pr",
+          prompt:
+            "Open a PR for the current branch. Use the task history to write a concise description.",
+        },
+      ],
+      in_review: [],
+      ci_failing: [
+        {
+          id: "fix_ci",
+          label: "Fix CI",
+          skillId: "fix-ci",
+          prompt:
+            "CI is failing on this PR. Investigate the failing checks and push a fix.",
+        },
+      ],
+      changes_requested: [
+        {
+          id: "address_comments",
+          label: "Address review",
+          skillId: "address-comments",
+          prompt:
+            "Address the change requests on this PR — read the latest review and respond with code.",
+        },
+      ],
+      comments_waiting: [
+        {
+          id: "address_threads",
+          label: "Address comments",
+          skillId: "address-comments",
+          prompt: "Address the unresolved review comments on this PR.",
+        },
+      ],
+      ready_to_merge: [
+        {
+          id: "final_check",
+          label: "Final check",
+          skillId: "code-review",
+          prompt:
+            "Do a last-pass review of this PR. Call out anything risky before I merge.",
+        },
+      ],
+      stale: [],
+      done: [],
+    },
+  };
+}
diff --git a/apps/code/src/main/services/workflow/service.ts b/apps/code/src/main/services/workflow/service.ts
new file mode 100644
index 0000000000..c84ab4abf4
--- /dev/null
+++ b/apps/code/src/main/services/workflow/service.ts
@@ -0,0 +1,111 @@
+import {
+  type SaveInput,
+  type SaveResult,
+  type WorkflowConfig,
+  WorkflowEvent,
+  type WorkflowEvents,
+} from "@shared/types/workflow";
+import { validateWorkflow } from "@shared/types/workflow-validate";
+import { inject, injectable, postConstruct } from "inversify";
+import { MAIN_TOKENS } from "../../di/tokens";
+import { logger } from "../../utils/logger";
+import { TypedEventEmitter } from "../../utils/typed-event-emitter";
+import type { WorkflowBackend } from "./backend";
+import { buildDefaultWorkflow } from "./default-workflow";
+
+const WORKFLOW_ID = "default";
+const log = logger.scope("workflow");
+
+/**
+ * Owns the workflow lifecycle (load → seed default → save → emit
+ * `WorkflowChanged`). Storage details live behind {@link WorkflowBackend}
+ * so this service is the same code whether persistence is local SQLite
+ * or a remote PostHog API — see `docs/workflow-architecture.md`.
+ */
+@injectable()
+export class WorkflowService extends TypedEventEmitter<WorkflowEvents> {
+  private cached: WorkflowConfig | null = null;
+  private inflightLoad: Promise<WorkflowConfig> | null = null;
+
+  constructor(
+    @inject(MAIN_TOKENS.WorkflowBackend)
+    private readonly backend: WorkflowBackend,
+  ) {
+    super();
+  }
+
+  @postConstruct()
+  init(): void {
+    void this.get();
+  }
+
+  async get(): Promise<WorkflowConfig> {
+    if (this.cached) return this.cached;
+    // Dedup concurrent first-load callers behind one in-flight promise.
+    if (this.inflightLoad) return this.inflightLoad;
+    this.inflightLoad = this.loadOrSeed().finally(() => {
+      this.inflightLoad = null;
+    });
+    return this.inflightLoad;
+  }
+
+  async save(input: SaveInput): Promise<SaveResult> {
+    const current = await this.get();
+    if (current.version !== input.expectedVersion) {
+      return { status: "conflict", config: current };
+    }
+    const validation = validateWorkflow(input.config);
+    if (!validation.canSave) {
+      return {
+        status: "invalid",
+        config: current,
+        diagnostics: validation.diagnostics,
+      };
+    }
+    const next: WorkflowConfig = {
+      ...input.config,
+      id: WORKFLOW_ID,
+      version: current.version + 1,
+      updatedAt: new Date().toISOString(),
+    };
+    await this.backend.save(next);
+    this.cached = next;
+    this.emit(WorkflowEvent.Changed, next);
+    log.info("Workflow saved", {
+      version: next.version,
+      actionCount: Object.values(next.bindings).reduce(
+        (sum, list) => sum + list.length,
+        0,
+      ),
+    });
+    return { status: "saved", config: next };
+  }
+
+  async resetToDefault(): Promise<WorkflowConfig> {
+    const current = await this.get();
+    const fresh = buildDefaultWorkflow();
+    const next: WorkflowConfig = {
+      ...fresh,
+      version: current.version + 1,
+      updatedAt: new Date().toISOString(),
+    };
+    await this.backend.save(next);
+    this.cached = next;
+    this.emit(WorkflowEvent.Changed, next);
+    log.info("Workflow reset to default", { version: next.version });
+    return next;
+  }
+
+  private async loadOrSeed(): Promise<WorkflowConfig> {
+    const loaded = await this.backend.load();
+    if (loaded) {
+      this.cached = loaded;
+      return loaded;
+    }
+    const seed = buildDefaultWorkflow();
+    await this.backend.save(seed);
+    this.cached = seed;
+    log.info("Seeded default workflow", { version: seed.version });
+    return seed;
+  }
+}
diff --git a/apps/code/src/main/trpc/router.ts b/apps/code/src/main/trpc/router.ts
index f0f8dd9eb5..53449b0297 100644
--- a/apps/code/src/main/trpc/router.ts
+++ b/apps/code/src/main/trpc/router.ts
@@ -37,6 +37,7 @@ import { suspensionRouter } from "./routers/suspension.js";
 import { uiRouter } from "./routers/ui";
 import { updatesRouter } from "./routers/updates";
 import { usageMonitorRouter } from "./routers/usage-monitor";
+import { workflowRouter } from "./routers/workflow";
 import { workspaceRouter } from "./routers/workspace";
 import { router } from "./trpc";
 
@@ -81,6 +82,7 @@ export const trpcRouter = router({
   updates: updatesRouter,
   usageMonitor: usageMonitorRouter,
   deepLink: deepLinkRouter,
+  workflow: workflowRouter,
   workspace: workspaceRouter,
 });
 
diff --git a/apps/code/src/main/trpc/routers/workflow.ts b/apps/code/src/main/trpc/routers/workflow.ts
new file mode 100644
index 0000000000..fdb4420e9c
--- /dev/null
+++ b/apps/code/src/main/trpc/routers/workflow.ts
@@ -0,0 +1,36 @@
+import {
+  saveInput,
+  saveResult,
+  WorkflowEvent,
+  type WorkflowEvents,
+  workflowConfig,
+} from "@shared/types/workflow";
+import { container } from "../../di/container";
+import { MAIN_TOKENS } from "../../di/tokens";
+import type { WorkflowService } from "../../services/workflow/service";
+import { publicProcedure, router } from "../trpc";
+
+const getService = () =>
+  container.get<WorkflowService>(MAIN_TOKENS.WorkflowService);
+
+function subscribe<K extends keyof WorkflowEvents>(event: K) {
+  return publicProcedure.subscription(async function* (opts) {
+    const service = getService();
+    const iterable = service.toIterable(event, { signal: opts.signal });
+    for await (const data of iterable) {
+      yield data;
+    }
+  });
+}
+
+export const workflowRouter = router({
+  get: publicProcedure.output(workflowConfig).query(() => getService().get()),
+  save: publicProcedure
+    .input(saveInput)
+    .output(saveResult)
+    .mutation(({ input }) => getService().save(input)),
+  resetToDefault: publicProcedure
+    .output(workflowConfig)
+    .mutation(() => getService().resetToDefault()),
+  onChanged: subscribe(WorkflowEvent.Changed),
+});
diff --git a/apps/code/src/renderer/App.tsx b/apps/code/src/renderer/App.tsx
index 03e55f4c79..70dd9173fb 100644
--- a/apps/code/src/renderer/App.tsx
+++ b/apps/code/src/renderer/App.tsx
@@ -14,6 +14,7 @@ import { useAuthSession } from "@features/auth/hooks/useAuthSession";
 import { useIsOrgAdmin } from "@features/auth/hooks/useOrgRole";
 import { registerBillingSubscriptions } from "@features/billing/subscriptions";
 import { AddDirectoryDialog } from "@features/folder-picker/components/AddDirectoryDialog";
+import { registerHomeSubscriptions } from "@features/home/subscriptions";
 import { OnboardingFlow } from "@features/onboarding/components/OnboardingFlow";
 import { useOnboardingStore } from "@features/onboarding/stores/onboardingStore";
 import { Flex, Spinner, Text } from "@radix-ui/themes";
@@ -75,6 +76,11 @@ function App() {
     return registerBillingSubscriptions();
   }, [isAuthenticated]);
 
+  useEffect(() => {
+    if (!isAuthenticated) return;
+    return registerHomeSubscriptions();
+  }, [isAuthenticated]);
+
   // Initialize update store
   useEffect(() => {
     return initializeUpdateStore();
diff --git a/apps/code/src/renderer/components/MainLayout.tsx b/apps/code/src/renderer/components/MainLayout.tsx
index ff1d04eecf..42a9133feb 100644
--- a/apps/code/src/renderer/components/MainLayout.tsx
+++ b/apps/code/src/renderer/components/MainLayout.tsx
@@ -7,6 +7,7 @@ import { ArchivedTasksView } from "@features/archive/components/ArchivedTasksVie
 import { UsageLimitModal } from "@features/billing/components/UsageLimitModal";
 import { CommandMenu } from "@features/command/components/CommandMenu";
 import { CommandCenterView } from "@features/command-center/components/CommandCenterView";
+import { HomeView } from "@features/home/components/HomeView";
 import { InboxView } from "@features/inbox/components/InboxView";
 import { useInboxDeepLink } from "@features/inbox/hooks/useInboxDeepLink";
 import { McpServersView } from "@features/mcp-servers/components/McpServersView";
@@ -167,6 +168,8 @@ export function MainLayout() {
 
           {view.type === "folder-settings" && <FolderSettingsView />}
 
+          {view.type === "home" && <HomeView />}
+
           {view.type === "inbox" && <InboxView />}
 
           {view.type === "archived" && <ArchivedTasksView />}
diff --git a/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
new file mode 100644
index 0000000000..8416c7067c
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
@@ -0,0 +1,91 @@
+import { CircleNotch, GitBranch, Warning } from "@phosphor-icons/react";
+import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
+import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import { useNavigationStore } from "@stores/navigationStore";
+import { formatRelativeTimeShort } from "@utils/time";
+import type { HomeActiveAgent } from "../hooks/useHomeSnapshot";
+
+interface HomeActiveAgentsStripProps {
+  agents: HomeActiveAgent[];
+}
+
+export function HomeActiveAgentsStrip({ agents }: HomeActiveAgentsStripProps) {
+  const { data: tasks = [] } = useTasks();
+  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
+
+  if (agents.length === 0) return null;
+
+  return (
+    <Box className="border-(--gray-4) border-b px-5 py-3">
+      <Flex align="center" gap="2" mb="2">
+        <CircleNotch
+          size={12}
+          className="animate-spin text-(--gray-10)"
+          weight="bold"
+        />
+        <Text className="font-medium text-(--gray-11) text-[11px] uppercase tracking-wide">
+          Running ({agents.length})
+        </Text>
+      </Flex>
+      <ScrollArea scrollbars="horizontal">
+        <Flex gap="2" className="pb-1">
+          {agents.map((agent) => {
+            const task = tasks.find((t) => t.id === agent.taskId);
+            return (
+              <button
+                key={agent.taskId}
+                type="button"
+                onClick={() => {
+                  if (task) navigateToTask(task);
+                }}
+                className="group flex min-w-[260px] max-w-[320px] shrink-0 cursor-pointer flex-col items-start gap-1 rounded-md border border-(--gray-4) bg-(--gray-2) px-3 py-2 text-left hover:border-(--gray-6) hover:bg-(--gray-3)"
+              >
+                <Flex
+                  align="center"
+                  gap="1"
+                  justify="between"
+                  className="w-full"
+                >
+                  <Text
+                    className="truncate font-medium text-[13px] text-gray-12 leading-tight"
+                    title={agent.title}
+                  >
+                    {agent.title || "Untitled task"}
+                  </Text>
+                  <Text className="shrink-0 text-(--gray-10) text-[11px]">
+                    {formatRelativeTimeShort(agent.lastActivityAt)}
+                  </Text>
+                </Flex>
+                <Flex
+                  align="center"
+                  gap="2"
+                  className="w-full text-(--gray-10) text-[11px]"
+                >
+                  {agent.branch ? (
+                    <Flex align="center" gap="1" className="min-w-0">
+                      <GitBranch size={10} />
+                      <span className="truncate" title={agent.branch}>
+                        {agent.branch}
+                      </span>
+                    </Flex>
+                  ) : null}
+                  {agent.needsPermission ? (
+                    <Flex
+                      align="center"
+                      gap="1"
+                      className="text-(--amber-11)"
+                      title="Waiting on permission"
+                    >
+                      <Warning size={10} weight="fill" />
+                      <span>Needs input</span>
+                    </Flex>
+                  ) : null}
+                </Flex>
+              </button>
+            );
+          })}
+        </Flex>
+      </ScrollArea>
+    </Box>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
new file mode 100644
index 0000000000..263ae067cd
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
@@ -0,0 +1,64 @@
+import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
+import type { HomeSnapshot } from "../hooks/useHomeSnapshot";
+import { buildBoardColumns } from "../utils/boardColumns";
+import { HomeWorkstreamCard } from "./HomeWorkstreamCard";
+
+interface HomeBoardViewProps {
+  snapshot: HomeSnapshot;
+}
+
+export function HomeBoardView({ snapshot }: HomeBoardViewProps) {
+  const columns = buildBoardColumns(
+    snapshot.needsAttention,
+    snapshot.inProgress,
+  );
+
+  return (
+    <ScrollArea scrollbars="horizontal">
+      <Flex gap="3" className="h-full min-h-0 p-4">
+        {columns.map((column) => (
+          <Flex
+            key={column.id}
+            direction="column"
+            className="min-h-0 w-[300px] shrink-0"
+          >
+            <Box className="mb-2">
+              <Flex align="baseline" justify="between" gap="2">
+                <Text className="font-semibold text-[12px] text-gray-12 uppercase tracking-wide">
+                  {column.title}
+                </Text>
+                <Text className="text-(--gray-10) text-[11px]">
+                  {column.workstreams.length}
+                </Text>
+              </Flex>
+              <Text className="text-(--gray-10) text-[11px]">
+                {column.description}
+              </Text>
+            </Box>
+            <Flex
+              direction="column"
+              gap="2"
+              className="min-h-[120px] rounded-md bg-(--gray-2) p-2"
+            >
+              {column.workstreams.length === 0 ? (
+                <Flex
+                  align="center"
+                  justify="center"
+                  className="h-[100px] rounded-md border border-(--gray-4) border-dashed"
+                >
+                  <Text className="text-(--gray-9) text-[11px]">
+                    Nothing here
+                  </Text>
+                </Flex>
+              ) : (
+                column.workstreams.map((ws) => (
+                  <HomeWorkstreamCard key={ws.id} workstream={ws} />
+                ))
+              )}
+            </Flex>
+          </Flex>
+        ))}
+      </Flex>
+    </ScrollArea>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/components/HomeEmptyState.tsx b/apps/code/src/renderer/features/home/components/HomeEmptyState.tsx
new file mode 100644
index 0000000000..b140e27cb4
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/HomeEmptyState.tsx
@@ -0,0 +1,42 @@
+import { CheckCircle, Plus } from "@phosphor-icons/react";
+import { Button } from "@posthog/quill";
+import { Flex, Text } from "@radix-ui/themes";
+import { useNavigationStore } from "@stores/navigationStore";
+
+interface HomeEmptyStateProps {
+  hasRunningAgents: boolean;
+}
+
+export function HomeEmptyState({ hasRunningAgents }: HomeEmptyStateProps) {
+  const navigateToTaskInput = useNavigationStore((s) => s.navigateToTaskInput);
+
+  return (
+    <Flex
+      direction="column"
+      align="center"
+      justify="center"
+      gap="3"
+      className="h-full px-5 py-12"
+    >
+      <CheckCircle size={36} className="text-(--green-9)" weight="duotone" />
+      <Text className="font-medium text-[15px] text-gray-12">
+        You're caught up
+      </Text>
+      <Text className="max-w-[360px] text-center text-(--gray-11) text-[13px]">
+        {hasRunningAgents
+          ? "Nothing else needs your attention. Your active agents are working."
+          : "Nothing needs your attention right now. Start something new when you're ready."}
+      </Text>
+      {!hasRunningAgents ? (
+        <Button
+          variant="primary"
+          size="sm"
+          onClick={() => navigateToTaskInput()}
+        >
+          <Plus size={12} />
+          New task
+        </Button>
+      ) : null}
+    </Flex>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/components/HomeView.tsx b/apps/code/src/renderer/features/home/components/HomeView.tsx
new file mode 100644
index 0000000000..32a679fc87
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/HomeView.tsx
@@ -0,0 +1,306 @@
+import { DotsCircleSpinner } from "@components/DotsCircleSpinner";
+import { useSetHeaderContent } from "@hooks/useSetHeaderContent";
+import {
+  Flask,
+  Graph,
+  House,
+  Kanban,
+  ListBullets,
+  Warning,
+} from "@phosphor-icons/react";
+import { Badge, Button } from "@posthog/quill";
+import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
+import { useEffect, useMemo } from "react";
+import { ConfigMap } from "../config/ConfigMap";
+import { useHomeSnapshot } from "../hooks/useHomeSnapshot";
+import {
+  type HomeDemoScenario,
+  useHomeDemoStore,
+} from "../stores/homeDemoStore";
+import { type HomeViewMode, useHomeUiStore } from "../stores/homeUiStore";
+import { HomeActiveAgentsStrip } from "./HomeActiveAgentsStrip";
+import { HomeBoardView } from "./HomeBoardView";
+import { HomeEmptyState } from "./HomeEmptyState";
+import { HomeWorkstreamDetailPanel } from "./HomeWorkstreamDetailPanel";
+import { HomeWorkstreamRow } from "./HomeWorkstreamRow";
+
+const VIEW_CYCLE: HomeViewMode[] = ["list", "board", "config"];
+
+export function HomeView() {
+  const { snapshot, isLoading, isDemo } = useHomeSnapshot();
+  const demoScenario = useHomeDemoStore((s) => s.scenario);
+  const setDemoScenario = useHomeDemoStore((s) => s.setScenario);
+  const viewMode = useHomeUiStore((s) => s.viewMode);
+  const setViewMode = useHomeUiStore((s) => s.setViewMode);
+  const selectedWorkstreamId = useHomeUiStore((s) => s.selectedWorkstreamId);
+  const setSelectedWorkstreamId = useHomeUiStore(
+    (s) => s.setSelectedWorkstreamId,
+  );
+
+  const headerContent = useMemo(
+    () => (
+      <Flex align="center" gap="2" className="w-full min-w-0">
+        <House size={12} className="shrink-0 text-gray-10" />
+        <Text
+          className="truncate whitespace-nowrap font-medium text-[13px]"
+          title="Home"
+        >
+          Home
+        </Text>
+      </Flex>
+    ),
+    [],
+  );
+  useSetHeaderContent(headerContent);
+
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      if (e.key !== "v" || e.metaKey || e.ctrlKey || e.altKey) return;
+      // Don't capture `v` while the user is typing.
+      const target = e.target as HTMLElement | null;
+      const tag = target?.tagName;
+      if (tag === "INPUT" || tag === "TEXTAREA" || target?.isContentEditable) {
+        return;
+      }
+      const idx = VIEW_CYCLE.indexOf(viewMode);
+      setViewMode(VIEW_CYCLE[(idx + 1) % VIEW_CYCLE.length] ?? "list");
+    }
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [viewMode, setViewMode]);
+
+  useEffect(() => {
+    if (!selectedWorkstreamId) return;
+    function onKey(e: KeyboardEvent) {
+      if (e.key === "Escape") setSelectedWorkstreamId(null);
+    }
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [selectedWorkstreamId, setSelectedWorkstreamId]);
+
+  if (isLoading) {
+    return (
+      <Flex align="center" justify="center" className="h-full">
+        <DotsCircleSpinner size={16} className="text-gray-10" />
+      </Flex>
+    );
+  }
+
+  const { activeAgents, needsAttention, inProgress } = snapshot;
+  const totalRows = needsAttention.length + inProgress.length;
+  const hasContent = activeAgents.length > 0 || totalRows > 0;
+
+  const selectedWorkstream = selectedWorkstreamId
+    ? (needsAttention.find((ws) => ws.id === selectedWorkstreamId) ??
+      inProgress.find((ws) => ws.id === selectedWorkstreamId) ??
+      null)
+    : null;
+
+  const summary = [
+    needsAttention.length > 0
+      ? `${needsAttention.length} need${needsAttention.length === 1 ? "s" : ""} attention`
+      : null,
+    activeAgents.length > 0 ? `${activeAgents.length} running` : null,
+    inProgress.length > 0 ? `${inProgress.length} in progress` : null,
+  ]
+    .filter(Boolean)
+    .join(" · ");
+
+  return (
+    <Flex direction="column" className="h-full">
+      <Box className="border-(--gray-4) border-b px-5 py-3">
+        <Flex align="center" justify="between" gap="3">
+          <Flex direction="column" gap="1" className="min-w-0">
+            <Flex align="center" gap="2">
+              <Text className="font-semibold text-[15px] text-gray-12">
+                Home
+              </Text>
+              {isDemo ? (
+                <Badge
+                  variant="info"
+                  title="Showing fixture data — not your real workspaces"
+                >
+                  Demo data
+                </Badge>
+              ) : null}
+            </Flex>
+            <Text className="text-(--gray-11) text-[12px]">
+              {summary || "You're caught up"}
+            </Text>
+          </Flex>
+          <Flex align="center" gap="2" className="shrink-0">
+            <ViewModeToggle value={viewMode} onChange={setViewMode} />
+            {viewMode !== "config" ? (
+              <DemoScenarioPicker
+                value={demoScenario}
+                onChange={setDemoScenario}
+              />
+            ) : null}
+          </Flex>
+        </Flex>
+      </Box>
+
+      {viewMode === "config" ? (
+        <Box className="min-h-0 flex-1">
+          <ConfigMap />
+        </Box>
+      ) : (
+        <>
+          <HomeActiveAgentsStrip agents={activeAgents} />
+          <Flex className="min-h-0 flex-1">
+            <Box className="min-w-0 flex-1">
+              {!hasContent && totalRows === 0 ? (
+                <HomeEmptyState hasRunningAgents={activeAgents.length > 0} />
+              ) : viewMode === "board" ? (
+                <Box className="h-full min-h-0">
+                  <HomeBoardView snapshot={snapshot} />
+                </Box>
+              ) : (
+                <ScrollArea>
+                  {needsAttention.length > 0 ? (
+                    <Section
+                      title="Needs attention"
+                      icon={
+                        <Warning
+                          size={12}
+                          weight="fill"
+                          className="text-(--amber-11)"
+                        />
+                      }
+                      count={needsAttention.length}
+                    >
+                      {needsAttention.map((ws) => (
+                        <HomeWorkstreamRow key={ws.id} workstream={ws} />
+                      ))}
+                    </Section>
+                  ) : null}
+
+                  {inProgress.length > 0 ? (
+                    <Section title="In progress" count={inProgress.length}>
+                      {inProgress.map((ws) => (
+                        <HomeWorkstreamRow key={ws.id} workstream={ws} />
+                      ))}
+                    </Section>
+                  ) : null}
+
+                  {totalRows === 0 && activeAgents.length > 0 ? (
+                    <HomeEmptyState hasRunningAgents />
+                  ) : null}
+                </ScrollArea>
+              )}
+            </Box>
+            {selectedWorkstream ? (
+              <Box className="w-[400px] shrink-0 border-(--gray-4) border-l">
+                <HomeWorkstreamDetailPanel
+                  workstream={selectedWorkstream}
+                  onClose={() => setSelectedWorkstreamId(null)}
+                />
+              </Box>
+            ) : null}
+          </Flex>
+        </>
+      )}
+    </Flex>
+  );
+}
+
+interface SectionProps {
+  title: string;
+  count: number;
+  icon?: React.ReactNode;
+  children: React.ReactNode;
+}
+
+const DEMO_OPTIONS: { value: HomeDemoScenario; label: string }[] = [
+  { value: "off", label: "Real" },
+  { value: "populated", label: "Demo" },
+  { value: "empty", label: "Empty" },
+];
+
+interface DemoScenarioPickerProps {
+  value: HomeDemoScenario;
+  onChange: (next: HomeDemoScenario) => void;
+}
+
+function DemoScenarioPicker({ value, onChange }: DemoScenarioPickerProps) {
+  return (
+    <Flex
+      align="center"
+      gap="1"
+      className="shrink-0 rounded-md border border-(--gray-4) bg-(--gray-2) p-0.5"
+      title="Switch between real data and demo fixtures (prototype only)"
+    >
+      <Flask size={11} className="ml-1 text-(--gray-10)" />
+      {DEMO_OPTIONS.map((opt) => (
+        <Button
+          key={opt.value}
+          size="xs"
+          variant={value === opt.value ? "primary" : "link-muted"}
+          onClick={() => onChange(opt.value)}
+        >
+          {opt.label}
+        </Button>
+      ))}
+    </Flex>
+  );
+}
+
+interface ViewModeToggleProps {
+  value: HomeViewMode;
+  onChange: (next: HomeViewMode) => void;
+}
+
+function ViewModeToggle({ value, onChange }: ViewModeToggleProps) {
+  return (
+    <Flex
+      align="center"
+      gap="1"
+      className="shrink-0 rounded-md border border-(--gray-4) bg-(--gray-2) p-0.5"
+      title="Switch view (press v to cycle)"
+    >
+      <Button
+        size="xs"
+        variant={value === "list" ? "primary" : "link-muted"}
+        onClick={() => onChange("list")}
+      >
+        <ListBullets size={12} />
+        List
+      </Button>
+      <Button
+        size="xs"
+        variant={value === "board" ? "primary" : "link-muted"}
+        onClick={() => onChange("board")}
+      >
+        <Kanban size={12} />
+        Board
+      </Button>
+      <Button
+        size="xs"
+        variant={value === "config" ? "primary" : "link-muted"}
+        onClick={() => onChange("config")}
+      >
+        <Graph size={12} />
+        Config
+      </Button>
+    </Flex>
+  );
+}
+
+function Section({ title, count, icon, children }: SectionProps) {
+  return (
+    <Box>
+      <Flex
+        align="center"
+        gap="2"
+        className="border-(--gray-4) border-b bg-(--gray-2) px-5 py-2"
+      >
+        {icon}
+        <Text className="font-medium text-(--gray-11) text-[11px] uppercase tracking-wide">
+          {title}
+        </Text>
+        <Text className="text-(--gray-10) text-[11px]">({count})</Text>
+      </Flex>
+      {children}
+    </Box>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
new file mode 100644
index 0000000000..ded9b6ad76
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
@@ -0,0 +1,236 @@
+import {
+  CaretDown,
+  CheckCircle,
+  GitBranch,
+  Sparkle,
+  Warning,
+  XCircle,
+} from "@phosphor-icons/react";
+import { Button } from "@posthog/quill";
+import { Box, DropdownMenu, Flex, Text } from "@radix-ui/themes";
+import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import { useNavigationStore } from "@stores/navigationStore";
+import { openUrlInBrowser } from "@utils/browser";
+import { formatRelativeTimeShort } from "@utils/time";
+import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
+import type { HomePullRequest, HomeWorkstream } from "../hooks/useHomeSnapshot";
+import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
+import { useHomeUiStore } from "../stores/homeUiStore";
+import {
+  severityRingClass,
+  situationSeverity,
+} from "../utils/situationDisplay";
+import { SituationChip } from "./SituationChip";
+
+interface HomeWorkstreamCardProps {
+  workstream: HomeWorkstream;
+}
+
+function CiDot({ status }: { status: HomePullRequest["ciStatus"] }) {
+  if (status === "passing") {
+    return (
+      <span title="CI passing">
+        <CheckCircle size={11} weight="fill" className="text-(--green-9)" />
+      </span>
+    );
+  }
+  if (status === "failing") {
+    return (
+      <span title="CI failing">
+        <XCircle size={11} weight="fill" className="text-(--red-9)" />
+      </span>
+    );
+  }
+  if (status === "pending") {
+    return (
+      <span
+        className="inline-block h-[8px] w-[8px] animate-pulse rounded-full bg-(--amber-9)"
+        title="CI pending"
+      />
+    );
+  }
+  return null;
+}
+
+export function HomeWorkstreamCard({ workstream }: HomeWorkstreamCardProps) {
+  const { data: tasks = [] } = useTasks();
+  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
+  const boundActions = useBoundActions(workstream);
+  const runAction = useRunWorkstreamAction();
+  const setSelectedWorkstreamId = useHomeUiStore(
+    (s) => s.setSelectedWorkstreamId,
+  );
+  const isSelected = useHomeUiStore(
+    (s) => s.selectedWorkstreamId === workstream.id,
+  );
+
+  const headTask = workstream.tasks[0];
+  const pr = workstream.pr;
+  const title =
+    pr?.title ?? headTask?.title ?? workstream.branch ?? "Workstream";
+  const taskCount = workstream.tasks.length;
+  const severity = situationSeverity(workstream.situations);
+  const primaryBound = boundActions[0] ?? null;
+  const overflowBound = boundActions.slice(1);
+
+  function handleRunAction(action: BoundAction) {
+    runAction(action, workstream);
+  }
+
+  function handleOpenTask() {
+    if (!headTask) return;
+    const task = tasks.find((t) => t.id === headTask.id);
+    if (task) navigateToTask(task);
+  }
+
+  function handleOpenPr() {
+    if (workstream.prUrl) void openUrlInBrowser(workstream.prUrl);
+  }
+
+  return (
+    <Box
+      onClick={() => setSelectedWorkstreamId(workstream.id)}
+      onKeyDown={(e) => {
+        if (e.key === "Enter" || e.key === " ") {
+          e.preventDefault();
+          setSelectedWorkstreamId(workstream.id);
+        }
+      }}
+      role="button"
+      tabIndex={0}
+      aria-label={`Open ${title}`}
+      className={`cursor-pointer rounded-md border border-(--gray-4) bg-(--color-panel-solid) p-3 transition-colors hover:border-(--gray-6) hover:shadow-sm ${
+        isSelected ? "border-(--accent-9) ring-(--accent-7) ring-2" : ""
+      } ${severityRingClass(severity)}`}
+    >
+      <Flex direction="column" gap="2">
+        <Flex align="start" justify="between" gap="2">
+          <Text
+            className="line-clamp-2 font-medium text-[13px] text-gray-12 leading-tight"
+            title={title}
+          >
+            {title}
+          </Text>
+          {pr ? <CiDot status={pr.ciStatus} /> : null}
+        </Flex>
+
+        <Flex
+          align="center"
+          gap="2"
+          wrap="wrap"
+          className="text-(--gray-10) text-[11px]"
+        >
+          {workstream.repoName ? (
+            <Text title="Repository">{workstream.repoName}</Text>
+          ) : null}
+          {workstream.branch ? (
+            <Flex align="center" gap="1" className="min-w-0">
+              <GitBranch size={10} />
+              <span
+                className="max-w-[140px] truncate"
+                title={workstream.branch}
+              >
+                {workstream.branch}
+              </span>
+            </Flex>
+          ) : null}
+          {pr ? <Text>#{pr.number}</Text> : null}
+          <Text>{formatRelativeTimeShort(workstream.lastActivityAt)}</Text>
+        </Flex>
+
+        {workstream.situations.length > 0 ? (
+          <Flex align="center" gap="1" wrap="wrap">
+            {workstream.situations.map((sid) => (
+              <SituationChip key={sid} sid={sid} />
+            ))}
+          </Flex>
+        ) : null}
+
+        {pr?.reviewDecision === "changes_requested" ? (
+          <Flex
+            align="center"
+            gap="1"
+            className="text-(--amber-11) text-[11px]"
+          >
+            <Warning size={11} weight="fill" />
+            <span>Changes requested</span>
+          </Flex>
+        ) : null}
+        {pr?.reviewDecision === "approved" ? (
+          <Flex
+            align="center"
+            gap="1"
+            className="text-(--green-11) text-[11px]"
+          >
+            <CheckCircle size={11} weight="fill" />
+            <span>Approved</span>
+          </Flex>
+        ) : null}
+
+        <Flex
+          align="center"
+          gap="1.5"
+          justify="between"
+          wrap="wrap"
+          onClick={(e) => e.stopPropagation()}
+          onKeyDown={(e) => e.stopPropagation()}
+        >
+          {primaryBound ? (
+            <Flex align="center" gap="1">
+              <Button
+                variant="primary"
+                size="xs"
+                onClick={() => handleRunAction(primaryBound)}
+                title={`${primaryBound.situationLabel} → ${primaryBound.skillId}`}
+              >
+                <Sparkle size={11} />
+                {primaryBound.label}
+              </Button>
+              {overflowBound.length > 0 ? (
+                <DropdownMenu.Root>
+                  <DropdownMenu.Trigger>
+                    <Button
+                      variant="outline"
+                      size="xs"
+                      title={`${overflowBound.length} more quick action${overflowBound.length === 1 ? "" : "s"}`}
+                    >
+                      +{overflowBound.length}
+                      <CaretDown size={9} />
+                    </Button>
+                  </DropdownMenu.Trigger>
+                  <DropdownMenu.Content>
+                    {overflowBound.map((action) => (
+                      <DropdownMenu.Item
+                        key={`${action.situationId}::${action.id}`}
+                        onSelect={() => handleRunAction(action)}
+                      >
+                        <Sparkle size={11} />
+                        {action.label}
+                        <Text className="ml-auto pl-3 text-(--gray-10) text-[10px]">
+                          {action.situationLabel}
+                        </Text>
+                      </DropdownMenu.Item>
+                    ))}
+                  </DropdownMenu.Content>
+                </DropdownMenu.Root>
+              ) : null}
+            </Flex>
+          ) : workstream.prUrl ? (
+            <Button variant="outline" size="xs" onClick={handleOpenPr}>
+              Open PR
+            </Button>
+          ) : (
+            <Button variant="outline" size="xs" onClick={handleOpenTask}>
+              Open task
+            </Button>
+          )}
+          {taskCount > 1 ? (
+            <Text className="text-(--gray-10) text-[11px]">
+              {taskCount} tasks
+            </Text>
+          ) : null}
+        </Flex>
+      </Flex>
+    </Box>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
new file mode 100644
index 0000000000..4e7d876793
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
@@ -0,0 +1,371 @@
+import {
+  ArrowSquareOut,
+  CaretDown,
+  CaretRight,
+  ChatCircle,
+  CheckCircle,
+  CircleDashed,
+  GitBranch,
+  GitPullRequest,
+  Sparkle,
+  Spinner,
+  Warning,
+  X,
+  XCircle,
+} from "@phosphor-icons/react";
+import { Badge, Button } from "@posthog/quill";
+import { Box, DropdownMenu, Flex, ScrollArea, Text } from "@radix-ui/themes";
+import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import type { TaskRunStatus } from "@shared/types";
+import { useNavigationStore } from "@stores/navigationStore";
+import { openUrlInBrowser } from "@utils/browser";
+import { formatRelativeTimeShort } from "@utils/time";
+import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
+import type {
+  HomePullRequest,
+  HomeWorkstream,
+  HomeWorkstreamTask,
+} from "../hooks/useHomeSnapshot";
+import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
+import { SituationChip } from "./SituationChip";
+
+interface Props {
+  workstream: HomeWorkstream;
+  onClose: () => void;
+}
+
+export function HomeWorkstreamDetailPanel({ workstream, onClose }: Props) {
+  const { data: allTasks = [] } = useTasks();
+  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
+  const boundActions = useBoundActions(workstream);
+  const runAction = useRunWorkstreamAction();
+
+  const pr = workstream.pr;
+  const headTask = workstream.tasks[0];
+  const title =
+    pr?.title ?? headTask?.title ?? workstream.branch ?? "Workstream";
+
+  function handleOpenTask(task: HomeWorkstreamTask) {
+    const found = allTasks.find((t) => t.id === task.id);
+    if (found) navigateToTask(found);
+  }
+
+  function handleOpenPr() {
+    if (workstream.prUrl) void openUrlInBrowser(workstream.prUrl);
+  }
+
+  const primaryAction = boundActions[0] ?? null;
+  const overflowActions = boundActions.slice(1);
+
+  return (
+    <Flex
+      direction="column"
+      className="h-full min-h-0 bg-(--color-panel-solid)"
+    >
+      {/* Header */}
+      <Flex
+        align="start"
+        justify="between"
+        gap="2"
+        className="border-(--gray-4) border-b px-4 py-3"
+      >
+        <Flex direction="column" gap="1" className="min-w-0 flex-1">
+          <Text
+            className="font-semibold text-[13px] text-gray-12 leading-snug"
+            title={title}
+          >
+            {title}
+          </Text>
+          <Flex
+            align="center"
+            gap="2"
+            wrap="wrap"
+            className="text-(--gray-10) text-[11px]"
+          >
+            {workstream.repoName ? <Text>{workstream.repoName}</Text> : null}
+            {workstream.branch ? (
+              <Flex align="center" gap="1" className="min-w-0">
+                <GitBranch size={10} />
+                <span className="truncate" title={workstream.branch}>
+                  {workstream.branch}
+                </span>
+              </Flex>
+            ) : null}
+            {pr ? <Text title={`PR #${pr.number}`}>#{pr.number}</Text> : null}
+            <Text>{formatRelativeTimeShort(workstream.lastActivityAt)}</Text>
+          </Flex>
+        </Flex>
+        <Button size="xs" variant="link-muted" onClick={onClose} title="Close">
+          <X size={12} />
+        </Button>
+      </Flex>
+
+      <ScrollArea>
+        <Flex direction="column" gap="4" className="px-4 py-4">
+          {workstream.situations.length > 0 ? (
+            <Section title="Situations">
+              <Flex gap="1" wrap="wrap">
+                {workstream.situations.map((sid) => (
+                  <SituationChip key={sid} sid={sid} />
+                ))}
+              </Flex>
+            </Section>
+          ) : null}
+
+          {pr ? <PrBlock pr={pr} onOpen={handleOpenPr} /> : null}
+
+          {boundActions.length > 0 ? (
+            <Section title="Quick actions">
+              <Flex gap="1.5" wrap="wrap">
+                {primaryAction ? (
+                  <Button
+                    variant="primary"
+                    size="sm"
+                    onClick={() => runAction(primaryAction, workstream)}
+                    title={`${primaryAction.situationLabel} → ${primaryAction.skillId}`}
+                  >
+                    <Sparkle size={12} />
+                    {primaryAction.label}
+                  </Button>
+                ) : null}
+                {overflowActions.length > 0 ? (
+                  <DropdownMenu.Root>
+                    <DropdownMenu.Trigger>
+                      <Button variant="outline" size="sm">
+                        +{overflowActions.length}
+                        <CaretDown size={10} />
+                      </Button>
+                    </DropdownMenu.Trigger>
+                    <DropdownMenu.Content>
+                      {overflowActions.map((action: BoundAction) => (
+                        <DropdownMenu.Item
+                          key={`${action.situationId}::${action.id}`}
+                          onSelect={() => runAction(action, workstream)}
+                        >
+                          <Sparkle size={11} />
+                          {action.label}
+                          <Text className="ml-auto pl-3 text-(--gray-10) text-[10px]">
+                            {action.situationLabel}
+                          </Text>
+                        </DropdownMenu.Item>
+                      ))}
+                    </DropdownMenu.Content>
+                  </DropdownMenu.Root>
+                ) : null}
+              </Flex>
+            </Section>
+          ) : null}
+
+          <Section
+            title={`Tasks (${workstream.tasks.length})`}
+            subtitle={
+              workstream.tasks.length === 0
+                ? "No tasks attached to this workstream"
+                : undefined
+            }
+          >
+            <Flex direction="column" gap="1">
+              {workstream.tasks.map((task) => (
+                <TaskRow
+                  key={task.id}
+                  task={task}
+                  onClick={() => handleOpenTask(task)}
+                />
+              ))}
+            </Flex>
+          </Section>
+        </Flex>
+      </ScrollArea>
+
+      {/* Footer links */}
+      {workstream.prUrl ? (
+        <Box className="border-(--gray-4) border-t px-4 py-2">
+          <Button
+            variant="link-muted"
+            size="sm"
+            onClick={handleOpenPr}
+            className="w-full justify-center"
+          >
+            <GitPullRequest size={12} />
+            Open PR in browser
+            <ArrowSquareOut size={10} />
+          </Button>
+        </Box>
+      ) : null}
+    </Flex>
+  );
+}
+
+interface SectionProps {
+  title: string;
+  subtitle?: string;
+  children: React.ReactNode;
+}
+
+function Section({ title, subtitle, children }: SectionProps) {
+  return (
+    <Flex direction="column" gap="2">
+      <Flex direction="column" gap="0">
+        <Text className="font-semibold text-[10px] text-gray-11 uppercase tracking-wider">
+          {title}
+        </Text>
+        {subtitle ? (
+          <Text className="text-[11px] text-gray-10">{subtitle}</Text>
+        ) : null}
+      </Flex>
+      {children}
+    </Flex>
+  );
+}
+
+function PrBlock({ pr, onOpen }: { pr: HomePullRequest; onOpen: () => void }) {
+  return (
+    <Section title="Pull request">
+      <Flex
+        direction="column"
+        gap="2"
+        className="rounded-md border border-(--gray-5) bg-(--gray-2) px-3 py-2.5"
+      >
+        <Flex align="center" justify="between" gap="2">
+          <PrStatePill pr={pr} />
+          <CiBadge status={pr.ciStatus} />
+        </Flex>
+        {pr.reviewDecision === "approved" ? (
+          <Flex
+            align="center"
+            gap="1"
+            className="text-(--green-11) text-[11px]"
+          >
+            <CheckCircle size={11} weight="fill" />
+            <span>Approved</span>
+          </Flex>
+        ) : null}
+        {pr.reviewDecision === "changes_requested" ? (
+          <Flex
+            align="center"
+            gap="1"
+            className="text-(--amber-11) text-[11px]"
+          >
+            <Warning size={11} weight="fill" />
+            <span>Changes requested</span>
+          </Flex>
+        ) : null}
+        {pr.unresolvedThreads > 0 ? (
+          <Flex align="center" gap="1" className="text-[11px] text-gray-11">
+            <ChatCircle size={11} />
+            <span>
+              {pr.unresolvedThreads} unresolved review thread
+              {pr.unresolvedThreads === 1 ? "" : "s"}
+            </span>
+          </Flex>
+        ) : null}
+        {pr.author && !pr.isCurrentUserAuthor ? (
+          <Text className="text-[11px] text-gray-11">by @{pr.author}</Text>
+        ) : null}
+        <Button
+          variant="link-muted"
+          size="xs"
+          onClick={onOpen}
+          className="self-start"
+        >
+          <ArrowSquareOut size={10} />
+          Open PR
+        </Button>
+      </Flex>
+    </Section>
+  );
+}
+
+function PrStatePill({ pr }: { pr: HomePullRequest }) {
+  if (pr.state === "merged") return <Badge variant="info">Merged</Badge>;
+  if (pr.state === "draft") return <Badge variant="default">Draft</Badge>;
+  if (pr.state === "closed") return <Badge variant="default">Closed</Badge>;
+  return <Badge variant="success">Open</Badge>;
+}
+
+function CiBadge({ status }: { status: HomePullRequest["ciStatus"] }) {
+  if (status === "passing") {
+    return (
+      <Flex align="center" gap="1" className="text-(--green-11) text-[11px]">
+        <CheckCircle size={11} weight="fill" />
+        <span>CI passing</span>
+      </Flex>
+    );
+  }
+  if (status === "failing") {
+    return (
+      <Flex align="center" gap="1" className="text-(--red-11) text-[11px]">
+        <XCircle size={11} weight="fill" />
+        <span>CI failing</span>
+      </Flex>
+    );
+  }
+  if (status === "pending") {
+    return (
+      <Flex align="center" gap="1" className="text-(--amber-11) text-[11px]">
+        <Spinner size={11} className="animate-spin" />
+        <span>CI pending</span>
+      </Flex>
+    );
+  }
+  return null;
+}
+
+function TaskRow({
+  task,
+  onClick,
+}: {
+  task: HomeWorkstreamTask;
+  onClick: () => void;
+}) {
+  return (
+    <button
+      type="button"
+      onClick={onClick}
+      className="flex items-center gap-2 rounded-md border border-(--gray-5) bg-(--gray-1) px-2.5 py-1.5 text-left transition-colors hover:border-(--gray-7) hover:bg-(--gray-2)"
+    >
+      <TaskStatusIcon status={task.status} isGenerating={task.isGenerating} />
+      <Text className="min-w-0 flex-1 truncate text-[12px] text-gray-12">
+        {task.title}
+      </Text>
+      {task.needsPermission ? (
+        <Badge variant="warning" title="Awaiting permission">
+          !
+        </Badge>
+      ) : null}
+      <CaretRight size={11} className="shrink-0 text-(--gray-10)" />
+    </button>
+  );
+}
+
+function TaskStatusIcon({
+  status,
+  isGenerating,
+}: {
+  status: TaskRunStatus | undefined;
+  isGenerating: boolean;
+}) {
+  if (isGenerating || status === "in_progress" || status === "queued") {
+    return (
+      <Spinner size={11} className="shrink-0 animate-spin text-(--accent-11)" />
+    );
+  }
+  if (status === "completed") {
+    return (
+      <CheckCircle
+        size={11}
+        weight="fill"
+        className="shrink-0 text-(--green-9)"
+      />
+    );
+  }
+  if (status === "failed") {
+    return (
+      <XCircle size={11} weight="fill" className="shrink-0 text-(--red-9)" />
+    );
+  }
+  if (status === "cancelled") {
+    return <CircleDashed size={11} className="shrink-0 text-(--gray-10)" />;
+  }
+  return <CircleDashed size={11} className="shrink-0 text-(--gray-10)" />;
+}
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
new file mode 100644
index 0000000000..8c67d1b1ee
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
@@ -0,0 +1,193 @@
+import {
+  ArrowSquareOut,
+  CaretDown,
+  ChatCircle,
+  GitBranch,
+  GitPullRequest,
+  Sparkle,
+  Warning,
+} from "@phosphor-icons/react";
+import { Button } from "@posthog/quill";
+import { Box, DropdownMenu, Flex, Text } from "@radix-ui/themes";
+import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import { useNavigationStore } from "@stores/navigationStore";
+import { openUrlInBrowser } from "@utils/browser";
+import { formatRelativeTimeShort } from "@utils/time";
+import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
+import type { HomeWorkstream } from "../hooks/useHomeSnapshot";
+import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
+import { useHomeUiStore } from "../stores/homeUiStore";
+import {
+  severityRingClass,
+  situationSeverity,
+} from "../utils/situationDisplay";
+import { SituationChip } from "./SituationChip";
+
+interface HomeWorkstreamRowProps {
+  workstream: HomeWorkstream;
+}
+
+export function HomeWorkstreamRow({ workstream }: HomeWorkstreamRowProps) {
+  const { data: tasks = [] } = useTasks();
+  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
+  const boundActions = useBoundActions(workstream);
+  const runAction = useRunWorkstreamAction();
+  const setSelectedWorkstreamId = useHomeUiStore(
+    (s) => s.setSelectedWorkstreamId,
+  );
+  const isSelected = useHomeUiStore(
+    (s) => s.selectedWorkstreamId === workstream.id,
+  );
+
+  const headTask = workstream.tasks[0];
+  const title = headTask?.title ?? workstream.branch ?? "Workstream";
+  const taskCount = workstream.tasks.length;
+  const severity = situationSeverity(workstream.situations);
+  const inlineActions = boundActions.slice(0, 2);
+  const overflowActions = boundActions.slice(2);
+
+  function handleRunAction(action: BoundAction) {
+    runAction(action, workstream);
+  }
+
+  function handleOpenTask() {
+    if (!headTask) return;
+    const task = tasks.find((t) => t.id === headTask.id);
+    if (task) navigateToTask(task);
+  }
+
+  function handleOpenPr() {
+    if (workstream.prUrl) void openUrlInBrowser(workstream.prUrl);
+  }
+
+  return (
+    <Box
+      onClick={() => setSelectedWorkstreamId(workstream.id)}
+      onKeyDown={(e) => {
+        if (e.key === "Enter" || e.key === " ") {
+          e.preventDefault();
+          setSelectedWorkstreamId(workstream.id);
+        }
+      }}
+      role="button"
+      tabIndex={0}
+      aria-label={`Open ${title}`}
+      className={`cursor-pointer border-(--gray-4) border-b px-5 py-3 transition-colors hover:bg-(--gray-2) ${
+        isSelected ? "bg-(--accent-3)" : ""
+      } ${severityRingClass(severity)}`}
+    >
+      <Flex align="start" justify="between" gap="3">
+        <Flex direction="column" gap="2" className="min-w-0 flex-1">
+          <Flex align="center" gap="2" wrap="wrap" className="min-w-0">
+            <Text
+              className="truncate font-medium text-[13px] text-gray-12"
+              title={title}
+            >
+              {title}
+            </Text>
+            {workstream.situations.map((sid) => (
+              <SituationChip key={sid} sid={sid} />
+            ))}
+            {taskCount > 1 ? (
+              <Text className="shrink-0 text-(--gray-10) text-[11px]">
+                · {taskCount} tasks
+              </Text>
+            ) : null}
+          </Flex>
+
+          <Flex
+            align="center"
+            gap="3"
+            wrap="wrap"
+            className="text-(--gray-10) text-[11px]"
+          >
+            {workstream.repoName ? (
+              <Text title="Repository">{workstream.repoName}</Text>
+            ) : null}
+            {workstream.branch ? (
+              <Flex align="center" gap="1" className="min-w-0">
+                <GitBranch size={10} />
+                <span className="truncate" title={workstream.branch}>
+                  {workstream.branch}
+                </span>
+              </Flex>
+            ) : null}
+            {headTask?.needsPermission ? (
+              <Flex align="center" gap="1" className="text-(--amber-11)">
+                <Warning size={11} weight="fill" />
+                <span>Awaiting permission</span>
+              </Flex>
+            ) : null}
+            {workstream.tasks.some((t) => t.isGenerating) ? (
+              <Flex align="center" gap="1">
+                <ChatCircle size={11} />
+                <span>Generating</span>
+              </Flex>
+            ) : null}
+            <Text>{formatRelativeTimeShort(workstream.lastActivityAt)}</Text>
+          </Flex>
+        </Flex>
+
+        <Flex
+          align="center"
+          gap="2"
+          wrap="wrap"
+          className="shrink-0"
+          onClick={(e) => e.stopPropagation()}
+          onKeyDown={(e) => e.stopPropagation()}
+        >
+          {inlineActions.map((action, idx) => (
+            <Button
+              key={`${action.situationId}::${action.id}`}
+              variant={idx === 0 ? "primary" : "outline"}
+              size="sm"
+              onClick={() => handleRunAction(action)}
+              title={`${action.situationLabel} → ${action.skillId}`}
+            >
+              <Sparkle size={12} />
+              {action.label}
+            </Button>
+          ))}
+          {overflowActions.length > 0 ? (
+            <DropdownMenu.Root>
+              <DropdownMenu.Trigger>
+                <Button
+                  variant="outline"
+                  size="sm"
+                  title={`${overflowActions.length} more quick action${overflowActions.length === 1 ? "" : "s"}`}
+                >
+                  +{overflowActions.length}
+                  <CaretDown size={10} />
+                </Button>
+              </DropdownMenu.Trigger>
+              <DropdownMenu.Content>
+                {overflowActions.map((action) => (
+                  <DropdownMenu.Item
+                    key={`${action.situationId}::${action.id}`}
+                    onSelect={() => handleRunAction(action)}
+                  >
+                    <Sparkle size={12} />
+                    {action.label}
+                    <Text className="ml-auto pl-3 text-(--gray-10) text-[10px]">
+                      {action.situationLabel}
+                    </Text>
+                  </DropdownMenu.Item>
+                ))}
+              </DropdownMenu.Content>
+            </DropdownMenu.Root>
+          ) : null}
+          {workstream.prUrl ? (
+            <Button variant="link-muted" size="sm" onClick={handleOpenPr}>
+              <GitPullRequest size={12} />
+              PR
+              <ArrowSquareOut size={10} />
+            </Button>
+          ) : null}
+          <Button variant="link-muted" size="sm" onClick={handleOpenTask}>
+            Open task
+          </Button>
+        </Flex>
+      </Flex>
+    </Box>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/components/SituationChip.tsx b/apps/code/src/renderer/features/home/components/SituationChip.tsx
new file mode 100644
index 0000000000..3b456e284d
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/SituationChip.tsx
@@ -0,0 +1,16 @@
+import { Badge } from "@posthog/quill";
+import type { SituationId } from "@shared/types/workflow";
+import { SITUATION_BADGE, SITUATION_META } from "../utils/situationDisplay";
+
+interface Props {
+  sid: SituationId;
+}
+
+export function SituationChip({ sid }: Props) {
+  const meta = SITUATION_META[sid];
+  return (
+    <Badge variant={SITUATION_BADGE[sid]} title={meta.description}>
+      {meta.label}
+    </Badge>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx b/apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx
new file mode 100644
index 0000000000..86a3800e26
--- /dev/null
+++ b/apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx
@@ -0,0 +1,172 @@
+import { useSkillsForPicker } from "@features/home/hooks/useSkillsForPicker";
+import { useWorkflowEditorStore } from "@features/home/stores/workflowEditorStore";
+import { ArrowDown, ArrowUp, Trash, X } from "@phosphor-icons/react";
+import { Button } from "@posthog/quill";
+import { Card, Flex, Text, TextArea, TextField } from "@radix-ui/themes";
+import {
+  SITUATIONS,
+  type SituationId,
+  type WorkflowAction,
+} from "@shared/types/workflow";
+import { SITUATION_TONE } from "./workflowMapLayout";
+
+interface Props {
+  situationId: SituationId;
+  action: WorkflowAction;
+  totalInSituation: number;
+  indexInSituation: number;
+}
+
+export function ActionEditorPanel({
+  situationId,
+  action,
+  totalInSituation,
+  indexInSituation,
+}: Props) {
+  const updateAction = useWorkflowEditorStore((s) => s.updateAction);
+  const removeAction = useWorkflowEditorStore((s) => s.removeAction);
+  const moveAction = useWorkflowEditorStore((s) => s.moveAction);
+  const selectSituation = useWorkflowEditorStore((s) => s.selectSituation);
+
+  const { skills, isLoading } = useSkillsForPicker();
+  const selectedSkill = skills.find((s) => s.name === action.skillId) ?? null;
+
+  const meta = SITUATIONS.find((s) => s.id === situationId);
+  const tone = SITUATION_TONE[situationId];
+
+  function patch(p: Partial<WorkflowAction>) {
+    updateAction(situationId, action.id, p);
+  }
+
+  function handleRemove() {
+    removeAction(situationId, action.id);
+    // Fall back to the situation overview so the user keeps context after
+    // deleting the action they were editing.
+    selectSituation(situationId);
+  }
+
+  return (
+    <Flex direction="column" className="h-full min-h-0">
+      <Flex
+        align="center"
+        justify="between"
+        gap="2"
+        className={`border-(--gray-4) border-b px-4 py-2.5 ${tone.bg}`}
+      >
+        <Flex direction="column" gap="0">
+          <Text
+            className={`font-semibold text-[10px] uppercase tracking-wider ${tone.label}`}
+          >
+            {meta?.label}
+          </Text>
+          <Text className="text-[11px] text-gray-11">Edit action</Text>
+        </Flex>
+        <Button
+          size="xs"
+          variant="link-muted"
+          onClick={() => selectSituation(situationId)}
+          title="Back to situation"
+        >
+          <X size={12} />
+        </Button>
+      </Flex>
+
+      <div className="flex-1 overflow-y-auto px-4 py-3">
+        <Card variant="surface" className="flex flex-col gap-3 p-3">
+          <Field label="Button label">
+            <TextField.Root
+              size="2"
+              value={action.label}
+              autoFocus
+              placeholder="What the button on the row says"
+              onChange={(e) => patch({ label: e.target.value })}
+            />
+          </Field>
+
+          <Field label="Skill">
+            <select
+              value={action.skillId}
+              onChange={(e) => patch({ skillId: e.target.value })}
+              className="rounded-md border border-(--gray-6) bg-(--gray-1) px-2 py-1.5 text-[12px] text-gray-12"
+            >
+              <option value="">
+                {isLoading ? "Loading…" : "Pick a skill"}
+              </option>
+              {skills.map((s) => (
+                <option key={s.name} value={s.name}>
+                  {s.name}
+                </option>
+              ))}
+            </select>
+            {selectedSkill ? (
+              <Text className="mt-1 text-[10px] text-gray-10">
+                {selectedSkill.description}
+              </Text>
+            ) : null}
+          </Field>
+
+          <Field label="Prompt">
+            <TextArea
+              size="2"
+              value={action.prompt}
+              placeholder="Prompt to send to the agent. It already has access to the current branch, PR, and repo."
+              rows={6}
+              onChange={(e) => patch({ prompt: e.target.value })}
+            />
+          </Field>
+        </Card>
+
+        <Flex justify="between" align="center" className="mt-3">
+          <Flex gap="1">
+            <Button
+              size="xs"
+              variant="link-muted"
+              onClick={() => moveAction(situationId, action.id, "up")}
+              disabled={indexInSituation === 0}
+              title="Move up (button order on row)"
+            >
+              <ArrowUp size={11} />
+            </Button>
+            <Button
+              size="xs"
+              variant="link-muted"
+              onClick={() => moveAction(situationId, action.id, "down")}
+              disabled={indexInSituation === totalInSituation - 1}
+              title="Move down"
+            >
+              <ArrowDown size={11} />
+            </Button>
+            <Text className="ml-1 self-center text-[10px] text-gray-10">
+              {indexInSituation + 1} of {totalInSituation}
+            </Text>
+          </Flex>
+          <Button
+            size="xs"
+            variant="link-muted"
+            onClick={handleRemove}
+            title="Delete action"
+          >
+            <Trash size={11} />
+            Delete
+          </Button>
+        </Flex>
+      </div>
+    </Flex>
+  );
+}
+
+interface FieldProps {
+  label: string;
+  children: React.ReactNode;
+}
+
+function Field({ label, children }: FieldProps) {
+  return (
+    <div className="flex flex-col gap-1">
+      <Text className="text-[10px] text-gray-11 uppercase tracking-wider">
+        {label}
+      </Text>
+      {children}
+    </div>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/config/ConfigMap.tsx b/apps/code/src/renderer/features/home/config/ConfigMap.tsx
new file mode 100644
index 0000000000..50bd99eb98
--- /dev/null
+++ b/apps/code/src/renderer/features/home/config/ConfigMap.tsx
@@ -0,0 +1,286 @@
+import { useWorkflow } from "@features/home/hooks/useWorkflow";
+import { useWorkflowEditorStore } from "@features/home/stores/workflowEditorStore";
+import {
+  ArrowCounterClockwise,
+  FloppyDisk,
+  Warning,
+} from "@phosphor-icons/react";
+import { Button } from "@posthog/quill";
+import { Box, Flex, Text } from "@radix-ui/themes";
+import { useTRPC } from "@renderer/trpc";
+import { SITUATIONS } from "@shared/types/workflow";
+import { validateWorkflow } from "@shared/types/workflow-validate";
+import { useMutation } from "@tanstack/react-query";
+import { toast } from "@utils/toast";
+import { useCallback, useEffect } from "react";
+import { ActionEditorPanel } from "./ActionEditorPanel";
+import { SituationOverviewPanel } from "./SituationOverviewPanel";
+import { SituationStation } from "./SituationStation";
+import { WorkflowMapArrows } from "./WorkflowMapArrows";
+import { MAP_HEIGHT, MAP_WIDTH } from "./workflowMapLayout";
+
+export function ConfigMap() {
+  const trpc = useTRPC();
+  const { workflow, isLoading, error, refetch } = useWorkflow();
+  const draft = useWorkflowEditorStore((s) => s.draft);
+  const dirty = useWorkflowEditorStore((s) => s.dirty);
+  const diagnostics = useWorkflowEditorStore((s) => s.diagnostics);
+  const selection = useWorkflowEditorStore((s) => s.selection);
+  const beginEdit = useWorkflowEditorStore((s) => s.beginEdit);
+  const discardEdit = useWorkflowEditorStore((s) => s.discardEdit);
+  const setDiagnostics = useWorkflowEditorStore((s) => s.setDiagnostics);
+  const clearSelection = useWorkflowEditorStore((s) => s.clearSelection);
+
+  useEffect(() => {
+    if (!workflow) return;
+    if (!draft || (draft.version !== workflow.version && !dirty)) {
+      beginEdit(workflow);
+    }
+  }, [workflow, draft, dirty, beginEdit]);
+
+  const saveMutation = useMutation(trpc.workflow.save.mutationOptions());
+  const resetMutation = useMutation(
+    trpc.workflow.resetToDefault.mutationOptions(),
+  );
+
+  useEffect(() => {
+    if (!draft) return;
+    setDiagnostics(validateWorkflow(draft).diagnostics);
+  }, [draft, setDiagnostics]);
+
+  const onSave = useCallback(async () => {
+    if (!draft) return;
+    const result = await saveMutation.mutateAsync({
+      config: draft,
+      expectedVersion: draft.version,
+    });
+    if (result.status === "saved") {
+      toast.success("Workflow saved");
+      beginEdit(result.config);
+      return;
+    }
+    if (result.status === "conflict") {
+      toast.error("Workflow changed elsewhere", {
+        description:
+          "Another window saved a newer version. Reload to pick it up.",
+      });
+      return;
+    }
+    if (result.status === "invalid") {
+      toast.error("Can't save — fix the errors below");
+      setDiagnostics(result.diagnostics ?? []);
+    }
+  }, [draft, saveMutation, beginEdit, setDiagnostics]);
+
+  const onReset = useCallback(async () => {
+    const fresh = await resetMutation.mutateAsync();
+    beginEdit(fresh);
+    toast.success("Reset to default workflow");
+  }, [resetMutation, beginEdit]);
+
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      const mod = e.metaKey || e.ctrlKey;
+      if (mod && e.key === "s") {
+        e.preventDefault();
+        if (dirty) void onSave();
+      }
+      if (e.key === "Escape") {
+        clearSelection();
+      }
+    }
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [dirty, onSave, clearSelection]);
+
+  if (error) {
+    return (
+      <Flex
+        align="center"
+        justify="center"
+        direction="column"
+        gap="2"
+        className="h-full p-6 text-center"
+      >
+        <Text className="text-(--red-11) text-[12px]">
+          Couldn't load workflow: {error.message}
+        </Text>
+        <Button size="xs" variant="primary" onClick={() => refetch()}>
+          Retry
+        </Button>
+      </Flex>
+    );
+  }
+
+  if (isLoading || !workflow || !draft) {
+    return (
+      <Flex
+        align="center"
+        justify="center"
+        className="h-full text-[12px] text-gray-10"
+      >
+        Loading workflow…
+      </Flex>
+    );
+  }
+
+  const errors = diagnostics.filter((d) => d.severity === "error");
+
+  let panel: React.ReactNode = null;
+  if (selection?.kind === "action") {
+    const actionsForSituation = draft.bindings[selection.situationId] ?? [];
+    const action = actionsForSituation.find((a) => a.id === selection.actionId);
+    if (action) {
+      panel = (
+        <ActionEditorPanel
+          situationId={selection.situationId}
+          action={action}
+          indexInSituation={actionsForSituation.findIndex(
+            (a) => a.id === action.id,
+          )}
+          totalInSituation={actionsForSituation.length}
+        />
+      );
+    }
+  } else if (selection?.kind === "situation") {
+    panel = (
+      <SituationOverviewPanel
+        situationId={selection.situationId}
+        actions={draft.bindings[selection.situationId] ?? []}
+      />
+    );
+  }
+
+  const actionCount = Object.values(draft.bindings).reduce(
+    (sum, list) => sum + list.length,
+    0,
+  );
+
+  return (
+    <Flex direction="column" className="h-full min-h-0">
+      <Box className="border-(--gray-4) border-b bg-(--gray-1) px-5 py-3">
+        <Flex align="center" justify="between" gap="3">
+          <Flex direction="column" gap="1">
+            <Text className="font-medium text-[12px] text-gray-12">
+              Workflow map
+            </Text>
+            <Text className="text-[11px] text-gray-10">
+              v{workflow.version} · {actionCount} action
+              {actionCount === 1 ? "" : "s"} bound
+              {dirty ? " · unsaved changes" : ""}
+            </Text>
+          </Flex>
+          <Flex align="center" gap="2">
+            <Button
+              size="xs"
+              variant="link-muted"
+              onClick={onReset}
+              disabled={resetMutation.isPending}
+            >
+              <ArrowCounterClockwise size={12} />
+              Reset to default
+            </Button>
+            <Button
+              size="xs"
+              variant="link-muted"
+              onClick={() => discardEdit(workflow)}
+              disabled={!dirty}
+            >
+              Discard
+            </Button>
+            <Button
+              size="xs"
+              variant="primary"
+              onClick={onSave}
+              disabled={!dirty || saveMutation.isPending}
+            >
+              <FloppyDisk size={12} />
+              {saveMutation.isPending ? "Saving…" : "Save"}
+            </Button>
+          </Flex>
+        </Flex>
+      </Box>
+
+      {errors.length > 0 ? (
+        <Box className="flex items-start gap-2 border-(--red-6) border-b bg-(--red-2) px-5 py-2 text-(--red-11) text-[12px]">
+          <Warning size={14} className="mt-0.5 shrink-0" />
+          <div className="flex flex-col gap-0.5">
+            <Text className="font-medium">
+              {errors.length} error{errors.length === 1 ? "" : "s"} — fix before
+              saving
+            </Text>
+            <ul className="ml-1 list-disc pl-3">
+              {errors.slice(0, 5).map((d, idx) => (
+                <li
+                  key={`${d.code}-${d.situationId ?? d.actionId ?? idx}`}
+                  className="text-[11px]"
+                >
+                  {d.message}
+                </li>
+              ))}
+              {errors.length > 5 ? (
+                <li className="text-[11px] opacity-70">
+                  …and {errors.length - 5} more
+                </li>
+              ) : null}
+            </ul>
+          </div>
+        </Box>
+      ) : null}
+
+      <Flex className="min-h-0 flex-1">
+        <Box className="relative min-w-0 flex-1 overflow-auto bg-(--gray-2)">
+          {/* Outer wrapper carries the dot-grid background so it scrolls
+              with the map content rather than getting clipped to the
+              viewport on narrow displays. */}
+          <div
+            className="relative mx-auto"
+            style={{
+              width: MAP_WIDTH + 80,
+              height: MAP_HEIGHT + 80,
+            }}
+          >
+            <MapBackground />
+            <div
+              className="absolute"
+              style={{
+                left: 40,
+                top: 40,
+                width: MAP_WIDTH,
+                height: MAP_HEIGHT,
+              }}
+            >
+              <WorkflowMapArrows />
+              {SITUATIONS.map((situation) => (
+                <SituationStation
+                  key={situation.id}
+                  id={situation.id}
+                  bindings={draft.bindings}
+                />
+              ))}
+            </div>
+          </div>
+        </Box>
+        {panel ? (
+          <Box className="w-[360px] shrink-0 border-(--gray-4) border-l bg-(--color-panel-solid)">
+            {panel}
+          </Box>
+        ) : null}
+      </Flex>
+    </Flex>
+  );
+}
+
+function MapBackground() {
+  return (
+    <div
+      className="pointer-events-none absolute inset-0"
+      aria-hidden="true"
+      style={{
+        backgroundImage:
+          "radial-gradient(circle, var(--gray-a4) 1px, transparent 1px)",
+        backgroundSize: "20px 20px",
+      }}
+    />
+  );
+}
diff --git a/apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx b/apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx
new file mode 100644
index 0000000000..9d665c9e12
--- /dev/null
+++ b/apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx
@@ -0,0 +1,155 @@
+import { useWorkflowEditorStore } from "@features/home/stores/workflowEditorStore";
+import { Plus, Sparkle, Trash, X } from "@phosphor-icons/react";
+import { Button } from "@posthog/quill";
+import { Flex, Text } from "@radix-ui/themes";
+import {
+  SITUATIONS,
+  type SituationId,
+  type WorkflowAction,
+} from "@shared/types/workflow";
+import { SITUATION_TONE } from "./workflowMapLayout";
+
+interface Props {
+  situationId: SituationId;
+  actions: WorkflowAction[];
+}
+
+function freshActionId(existing: string[]): string {
+  let n = 1;
+  while (existing.includes(`action_${n}`)) n++;
+  return `action_${n}`;
+}
+
+export function SituationOverviewPanel({ situationId, actions }: Props) {
+  const addAction = useWorkflowEditorStore((s) => s.addAction);
+  const removeAction = useWorkflowEditorStore((s) => s.removeAction);
+  const selectAction = useWorkflowEditorStore((s) => s.selectAction);
+  const clearSelection = useWorkflowEditorStore((s) => s.clearSelection);
+
+  const meta = SITUATIONS.find((s) => s.id === situationId);
+  const tone = SITUATION_TONE[situationId];
+
+  function handleAdd() {
+    const action: WorkflowAction = {
+      id: freshActionId(actions.map((a) => a.id)),
+      label: "Run skill",
+      skillId: "",
+      prompt: "",
+    };
+    addAction(situationId, action);
+    selectAction({
+      kind: "action",
+      situationId,
+      actionId: action.id,
+    });
+  }
+
+  return (
+    <Flex direction="column" className="h-full min-h-0">
+      <Flex
+        align="center"
+        justify="between"
+        gap="2"
+        className={`border-(--gray-4) border-b px-4 py-2.5 ${tone.bg}`}
+      >
+        <Flex direction="column" gap="0">
+          <Text
+            className={`font-semibold text-[10px] uppercase tracking-wider ${tone.label}`}
+          >
+            {meta?.label}
+          </Text>
+          <Text className="text-[11px] text-gray-11">
+            {actions.length} action{actions.length === 1 ? "" : "s"} bound
+          </Text>
+        </Flex>
+        <Button
+          size="xs"
+          variant="link-muted"
+          onClick={() => clearSelection()}
+          title="Close"
+        >
+          <X size={12} />
+        </Button>
+      </Flex>
+
+      <div className="flex-1 overflow-y-auto px-4 py-3">
+        <Text className="text-[11px] text-gray-11">{meta?.description}</Text>
+        <Text className="mt-2 block font-mono text-[10px] text-gray-9">
+          {situationId}
+        </Text>
+
+        <Flex direction="column" gap="2" className="mt-4">
+          {actions.length === 0 ? (
+            <Text className="text-[11px] text-gray-10">
+              Nothing bound yet. Add a skill to surface a quick-action button on
+              the workstream row when work lands here.
+            </Text>
+          ) : (
+            actions.map((action) => {
+              const incomplete =
+                action.skillId.trim() === "" || action.prompt.trim() === "";
+              return (
+                <Flex
+                  key={action.id}
+                  align="center"
+                  justify="between"
+                  gap="2"
+                  className={`rounded-md border bg-(--gray-1) px-2.5 py-2 ${
+                    incomplete
+                      ? "border-(--amber-7)"
+                      : "border-(--gray-5) hover:border-(--gray-7)"
+                  }`}
+                >
+                  <button
+                    type="button"
+                    onClick={() =>
+                      selectAction({
+                        kind: "action",
+                        situationId,
+                        actionId: action.id,
+                      })
+                    }
+                    className="flex min-w-0 flex-1 items-center gap-2 text-left"
+                  >
+                    <Sparkle
+                      size={11}
+                      className={
+                        incomplete ? "text-(--amber-11)" : "text-(--accent-11)"
+                      }
+                    />
+                    <div className="min-w-0 flex-1">
+                      <Text className="truncate font-medium text-[12px] text-gray-12">
+                        {action.label || "(no label)"}
+                      </Text>
+                      <Text className="block truncate text-[10px] text-gray-10">
+                        {action.skillId || "(no skill)"}
+                      </Text>
+                    </div>
+                  </button>
+                  <Button
+                    size="xs"
+                    variant="link-muted"
+                    onClick={() => removeAction(situationId, action.id)}
+                    title="Remove"
+                  >
+                    <Trash size={11} />
+                  </Button>
+                </Flex>
+              );
+            })
+          )}
+        </Flex>
+
+        <Button
+          size="xs"
+          variant="outline"
+          onClick={handleAdd}
+          className="mt-3 w-full"
+        >
+          <Plus size={11} />
+          Add action
+        </Button>
+      </div>
+    </Flex>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/config/SituationStation.tsx b/apps/code/src/renderer/features/home/config/SituationStation.tsx
new file mode 100644
index 0000000000..7db00e00aa
--- /dev/null
+++ b/apps/code/src/renderer/features/home/config/SituationStation.tsx
@@ -0,0 +1,143 @@
+import { useWorkflowEditorStore } from "@features/home/stores/workflowEditorStore";
+import { Plus, Sparkle } from "@phosphor-icons/react";
+import { Text } from "@radix-ui/themes";
+import {
+  SITUATIONS,
+  type SituationId,
+  type WorkflowAction,
+  type WorkflowBindings,
+} from "@shared/types/workflow";
+import { SITUATION_TONE, STATION_LAYOUT } from "./workflowMapLayout";
+
+interface Props {
+  id: SituationId;
+  bindings: WorkflowBindings;
+}
+
+function freshActionId(existing: string[]): string {
+  let n = 1;
+  while (existing.includes(`action_${n}`)) n++;
+  return `action_${n}`;
+}
+
+export function SituationStation({ id, bindings }: Props) {
+  const layout = STATION_LAYOUT[id];
+  const tone = SITUATION_TONE[id];
+  const meta = SITUATIONS.find((s) => s.id === id);
+  const actions = bindings?.[id] ?? [];
+
+  const selectAction = useWorkflowEditorStore((s) => s.selectAction);
+  const selectSituation = useWorkflowEditorStore((s) => s.selectSituation);
+  const addAction = useWorkflowEditorStore((s) => s.addAction);
+  const selection = useWorkflowEditorStore((s) => s.selection);
+
+  const isStationSelected =
+    selection?.kind === "situation" && selection.situationId === id;
+  const isHostingSelectedAction =
+    selection?.kind === "action" && selection.situationId === id;
+
+  function handleAdd(e: React.MouseEvent) {
+    e.stopPropagation();
+    const newAction: WorkflowAction = {
+      id: freshActionId(actions.map((a) => a.id)),
+      label: "Run skill",
+      skillId: "",
+      prompt: "",
+    };
+    addAction(id, newAction);
+    selectAction({
+      kind: "action",
+      situationId: id,
+      actionId: newAction.id,
+    });
+  }
+
+  function handleChip(e: React.MouseEvent, actionId: string) {
+    e.stopPropagation();
+    selectAction({
+      kind: "action",
+      situationId: id,
+      actionId,
+    });
+  }
+
+  function handleStation() {
+    selectSituation(id);
+  }
+
+  return (
+    <button
+      type="button"
+      onClick={handleStation}
+      className={`absolute rounded-lg border ${tone.accent} ${tone.bg} cursor-pointer px-3 py-2.5 text-left shadow-md transition-shadow hover:shadow-lg ${
+        isStationSelected || isHostingSelectedAction
+          ? "ring-(--accent-9) ring-2 ring-offset-(--gray-2) ring-offset-1"
+          : ""
+      }`}
+      style={{
+        left: layout.x,
+        top: layout.y,
+        width: layout.w,
+        height: layout.h,
+      }}
+      aria-label={`${meta?.label ?? id} — ${actions.length} action${actions.length === 1 ? "" : "s"}`}
+    >
+      <div className="flex items-baseline justify-between gap-2">
+        <Text
+          className={`font-semibold text-[11px] uppercase tracking-wider ${tone.label}`}
+        >
+          {meta?.label ?? id}
+        </Text>
+        <Text className="font-mono text-[9px] text-gray-9">{id}</Text>
+      </div>
+      <Text
+        className="mt-0.5 line-clamp-1 text-[10px] text-gray-10"
+        title={meta?.description}
+      >
+        {meta?.description}
+      </Text>
+
+      <div className="mt-2 flex flex-wrap items-center gap-1">
+        {actions.map((action) => {
+          const isChipSelected =
+            selection?.kind === "action" &&
+            selection.situationId === id &&
+            selection.actionId === action.id;
+          const incomplete =
+            action.skillId.trim() === "" || action.prompt.trim() === "";
+          return (
+            <button
+              type="button"
+              key={action.id}
+              onClick={(e) => handleChip(e, action.id)}
+              className={`flex max-w-[150px] items-center gap-1 rounded-full border px-2 py-0.5 text-[11px] transition-colors ${
+                isChipSelected
+                  ? "border-(--accent-9) bg-(--accent-3) text-(--accent-12)"
+                  : incomplete
+                    ? "border-(--amber-8) bg-(--amber-4) text-(--amber-11)"
+                    : "border-(--gray-7) bg-(--color-panel-solid) text-gray-12 hover:border-(--gray-9)"
+              }`}
+              title={
+                action.skillId
+                  ? `${action.label} · ${action.skillId}`
+                  : action.label
+              }
+            >
+              <Sparkle size={9} />
+              <span className="truncate">{action.label || "(no label)"}</span>
+            </button>
+          );
+        })}
+        <button
+          type="button"
+          onClick={handleAdd}
+          className="flex items-center gap-1 rounded-full border border-(--gray-8) border-dashed bg-transparent px-2 py-0.5 text-[11px] text-gray-11 transition-colors hover:border-(--gray-10) hover:bg-(--color-panel-solid) hover:text-gray-12"
+          title="Bind a skill to this situation"
+        >
+          <Plus size={9} />
+          Add
+        </button>
+      </div>
+    </button>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx b/apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx
new file mode 100644
index 0000000000..7c0700cf5d
--- /dev/null
+++ b/apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx
@@ -0,0 +1,106 @@
+import {
+  FLOW_ARROWS,
+  MAP_HEIGHT,
+  MAP_WIDTH,
+  STATION_LAYOUT,
+  stationCentre,
+} from "./workflowMapLayout";
+
+// Decorative flow arrows between stations — not runtime edges (see
+// `FLOW_ARROWS` in workflowMapLayout.ts).
+export function WorkflowMapArrows() {
+  return (
+    <svg
+      width={MAP_WIDTH}
+      height={MAP_HEIGHT}
+      viewBox={`0 0 ${MAP_WIDTH} ${MAP_HEIGHT}`}
+      className="pointer-events-none absolute inset-0"
+      aria-hidden="true"
+    >
+      <defs>
+        <marker
+          id="wf-arrowhead"
+          viewBox="0 0 10 10"
+          refX="8"
+          refY="5"
+          markerWidth="6"
+          markerHeight="6"
+          orient="auto-start-reverse"
+        >
+          <path d="M0,0 L10,5 L0,10 z" className="fill-(--gray-9)" />
+        </marker>
+        <marker
+          id="wf-arrowhead-dim"
+          viewBox="0 0 10 10"
+          refX="8"
+          refY="5"
+          markerWidth="6"
+          markerHeight="6"
+          orient="auto-start-reverse"
+        >
+          <path d="M0,0 L10,5 L0,10 z" className="fill-(--gray-8)" />
+        </marker>
+      </defs>
+
+      {FLOW_ARROWS.map((arrow) => {
+        const a = STATION_LAYOUT[arrow.from];
+        const b = STATION_LAYOUT[arrow.to];
+        const ca = stationCentre(a);
+        const cb = stationCentre(b);
+
+        // Pick start/end points on the *edges* of the station rectangles
+        // along the direction of travel, so the line doesn't run under the
+        // station card.
+        const start = edgePoint(a, cb);
+        const end = edgePoint(b, ca);
+
+        // Slight curve via a quadratic Bézier — control point pulled toward
+        // the midpoint with a small perpendicular offset.
+        const mx = (start.x + end.x) / 2;
+        const my = (start.y + end.y) / 2;
+        const dx = end.x - start.x;
+        const dy = end.y - start.y;
+        const len = Math.max(1, Math.hypot(dx, dy));
+        const perp = { x: -dy / len, y: dx / len };
+        const curveAmount = arrow.kind === "branch" ? 28 : 12;
+        const cx = mx + perp.x * curveAmount;
+        const cy = my + perp.y * curveAmount;
+
+        const path = `M ${start.x},${start.y} Q ${cx},${cy} ${end.x},${end.y}`;
+        const dim = arrow.kind === "branch";
+
+        return (
+          <path
+            key={`${arrow.from}->${arrow.to}`}
+            d={path}
+            fill="none"
+            strokeWidth={dim ? 1 : 1.5}
+            strokeDasharray={dim ? "4 4" : "none"}
+            className={dim ? "stroke-(--gray-8)" : "stroke-(--gray-9)"}
+            markerEnd={`url(#wf-arrowhead${dim ? "-dim" : ""})`}
+          />
+        );
+      })}
+    </svg>
+  );
+}
+
+// Returns the point on the rectangle's perimeter closest to a target,
+// clipped along the ray from the rectangle's centre toward the target.
+function edgePoint(
+  rect: { x: number; y: number; w: number; h: number },
+  target: { x: number; y: number },
+): { x: number; y: number } {
+  const cx = rect.x + rect.w / 2;
+  const cy = rect.y + rect.h / 2;
+  const dx = target.x - cx;
+  const dy = target.y - cy;
+  if (dx === 0 && dy === 0) return { x: cx, y: cy };
+
+  const halfW = rect.w / 2;
+  const halfH = rect.h / 2;
+  const tx = dx === 0 ? Number.POSITIVE_INFINITY : halfW / Math.abs(dx);
+  const ty = dy === 0 ? Number.POSITIVE_INFINITY : halfH / Math.abs(dy);
+  const t = Math.min(tx, ty);
+  return { x: cx + dx * t, y: cy + dy * t };
+}
diff --git a/apps/code/src/renderer/features/home/config/workflowMapLayout.ts b/apps/code/src/renderer/features/home/config/workflowMapLayout.ts
new file mode 100644
index 0000000000..aab3f46cdf
--- /dev/null
+++ b/apps/code/src/renderer/features/home/config/workflowMapLayout.ts
@@ -0,0 +1,114 @@
+import type { SituationId } from "@shared/types/workflow";
+
+// Fixed canvas layout. Positions are NOT user-editable — the workflow shape
+// is a designer-authored map, not a user-authored graph. Numbers are unitless
+// "canvas points"; the renderer scales them into a responsive container.
+
+export const MAP_WIDTH = 1100;
+export const MAP_HEIGHT = 720;
+
+export interface StationLayout {
+  x: number; // top-left of the station card, in canvas points
+  y: number;
+  w: number;
+  h: number;
+}
+
+export const STATION_LAYOUT: Record<SituationId, StationLayout> = {
+  // Top — entry point
+  working: { x: 420, y: 30, w: 260, h: 110 },
+
+  // Hub — most work passes through here
+  in_review: { x: 420, y: 200, w: 260, h: 110 },
+
+  // Side stations — attention-needing variants of in_review
+  ci_failing: { x: 60, y: 370, w: 260, h: 110 },
+  changes_requested: { x: 420, y: 370, w: 260, h: 110 },
+  comments_waiting: { x: 780, y: 370, w: 260, h: 110 },
+
+  // Approval gate
+  ready_to_merge: { x: 420, y: 540, w: 260, h: 110 },
+
+  // Modifier — parked to the right, can apply at any stage
+  stale: { x: 780, y: 30, w: 260, h: 110 },
+
+  // Terminal — bottom right, off the active flow
+  done: { x: 780, y: 540, w: 260, h: 110 },
+};
+
+export interface FlowArrow {
+  from: SituationId;
+  to: SituationId;
+  /** Visual hint — `branch` arrows are drawn dotted to suggest "and/or". */
+  kind: "main" | "branch";
+}
+
+// Decorative arrows. These are NOT runtime edges — they're hand-authored
+// hints about the typical progression of work, drawn dotted/subtle so the
+// user reads them as guidance, not promises. The system doesn't enforce or
+// observe these transitions.
+export const FLOW_ARROWS: FlowArrow[] = [
+  { from: "working", to: "in_review", kind: "main" },
+  { from: "in_review", to: "ci_failing", kind: "branch" },
+  { from: "in_review", to: "changes_requested", kind: "branch" },
+  { from: "in_review", to: "comments_waiting", kind: "branch" },
+  { from: "ci_failing", to: "ready_to_merge", kind: "branch" },
+  { from: "changes_requested", to: "ready_to_merge", kind: "branch" },
+  { from: "comments_waiting", to: "ready_to_merge", kind: "branch" },
+  { from: "in_review", to: "ready_to_merge", kind: "main" },
+  { from: "ready_to_merge", to: "done", kind: "main" },
+];
+
+// Per-situation accent colours for the canvas station. Indices on the Radix
+// scale (`*-3` bg, `*-8` border) are chosen to read in both light and dark
+// modes without relying on coloured shadows.
+export const SITUATION_TONE: Record<
+  SituationId,
+  { accent: string; bg: string; label: string }
+> = {
+  working: {
+    accent: "border-(--blue-8)",
+    bg: "bg-(--blue-3)",
+    label: "text-(--blue-11)",
+  },
+  in_review: {
+    accent: "border-(--violet-8)",
+    bg: "bg-(--violet-3)",
+    label: "text-(--violet-11)",
+  },
+  ci_failing: {
+    accent: "border-(--red-8)",
+    bg: "bg-(--red-3)",
+    label: "text-(--red-11)",
+  },
+  changes_requested: {
+    accent: "border-(--amber-8)",
+    bg: "bg-(--amber-3)",
+    label: "text-(--amber-11)",
+  },
+  comments_waiting: {
+    accent: "border-(--amber-8)",
+    bg: "bg-(--amber-3)",
+    label: "text-(--amber-11)",
+  },
+  ready_to_merge: {
+    accent: "border-(--green-8)",
+    bg: "bg-(--green-3)",
+    label: "text-(--green-11)",
+  },
+  stale: {
+    accent: "border-(--gray-8)",
+    bg: "bg-(--gray-3)",
+    label: "text-(--gray-11)",
+  },
+  done: {
+    accent: "border-(--gray-8)",
+    bg: "bg-(--gray-3)",
+    label: "text-(--gray-11)",
+  },
+};
+
+/** Centre point of a station — used to anchor arrows. */
+export function stationCentre(s: StationLayout): { x: number; y: number } {
+  return { x: s.x + s.w / 2, y: s.y + s.h / 2 };
+}
diff --git a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
new file mode 100644
index 0000000000..84cee8aafe
--- /dev/null
+++ b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
@@ -0,0 +1,423 @@
+import { classify } from "@shared/types/workflow-classify";
+import type {
+  HomePullRequest,
+  HomeSnapshot,
+  HomeWorkstream,
+} from "../hooks/useHomeSnapshot";
+
+function withSituations(
+  workstreams: Omit<HomeWorkstream, "situations">[],
+): HomeWorkstream[] {
+  const now = Date.now();
+  return workstreams.map((ws) => ({
+    ...ws,
+    situations: Array.from(
+      classify({
+        hasPrUrl: !!ws.prUrl,
+        pr: ws.pr
+          ? {
+              state: ws.pr.state,
+              ciStatus: ws.pr.ciStatus,
+              reviewDecision: ws.pr.reviewDecision,
+              unresolvedThreads: ws.pr.unresolvedThreads,
+              isCurrentUserAuthor: ws.pr.isCurrentUserAuthor,
+            }
+          : null,
+        branch: ws.branch,
+        lastActivityAt: ws.lastActivityAt,
+        now,
+      }),
+    ),
+  }));
+}
+
+const HOUR = 60 * 60 * 1000;
+const DAY = 24 * HOUR;
+const now = () => Date.now();
+
+function pr(
+  overrides: Partial<HomePullRequest> & { url: string },
+): HomePullRequest {
+  return {
+    number: 0,
+    title: "",
+    state: "open",
+    ciStatus: "passing",
+    unresolvedThreads: 0,
+    reviewDecision: null,
+    isCurrentUserRequestedReviewer: false,
+    isCurrentUserAuthor: true,
+    author: "peter",
+    lastUpdatedAt: now() - HOUR,
+    ...overrides,
+  };
+}
+
+export function buildDemoSnapshot(): HomeSnapshot {
+  const t = now();
+
+  const needsAttention: Omit<HomeWorkstream, "situations">[] = [
+    // ── Critical: CI failing ───────────────────────────────────────────────
+    {
+      id: "demo-attn-ci",
+      repoName: "posthog",
+      branch: "feat/cohort-batch-export",
+      prUrl: "https://github.com/posthog/posthog/pull/29412",
+      pr: pr({
+        url: "https://github.com/posthog/posthog/pull/29412",
+        number: 29412,
+        title: "Batch export support for cohorts",
+        state: "open",
+        ciStatus: "failing",
+        unresolvedThreads: 0,
+        reviewDecision: "review_required",
+        lastUpdatedAt: t - 45 * 60_000,
+      }),
+      tasks: [
+        {
+          id: "demo-task-ci-1",
+          title: "Add cohort batch export endpoint",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 45 * 60_000,
+    },
+
+    // ── Critical: CI failing + unresolved comments (stacked attentions) ────
+    {
+      id: "demo-attn-ci-comments",
+      repoName: "posthog-js",
+      branch: "fix/web-vitals-sampling",
+      prUrl: "https://github.com/posthog/posthog-js/pull/1820",
+      pr: pr({
+        url: "https://github.com/posthog/posthog-js/pull/1820",
+        number: 1820,
+        title: "Sample web-vitals at session boundary",
+        state: "open",
+        ciStatus: "failing",
+        unresolvedThreads: 2,
+        reviewDecision: "changes_requested",
+        lastUpdatedAt: t - 4 * HOUR,
+      }),
+      tasks: [
+        {
+          id: "demo-task-ci-comments-1",
+          title: "Sample web-vitals at session boundary",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+        {
+          id: "demo-task-ci-comments-2",
+          title: "Address review feedback",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 4 * HOUR,
+    },
+
+    // ── Attention: Review requested on me ──────────────────────────────────
+    {
+      id: "demo-attn-review-1",
+      repoName: "posthog",
+      branch: "feat/insights-formula-cleanup",
+      prUrl: "https://github.com/posthog/posthog/pull/29385",
+      pr: pr({
+        url: "https://github.com/posthog/posthog/pull/29385",
+        number: 29385,
+        title: "Refactor insights formula parser",
+        state: "open",
+        ciStatus: "passing",
+        unresolvedThreads: 0,
+        reviewDecision: "review_required",
+        isCurrentUserAuthor: false,
+        isCurrentUserRequestedReviewer: true,
+        author: "thomas",
+        lastUpdatedAt: t - 6 * HOUR,
+      }),
+      tasks: [],
+      lastActivityAt: t - 6 * HOUR,
+    },
+
+    // ── Attention: Review requested on me (urgent / older) ─────────────────
+    {
+      id: "demo-attn-review-2",
+      repoName: "posthog",
+      branch: "fix/billing-quota-display",
+      prUrl: "https://github.com/posthog/posthog/pull/29298",
+      pr: pr({
+        url: "https://github.com/posthog/posthog/pull/29298",
+        number: 29298,
+        title: "Fix billing quota off-by-one in usage modal",
+        state: "open",
+        ciStatus: "passing",
+        unresolvedThreads: 0,
+        reviewDecision: "review_required",
+        isCurrentUserAuthor: false,
+        isCurrentUserRequestedReviewer: true,
+        author: "raquel",
+        lastUpdatedAt: t - 2 * DAY,
+      }),
+      tasks: [],
+      lastActivityAt: t - 2 * DAY,
+    },
+
+    // ── Attention: PR has unresolved comments on my PR ─────────────────────
+    {
+      id: "demo-attn-comments",
+      repoName: "posthog-code",
+      branch: "posthog-code/skill-buttons-v2",
+      prUrl: "https://github.com/posthog/posthog-code/pull/2401",
+      pr: pr({
+        url: "https://github.com/posthog/posthog-code/pull/2401",
+        number: 2401,
+        title: "Skill buttons v2 — bundled, custom, and recent groups",
+        state: "open",
+        ciStatus: "passing",
+        unresolvedThreads: 3,
+        reviewDecision: "changes_requested",
+        lastUpdatedAt: t - 90 * 60_000,
+      }),
+      tasks: [
+        {
+          id: "demo-task-comments-1",
+          title: "Skill buttons v2 layout",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 90 * 60_000,
+    },
+
+    // ── Attention: PR ready to merge ───────────────────────────────────────
+    {
+      id: "demo-attn-merge",
+      repoName: "posthog",
+      branch: "feat/experiments-secondary-metrics",
+      prUrl: "https://github.com/posthog/posthog/pull/29381",
+      pr: pr({
+        url: "https://github.com/posthog/posthog/pull/29381",
+        number: 29381,
+        title: "Secondary metrics in experiments view",
+        state: "open",
+        ciStatus: "passing",
+        unresolvedThreads: 0,
+        reviewDecision: "approved",
+        lastUpdatedAt: t - 30 * 60_000,
+      }),
+      tasks: [
+        {
+          id: "demo-task-merge-1",
+          title: "Add secondary metrics to experiment view",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 30 * 60_000,
+    },
+
+    // ── Quiet: Stale branch with no PR ─────────────────────────────────────
+    {
+      id: "demo-attn-stale-1",
+      repoName: "posthog-code",
+      branch: "posthog-code/onboarding-copy",
+      prUrl: null,
+      pr: null,
+      tasks: [
+        {
+          id: "demo-task-stale-1",
+          title: "Tweak onboarding copy for empty state",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 2 * DAY - 3 * HOUR,
+    },
+
+    // ── Quiet: Stale branch with 2 task runs ───────────────────────────────
+    {
+      id: "demo-attn-stale-2",
+      repoName: "posthog",
+      branch: "exp/funnel-paths-refactor",
+      prUrl: null,
+      pr: null,
+      tasks: [
+        {
+          id: "demo-task-stale-2a",
+          title: "Refactor funnel path computation",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+        {
+          id: "demo-task-stale-2b",
+          title: "Self-review funnel refactor",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 4 * DAY - 12 * HOUR,
+    },
+
+    // ── Quiet: Merged PR with leftover worktree ────────────────────────────
+    {
+      id: "demo-attn-cleanup",
+      repoName: "posthog-js",
+      branch: "fix/autocapture-shadow-dom",
+      prUrl: "https://github.com/posthog/posthog-js/pull/1789",
+      pr: pr({
+        url: "https://github.com/posthog/posthog-js/pull/1789",
+        number: 1789,
+        title: "Capture clicks inside shadow DOM",
+        state: "merged",
+        ciStatus: "passing",
+        unresolvedThreads: 0,
+        reviewDecision: "approved",
+        lastUpdatedAt: t - 5 * DAY,
+      }),
+      tasks: [
+        {
+          id: "demo-task-cleanup-1",
+          title: "Capture clicks inside shadow DOM",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 5 * DAY,
+    },
+  ];
+
+  const inProgress: Omit<HomeWorkstream, "situations">[] = [
+    {
+      id: "demo-ip-pr-open",
+      repoName: "posthog",
+      branch: "feat/cdp-hog-flow-retries",
+      prUrl: "https://github.com/posthog/posthog/pull/29402",
+      pr: pr({
+        url: "https://github.com/posthog/posthog/pull/29402",
+        number: 29402,
+        title: "Hog Flow: per-step retry policy",
+        state: "open",
+        ciStatus: "passing",
+        unresolvedThreads: 0,
+        reviewDecision: "review_required",
+        lastUpdatedAt: t - 5 * HOUR,
+      }),
+      tasks: [
+        {
+          id: "demo-task-ip-pr-open-1",
+          title: "Per-step retry policy for Hog Flow",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 5 * HOUR,
+    },
+    {
+      id: "demo-ip-draft",
+      repoName: "posthog",
+      branch: "exp/web-experiments-headless",
+      prUrl: "https://github.com/posthog/posthog/pull/29397",
+      pr: pr({
+        url: "https://github.com/posthog/posthog/pull/29397",
+        number: 29397,
+        title: "Headless mode for web experiments runner",
+        state: "draft",
+        ciStatus: "pending",
+        unresolvedThreads: 0,
+        reviewDecision: null,
+        lastUpdatedAt: t - 2 * HOUR,
+      }),
+      tasks: [
+        {
+          id: "demo-task-ip-draft-1",
+          title: "Headless mode for web experiments",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 2 * HOUR,
+    },
+    {
+      id: "demo-ip-no-pr",
+      repoName: "posthog-docs",
+      branch: "docs/error-tracking-quickstart",
+      prUrl: null,
+      pr: null,
+      tasks: [
+        {
+          id: "demo-task-ip-no-pr-1",
+          title: "Draft error tracking quickstart",
+          status: "completed",
+          isGenerating: false,
+          needsPermission: false,
+        },
+      ],
+      lastActivityAt: t - 90 * 60_000,
+    },
+  ];
+
+  return {
+    activeAgents: [
+      {
+        taskId: "demo-agent-1",
+        title: "Add Home tab to sidebar",
+        repoName: "posthog-code",
+        branch: "posthog-code/home-tab",
+        status: "in_progress",
+        lastActivityAt: t - 2 * 60_000,
+        needsPermission: false,
+        cloudPrUrl: null,
+      },
+      {
+        taskId: "demo-agent-2",
+        title: "Migrate event ingestion to new schema",
+        repoName: "posthog",
+        branch: "feat/ingest-v2",
+        status: "in_progress",
+        lastActivityAt: t - 18 * 60_000,
+        needsPermission: true,
+        cloudPrUrl: null,
+      },
+      {
+        taskId: "demo-agent-3",
+        title: "Investigate replay player frame drops",
+        repoName: "posthog",
+        branch: "fix/replay-frame-drops",
+        status: "queued",
+        lastActivityAt: t - 35 * 60_000,
+        needsPermission: false,
+        cloudPrUrl: null,
+      },
+      {
+        taskId: "demo-agent-4",
+        title: "Review billing-quota-display PR",
+        repoName: "posthog",
+        branch: "review/29298",
+        status: "in_progress",
+        lastActivityAt: t - 4 * 60_000,
+        needsPermission: false,
+        cloudPrUrl: null,
+      },
+    ],
+    needsAttention: withSituations(needsAttention),
+    inProgress: withSituations(inProgress),
+  };
+}
+
+export const EMPTY_SNAPSHOT: HomeSnapshot = {
+  activeAgents: [],
+  needsAttention: [],
+  inProgress: [],
+};
diff --git a/apps/code/src/renderer/features/home/hooks/useBoundActions.ts b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
new file mode 100644
index 0000000000..a4a6f982f3
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
@@ -0,0 +1,48 @@
+import { useWorkflow } from "@features/home/hooks/useWorkflow";
+import {
+  SITUATIONS,
+  type SituationId,
+  type WorkflowAction,
+} from "@shared/types/workflow";
+import { useMemo } from "react";
+import type { HomeWorkstream } from "./useHomeSnapshot";
+
+export interface BoundAction extends WorkflowAction {
+  /** Situation this action came from — used for telemetry + tooltips. */
+  situationId: SituationId;
+  situationLabel: string;
+}
+
+/**
+ * Joins a workstream's classified situations against the persisted workflow's
+ * bindings and returns the deduped list of actions the user has bound to any
+ * matching situation. Order follows the workstream's situations array (which
+ * preserves classifier output order), then the action order within each
+ * binding list.
+ */
+export function useBoundActions(workstream: HomeWorkstream): BoundAction[] {
+  const { workflow } = useWorkflow();
+  return useMemo(() => {
+    if (!workflow) return [];
+    const bindings = workflow.bindings;
+    const seen = new Set<string>();
+    const out: BoundAction[] = [];
+    for (const sid of workstream.situations) {
+      const actions = bindings?.[sid] ?? [];
+      const meta = SITUATIONS.find((s) => s.id === sid);
+      for (const action of actions) {
+        // Dedup if the user bound the same action id under multiple
+        // situations — shouldn't happen via the editor but be defensive.
+        const dedupKey = `${action.skillId}::${action.label}`;
+        if (seen.has(dedupKey)) continue;
+        seen.add(dedupKey);
+        out.push({
+          ...action,
+          situationId: sid,
+          situationLabel: meta?.label ?? sid,
+        });
+      }
+    }
+    return out;
+  }, [workflow, workstream.situations]);
+}
diff --git a/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
new file mode 100644
index 0000000000..24fcb90f6b
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
@@ -0,0 +1,211 @@
+import {
+  type SidebarData,
+  type TaskData,
+  useSidebarData,
+} from "@features/sidebar/hooks/useSidebarData";
+import type { TaskRunStatus } from "@shared/types";
+import type { SituationId } from "@shared/types/workflow";
+import { classify } from "@shared/types/workflow-classify";
+import { useNavigationStore } from "@stores/navigationStore";
+import { useMemo } from "react";
+import { buildDemoSnapshot, EMPTY_SNAPSHOT } from "../fixtures/demoSnapshot";
+import { useHomeDemoStore } from "../stores/homeDemoStore";
+
+export type HomeActiveAgent = {
+  taskId: string;
+  title: string;
+  repoName: string | null;
+  branch: string | null;
+  status: TaskRunStatus;
+  lastActivityAt: number;
+  needsPermission: boolean;
+  cloudPrUrl: string | null;
+};
+
+// Until the GitHub fetcher lands, real data only ever has `pr: null`. Kept
+// on the type because demo fixtures populate it and the detail panel renders
+// the richer view when present.
+export type HomePullRequest = {
+  url: string;
+  number: number;
+  title: string;
+  state: "open" | "draft" | "merged" | "closed";
+  ciStatus: "passing" | "failing" | "pending" | "none";
+  unresolvedThreads: number;
+  reviewDecision: "approved" | "changes_requested" | "review_required" | null;
+  isCurrentUserRequestedReviewer: boolean;
+  isCurrentUserAuthor: boolean;
+  author: string | null;
+  lastUpdatedAt: number;
+};
+
+export type HomeWorkstreamTask = {
+  id: string;
+  title: string;
+  status?: TaskRunStatus;
+  isGenerating: boolean;
+  needsPermission: boolean;
+};
+
+export type HomeWorkstream = {
+  id: string;
+  repoName: string | null;
+  branch: string | null;
+  prUrl: string | null;
+  pr: HomePullRequest | null;
+  tasks: HomeWorkstreamTask[];
+  /** Situations this workstream is in — drives board placement + bound actions. */
+  situations: SituationId[];
+  lastActivityAt: number;
+};
+
+export type HomeSnapshot = {
+  activeAgents: HomeActiveAgent[];
+  needsAttention: HomeWorkstream[];
+  inProgress: HomeWorkstream[];
+};
+
+const RUNNING_STATUSES: ReadonlySet<TaskRunStatus> = new Set([
+  "queued",
+  "in_progress",
+]);
+
+// Situations that escalate a workstream into the "Needs attention" bucket on
+// the list view. Everything else falls into "In progress".
+const ATTENTION_SITUATIONS: ReadonlySet<SituationId> = new Set([
+  "ci_failing",
+  "changes_requested",
+  "comments_waiting",
+  "stale",
+]);
+
+function isRunning(status?: TaskRunStatus): boolean {
+  return !!status && RUNNING_STATUSES.has(status);
+}
+
+function workstreamKey(task: TaskData): string | null {
+  const repo = task.repository?.name ?? null;
+  const branch = task.linkedBranch ?? task.branchName ?? null;
+  if (task.cloudPrUrl) return `pr:${task.cloudPrUrl}`;
+  if (repo && branch) return `branch:${repo}#${branch}`;
+  return null;
+}
+
+function buildSnapshotFromTasks(
+  pinned: TaskData[],
+  flat: TaskData[],
+): HomeSnapshot {
+  const allTasks = [...pinned, ...flat];
+  const now = Date.now();
+
+  const activeAgents: HomeActiveAgent[] = [];
+  const groups = new Map<string, TaskData[]>();
+  const taskInStrip = new Set<string>();
+
+  for (const task of allTasks) {
+    if (isRunning(task.taskRunStatus)) {
+      activeAgents.push({
+        taskId: task.id,
+        title: task.title,
+        repoName: task.repository?.name ?? null,
+        branch: task.linkedBranch ?? task.branchName ?? null,
+        status: task.taskRunStatus as TaskRunStatus,
+        lastActivityAt: task.lastActivityAt,
+        needsPermission: task.needsPermission,
+        cloudPrUrl: task.cloudPrUrl,
+      });
+      taskInStrip.add(task.id);
+      continue;
+    }
+    const key = workstreamKey(task);
+    if (!key) continue;
+    const bucket = groups.get(key);
+    if (bucket) bucket.push(task);
+    else groups.set(key, [task]);
+  }
+
+  activeAgents.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+
+  const needsAttention: HomeWorkstream[] = [];
+  const inProgress: HomeWorkstream[] = [];
+
+  for (const [id, tasks] of groups) {
+    tasks.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+    const head = tasks[0];
+    if (!head) continue;
+
+    if (tasks.every((t) => taskInStrip.has(t.id))) continue;
+
+    const prUrl = tasks.find((t) => t.cloudPrUrl)?.cloudPrUrl ?? null;
+    const branch = head.linkedBranch ?? head.branchName ?? null;
+    const lastActivityAt = head.lastActivityAt;
+
+    const situations = Array.from(
+      classify({
+        hasPrUrl: !!prUrl,
+        pr: null,
+        branch,
+        lastActivityAt,
+        now,
+      }),
+    );
+
+    const workstream: HomeWorkstream = {
+      id,
+      repoName: head.repository?.name ?? null,
+      branch,
+      prUrl,
+      pr: null,
+      tasks: tasks.map((t) => ({
+        id: t.id,
+        title: t.title,
+        status: t.taskRunStatus,
+        isGenerating: t.isGenerating,
+        needsPermission: t.needsPermission,
+      })),
+      situations,
+      lastActivityAt,
+    };
+
+    if (situations.some((s) => ATTENTION_SITUATIONS.has(s))) {
+      needsAttention.push(workstream);
+    } else {
+      inProgress.push(workstream);
+    }
+  }
+
+  needsAttention.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+  inProgress.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+
+  return { activeAgents, needsAttention, inProgress };
+}
+
+export function useHomeSnapshot(): {
+  snapshot: HomeSnapshot;
+  isLoading: boolean;
+  sidebarData: SidebarData;
+  isDemo: boolean;
+} {
+  const view = useNavigationStore((s) => s.view);
+  const sidebarData = useSidebarData({ activeView: view });
+  const demoScenario = useHomeDemoStore((s) => s.scenario);
+
+  const realSnapshot = useMemo(
+    () =>
+      buildSnapshotFromTasks(sidebarData.pinnedTasks, sidebarData.flatTasks),
+    [sidebarData.pinnedTasks, sidebarData.flatTasks],
+  );
+
+  const snapshot = useMemo(() => {
+    if (demoScenario === "populated") return buildDemoSnapshot();
+    if (demoScenario === "empty") return EMPTY_SNAPSHOT;
+    return realSnapshot;
+  }, [demoScenario, realSnapshot]);
+
+  return {
+    snapshot,
+    isLoading: demoScenario !== "off" ? false : sidebarData.isLoading,
+    sidebarData,
+    isDemo: demoScenario !== "off",
+  };
+}
diff --git a/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
new file mode 100644
index 0000000000..ab741c92c2
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
@@ -0,0 +1,27 @@
+import { useNavigationStore } from "@stores/navigationStore";
+import { toast } from "@utils/toast";
+import { useCallback } from "react";
+import type { BoundAction } from "./useBoundActions";
+import type { HomeWorkstream } from "./useHomeSnapshot";
+
+// Routes a bound workflow action into the new-task screen with the prompt
+// prefilled, rather than firing `taskService.createTask` directly: the user
+// still picks skill/branch/model on that screen, and we don't want to
+// duplicate that picker logic here.
+export function useRunWorkstreamAction() {
+  const navigateToTaskInput = useNavigationStore((s) => s.navigateToTaskInput);
+
+  return useCallback(
+    (action: BoundAction, workstream: HomeWorkstream) => {
+      navigateToTaskInput({
+        initialPrompt: action.prompt,
+        initialCloudRepository: workstream.repoName ?? undefined,
+      });
+      toast.info(
+        action.label,
+        `Pick the "${action.skillId}" skill on the next screen — prompt is prefilled.`,
+      );
+    },
+    [navigateToTaskInput],
+  );
+}
diff --git a/apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts b/apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts
new file mode 100644
index 0000000000..ba5d38164c
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts
@@ -0,0 +1,14 @@
+import { useTRPC } from "@renderer/trpc";
+import { useQuery } from "@tanstack/react-query";
+
+// Thin wrapper around the existing skills router — used by the workflow
+// action editor to populate the skill dropdown so the user picks a real
+// skill instead of typing an id.
+export function useSkillsForPicker() {
+  const trpc = useTRPC();
+  const query = useQuery(trpc.skills.list.queryOptions());
+  return {
+    skills: query.data ?? [],
+    isLoading: query.isLoading,
+  };
+}
diff --git a/apps/code/src/renderer/features/home/hooks/useWorkflow.ts b/apps/code/src/renderer/features/home/hooks/useWorkflow.ts
new file mode 100644
index 0000000000..4925c042ec
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/useWorkflow.ts
@@ -0,0 +1,16 @@
+import { useTRPC } from "@renderer/trpc";
+import { useQuery } from "@tanstack/react-query";
+
+// Single-query window into the persisted WorkflowConfig. Subscription updates
+// arrive via features/home/subscriptions.ts and write back through the same
+// query key so consumers re-render without orchestration here.
+export function useWorkflow() {
+  const trpc = useTRPC();
+  const query = useQuery(trpc.workflow.get.queryOptions());
+  return {
+    workflow: query.data ?? null,
+    isLoading: query.isLoading,
+    error: query.error,
+    refetch: query.refetch,
+  };
+}
diff --git a/apps/code/src/renderer/features/home/stores/homeDemoStore.ts b/apps/code/src/renderer/features/home/stores/homeDemoStore.ts
new file mode 100644
index 0000000000..62adedad5f
--- /dev/null
+++ b/apps/code/src/renderer/features/home/stores/homeDemoStore.ts
@@ -0,0 +1,23 @@
+import { electronStorage } from "@utils/electronStorage";
+import { create } from "zustand";
+import { persist } from "zustand/middleware";
+
+export type HomeDemoScenario = "off" | "populated" | "empty";
+
+interface HomeDemoStore {
+  scenario: HomeDemoScenario;
+  setScenario: (scenario: HomeDemoScenario) => void;
+}
+
+export const useHomeDemoStore = create<HomeDemoStore>()(
+  persist(
+    (set) => ({
+      scenario: "off",
+      setScenario: (scenario) => set({ scenario }),
+    }),
+    {
+      name: "home-demo-store",
+      storage: electronStorage,
+    },
+  ),
+);
diff --git a/apps/code/src/renderer/features/home/stores/homeUiStore.ts b/apps/code/src/renderer/features/home/stores/homeUiStore.ts
new file mode 100644
index 0000000000..c72059bca2
--- /dev/null
+++ b/apps/code/src/renderer/features/home/stores/homeUiStore.ts
@@ -0,0 +1,28 @@
+import { electronStorage } from "@utils/electronStorage";
+import { create } from "zustand";
+import { persist } from "zustand/middleware";
+
+export type HomeViewMode = "list" | "board" | "config";
+
+interface HomeUiStore {
+  viewMode: HomeViewMode;
+  setViewMode: (mode: HomeViewMode) => void;
+  selectedWorkstreamId: string | null;
+  setSelectedWorkstreamId: (id: string | null) => void;
+}
+
+export const useHomeUiStore = create<HomeUiStore>()(
+  persist(
+    (set) => ({
+      viewMode: "list",
+      setViewMode: (mode) => set({ viewMode: mode }),
+      selectedWorkstreamId: null,
+      setSelectedWorkstreamId: (id) => set({ selectedWorkstreamId: id }),
+    }),
+    {
+      name: "home-ui-store",
+      storage: electronStorage,
+      partialize: (state) => ({ viewMode: state.viewMode }),
+    },
+  ),
+);
diff --git a/apps/code/src/renderer/features/home/stores/workflowEditorStore.ts b/apps/code/src/renderer/features/home/stores/workflowEditorStore.ts
new file mode 100644
index 0000000000..d893fbd0d1
--- /dev/null
+++ b/apps/code/src/renderer/features/home/stores/workflowEditorStore.ts
@@ -0,0 +1,169 @@
+import {
+  SITUATION_IDS,
+  type SituationId,
+  type ValidationDiagnostic,
+  type WorkflowAction,
+  type WorkflowBindings,
+  type WorkflowConfig,
+  type WorkflowDraft,
+} from "@shared/types/workflow";
+import { create } from "zustand";
+
+// Uncommitted editor state for the Config view. Persisted workflow lives in
+// the tRPC query cache; this store only holds the in-flight draft, dirty
+// flag, and validation diagnostics.
+
+export type Selection =
+  | { kind: "action"; situationId: SituationId; actionId: string }
+  | { kind: "situation"; situationId: SituationId }
+  | null;
+
+interface WorkflowEditorStore {
+  draft: WorkflowDraft | null;
+  baselineSerialized: string | null;
+  dirty: boolean;
+  diagnostics: ValidationDiagnostic[];
+  selection: Selection;
+
+  beginEdit(persisted: WorkflowConfig): void;
+  discardEdit(persisted: WorkflowConfig): void;
+  addAction(situation: SituationId, action: WorkflowAction): void;
+  updateAction(
+    situation: SituationId,
+    actionId: string,
+    patch: Partial<WorkflowAction>,
+  ): void;
+  removeAction(situation: SituationId, actionId: string): void;
+  moveAction(
+    situation: SituationId,
+    actionId: string,
+    direction: "up" | "down",
+  ): void;
+  setDiagnostics(diagnostics: ValidationDiagnostic[]): void;
+  selectAction(ref: Extract<Selection, { kind: "action" }> | null): void;
+  selectSituation(id: SituationId | null): void;
+  clearSelection(): void;
+}
+
+function serialize(draft: WorkflowDraft): string {
+  return JSON.stringify(draft.bindings);
+}
+
+function toDraft(config: WorkflowConfig): WorkflowDraft {
+  // Normalize bindings to cover every situation key (the schema's `z.record`
+  // technically allows partial maps). Consumers can then read
+  // `bindings[sid]` without optional-chaining.
+  const bindings = Object.fromEntries(
+    SITUATION_IDS.map((sid) => [sid, config.bindings[sid] ?? []]),
+  ) as WorkflowBindings;
+  return {
+    id: config.id,
+    version: config.version,
+    bindings,
+  };
+}
+
+function commit(
+  set: (partial: Partial<WorkflowEditorStore>) => void,
+  next: WorkflowDraft,
+  baseline: string | null,
+) {
+  set({
+    draft: next,
+    dirty: baseline !== null && serialize(next) !== baseline,
+  });
+}
+
+export const useWorkflowEditorStore = create<WorkflowEditorStore>(
+  (set, get) => ({
+    draft: null,
+    baselineSerialized: null,
+    dirty: false,
+    diagnostics: [],
+    selection: null,
+
+    beginEdit(persisted) {
+      const draft = toDraft(persisted);
+      set({
+        draft,
+        baselineSerialized: serialize(draft),
+        dirty: false,
+        diagnostics: [],
+        selection: null,
+      });
+    },
+
+    discardEdit(persisted) {
+      const draft = toDraft(persisted);
+      set({
+        draft,
+        baselineSerialized: serialize(draft),
+        dirty: false,
+        diagnostics: [],
+        selection: null,
+      });
+    },
+
+    addAction(situation, action) {
+      const { draft, baselineSerialized } = get();
+      if (!draft) return;
+      const current = draft.bindings[situation] ?? [];
+      const bindings = {
+        ...draft.bindings,
+        [situation]: [...current, action],
+      };
+      commit(set, { ...draft, bindings }, baselineSerialized);
+    },
+
+    updateAction(situation, actionId, patch) {
+      const { draft, baselineSerialized } = get();
+      if (!draft) return;
+      const current = draft.bindings[situation] ?? [];
+      const next = current.map((a) =>
+        a.id === actionId ? { ...a, ...patch } : a,
+      );
+      const bindings = { ...draft.bindings, [situation]: next };
+      commit(set, { ...draft, bindings }, baselineSerialized);
+    },
+
+    removeAction(situation, actionId) {
+      const { draft, baselineSerialized } = get();
+      if (!draft) return;
+      const current = draft.bindings[situation] ?? [];
+      const next = current.filter((a) => a.id !== actionId);
+      const bindings = { ...draft.bindings, [situation]: next };
+      commit(set, { ...draft, bindings }, baselineSerialized);
+    },
+
+    moveAction(situation, actionId, direction) {
+      const { draft, baselineSerialized } = get();
+      if (!draft) return;
+      const current = draft.bindings[situation] ?? [];
+      const idx = current.findIndex((a) => a.id === actionId);
+      if (idx === -1) return;
+      const target = direction === "up" ? idx - 1 : idx + 1;
+      if (target < 0 || target >= current.length) return;
+      const next = [...current];
+      const [removed] = next.splice(idx, 1);
+      if (!removed) return;
+      next.splice(target, 0, removed);
+      const bindings = { ...draft.bindings, [situation]: next };
+      commit(set, { ...draft, bindings }, baselineSerialized);
+    },
+
+    setDiagnostics(diagnostics) {
+      set({ diagnostics });
+    },
+    selectAction(ref) {
+      set({ selection: ref });
+    },
+    selectSituation(id) {
+      set({
+        selection: id === null ? null : { kind: "situation", situationId: id },
+      });
+    },
+    clearSelection() {
+      set({ selection: null });
+    },
+  }),
+);
diff --git a/apps/code/src/renderer/features/home/subscriptions.ts b/apps/code/src/renderer/features/home/subscriptions.ts
new file mode 100644
index 0000000000..5ebd8bb97b
--- /dev/null
+++ b/apps/code/src/renderer/features/home/subscriptions.ts
@@ -0,0 +1,20 @@
+import { trpc, trpcClient } from "@renderer/trpc";
+import { logger } from "@utils/logger";
+import { queryClient } from "@utils/queryClient";
+
+const log = logger.scope("home-subscriptions");
+
+export function registerHomeSubscriptions() {
+  const workflowChanged = trpcClient.workflow.onChanged.subscribe(undefined, {
+    onData: (next) => {
+      queryClient.setQueryData(trpc.workflow.get.queryKey(), next);
+    },
+    onError: (error) => {
+      log.error("workflow.onChanged subscription error", { error });
+    },
+  });
+
+  return () => {
+    workflowChanged.unsubscribe();
+  };
+}
diff --git a/apps/code/src/renderer/features/home/utils/boardColumns.ts b/apps/code/src/renderer/features/home/utils/boardColumns.ts
new file mode 100644
index 0000000000..767f86fca6
--- /dev/null
+++ b/apps/code/src/renderer/features/home/utils/boardColumns.ts
@@ -0,0 +1,61 @@
+import { SITUATIONS, type SituationId } from "@shared/types/workflow";
+import { pickPrimarySituation } from "@shared/types/workflow-classify";
+import type { HomeWorkstream } from "../hooks/useHomeSnapshot";
+
+export type HomeBoardColumn = {
+  id: SituationId;
+  title: string;
+  description: string;
+  workstreams: HomeWorkstream[];
+};
+
+// Columns shown on the board, left → right. We omit `done` from the active
+// view (terminal situations don't need a column — they should fall off) and
+// `stale` (it's a modifier, not a workflow stage; it surfaces as a chip).
+const BOARD_COLUMN_IDS: SituationId[] = [
+  "working",
+  "in_review",
+  "ci_failing",
+  "changes_requested",
+  "comments_waiting",
+  "ready_to_merge",
+];
+
+export function columnForWorkstream(
+  workstream: HomeWorkstream,
+): SituationId | null {
+  const primary = pickPrimarySituation(workstream.situations);
+  if (!primary) return null;
+  // Push terminal/done situations off the active board.
+  if (primary === "done") return null;
+  // `stale` alone (no PR situation) is still useful to surface — bucket it
+  // into `working` since that's where stale-no-PR work belongs visually.
+  if (primary === "stale") return "working";
+  return primary;
+}
+
+export function buildBoardColumns(
+  needsAttention: HomeWorkstream[],
+  inProgress: HomeWorkstream[],
+): HomeBoardColumn[] {
+  const map = new Map<SituationId, HomeWorkstream[]>();
+  for (const id of BOARD_COLUMN_IDS) map.set(id, []);
+
+  for (const ws of [...needsAttention, ...inProgress]) {
+    const id = columnForWorkstream(ws);
+    if (!id) continue;
+    map.get(id)?.push(ws);
+  }
+
+  return BOARD_COLUMN_IDS.map((id) => {
+    const meta = SITUATIONS.find((s) => s.id === id);
+    return {
+      id,
+      title: meta?.label ?? id,
+      description: meta?.description ?? "",
+      workstreams: (map.get(id) ?? []).sort(
+        (a, b) => b.lastActivityAt - a.lastActivityAt,
+      ),
+    };
+  });
+}
diff --git a/apps/code/src/renderer/features/home/utils/situationDisplay.ts b/apps/code/src/renderer/features/home/utils/situationDisplay.ts
new file mode 100644
index 0000000000..9b8e8fde1d
--- /dev/null
+++ b/apps/code/src/renderer/features/home/utils/situationDisplay.ts
@@ -0,0 +1,48 @@
+import { SITUATIONS, type SituationId } from "@shared/types/workflow";
+
+// O(1) lookup table for situation metadata, built once at module load.
+// SITUATIONS itself is an array (ordered for the renderer); this is the map.
+export const SITUATION_META: Record<
+  SituationId,
+  { label: string; description: string }
+> = Object.fromEntries(
+  SITUATIONS.map((s) => [s.id, { label: s.label, description: s.description }]),
+) as Record<SituationId, { label: string; description: string }>;
+
+export const SITUATION_BADGE: Record<
+  SituationId,
+  "destructive" | "warning" | "success" | "info" | "default"
+> = {
+  done: "default",
+  ready_to_merge: "success",
+  ci_failing: "destructive",
+  changes_requested: "warning",
+  comments_waiting: "warning",
+  in_review: "info",
+  working: "default",
+  stale: "default",
+};
+
+export type WorkstreamSeverity = "critical" | "attention" | null;
+
+// Derived from situations rather than a separate field — `ci_failing` is the
+// only "critical" today; the user-action-requested situations are "attention".
+const CRITICAL: ReadonlySet<SituationId> = new Set(["ci_failing"]);
+const ATTENTION: ReadonlySet<SituationId> = new Set([
+  "changes_requested",
+  "comments_waiting",
+]);
+
+export function situationSeverity(
+  situations: readonly SituationId[],
+): WorkstreamSeverity {
+  if (situations.some((s) => CRITICAL.has(s))) return "critical";
+  if (situations.some((s) => ATTENTION.has(s))) return "attention";
+  return null;
+}
+
+export function severityRingClass(severity: WorkstreamSeverity): string {
+  if (severity === "critical") return "border-l-2 border-l-(--red-9)";
+  if (severity === "attention") return "border-l-2 border-l-(--amber-9)";
+  return "";
+}
diff --git a/apps/code/src/renderer/features/sidebar/components/SidebarMenu.tsx b/apps/code/src/renderer/features/sidebar/components/SidebarMenu.tsx
index 7ef074b320..618fda1ac0 100644
--- a/apps/code/src/renderer/features/sidebar/components/SidebarMenu.tsx
+++ b/apps/code/src/renderer/features/sidebar/components/SidebarMenu.tsx
@@ -32,8 +32,10 @@ import { useTaskViewed } from "../hooks/useTaskViewed";
 import { useSidebarStore } from "../stores/sidebarStore";
 import { useTaskSelectionStore } from "../stores/taskSelectionStore";
 import { CommandCenterItem } from "./items/CommandCenterItem";
-import { InboxItem, NewTaskItem } from "./items/HomeItem";
+import { HomeItem } from "./items/HomeItem";
+import { InboxItem } from "./items/InboxItem";
 import { McpServersItem } from "./items/McpServersItem";
+import { NewTaskItem } from "./items/NewTaskItem";
 import { SearchItem } from "./items/SearchItem";
 import { SkillsItem } from "./items/SkillsItem";
 import { SidebarItem } from "./SidebarItem";
@@ -44,6 +46,7 @@ function SidebarMenuComponent() {
     view,
     navigateToTask,
     navigateToTaskInput,
+    navigateToHome,
     navigateToInbox,
     navigateToCommandCenter,
     navigateToSkills,
@@ -114,6 +117,10 @@ function SidebarMenuComponent() {
     navigateToTaskInput();
   };
 
+  const handleHomeClick = () => {
+    navigateToHome();
+  };
+
   const handleInboxClick = () => {
     navigateToInbox();
   };
@@ -398,6 +405,13 @@ function SidebarMenuComponent() {
             />
           </Box>
 
+          <Box>
+            <HomeItem
+              isActive={sidebarData.isHomeViewActive}
+              onClick={handleHomeClick}
+            />
+          </Box>
+
           <Box>
             <SearchItem onClick={handleSearchClick} />
           </Box>
diff --git a/apps/code/src/renderer/features/sidebar/components/items/HomeItem.tsx b/apps/code/src/renderer/features/sidebar/components/items/HomeItem.tsx
index 648ce78d35..237cb73565 100644
--- a/apps/code/src/renderer/features/sidebar/components/items/HomeItem.tsx
+++ b/apps/code/src/renderer/features/sidebar/components/items/HomeItem.tsx
@@ -1,96 +1,40 @@
-import { Tooltip } from "@components/ui/Tooltip";
-import { EnvelopeSimple, Plus } from "@phosphor-icons/react";
-import { Badge, type ButtonProps } from "@posthog/quill";
-import { SHORTCUTS } from "@renderer/constants/keyboard-shortcuts";
-import { useDraftStore } from "@renderer/features/message-editor/stores/draftStore";
-import { isContentEmpty } from "@renderer/features/message-editor/utils/content";
+import { House } from "@phosphor-icons/react";
+import { Badge } from "@posthog/quill";
 import { SidebarItem } from "../SidebarItem";
-import { SidebarKbdHint } from "./SidebarKbdHint";
 
-interface NewTaskItemProps {
+interface HomeItemProps {
   isActive: boolean;
   onClick: () => void;
-  variant?: ButtonProps["variant"];
+  attentionCount?: number;
 }
 
-export function NewTaskItem({ isActive, onClick }: NewTaskItemProps) {
-  const hasDraft = useDraftStore(
-    (s) => !isContentEmpty(s.drafts["task-input"]),
-  );
+function formatAttentionCount(count: number): string {
+  if (count > 99) return "99+";
+  return String(count);
+}
+
+export function HomeItem({ isActive, onClick, attentionCount }: HomeItemProps) {
   return (
     <SidebarItem
       depth={0}
-      icon={<Plus size={16} weight={isActive ? "bold" : "regular"} />}
-      label="New task"
-      isActive={isActive}
-      onClick={onClick}
-      endContent={
+      icon={<House size={16} weight={isActive ? "fill" : "regular"} />}
+      label={
         <>
-          {hasDraft ? (
-            <Badge variant="default" title="You have unsubmitted changes">
-              Draft
-            </Badge>
+          Home
+          {attentionCount && attentionCount > 0 ? (
+            <span
+              className="ml-2 inline-flex shrink-0 items-center justify-center rounded-full bg-(--red-9) p-1 font-medium text-[10px] leading-none"
+              style={{ color: "white" }}
+              title={`${attentionCount} item${attentionCount === 1 ? "" : "s"} needing attention`}
+            >
+              {formatAttentionCount(attentionCount)}
+            </span>
           ) : null}
-          <SidebarKbdHint keys={SHORTCUTS.NEW_TASK} />
         </>
       }
+      isActive={isActive}
+      onClick={onClick}
+      endContent={<Badge variant="warning">Alpha</Badge>}
     />
   );
 }
-
-interface InboxItemProps {
-  isActive: boolean;
-  onClick: () => void;
-  signalCount?: number;
-}
-
-function formatSignalCount(count: number): string {
-  if (count > 99) return "99+";
-  return String(count);
-}
-
-export function InboxItem({ isActive, onClick, signalCount }: InboxItemProps) {
-  return (
-    <Tooltip
-      content={
-        signalCount && signalCount > 0
-          ? `${signalCount} actionable report${signalCount === 1 ? "" : "s"} assigned to you`
-          : "No actionable reports assigned to you yet"
-      }
-      side="right"
-    >
-      <div>
-        <SidebarItem
-          depth={0}
-          icon={
-            <EnvelopeSimple size={16} weight={isActive ? "fill" : "regular"} />
-          }
-          label={
-            <>
-              Inbox
-              {signalCount && signalCount > 0 ? (
-                <span
-                  className="ml-2 inline-flex shrink-0 items-center justify-center rounded-full bg-(--red-9) p-1 font-medium text-[10px] leading-none"
-                  style={{
-                    color: "white",
-                  }}
-                  title={`${signalCount} actionable reports for you`}
-                >
-                  {formatSignalCount(signalCount)}
-                </span>
-              ) : null}
-            </>
-          }
-          isActive={isActive}
-          onClick={onClick}
-          endContent={
-            <>
-              <Badge variant="warning">Alpha</Badge>
-              <SidebarKbdHint keys={SHORTCUTS.INBOX} />
-            </>
-          }
-        />
-      </div>
-    </Tooltip>
-  );
-}
diff --git a/apps/code/src/renderer/features/sidebar/components/items/InboxItem.tsx b/apps/code/src/renderer/features/sidebar/components/items/InboxItem.tsx
new file mode 100644
index 0000000000..9ef364ac74
--- /dev/null
+++ b/apps/code/src/renderer/features/sidebar/components/items/InboxItem.tsx
@@ -0,0 +1,63 @@
+import { Tooltip } from "@components/ui/Tooltip";
+import { EnvelopeSimple } from "@phosphor-icons/react";
+import { Badge } from "@posthog/quill";
+import { SHORTCUTS } from "@renderer/constants/keyboard-shortcuts";
+import { SidebarItem } from "../SidebarItem";
+import { SidebarKbdHint } from "./SidebarKbdHint";
+
+interface InboxItemProps {
+  isActive: boolean;
+  onClick: () => void;
+  signalCount?: number;
+}
+
+function formatSignalCount(count: number): string {
+  if (count > 99) return "99+";
+  return String(count);
+}
+
+export function InboxItem({ isActive, onClick, signalCount }: InboxItemProps) {
+  return (
+    <Tooltip
+      content={
+        signalCount && signalCount > 0
+          ? `${signalCount} actionable report${signalCount === 1 ? "" : "s"} assigned to you`
+          : "No actionable reports assigned to you yet"
+      }
+      side="right"
+    >
+      <div>
+        <SidebarItem
+          depth={0}
+          icon={
+            <EnvelopeSimple size={16} weight={isActive ? "fill" : "regular"} />
+          }
+          label={
+            <>
+              Inbox
+              {signalCount && signalCount > 0 ? (
+                <span
+                  className="ml-2 inline-flex shrink-0 items-center justify-center rounded-full bg-(--red-9) p-1 font-medium text-[10px] leading-none"
+                  style={{
+                    color: "white",
+                  }}
+                  title={`${signalCount} actionable reports for you`}
+                >
+                  {formatSignalCount(signalCount)}
+                </span>
+              ) : null}
+            </>
+          }
+          isActive={isActive}
+          onClick={onClick}
+          endContent={
+            <>
+              <Badge variant="warning">Alpha</Badge>
+              <SidebarKbdHint keys={SHORTCUTS.INBOX} />
+            </>
+          }
+        />
+      </div>
+    </Tooltip>
+  );
+}
diff --git a/apps/code/src/renderer/features/sidebar/components/items/NewTaskItem.tsx b/apps/code/src/renderer/features/sidebar/components/items/NewTaskItem.tsx
new file mode 100644
index 0000000000..4708654d2e
--- /dev/null
+++ b/apps/code/src/renderer/features/sidebar/components/items/NewTaskItem.tsx
@@ -0,0 +1,38 @@
+import { Plus } from "@phosphor-icons/react";
+import { Badge, type ButtonProps } from "@posthog/quill";
+import { SHORTCUTS } from "@renderer/constants/keyboard-shortcuts";
+import { useDraftStore } from "@renderer/features/message-editor/stores/draftStore";
+import { isContentEmpty } from "@renderer/features/message-editor/utils/content";
+import { SidebarItem } from "../SidebarItem";
+import { SidebarKbdHint } from "./SidebarKbdHint";
+
+interface NewTaskItemProps {
+  isActive: boolean;
+  onClick: () => void;
+  variant?: ButtonProps["variant"];
+}
+
+export function NewTaskItem({ isActive, onClick }: NewTaskItemProps) {
+  const hasDraft = useDraftStore(
+    (s) => !isContentEmpty(s.drafts["task-input"]),
+  );
+  return (
+    <SidebarItem
+      depth={0}
+      icon={<Plus size={16} weight={isActive ? "bold" : "regular"} />}
+      label="New task"
+      isActive={isActive}
+      onClick={onClick}
+      endContent={
+        <>
+          {hasDraft ? (
+            <Badge variant="default" title="You have unsubmitted changes">
+              Draft
+            </Badge>
+          ) : null}
+          <SidebarKbdHint keys={SHORTCUTS.NEW_TASK} />
+        </>
+      }
+    />
+  );
+}
diff --git a/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts b/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
index c7a49b150a..1ab8a94238 100644
--- a/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
+++ b/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
@@ -49,6 +49,7 @@ export type TaskGroup = GenericTaskGroup<TaskData>;
 
 export interface SidebarData {
   isHomeActive: boolean;
+  isHomeViewActive: boolean;
   isInboxActive: boolean;
   isCommandCenterActive: boolean;
   isSkillsActive: boolean;
@@ -69,6 +70,7 @@ interface ViewState {
     | "task-input"
     | "settings"
     | "folder-settings"
+    | "home"
     | "inbox"
     | "archived"
     | "command-center"
@@ -220,6 +222,7 @@ export function useSidebarData({
 
   const isHomeActive =
     activeView.type === "task-input" || activeView.type === "task-pending";
+  const isHomeViewActive = activeView.type === "home";
   const isInboxActive = activeView.type === "inbox";
   const isCommandCenterActive = activeView.type === "command-center";
   const isSkillsActive = activeView.type === "skills";
@@ -350,6 +353,7 @@ export function useSidebarData({
 
   return {
     isHomeActive,
+    isHomeViewActive,
     isInboxActive,
     isCommandCenterActive,
     isSkillsActive,
diff --git a/apps/code/src/renderer/stores/navigationStore.ts b/apps/code/src/renderer/stores/navigationStore.ts
index 3bfb98fb3b..fd3d01d4b0 100644
--- a/apps/code/src/renderer/stores/navigationStore.ts
+++ b/apps/code/src/renderer/stores/navigationStore.ts
@@ -17,6 +17,7 @@ type ViewType =
   | "task-pending"
   | "task-input"
   | "folder-settings"
+  | "home"
   | "inbox"
   | "archived"
   | "command-center"
@@ -64,6 +65,7 @@ interface NavigationStore {
   ) => void;
   clearTaskInputReportAssociation: () => void;
   navigateToFolderSettings: (folderId: string) => void;
+  navigateToHome: () => void;
   navigateToInbox: () => void;
   navigateToArchived: () => void;
   navigateToCommandCenter: () => void;
@@ -93,6 +95,9 @@ const isSameView = (view1: ViewState, view2: ViewState): boolean => {
   if (view1.type === "folder-settings" && view2.type === "folder-settings") {
     return view1.folderId === view2.folderId;
   }
+  if (view1.type === "home" && view2.type === "home") {
+    return true;
+  }
   if (view1.type === "inbox" && view2.type === "inbox") {
     return true;
   }
@@ -284,6 +289,10 @@ export const useNavigationStore = create<NavigationStore>()(
           navigate({ type: "folder-settings", folderId });
         },
 
+        navigateToHome: () => {
+          navigate({ type: "home" });
+        },
+
         navigateToInbox: () => {
           navigate({ type: "inbox" });
         },
diff --git a/apps/code/src/shared/types/workflow-classify.ts b/apps/code/src/shared/types/workflow-classify.ts
new file mode 100644
index 0000000000..00de4b6a16
--- /dev/null
+++ b/apps/code/src/shared/types/workflow-classify.ts
@@ -0,0 +1,114 @@
+import type { SituationId } from "@shared/types/workflow";
+
+// Inputs the classifier needs to decide which situations a piece of work
+// is in. All optional / nullable so the same function works whether we
+// have rich GitHub data, just a local git state, or only task metadata.
+export interface ClassifyInput {
+  /** True if any task on the workstream points at a PR URL. */
+  hasPrUrl: boolean;
+  /** PR snapshot (when available — null until a GitHub fetcher is wired up). */
+  pr: {
+    state: "open" | "draft" | "merged" | "closed";
+    ciStatus: "passing" | "failing" | "pending" | "none";
+    reviewDecision: "approved" | "changes_requested" | "review_required" | null;
+    unresolvedThreads: number;
+    isCurrentUserAuthor: boolean;
+    mergeable?: boolean | null;
+  } | null;
+  /** Local git ahead/behind, when we have a worktree to inspect. */
+  gitState?: {
+    commitsAhead: number;
+    commitsBehind?: number;
+    dirty?: boolean;
+  } | null;
+  /** Branch the workstream is on (used as a working signal when no PR yet). */
+  branch: string | null;
+  /** Epoch ms of the freshest activity across all tasks in the workstream. */
+  lastActivityAt: number;
+  /** Now — passed in so unit tests can pin time. */
+  now: number;
+}
+
+// Tunable; surfaced here so a future settings UI can expose it.
+const STALE_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000;
+
+/**
+ * Pure classifier — takes a single workstream's observed state and emits
+ * the (possibly multiple) situations it's in. Deliberately defensive: if
+ * a signal is missing, the situation that depended on it simply doesn't
+ * fire, rather than producing a misleading bucket.
+ */
+export function classify(input: ClassifyInput): Set<SituationId> {
+  const out = new Set<SituationId>();
+  const { pr, hasPrUrl, gitState, branch, lastActivityAt, now } = input;
+
+  if (pr) {
+    if (pr.state === "merged" || pr.state === "closed") {
+      out.add("done");
+      // `done` is exclusive — return early so we don't double-bucket merged PRs.
+      return out;
+    }
+
+    if (pr.ciStatus === "failing") out.add("ci_failing");
+    if (pr.reviewDecision === "changes_requested") out.add("changes_requested");
+    if (pr.unresolvedThreads > 0 && pr.isCurrentUserAuthor) {
+      out.add("comments_waiting");
+    }
+    if (
+      pr.state === "open" &&
+      pr.ciStatus === "passing" &&
+      pr.reviewDecision === "approved" &&
+      pr.mergeable !== false
+    ) {
+      out.add("ready_to_merge");
+    }
+    // `in_review` is the catch-all for any PR that's open/draft without a
+    // more-specific situation. We still emit it alongside ci_failing etc. so
+    // the list view can surface the workstream under "In review" too — the
+    // board uses primary-situation priority to decide column placement.
+    if (pr.state === "open" || pr.state === "draft") {
+      out.add("in_review");
+    }
+  } else if (hasPrUrl) {
+    // Workstream has a PR URL stamped on a task but we don't have PR data
+    // yet (the GitHub fetcher isn't wired up). Treat it as in review so it
+    // doesn't fall into `working`.
+    out.add("in_review");
+  } else if (branch) {
+    // No PR yet — branch with local changes.
+    const ahead = gitState?.commitsAhead;
+    if (ahead === undefined || ahead > 0) out.add("working");
+  }
+
+  // `stale` stacks on top of whatever else applies, except `done` (handled
+  // above with an early return).
+  if (now - lastActivityAt > STALE_THRESHOLD_MS) {
+    out.add("stale");
+  }
+
+  return out;
+}
+
+// Priority order for picking the *primary* situation when a workstream is in
+// several at once. Used by the board to decide column placement; the list
+// view can show the workstream in every section it qualifies for.
+export const SITUATION_PRIORITY: SituationId[] = [
+  "done",
+  "ready_to_merge",
+  "ci_failing",
+  "changes_requested",
+  "comments_waiting",
+  "in_review",
+  "working",
+  "stale",
+];
+
+export function pickPrimarySituation(
+  situations: ReadonlySet<SituationId> | readonly SituationId[],
+): SituationId | null {
+  const set = situations instanceof Set ? situations : new Set(situations);
+  for (const sid of SITUATION_PRIORITY) {
+    if (set.has(sid)) return sid;
+  }
+  return null;
+}
diff --git a/apps/code/src/shared/types/workflow-validate.ts b/apps/code/src/shared/types/workflow-validate.ts
new file mode 100644
index 0000000000..395e5f45b2
--- /dev/null
+++ b/apps/code/src/shared/types/workflow-validate.ts
@@ -0,0 +1,60 @@
+import {
+  SITUATION_IDS,
+  type SituationId,
+  type ValidationDiagnostic,
+  type ValidationResult,
+  type WorkflowDraft,
+} from "./workflow";
+
+export function validateWorkflow(draft: WorkflowDraft): ValidationResult {
+  const diagnostics: ValidationDiagnostic[] = [];
+
+  for (const sid of SITUATION_IDS) {
+    const actions = draft.bindings[sid] ?? [];
+    const seenIds = new Set<string>();
+    for (const action of actions) {
+      if (seenIds.has(action.id)) {
+        diagnostics.push({
+          severity: "error",
+          code: "duplicate_action_id",
+          message: `Duplicate action id "${action.id}" in ${sid}`,
+          situationId: sid as SituationId,
+          actionId: action.id,
+        });
+        continue;
+      }
+      seenIds.add(action.id);
+
+      if (action.label.trim() === "") {
+        diagnostics.push({
+          severity: "error",
+          code: "action_empty_label",
+          message: `An action in ${sid} has no label`,
+          situationId: sid as SituationId,
+          actionId: action.id,
+        });
+      }
+      if (action.skillId.trim() === "") {
+        diagnostics.push({
+          severity: "error",
+          code: "action_missing_skill",
+          message: `Action "${action.label}" in ${sid} has no skill selected`,
+          situationId: sid as SituationId,
+          actionId: action.id,
+        });
+      }
+      if (action.prompt.trim() === "") {
+        diagnostics.push({
+          severity: "error",
+          code: "action_empty_prompt",
+          message: `Action "${action.label}" in ${sid} has an empty prompt`,
+          situationId: sid as SituationId,
+          actionId: action.id,
+        });
+      }
+    }
+  }
+
+  const canSave = !diagnostics.some((d) => d.severity === "error");
+  return { diagnostics, canSave };
+}
diff --git a/apps/code/src/shared/types/workflow.ts b/apps/code/src/shared/types/workflow.ts
new file mode 100644
index 0000000000..46ec86016e
--- /dev/null
+++ b/apps/code/src/shared/types/workflow.ts
@@ -0,0 +1,134 @@
+import { z } from "zod";
+
+// Order is load-bearing: the renderer iterates this list and the classifier
+// emits situations in this order.
+export const SITUATIONS = [
+  {
+    id: "working",
+    label: "Working",
+    description: "Branch with changes, no PR yet",
+  },
+  {
+    id: "in_review",
+    label: "In review",
+    description: "PR open, nothing pending from you",
+  },
+  {
+    id: "ci_failing",
+    label: "CI failing",
+    description: "PR open, CI is red",
+  },
+  {
+    id: "changes_requested",
+    label: "Changes requested",
+    description: "A reviewer requested changes",
+  },
+  {
+    id: "comments_waiting",
+    label: "Comments waiting",
+    description: "Unresolved review threads not from you",
+  },
+  {
+    id: "ready_to_merge",
+    label: "Ready to merge",
+    description: "PR open, CI green, approved, mergeable",
+  },
+  {
+    id: "stale",
+    label: "Stale",
+    description: "No activity for a while",
+  },
+  {
+    id: "done",
+    label: "Done",
+    description: "PR merged or closed",
+  },
+] as const;
+
+export type SituationId = (typeof SITUATIONS)[number]["id"];
+export const SITUATION_IDS = SITUATIONS.map((s) => s.id) as [
+  SituationId,
+  ...SituationId[],
+];
+
+export const situationId = z.enum(SITUATION_IDS);
+
+export const workflowAction = z
+  .object({
+    id: z.string().min(1).max(64),
+    label: z.string().min(1).max(120),
+    skillId: z.string().min(1),
+    prompt: z.string().min(1).max(8_000),
+  })
+  .strict();
+export type WorkflowAction = z.infer<typeof workflowAction>;
+
+// Bindings: situation id → ordered list of actions. Every situation appears
+// as a key with at minimum an empty array, so the renderer can iterate
+// SITUATIONS without checking for nulls.
+export const workflowBindings = z.record(situationId, z.array(workflowAction));
+export type WorkflowBindings = z.infer<typeof workflowBindings>;
+
+export const workflowConfig = z
+  .object({
+    id: z.string().min(1),
+    version: z.number().int().nonnegative(),
+    updatedAt: z.string(),
+    bindings: workflowBindings,
+  })
+  .strict();
+export type WorkflowConfig = z.infer<typeof workflowConfig>;
+
+export const workflowDraft = workflowConfig
+  .omit({ updatedAt: true })
+  .extend({ updatedAt: z.string().optional() });
+export type WorkflowDraft = z.infer<typeof workflowDraft>;
+
+export const validationDiagnostic = z
+  .object({
+    severity: z.enum(["error", "warning"]),
+    code: z.enum([
+      "duplicate_action_id",
+      "action_missing_skill",
+      "action_empty_prompt",
+      "action_empty_label",
+    ]),
+    message: z.string(),
+    situationId: situationId.optional(),
+    actionId: z.string().optional(),
+  })
+  .strict();
+export type ValidationDiagnostic = z.infer<typeof validationDiagnostic>;
+
+export const validationResult = z
+  .object({
+    diagnostics: z.array(validationDiagnostic),
+    canSave: z.boolean(),
+  })
+  .strict();
+export type ValidationResult = z.infer<typeof validationResult>;
+
+export const saveInput = z
+  .object({
+    config: workflowDraft,
+    expectedVersion: z.number().int().nonnegative(),
+  })
+  .strict();
+export type SaveInput = z.infer<typeof saveInput>;
+
+export const saveResult = z
+  .object({
+    status: z.enum(["saved", "conflict", "invalid"]),
+    config: workflowConfig,
+    diagnostics: z.array(validationDiagnostic).optional(),
+  })
+  .strict();
+export type SaveResult = z.infer<typeof saveResult>;
+
+export const WorkflowEvent = {
+  Changed: "changed",
+} as const;
+
+export interface WorkflowEvents {
+  [WorkflowEvent.Changed]: WorkflowConfig;
+}
diff --git a/docs/home-tab.md b/docs/home-tab.md
new file mode 100644
index 0000000000..e04c782914
--- /dev/null
+++ b/docs/home-tab.md
@@ -0,0 +1,569 @@
+# Home tab
+
+## 1. Summary
+
+A new **Home** sidebar tab that helps users reach inbox zero on code work. Home aggregates PRs, branches, and worktrees into *workstreams* and surfaces only the items that need the user's attention right now — things that are not already obvious from the existing task list.
+
+The existing task panel already shows what your agents are doing (in-flight, failed, cancelled, needing permission). Home does **not** duplicate that. Home is about everything that happens *around* an agent task — the PR it produced, the comments people left on it, the CI that's failing, the branch that never got a PR, the review someone is waiting on you for.
+
+Home should answer:
+
+- What's running right now? (glanceable strip — no detail)
+- What needs me to do something so this work can ship?
+- What's stale and should be picked up, closed, or cleaned up?
+- Which PRs have feedback, failing checks, or are waiting on my review?
+
+## 2. Goals
+
+1. **One surface for "what needs me"** — PR feedback, failing CI, review requests, stale branches, ready-to-merge PRs.
+2. **Inbox-zero shape** — only render rows the user can act on now; snooze and mute reduce the list; no endless feed.
+3. **Agent-native actions** — primary actions kick off new tasks with the right skill (review, fix CI, address comments).
+4. **Don't duplicate the task list** — running and failed agent runs surface as a compact strip, not as attention rows.
+5. **Three views of the same data** — a triage **list** (severity-first), a workflow **board** (stage-first kanban), and a **config** canvas where the user models the workflow that the other two views derive from. Same workstream model, three renderings.
+6. **User-configurable workflow** — list sections and board columns are *not* hardcoded for the long run. The user defines the pipeline (steps, conditions, agents attached at each step) on the Config canvas; List and Board are projections of that configuration over the live `HomeSnapshot`. A built-in default workflow matches the v1 hardcoded spec so the feature ships useful on day one.
+7. **Host-agnostic architecture** — all aggregation, workflow persistence, and classification in main services; renderer is dumb (yes, even the canvas).
+
+## 3. Non-goals (v1)
+
+- Full Git client or repo browser.
+- Re-surfacing what the task panel already shows (running runs, failed runs, agents needing permission).
+- Cross-org reporting or an "all users" view.
+- Destructive cleanup automation.
+- Mirroring GitHub's notifications inbox.
+- Slack-origin signals or signal reports with no branch/PR yet — Inbox already handles those.
+
+## 4. Sidebar & navigation
+
+**Sidebar order:** New task, **Home**, Search, Inbox, Skills, MCP Servers, Command Center, task list.
+
+**Default landing view:** Home if the user has ≥1 workspace, otherwise New task.
+
+**Implementation:**
+
+- Add `"home"` to `ViewType` in `apps/code/src/renderer/stores/navigationStore.ts:24`.
+- Add `navigateToHome` action.
+- **Rename** existing `apps/code/src/renderer/features/sidebar/components/items/HomeItem.tsx` (which currently exports `NewTaskItem` and `InboxItem`) before this feature lands. New `HomeItem.tsx` owns the Home sidebar entry.
+- Add a `Home` arm to the view switch in `apps/code/src/renderer/components/MainLayout.tsx`.
+- Keep using the existing `navigationStore`; no second router introduced.
+
+## 5. Core model
+
+```ts
+type HomeSnapshot = {
+  generatedAt: string
+  summary: { needsAttention: number; inProgress: number; watching: number }
+  activeAgents: ActiveAgentSummary[]    // compact strip; see §6
+  workstreams: HomeWorkstream[]
+}
+
+type HomeWorkstream = {
+  id: string                    // PR URL → repo#branch → worktreePath → taskId
+  repository: { path?: string; owner: string; name: string } | null
+  branch: string | null
+  baseBranch: string | null
+  pr: HomePullRequest | null
+  tasks: HomeTaskSummary[]      // sorted newest first; count shown, latest expanded
+  attention: HomeAttentionItem[]
+  state: "attention" | "in_progress" | "watching"
+  lastActivityAt: string
+  lastUserViewedAt: string | null
+}
+
+type HomeAttentionItem = {
+  id: string
+  kind:
+    | "pr_review_requested"
+    | "pr_comments"
+    | "pr_ci_failed"
+    | "pr_ready_to_merge"
+    | "stale_no_pr"
+    | "branch_cleanup"
+  severity: "critical" | "attention" | "quiet"
+  source: "git" | "github"
+  title: string                 // "CI failed on test:e2e"
+  detail: string                // one-line context
+  primaryActionId: string
+  secondaryActionIds: string[]
+  snoozedUntil: string | null
+  mutedAt: string | null        // cleared on next state change
+  mutedAtSha: string | null     // anchor for "next change" detection
+}
+
+type HomePullRequest = {
+  url: string; number: number; title: string
+  state: "open" | "draft" | "merged" | "closed"
+  mergeable: boolean | null
+  ciStatus: "passing" | "failing" | "pending" | "none"
+  unresolvedThreads: number
+  newCommentsSinceViewed: number
+  reviewDecision: "approved" | "changes_requested" | "review_required" | null
+  isCurrentUserRequestedReviewer: boolean
+  isCurrentUserAuthor: boolean
+  lastUpdatedAt: string
+}
+
+type ActiveAgentSummary = {
+  taskId: string
+  taskRunId: string
+  title: string
+  branch: string | null
+  prUrl: string | null
+  startedAt: string
+  // Status comes directly from TaskRun; no Home-side classification.
+  status: "queued" | "in_progress"
+}
+```
+
+### Workflow configuration model
+
+The Config canvas persists a `WorkflowConfig` that the List and Board views project over the snapshot. The model lives in main; the renderer reads it via tRPC. A built-in default `WorkflowConfig` (matching the §6.3 hardcoded board columns) ships with the app and is used until the user customises it.
+
+```ts
+type WorkflowConfig = {
+  id: string
+  version: number              // bumps on every save; enables optimistic concurrency
+  updatedAt: string
+  nodes: WorkflowNode[]
+  edges: WorkflowEdge[]
+  layout: Record<NodeId, { x: number; y: number }>  // canvas positions, opaque to main
+}
+
+type WorkflowNode =
+  | { id: NodeId; kind: "input"; label: string; inputType: "pr_url" | "branch" | "task_prompt" }
+  | { id: NodeId; kind: "task"; label: string; skillId: string | null }
+  | { id: NodeId; kind: "step"; label: string; match: WorkflowMatch; agents: AgentBinding[] }
+  | { id: NodeId; kind: "queue"; label: string; queueKind: "stale" | "merge" | "cleanup"; match: WorkflowMatch; agents: AgentBinding[] }
+  | { id: NodeId; kind: "branch"; label: string; condition: WorkflowCondition }
+  | { id: NodeId; kind: "terminal"; label: string; terminalKind: "merged" | "closed" | "archived" }
+
+type WorkflowEdge = {
+  id: EdgeId
+  from: NodeId
+  to: NodeId
+  // Edge fires when the source node's condition resolves to this case (e.g. "ci_failed", "approved").
+  whenCase: string | null
+}
+
+// Declarative predicate; main evaluates it against a HomeWorkstream.
+type WorkflowMatch = {
+  hasPr?: boolean
+  prState?: ("open" | "draft" | "merged" | "closed")[]
+  ciStatus?: ("passing" | "failing" | "pending" | "none")[]
+  reviewDecision?: ("approved" | "changes_requested" | "review_required")[]
+  hasUnresolvedComments?: boolean
+  isStale?: { olderThanHours: number }
+  // Extend as needed; the renderer never interprets this directly.
+}
+
+type WorkflowCondition =
+  | { kind: "ci_status" }       // cases: "passing" | "failing" | "pending"
+  | { kind: "review_decision" } // cases: "approved" | "changes_requested" | "review_required"
+  | { kind: "pr_state" }        // cases: "open" | "draft" | "merged" | "closed"
+
+type AgentBinding = {
+  id: string
+  label: string                 // "Fix CI", "Address comments"
+  skillId: string               // resolved against the skills registry in main
+  promptTemplate: string        // mustache-style; main fills `{{prUrl}}`, `{{branch}}`, etc.
+  trigger: "primary" | "secondary" | "auto"  // "auto" runs as soon as a workstream lands in this node
+}
+```
+
+**Classification (main only).** `HomeService` walks each workstream against the workflow's nodes in declaration order and assigns it to the first matching `step` / `queue` node. The result is a `nodeId` per workstream, stored on the snapshot — the renderer never re-evaluates predicates. This keeps `WorkflowMatch` as a private main-side language.
+
+**Workstream grouping key precedence:** PR URL → `repo + branch` → worktree path → task id.
+
+**Note: no `run_failed` or `agent_needs_input` kinds.** Failed runs, cancelled runs, and runs awaiting permission are already obvious in the task panel. Home does not surface them as attention rows. If they materially affect downstream state (e.g. a failed run left a branch with no PR for >24h), the *branch* surfaces as `stale_no_pr` — the user-facing reason, not the agent-side cause.
+
+## 6. UI layout
+
+Home renders three views over the same `HomeSnapshot` + active `WorkflowConfig`. The user picks one with a persistent toggle in the header; data, actions, and empty states are consistent across views — only the layout and density differ.
+
+- **List view (default)** — triage-first. Two sections (Needs attention / In progress) sorted by severity and recency. Best for "what should I do next?".
+- **Board view** — workflow-first kanban. One column per `step`/`queue` node in the active workflow, left → right. Best for "where is everything in the pipeline?".
+- **Config view** — drag-and-drop canvas where the user authors the workflow that List and Board project over. Best for "how does *my* work actually flow?".
+
+A piece of work belongs to a single bucket in list/board: the list assigns it to a *section* by severity, the board assigns it to a *column* by the workflow node it matched. Same `HomeWorkstream`, two derivations of the same workflow.
+
+### 6.1 Shared chrome (both views)
+
+**Header:** title `Home`, summary line (`3 need attention · 2 running · 4 watching`), repo chip (default: current repo), **view toggle** (`List` / `Board`), refresh button.
+
+**Strip — Active agents.** Horizontal, compact, glanceable. One small card per `in_progress` or `queued` TaskRun.
+
+- Task title, branch chip, elapsed timer, skill icon.
+- Click → opens the task detail view (same as clicking it in the task panel).
+- This strip is **information, not attention**. It never gets a count badge, never blocks empty state. Hidden entirely when no agents are running.
+- The strip lives at the top in **both** views. Agents are a transient activity feed; workstreams are persistent. They run on different timescales, so they don't share visual real estate with the buckets.
+
+**Detail pane** (two-pane, like Inbox): workstream header → PR header (state, CI, reviewers) → attached task runs (clickable to their detail view) → unresolved comments preview → action bar (`SkillButtonsMenu` shape). The detail pane is shared between views — selecting a row in list or a card on the board opens the same panel.
+
+**Keyboard:** `j`/`k` move, `Enter` primary action, `s` snooze, `m` mute, `o` open in browser, `r` refresh, `v` toggle list/board.
+
+**Empty states:**
+
+- Zero attention, no agents running: "You're caught up." + summary chips.
+- Zero attention, agents running: strip is visible, sections/columns empty + "Everything else is healthy."
+- No GitHub auth: degraded mode (local Git signals only) + CTA to connect.
+- No workspaces: redirect to New task.
+
+### 6.2 List view
+
+**Section 1 — Needs attention.** Only rows where `state === "attention"`. Sorted by severity, then last activity. Multiple attention items on one workstream stack as chips on the row; top-severity drives the primary action.
+
+**Section 2 — In progress.** Workstreams with recent activity but no outstanding attention item (e.g. PR open, draft, CI green, no comments waiting on you). Collapsed by default when Section 1 is non-empty.
+
+**Section 3 — Watching.** *Not a section — a counter pill in the header.* Click expands an overlay: snoozed items, PRs awaiting external reviewers, items in pending CI. Never a default list of rows.
+
+**Row anatomy.**
+
+- Left: workstream title (PR title or branch), repo+branch metadata, attention chips.
+- Middle: PR state pill (open/draft/merged), CI dot, task-run count if >1.
+- Right: primary action button (split-button with overflow), timestamp.
+- Severity-tinted left border: red (critical) / amber (attention) / none (quiet).
+
+### 6.3 Board view
+
+**Columns are workflow-derived.** One column per `step` / `queue` node in the active `WorkflowConfig`, ordered by topological-sort over the edges (left = inputs, right = terminals). The mapping `workstream → column` is the `nodeId` already assigned by `HomeService` (see §5 Classification); the renderer does *not* re-evaluate predicates.
+
+**Default workflow (shipped pre-customisation):**
+
+| Column | Backing node | Contains | Empty placeholder |
+|---|---|---|---|
+| **No PR yet** | step `no_pr` | `stale_no_pr`; or any workstream with a branch but no PR and no other attention | "Nothing here" |
+| **In review** | step `in_review` | PR open or draft with no attention items — awaiting external reviewer or CI | "Nothing here" |
+| **Needs me** | step `needs_me` | `pr_ci_failed`, `pr_comments`, `pr_review_requested` | "Nothing here" |
+| **Ready to merge** | queue `merge_queue` | `pr_ready_to_merge` | "Nothing here" |
+| **Cleanup** | queue `cleanup` | `branch_cleanup` | "Nothing here" |
+
+A workstream belongs to exactly one column — the first node whose `match` predicate it satisfies, walked in declaration order. The default config encodes today's resolution order (`cleanup` → `merge_queue` → `needs_me` → `no_pr` → `in_review`). Once the user edits the workflow in the Config view, this default is replaced; the renderer doesn't know or care.
+
+**Card anatomy** (denser than a row):
+
+- Title (line-clamp-2), CI status icon top-right.
+- Repo, branch chip, PR `#number`, relative time.
+- Attention chips (abbreviated: `Review` / `CI` / `Feedback` / `Mergeable` / `Stale` / `Cleanup`).
+- Author chip when it's someone else's PR (`by @user`).
+- Review decision line ("Changes requested" / "Approved") when relevant.
+- One-line summary from the top attention.
+- Primary action button + task count if >1.
+- Severity-tinted left border, same colour scheme as the list rows.
+
+**Empty columns render a dashed "Nothing here" placeholder.** Important for kanban scanning — the user should be able to glance and see *which stage is empty*, not just *which stage is full*.
+
+**Why kanban as well as list:** PRs move through a fixed workflow. The list is great when you're doing inbox-zero triage ("what should I act on first?"). The board is great when you're doing a status review ("how many things are stuck in review? what's about to ship?"). Same data, different question.
+
+### 6.4 Config view
+
+A drag-and-drop canvas where the user models their workflow. The canvas is the *only* heavy frontend surface in Home; everything that touches data still goes through main per R1/R2.
+
+**What you can build.**
+
+- **Input nodes** — entry points for new work. Examples: "Paste a PR URL", "Start from a task prompt", "Pick a branch". When the user triggers an input, it creates or attaches a workstream.
+- **Task nodes** — kick off a new agent task with a chosen skill. Used as starting nodes (user-initiated) or as transition handlers (the next-step agent in a chain).
+- **Step nodes** — workflow stages a workstream sits in (e.g. `In review`, `Needs me`). Each step has a `match` predicate and zero-or-more `AgentBinding`s that surface as quick actions on the List/Board row when a workstream lands there.
+- **Queue nodes** — like steps but visually distinct on the board (e.g. `Stale queue`, `Merge queue`, `Cleanup`). Same predicate model.
+- **Branch nodes** — split the flow by a condition (e.g. `CI status` → `passing` / `failing` / `pending`). Outgoing edges declare which case they handle via `whenCase`.
+- **Terminal nodes** — `merged`, `closed`, `archived`. Workstreams that match a terminal disappear from List/Board.
+
+**Worked example (matches the user's brief):**
+
+```
+[Input: PR URL]                                  ┐
+                                                  ├──► [Step: PR open]──► [Branch: CI status]
+[Task: "Create a PR" (skill: create-pr)] ──────────                              │
+                                                                                 ├─ failing ──► [Step: Needs me] ─► [Agent binding: "Fix CI"]
+[Step: No PR yet] ──► [Branch: PR exists?]                                       │
+                       └─ no ──► [Queue: Stale queue]                            ├─ pending ──► [Step: In review]
+                                                                                 │
+                                                                                 └─ passing ──► [Branch: review_decision]
+                                                                                                  ├─ changes_requested ──► [Step: Needs me] ─► [Agent: "Address comments"]
+                                                                                                  ├─ review_required   ──► [Step: In review]
+                                                                                                  └─ approved          ──► [Queue: Merge queue] ─► [Terminal: merged]
+```
+
+The board renders one column per step/queue node in the order above; the list renders the same nodes as severity-banded sections (severity inferred from each node's attention kinds).
+
+**Canvas UI behaviour.**
+
+- Pan / zoom / fit-to-content; minimap toggle.
+- Sidebar palette of node types — drag onto canvas to add.
+- Click a node → inspector panel on the right: label, match predicate builder, attached `AgentBinding`s (skill picker + prompt template editor with `{{prUrl}}` / `{{branch}}` / `{{failingChecks}}` placeholders).
+- Click an edge → set `whenCase` from the source branch node's case list.
+- Validation surfaces inline: orphan nodes, unreachable terminals, duplicate `whenCase` on a branch's outgoing edges, predicates that overlap a higher-priority node. Validation runs in main (the canvas only renders the diagnostics).
+- **Save model: explicit, not auto.** A dirty banner appears once the user changes anything; "Save" submits the whole workflow; "Discard" reverts to the persisted version. No silent autosave — workflow edits drive every other Home surface, so an accidental save would be loud.
+- Versioned saves with optimistic concurrency: if the persisted `version` has advanced (e.g. another window edited it), the save mutation rejects and the canvas offers reload or force-overwrite.
+
+**Architecture (heavy frontend, but the rules still hold).**
+
+Per R1 / R2 / R3: even though the canvas is the most visually expensive surface in the app, no business logic lives in the renderer.
+
+- **`WorkflowService` (main).** Owns the canonical `WorkflowConfig`, validation, version bumps, the built-in default, and the `match`-predicate evaluator used by `HomeService` for classification. Pure functions; no `electron` imports. Emits `WorkflowChanged` events that `HomeService` subscribes to so a config edit immediately reclassifies every workstream and pushes a new snapshot.
+- **`WorkflowRepository` (main).** SQLite table `home_workflow_config(id, version, json, updated_at)`. Single-row per user for v1. Migration ships the default workflow as version 1.
+- **tRPC `workflow.*` router (main).** One-liners only: `workflow.get` (query, returns `WorkflowConfig`), `workflow.save` (mutation, `{ config, expectedVersion }` → new version or `ConflictError`), `workflow.resetToDefault` (mutation), `workflow.onChanged` (subscription, `WorkflowConfig` diff stream).
+- **`useWorkflow` (renderer hook).** Single `useQuery` against `workflow.get`, kept fresh by the subscription registrar in `features/home/subscriptions.ts` per R9. No multi-query orchestration in the hook.
+- **`workflowEditorStore` (renderer Zustand, R2-clean).** Holds *only* uncommitted edit state: `viewport: { x, y, zoom }`, `selectedNodeId`, `selectedEdgeId`, `draftConfig` (deep-clone of the persisted config the moment editing starts), `dirty`, `validationErrors` (fed from main on each draft change via `workflow.validateDraft`). The persisted `WorkflowConfig` is *not* in this store — it's the `useQuery` result. Save action is one `useMutation` call; the store's job ends there.
+- **`workflowCanvasService` (renderer service, R3 escape hatch).** Drag-and-drop coordinator, snap-to-grid maths, hit-testing, edge-routing — the exact "non-trivial renderer-only UI mechanic shared across components" R3 carves out. No data fetching, no cross-store reach-ins.
+- **Components (`features/home/config/`).** `ConfigCanvas.tsx`, `NodePalette.tsx`, `NodeInspector.tsx`, `EdgeInspector.tsx`, `ValidationBanner.tsx`. Components consume the `useWorkflow` query for the persisted state and the editor store for the draft.
+- **Cross-feature coordination (R5).** `WorkflowService` emits `WorkflowChanged`; `HomeService` reacts by re-classifying and pushing a new `home.onSnapshotUpdated` frame. The renderer's List and Board re-render off the new snapshot. No store ever reaches across to another store.
+- **Library choice.** Use [`@xyflow/react`](https://reactflow.dev/) for the canvas primitive (pan / zoom / nodes / edges / minimap). It's the lightest mainstream option and the canvas state it owns is fine to keep local-to-component — we don't lift its internal state into the store. Wrap it once so the renderer service can layer our snap/validation behaviour.
+
+**Empty / new-user state.** Until the user touches Config, they see the default workflow on the canvas (read-only outline + "Customise" CTA). After customisation, "Reset to default" is always one click away in the header.
+
+**Keyboard:** `Cmd+S` save, `Cmd+Z` / `Cmd+Shift+Z` undo/redo within the draft, `Delete` / `Backspace` remove selected node or edge, `Esc` clears selection, `v` exits to last non-config view.
+
+### 6.5 View persistence
+
+The user's choice persists across sessions via `homeUiStore.viewMode: "list" | "board" | "config"`. Default for new users is `list` (the inbox-zero shape we open with). Toggle is keyboard-accessible (`v` cycles `list → board → config → list`).
+
+## 7. Data sources
+
+| Source | Data | Mechanism |
+|---|---|---|
+| Tasks (PostHog API) | `Task` + `TaskRun` status, branch, `output.pr_url` | existing `useTasks` poll piped into main; live runs via `CloudTaskService` SSE |
+| Workspaces (SQLite) | `linkedBranch`, `branchName`, `lastActivityAt`, `lastViewedAt`, `pinnedAt` | `WorkspaceService` events (`BranchChanged`, `LinkedBranchChanged`) |
+| Git state | branch, ahead/behind, default-branch diff | `GitService` + `FileWatcherService` `GitStateChanged` |
+| GitHub PR metadata | title, state, draft, mergeable, CI, reviewers, threads, comments | new `gh` helpers (see §9) |
+| GitHub review requests | PRs where current user is requested as reviewer | `gh pr list --search "review-requested:@me"` |
+| Snooze / mute / viewed | per-attention-item persistence | new `home_attention_state` SQLite table |
+
+## 8. Architecture
+
+**Main (`apps/code/src/main/services/home/`)**
+
+- `HomeService` — aggregation, classification, ranking, action dispatch. Reads the active workflow from `WorkflowService` and uses it to assign each workstream a `nodeId`.
+- `HomeRepository` — SQLite persistence for snooze/mute and last-viewed timestamps.
+- `schemas.ts` — Zod for snapshot, attention items, and action requests.
+- Dependencies (constructor injected): `WorkspaceService`, `GitService`, `CloudTaskService`, `AgentService`, `PostHogApiClient`, `HomeRepository`, `WorkflowService`, platform `urlOpener`.
+
+**Main (`apps/code/src/main/services/workflow/`)**
+
+- `WorkflowService` — owns the canonical `WorkflowConfig`, validates drafts, evaluates `match` predicates, emits `WorkflowChanged`. Host-agnostic (no `electron` imports).
+- `WorkflowRepository` — SQLite `home_workflow_config(id, version, json, updated_at)`. Single-row per user for v1. Default workflow installed by the migration as version 1.
+- `schemas.ts` — Zod for `WorkflowConfig`, `WorkflowNode`, `WorkflowEdge`, `WorkflowMatch`, `AgentBinding`, validation diagnostics.
+- Dependencies (constructor injected): `WorkflowRepository`, skill registry (read-only).
+
+**tRPC routers — one-liners with Zod input/output:**
+
+`apps/code/src/main/trpc/routers/home.ts`:
+
+- `home.getSnapshot(input)` — query.
+- `home.refresh()` — mutation; forces a fresh PR poll.
+- `home.snooze({ attentionId, untilHours? })` — mutation.
+- `home.mute({ attentionId })` — mutation.
+- `home.markViewed({ workstreamId })` — mutation.
+- `home.startAction({ workstreamId, actionId })` — mutation; returns navigation target or new task id.
+- `home.onSnapshotUpdated` — subscription; diff stream.
+
+`apps/code/src/main/trpc/routers/workflow.ts`:
+
+- `workflow.get()` — query; returns active `WorkflowConfig`.
+- `workflow.save({ config, expectedVersion })` — mutation; rejects with `ConflictError` if version drifted.
+- `workflow.validateDraft({ config })` — query; returns diagnostics without persisting (canvas re-runs on edit).
+- `workflow.resetToDefault()` — mutation.
+- `workflow.onChanged` — subscription.
+
+**Renderer (`apps/code/src/renderer/features/home/`)**
+
+- `components/HomeView.tsx` — top-level layout, header, view toggle.
+- `components/HomeActiveAgentsStrip.tsx` — shared strip across all three views.
+- `components/HomeWorkstreamRow.tsx` — list view row.
+- `components/HomeWorkstreamCard.tsx` — board view card (denser than row).
+- `components/HomeBoardView.tsx` — kanban column layout, columns derived from workflow.
+- `components/HomeDetailPane.tsx`, `HomeEmptyStates.tsx`.
+- `config/ConfigCanvas.tsx`, `config/NodePalette.tsx`, `config/NodeInspector.tsx`, `config/EdgeInspector.tsx`, `config/ValidationBanner.tsx` — Config view.
+- `utils/boardColumns.ts` — pure projection `(workflow, snapshot) → BoardColumn[]`. No I/O, no React, no predicate evaluation (that's main).
+- `hooks/useHomeSnapshot.ts` — single `useQuery` against `home.getSnapshot`, kept in sync via subscription.
+- `hooks/useWorkflow.ts` — single `useQuery` against `workflow.get`, kept in sync via subscription.
+- `stores/homeUiStore.ts` — Zustand, UI only: `viewMode: "list" | "board" | "config"`, `selectedWorkstreamId`, `expanded.{ inProgress, watching }`, `keyboardCursor`.
+- `stores/workflowEditorStore.ts` — Zustand, UI only: `draftConfig`, `dirty`, `selectedNodeId`, `selectedEdgeId`, `viewport`, `validationErrors`. No persisted state, no tRPC orchestration beyond a single mutation call.
+- `services/workflowCanvasService.ts` — `@injectable()` renderer service: drag-and-drop, snap, hit-testing, edge routing. R3 escape hatch. No data, no tRPC, no cross-store reach-ins.
+- `subscriptions.ts` — start `home.onSnapshotUpdated` *and* `workflow.onChanged` at boot per R9.
+
+**Column projection belongs to the renderer; predicate evaluation does not.** The `match` evaluator is a main-side concern (it reads workstream internals like `attentions`, PR metadata, staleness windows). The renderer only joins `snapshot.workstreams[].nodeId` to the workflow's ordered node list to render columns. This keeps `WorkflowMatch` private to main and means the renderer never reasons about "is this PR stale?".
+
+**Rules honoured:** R1 (main owns workflow + classification), R2 (editor store is uncommitted UI state only), R3 (canvas service is the documented escape hatch, no data), R4 (one `useQuery` per surface), R5 (main emits `WorkflowChanged`, both Home and Workflow renderer stores react via subscriptions), R6 (Zod everywhere, inferred types), R7 (SQLite via `WorkflowRepository`), R8 (constructor injection), R9 (subscriptions registered once), R10 (router one-liners).
+
+## 9. New `gh` helpers
+
+Land in `packages/git/src/gh.ts`, expose via `GitService`:
+
+- `listReviewRequestedPrs(owner?)` — `gh pr list --search "review-requested:@me state:open"`.
+- `getPrFull(prUrl)` — `gh pr view <url> --json number,title,state,isDraft,mergeable,mergeStateStatus,statusCheckRollup,reviewDecision,reviewRequests,reviews,reviewThreads,latestReviews,comments,updatedAt,headRefName,baseRefName,url`.
+- `getPrFullBatch(prUrls)` — concurrency cap 3.
+
+## 10. Polling & rate-limit strategy
+
+- Cadence: PR refresh **3 min** focused, **15 min** blurred, **paused** hidden. Add 0–20% jitter.
+- Scope: only PRs touched (either side) in last 30 days, plus pinned, plus review-requested-on-me. Cap at 50 PRs per cycle.
+- On-demand: when a workstream row enters the viewport, fetch its PR within 250ms if cache is >60s old.
+- `gh` errors / rate-limit responses → exponential backoff per host; surface a warning chip in the header.
+- Cloud task SSE already streams in real time — `activeAgents` strip is fed by it, no polling.
+
+## 11. Classification & ranking
+
+**Attention kinds → severity:**
+
+| Kind | Severity |
+|---|---|
+| `pr_ci_failed` | critical |
+| `pr_review_requested` (on me) | attention |
+| `pr_comments` (unresolved, not by me) | attention |
+| `pr_ready_to_merge` | attention |
+| `stale_no_pr` | quiet |
+| `branch_cleanup` (merged/closed but worktree lingering) | quiet |
+
+**Stale thresholds (constants in `home/service.ts`):**
+
+- Completed run with diff on a branch and no PR: 24h → `stale_no_pr`.
+- Branch/worktree with no activity and no PR: 3 days → `stale_no_pr` (escalated severity).
+- Merged/closed PR with worktree still around: 1 day → `branch_cleanup`.
+
+**Row ordering inside "Needs attention":** severity → ownership (mine first) → staleness → `lastActivityAt`.
+
+## 12. Actions (registry-driven)
+
+| Situation | Primary | Secondary |
+|---|---|---|
+| `stale_no_pr` | Create PR | Resume with agent, Open changes, Archive |
+| `pr_ci_failed` | Fix CI with agent | Open checks, Open PR |
+| `pr_comments` | Address comments with agent | Open review thread, Open PR |
+| `pr_review_requested` | **Review with agent** | Open PR, Snooze |
+| `pr_ready_to_merge` | Open PR | Ask agent for final check |
+| `branch_cleanup` | Archive task & worktree | Open PR |
+
+Agent actions prefill the task input with structured context (PR URL, branch, failing-check summary, unresolved-comment list, suggested skill id) and reuse `TaskCreationSaga` + `sendPromptToAgent`.
+
+Action descriptors are data, not hardcoded buttons. The registry maps `actionId → { label, icon, run: (workstream) => Effect }` and lives in `HomeService` so it remains serializable across the IPC boundary.
+
+## 13. The code-review skill (keystone, ships with M3)
+
+The existing `code-review` feature in `apps/code/src/renderer/features/code-review/` only handles *responding* to PR comments inside an active task. We need a new marketplace skill `code-review` that:
+
+- Takes a PR URL as input.
+- Checks out the PR into a fresh worktree.
+- Runs a structured review: scope, risk areas, tests, security, style.
+- Posts a single review with inline comments via `gh pr review`.
+- Lives at `apps/code/skills/code-review/` so it loads through the existing `readSkillMetadataFromDir` discovery.
+
+This is a blocker for M3, not an open question.
+
+## 14. Snooze, mute, viewed
+
+- **Snooze** — hide until `now + N hours`. Default 24h; options 1h/4h/1d/3d.
+- **Mute** — hide until the underlying state changes (new commit on the branch, new comment, CI flip, reviewer change). Cleared automatically by `HomeService` when the watermark moves.
+- **markViewed** — updates `lastUserViewedAt`; powers `pr.newCommentsSinceViewed`.
+
+Persistence: `home_attention_state(attentionId, snoozedUntil, mutedAt, mutedAtSha)`.
+
+## 15. Analytics events
+
+- `home_viewed` (viewMode: list | board)
+- `home_view_mode_changed` (from, to)
+- `home_attention_action_clicked` (kind, actionId, viewMode)
+- `home_attention_snoozed` (kind, durationHours)
+- `home_attention_muted` (kind)
+- `home_action_started_task` (kind, skillId)
+- `home_refresh_requested` (reason: manual | visible | poll)
+- `home_active_agent_clicked` (taskId)
+- `home_config_opened`
+- `home_config_workflow_saved` (nodeCount, edgeCount, agentBindingCount, version)
+- `home_config_workflow_reset_to_default`
+- `home_config_node_added` (nodeKind)
+- `home_config_validation_blocked_save` (errorCount)
+
+Follow naming conventions in `docs/conventions.md`.
+
+## 16. Phasing
+
+### M1 — Skeleton (no new I/O)
+
+- Home route, sidebar entry, view scaffold.
+- `HomeService.getSnapshot` built from existing `useTasks` data + `WorkspaceService` state piped to main.
+- **Active agents strip** wired to existing `CloudTaskService` stream (zero new infra).
+- Kinds that work without new `gh` calls: `stale_no_pr`.
+- **List and board ship together with the built-in default workflow.** No editor yet. The board reads the default `WorkflowConfig` from `WorkflowService.getDefault()` (no SQLite write needed at this stage). Column projection lives in `utils/boardColumns.ts`.
+- Ships visible value immediately and validates the layout.
+
+### M2 — PR enrichment
+
+- New `gh` helpers (`getPrFull`, batch), polling loop, rate-limit handling.
+- New kinds: `pr_ci_failed`, `pr_comments`, `pr_ready_to_merge`, `branch_cleanup`.
+- PR row UI; refresh button; rate-limit warning chip.
+
+### M3 — Reviewer flow + code-review skill
+
+- `listReviewRequestedPrs`, `pr_review_requested` kind.
+- **Ship the `code-review` skill in this same milestone.**
+- "Review with agent" action wired through `TaskCreationSaga`.
+
+### M4 — Inbox-zero controls
+
+- Snooze, mute, `lastUserViewedAt`, keyboard shortcuts (`j`/`k`/`s`/`m`/`Enter`).
+- `home_attention_state` migration.
+
+### M5 — Config canvas (workflow editor)
+
+- `WorkflowService` + `WorkflowRepository` + migration; persist the default workflow on first run.
+- `workflow.*` tRPC router with Zod schemas.
+- Renderer: `ConfigCanvas`, palette, inspectors, validation banner.
+- `workflowEditorStore` + `workflowCanvasService` (R3 escape hatch).
+- `WorkflowChanged` event flow into `HomeService` so List/Board re-render on save.
+- Agent bindings on step/queue nodes drive primary/secondary actions in the action registry (replaces the M2 hardcoded action table).
+- View toggle becomes three-way; `v` keyboard cycle updated.
+
+### M6 — Polish
+
+- Multi-repo chip, GitHub integration toggle.
+- Optional native notifications on critical kinds (opt-in).
+- Settings (stale thresholds, polling cadence).
+- Workflow templates (share-and-import a `WorkflowConfig` JSON).
+
+## 17. Implementation checklist
+
+**M1–M4 (List + Board with built-in default workflow):**
+
+- [ ] Rename existing `HomeItem.tsx` to free the filename.
+- [ ] Add `home` to `ViewType` + `navigateToHome`.
+- [ ] Scaffold `HomeService`, `HomeRepository`, schemas, router, DI token, root router wiring.
+- [ ] Scaffold `WorkflowService.getDefault()` returning the hardcoded default `WorkflowConfig` (no SQLite yet); `HomeService` reads from it for classification.
+- [ ] SQLite migration: `home_attention_state` + ensure `workspaces.lastViewedAt` covers what we need.
+- [ ] Wire `WorkspaceService` / `CloudTaskService` / `FileWatcherService` events into `HomeService` (subscriptions, not polling).
+- [ ] M2: `gh` helpers + `HomeService.refreshPullRequests` polling loop with rate-limit handling.
+- [ ] M3: `code-review` skill in `apps/code/skills/code-review/`.
+- [ ] Renderer: `useHomeSnapshot` (query + subscription), `HomeView`, active-agents strip, row + card components, board view, view toggle in header, detail pane, empty states.
+- [ ] `utils/boardColumns.ts` — column projection from `(workflow, snapshot) → BoardColumn[]` + unit tests covering every attention combination.
+- [ ] `homeUiStore.viewMode` persistence + `v` keyboard shortcut for toggle.
+- [ ] Action registry + `home.startAction` dispatcher (link to `TaskCreationSaga` / `sendPromptToAgent` / urlOpener).
+- [ ] Analytics events (include `home_view_mode_changed`).
+- [ ] Tests: workstream grouping, column projection, staleness classification, severity ranking, snooze/mute decay, action prompt builders.
+- [ ] Component tests for empty / caught-up / heavy states **in both list and board layouts**.
+
+**M5 (Config canvas):**
+
+- [ ] `WorkflowService` (validation, predicate evaluator, default workflow, `WorkflowChanged` event) + `WorkflowRepository` + SQLite migration `home_workflow_config`.
+- [ ] `workflow.*` tRPC router with Zod input/output schemas (`get`, `save`, `validateDraft`, `resetToDefault`, `onChanged`).
+- [ ] `useWorkflow` hook (query + subscription); subscription wired in `features/home/subscriptions.ts`.
+- [ ] `workflowEditorStore` (Zustand, UI-only) + `workflowCanvasService` (R3 escape hatch for drag/snap/hit-test).
+- [ ] Components: `ConfigCanvas`, `NodePalette`, `NodeInspector`, `EdgeInspector`, `ValidationBanner`.
+- [ ] Three-way view toggle + `v` cycle + `Cmd+S` save + undo/redo within draft.
+- [ ] `WorkflowChanged` → `HomeService.reclassify()` → new snapshot frame; both List and Board update without any renderer-side coordination.
+- [ ] Agent bindings drive primary/secondary action registry (replaces the M2 hardcoded mapping in §12).
+- [ ] Tests: workflow Zod round-trip, predicate evaluation (matching `boardColumns` expectations against the default config), validation diagnostics, optimistic-concurrency reject + reload, draft → save → snapshot reclassification end-to-end.
+
+## 18. Open questions
+
+1. Should Home replace Command Center, given overlap on "see all running tasks"? Probably not — Command Center is a grid-of-agents work view, Home is workstream-grouped triage — but confirm.
+2. When a PR has both `pr_ci_failed` and `pr_comments`, do we stack chips on one row (current spec) or split into two attention items? Current: stack, single row, primary action follows top severity.
+3. Which GitHub identity wins when both the GitHub integration and `gh` auth are present? Suggestion: `gh` for queries, GitHub integration for permission checks.
+4. Should "Review with agent" auto-checkout into a new worktree or reuse the user's current one with a stash? Suggestion: new worktree, always.
+5. Cross-device snooze sync? v1: local only.
+6. Native OS notifications on critical kinds? Defer to M5; opt-in.
+7. Should the board support drag-to-move between columns? Current answer: **no for v1**. Columns are derived from underlying state, not user-set status — dragging would either need an override store (extra concept, sync complexity) or have to perform the underlying action (e.g. "drag to Ready to merge" = merge the PR), which is too consequential for a drag gesture. Default: cards are read-only with explicit action buttons.
+8. Should the board surface snoozed and muted items in a "Watching" column, or keep the list view's behaviour (counter pill only, not a column)? Current answer: **counter pill only**. Adding a sixth column dilutes the workflow story — Watching items aren't a workflow stage.
+9. Default view for new users — list or board? Current answer: **list**. Inbox-zero shape is what we open with; the board reveals itself via the toggle.
+10. Should the Config canvas be per-user, per-repo, or per-project? Current answer: **per-user, global**. Cross-repo workflows are the same shape ("PR → review → merge") so a single workflow keeps the model simple. Revisit if teams ask for per-repo overrides.
+11. Are workflow edits live for everyone in the org, or local? Current answer: **local for v1**. Sync via PostHog API is M6+.
+12. Should `terminal: archived` automatically run the existing archive action when a workstream lands there? Current answer: **no for v1**. Terminals just hide the workstream from List/Board; actions stay user-initiated.
+13. Should the canvas render the *live* workstreams (a count chip on each node) so it doubles as a board? Current answer: **yes for v1, read-only chips only**. Helps the user understand what their workflow is doing without making the canvas a third board.
+14. Library: `@xyflow/react` vs roll our own. Current answer: **`@xyflow/react`**. Pan/zoom/edge routing is enough work that "prefer writing our own" doesn't apply; wrap it once so we can swap later.
diff --git a/docs/workflow-architecture.md b/docs/workflow-architecture.md
new file mode 100644
index 0000000000..66b842366b
--- /dev/null
+++ b/docs/workflow-architecture.md
@@ -0,0 +1,230 @@
+# Workflow architecture: POC → productionisation
+
+This doc explains where the Home **workflow** feature lives today, where it
+needs to land for production, and what the seams are so the migration is
+mechanical rather than a rewrite.
+
+If you change anything substantive about how workflow config is persisted
+or how PR / situation data is computed, update this doc.
+
+---
+
+## 1. What "the workflow" is
+
+A user-authored mapping of **situations** a piece of work can be in
+(`working`, `in_review`, `ci_failing`, `changes_requested`, `comments_waiting`,
+`ready_to_merge`, `stale`, `done`) → **actions** (skill + prompt) the user
+wants available when work lands in each situation.
+
+Three concerns sit on top of that data:
+
+1. **Storage** — where the bindings JSON lives.
+2. **PR / signal polling** — fetching CI status, review decision, etc. for
+   each PR so situations can be classified accurately.
+3. **Classification** — pure function `(workstream, pr) → Set<SituationId>`,
+   plus the renderer logic that joins situations to bindings to surface
+   quick-action buttons.
+
+Concern (3) doesn't move — it's a pure TS function in
+`apps/code/src/shared/types/workflow-classify.ts` and stays that way. Concerns
+(1) and (2) move to PostHog when we productionise.
+
+---
+
+## 2. Today (POC, this repo only)
+
+```
+┌────────────────────────────────────────────────────────────────────────┐
+│  Electron renderer (apps/code/src/renderer/features/home)              │
+│                                                                        │
+│  • ConfigList edits the workflow via tRPC                              │
+│  • useHomeSnapshot groups TaskData → HomeWorkstream                    │
+│  • classify() in @shared/ computes situations per workstream           │
+│  • useBoundActions joins situations → workflow.bindings → action list  │
+│  • HomeWorkstreamRow/Card render situation chips + bound buttons       │
+└──────────────────────────────┬─────────────────────────────────────────┘
+                               │ tRPC (workflow.* router)
+                               ▼
+┌────────────────────────────────────────────────────────────────────────┐
+│  Electron main                                                         │
+│                                                                        │
+│  WorkflowService  ──→  WorkflowBackend (interface)                     │
+│                              │                                         │
+│                              ▼                                         │
+│                       LocalWorkflowBackend ───→ SQLite                 │
+│                       (HomeWorkflowRepository)                         │
+│                                                                        │
+│  PR polling: NOT BUILT YET. classify() runs with pr=null in real data; │
+│  fixtures provide rich pr objects for demo mode.                       │
+└────────────────────────────────────────────────────────────────────────┘
+```
+
+**Where the actual files are:**
+
+| Concern | File | Lifetime |
+|---|---|---|
+| Schema (Zod + types) | `apps/code/src/shared/types/workflow.ts` | Permanent. Server will share the shape. |
+| Classifier (pure) | `apps/code/src/shared/types/workflow-classify.ts` | Permanent. Server may port to Python; same logic. |
+| Validation (pure) | `apps/code/src/shared/types/workflow-validate.ts` | Permanent. Runs both client-side (instant feedback) and inside `WorkflowService.save` (defense in depth). Server re-validates on save with the same rules — port to Python during migration. |
+| WorkflowService | `apps/code/src/main/services/workflow/service.ts` | Permanent in shape. Body stays the same after swap. |
+| `WorkflowBackend` interface | `apps/code/src/main/services/workflow/backend.ts` | Permanent. The swap point. |
+| `LocalWorkflowBackend` | same file | **POC-only.** Deleted post-migration. |
+| `CloudWorkflowBackend` | same file | Stub today, the implementation post-migration. |
+| SQLite repo | `apps/code/src/main/db/repositories/home-workflow-repository.ts` | **POC-only.** Deleted with the migration. |
+| Migration `0007_*` (`home_workflow_config` table) | `apps/code/src/main/db/migrations/` | **POC-only.** Drop the table via a follow-up migration once cloud is the source of truth. |
+| tRPC router | `apps/code/src/main/trpc/routers/workflow.ts` | Permanent shape. Same procedures, same Zod schemas — the backend just changes underneath. |
+
+---
+
+## 3. Target (production)
+
+```
+┌───────────────────────────────┐         ┌────────────────────────────────────┐
+│ Electron renderer (unchanged) │         │  posthog/ backend                  │
+│                               │         │                                    │
+│  ConfigList, useHomeSnapshot, │         │  • CodeWorkflow Django model       │
+│  classify(), useBoundActions  │         │  • REST endpoints (see §4)         │
+│  …all identical               │         │  • Celery beat task: per-user GH   │
+└───────────────┬───────────────┘         │    PR poll, writes CodePrSnapshot  │
+                │ tRPC (unchanged)        │  • SSE/WebSocket: pushes           │
+                ▼                         │    WorkflowChanged +               │
+┌───────────────────────────────┐         │    PrSnapshotUpdated to clients    │
+│ Electron main                 │         └──────────────────┬─────────────────┘
+│                               │                            │
+│  WorkflowService              │                            │
+│    │                          │                            │
+│    ▼                          │   HTTPS (auth'd)           │
+│  CloudWorkflowBackend ────────┼────────────────────────────┘
+│  (calls posthog API)          │
+│                               │
+│  No more SQLite for workflow. │
+│  No more local PR polling.    │
+└───────────────────────────────┘
+```
+
+**What moves to `posthog/`:**
+
+1. **Workflow persistence.** Per-user, syncs across devices, optimistic
+   concurrency on a monotonic `version` (same as today's local SQLite logic).
+2. **PR polling worker.** One server-side worker walks every user's
+   tracked PRs, batches by host, respects per-user `gh`/PAT rate-limit
+   budgets, and writes snapshots into a `CodePrSnapshot` table that
+   downstream services read.
+3. **Snapshot delivery.** Server pushes `WorkflowChanged` and
+   `PrSnapshotUpdated` over an existing realtime channel (SSE or
+   WebSocket). The renderer subscribes via tRPC — the same shape as
+   today's `workflow.onChanged`, just sourced from upstream.
+
+**What stays in `apps/code/`:**
+
+1. The UI — ConfigList, list/board views, action firing.
+2. `WorkflowService`, `WorkflowBackend` interface, classifier — same
+   files, same shapes.
+3. `TaskCreationSaga` invocation when a user clicks a bound action.
+   Already cloud, no change.
+4. Local task grouping in `useHomeSnapshot` — eventually moves
+   server-side too, but it's not on the critical migration path.
+
+---
+
+## 4. Server-side API sketch
+
+Subject to backend design review; this is what the Electron side expects.
+
+```
+GET    /api/projects/:project_id/code_workflow/
+       → 200 WorkflowConfig
+       → 404 (no config yet — client seeds default)
+
+PUT    /api/projects/:project_id/code_workflow/
+       body: { config: WorkflowConfig, expected_version: number }
+       → 200 { status: "saved", config }
+       → 409 { status: "conflict", config }       (version drifted)
+       → 422 { status: "invalid", diagnostics }   (schema violation)
+
+DELETE /api/projects/:project_id/code_workflow/
+       → 200 WorkflowConfig (the reseeded default)
+```
+
+The `WorkflowConfig` Zod schema in `@shared/types/workflow.ts` is the
+contract — the backend serialises it as-is. If we add fields, we add
+them once in the shared schema and both ends pick them up.
+
+For real-time updates, ride whichever channel `posthog/` already uses
+for live data (today: long-poll + the new task SSE channel). The tRPC
+subscription `workflow.onChanged` in this repo becomes a passthrough.
+
+---
+
+## 5. The PR polling worker (when we build it)
+
+**POC option** (not built yet, but if needed pre-cloud): A
+`PrSnapshotService` in Electron main, running locally, fetching via the
+`gh` CLI. Owned by the same DI container, exposed via a tRPC
+subscription `pr.onSnapshotUpdated`. The classifier in
+`workflow-classify.ts` already takes an optional `pr` argument so
+plugging in the data is a one-call change in `useHomeSnapshot`.
+
+**Production**: A Celery beat task in `posthog/` paging through
+`CodeWorkflow` rows, batching the PRs each user is tracking, hitting
+the GitHub API with the user's stored PAT, writing snapshots into
+`CodePrSnapshot`, and emitting a realtime event when a snapshot
+changes. Clients subscribe; the Electron tRPC subscription becomes a
+passthrough.
+
+In both cases the shape we hand to `classify()` is identical:
+`{ state, ciStatus, reviewDecision, unresolvedThreads, mergeable, … }`.
+
+---
+
+## 6. The actual swap (when PostHog is ready)
+
+For this Electron app:
+
+1. **Implement `CloudWorkflowBackend.load/save/delete`** in
+   `apps/code/src/main/services/workflow/backend.ts` — replacing the
+   `throw new Error("not implemented yet")` stubs. Use the existing
+   auth'd HTTP client. Validate the response with
+   `workflowConfig.safeParse` before returning; on shape mismatch,
+   return `null` so the service reseeds.
+2. **Flip the DI binding** in `apps/code/src/main/di/container.ts`
+   from `LocalWorkflowBackend` to `CloudWorkflowBackend`. One line.
+3. **Add a follow-up Drizzle migration** that drops the
+   `home_workflow_config` table.
+4. **Delete the POC-only files:** `home-workflow-repository.ts`, the
+   `homeWorkflowConfig` table in `schema.ts`, the `0007_*` migration
+   stays in place (historical) but the drop migration succeeds it.
+5. **Rewrite `workflow.onChanged`** in
+   `apps/code/src/main/trpc/routers/workflow.ts` to fan out the
+   server's realtime event instead of `WorkflowService.emit`. Same
+   tRPC contract — renderer doesn't change.
+
+For the PR polling worker, replace the (not-yet-built) local
+`PrSnapshotService` with a passthrough subscription to the server's
+event.
+
+For the classifier: nothing changes.
+
+---
+
+## 7. Things we deliberately did NOT do in the POC
+
+- **No user identity.** Bindings are anonymous, one row per app
+  install. Cloud version is per-user.
+- **No real PR polling.** Real data has `pr: null` everywhere — only
+  the demo fixtures populate PR metadata. Situations involving
+  `ci_failing` / `changes_requested` etc. won't fire in real use yet.
+- **No `auto`-trigger actions.** We dropped the auto trigger
+  intentionally — we can't reliably watch for state transitions across
+  cloud and local task setups. Once the server-side polling worker
+  exists it could fire auto actions, but that's a deliberate future
+  decision.
+- **No cross-device sync.** Implicit, but worth naming: today, if you
+  edit the workflow on one machine and open the app on another, the
+  second machine has its own row.
+- **No action firing.** `useBoundActions` toasts "not wired yet" when a
+  user clicks a button. The seam to `TaskCreationSaga` is the next
+  slice — independent of the cloud migration.
+
+Each of these is a follow-up slice with its own clear seam — none of
+them require redesigning what the POC already built.
diff --git a/packages/agent/tsup.config.bundled_xsmisnp8nz.mjs b/packages/agent/tsup.config.bundled_xsmisnp8nz.mjs
new file mode 100644
index 0000000000..6082b862ff
--- /dev/null
+++ b/packages/agent/tsup.config.bundled_xsmisnp8nz.mjs
@@ -0,0 +1,152 @@
+// tsup.config.ts
+import {
+  chmodSync,
+  copyFileSync,
+  cpSync,
+  existsSync,
+  mkdirSync,
+  writeFileSync,
+} from "node:fs";
+import { builtinModules } from "node:module";
+// build/native-binary.mjs
+import { join, resolve } from "node:path";
+import { defineConfig } from "tsup";
+
+function targetPlatform() {
+  return process.env.npm_config_platform ?? process.platform;
+}
+function targetArch() {
+  return process.env.npm_config_arch ?? process.arch;
+}
+function claudeBinName(platform = targetPlatform()) {
+  return platform === "win32" ? "claude.exe" : "claude";
+}
+function isMuslLibc() {
+  if (process.platform !== "linux") return false;
+  const report = process.report?.getReport();
+  const header = report?.header;
+  return !header?.glibcVersionRuntime;
+}
+function nativeBinaryCandidates(rootNodeModules) {
+  const platform = targetPlatform();
+  const arch = targetArch();
+  const binary = claudeBinName(platform);
+  const slugs =
+    platform === "linux"
+      ? isMuslLibc()
+        ? [`linux-${arch}-musl`, `linux-${arch}`]
+        : [`linux-${arch}`, `linux-${arch}-musl`]
+      : [`${platform}-${arch}`];
+  return slugs.map((slug) =>
+    join(rootNodeModules, `@anthropic-ai/claude-agent-sdk-${slug}`, binary),
+  );
+}
+
+// tsup.config.ts
+function nativeBinarySourcePath() {
+  const candidates = nativeBinaryCandidates(
+    resolve(import.meta.dirname, "../../node_modules"),
+  );
+  return candidates.find((p) => existsSync(p));
+}
+function copyAssets() {
+  const distDir = resolve(import.meta.dirname, "dist");
+  const templatesDir = resolve(distDir, "templates");
+  const claudeCliDir = resolve(distDir, "claude-cli");
+  mkdirSync(templatesDir, { recursive: true });
+  mkdirSync(claudeCliDir, { recursive: true });
+  const srcTemplatesDir = resolve(import.meta.dirname, "src/templates");
+  if (existsSync(srcTemplatesDir)) {
+    cpSync(srcTemplatesDir, templatesDir, { recursive: true });
+  }
+  const binName = claudeBinName();
+  const nativeBinary = nativeBinarySourcePath();
+  if (nativeBinary) {
+    const dest = resolve(claudeCliDir, binName);
+    copyFileSync(nativeBinary, dest);
+    if (targetPlatform() !== "win32") {
+      chmodSync(dest, 493);
+    }
+  } else {
+    console.warn(
+      `[agent/tsup] No native claude binary found for ${targetPlatform()}-${targetArch()}; install @anthropic-ai/claude-agent-sdk optional deps`,
+    );
+  }
+  writeFileSync(
+    resolve(claudeCliDir, "package.json"),
+    JSON.stringify({ type: "module" }, null, 2),
+  );
+}
+var sharedOptions = {
+  sourcemap: true,
+  splitting: false,
+  outDir: "dist",
+  target: "node20",
+  noExternal: ["@posthog/shared", "@posthog/git", "@posthog/enricher"],
+  external: [
+    ...builtinModules,
+    ...builtinModules.map((m) => `node:${m}`),
+    "@agentclientprotocol/sdk",
+    "@anthropic-ai/claude-agent-sdk",
+    "dotenv",
+    "openai",
+    "tar",
+    "zod",
+  ],
+};
+var tsup_config_default = defineConfig([
+  {
+    entry: [
+      "src/index.ts",
+      "src/agent.ts",
+      "src/gateway-models.ts",
+      "src/handoff-checkpoint.ts",
+      "src/posthog-api.ts",
+      "src/pr-url-detector.ts",
+      "src/resume.ts",
+      "src/types.ts",
+      "src/adapters/claude/questions/utils.ts",
+      "src/adapters/claude/permissions/permission-options.ts",
+      "src/adapters/claude/tools.ts",
+      "src/adapters/claude/conversion/tool-use-to-acp.ts",
+      "src/adapters/claude/session/jsonl-hydration.ts",
+      "src/adapters/claude/session/models.ts",
+      "src/adapters/codex/models.ts",
+      "src/adapters/claude/mcp/tool-metadata.ts",
+      "src/adapters/codex/structured-output-mcp-server.ts",
+      "src/adapters/codex/local-tools-mcp-server.ts",
+      "src/adapters/reasoning-effort.ts",
+      "src/execution-mode.ts",
+      "src/server/schemas.ts",
+      "src/server/agent-server.ts",
+    ],
+    format: ["esm"],
+    dts: true,
+    clean: false,
+    ...sharedOptions,
+    onSuccess: async () => {
+      copyAssets();
+      console.log("Assets copied successfully");
+      const triggerFile = resolve(
+        import.meta.dirname,
+        "../../apps/code/src/main/.agent-trigger",
+      );
+      const triggerDir = resolve(
+        import.meta.dirname,
+        "../../apps/code/src/main",
+      );
+      if (existsSync(triggerDir)) {
+        writeFileSync(triggerFile, `${Date.now()}`);
+      }
+    },
+  },
+  {
+    entry: { "server/bin": "src/server/bin.ts" },
+    format: ["cjs"],
+    dts: false,
+    clean: false,
+    ...sharedOptions,
+  },
+]);
+export { tsup_config_default as default };
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsidHN1cC5jb25maWcudHMiLCAiYnVpbGQvbmF0aXZlLWJpbmFyeS5tanMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbImNvbnN0IF9faW5qZWN0ZWRfZmlsZW5hbWVfXyA9IFwiL1VzZXJzL3BldGVya2lya2hhbS9kZXYvY29kZS9wYWNrYWdlcy9hZ2VudC90c3VwLmNvbmZpZy50c1wiO2NvbnN0IF9faW5qZWN0ZWRfZGlybmFtZV9fID0gXCIvVXNlcnMvcGV0ZXJraXJraGFtL2Rldi9jb2RlL3BhY2thZ2VzL2FnZW50XCI7Y29uc3QgX19pbmplY3RlZF9pbXBvcnRfbWV0YV91cmxfXyA9IFwiZmlsZTovLy9Vc2Vycy9wZXRlcmtpcmtoYW0vZGV2L2NvZGUvcGFja2FnZXMvYWdlbnQvdHN1cC5jb25maWcudHNcIjtpbXBvcnQge1xuICBjaG1vZFN5bmMsXG4gIGNvcHlGaWxlU3luYyxcbiAgY3BTeW5jLFxuICBleGlzdHNTeW5jLFxuICBta2RpclN5bmMsXG4gIHdyaXRlRmlsZVN5bmMsXG59IGZyb20gXCJub2RlOmZzXCI7XG5pbXBvcnQgeyBidWlsdGluTW9kdWxlcyB9IGZyb20gXCJub2RlOm1vZHVsZVwiO1xuaW1wb3J0IHsgcmVzb2x2ZSB9IGZyb20gXCJub2RlOnBhdGhcIjtcbmltcG9ydCB7IGRlZmluZUNvbmZpZyB9IGZyb20gXCJ0c3VwXCI7XG4vLyBQbGFpbiBFU00gaGVscGVyLCBzaGFyZWQgd2l0aCBhcHBzL2NvZGUvdml0ZS5tYWluLmNvbmZpZy5tdHMuXG5pbXBvcnQge1xuICBjbGF1ZGVCaW5OYW1lLFxuICBuYXRpdmVCaW5hcnlDYW5kaWRhdGVzLFxuICB0YXJnZXRBcmNoLFxuICB0YXJnZXRQbGF0Zm9ybSxcbn0gZnJvbSBcIi4vYnVpbGQvbmF0aXZlLWJpbmFyeS5tanNcIjtcblxuZnVuY3Rpb24gbmF0aXZlQmluYXJ5U291cmNlUGF0aCgpOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICBjb25zdCBjYW5kaWRhdGVzID0gbmF0aXZlQmluYXJ5Q2FuZGlkYXRlcyhcbiAgICByZXNvbHZlKGltcG9ydC5tZXRhLmRpcm5hbWUsIFwiLi4vLi4vbm9kZV9tb2R1bGVzXCIpLFxuICApO1xuICByZXR1cm4gY2FuZGlkYXRlcy5maW5kKChwOiBzdHJpbmcpID0+IGV4aXN0c1N5bmMocCkpO1xufVxuXG5mdW5jdGlvbiBjb3B5QXNzZXRzKCkge1xuICBjb25zdCBkaXN0RGlyID0gcmVzb2x2ZShpbXBvcnQubWV0YS5kaXJuYW1lLCBcImRpc3RcIik7XG4gIGNvbnN0IHRlbXBsYXRlc0RpciA9IHJlc29sdmUoZGlzdERpciwgXCJ0ZW1wbGF0ZXNcIik7XG4gIGNvbnN0IGNsYXVkZUNsaURpciA9IHJlc29sdmUoZGlzdERpciwgXCJjbGF1ZGUtY2xpXCIpO1xuXG4gIG1rZGlyU3luYyh0ZW1wbGF0ZXNEaXIsIHsgcmVjdXJzaXZlOiB0cnVlIH0pO1xuICBta2RpclN5bmMoY2xhdWRlQ2xpRGlyLCB7IHJlY3Vyc2l2ZTogdHJ1ZSB9KTtcblxuICBjb25zdCBzcmNUZW1wbGF0ZXNEaXIgPSByZXNvbHZlKGltcG9ydC5tZXRhLmRpcm5hbWUsIFwic3JjL3RlbXBsYXRlc1wiKTtcbiAgaWYgKGV4aXN0c1N5bmMoc3JjVGVtcGxhdGVzRGlyKSkge1xuICAgIGNwU3luYyhzcmNUZW1wbGF0ZXNEaXIsIHRlbXBsYXRlc0RpciwgeyByZWN1cnNpdmU6IHRydWUgfSk7XG4gIH1cblxuICBjb25zdCBiaW5OYW1lID0gY2xhdWRlQmluTmFtZSgpO1xuICBjb25zdCBuYXRpdmVCaW5hcnkgPSBuYXRpdmVCaW5hcnlTb3VyY2VQYXRoKCk7XG4gIGlmIChuYXRpdmVCaW5hcnkpIHtcbiAgICBjb25zdCBkZXN0ID0gcmVzb2x2ZShjbGF1ZGVDbGlEaXIsIGJpbk5hbWUpO1xuICAgIGNvcHlGaWxlU3luYyhuYXRpdmVCaW5hcnksIGRlc3QpO1xuICAgIGlmICh0YXJnZXRQbGF0Zm9ybSgpICE9PSBcIndpbjMyXCIpIHtcbiAgICAgIGNobW9kU3luYyhkZXN0LCAwbzc1NSk7XG4gICAgfVxuICB9IGVsc2Uge1xuICAgIGNvbnNvbGUud2FybihcbiAgICAgIGBbYWdlbnQvdHN1cF0gTm8gbmF0aXZlIGNsYXVkZSBiaW5hcnkgZm91bmQgZm9yICR7dGFyZ2V0UGxhdGZvcm0oKX0tJHt0YXJnZXRBcmNoKCl9OyBpbnN0YWxsIEBhbnRocm9waWMtYWkvY2xhdWRlLWFnZW50LXNkayBvcHRpb25hbCBkZXBzYCxcbiAgICApO1xuICB9XG5cbiAgd3JpdGVGaWxlU3luYyhcbiAgICByZXNvbHZlKGNsYXVkZUNsaURpciwgXCJwYWNrYWdlLmpzb25cIiksXG4gICAgSlNPTi5zdHJpbmdpZnkoeyB0eXBlOiBcIm1vZHVsZVwiIH0sIG51bGwsIDIpLFxuICApO1xufVxuXG5jb25zdCBzaGFyZWRPcHRpb25zID0ge1xuICBzb3VyY2VtYXA6IHRydWUsXG4gIHNwbGl0dGluZzogZmFsc2UsXG4gIG91dERpcjogXCJkaXN0XCIsXG4gIHRhcmdldDogXCJub2RlMjBcIixcbiAgbm9FeHRlcm5hbDogW1wiQHBvc3Rob2cvc2hhcmVkXCIsIFwiQHBvc3Rob2cvZ2l0XCIsIFwiQHBvc3Rob2cvZW5yaWNoZXJcIl0sXG4gIGV4dGVybmFsOiBbXG4gICAgLi4uYnVpbHRpbk1vZHVsZXMsXG4gICAgLi4uYnVpbHRpbk1vZHVsZXMubWFwKChtKSA9PiBgbm9kZToke219YCksXG4gICAgXCJAYWdlbnRjbGllbnRwcm90b2NvbC9zZGtcIixcbiAgICBcIkBhbnRocm9waWMtYWkvY2xhdWRlLWFnZW50LXNka1wiLFxuICAgIFwiZG90ZW52XCIsXG4gICAgXCJvcGVuYWlcIixcbiAgICBcInRhclwiLFxuICAgIFwiem9kXCIsXG4gIF0sXG59O1xuXG5leHBvcnQgZGVmYXVsdCBkZWZpbmVDb25maWcoW1xuICB7XG4gICAgZW50cnk6IFtcbiAgICAgIFwic3JjL2luZGV4LnRzXCIsXG4gICAgICBcInNyYy9hZ2VudC50c1wiLFxuICAgICAgXCJzcmMvZ2F0ZXdheS1tb2RlbHMudHNcIixcbiAgICAgIFwic3JjL2hhbmRvZmYtY2hlY2twb2ludC50c1wiLFxuICAgICAgXCJzcmMvcG9zdGhvZy1hcGkudHNcIixcbiAgICAgIFwic3JjL3ByLXVybC1kZXRlY3Rvci50c1wiLFxuICAgICAgXCJzcmMvcmVzdW1lLnRzXCIsXG4gICAgICBcInNyYy90eXBlcy50c1wiLFxuICAgICAgXCJzcmMvYWRhcHRlcnMvY2xhdWRlL3F1ZXN0aW9ucy91dGlscy50c1wiLFxuICAgICAgXCJzcmMvYWRhcHRlcnMvY2xhdWRlL3Blcm1pc3Npb25zL3Blcm1pc3Npb24tb3B0aW9ucy50c1wiLFxuICAgICAgXCJzcmMvYWRhcHRlcnMvY2xhdWRlL3Rvb2xzLnRzXCIsXG4gICAgICBcInNyYy9hZGFwdGVycy9jbGF1ZGUvY29udmVyc2lvbi90b29sLXVzZS10by1hY3AudHNcIixcbiAgICAgIFwic3JjL2FkYXB0ZXJzL2NsYXVkZS9zZXNzaW9uL2pzb25sLWh5ZHJhdGlvbi50c1wiLFxuICAgICAgXCJzcmMvYWRhcHRlcnMvY2xhdWRlL3Nlc3Npb24vbW9kZWxzLnRzXCIsXG4gICAgICBcInNyYy9hZGFwdGVycy9jb2RleC9tb2RlbHMudHNcIixcbiAgICAgIFwic3JjL2FkYXB0ZXJzL2NsYXVkZS9tY3AvdG9vbC1tZXRhZGF0YS50c1wiLFxuICAgICAgXCJzcmMvYWRhcHRlcnMvY29kZXgvc3RydWN0dXJlZC1vdXRwdXQtbWNwLXNlcnZlci50c1wiLFxuICAgICAgXCJzcmMvYWRhcHRlcnMvY29kZXgvbG9jYWwtdG9vbHMtbWNwLXNlcnZlci50c1wiLFxuICAgICAgXCJzcmMvYWRhcHRlcnMvcmVhc29uaW5nLWVmZm9ydC50c1wiLFxuICAgICAgXCJzcmMvZXhlY3V0aW9uLW1vZGUudHNcIixcbiAgICAgIFwic3JjL3NlcnZlci9zY2hlbWFzLnRzXCIsXG4gICAgICBcInNyYy9zZXJ2ZXIvYWdlbnQtc2VydmVyLnRzXCIsXG4gICAgXSxcbiAgICBmb3JtYXQ6IFtcImVzbVwiXSxcbiAgICBkdHM6IHRydWUsXG4gICAgY2xlYW46IGZhbHNlLFxuICAgIC4uLnNoYXJlZE9wdGlvbnMsXG4gICAgb25TdWNjZXNzOiBhc3luYyAoKSA9PiB7XG4gICAgICBjb3B5QXNzZXRzKCk7XG4gICAgICBjb25zb2xlLmxvZyhcIkFzc2V0cyBjb3BpZWQgc3VjY2Vzc2Z1bGx5XCIpO1xuXG4gICAgICAvLyBUb3VjaCBhIHRyaWdnZXIgZmlsZSB0byBzaWduYWwgZWxlY3Ryb24tZm9yZ2UgdG8gcmVzdGFydFxuICAgICAgLy8gVGhpcyBmaWxlIGlzIHdhdGNoZWQgYnkgVml0ZSwgdHJpZ2dlcmluZyBtYWluIHByb2Nlc3MgcmVidWlsZFxuICAgICAgLy8gU2tpcCBpbiBEb2NrZXIvQ0kgZW52aXJvbm1lbnRzIHdoZXJlIHRoZSBjb2RlIGFwcCBkb2Vzbid0IGV4aXN0XG4gICAgICBjb25zdCB0cmlnZ2VyRmlsZSA9IHJlc29sdmUoXG4gICAgICAgIGltcG9ydC5tZXRhLmRpcm5hbWUsXG4gICAgICAgIFwiLi4vLi4vYXBwcy9jb2RlL3NyYy9tYWluLy5hZ2VudC10cmlnZ2VyXCIsXG4gICAgICApO1xuICAgICAgY29uc3QgdHJpZ2dlckRpciA9IHJlc29sdmUoXG4gICAgICAgIGltcG9ydC5tZXRhLmRpcm5hbWUsXG4gICAgICAgIFwiLi4vLi4vYXBwcy9jb2RlL3NyYy9tYWluXCIsXG4gICAgICApO1xuICAgICAgaWYgKGV4aXN0c1N5bmModHJpZ2dlckRpcikpIHtcbiAgICAgICAgd3JpdGVGaWxlU3luYyh0cmlnZ2VyRmlsZSwgYCR7RGF0ZS5ub3coKX1gKTtcbiAgICAgIH1cbiAgICB9LFxuICB9LFxuICB7XG4gICAgZW50cnk6IHsgXCJzZXJ2ZXIvYmluXCI6IFwic3JjL3NlcnZlci9iaW4udHNcIiB9LFxuICAgIGZvcm1hdDogW1wiY2pzXCJdLFxuICAgIGR0czogZmFsc2UsXG4gICAgY2xlYW46IGZhbHNlLFxuICAgIC4uLnNoYXJlZE9wdGlvbnMsXG4gIH0sXG5dKTtcbiIsICJjb25zdCBfX2luamVjdGVkX2ZpbGVuYW1lX18gPSBcIi9Vc2Vycy9wZXRlcmtpcmtoYW0vZGV2L2NvZGUvcGFja2FnZXMvYWdlbnQvYnVpbGQvbmF0aXZlLWJpbmFyeS5tanNcIjtjb25zdCBfX2luamVjdGVkX2Rpcm5hbWVfXyA9IFwiL1VzZXJzL3BldGVya2lya2hhbS9kZXYvY29kZS9wYWNrYWdlcy9hZ2VudC9idWlsZFwiO2NvbnN0IF9faW5qZWN0ZWRfaW1wb3J0X21ldGFfdXJsX18gPSBcImZpbGU6Ly8vVXNlcnMvcGV0ZXJraXJraGFtL2Rldi9jb2RlL3BhY2thZ2VzL2FnZW50L2J1aWxkL25hdGl2ZS1iaW5hcnkubWpzXCI7aW1wb3J0IHsgam9pbiB9IGZyb20gXCJub2RlOnBhdGhcIjtcblxuLyoqXG4gKiBTaGFyZWQgYnVpbGQtdGltZSBoZWxwZXJzIGZvciByZXNvbHZpbmcgdGhlIENsYXVkZSBuYXRpdmUgYmluYXJ5IHRoYXQgc2hpcHNcbiAqIHZpYSBgQGFudGhyb3BpYy1haS9jbGF1ZGUtYWdlbnQtc2RrLSR7cGxhdGZvcm19LSR7YXJjaH1gIG9wdGlvbmFsIGRlcHMuXG4gKlxuICogVXNlZCBieSBib3RoIGBwYWNrYWdlcy9hZ2VudC90c3VwLmNvbmZpZy50c2AgKGJ1bmRsZXMgdGhlIGJpbmFyeSBpbnRvIHRoZVxuICogYWdlbnQgcGFja2FnZSdzIGBkaXN0L2NsYXVkZS1jbGkvYCkgYW5kIGBhcHBzL2NvZGUvdml0ZS5tYWluLmNvbmZpZy5tdHNgXG4gKiAoY29waWVzIGl0IGludG8gdGhlIEVsZWN0cm9uIGFwcCdzIGAudml0ZS9idWlsZC9jbGF1ZGUtY2xpL2ApLlxuICpcbiAqIFRoZSBydW50aW1lIGVxdWl2YWxlbnQgb2YgdGhpcyBsaXZlcyB1cHN0cmVhbSBpbiBgYWNwLWFnZW50LnRzYCBhc1xuICogYGNsYXVkZUNsaVBhdGgoKWAgKyBgaXNNdXNsTGliYygpYC4gS2VlcCBiZWhhdmlvciBpbiBzeW5jIGlmIHRoZSB1cHN0cmVhbVxuICogcmVzb2x1dGlvbiBsb2dpYyBjaGFuZ2VzLlxuICovXG5cbi8qKiBDcm9zcy1jb21waWxlIGF3YXJlIHBsYXRmb3JtIFx1MjAxNCBlbGVjdHJvbi1mb3JnZSBzZXRzIG5wbV9jb25maWdfcGxhdGZvcm0gd2hlbiBwYWNrYWdpbmcgZm9yIGEgdGFyZ2V0LiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRhcmdldFBsYXRmb3JtKCkge1xuICByZXR1cm4gcHJvY2Vzcy5lbnYubnBtX2NvbmZpZ19wbGF0Zm9ybSA/PyBwcm9jZXNzLnBsYXRmb3JtO1xufVxuXG4vKiogQ3Jvc3MtY29tcGlsZSBhd2FyZSBhcmNoIFx1MjAxNCBzYW1lIHN0b3J5IGFzIHRhcmdldFBsYXRmb3JtLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRhcmdldEFyY2goKSB7XG4gIHJldHVybiBwcm9jZXNzLmVudi5ucG1fY29uZmlnX2FyY2ggPz8gcHJvY2Vzcy5hcmNoO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gY2xhdWRlQmluTmFtZShwbGF0Zm9ybSA9IHRhcmdldFBsYXRmb3JtKCkpIHtcbiAgcmV0dXJuIHBsYXRmb3JtID09PSBcIndpbjMyXCIgPyBcImNsYXVkZS5leGVcIiA6IFwiY2xhdWRlXCI7XG59XG5cbi8qKlxuICogRGV0ZWN0IHdoZXRoZXIgdGhlICpjdXJyZW50KiBOb2RlIHdhcyBidWlsdCBhZ2FpbnN0IG11c2wgbGliYyAobm90IGdsaWJjKS5cbiAqIE9ubHkgbWVhbmluZ2Z1bCB3aGVuIHRhcmdldFBsYXRmb3JtKCkgPT09IFwibGludXhcIiBhbmQgd2UncmUgcnVubmluZyBvblxuICogbGludXggXHUyMDE0IGNyb3NzLWhvc3QgcGFja2FnaW5nIGRlZmF1bHRzIHRvIGdsaWJjIG9yZGVyaW5nIHNpbmNlIHdlIGhhdmUgbm9cbiAqIHdheSB0byBrbm93IHRoZSB0YXJnZXQncyBsaWJjLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNNdXNsTGliYygpIHtcbiAgaWYgKHByb2Nlc3MucGxhdGZvcm0gIT09IFwibGludXhcIikgcmV0dXJuIGZhbHNlO1xuICBjb25zdCByZXBvcnQgPSBwcm9jZXNzLnJlcG9ydD8uZ2V0UmVwb3J0KCk7XG4gIGNvbnN0IGhlYWRlciA9IHJlcG9ydD8uaGVhZGVyO1xuICByZXR1cm4gIWhlYWRlcj8uZ2xpYmNWZXJzaW9uUnVudGltZTtcbn1cblxuLyoqXG4gKiBPcmRlcmVkIGxpc3Qgb2YgY2FuZGlkYXRlIHBhdGhzIHRvIGEgQ2xhdWRlIG5hdGl2ZSBiaW5hcnkgaW5zaWRlIGEgZ2l2ZW5cbiAqIG5vZGVfbW9kdWxlcyByb290LiBGaXJzdCBlbnRyeSB0aGF0IGV4aXN0cyBzaG91bGQgYmUgcHJlZmVycmVkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gbmF0aXZlQmluYXJ5Q2FuZGlkYXRlcyhyb290Tm9kZU1vZHVsZXMpIHtcbiAgY29uc3QgcGxhdGZvcm0gPSB0YXJnZXRQbGF0Zm9ybSgpO1xuICBjb25zdCBhcmNoID0gdGFyZ2V0QXJjaCgpO1xuICBjb25zdCBiaW5hcnkgPSBjbGF1ZGVCaW5OYW1lKHBsYXRmb3JtKTtcbiAgY29uc3Qgc2x1Z3MgPVxuICAgIHBsYXRmb3JtID09PSBcImxpbnV4XCJcbiAgICAgID8gaXNNdXNsTGliYygpXG4gICAgICAgID8gW2BsaW51eC0ke2FyY2h9LW11c2xgLCBgbGludXgtJHthcmNofWBdXG4gICAgICAgIDogW2BsaW51eC0ke2FyY2h9YCwgYGxpbnV4LSR7YXJjaH0tbXVzbGBdXG4gICAgICA6IFtgJHtwbGF0Zm9ybX0tJHthcmNofWBdO1xuICByZXR1cm4gc2x1Z3MubWFwKChzbHVnKSA9PlxuICAgIGpvaW4ocm9vdE5vZGVNb2R1bGVzLCBgQGFudGhyb3BpYy1haS9jbGF1ZGUtYWdlbnQtc2RrLSR7c2x1Z31gLCBiaW5hcnkpLFxuICApO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjtBQUErUTtBQUFBLEVBQzdRO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyxzQkFBc0I7QUFDL0IsU0FBUyxlQUFlO0FBQ3hCLFNBQVMsb0JBQW9COzs7QUNWMFEsU0FBUyxZQUFZO0FBZ0JyVCxTQUFTLGlCQUFpQjtBQUMvQixTQUFPLFFBQVEsSUFBSSx1QkFBdUIsUUFBUTtBQUNwRDtBQUdPLFNBQVMsYUFBYTtBQUMzQixTQUFPLFFBQVEsSUFBSSxtQkFBbUIsUUFBUTtBQUNoRDtBQUVPLFNBQVMsY0FBYyxXQUFXLGVBQWUsR0FBRztBQUN6RCxTQUFPLGFBQWEsVUFBVSxlQUFlO0FBQy9DO0FBUU8sU0FBUyxhQUFhO0FBQzNCLE1BQUksUUFBUSxhQUFhLFFBQVMsUUFBTztBQUN6QyxRQUFNLFNBQVMsUUFBUSxRQUFRLFVBQVU7QUFDekMsUUFBTSxTQUFTLFFBQVE7QUFDdkIsU0FBTyxDQUFDLFFBQVE7QUFDbEI7QUFNTyxTQUFTLHVCQUF1QixpQkFBaUI7QUFDdEQsUUFBTSxXQUFXLGVBQWU7QUFDaEMsUUFBTSxPQUFPLFdBQVc7QUFDeEIsUUFBTSxTQUFTLGNBQWMsUUFBUTtBQUNyQyxRQUFNLFFBQ0osYUFBYSxVQUNULFdBQVcsSUFDVCxDQUFDLFNBQVMsSUFBSSxTQUFTLFNBQVMsSUFBSSxFQUFFLElBQ3RDLENBQUMsU0FBUyxJQUFJLElBQUksU0FBUyxJQUFJLE9BQU8sSUFDeEMsQ0FBQyxHQUFHLFFBQVEsSUFBSSxJQUFJLEVBQUU7QUFDNUIsU0FBTyxNQUFNO0FBQUEsSUFBSSxDQUFDLFNBQ2hCLEtBQUssaUJBQWlCLGtDQUFrQyxJQUFJLElBQUksTUFBTTtBQUFBLEVBQ3hFO0FBQ0Y7OztBRHhDQSxTQUFTLHlCQUE2QztBQUNwRCxRQUFNLGFBQWE7QUFBQSxJQUNqQixRQUFRLFlBQVksU0FBUyxvQkFBb0I7QUFBQSxFQUNuRDtBQUNBLFNBQU8sV0FBVyxLQUFLLENBQUMsTUFBYyxXQUFXLENBQUMsQ0FBQztBQUNyRDtBQUVBLFNBQVMsYUFBYTtBQUNwQixRQUFNLFVBQVUsUUFBUSxZQUFZLFNBQVMsTUFBTTtBQUNuRCxRQUFNLGVBQWUsUUFBUSxTQUFTLFdBQVc7QUFDakQsUUFBTSxlQUFlLFFBQVEsU0FBUyxZQUFZO0FBRWxELFlBQVUsY0FBYyxFQUFFLFdBQVcsS0FBSyxDQUFDO0FBQzNDLFlBQVUsY0FBYyxFQUFFLFdBQVcsS0FBSyxDQUFDO0FBRTNDLFFBQU0sa0JBQWtCLFFBQVEsWUFBWSxTQUFTLGVBQWU7QUFDcEUsTUFBSSxXQUFXLGVBQWUsR0FBRztBQUMvQixXQUFPLGlCQUFpQixjQUFjLEVBQUUsV0FBVyxLQUFLLENBQUM7QUFBQSxFQUMzRDtBQUVBLFFBQU0sVUFBVSxjQUFjO0FBQzlCLFFBQU0sZUFBZSx1QkFBdUI7QUFDNUMsTUFBSSxjQUFjO0FBQ2hCLFVBQU0sT0FBTyxRQUFRLGNBQWMsT0FBTztBQUMxQyxpQkFBYSxjQUFjLElBQUk7QUFDL0IsUUFBSSxlQUFlLE1BQU0sU0FBUztBQUNoQyxnQkFBVSxNQUFNLEdBQUs7QUFBQSxJQUN2QjtBQUFBLEVBQ0YsT0FBTztBQUNMLFlBQVE7QUFBQSxNQUNOLGtEQUFrRCxlQUFlLENBQUMsSUFBSSxXQUFXLENBQUM7QUFBQSxJQUNwRjtBQUFBLEVBQ0Y7QUFFQTtBQUFBLElBQ0UsUUFBUSxjQUFjLGNBQWM7QUFBQSxJQUNwQyxLQUFLLFVBQVUsRUFBRSxNQUFNLFNBQVMsR0FBRyxNQUFNLENBQUM7QUFBQSxFQUM1QztBQUNGO0FBRUEsSUFBTSxnQkFBZ0I7QUFBQSxFQUNwQixXQUFXO0FBQUEsRUFDWCxXQUFXO0FBQUEsRUFDWCxRQUFRO0FBQUEsRUFDUixRQUFRO0FBQUEsRUFDUixZQUFZLENBQUMsbUJBQW1CLGdCQUFnQixtQkFBbUI7QUFBQSxFQUNuRSxVQUFVO0FBQUEsSUFDUixHQUFHO0FBQUEsSUFDSCxHQUFHLGVBQWUsSUFBSSxDQUFDLE1BQU0sUUFBUSxDQUFDLEVBQUU7QUFBQSxJQUN4QztBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsRUFDRjtBQUNGO0FBRUEsSUFBTyxzQkFBUSxhQUFhO0FBQUEsRUFDMUI7QUFBQSxJQUNFLE9BQU87QUFBQSxNQUNMO0FBQUEsTUFDQTtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsTUFDQTtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsTUFDQTtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsTUFDQTtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsTUFDQTtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsTUFDQTtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsTUFDQTtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsSUFDRjtBQUFBLElBQ0EsUUFBUSxDQUFDLEtBQUs7QUFBQSxJQUNkLEtBQUs7QUFBQSxJQUNMLE9BQU87QUFBQSxJQUNQLEdBQUc7QUFBQSxJQUNILFdBQVcsWUFBWTtBQUNyQixpQkFBVztBQUNYLGNBQVEsSUFBSSw0QkFBNEI7QUFLeEMsWUFBTSxjQUFjO0FBQUEsUUFDbEIsWUFBWTtBQUFBLFFBQ1o7QUFBQSxNQUNGO0FBQ0EsWUFBTSxhQUFhO0FBQUEsUUFDakIsWUFBWTtBQUFBLFFBQ1o7QUFBQSxNQUNGO0FBQ0EsVUFBSSxXQUFXLFVBQVUsR0FBRztBQUMxQixzQkFBYyxhQUFhLEdBQUcsS0FBSyxJQUFJLENBQUMsRUFBRTtBQUFBLE1BQzVDO0FBQUEsSUFDRjtBQUFBLEVBQ0Y7QUFBQSxFQUNBO0FBQUEsSUFDRSxPQUFPLEVBQUUsY0FBYyxvQkFBb0I7QUFBQSxJQUMzQyxRQUFRLENBQUMsS0FBSztBQUFBLElBQ2QsS0FBSztBQUFBLElBQ0wsT0FBTztBQUFBLElBQ1AsR0FBRztBQUFBLEVBQ0w7QUFDRixDQUFDOyIsCiAgIm5hbWVzIjogW10KfQo=

From 50ecc932ed2840082753e3d2df94c852051f1638 Mon Sep 17 00:00:00 2001
From: Peter Kirkham <peter@posthog.com>
Date: Mon, 1 Jun 2026 10:51:58 +0100
Subject: [PATCH 2/6] home tab changes

---
 .../home/components/HomeActiveAgentsStrip.tsx |   2 +-
 .../home/components/HomeBoardView.tsx         |   2 +-
 .../home/components/HomeWorkstreamCard.tsx    |   2 +-
 .../components/HomeWorkstreamDetailPanel.tsx  |   4 +-
 .../home/components/HomeWorkstreamRow.tsx     |   2 +-
 .../features/home/fixtures/demoSnapshot.ts    |   2 +-
 .../features/home/hooks/useBoundActions.ts    |   2 +-
 .../features/home/hooks/useHomeSnapshot.ts    | 177 +---------------
 .../home/hooks/useRunWorkstreamAction.ts      |   2 +-
 .../features/home/utils/boardColumns.ts       |   2 +-
 .../features/home/utils/buildSnapshot.test.ts |  96 +++++++++
 .../features/home/utils/buildSnapshot.ts      | 197 ++++++++++++++++++
 12 files changed, 307 insertions(+), 183 deletions(-)
 create mode 100644 apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
 create mode 100644 apps/code/src/renderer/features/home/utils/buildSnapshot.ts

diff --git a/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
index 8416c7067c..5825bdd47b 100644
--- a/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
@@ -3,7 +3,7 @@ import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
 import { useNavigationStore } from "@stores/navigationStore";
 import { formatRelativeTimeShort } from "@utils/time";
-import type { HomeActiveAgent } from "../hooks/useHomeSnapshot";
+import type { HomeActiveAgent } from "../utils/buildSnapshot";
 
 interface HomeActiveAgentsStripProps {
   agents: HomeActiveAgent[];
diff --git a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
index 263ae067cd..67341a2f81 100644
--- a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
@@ -1,6 +1,6 @@
 import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
-import type { HomeSnapshot } from "../hooks/useHomeSnapshot";
 import { buildBoardColumns } from "../utils/boardColumns";
+import type { HomeSnapshot } from "../utils/buildSnapshot";
 import { HomeWorkstreamCard } from "./HomeWorkstreamCard";
 
 interface HomeBoardViewProps {
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
index ded9b6ad76..41ce4ece3a 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
@@ -13,9 +13,9 @@ import { useNavigationStore } from "@stores/navigationStore";
 import { openUrlInBrowser } from "@utils/browser";
 import { formatRelativeTimeShort } from "@utils/time";
 import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
-import type { HomePullRequest, HomeWorkstream } from "../hooks/useHomeSnapshot";
 import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
 import { useHomeUiStore } from "../stores/homeUiStore";
+import type { HomePullRequest, HomeWorkstream } from "../utils/buildSnapshot";
 import {
   severityRingClass,
   situationSeverity,
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
index 4e7d876793..b327f176c7 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
@@ -21,12 +21,12 @@ import { useNavigationStore } from "@stores/navigationStore";
 import { openUrlInBrowser } from "@utils/browser";
 import { formatRelativeTimeShort } from "@utils/time";
 import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
+import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
 import type {
   HomePullRequest,
   HomeWorkstream,
   HomeWorkstreamTask,
-} from "../hooks/useHomeSnapshot";
-import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
+} from "../utils/buildSnapshot";
 import { SituationChip } from "./SituationChip";
 
 interface Props {
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
index 8c67d1b1ee..24953d1c04 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
@@ -14,9 +14,9 @@ import { useNavigationStore } from "@stores/navigationStore";
 import { openUrlInBrowser } from "@utils/browser";
 import { formatRelativeTimeShort } from "@utils/time";
 import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
-import type { HomeWorkstream } from "../hooks/useHomeSnapshot";
 import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
 import { useHomeUiStore } from "../stores/homeUiStore";
+import type { HomeWorkstream } from "../utils/buildSnapshot";
 import {
   severityRingClass,
   situationSeverity,
diff --git a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
index 84cee8aafe..9de9ee0f41 100644
--- a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
+++ b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
@@ -3,7 +3,7 @@ import type {
   HomePullRequest,
   HomeSnapshot,
   HomeWorkstream,
-} from "../hooks/useHomeSnapshot";
+} from "../utils/buildSnapshot";
 
 function withSituations(
   workstreams: Omit<HomeWorkstream, "situations">[],
diff --git a/apps/code/src/renderer/features/home/hooks/useBoundActions.ts b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
index a4a6f982f3..71a2635a03 100644
--- a/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
+++ b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
@@ -5,7 +5,7 @@ import {
   type WorkflowAction,
 } from "@shared/types/workflow";
 import { useMemo } from "react";
-import type { HomeWorkstream } from "./useHomeSnapshot";
+import type { HomeWorkstream } from "../utils/buildSnapshot";
 
 export interface BoundAction extends WorkflowAction {
   /** Situation this action came from — used for telemetry + tooltips. */
diff --git a/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
index 24fcb90f6b..aa86bb6023 100644
--- a/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
+++ b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
@@ -1,184 +1,15 @@
 import {
   type SidebarData,
-  type TaskData,
   useSidebarData,
 } from "@features/sidebar/hooks/useSidebarData";
-import type { TaskRunStatus } from "@shared/types";
-import type { SituationId } from "@shared/types/workflow";
-import { classify } from "@shared/types/workflow-classify";
 import { useNavigationStore } from "@stores/navigationStore";
 import { useMemo } from "react";
 import { buildDemoSnapshot, EMPTY_SNAPSHOT } from "../fixtures/demoSnapshot";
 import { useHomeDemoStore } from "../stores/homeDemoStore";
-
-export type HomeActiveAgent = {
-  taskId: string;
-  title: string;
-  repoName: string | null;
-  branch: string | null;
-  status: TaskRunStatus;
-  lastActivityAt: number;
-  needsPermission: boolean;
-  cloudPrUrl: string | null;
-};
-
-// Until the GitHub fetcher lands, real data only ever has `pr: null`. Kept
-// on the type because demo fixtures populate it and the detail panel renders
-// the richer view when present.
-export type HomePullRequest = {
-  url: string;
-  number: number;
-  title: string;
-  state: "open" | "draft" | "merged" | "closed";
-  ciStatus: "passing" | "failing" | "pending" | "none";
-  unresolvedThreads: number;
-  reviewDecision: "approved" | "changes_requested" | "review_required" | null;
-  isCurrentUserRequestedReviewer: boolean;
-  isCurrentUserAuthor: boolean;
-  author: string | null;
-  lastUpdatedAt: number;
-};
-
-export type HomeWorkstreamTask = {
-  id: string;
-  title: string;
-  status?: TaskRunStatus;
-  isGenerating: boolean;
-  needsPermission: boolean;
-};
-
-export type HomeWorkstream = {
-  id: string;
-  repoName: string | null;
-  branch: string | null;
-  prUrl: string | null;
-  pr: HomePullRequest | null;
-  tasks: HomeWorkstreamTask[];
-  /** Situations this workstream is in — drives board placement + bound actions. */
-  situations: SituationId[];
-  lastActivityAt: number;
-};
-
-export type HomeSnapshot = {
-  activeAgents: HomeActiveAgent[];
-  needsAttention: HomeWorkstream[];
-  inProgress: HomeWorkstream[];
-};
-
-const RUNNING_STATUSES: ReadonlySet<TaskRunStatus> = new Set([
-  "queued",
-  "in_progress",
-]);
-
-// Situations that escalate a workstream into the "Needs attention" bucket on
-// the list view. Everything else falls into "In progress".
-const ATTENTION_SITUATIONS: ReadonlySet<SituationId> = new Set([
-  "ci_failing",
-  "changes_requested",
-  "comments_waiting",
-  "stale",
-]);
-
-function isRunning(status?: TaskRunStatus): boolean {
-  return !!status && RUNNING_STATUSES.has(status);
-}
-
-function workstreamKey(task: TaskData): string | null {
-  const repo = task.repository?.name ?? null;
-  const branch = task.linkedBranch ?? task.branchName ?? null;
-  if (task.cloudPrUrl) return `pr:${task.cloudPrUrl}`;
-  if (repo && branch) return `branch:${repo}#${branch}`;
-  return null;
-}
-
-function buildSnapshotFromTasks(
-  pinned: TaskData[],
-  flat: TaskData[],
-): HomeSnapshot {
-  const allTasks = [...pinned, ...flat];
-  const now = Date.now();
-
-  const activeAgents: HomeActiveAgent[] = [];
-  const groups = new Map<string, TaskData[]>();
-  const taskInStrip = new Set<string>();
-
-  for (const task of allTasks) {
-    if (isRunning(task.taskRunStatus)) {
-      activeAgents.push({
-        taskId: task.id,
-        title: task.title,
-        repoName: task.repository?.name ?? null,
-        branch: task.linkedBranch ?? task.branchName ?? null,
-        status: task.taskRunStatus as TaskRunStatus,
-        lastActivityAt: task.lastActivityAt,
-        needsPermission: task.needsPermission,
-        cloudPrUrl: task.cloudPrUrl,
-      });
-      taskInStrip.add(task.id);
-      continue;
-    }
-    const key = workstreamKey(task);
-    if (!key) continue;
-    const bucket = groups.get(key);
-    if (bucket) bucket.push(task);
-    else groups.set(key, [task]);
-  }
-
-  activeAgents.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-
-  const needsAttention: HomeWorkstream[] = [];
-  const inProgress: HomeWorkstream[] = [];
-
-  for (const [id, tasks] of groups) {
-    tasks.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-    const head = tasks[0];
-    if (!head) continue;
-
-    if (tasks.every((t) => taskInStrip.has(t.id))) continue;
-
-    const prUrl = tasks.find((t) => t.cloudPrUrl)?.cloudPrUrl ?? null;
-    const branch = head.linkedBranch ?? head.branchName ?? null;
-    const lastActivityAt = head.lastActivityAt;
-
-    const situations = Array.from(
-      classify({
-        hasPrUrl: !!prUrl,
-        pr: null,
-        branch,
-        lastActivityAt,
-        now,
-      }),
-    );
-
-    const workstream: HomeWorkstream = {
-      id,
-      repoName: head.repository?.name ?? null,
-      branch,
-      prUrl,
-      pr: null,
-      tasks: tasks.map((t) => ({
-        id: t.id,
-        title: t.title,
-        status: t.taskRunStatus,
-        isGenerating: t.isGenerating,
-        needsPermission: t.needsPermission,
-      })),
-      situations,
-      lastActivityAt,
-    };
-
-    if (situations.some((s) => ATTENTION_SITUATIONS.has(s))) {
-      needsAttention.push(workstream);
-    } else {
-      inProgress.push(workstream);
-    }
-  }
-
-  needsAttention.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-  inProgress.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-
-  return { activeAgents, needsAttention, inProgress };
-}
+import {
+  buildSnapshotFromTasks,
+  type HomeSnapshot,
+} from "../utils/buildSnapshot";
 
 export function useHomeSnapshot(): {
   snapshot: HomeSnapshot;
diff --git a/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
index ab741c92c2..159c7356a0 100644
--- a/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
+++ b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
@@ -1,8 +1,8 @@
 import { useNavigationStore } from "@stores/navigationStore";
 import { toast } from "@utils/toast";
 import { useCallback } from "react";
+import type { HomeWorkstream } from "../utils/buildSnapshot";
 import type { BoundAction } from "./useBoundActions";
-import type { HomeWorkstream } from "./useHomeSnapshot";
 
 // Routes a bound workflow action into the new-task screen with the prompt
 // prefilled, rather than firing `taskService.createTask` directly: the user
diff --git a/apps/code/src/renderer/features/home/utils/boardColumns.ts b/apps/code/src/renderer/features/home/utils/boardColumns.ts
index 767f86fca6..e4f3da8b71 100644
--- a/apps/code/src/renderer/features/home/utils/boardColumns.ts
+++ b/apps/code/src/renderer/features/home/utils/boardColumns.ts
@@ -1,6 +1,6 @@
 import { SITUATIONS, type SituationId } from "@shared/types/workflow";
 import { pickPrimarySituation } from "@shared/types/workflow-classify";
-import type { HomeWorkstream } from "../hooks/useHomeSnapshot";
+import type { HomeWorkstream } from "./buildSnapshot";
 
 export type HomeBoardColumn = {
   id: SituationId;
diff --git a/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts b/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
new file mode 100644
index 0000000000..d4868ab7ff
--- /dev/null
+++ b/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
@@ -0,0 +1,96 @@
+import type { TaskData } from "@features/sidebar/hooks/useSidebarData";
+import { describe, expect, it } from "vitest";
+import { buildSnapshotFromTasks } from "./buildSnapshot";
+
+const MINUTE = 60 * 1000;
+
+function makeTask(overrides: Partial<TaskData> = {}): TaskData {
+  return {
+    id: "t1",
+    title: "Task",
+    createdAt: Date.now(),
+    lastActivityAt: Date.now(),
+    isGenerating: false,
+    isUnread: false,
+    isPinned: false,
+    needsPermission: false,
+    repository: { fullPath: "org/repo", name: "repo" },
+    isSuspended: false,
+    taskRunStatus: "in_progress",
+    folderPath: null,
+    cloudPrUrl: null,
+    branchName: "feature",
+    linkedBranch: null,
+    ...overrides,
+  };
+}
+
+describe("buildSnapshotFromTasks — Running strip", () => {
+  it("keeps a genuinely live in_progress agent in the Running strip", () => {
+    const { activeAgents, inProgress, needsAttention } = buildSnapshotFromTasks(
+      [],
+      [makeTask({ lastActivityAt: Date.now() - MINUTE })],
+    );
+
+    expect(activeAgents).toHaveLength(1);
+    expect(inProgress).toHaveLength(0);
+    expect(needsAttention).toHaveLength(0);
+  });
+
+  it("drops an agent with an open PR out of Running and into review", () => {
+    const { activeAgents, inProgress } = buildSnapshotFromTasks(
+      [],
+      [
+        makeTask({
+          cloudPrUrl: "https://github.com/org/repo/pull/1",
+          lastActivityAt: Date.now(),
+        }),
+      ],
+    );
+
+    expect(activeAgents).toHaveLength(0);
+    expect(inProgress).toHaveLength(1);
+    expect(inProgress[0]?.situations).toContain("in_review");
+  });
+
+  it("drops a stale in_progress agent out of the Running strip", () => {
+    const { activeAgents, inProgress, needsAttention } = buildSnapshotFromTasks(
+      [],
+      [makeTask({ lastActivityAt: Date.now() - 45 * MINUTE })],
+    );
+
+    expect(activeAgents).toHaveLength(0);
+    // Branch with no PR + recent-enough to not be 7-day stale → "Working".
+    expect(inProgress).toHaveLength(1);
+    expect(inProgress[0]?.situations).toContain("working");
+    expect(needsAttention).toHaveLength(0);
+  });
+
+  it("keeps a stale-by-timestamp agent in Running while it awaits permission", () => {
+    const { activeAgents } = buildSnapshotFromTasks(
+      [],
+      [
+        makeTask({
+          needsPermission: true,
+          lastActivityAt: Date.now() - 45 * MINUTE,
+        }),
+      ],
+    );
+
+    expect(activeAgents).toHaveLength(1);
+  });
+
+  it("keeps a stale-by-timestamp agent in Running while it is generating", () => {
+    const { activeAgents } = buildSnapshotFromTasks(
+      [],
+      [
+        makeTask({
+          isGenerating: true,
+          lastActivityAt: Date.now() - 45 * MINUTE,
+        }),
+      ],
+    );
+
+    expect(activeAgents).toHaveLength(1);
+  });
+});
diff --git a/apps/code/src/renderer/features/home/utils/buildSnapshot.ts b/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
new file mode 100644
index 0000000000..63b2536369
--- /dev/null
+++ b/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
@@ -0,0 +1,197 @@
+import type { TaskData } from "@features/sidebar/hooks/useSidebarData";
+import type { TaskRunStatus } from "@shared/types";
+import type { SituationId } from "@shared/types/workflow";
+import { classify } from "@shared/types/workflow-classify";
+
+export type HomeActiveAgent = {
+  taskId: string;
+  title: string;
+  repoName: string | null;
+  branch: string | null;
+  status: TaskRunStatus;
+  lastActivityAt: number;
+  needsPermission: boolean;
+  cloudPrUrl: string | null;
+};
+
+// Until the GitHub fetcher lands, real data only ever has `pr: null`. Kept
+// on the type because demo fixtures populate it and the detail panel renders
+// the richer view when present.
+export type HomePullRequest = {
+  url: string;
+  number: number;
+  title: string;
+  state: "open" | "draft" | "merged" | "closed";
+  ciStatus: "passing" | "failing" | "pending" | "none";
+  unresolvedThreads: number;
+  reviewDecision: "approved" | "changes_requested" | "review_required" | null;
+  isCurrentUserRequestedReviewer: boolean;
+  isCurrentUserAuthor: boolean;
+  author: string | null;
+  lastUpdatedAt: number;
+};
+
+export type HomeWorkstreamTask = {
+  id: string;
+  title: string;
+  status?: TaskRunStatus;
+  isGenerating: boolean;
+  needsPermission: boolean;
+};
+
+export type HomeWorkstream = {
+  id: string;
+  repoName: string | null;
+  branch: string | null;
+  prUrl: string | null;
+  pr: HomePullRequest | null;
+  tasks: HomeWorkstreamTask[];
+  /** Situations this workstream is in — drives board placement + bound actions. */
+  situations: SituationId[];
+  lastActivityAt: number;
+};
+
+export type HomeSnapshot = {
+  activeAgents: HomeActiveAgent[];
+  needsAttention: HomeWorkstream[];
+  inProgress: HomeWorkstream[];
+};
+
+const RUNNING_STATUSES: ReadonlySet<TaskRunStatus> = new Set([
+  "queued",
+  "in_progress",
+]);
+
+// How long a still-`in_progress` task can go without activity before we stop
+// treating it as actually running. A live run idles for seconds, not half an
+// hour — past this it's a status the server never transitioned to a terminal
+// state, not a live agent.
+const RUNNING_STALE_THRESHOLD_MS = 30 * 60 * 1000;
+
+// Situations that escalate a workstream into the "Needs attention" bucket on
+// the list view. Everything else falls into "In progress".
+const ATTENTION_SITUATIONS: ReadonlySet<SituationId> = new Set([
+  "ci_failing",
+  "changes_requested",
+  "comments_waiting",
+  "stale",
+]);
+
+function isRunning(status?: TaskRunStatus): boolean {
+  return !!status && RUNNING_STATUSES.has(status);
+}
+
+// A task only belongs in the "Running" strip if its run status is live *and*
+// it still looks genuinely active. A queued/in_progress status isn't enough on
+// its own:
+//   - Once a PR has been opened the agent has moved past working into review,
+//     even if the cloud run status is still stuck at in_progress.
+//   - A run with no activity for a while is a stale status the server never
+//     transitioned to a terminal state.
+// Both cases fall through to workstream grouping, where classify() routes them
+// to "In review" / "Working" / "Stale". A session that's actively generating
+// or waiting on the user is always live, so it's exempt from the stale check
+// (its activity timestamp may not tick while it waits).
+function isActivelyRunning(task: TaskData, now: number): boolean {
+  if (!isRunning(task.taskRunStatus)) return false;
+  if (task.cloudPrUrl) return false;
+  if (task.isGenerating || task.needsPermission) return true;
+  return now - task.lastActivityAt <= RUNNING_STALE_THRESHOLD_MS;
+}
+
+function workstreamKey(task: TaskData): string | null {
+  const repo = task.repository?.name ?? null;
+  const branch = task.linkedBranch ?? task.branchName ?? null;
+  if (task.cloudPrUrl) return `pr:${task.cloudPrUrl}`;
+  if (repo && branch) return `branch:${repo}#${branch}`;
+  return null;
+}
+
+export function buildSnapshotFromTasks(
+  pinned: TaskData[],
+  flat: TaskData[],
+): HomeSnapshot {
+  const allTasks = [...pinned, ...flat];
+  const now = Date.now();
+
+  const activeAgents: HomeActiveAgent[] = [];
+  const groups = new Map<string, TaskData[]>();
+  const taskInStrip = new Set<string>();
+
+  for (const task of allTasks) {
+    if (isActivelyRunning(task, now)) {
+      activeAgents.push({
+        taskId: task.id,
+        title: task.title,
+        repoName: task.repository?.name ?? null,
+        branch: task.linkedBranch ?? task.branchName ?? null,
+        status: task.taskRunStatus as TaskRunStatus,
+        lastActivityAt: task.lastActivityAt,
+        needsPermission: task.needsPermission,
+        cloudPrUrl: task.cloudPrUrl,
+      });
+      taskInStrip.add(task.id);
+      continue;
+    }
+    const key = workstreamKey(task);
+    if (!key) continue;
+    const bucket = groups.get(key);
+    if (bucket) bucket.push(task);
+    else groups.set(key, [task]);
+  }
+
+  activeAgents.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+
+  const needsAttention: HomeWorkstream[] = [];
+  const inProgress: HomeWorkstream[] = [];
+
+  for (const [id, tasks] of groups) {
+    tasks.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+    const head = tasks[0];
+    if (!head) continue;
+
+    if (tasks.every((t) => taskInStrip.has(t.id))) continue;
+
+    const prUrl = tasks.find((t) => t.cloudPrUrl)?.cloudPrUrl ?? null;
+    const branch = head.linkedBranch ?? head.branchName ?? null;
+    const lastActivityAt = head.lastActivityAt;
+
+    const situations = Array.from(
+      classify({
+        hasPrUrl: !!prUrl,
+        pr: null,
+        branch,
+        lastActivityAt,
+        now,
+      }),
+    );
+
+    const workstream: HomeWorkstream = {
+      id,
+      repoName: head.repository?.name ?? null,
+      branch,
+      prUrl,
+      pr: null,
+      tasks: tasks.map((t) => ({
+        id: t.id,
+        title: t.title,
+        status: t.taskRunStatus,
+        isGenerating: t.isGenerating,
+        needsPermission: t.needsPermission,
+      })),
+      situations,
+      lastActivityAt,
+    };
+
+    if (situations.some((s) => ATTENTION_SITUATIONS.has(s))) {
+      needsAttention.push(workstream);
+    } else {
+      inProgress.push(workstream);
+    }
+  }
+
+  needsAttention.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+  inProgress.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+
+  return { activeAgents, needsAttention, inProgress };
+}

From 3ef49539ba106b652aaea3320c37aa3de86265d8 Mon Sep 17 00:00:00 2001
From: Peter Kirkham <peter@posthog.com>
Date: Mon, 1 Jun 2026 13:27:14 +0100
Subject: [PATCH 3/6] home tab redesign

---
 apps/code/src/main/di/container.ts            |   7 +
 apps/code/src/main/di/tokens.ts               |   2 +
 .../src/main/services/git/service.test.ts     |  86 ++++-
 apps/code/src/main/services/git/service.ts    | 234 ++++++++++++-
 .../src/main/services/pr-snapshot/backend.ts  |  66 ++++
 .../src/main/services/pr-snapshot/service.ts  | 124 +++++++
 apps/code/src/main/trpc/router.ts             |   2 +
 .../code/src/main/trpc/routers/pr-snapshot.ts |  35 ++
 .../home/components/HomeActiveAgentsStrip.tsx |  55 ++-
 .../home/components/HomeBoardView.tsx         | 105 +++---
 .../home/components/HomeEmptyState.tsx        |  10 +-
 .../features/home/components/HomeView.tsx     |  88 +++--
 .../home/components/HomeWorkstreamCard.tsx    | 321 ++++++++----------
 .../components/HomeWorkstreamDetailPanel.tsx  |  12 +-
 .../home/components/HomeWorkstreamRow.tsx     | 274 +++++++--------
 .../home/components/SituationChip.tsx         |  22 +-
 .../home/components/WorkstreamBits.tsx        | 224 ++++++++++++
 .../features/home/fixtures/demoSnapshot.ts    |   1 +
 .../features/home/hooks/useHomeSnapshot.ts    |  40 ++-
 .../features/home/hooks/useHomeTasks.ts       |  86 +++++
 .../features/home/hooks/usePrSnapshots.ts     |  47 +++
 .../home/hooks/useWorkstreamPresentation.ts   |  95 ++++++
 .../features/home/stores/prSnapshotStore.ts   |  22 ++
 .../renderer/features/home/subscriptions.ts   |  14 +
 .../features/home/utils/buildSnapshot.test.ts |  75 ++++
 .../features/home/utils/buildSnapshot.ts      |  73 ++--
 .../features/home/utils/situationDisplay.ts   | 116 +++++--
 .../features/sidebar/hooks/useSidebarData.ts  | 146 +++++---
 apps/code/src/shared/types/pr-snapshot.ts     |  83 +++++
 docs/workflow-architecture.md                 |  72 +++-
 30 files changed, 1982 insertions(+), 555 deletions(-)
 create mode 100644 apps/code/src/main/services/pr-snapshot/backend.ts
 create mode 100644 apps/code/src/main/services/pr-snapshot/service.ts
 create mode 100644 apps/code/src/main/trpc/routers/pr-snapshot.ts
 create mode 100644 apps/code/src/renderer/features/home/components/WorkstreamBits.tsx
 create mode 100644 apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
 create mode 100644 apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
 create mode 100644 apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
 create mode 100644 apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
 create mode 100644 apps/code/src/shared/types/pr-snapshot.ts

diff --git a/apps/code/src/main/di/container.ts b/apps/code/src/main/di/container.ts
index 385f3c1e47..e7b1103994 100644
--- a/apps/code/src/main/di/container.ts
+++ b/apps/code/src/main/di/container.ts
@@ -70,6 +70,8 @@ import { UIService } from "../services/ui/service";
 import { UpdatesService } from "../services/updates/service";
 import { UsageMonitorService } from "../services/usage-monitor/service";
 import { WatcherRegistryService } from "../services/watcher-registry/service";
+import { LocalPrSnapshotBackend } from "../services/pr-snapshot/backend";
+import { PrSnapshotService } from "../services/pr-snapshot/service";
 import { LocalWorkflowBackend } from "../services/workflow/backend";
 import { WorkflowService } from "../services/workflow/service";
 import { WorkspaceService } from "../services/workspace/service";
@@ -162,6 +164,11 @@ container.bind(MAIN_TOKENS.WatcherRegistryService).to(WatcherRegistryService);
 // and apps/code/src/main/services/workflow/backend.ts for the migration plan.
 container.bind(MAIN_TOKENS.WorkflowBackend).to(LocalWorkflowBackend);
 container.bind(MAIN_TOKENS.WorkflowService).to(WorkflowService);
+// PR/CI snapshot polling. Same swap-point pattern as the workflow backend:
+// LocalPrSnapshotBackend (gh CLI) today → CloudPrSnapshotBackend when PostHog
+// owns PR polling. See docs/workflow-architecture.md §5–6.
+container.bind(MAIN_TOKENS.PrSnapshotBackend).to(LocalPrSnapshotBackend);
+container.bind(MAIN_TOKENS.PrSnapshotService).to(PrSnapshotService);
 container.bind(MAIN_TOKENS.WorkspaceService).to(WorkspaceService);
 
 container.bind(MAIN_TOKENS.SettingsStore).toConstantValue(settingsStore);
diff --git a/apps/code/src/main/di/tokens.ts b/apps/code/src/main/di/tokens.ts
index f23393745b..5f95316905 100644
--- a/apps/code/src/main/di/tokens.ts
+++ b/apps/code/src/main/di/tokens.ts
@@ -87,4 +87,6 @@ export const MAIN_TOKENS = Object.freeze({
   UsageMonitorService: Symbol.for("Main.UsageMonitorService"),
   WorkflowBackend: Symbol.for("Main.WorkflowBackend"),
   WorkflowService: Symbol.for("Main.WorkflowService"),
+  PrSnapshotBackend: Symbol.for("Main.PrSnapshotBackend"),
+  PrSnapshotService: Symbol.for("Main.PrSnapshotService"),
 });
diff --git a/apps/code/src/main/services/git/service.test.ts b/apps/code/src/main/services/git/service.test.ts
index afe6a4ff4f..5ed070233c 100644
--- a/apps/code/src/main/services/git/service.test.ts
+++ b/apps/code/src/main/services/git/service.test.ts
@@ -26,7 +26,14 @@ vi.mock("../../utils/logger.js", () => ({
 import type { AgentService } from "../agent/service";
 import type { LlmGatewayService } from "../llm-gateway/service";
 import type { WorkspaceService } from "../workspace/service";
-import { GitService, mapPrState } from "./service";
+import {
+  GitService,
+  mapCiStatus,
+  mapPrMergeable,
+  mapPrReviewDecision,
+  mapPrSnapshotState,
+  mapPrState,
+} from "./service";
 
 describe("GitService.getPrChangedFiles", () => {
   let service: GitService;
@@ -320,6 +327,83 @@ describe("mapPrState", () => {
   });
 });
 
+describe("mapPrSnapshotState", () => {
+  it("maps merged/closed regardless of draft", () => {
+    expect(mapPrSnapshotState("MERGED", false)).toBe("merged");
+    expect(mapPrSnapshotState("CLOSED", true)).toBe("closed");
+  });
+
+  it("maps open PRs, honouring draft", () => {
+    expect(mapPrSnapshotState("OPEN", false)).toBe("open");
+    expect(mapPrSnapshotState("OPEN", true)).toBe("draft");
+    expect(mapPrSnapshotState(undefined, false)).toBe("open");
+  });
+});
+
+describe("mapPrReviewDecision", () => {
+  it("lowercases known decisions", () => {
+    expect(mapPrReviewDecision("APPROVED")).toBe("approved");
+    expect(mapPrReviewDecision("CHANGES_REQUESTED")).toBe("changes_requested");
+    expect(mapPrReviewDecision("REVIEW_REQUIRED")).toBe("review_required");
+  });
+
+  it("returns null for empty/unknown (no review required)", () => {
+    expect(mapPrReviewDecision("")).toBeNull();
+    expect(mapPrReviewDecision(null)).toBeNull();
+    expect(mapPrReviewDecision(undefined)).toBeNull();
+  });
+});
+
+describe("mapPrMergeable", () => {
+  it("maps to a tri-state boolean", () => {
+    expect(mapPrMergeable("MERGEABLE")).toBe(true);
+    expect(mapPrMergeable("CONFLICTING")).toBe(false);
+    expect(mapPrMergeable("UNKNOWN")).toBeNull();
+    expect(mapPrMergeable(undefined)).toBeNull();
+  });
+});
+
+describe("mapCiStatus", () => {
+  it("returns none when there are no checks", () => {
+    expect(mapCiStatus(undefined)).toBe("none");
+    expect(mapCiStatus([])).toBe("none");
+  });
+
+  it("returns passing when every check succeeded", () => {
+    expect(
+      mapCiStatus([
+        { __typename: "CheckRun", status: "COMPLETED", conclusion: "SUCCESS" },
+        { __typename: "CheckRun", status: "COMPLETED", conclusion: "SKIPPED" },
+        { __typename: "StatusContext", state: "SUCCESS" },
+      ]),
+    ).toBe("passing");
+  });
+
+  it("returns failing when any check failed, even alongside pending ones", () => {
+    expect(
+      mapCiStatus([
+        { __typename: "CheckRun", status: "IN_PROGRESS", conclusion: null },
+        { __typename: "CheckRun", status: "COMPLETED", conclusion: "FAILURE" },
+      ]),
+    ).toBe("failing");
+    expect(mapCiStatus([{ __typename: "StatusContext", state: "ERROR" }])).toBe(
+      "failing",
+    );
+  });
+
+  it("returns pending when checks are still running and none failed", () => {
+    expect(
+      mapCiStatus([
+        { __typename: "CheckRun", status: "COMPLETED", conclusion: "SUCCESS" },
+        { __typename: "CheckRun", status: "QUEUED", conclusion: null },
+      ]),
+    ).toBe("pending");
+    expect(
+      mapCiStatus([{ __typename: "StatusContext", state: "PENDING" }]),
+    ).toBe("pending");
+  });
+});
+
 describe("GitService.getPrReviewComments", () => {
   let service: GitService;
 
diff --git a/apps/code/src/main/services/git/service.ts b/apps/code/src/main/services/git/service.ts
index 99ee93a957..fdd1c3b195 100644
--- a/apps/code/src/main/services/git/service.ts
+++ b/apps/code/src/main/services/git/service.ts
@@ -5,7 +5,7 @@ import { promisify } from "node:util";
 
 const execFileAsync = promisify(execFile);
 
-import { execGh } from "@posthog/git/gh";
+import { execGh, execGhWithRetry } from "@posthog/git/gh";
 import {
   getAllBranches,
   getBranchDiffPatchesByPath,
@@ -37,6 +37,7 @@ import { DiscardFileChangesSaga } from "@posthog/git/sagas/discard";
 import { PullSaga } from "@posthog/git/sagas/pull";
 import { PushSaga } from "@posthog/git/sagas/push";
 import { parseGithubUrl } from "@posthog/git/utils";
+import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import { inject, injectable } from "inversify";
 import { MAIN_TOKENS } from "../../di/tokens";
 import { logger } from "../../utils/logger";
@@ -113,6 +114,95 @@ export function mapPrState(
   return null;
 }
 
+// gh's PR `state` is OPEN | CLOSED | MERGED; draftness is a separate flag.
+// Collapse both into the PrSnapshot lifecycle the classifier understands.
+export function mapPrSnapshotState(
+  state: string | null | undefined,
+  isDraft: boolean | undefined,
+): PrSnapshot["state"] {
+  switch (state?.toUpperCase()) {
+    case "MERGED":
+      return "merged";
+    case "CLOSED":
+      return "closed";
+    default:
+      return isDraft ? "draft" : "open";
+  }
+}
+
+export function mapPrReviewDecision(
+  decision: string | null | undefined,
+): PrSnapshot["reviewDecision"] {
+  switch (decision?.toUpperCase()) {
+    case "APPROVED":
+      return "approved";
+    case "CHANGES_REQUESTED":
+      return "changes_requested";
+    case "REVIEW_REQUIRED":
+      return "review_required";
+    default:
+      return null;
+  }
+}
+
+export function mapPrMergeable(
+  mergeable: string | null | undefined,
+): boolean | null {
+  switch (mergeable?.toUpperCase()) {
+    case "MERGEABLE":
+      return true;
+    case "CONFLICTING":
+      return false;
+    default:
+      return null;
+  }
+}
+
+type GhCheckRollupEntry = {
+  __typename?: string;
+  // CheckRun
+  status?: string | null;
+  conclusion?: string | null;
+  // StatusContext
+  state?: string | null;
+};
+
+const FAILING_CHECK_CONCLUSIONS = new Set([
+  "FAILURE",
+  "TIMED_OUT",
+  "CANCELLED",
+  "ACTION_REQUIRED",
+  "STARTUP_FAILURE",
+]);
+
+// Aggregate gh's per-check `statusCheckRollup` into a single CI verdict.
+// Precedence is failing > pending > passing: one red check makes the PR red
+// even if others are still running.
+export function mapCiStatus(
+  rollup: GhCheckRollupEntry[] | null | undefined,
+): PrSnapshot["ciStatus"] {
+  if (!rollup || rollup.length === 0) return "none";
+  let pending = false;
+  for (const entry of rollup) {
+    if (entry.__typename === "StatusContext") {
+      const state = entry.state?.toUpperCase();
+      if (state === "FAILURE" || state === "ERROR") return "failing";
+      if (state === "PENDING" || state === "EXPECTED") pending = true;
+      continue;
+    }
+    // CheckRun (the common case for GitHub Actions).
+    const status = entry.status?.toUpperCase();
+    if (status !== "COMPLETED") {
+      pending = true;
+      continue;
+    }
+    const conclusion = entry.conclusion?.toUpperCase() ?? null;
+    if (conclusion && FAILING_CHECK_CONCLUSIONS.has(conclusion))
+      return "failing";
+  }
+  return pending ? "pending" : "passing";
+}
+
 /**
  * Wraps a GitHub API per-file patch (hunk content only) with
  * the `diff --git` / `---` / `+++` header so that unified-diff
@@ -133,6 +223,9 @@ function toUnifiedDiffPatch(
 @injectable()
 export class GitService extends TypedEventEmitter<GitServiceEvents> {
   private lastFetchTime = new Map<string, number>();
+  // Resolved once: the gh-authenticated user, used to decide whether a PR is
+  // "mine". `undefined` = not looked up yet, `null` = lookup failed/unknown.
+  private viewerLogin: string | null | undefined;
 
   constructor(
     @inject(MAIN_TOKENS.LlmGatewayService)
@@ -1181,6 +1274,102 @@ export class GitService extends TypedEventEmitter<GitServiceEvents> {
     }
   }
 
+  private async getViewerLogin(): Promise<string | null> {
+    if (this.viewerLogin !== undefined) return this.viewerLogin;
+    const result = await execGh(["api", "user", "--jq", ".login"]);
+    this.viewerLogin =
+      result.exitCode === 0 ? result.stdout.trim() || null : null;
+    return this.viewerLogin;
+  }
+
+  /**
+   * Rich PR snapshot for the home tab: lifecycle state, CI verdict, review
+   * decision, mergeability, and (for the user's own open PRs) the unresolved
+   * review-thread count. This is the local gh implementation of the PR-polling
+   * concern; the production PostHog worker produces the same `PrSnapshot`
+   * shape — see docs/workflow-architecture.md §5.
+   */
+  public async getPrFull(prUrl: string): Promise<PrSnapshot | null> {
+    const ref = parseGithubUrl(prUrl);
+    if (ref?.kind !== "pr") return null;
+
+    const result = await execGhWithRetry(
+      [
+        "pr",
+        "view",
+        prUrl,
+        "--json",
+        "number,title,state,isDraft,mergeable,reviewDecision,statusCheckRollup,author,reviewRequests,updatedAt,url",
+      ],
+      { timeoutMs: 15_000 },
+    );
+
+    if (result.exitCode !== 0) {
+      log.warn("Failed to fetch PR snapshot", {
+        prUrl,
+        error: result.stderr || result.error,
+      });
+      return null;
+    }
+
+    let data: {
+      number?: number;
+      title?: string;
+      state?: string;
+      isDraft?: boolean;
+      mergeable?: string;
+      reviewDecision?: string;
+      statusCheckRollup?: GhCheckRollupEntry[];
+      author?: { login?: string } | null;
+      reviewRequests?: Array<{ login?: string }>;
+      updatedAt?: string;
+      url?: string;
+    };
+    try {
+      data = JSON.parse(result.stdout);
+    } catch (error) {
+      log.warn("PR snapshot JSON is not parseable", { prUrl, error });
+      return null;
+    }
+
+    const viewer = await this.getViewerLogin();
+    const authorLogin = data.author?.login ?? null;
+    const isCurrentUserAuthor = !!viewer && authorLogin === viewer;
+    const isCurrentUserRequestedReviewer =
+      !!viewer && (data.reviewRequests ?? []).some((r) => r.login === viewer);
+    const state = mapPrSnapshotState(data.state, data.isDraft);
+
+    // Unresolved threads only drive the `comments_waiting` situation, which is
+    // scoped to the author's own live PRs — so only pay for the extra GraphQL
+    // call there, and never block the snapshot if it fails.
+    let unresolvedThreads = 0;
+    if (isCurrentUserAuthor && (state === "open" || state === "draft")) {
+      try {
+        const threads = await this.getPrReviewComments(prUrl);
+        unresolvedThreads = threads.filter((t) => !t.isResolved).length;
+      } catch (error) {
+        log.warn("Failed to count unresolved review threads", { prUrl, error });
+      }
+    }
+
+    return {
+      url: data.url ?? prUrl,
+      number: data.number ?? ref.number,
+      title: data.title ?? "",
+      state,
+      ciStatus: mapCiStatus(data.statusCheckRollup),
+      reviewDecision: mapPrReviewDecision(data.reviewDecision),
+      unresolvedThreads,
+      mergeable: mapPrMergeable(data.mergeable),
+      isCurrentUserRequestedReviewer,
+      isCurrentUserAuthor,
+      author: authorLogin,
+      lastUpdatedAt: data.updatedAt
+        ? new Date(data.updatedAt).getTime()
+        : Date.now(),
+    };
+  }
+
   public async updatePrByUrl(
     prUrl: string,
     action: PrActionType,
@@ -2045,4 +2234,47 @@ ${truncatedDiff || "(no diff available)"}${contextSection}`;
 
     return { prState: null, hasDiff: false };
   }
+
+  /**
+   * Resolve the PR URL for a task across all task kinds — cloud run output, the
+   * linked branch (`gh pr list --head`), or the worktree's current branch —
+   * mirroring {@link getTaskPrStatus}. Returns null when the task has no PR.
+   */
+  async resolveTaskPrUrl(
+    taskId: string,
+    cloudPrUrl: string | null,
+  ): Promise<string | null> {
+    const workspace = await this.workspaceService.getWorkspace(taskId);
+    if (!workspace) return cloudPrUrl ?? null;
+
+    const { mode, worktreePath, folderPath, linkedBranch } = workspace;
+    const repoPath = worktreePath ?? (folderPath || null);
+
+    if (mode === "cloud") return cloudPrUrl ?? null;
+
+    if (linkedBranch && repoPath) {
+      const prUrl = await this.getPrUrlForBranch(repoPath, linkedBranch);
+      if (prUrl) return prUrl;
+    }
+
+    if (worktreePath) {
+      const prStatus = await this.getPrStatus(worktreePath);
+      if (prStatus.prExists && prStatus.prUrl) return prStatus.prUrl;
+    }
+
+    return cloudPrUrl ?? null;
+  }
+
+  /**
+   * Resolve a task's PR (any kind) and return the rich snapshot the home tab
+   * classifies against. Null when the task has no PR.
+   */
+  async getTaskPrSnapshot(
+    taskId: string,
+    cloudPrUrl: string | null,
+  ): Promise<PrSnapshot | null> {
+    const prUrl = await this.resolveTaskPrUrl(taskId, cloudPrUrl);
+    if (!prUrl) return null;
+    return this.getPrFull(prUrl);
+  }
 }
diff --git a/apps/code/src/main/services/pr-snapshot/backend.ts b/apps/code/src/main/services/pr-snapshot/backend.ts
new file mode 100644
index 0000000000..c2d840ef59
--- /dev/null
+++ b/apps/code/src/main/services/pr-snapshot/backend.ts
@@ -0,0 +1,66 @@
+import { MAIN_TOKENS } from "@main/di/tokens";
+import type { GitService } from "@main/services/git/service";
+import type { TaskPrRef, TaskPrSnapshot } from "@shared/types/pr-snapshot";
+import { inject, injectable } from "inversify";
+
+/**
+ * Single seam between {@link PrSnapshotService} and where PR/CI data comes
+ * from. Today: the local gh CLI ({@link LocalPrSnapshotBackend}). When the
+ * PostHog backend grows a PR-polling worker, a `CloudPrSnapshotBackend`
+ * replaces this binding and the service above is unchanged — see
+ * docs/workflow-architecture.md §5–6 for the migration plan.
+ *
+ * Contract for any implementation:
+ * - `fetch` returns a snapshot per task it could resolve a PR for; tasks with
+ *   no PR (or a transient failure) are simply omitted, never thrown.
+ * - The returned snapshot shape is the canonical `PrSnapshot` regardless of
+ *   source; resolution (cloud URL vs branch lookup) is the backend's concern.
+ */
+export interface PrSnapshotBackend {
+  fetch(tasks: TaskPrRef[]): Promise<TaskPrSnapshot[]>;
+}
+
+// gh is rate-limited and each task is independent network work, so cap how many
+// we resolve at once. Matches the concurrency cap in docs/home-tab.md §9.
+const MAX_CONCURRENCY = 3;
+
+@injectable()
+export class LocalPrSnapshotBackend implements PrSnapshotBackend {
+  constructor(
+    @inject(MAIN_TOKENS.GitService)
+    private readonly git: GitService,
+  ) {}
+
+  async fetch(tasks: TaskPrRef[]): Promise<TaskPrSnapshot[]> {
+    const queue = [...tasks];
+    const out: TaskPrSnapshot[] = [];
+
+    const worker = async (): Promise<void> => {
+      for (let ref = queue.shift(); ref; ref = queue.shift()) {
+        const snapshot = await this.git
+          .getTaskPrSnapshot(ref.taskId, ref.cloudPrUrl)
+          .catch(() => null);
+        if (snapshot) out.push({ taskId: ref.taskId, snapshot });
+      }
+    };
+
+    await Promise.all(
+      Array.from({ length: Math.min(MAX_CONCURRENCY, queue.length) }, worker),
+    );
+    return out;
+  }
+}
+
+/**
+ * Stub for the production path. Implemented when PostHog owns PR polling:
+ * call the auth'd API, validate the response with `taskPrSnapshot`, return it.
+ * Flipping the DI binding to this is the entire client-side migration.
+ */
+@injectable()
+export class CloudPrSnapshotBackend implements PrSnapshotBackend {
+  async fetch(): Promise<TaskPrSnapshot[]> {
+    throw new Error(
+      "CloudPrSnapshotBackend not implemented yet — see docs/workflow-architecture.md",
+    );
+  }
+}
diff --git a/apps/code/src/main/services/pr-snapshot/service.ts b/apps/code/src/main/services/pr-snapshot/service.ts
new file mode 100644
index 0000000000..94ea7ba0a6
--- /dev/null
+++ b/apps/code/src/main/services/pr-snapshot/service.ts
@@ -0,0 +1,124 @@
+import { MAIN_TOKENS } from "@main/di/tokens";
+import { logger } from "@main/utils/logger";
+import { TypedEventEmitter } from "@main/utils/typed-event-emitter";
+import {
+  type PrSnapshot,
+  PrSnapshotEvent,
+  type PrSnapshotEvents,
+  type TaskPrRef,
+  type TaskPrSnapshot,
+} from "@shared/types/pr-snapshot";
+import { inject, injectable, postConstruct } from "inversify";
+import type { PrSnapshotBackend } from "./backend";
+
+const log = logger.scope("pr-snapshot");
+
+// How often the tracked tasks are re-polled. The renderer registers the tasks
+// it cares about via getSnapshots; this loop keeps them fresh in the
+// background. The production worker owns this cadence server-side.
+const POLL_INTERVAL_MS = 3 * 60 * 1000;
+
+/**
+ * Owns the PR-snapshot lifecycle: which tasks to watch, their cached CI/review
+ * state, the refresh loop, and the `Updated` event the renderer subscribes to.
+ * Resolution + acquisition live behind {@link PrSnapshotBackend} so this
+ * service is the same code whether snapshots come from the local gh CLI or,
+ * later, a PostHog realtime feed (docs/workflow-architecture.md §5).
+ */
+@injectable()
+export class PrSnapshotService extends TypedEventEmitter<PrSnapshotEvents> {
+  private readonly cache = new Map<string, PrSnapshot>();
+  private readonly tracked = new Map<string, TaskPrRef>();
+  private inflight: Promise<void> | null = null;
+
+  constructor(
+    @inject(MAIN_TOKENS.PrSnapshotBackend)
+    private readonly backend: PrSnapshotBackend,
+  ) {
+    super();
+  }
+
+  @postConstruct()
+  init(): void {
+    const timer = setInterval(() => {
+      void this.refresh().catch((error) => {
+        log.warn("Scheduled PR snapshot refresh failed", { error });
+      });
+    }, POLL_INTERVAL_MS);
+    // Don't keep the process alive for the poll loop.
+    timer.unref?.();
+  }
+
+  /**
+   * Returns the current snapshots for the requested tasks, marking them tracked
+   * for future polls. Tasks not yet cached are resolved inline so first paint
+   * has real data; the rest come from cache and stay fresh via the poll loop.
+   */
+  async getSnapshots(tasks: TaskPrRef[]): Promise<TaskPrSnapshot[]> {
+    for (const ref of tasks) this.tracked.set(ref.taskId, ref);
+
+    const missing = tasks.filter((ref) => !this.cache.has(ref.taskId));
+    if (missing.length > 0) await this.runRefresh(missing);
+
+    const out: TaskPrSnapshot[] = [];
+    for (const ref of tasks) {
+      const snapshot = this.cache.get(ref.taskId);
+      if (snapshot) out.push({ taskId: ref.taskId, snapshot });
+    }
+    return out;
+  }
+
+  /**
+   * Re-resolve the given tasks (or every tracked task), update the cache, and
+   * emit only those that materially changed. Concurrent full refreshes dedupe
+   * onto one in-flight run.
+   */
+  async refresh(tasks?: TaskPrRef[]): Promise<void> {
+    const refs = tasks ?? [...this.tracked.values()];
+    if (refs.length === 0) return;
+
+    if (!tasks && this.inflight) return this.inflight;
+
+    const run = this.runRefresh(refs);
+    if (!tasks) {
+      this.inflight = run.finally(() => {
+        this.inflight = null;
+      });
+      return this.inflight;
+    }
+    return run;
+  }
+
+  private async runRefresh(refs: TaskPrRef[]): Promise<void> {
+    const fresh = await this.backend.fetch(refs);
+    const changed: TaskPrSnapshot[] = [];
+
+    for (const { taskId, snapshot } of fresh) {
+      const previous = this.cache.get(taskId);
+      if (!previous || hasMaterialChange(previous, snapshot)) {
+        changed.push({ taskId, snapshot });
+      }
+      this.cache.set(taskId, snapshot);
+    }
+
+    if (changed.length > 0) {
+      this.emit(PrSnapshotEvent.Updated, changed);
+      log.info("PR snapshots updated", { count: changed.length });
+    }
+  }
+}
+
+// Ignore churn (e.g. a bumped `lastUpdatedAt` with no state change) so we don't
+// re-render the home tab for nothing — only the fields the classifier reads.
+function hasMaterialChange(a: PrSnapshot, b: PrSnapshot): boolean {
+  return (
+    a.url !== b.url ||
+    a.state !== b.state ||
+    a.ciStatus !== b.ciStatus ||
+    a.reviewDecision !== b.reviewDecision ||
+    a.unresolvedThreads !== b.unresolvedThreads ||
+    a.mergeable !== b.mergeable ||
+    a.isCurrentUserRequestedReviewer !== b.isCurrentUserRequestedReviewer ||
+    a.title !== b.title
+  );
+}
diff --git a/apps/code/src/main/trpc/router.ts b/apps/code/src/main/trpc/router.ts
index 53449b0297..55099545c9 100644
--- a/apps/code/src/main/trpc/router.ts
+++ b/apps/code/src/main/trpc/router.ts
@@ -26,6 +26,7 @@ import { mcpCallbackRouter } from "./routers/mcp-callback";
 import { notificationRouter } from "./routers/notification";
 import { oauthRouter } from "./routers/oauth";
 import { osRouter } from "./routers/os";
+import { prSnapshotRouter } from "./routers/pr-snapshot";
 import { processTrackingRouter } from "./routers/process-tracking";
 import { provisioningRouter } from "./routers/provisioning";
 import { secureStoreRouter } from "./routers/secure-store";
@@ -70,6 +71,7 @@ export const trpcRouter = router({
   oauth: oauthRouter,
   logs: logsRouter,
   os: osRouter,
+  prSnapshot: prSnapshotRouter,
   processTracking: processTrackingRouter,
   provisioning: provisioningRouter,
   sleep: sleepRouter,
diff --git a/apps/code/src/main/trpc/routers/pr-snapshot.ts b/apps/code/src/main/trpc/routers/pr-snapshot.ts
new file mode 100644
index 0000000000..e4a69d619f
--- /dev/null
+++ b/apps/code/src/main/trpc/routers/pr-snapshot.ts
@@ -0,0 +1,35 @@
+import {
+  getPrSnapshotsInput,
+  PrSnapshotEvent,
+  type PrSnapshotEvents,
+  refreshPrSnapshotsInput,
+  taskPrSnapshotArray,
+} from "@shared/types/pr-snapshot";
+import { container } from "../../di/container";
+import { MAIN_TOKENS } from "../../di/tokens";
+import type { PrSnapshotService } from "../../services/pr-snapshot/service";
+import { publicProcedure, router } from "../trpc";
+
+const getService = () =>
+  container.get<PrSnapshotService>(MAIN_TOKENS.PrSnapshotService);
+
+function subscribe<K extends keyof PrSnapshotEvents>(event: K) {
+  return publicProcedure.subscription(async function* (opts) {
+    const service = getService();
+    const iterable = service.toIterable(event, { signal: opts.signal });
+    for await (const data of iterable) {
+      yield data;
+    }
+  });
+}
+
+export const prSnapshotRouter = router({
+  getSnapshots: publicProcedure
+    .input(getPrSnapshotsInput)
+    .output(taskPrSnapshotArray)
+    .query(({ input }) => getService().getSnapshots(input.tasks)),
+  refresh: publicProcedure
+    .input(refreshPrSnapshotsInput)
+    .mutation(({ input }) => getService().refresh(input.tasks)),
+  onUpdated: subscribe(PrSnapshotEvent.Updated),
+});
diff --git a/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
index 5825bdd47b..ac4bf53bba 100644
--- a/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
@@ -3,6 +3,7 @@ import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
 import { useNavigationStore } from "@stores/navigationStore";
 import { formatRelativeTimeShort } from "@utils/time";
+import { useMemo } from "react";
 import type { HomeActiveAgent } from "../utils/buildSnapshot";
 
 interface HomeActiveAgentsStripProps {
@@ -12,25 +13,32 @@ interface HomeActiveAgentsStripProps {
 export function HomeActiveAgentsStrip({ agents }: HomeActiveAgentsStripProps) {
   const { data: tasks = [] } = useTasks();
   const navigateToTask = useNavigationStore((s) => s.navigateToTask);
+  const taskById = useMemo(() => new Map(tasks.map((t) => [t.id, t])), [tasks]);
 
   if (agents.length === 0) return null;
 
   return (
-    <Box className="border-(--gray-4) border-b px-5 py-3">
+    <Box className="border-(--gray-3) border-b px-4 py-3">
       <Flex align="center" gap="2" mb="2">
         <CircleNotch
-          size={12}
-          className="animate-spin text-(--gray-10)"
+          size={13}
+          className="animate-spin text-(--green-11)"
           weight="bold"
         />
-        <Text className="font-medium text-(--gray-11) text-[11px] uppercase tracking-wide">
-          Running ({agents.length})
+        <Text className="font-semibold text-[12px] text-gray-12">Running</Text>
+        <Text className="rounded-full bg-(--gray-a3) px-1.5 py-px font-medium text-(--gray-11) text-[10.5px] tabular-nums">
+          {agents.length}
         </Text>
       </Flex>
       <ScrollArea scrollbars="horizontal">
         <Flex gap="2" className="pb-1">
           {agents.map((agent) => {
-            const task = tasks.find((t) => t.id === agent.taskId);
+            const task = taskById.get(agent.taskId);
+            const dotColor = agent.needsPermission
+              ? "var(--amber-9)"
+              : agent.status === "queued"
+                ? "var(--gray-8)"
+                : "var(--green-9)";
             return (
               <button
                 key={agent.taskId}
@@ -38,32 +46,43 @@ export function HomeActiveAgentsStrip({ agents }: HomeActiveAgentsStripProps) {
                 onClick={() => {
                   if (task) navigateToTask(task);
                 }}
-                className="group flex min-w-[260px] max-w-[320px] shrink-0 cursor-pointer flex-col items-start gap-1 rounded-md border border-(--gray-4) bg-(--gray-2) px-3 py-2 text-left hover:border-(--gray-6) hover:bg-(--gray-3)"
+                className="group hover:-translate-y-px flex min-w-[260px] max-w-[320px] shrink-0 cursor-pointer flex-col items-start gap-1.5 rounded-lg border border-(--gray-4) bg-(--color-panel-solid) px-3 py-2.5 text-left transition-all hover:border-(--gray-7) hover:shadow-sm"
               >
                 <Flex
                   align="center"
-                  gap="1"
+                  gap="2"
                   justify="between"
                   className="w-full"
                 >
-                  <Text
-                    className="truncate font-medium text-[13px] text-gray-12 leading-tight"
-                    title={agent.title}
-                  >
-                    {agent.title || "Untitled task"}
-                  </Text>
-                  <Text className="shrink-0 text-(--gray-10) text-[11px]">
+                  <Flex align="center" gap="2" className="min-w-0">
+                    <span
+                      className="inline-block h-2 w-2 shrink-0 animate-pulse rounded-full"
+                      style={{ backgroundColor: dotColor }}
+                    />
+                    <Text
+                      className="truncate font-medium text-[13px] text-gray-12 leading-tight"
+                      title={agent.title}
+                    >
+                      {agent.title || "Untitled task"}
+                    </Text>
+                  </Flex>
+                  <Text className="shrink-0 text-(--gray-9) text-[11px]">
                     {formatRelativeTimeShort(agent.lastActivityAt)}
                   </Text>
                 </Flex>
                 <Flex
                   align="center"
                   gap="2"
-                  className="w-full text-(--gray-10) text-[11px]"
+                  className="w-full pl-4 text-(--gray-10) text-[11px]"
                 >
+                  {agent.repoName ? (
+                    <span className="shrink-0 text-(--gray-11)">
+                      {agent.repoName}
+                    </span>
+                  ) : null}
                   {agent.branch ? (
                     <Flex align="center" gap="1" className="min-w-0">
-                      <GitBranch size={10} />
+                      <GitBranch size={10} className="shrink-0" />
                       <span className="truncate" title={agent.branch}>
                         {agent.branch}
                       </span>
@@ -73,7 +92,7 @@ export function HomeActiveAgentsStrip({ agents }: HomeActiveAgentsStripProps) {
                     <Flex
                       align="center"
                       gap="1"
-                      className="text-(--amber-11)"
+                      className="shrink-0 text-(--amber-11)"
                       title="Waiting on permission"
                     >
                       <Warning size={10} weight="fill" />
diff --git a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
index 67341a2f81..ce9191a338 100644
--- a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
@@ -1,6 +1,8 @@
-import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
-import { buildBoardColumns } from "../utils/boardColumns";
+import { ScrollArea } from "@radix-ui/themes";
+import type { SituationId } from "@shared/types/workflow";
+import { buildBoardColumns, type HomeBoardColumn } from "../utils/boardColumns";
 import type { HomeSnapshot } from "../utils/buildSnapshot";
+import { SITUATION_VISUAL, situationCss } from "../utils/situationDisplay";
 import { HomeWorkstreamCard } from "./HomeWorkstreamCard";
 
 interface HomeBoardViewProps {
@@ -15,50 +17,65 @@ export function HomeBoardView({ snapshot }: HomeBoardViewProps) {
 
   return (
     <ScrollArea scrollbars="horizontal">
-      <Flex gap="3" className="h-full min-h-0 p-4">
+      <div className="flex h-full min-h-0 gap-3 p-4">
         {columns.map((column) => (
-          <Flex
-            key={column.id}
-            direction="column"
-            className="min-h-0 w-[300px] shrink-0"
-          >
-            <Box className="mb-2">
-              <Flex align="baseline" justify="between" gap="2">
-                <Text className="font-semibold text-[12px] text-gray-12 uppercase tracking-wide">
-                  {column.title}
-                </Text>
-                <Text className="text-(--gray-10) text-[11px]">
-                  {column.workstreams.length}
-                </Text>
-              </Flex>
-              <Text className="text-(--gray-10) text-[11px]">
-                {column.description}
-              </Text>
-            </Box>
-            <Flex
-              direction="column"
-              gap="2"
-              className="min-h-[120px] rounded-md bg-(--gray-2) p-2"
-            >
-              {column.workstreams.length === 0 ? (
-                <Flex
-                  align="center"
-                  justify="center"
-                  className="h-[100px] rounded-md border border-(--gray-4) border-dashed"
-                >
-                  <Text className="text-(--gray-9) text-[11px]">
-                    Nothing here
-                  </Text>
-                </Flex>
-              ) : (
-                column.workstreams.map((ws) => (
-                  <HomeWorkstreamCard key={ws.id} workstream={ws} />
-                ))
-              )}
-            </Flex>
-          </Flex>
+          <BoardColumn key={column.id} column={column} />
         ))}
-      </Flex>
+      </div>
     </ScrollArea>
   );
 }
+
+function BoardColumn({ column }: { column: HomeBoardColumn }) {
+  const v = SITUATION_VISUAL[column.id];
+  const c = situationCss(v.color);
+  const Icon = v.Icon;
+  const count = column.workstreams.length;
+
+  return (
+    <div className="flex h-full min-h-0 w-[300px] shrink-0 flex-col">
+      <div className="mb-2 flex items-center gap-2 px-1" title={v.description}>
+        <span style={{ color: c.fg }}>
+          <Icon size={14} weight="bold" />
+        </span>
+        <span className="font-semibold text-[12px] text-gray-12">
+          {v.label}
+        </span>
+        <span
+          className="rounded-full px-1.5 py-px font-semibold text-[10.5px] tabular-nums"
+          style={{ color: c.fg, backgroundColor: c.tint }}
+        >
+          {count}
+        </span>
+      </div>
+
+      <div
+        className="min-h-0 flex-1 rounded-xl border border-(--gray-3)"
+        style={{ backgroundColor: c.wash }}
+      >
+        <ScrollArea scrollbars="vertical">
+          <div className="flex flex-col gap-2 p-2">
+            {count === 0 ? (
+              <EmptyColumn sid={column.id} />
+            ) : (
+              column.workstreams.map((ws) => (
+                <HomeWorkstreamCard key={ws.id} workstream={ws} />
+              ))
+            )}
+          </div>
+        </ScrollArea>
+      </div>
+    </div>
+  );
+}
+
+function EmptyColumn({ sid }: { sid: SituationId }) {
+  const v = SITUATION_VISUAL[sid];
+  const Icon = v.Icon;
+  return (
+    <div className="flex flex-col items-center justify-center gap-1.5 rounded-lg border border-(--gray-a5) border-dashed py-10">
+      <Icon size={18} className="text-(--gray-8)" />
+      <span className="text-(--gray-9) text-[11px]">Nothing here</span>
+    </div>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/components/HomeEmptyState.tsx b/apps/code/src/renderer/features/home/components/HomeEmptyState.tsx
index b140e27cb4..ae2cb2ab37 100644
--- a/apps/code/src/renderer/features/home/components/HomeEmptyState.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeEmptyState.tsx
@@ -18,8 +18,14 @@ export function HomeEmptyState({ hasRunningAgents }: HomeEmptyStateProps) {
       gap="3"
       className="h-full px-5 py-12"
     >
-      <CheckCircle size={36} className="text-(--green-9)" weight="duotone" />
-      <Text className="font-medium text-[15px] text-gray-12">
+      <Flex
+        align="center"
+        justify="center"
+        className="h-14 w-14 rounded-full bg-(--green-a3)"
+      >
+        <CheckCircle size={30} className="text-(--green-11)" weight="fill" />
+      </Flex>
+      <Text className="font-semibold text-[16px] text-gray-12">
         You're caught up
       </Text>
       <Text className="max-w-[360px] text-center text-(--gray-11) text-[13px]">
diff --git a/apps/code/src/renderer/features/home/components/HomeView.tsx b/apps/code/src/renderer/features/home/components/HomeView.tsx
index 32a679fc87..40ac12058c 100644
--- a/apps/code/src/renderer/features/home/components/HomeView.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeView.tsx
@@ -1,6 +1,7 @@
 import { DotsCircleSpinner } from "@components/DotsCircleSpinner";
 import { useSetHeaderContent } from "@hooks/useSetHeaderContent";
 import {
+  CircleHalf,
   Flask,
   Graph,
   House,
@@ -96,15 +97,10 @@ export function HomeView() {
       null)
     : null;
 
-  const summary = [
-    needsAttention.length > 0
-      ? `${needsAttention.length} need${needsAttention.length === 1 ? "s" : ""} attention`
-      : null,
-    activeAgents.length > 0 ? `${activeAgents.length} running` : null,
-    inProgress.length > 0 ? `${inProgress.length} in progress` : null,
-  ]
-    .filter(Boolean)
-    .join(" · ");
+  const hasStats =
+    needsAttention.length > 0 ||
+    activeAgents.length > 0 ||
+    inProgress.length > 0;
 
   return (
     <Flex direction="column" className="h-full">
@@ -124,9 +120,33 @@ export function HomeView() {
                 </Badge>
               ) : null}
             </Flex>
-            <Text className="text-(--gray-11) text-[12px]">
-              {summary || "You're caught up"}
-            </Text>
+            {hasStats ? (
+              <Flex align="center" gap="3" className="text-[12px]">
+                {needsAttention.length > 0 ? (
+                  <Stat
+                    color="var(--amber-9)"
+                    label={`${needsAttention.length} need${needsAttention.length === 1 ? "s" : ""} attention`}
+                  />
+                ) : null}
+                {activeAgents.length > 0 ? (
+                  <Stat
+                    color="var(--green-9)"
+                    label={`${activeAgents.length} running`}
+                    pulse
+                  />
+                ) : null}
+                {inProgress.length > 0 ? (
+                  <Stat
+                    color="var(--blue-9)"
+                    label={`${inProgress.length} in progress`}
+                  />
+                ) : null}
+              </Flex>
+            ) : (
+              <Text className="text-(--gray-11) text-[12px]">
+                You're caught up
+              </Text>
+            )}
           </Flex>
           <Flex align="center" gap="2" className="shrink-0">
             <ViewModeToggle value={viewMode} onChange={setViewMode} />
@@ -156,13 +176,13 @@ export function HomeView() {
                   <HomeBoardView snapshot={snapshot} />
                 </Box>
               ) : (
-                <ScrollArea>
+                <ScrollArea scrollbars="vertical">
                   {needsAttention.length > 0 ? (
                     <Section
                       title="Needs attention"
                       icon={
                         <Warning
-                          size={12}
+                          size={13}
                           weight="fill"
                           className="text-(--amber-11)"
                         />
@@ -176,7 +196,17 @@ export function HomeView() {
                   ) : null}
 
                   {inProgress.length > 0 ? (
-                    <Section title="In progress" count={inProgress.length}>
+                    <Section
+                      title="In progress"
+                      icon={
+                        <CircleHalf
+                          size={13}
+                          weight="fill"
+                          className="text-(--blue-11)"
+                        />
+                      }
+                      count={inProgress.length}
+                    >
                       {inProgress.map((ws) => (
                         <HomeWorkstreamRow key={ws.id} workstream={ws} />
                       ))}
@@ -286,19 +316,39 @@ function ViewModeToggle({ value, onChange }: ViewModeToggleProps) {
   );
 }
 
+function Stat({
+  color,
+  label,
+  pulse = false,
+}: {
+  color: string;
+  label: string;
+  pulse?: boolean;
+}) {
+  return (
+    <Flex align="center" gap="1.5">
+      <span
+        className={`inline-block h-2 w-2 rounded-full ${pulse ? "animate-pulse" : ""}`}
+        style={{ backgroundColor: color }}
+      />
+      <Text className="text-(--gray-11) text-[12px]">{label}</Text>
+    </Flex>
+  );
+}
+
 function Section({ title, count, icon, children }: SectionProps) {
   return (
     <Box>
       <Flex
         align="center"
         gap="2"
-        className="border-(--gray-4) border-b bg-(--gray-2) px-5 py-2"
+        className="sticky top-0 z-10 border-(--gray-3) border-b bg-(--color-panel-solid) px-4 py-2"
       >
         {icon}
-        <Text className="font-medium text-(--gray-11) text-[11px] uppercase tracking-wide">
-          {title}
+        <Text className="font-semibold text-[12px] text-gray-12">{title}</Text>
+        <Text className="rounded-full bg-(--gray-a3) px-1.5 py-px font-medium text-(--gray-11) text-[10.5px] tabular-nums">
+          {count}
         </Text>
-        <Text className="text-(--gray-10) text-[11px]">({count})</Text>
       </Flex>
       {children}
     </Box>
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
index 41ce4ece3a..6c41bceb63 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
@@ -1,62 +1,43 @@
-import {
-  CaretDown,
-  CheckCircle,
-  GitBranch,
-  Sparkle,
-  Warning,
-  XCircle,
-} from "@phosphor-icons/react";
+import { GitBranch, GitPullRequest, Sparkle } from "@phosphor-icons/react";
 import { Button } from "@posthog/quill";
-import { Box, DropdownMenu, Flex, Text } from "@radix-ui/themes";
-import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
-import { useNavigationStore } from "@stores/navigationStore";
-import { openUrlInBrowser } from "@utils/browser";
+import { Box, Flex, Text } from "@radix-ui/themes";
 import { formatRelativeTimeShort } from "@utils/time";
-import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
-import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
+import { useWorkstreamPresentation } from "../hooks/useWorkstreamPresentation";
 import { useHomeUiStore } from "../stores/homeUiStore";
-import type { HomePullRequest, HomeWorkstream } from "../utils/buildSnapshot";
-import {
-  severityRingClass,
-  situationSeverity,
-} from "../utils/situationDisplay";
+import type { HomeWorkstream } from "../utils/buildSnapshot";
+import { SITUATION_VISUAL } from "../utils/situationDisplay";
 import { SituationChip } from "./SituationChip";
+import {
+  AuthorAvatar,
+  CiIndicator,
+  type MetaItem,
+  MetaList,
+  WorkstreamOverflowMenu,
+} from "./WorkstreamBits";
 
 interface HomeWorkstreamCardProps {
   workstream: HomeWorkstream;
 }
 
-function CiDot({ status }: { status: HomePullRequest["ciStatus"] }) {
-  if (status === "passing") {
-    return (
-      <span title="CI passing">
-        <CheckCircle size={11} weight="fill" className="text-(--green-9)" />
-      </span>
-    );
-  }
-  if (status === "failing") {
-    return (
-      <span title="CI failing">
-        <XCircle size={11} weight="fill" className="text-(--red-9)" />
-      </span>
-    );
-  }
-  if (status === "pending") {
-    return (
-      <span
-        className="inline-block h-[8px] w-[8px] animate-pulse rounded-full bg-(--amber-9)"
-        title="CI pending"
-      />
-    );
-  }
-  return null;
-}
-
 export function HomeWorkstreamCard({ workstream }: HomeWorkstreamCardProps) {
-  const { data: tasks = [] } = useTasks();
-  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
-  const boundActions = useBoundActions(workstream);
-  const runAction = useRunWorkstreamAction();
+  const {
+    pr,
+    title,
+    primarySid,
+    accent,
+    author,
+    extraSituations,
+    primaryBound,
+    restBound,
+    primaryIsPr,
+    primaryIsTask,
+    showPrInMenu,
+    showTaskInMenu,
+    hasMenu,
+    runAction,
+    openTask,
+    openPr,
+  } = useWorkstreamPresentation(workstream);
   const setSelectedWorkstreamId = useHomeUiStore(
     (s) => s.setSelectedWorkstreamId,
   );
@@ -64,28 +45,31 @@ export function HomeWorkstreamCard({ workstream }: HomeWorkstreamCardProps) {
     (s) => s.selectedWorkstreamId === workstream.id,
   );
 
-  const headTask = workstream.tasks[0];
-  const pr = workstream.pr;
-  const title =
-    pr?.title ?? headTask?.title ?? workstream.branch ?? "Workstream";
   const taskCount = workstream.tasks.length;
-  const severity = situationSeverity(workstream.situations);
-  const primaryBound = boundActions[0] ?? null;
-  const overflowBound = boundActions.slice(1);
+  const primary = SITUATION_VISUAL[primarySid];
+  const PrimaryIcon = primary.Icon;
 
-  function handleRunAction(action: BoundAction) {
-    runAction(action, workstream);
+  const meta: MetaItem[] = [];
+  if (workstream.branch) {
+    meta.push({
+      key: "branch",
+      node: (
+        <span className="inline-flex min-w-0 items-center gap-1">
+          <GitBranch size={11} className="shrink-0" />
+          <span className="max-w-[150px] truncate" title={workstream.branch}>
+            {workstream.branch}
+          </span>
+        </span>
+      ),
+    });
   }
-
-  function handleOpenTask() {
-    if (!headTask) return;
-    const task = tasks.find((t) => t.id === headTask.id);
-    if (task) navigateToTask(task);
-  }
-
-  function handleOpenPr() {
-    if (workstream.prUrl) void openUrlInBrowser(workstream.prUrl);
+  if (pr) {
+    meta.push({ key: "pr", node: <span>#{pr.number}</span> });
   }
+  meta.push({
+    key: "time",
+    node: <span>{formatRelativeTimeShort(workstream.lastActivityAt)}</span>,
+  });
 
   return (
     <Box
@@ -99,137 +83,102 @@ export function HomeWorkstreamCard({ workstream }: HomeWorkstreamCardProps) {
       role="button"
       tabIndex={0}
       aria-label={`Open ${title}`}
-      className={`cursor-pointer rounded-md border border-(--gray-4) bg-(--color-panel-solid) p-3 transition-colors hover:border-(--gray-6) hover:shadow-sm ${
-        isSelected ? "border-(--accent-9) ring-(--accent-7) ring-2" : ""
-      } ${severityRingClass(severity)}`}
+      className="group hover:-translate-y-px relative flex cursor-pointer flex-col gap-2 overflow-hidden rounded-lg border border-(--gray-4) bg-(--color-panel-solid) px-3 pt-3 pb-2.5 transition-all hover:border-(--gray-7) hover:shadow-md"
+      style={
+        isSelected
+          ? {
+              borderColor: "var(--accent-8)",
+              boxShadow: "0 0 0 1px var(--accent-8)",
+            }
+          : undefined
+      }
     >
-      <Flex direction="column" gap="2">
-        <Flex align="start" justify="between" gap="2">
-          <Text
-            className="line-clamp-2 font-medium text-[13px] text-gray-12 leading-tight"
-            title={title}
-          >
-            {title}
-          </Text>
-          {pr ? <CiDot status={pr.ciStatus} /> : null}
-        </Flex>
+      <span
+        aria-hidden
+        className="absolute inset-x-0 top-0 h-[3px]"
+        style={{ backgroundColor: accent.solid }}
+      />
 
-        <Flex
-          align="center"
-          gap="2"
-          wrap="wrap"
-          className="text-(--gray-10) text-[11px]"
+      <div className="flex items-center justify-between gap-2">
+        <span
+          className="inline-flex min-w-0 items-center gap-1.5 font-semibold text-[11px]"
+          style={{ color: accent.fg }}
+          title={primary.description}
         >
-          {workstream.repoName ? (
-            <Text title="Repository">{workstream.repoName}</Text>
-          ) : null}
-          {workstream.branch ? (
-            <Flex align="center" gap="1" className="min-w-0">
-              <GitBranch size={10} />
-              <span
-                className="max-w-[140px] truncate"
-                title={workstream.branch}
-              >
-                {workstream.branch}
-              </span>
-            </Flex>
-          ) : null}
-          {pr ? <Text>#{pr.number}</Text> : null}
-          <Text>{formatRelativeTimeShort(workstream.lastActivityAt)}</Text>
-        </Flex>
+          <PrimaryIcon size={13} weight="bold" className="shrink-0" />
+          <span className="truncate">{primary.label}</span>
+        </span>
+        <div className="flex shrink-0 items-center gap-2">
+          {author ? <AuthorAvatar login={author} /> : null}
+          {pr ? <CiIndicator status={pr.ciStatus} /> : null}
+        </div>
+      </div>
 
-        {workstream.situations.length > 0 ? (
-          <Flex align="center" gap="1" wrap="wrap">
-            {workstream.situations.map((sid) => (
-              <SituationChip key={sid} sid={sid} />
-            ))}
-          </Flex>
-        ) : null}
+      <span
+        className="line-clamp-2 font-medium text-[13px] text-gray-12 leading-snug"
+        title={title}
+      >
+        {title}
+      </span>
 
-        {pr?.reviewDecision === "changes_requested" ? (
-          <Flex
-            align="center"
-            gap="1"
-            className="text-(--amber-11) text-[11px]"
-          >
-            <Warning size={11} weight="fill" />
-            <span>Changes requested</span>
-          </Flex>
-        ) : null}
-        {pr?.reviewDecision === "approved" ? (
-          <Flex
-            align="center"
-            gap="1"
-            className="text-(--green-11) text-[11px]"
+      {extraSituations.length > 0 ? (
+        <div className="flex flex-wrap items-center gap-1">
+          {extraSituations.map((sid) => (
+            <SituationChip key={sid} sid={sid} />
+          ))}
+        </div>
+      ) : null}
+
+      <MetaList items={meta} className="mt-0.5" />
+
+      <Flex
+        align="center"
+        justify="between"
+        className="mt-1.5 gap-2 border-(--gray-3) border-t pt-2.5"
+        onClick={(e) => e.stopPropagation()}
+        onKeyDown={(e) => e.stopPropagation()}
+      >
+        {primaryBound ? (
+          <Button
+            variant="primary"
+            size="xs"
+            onClick={() => runAction(primaryBound)}
+            title={`${primaryBound.situationLabel} → ${primaryBound.skillId}`}
           >
-            <CheckCircle size={11} weight="fill" />
-            <span>Approved</span>
-          </Flex>
-        ) : null}
+            <Sparkle size={11} weight="fill" />
+            {primaryBound.label}
+          </Button>
+        ) : primaryIsPr ? (
+          <Button variant="outline" size="xs" onClick={openPr}>
+            <GitPullRequest size={11} />
+            {author ? "Review PR" : "View PR"}
+          </Button>
+        ) : primaryIsTask ? (
+          <Button variant="outline" size="xs" onClick={openTask}>
+            Open task
+          </Button>
+        ) : (
+          <span />
+        )}
 
-        <Flex
-          align="center"
-          gap="1.5"
-          justify="between"
-          wrap="wrap"
-          onClick={(e) => e.stopPropagation()}
-          onKeyDown={(e) => e.stopPropagation()}
-        >
-          {primaryBound ? (
-            <Flex align="center" gap="1">
-              <Button
-                variant="primary"
-                size="xs"
-                onClick={() => handleRunAction(primaryBound)}
-                title={`${primaryBound.situationLabel} → ${primaryBound.skillId}`}
-              >
-                <Sparkle size={11} />
-                {primaryBound.label}
-              </Button>
-              {overflowBound.length > 0 ? (
-                <DropdownMenu.Root>
-                  <DropdownMenu.Trigger>
-                    <Button
-                      variant="outline"
-                      size="xs"
-                      title={`${overflowBound.length} more quick action${overflowBound.length === 1 ? "" : "s"}`}
-                    >
-                      +{overflowBound.length}
-                      <CaretDown size={9} />
-                    </Button>
-                  </DropdownMenu.Trigger>
-                  <DropdownMenu.Content>
-                    {overflowBound.map((action) => (
-                      <DropdownMenu.Item
-                        key={`${action.situationId}::${action.id}`}
-                        onSelect={() => handleRunAction(action)}
-                      >
-                        <Sparkle size={11} />
-                        {action.label}
-                        <Text className="ml-auto pl-3 text-(--gray-10) text-[10px]">
-                          {action.situationLabel}
-                        </Text>
-                      </DropdownMenu.Item>
-                    ))}
-                  </DropdownMenu.Content>
-                </DropdownMenu.Root>
-              ) : null}
-            </Flex>
-          ) : workstream.prUrl ? (
-            <Button variant="outline" size="xs" onClick={handleOpenPr}>
-              Open PR
-            </Button>
-          ) : (
-            <Button variant="outline" size="xs" onClick={handleOpenTask}>
-              Open task
-            </Button>
-          )}
+        <div className="flex shrink-0 items-center gap-2">
           {taskCount > 1 ? (
             <Text className="text-(--gray-10) text-[11px]">
               {taskCount} tasks
             </Text>
           ) : null}
-        </Flex>
+          {hasMenu ? (
+            <WorkstreamOverflowMenu
+              restBound={restBound}
+              showPrInMenu={showPrInMenu}
+              showTaskInMenu={showTaskInMenu}
+              onRun={runAction}
+              onOpenPr={openPr}
+              onOpenTask={openTask}
+              size="xs"
+            />
+          ) : null}
+        </div>
       </Flex>
     </Box>
   );
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
index b327f176c7..a783c0c875 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
@@ -14,7 +14,7 @@ import {
   XCircle,
 } from "@phosphor-icons/react";
 import { Badge, Button } from "@posthog/quill";
-import { Box, DropdownMenu, Flex, ScrollArea, Text } from "@radix-ui/themes";
+import { Box, DropdownMenu, Flex, Text } from "@radix-ui/themes";
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
 import type { TaskRunStatus } from "@shared/types";
 import { useNavigationStore } from "@stores/navigationStore";
@@ -60,7 +60,7 @@ export function HomeWorkstreamDetailPanel({ workstream, onClose }: Props) {
   return (
     <Flex
       direction="column"
-      className="h-full min-h-0 bg-(--color-panel-solid)"
+      className="h-full min-h-0 w-full min-w-0 overflow-hidden bg-(--color-panel-solid)"
     >
       {/* Header */}
       <Flex
@@ -71,7 +71,7 @@ export function HomeWorkstreamDetailPanel({ workstream, onClose }: Props) {
       >
         <Flex direction="column" gap="1" className="min-w-0 flex-1">
           <Text
-            className="font-semibold text-[13px] text-gray-12 leading-snug"
+            className="line-clamp-2 break-words font-semibold text-[13px] text-gray-12 leading-snug"
             title={title}
           >
             {title}
@@ -100,8 +100,8 @@ export function HomeWorkstreamDetailPanel({ workstream, onClose }: Props) {
         </Button>
       </Flex>
 
-      <ScrollArea>
-        <Flex direction="column" gap="4" className="px-4 py-4">
+      <div className="scrollbar-overlay-y min-h-0 flex-1 overflow-x-hidden">
+        <Flex direction="column" gap="4" className="min-w-0 px-4 py-4">
           {workstream.situations.length > 0 ? (
             <Section title="Situations">
               <Flex gap="1" wrap="wrap">
@@ -175,7 +175,7 @@ export function HomeWorkstreamDetailPanel({ workstream, onClose }: Props) {
             </Flex>
           </Section>
         </Flex>
-      </ScrollArea>
+      </div>
 
       {/* Footer links */}
       {workstream.prUrl ? (
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
index 24953d1c04..04878b6430 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
@@ -1,6 +1,4 @@
 import {
-  ArrowSquareOut,
-  CaretDown,
   ChatCircle,
   GitBranch,
   GitPullRequest,
@@ -8,30 +6,44 @@ import {
   Warning,
 } from "@phosphor-icons/react";
 import { Button } from "@posthog/quill";
-import { Box, DropdownMenu, Flex, Text } from "@radix-ui/themes";
-import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
-import { useNavigationStore } from "@stores/navigationStore";
-import { openUrlInBrowser } from "@utils/browser";
+import { Box, Flex, Text } from "@radix-ui/themes";
 import { formatRelativeTimeShort } from "@utils/time";
-import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
-import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
+import { useWorkstreamPresentation } from "../hooks/useWorkstreamPresentation";
 import { useHomeUiStore } from "../stores/homeUiStore";
 import type { HomeWorkstream } from "../utils/buildSnapshot";
-import {
-  severityRingClass,
-  situationSeverity,
-} from "../utils/situationDisplay";
 import { SituationChip } from "./SituationChip";
+import {
+  AuthorAvatar,
+  CiIndicator,
+  type MetaItem,
+  MetaList,
+  StatusGlyph,
+  WorkstreamOverflowMenu,
+} from "./WorkstreamBits";
 
 interface HomeWorkstreamRowProps {
   workstream: HomeWorkstream;
 }
 
 export function HomeWorkstreamRow({ workstream }: HomeWorkstreamRowProps) {
-  const { data: tasks = [] } = useTasks();
-  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
-  const boundActions = useBoundActions(workstream);
-  const runAction = useRunWorkstreamAction();
+  const {
+    pr,
+    title,
+    primarySid,
+    accent,
+    author,
+    extraSituations,
+    primaryBound,
+    restBound,
+    primaryIsPr,
+    primaryIsTask,
+    showPrInMenu,
+    showTaskInMenu,
+    hasMenu,
+    runAction,
+    openTask,
+    openPr,
+  } = useWorkstreamPresentation(workstream);
   const setSelectedWorkstreamId = useHomeUiStore(
     (s) => s.setSelectedWorkstreamId,
   );
@@ -39,25 +51,59 @@ export function HomeWorkstreamRow({ workstream }: HomeWorkstreamRowProps) {
     (s) => s.selectedWorkstreamId === workstream.id,
   );
 
-  const headTask = workstream.tasks[0];
-  const title = headTask?.title ?? workstream.branch ?? "Workstream";
-  const taskCount = workstream.tasks.length;
-  const severity = situationSeverity(workstream.situations);
-  const inlineActions = boundActions.slice(0, 2);
-  const overflowActions = boundActions.slice(2);
+  const generating = workstream.tasks.some((t) => t.isGenerating);
+  const awaitingPermission = workstream.tasks.some((t) => t.needsPermission);
 
-  function handleRunAction(action: BoundAction) {
-    runAction(action, workstream);
+  const meta: MetaItem[] = [];
+  if (workstream.repoName) {
+    meta.push({
+      key: "repo",
+      node: <span className="text-(--gray-11)">{workstream.repoName}</span>,
+    });
   }
-
-  function handleOpenTask() {
-    if (!headTask) return;
-    const task = tasks.find((t) => t.id === headTask.id);
-    if (task) navigateToTask(task);
+  if (workstream.branch) {
+    meta.push({
+      key: "branch",
+      node: (
+        <span className="inline-flex min-w-0 items-center gap-1">
+          <GitBranch size={11} className="shrink-0" />
+          <span className="max-w-[200px] truncate" title={workstream.branch}>
+            {workstream.branch}
+          </span>
+        </span>
+      ),
+    });
   }
-
-  function handleOpenPr() {
-    if (workstream.prUrl) void openUrlInBrowser(workstream.prUrl);
+  if (pr) {
+    meta.push({ key: "pr", node: <span>#{pr.number}</span> });
+  }
+  if (pr && pr.ciStatus !== "passing" && pr.ciStatus !== "none") {
+    meta.push({
+      key: "ci",
+      node: <CiIndicator status={pr.ciStatus} showLabel />,
+    });
+  }
+  if (awaitingPermission) {
+    meta.push({
+      key: "perm",
+      node: (
+        <span className="inline-flex items-center gap-1 text-(--amber-11)">
+          <Warning size={11} weight="fill" />
+          Awaiting permission
+        </span>
+      ),
+    });
+  }
+  if (generating) {
+    meta.push({
+      key: "gen",
+      node: (
+        <span className="inline-flex items-center gap-1 text-(--accent-11)">
+          <ChatCircle size={11} />
+          Generating
+        </span>
+      ),
+    });
   }
 
   return (
@@ -72,121 +118,77 @@ export function HomeWorkstreamRow({ workstream }: HomeWorkstreamRowProps) {
       role="button"
       tabIndex={0}
       aria-label={`Open ${title}`}
-      className={`cursor-pointer border-(--gray-4) border-b px-5 py-3 transition-colors hover:bg-(--gray-2) ${
-        isSelected ? "bg-(--accent-3)" : ""
-      } ${severityRingClass(severity)}`}
+      className="group relative flex cursor-pointer items-center gap-3 border-(--gray-3) border-b py-2.5 pr-3 pl-4 transition-colors hover:bg-(--gray-2)"
+      style={isSelected ? { backgroundColor: "var(--accent-a3)" } : undefined}
     >
-      <Flex align="start" justify="between" gap="3">
-        <Flex direction="column" gap="2" className="min-w-0 flex-1">
-          <Flex align="center" gap="2" wrap="wrap" className="min-w-0">
-            <Text
-              className="truncate font-medium text-[13px] text-gray-12"
-              title={title}
-            >
-              {title}
-            </Text>
-            {workstream.situations.map((sid) => (
-              <SituationChip key={sid} sid={sid} />
-            ))}
-            {taskCount > 1 ? (
-              <Text className="shrink-0 text-(--gray-10) text-[11px]">
-                · {taskCount} tasks
-              </Text>
-            ) : null}
-          </Flex>
+      <span
+        aria-hidden
+        className="absolute top-0 bottom-0 left-0 w-[3px]"
+        style={{ backgroundColor: accent.solid }}
+      />
+
+      <StatusGlyph sid={primarySid} size={32} />
 
-          <Flex
-            align="center"
-            gap="3"
-            wrap="wrap"
-            className="text-(--gray-10) text-[11px]"
+      <div className="flex min-w-0 flex-1 flex-col gap-1">
+        <div className="flex min-w-0 items-center gap-2">
+          <span
+            className="truncate font-medium text-[13px] text-gray-12"
+            title={title}
           >
-            {workstream.repoName ? (
-              <Text title="Repository">{workstream.repoName}</Text>
-            ) : null}
-            {workstream.branch ? (
-              <Flex align="center" gap="1" className="min-w-0">
-                <GitBranch size={10} />
-                <span className="truncate" title={workstream.branch}>
-                  {workstream.branch}
-                </span>
-              </Flex>
-            ) : null}
-            {headTask?.needsPermission ? (
-              <Flex align="center" gap="1" className="text-(--amber-11)">
-                <Warning size={11} weight="fill" />
-                <span>Awaiting permission</span>
-              </Flex>
-            ) : null}
-            {workstream.tasks.some((t) => t.isGenerating) ? (
-              <Flex align="center" gap="1">
-                <ChatCircle size={11} />
-                <span>Generating</span>
-              </Flex>
-            ) : null}
-            <Text>{formatRelativeTimeShort(workstream.lastActivityAt)}</Text>
-          </Flex>
-        </Flex>
+            {title}
+          </span>
+          {extraSituations.map((sid) => (
+            <SituationChip key={sid} sid={sid} />
+          ))}
+        </div>
+        <MetaList items={meta} />
+      </div>
+
+      <Flex
+        align="center"
+        className="shrink-0 gap-2.5 pl-2"
+        onClick={(e) => e.stopPropagation()}
+        onKeyDown={(e) => e.stopPropagation()}
+      >
+        {author ? <AuthorAvatar login={author} /> : null}
+        <Text className="w-[40px] shrink-0 text-right text-(--gray-9) text-[11px]">
+          {formatRelativeTimeShort(workstream.lastActivityAt)}
+        </Text>
 
-        <Flex
-          align="center"
-          gap="2"
-          wrap="wrap"
-          className="shrink-0"
-          onClick={(e) => e.stopPropagation()}
-          onKeyDown={(e) => e.stopPropagation()}
-        >
-          {inlineActions.map((action, idx) => (
+        <div className="flex items-center gap-1">
+          {primaryBound ? (
             <Button
-              key={`${action.situationId}::${action.id}`}
-              variant={idx === 0 ? "primary" : "outline"}
+              variant="primary"
               size="sm"
-              onClick={() => handleRunAction(action)}
-              title={`${action.situationLabel} → ${action.skillId}`}
+              onClick={() => runAction(primaryBound)}
+              title={`${primaryBound.situationLabel} → ${primaryBound.skillId}`}
             >
-              <Sparkle size={12} />
-              {action.label}
+              <Sparkle size={12} weight="fill" />
+              {primaryBound.label}
             </Button>
-          ))}
-          {overflowActions.length > 0 ? (
-            <DropdownMenu.Root>
-              <DropdownMenu.Trigger>
-                <Button
-                  variant="outline"
-                  size="sm"
-                  title={`${overflowActions.length} more quick action${overflowActions.length === 1 ? "" : "s"}`}
-                >
-                  +{overflowActions.length}
-                  <CaretDown size={10} />
-                </Button>
-              </DropdownMenu.Trigger>
-              <DropdownMenu.Content>
-                {overflowActions.map((action) => (
-                  <DropdownMenu.Item
-                    key={`${action.situationId}::${action.id}`}
-                    onSelect={() => handleRunAction(action)}
-                  >
-                    <Sparkle size={12} />
-                    {action.label}
-                    <Text className="ml-auto pl-3 text-(--gray-10) text-[10px]">
-                      {action.situationLabel}
-                    </Text>
-                  </DropdownMenu.Item>
-                ))}
-              </DropdownMenu.Content>
-            </DropdownMenu.Root>
-          ) : null}
-          {workstream.prUrl ? (
-            <Button variant="link-muted" size="sm" onClick={handleOpenPr}>
+          ) : primaryIsPr ? (
+            <Button variant="outline" size="sm" onClick={openPr}>
               <GitPullRequest size={12} />
-              PR
-              <ArrowSquareOut size={10} />
+              {author ? "Review PR" : "View PR"}
             </Button>
+          ) : primaryIsTask ? (
+            <Button variant="outline" size="sm" onClick={openTask}>
+              Open task
+            </Button>
+          ) : null}
+
+          {hasMenu ? (
+            <WorkstreamOverflowMenu
+              restBound={restBound}
+              showPrInMenu={showPrInMenu}
+              showTaskInMenu={showTaskInMenu}
+              onRun={runAction}
+              onOpenPr={openPr}
+              onOpenTask={openTask}
+              size="sm"
+            />
           ) : null}
-          <Button variant="link-muted" size="sm" onClick={handleOpenTask}>
-            Open task
-          </Button>
-        </Flex>
+        </div>
       </Flex>
     </Box>
   );
diff --git a/apps/code/src/renderer/features/home/components/SituationChip.tsx b/apps/code/src/renderer/features/home/components/SituationChip.tsx
index 3b456e284d..2f1034c9dc 100644
--- a/apps/code/src/renderer/features/home/components/SituationChip.tsx
+++ b/apps/code/src/renderer/features/home/components/SituationChip.tsx
@@ -1,16 +1,24 @@
-import { Badge } from "@posthog/quill";
 import type { SituationId } from "@shared/types/workflow";
-import { SITUATION_BADGE, SITUATION_META } from "../utils/situationDisplay";
+import { SITUATION_VISUAL, situationCss } from "../utils/situationDisplay";
 
 interface Props {
   sid: SituationId;
+  /** Hide the leading glyph (e.g. when the chip sits next to a status icon). */
+  showIcon?: boolean;
 }
 
-export function SituationChip({ sid }: Props) {
-  const meta = SITUATION_META[sid];
+export function SituationChip({ sid, showIcon = true }: Props) {
+  const v = SITUATION_VISUAL[sid];
+  const c = situationCss(v.color);
+  const Icon = v.Icon;
   return (
-    <Badge variant={SITUATION_BADGE[sid]} title={meta.description}>
-      {meta.label}
-    </Badge>
+    <span
+      className="inline-flex shrink-0 items-center gap-1 rounded-full px-1.5 py-0.5 font-medium text-[10.5px] leading-none"
+      style={{ color: c.fg, backgroundColor: c.tint }}
+      title={v.description}
+    >
+      {showIcon ? <Icon size={10} weight="fill" /> : null}
+      {v.label}
+    </span>
   );
 }
diff --git a/apps/code/src/renderer/features/home/components/WorkstreamBits.tsx b/apps/code/src/renderer/features/home/components/WorkstreamBits.tsx
new file mode 100644
index 0000000000..6f3e59fd14
--- /dev/null
+++ b/apps/code/src/renderer/features/home/components/WorkstreamBits.tsx
@@ -0,0 +1,224 @@
+import {
+  ArrowSquareOut,
+  CheckCircle,
+  CircleNotch,
+  DotsThree,
+  GitPullRequest,
+  Sparkle,
+  XCircle,
+} from "@phosphor-icons/react";
+import { Button } from "@posthog/quill";
+import { DropdownMenu, Text } from "@radix-ui/themes";
+import type { PrCiStatus } from "@shared/types/pr-snapshot";
+import type { SituationId } from "@shared/types/workflow";
+import { Fragment } from "react";
+import type { BoundAction } from "../hooks/useBoundActions";
+import { SITUATION_VISUAL, situationCss } from "../utils/situationDisplay";
+
+/**
+ * The square status anchor that leads every row / card. A tinted rounded tile
+ * carrying the primary situation's glyph in its own hue — the single fastest
+ * "what state is this in?" read on the page.
+ */
+export function StatusGlyph({
+  sid,
+  size = 30,
+}: {
+  sid: SituationId;
+  size?: number;
+}) {
+  const v = SITUATION_VISUAL[sid];
+  const c = situationCss(v.color);
+  const Icon = v.Icon;
+  return (
+    <span
+      className="flex shrink-0 items-center justify-center rounded-[7px]"
+      style={{
+        width: size,
+        height: size,
+        backgroundColor: c.tint,
+        color: c.fg,
+      }}
+      title={`${v.label} — ${v.description}`}
+    >
+      <Icon size={Math.round(size * 0.52)} weight="bold" />
+    </span>
+  );
+}
+
+/** Small solid dot in a situation's colour — used in column headers. */
+export function StatusDot({ sid }: { sid: SituationId }) {
+  const c = situationCss(SITUATION_VISUAL[sid].color);
+  return (
+    <span
+      className="inline-block h-2 w-2 shrink-0 rounded-full"
+      style={{ backgroundColor: c.solid }}
+    />
+  );
+}
+
+/** Compact CI signal — icon-only by default, optional inline label. */
+export function CiIndicator({
+  status,
+  showLabel = false,
+}: {
+  status: PrCiStatus;
+  showLabel?: boolean;
+}) {
+  if (status === "none") return null;
+  if (status === "passing") {
+    return (
+      <span
+        className="inline-flex items-center gap-1 text-(--green-11)"
+        title="CI passing"
+      >
+        <CheckCircle size={13} weight="fill" />
+        {showLabel ? <span className="text-[11px]">CI passing</span> : null}
+      </span>
+    );
+  }
+  if (status === "failing") {
+    return (
+      <span
+        className="inline-flex items-center gap-1 text-(--red-11)"
+        title="CI failing"
+      >
+        <XCircle size={13} weight="fill" />
+        {showLabel ? <span className="text-[11px]">CI failing</span> : null}
+      </span>
+    );
+  }
+  return (
+    <span
+      className="inline-flex items-center gap-1 text-(--amber-11)"
+      title="CI running"
+    >
+      <CircleNotch size={13} weight="bold" className="animate-spin" />
+      {showLabel ? <span className="text-[11px]">CI running</span> : null}
+    </span>
+  );
+}
+
+/**
+ * GitHub avatar for a PR author. Uses the same `github.com/<login>.png` source
+ * + `.github-avatar` loading placeholder convention as the inbox. Hides itself
+ * if the image can't load. Renders nothing without a login.
+ */
+export function AuthorAvatar({
+  login,
+  size = 18,
+}: {
+  login: string | null;
+  size?: number;
+}) {
+  if (!login) return null;
+  return (
+    <img
+      src={`https://github.com/${login}.png?size=${size * 2}`}
+      alt={`@${login}`}
+      title={`@${login}`}
+      className="github-avatar shrink-0 rounded-full"
+      style={{ width: size, height: size }}
+      onLoad={(e) => e.currentTarget.classList.add("loaded")}
+      onError={(e) => {
+        e.currentTarget.style.display = "none";
+      }}
+    />
+  );
+}
+
+/**
+ * The "more actions" overflow shared by the list row and board card: the
+ * non-primary bound actions, then (separated) open-PR / open-task fallbacks.
+ * Only the trigger/icon sizing differs between the two surfaces.
+ */
+export function WorkstreamOverflowMenu({
+  restBound,
+  showPrInMenu,
+  showTaskInMenu,
+  onRun,
+  onOpenPr,
+  onOpenTask,
+  size = "sm",
+}: {
+  restBound: BoundAction[];
+  showPrInMenu: boolean;
+  showTaskInMenu: boolean;
+  onRun: (action: BoundAction) => void;
+  onOpenPr: () => void;
+  onOpenTask: () => void;
+  size?: "sm" | "xs";
+}) {
+  const sparkleSize = size === "xs" ? 11 : 12;
+  const dotsSize = size === "xs" ? 15 : 16;
+  return (
+    <DropdownMenu.Root>
+      <DropdownMenu.Trigger>
+        <Button variant="link-muted" size={size} title="More actions">
+          <DotsThree size={dotsSize} weight="bold" />
+        </Button>
+      </DropdownMenu.Trigger>
+      <DropdownMenu.Content align="end">
+        {restBound.map((action) => (
+          <DropdownMenu.Item
+            key={`${action.situationId}::${action.id}`}
+            onSelect={() => onRun(action)}
+          >
+            <Sparkle size={sparkleSize} />
+            {action.label}
+            <Text className="ml-auto pl-3 text-(--gray-10) text-[10px]">
+              {action.situationLabel}
+            </Text>
+          </DropdownMenu.Item>
+        ))}
+        {restBound.length > 0 && (showPrInMenu || showTaskInMenu) ? (
+          <DropdownMenu.Separator />
+        ) : null}
+        {showPrInMenu ? (
+          <DropdownMenu.Item onSelect={onOpenPr}>
+            <GitPullRequest size={12} />
+            Open PR in browser
+            <ArrowSquareOut size={10} className="ml-auto pl-3" />
+          </DropdownMenu.Item>
+        ) : null}
+        {showTaskInMenu ? (
+          <DropdownMenu.Item onSelect={onOpenTask}>Open task</DropdownMenu.Item>
+        ) : null}
+      </DropdownMenu.Content>
+    </DropdownMenu.Root>
+  );
+}
+
+export interface MetaItem {
+  key: string;
+  node: React.ReactNode;
+}
+
+/**
+ * A muted, dot-separated metadata line (repo · branch · #PR · …). Callers pass
+ * only the items that exist, so separators never dangle.
+ */
+export function MetaList({
+  items,
+  className,
+}: {
+  items: MetaItem[];
+  className?: string;
+}) {
+  return (
+    <div
+      className={`flex min-w-0 flex-wrap items-center gap-x-1.5 gap-y-0.5 text-(--gray-10) text-[11px] ${className ?? ""}`}
+    >
+      {items.map((item, i) => (
+        <Fragment key={item.key}>
+          {i > 0 ? (
+            <span aria-hidden className="text-(--gray-6)">
+              ·
+            </span>
+          ) : null}
+          {item.node}
+        </Fragment>
+      ))}
+    </div>
+  );
+}
diff --git a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
index 9de9ee0f41..6bbbf9e134 100644
--- a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
+++ b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
@@ -45,6 +45,7 @@ function pr(
     ciStatus: "passing",
     unresolvedThreads: 0,
     reviewDecision: null,
+    mergeable: null,
     isCurrentUserRequestedReviewer: false,
     isCurrentUserAuthor: true,
     author: "peter",
diff --git a/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
index aa86bb6023..add715e44e 100644
--- a/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
+++ b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
@@ -1,8 +1,4 @@
-import {
-  type SidebarData,
-  useSidebarData,
-} from "@features/sidebar/hooks/useSidebarData";
-import { useNavigationStore } from "@stores/navigationStore";
+import type { TaskPrRef } from "@shared/types/pr-snapshot";
 import { useMemo } from "react";
 import { buildDemoSnapshot, EMPTY_SNAPSHOT } from "../fixtures/demoSnapshot";
 import { useHomeDemoStore } from "../stores/homeDemoStore";
@@ -10,21 +6,40 @@ import {
   buildSnapshotFromTasks,
   type HomeSnapshot,
 } from "../utils/buildSnapshot";
+import { useHomeTasks } from "./useHomeTasks";
+import { usePrSnapshots } from "./usePrSnapshots";
 
 export function useHomeSnapshot(): {
   snapshot: HomeSnapshot;
   isLoading: boolean;
-  sidebarData: SidebarData;
   isDemo: boolean;
 } {
-  const view = useNavigationStore((s) => s.view);
-  const sidebarData = useSidebarData({ activeView: view });
+  const { pinnedTasks, flatTasks, isLoading } = useHomeTasks();
   const demoScenario = useHomeDemoStore((s) => s.scenario);
 
+  // Tasks worth resolving a PR for: a cloud PR URL, a branch (which may have a
+  // PR), or a worktree. Skipped in demo mode, which supplies its own fixtures.
+  const prRefs = useMemo<TaskPrRef[]>(() => {
+    if (demoScenario !== "off") return [];
+    const refs: TaskPrRef[] = [];
+    for (const task of [...pinnedTasks, ...flatTasks]) {
+      if (
+        task.cloudPrUrl ||
+        task.linkedBranch ||
+        task.branchName ||
+        task.folderPath
+      ) {
+        refs.push({ taskId: task.id, cloudPrUrl: task.cloudPrUrl });
+      }
+    }
+    return refs;
+  }, [demoScenario, pinnedTasks, flatTasks]);
+
+  const prByTaskId = usePrSnapshots(prRefs);
+
   const realSnapshot = useMemo(
-    () =>
-      buildSnapshotFromTasks(sidebarData.pinnedTasks, sidebarData.flatTasks),
-    [sidebarData.pinnedTasks, sidebarData.flatTasks],
+    () => buildSnapshotFromTasks(pinnedTasks, flatTasks, prByTaskId),
+    [pinnedTasks, flatTasks, prByTaskId],
   );
 
   const snapshot = useMemo(() => {
@@ -35,8 +50,7 @@ export function useHomeSnapshot(): {
 
   return {
     snapshot,
-    isLoading: demoScenario !== "off" ? false : sidebarData.isLoading,
-    sidebarData,
+    isLoading: demoScenario !== "off" ? false : isLoading,
     isDemo: demoScenario !== "off",
   };
 }
diff --git a/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts b/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
new file mode 100644
index 0000000000..6a791f737a
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
@@ -0,0 +1,86 @@
+import { useArchivedTaskIds } from "@features/archive/hooks/useArchivedTaskIds";
+import { useSessions } from "@features/sessions/stores/sessionStore";
+import { usePinnedTasks } from "@features/sidebar/hooks/usePinnedTasks";
+import {
+  type TaskData,
+  toTaskData,
+} from "@features/sidebar/hooks/useSidebarData";
+import { useTaskViewed } from "@features/sidebar/hooks/useTaskViewed";
+import { useSidebarStore } from "@features/sidebar/stores/sidebarStore";
+import { useSuspendedTaskIds } from "@features/suspension/hooks/useSuspendedTaskIds";
+import { useTasks } from "@features/tasks/hooks/useTasks";
+import { useWorkspaces } from "@features/workspace/hooks/useWorkspace";
+import { useMemo } from "react";
+
+export interface HomeTasks {
+  pinnedTasks: TaskData[];
+  flatTasks: TaskData[];
+  isLoading: boolean;
+}
+
+const byActivity = (a: TaskData, b: TaskData) =>
+  b.lastActivityAt - a.lastActivityAt;
+
+// The home tab aggregates ALL of the current user's tasks — not the sidebar's
+// workspace-scoped, paginated slice. It sources the full task list directly
+// (createdBy = me) and reuses the sidebar's Task → TaskData mapping, then lets
+// buildSnapshot group + classify. No history slice, no workspace filter, so
+// cloud tasks and tasks without a local checkout still surface.
+export function useHomeTasks(): HomeTasks {
+  const showInternal = useSidebarStore((s) => s.showInternal);
+  const { data: tasks = [], isLoading } = useTasks({ showInternal });
+  const { data: workspaces, isFetched: workspacesFetched } = useWorkspaces();
+  const sessions = useSessions();
+  const { timestamps } = useTaskViewed();
+  const { pinnedTaskIds } = usePinnedTasks();
+  const suspendedTaskIds = useSuspendedTaskIds();
+  const archivedTaskIds = useArchivedTaskIds();
+
+  const sessionByTaskId = useMemo(() => {
+    const map = new Map<string, (typeof sessions)[string]>();
+    for (const session of Object.values(sessions)) {
+      if (session.taskId) map.set(session.taskId, session);
+    }
+    return map;
+  }, [sessions]);
+
+  const taskData = useMemo(
+    () =>
+      tasks
+        .filter((task) => !archivedTaskIds.has(task.id))
+        .map((task) =>
+          toTaskData(task, {
+            session: sessionByTaskId.get(task.id),
+            workspace: workspaces?.[task.id],
+            taskTimestamps: timestamps[task.id],
+            isPinned: pinnedTaskIds.has(task.id),
+            isSuspended: suspendedTaskIds.has(task.id),
+            isSlackOrigin: false,
+          }),
+        ),
+    [
+      tasks,
+      archivedTaskIds,
+      sessionByTaskId,
+      workspaces,
+      timestamps,
+      pinnedTaskIds,
+      suspendedTaskIds,
+    ],
+  );
+
+  const pinnedTasks = useMemo(
+    () => taskData.filter((t) => t.isPinned).sort(byActivity),
+    [taskData],
+  );
+  const flatTasks = useMemo(
+    () => taskData.filter((t) => !t.isPinned).sort(byActivity),
+    [taskData],
+  );
+
+  return {
+    pinnedTasks,
+    flatTasks,
+    isLoading: isLoading || !workspacesFetched,
+  };
+}
diff --git a/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts b/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
new file mode 100644
index 0000000000..1a71cb2d5c
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
@@ -0,0 +1,47 @@
+import { useTRPC } from "@renderer/trpc";
+import type { PrSnapshot, TaskPrRef } from "@shared/types/pr-snapshot";
+import { useQuery } from "@tanstack/react-query";
+import { useMemo } from "react";
+import { usePrSnapshotStore } from "../stores/prSnapshotStore";
+
+/**
+ * Resolves PR/CI snapshots for the given tasks as a `Map` keyed by task id.
+ *
+ * The query both registers these tasks for background polling in main and
+ * seeds the first paint; the subscription registrar
+ * (features/home/subscriptions.ts) keeps the store fresh after that, so store
+ * values win over the initial query result. Tasks without a PR are simply
+ * absent from the map — the classifier treats that as "no PR data".
+ */
+export function usePrSnapshots(refs: TaskPrRef[]): Map<string, PrSnapshot> {
+  const trpc = useTRPC();
+
+  // Dedupe + sort for a stable query key. `refs` is already memoized upstream,
+  // and TanStack serialises the input, so an equal-content list never refetches.
+  const tasks = useMemo(() => {
+    const byId = new Map<string, TaskPrRef>();
+    for (const ref of refs) byId.set(ref.taskId, ref);
+    return [...byId.values()].sort((a, b) => a.taskId.localeCompare(b.taskId));
+  }, [refs]);
+
+  const query = useQuery(
+    trpc.prSnapshot.getSnapshots.queryOptions(
+      { tasks },
+      { enabled: tasks.length > 0, staleTime: 60_000 },
+    ),
+  );
+
+  const byTaskId = usePrSnapshotStore((s) => s.byTaskId);
+
+  return useMemo(() => {
+    const map = new Map<string, PrSnapshot>();
+    for (const { taskId, snapshot } of query.data ?? [])
+      map.set(taskId, snapshot);
+    // Subscription cache is fresher than the initial query — let it win.
+    for (const ref of tasks) {
+      const snapshot = byTaskId[ref.taskId];
+      if (snapshot) map.set(ref.taskId, snapshot);
+    }
+    return map;
+  }, [query.data, byTaskId, tasks]);
+}
diff --git a/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts b/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
new file mode 100644
index 0000000000..881513d839
--- /dev/null
+++ b/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
@@ -0,0 +1,95 @@
+import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import type { SituationId } from "@shared/types/workflow";
+import { useNavigationStore } from "@stores/navigationStore";
+import { openUrlInBrowser } from "@utils/browser";
+import type { HomePullRequest, HomeWorkstream } from "../utils/buildSnapshot";
+import {
+  primarySituationId,
+  SITUATION_VISUAL,
+  type SituationCss,
+  situationCss,
+} from "../utils/situationDisplay";
+import { type BoundAction, useBoundActions } from "./useBoundActions";
+import { useRunWorkstreamAction } from "./useRunWorkstreamAction";
+
+export interface WorkstreamPresentation {
+  pr: HomePullRequest | null;
+  headTask: HomeWorkstream["tasks"][number] | undefined;
+  title: string;
+  primarySid: SituationId;
+  accent: SituationCss;
+  /** PR author login when it's someone else's PR, else null. */
+  author: string | null;
+  /** Situations to render as chips — primary + the calm `in_review` are omitted. */
+  extraSituations: SituationId[];
+  primaryBound: BoundAction | null;
+  restBound: BoundAction[];
+  primaryIsPr: boolean;
+  primaryIsTask: boolean;
+  showPrInMenu: boolean;
+  showTaskInMenu: boolean;
+  hasMenu: boolean;
+  runAction: (action: BoundAction) => void;
+  openTask: () => void;
+  openPr: () => void;
+}
+
+/**
+ * Shared presentation + action derivation for a workstream. The list row and
+ * board card differ only in layout — everything about *what* to show and *what*
+ * the affordances do lives here so the two renderings can't drift.
+ */
+export function useWorkstreamPresentation(
+  workstream: HomeWorkstream,
+): WorkstreamPresentation {
+  const { data: tasks = [] } = useTasks();
+  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
+  const boundActions = useBoundActions(workstream);
+  const run = useRunWorkstreamAction();
+
+  const pr = workstream.pr;
+  const headTask = workstream.tasks[0];
+  const title =
+    pr?.title ?? headTask?.title ?? workstream.branch ?? "Workstream";
+  const primarySid = primarySituationId(workstream.situations) ?? "working";
+  const accent = situationCss(SITUATION_VISUAL[primarySid].color);
+  const author = pr?.author && !pr.isCurrentUserAuthor ? pr.author : null;
+  const extraSituations = workstream.situations.filter(
+    (s) => s !== primarySid && s !== "in_review",
+  );
+
+  const primaryBound = boundActions[0] ?? null;
+  const restBound = primaryBound ? boundActions.slice(1) : [];
+
+  const primaryIsPr = !primaryBound && !!workstream.prUrl;
+  const primaryIsTask = !primaryBound && !workstream.prUrl && !!headTask;
+  const showPrInMenu = !!workstream.prUrl && !primaryIsPr;
+  const showTaskInMenu = !!headTask && !primaryIsTask;
+  const hasMenu = restBound.length > 0 || showPrInMenu || showTaskInMenu;
+
+  return {
+    pr,
+    headTask,
+    title,
+    primarySid,
+    accent,
+    author,
+    extraSituations,
+    primaryBound,
+    restBound,
+    primaryIsPr,
+    primaryIsTask,
+    showPrInMenu,
+    showTaskInMenu,
+    hasMenu,
+    runAction: (action) => run(action, workstream),
+    openTask: () => {
+      if (!headTask) return;
+      const task = tasks.find((t) => t.id === headTask.id);
+      if (task) navigateToTask(task);
+    },
+    openPr: () => {
+      if (workstream.prUrl) void openUrlInBrowser(workstream.prUrl);
+    },
+  };
+}
diff --git a/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts b/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
new file mode 100644
index 0000000000..22265fd6da
--- /dev/null
+++ b/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
@@ -0,0 +1,22 @@
+import type { PrSnapshot, TaskPrSnapshot } from "@shared/types/pr-snapshot";
+import { create } from "zustand";
+
+// Subscription-fed cache of PR/CI snapshots, keyed by task id. Pure UI state
+// per R2: the main PrSnapshotService owns resolution and freshness; this store
+// just mirrors what it pushes over `prSnapshot.onUpdated` so components
+// re-render.
+interface PrSnapshotStore {
+  byTaskId: Record<string, PrSnapshot>;
+  upsertMany: (results: TaskPrSnapshot[]) => void;
+}
+
+export const usePrSnapshotStore = create<PrSnapshotStore>((set) => ({
+  byTaskId: {},
+  upsertMany: (results) =>
+    set((state) => {
+      if (results.length === 0) return state;
+      const byTaskId = { ...state.byTaskId };
+      for (const { taskId, snapshot } of results) byTaskId[taskId] = snapshot;
+      return { byTaskId };
+    }),
+}));
diff --git a/apps/code/src/renderer/features/home/subscriptions.ts b/apps/code/src/renderer/features/home/subscriptions.ts
index 5ebd8bb97b..b7cfb22006 100644
--- a/apps/code/src/renderer/features/home/subscriptions.ts
+++ b/apps/code/src/renderer/features/home/subscriptions.ts
@@ -1,6 +1,7 @@
 import { trpc, trpcClient } from "@renderer/trpc";
 import { logger } from "@utils/logger";
 import { queryClient } from "@utils/queryClient";
+import { usePrSnapshotStore } from "./stores/prSnapshotStore";
 
 const log = logger.scope("home-subscriptions");
 
@@ -14,7 +15,20 @@ export function registerHomeSubscriptions() {
     },
   });
 
+  const prSnapshotUpdated = trpcClient.prSnapshot.onUpdated.subscribe(
+    undefined,
+    {
+      onData: (snapshots) => {
+        usePrSnapshotStore.getState().upsertMany(snapshots);
+      },
+      onError: (error) => {
+        log.error("prSnapshot.onUpdated subscription error", { error });
+      },
+    },
+  );
+
   return () => {
     workflowChanged.unsubscribe();
+    prSnapshotUpdated.unsubscribe();
   };
 }
diff --git a/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts b/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
index d4868ab7ff..ba2de14120 100644
--- a/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
+++ b/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
@@ -1,9 +1,28 @@
 import type { TaskData } from "@features/sidebar/hooks/useSidebarData";
+import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import { describe, expect, it } from "vitest";
 import { buildSnapshotFromTasks } from "./buildSnapshot";
 
 const MINUTE = 60 * 1000;
 
+function makePr(overrides: Partial<PrSnapshot> = {}): PrSnapshot {
+  return {
+    url: "https://github.com/org/repo/pull/7",
+    number: 7,
+    title: "PR",
+    state: "open",
+    ciStatus: "passing",
+    reviewDecision: null,
+    unresolvedThreads: 0,
+    mergeable: null,
+    isCurrentUserRequestedReviewer: false,
+    isCurrentUserAuthor: true,
+    author: "me",
+    lastUpdatedAt: Date.now(),
+    ...overrides,
+  };
+}
+
 function makeTask(overrides: Partial<TaskData> = {}): TaskData {
   return {
     id: "t1",
@@ -94,3 +113,59 @@ describe("buildSnapshotFromTasks — Running strip", () => {
     expect(activeAgents).toHaveLength(1);
   });
 });
+
+describe("buildSnapshotFromTasks — resolved PR snapshots (branch PRs)", () => {
+  it("surfaces a branch PR with failing CI under Needs attention", () => {
+    const task = makeTask({
+      id: "t-ci",
+      taskRunStatus: "completed",
+      cloudPrUrl: null, // PR lives on the branch, not cloud-run output
+      linkedBranch: "feature",
+    });
+    const prByTaskId = new Map([
+      [task.id, makePr({ ciStatus: "failing", state: "open" })],
+    ]);
+
+    const { needsAttention, inProgress, activeAgents } = buildSnapshotFromTasks(
+      [],
+      [task],
+      prByTaskId,
+    );
+
+    expect(activeAgents).toHaveLength(0);
+    expect(needsAttention).toHaveLength(1);
+    expect(needsAttention[0]?.situations).toContain("ci_failing");
+    expect(needsAttention[0]?.prUrl).toBe("https://github.com/org/repo/pull/7");
+    expect(needsAttention[0]?.pr?.ciStatus).toBe("failing");
+    expect(inProgress).toHaveLength(0);
+  });
+
+  it("groups a task under its resolved PR even without a cloud PR URL", () => {
+    const task = makeTask({
+      id: "t-rev",
+      taskRunStatus: "completed",
+      cloudPrUrl: null,
+    });
+    const prByTaskId = new Map([[task.id, makePr({ state: "open" })]]);
+
+    const { inProgress } = buildSnapshotFromTasks([], [task], prByTaskId);
+
+    expect(inProgress).toHaveLength(1);
+    expect(inProgress[0]?.situations).toContain("in_review");
+  });
+
+  it("drops an in_progress agent with a resolved branch PR out of Running", () => {
+    const task = makeTask({ cloudPrUrl: null, lastActivityAt: Date.now() });
+    const prByTaskId = new Map([[task.id, makePr({ state: "open" })]]);
+
+    const { activeAgents, inProgress } = buildSnapshotFromTasks(
+      [],
+      [task],
+      prByTaskId,
+    );
+
+    expect(activeAgents).toHaveLength(0);
+    expect(inProgress).toHaveLength(1);
+    expect(inProgress[0]?.situations).toContain("in_review");
+  });
+});
diff --git a/apps/code/src/renderer/features/home/utils/buildSnapshot.ts b/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
index 63b2536369..a34af13f2e 100644
--- a/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
+++ b/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
@@ -1,5 +1,6 @@
 import type { TaskData } from "@features/sidebar/hooks/useSidebarData";
 import type { TaskRunStatus } from "@shared/types";
+import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import type { SituationId } from "@shared/types/workflow";
 import { classify } from "@shared/types/workflow-classify";
 
@@ -14,22 +15,11 @@ export type HomeActiveAgent = {
   cloudPrUrl: string | null;
 };
 
-// Until the GitHub fetcher lands, real data only ever has `pr: null`. Kept
-// on the type because demo fixtures populate it and the detail panel renders
-// the richer view when present.
-export type HomePullRequest = {
-  url: string;
-  number: number;
-  title: string;
-  state: "open" | "draft" | "merged" | "closed";
-  ciStatus: "passing" | "failing" | "pending" | "none";
-  unresolvedThreads: number;
-  reviewDecision: "approved" | "changes_requested" | "review_required" | null;
-  isCurrentUserRequestedReviewer: boolean;
-  isCurrentUserAuthor: boolean;
-  author: string | null;
-  lastUpdatedAt: number;
-};
+// The PR/CI snapshot a workstream is classified against. Populated from the
+// gh-backed PrSnapshotService (null until its first fetch resolves) and by demo
+// fixtures; the production PostHog feed produces the same shape — see
+// docs/workflow-architecture.md.
+export type HomePullRequest = PrSnapshot;
 
 export type HomeWorkstreamTask = {
   id: string;
@@ -92,34 +82,55 @@ function isRunning(status?: TaskRunStatus): boolean {
 // to "In review" / "Working" / "Stale". A session that's actively generating
 // or waiting on the user is always live, so it's exempt from the stale check
 // (its activity timestamp may not tick while it waits).
-function isActivelyRunning(task: TaskData, now: number): boolean {
+function isActivelyRunning(
+  task: TaskData,
+  now: number,
+  hasPr: boolean,
+): boolean {
   if (!isRunning(task.taskRunStatus)) return false;
-  if (task.cloudPrUrl) return false;
+  if (hasPr) return false;
   if (task.isGenerating || task.needsPermission) return true;
   return now - task.lastActivityAt <= RUNNING_STALE_THRESHOLD_MS;
 }
 
-function workstreamKey(task: TaskData): string | null {
+// Grouping key precedence (per docs/home-tab.md §5):
+// PR URL → repo+branch → worktree path. `prUrl` here is the *resolved* URL
+// (cloud run output or a branch lookup), so a PR that only exists on the branch
+// still groups a task under its PR. Tasks with none of these — e.g. an old
+// cloud task with no PR and no local checkout — return null and are skipped, so
+// Home stays a view of actual code work rather than every historical task.
+function workstreamKey(task: TaskData, prUrl: string | null): string | null {
+  if (prUrl) return `pr:${prUrl}`;
   const repo = task.repository?.name ?? null;
   const branch = task.linkedBranch ?? task.branchName ?? null;
-  if (task.cloudPrUrl) return `pr:${task.cloudPrUrl}`;
   if (repo && branch) return `branch:${repo}#${branch}`;
+  if (task.folderPath) return `path:${task.folderPath}`;
   return null;
 }
 
 export function buildSnapshotFromTasks(
   pinned: TaskData[],
   flat: TaskData[],
+  prByTaskId?: ReadonlyMap<string, PrSnapshot>,
 ): HomeSnapshot {
   const allTasks = [...pinned, ...flat];
   const now = Date.now();
 
+  // Effective PR per task: a resolved snapshot (cloud run *or* branch lookup)
+  // wins; fall back to the cloud-run URL so grouping still works before the
+  // snapshot resolves.
+  const prOf = (task: TaskData): PrSnapshot | null =>
+    prByTaskId?.get(task.id) ?? null;
+  const prUrlOf = (task: TaskData): string | null =>
+    prOf(task)?.url ?? task.cloudPrUrl ?? null;
+
   const activeAgents: HomeActiveAgent[] = [];
   const groups = new Map<string, TaskData[]>();
   const taskInStrip = new Set<string>();
 
   for (const task of allTasks) {
-    if (isActivelyRunning(task, now)) {
+    const prUrl = prUrlOf(task);
+    if (isActivelyRunning(task, now, !!prUrl)) {
       activeAgents.push({
         taskId: task.id,
         title: task.title,
@@ -133,7 +144,7 @@ export function buildSnapshotFromTasks(
       taskInStrip.add(task.id);
       continue;
     }
-    const key = workstreamKey(task);
+    const key = workstreamKey(task, prUrl);
     if (!key) continue;
     const bucket = groups.get(key);
     if (bucket) bucket.push(task);
@@ -152,14 +163,26 @@ export function buildSnapshotFromTasks(
 
     if (tasks.every((t) => taskInStrip.has(t.id))) continue;
 
-    const prUrl = tasks.find((t) => t.cloudPrUrl)?.cloudPrUrl ?? null;
+    // First task in the group that resolves to a PR carries the snapshot;
+    // grouped-by-PR tasks all share the same URL anyway.
+    let pr: PrSnapshot | null = null;
+    let prUrl: string | null = null;
+    for (const t of tasks) {
+      const snap = prOf(t);
+      const url = snap?.url ?? t.cloudPrUrl ?? null;
+      if (url) {
+        pr = snap;
+        prUrl = url;
+        break;
+      }
+    }
     const branch = head.linkedBranch ?? head.branchName ?? null;
     const lastActivityAt = head.lastActivityAt;
 
     const situations = Array.from(
       classify({
         hasPrUrl: !!prUrl,
-        pr: null,
+        pr,
         branch,
         lastActivityAt,
         now,
@@ -171,7 +194,7 @@ export function buildSnapshotFromTasks(
       repoName: head.repository?.name ?? null,
       branch,
       prUrl,
-      pr: null,
+      pr,
       tasks: tasks.map((t) => ({
         id: t.id,
         title: t.title,
diff --git a/apps/code/src/renderer/features/home/utils/situationDisplay.ts b/apps/code/src/renderer/features/home/utils/situationDisplay.ts
index 9b8e8fde1d..89610a2b68 100644
--- a/apps/code/src/renderer/features/home/utils/situationDisplay.ts
+++ b/apps/code/src/renderer/features/home/utils/situationDisplay.ts
@@ -1,48 +1,92 @@
+import {
+  ArrowUUpLeft,
+  ChatCircleDots,
+  CheckCircle,
+  Clock,
+  Eye,
+  GitCommit,
+  GitMerge,
+  type Icon,
+  XCircle,
+} from "@phosphor-icons/react";
 import { SITUATIONS, type SituationId } from "@shared/types/workflow";
+import { pickPrimarySituation } from "@shared/types/workflow-classify";
 
-// O(1) lookup table for situation metadata, built once at module load.
-// SITUATIONS itself is an array (ordered for the renderer); this is the map.
-export const SITUATION_META: Record<
-  SituationId,
-  { label: string; description: string }
-> = Object.fromEntries(
-  SITUATIONS.map((s) => [s.id, { label: s.label, description: s.description }]),
-) as Record<SituationId, { label: string; description: string }>;
+// Radix color scale names we lean on for the status system. Each maps to the
+// full `--<color>-{1..12}` + `--<color>-a{1..12}` token families.
+export type SituationColor =
+  | "red"
+  | "orange"
+  | "amber"
+  | "green"
+  | "blue"
+  | "purple"
+  | "gray";
+
+export interface SituationVisual {
+  label: string;
+  description: string;
+  /** Radix color scale that gives this situation its identity. */
+  color: SituationColor;
+  /** Phosphor glyph rendered in the status badge / chip. */
+  Icon: Icon;
+}
 
-export const SITUATION_BADGE: Record<
+// The colour + glyph each situation reads as. Cool hues (purple/blue) are work
+// in flight; warm hues (red/orange/amber) are "your move"; green is go; gray is
+// dormant. Picked so adjacent board columns stay visually distinct.
+const SITUATION_STYLE: Record<
   SituationId,
-  "destructive" | "warning" | "success" | "info" | "default"
+  { color: SituationColor; Icon: Icon }
 > = {
-  done: "default",
-  ready_to_merge: "success",
-  ci_failing: "destructive",
-  changes_requested: "warning",
-  comments_waiting: "warning",
-  in_review: "info",
-  working: "default",
-  stale: "default",
+  working: { color: "purple", Icon: GitCommit },
+  in_review: { color: "blue", Icon: Eye },
+  ci_failing: { color: "red", Icon: XCircle },
+  changes_requested: { color: "orange", Icon: ArrowUUpLeft },
+  comments_waiting: { color: "amber", Icon: ChatCircleDots },
+  ready_to_merge: { color: "green", Icon: GitMerge },
+  stale: { color: "gray", Icon: Clock },
+  done: { color: "gray", Icon: CheckCircle },
 };
 
-export type WorkstreamSeverity = "critical" | "attention" | null;
+export const SITUATION_VISUAL: Record<SituationId, SituationVisual> =
+  Object.fromEntries(
+    SITUATIONS.map((s) => [
+      s.id,
+      { label: s.label, description: s.description, ...SITUATION_STYLE[s.id] },
+    ]),
+  ) as Record<SituationId, SituationVisual>;
 
-// Derived from situations rather than a separate field — `ci_failing` is the
-// only "critical" today; the user-action-requested situations are "attention".
-const CRITICAL: ReadonlySet<SituationId> = new Set(["ci_failing"]);
-const ATTENTION: ReadonlySet<SituationId> = new Set([
-  "changes_requested",
-  "comments_waiting",
-]);
+/** CSS-var passthroughs for a colour scale — used in inline `style`. */
+export interface SituationCss {
+  /** Readable text / icon colour, also good on a tinted fill (`--c-11`). */
+  fg: string;
+  /** Saturated solid — dots and accent rails (`--c-9`). */
+  solid: string;
+  /** Soft translucent fill for chips / glyph backgrounds (`--c-a3`). */
+  tint: string;
+  /** Slightly stronger fill for hover / wells (`--c-a4`). */
+  tintStrong: string;
+  /** Hairline border that reads as the colour (`--c-a6`). */
+  border: string;
+  /** Whisper-faint column wash (`--c-a2`). */
+  wash: string;
+}
 
-export function situationSeverity(
-  situations: readonly SituationId[],
-): WorkstreamSeverity {
-  if (situations.some((s) => CRITICAL.has(s))) return "critical";
-  if (situations.some((s) => ATTENTION.has(s))) return "attention";
-  return null;
+export function situationCss(color: SituationColor): SituationCss {
+  return {
+    fg: `var(--${color}-11)`,
+    solid: `var(--${color}-9)`,
+    tint: `var(--${color}-a3)`,
+    tintStrong: `var(--${color}-a4)`,
+    border: `var(--${color}-a6)`,
+    wash: `var(--${color}-a2)`,
+  };
 }
 
-export function severityRingClass(severity: WorkstreamSeverity): string {
-  if (severity === "critical") return "border-l-2 border-l-(--red-9)";
-  if (severity === "attention") return "border-l-2 border-l-(--amber-9)";
-  return "";
+/** The single most important situation a workstream is in, if any. */
+export function primarySituationId(
+  situations: readonly SituationId[],
+): SituationId | null {
+  return pickPrimarySituation(situations);
 }
diff --git a/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts b/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
index 1ab8a94238..40078159d5 100644
--- a/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
+++ b/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
@@ -94,6 +94,96 @@ function sortTasks(tasks: TaskData[], sortMode: SortMode): TaskData[] {
   );
 }
 
+// Minimal task shape the mapper reads — satisfied by both TaskSummary (sidebar)
+// and the full Task (home tab), so a single mapping serves both.
+export interface TaskDataInput {
+  id: string;
+  title: string;
+  created_at: string;
+  updated_at: string;
+  repository?: string | null;
+  latest_run?: {
+    status?: TaskRunStatus | null;
+    environment?: "local" | "cloud" | null;
+    output?: { pr_url?: unknown } | null;
+  } | null;
+  origin_product?: string;
+  slack_thread_url?: string;
+}
+
+export interface TaskDataContext {
+  session?: {
+    isPromptPending?: boolean;
+    pendingPermissions?: { size: number };
+    cloudStatus?: TaskRunStatus;
+    cloudOutput?: { pr_url?: unknown } | null;
+  };
+  workspace?: {
+    folderPath?: string | null;
+    folderId?: string;
+    branchName?: string | null;
+    linkedBranch?: string | null;
+  };
+  taskTimestamps?: {
+    lastActivityAt?: number | null;
+    lastViewedAt?: number | null;
+  };
+  isPinned: boolean;
+  isSuspended: boolean;
+  isSlackOrigin: boolean;
+  slackThreadUrlFallback?: string;
+}
+
+// Single source of truth for Task → TaskData. Used by the sidebar (over the
+// workspace-scoped summary list) and the home tab (over the full task list).
+export function toTaskData(
+  task: TaskDataInput,
+  ctx: TaskDataContext,
+): TaskData {
+  const { session, workspace, taskTimestamps } = ctx;
+  const apiUpdatedAt = new Date(task.updated_at).getTime();
+  const localActivity = taskTimestamps?.lastActivityAt;
+  const lastActivityAt = localActivity
+    ? Math.max(apiUpdatedAt, localActivity)
+    : apiUpdatedAt;
+  const createdAt = new Date(task.created_at).getTime();
+
+  const taskLastViewedAt = taskTimestamps?.lastViewedAt;
+  const isUnread =
+    taskLastViewedAt != null && lastActivityAt > taskLastViewedAt;
+
+  const cloudPrUrl =
+    typeof task.latest_run?.output?.pr_url === "string"
+      ? task.latest_run.output.pr_url
+      : ((session?.cloudOutput?.pr_url as string | undefined) ?? null);
+
+  const originProduct =
+    task.origin_product ?? (ctx.isSlackOrigin ? "slack" : undefined);
+  const slackThreadUrl = task.slack_thread_url ?? ctx.slackThreadUrlFallback;
+
+  return {
+    id: task.id,
+    title: task.title,
+    createdAt,
+    lastActivityAt,
+    isGenerating: session?.isPromptPending ?? false,
+    isUnread,
+    isPinned: ctx.isPinned,
+    isSuspended: ctx.isSuspended,
+    needsPermission: (session?.pendingPermissions?.size ?? 0) > 0,
+    repository: getRepositoryInfo(task, workspace?.folderPath ?? undefined),
+    folderId: workspace?.folderId || undefined,
+    taskRunStatus: session?.cloudStatus ?? task.latest_run?.status ?? undefined,
+    taskRunEnvironment: task.latest_run?.environment ?? undefined,
+    originProduct,
+    slackThreadUrl,
+    folderPath: workspace?.folderPath ?? null,
+    cloudPrUrl,
+    branchName: workspace?.branchName ?? null,
+    linkedBranch: workspace?.linkedBranch ?? null,
+  };
+}
+
 export function useSidebarData({
   activeView,
 }: UseSidebarDataProps): SidebarData {
@@ -244,55 +334,17 @@ export function useSidebarData({
   }, [sessions]);
 
   const taskData = useMemo(() => {
-    return allTasks.map((task) => {
-      const session = sessionByTaskId.get(task.id);
-      const workspace = workspaces?.[task.id];
-      const apiUpdatedAt = new Date(task.updated_at).getTime();
-      const taskTimestamps = timestamps[task.id];
-      const localActivity = taskTimestamps?.lastActivityAt;
-      const lastActivityAt = localActivity
-        ? Math.max(apiUpdatedAt, localActivity)
-        : apiUpdatedAt;
-      const createdAt = new Date(task.created_at).getTime();
-
-      const taskLastViewedAt = taskTimestamps?.lastViewedAt;
-      const isUnread =
-        taskLastViewedAt != null && lastActivityAt > taskLastViewedAt;
-
-      const cloudPrUrl =
-        typeof task.latest_run?.output?.pr_url === "string"
-          ? task.latest_run.output.pr_url
-          : ((session?.cloudOutput?.pr_url as string | undefined) ?? null);
-
-      const originProduct =
-        task.origin_product ??
-        (slackTaskIds.has(task.id) ? "slack" : undefined);
-      const slackThreadUrl =
-        task.slack_thread_url ?? slackThreadUrlByTaskId.get(task.id);
-
-      return {
-        id: task.id,
-        title: task.title,
-        createdAt,
-        lastActivityAt,
-        isGenerating: session?.isPromptPending ?? false,
-        isUnread,
+    return allTasks.map((task) =>
+      toTaskData(task, {
+        session: sessionByTaskId.get(task.id),
+        workspace: workspaces?.[task.id],
+        taskTimestamps: timestamps[task.id],
         isPinned: pinnedTaskIds.has(task.id),
         isSuspended: suspendedTaskIds.has(task.id),
-        needsPermission: (session?.pendingPermissions?.size ?? 0) > 0,
-        repository: getRepositoryInfo(task, workspace?.folderPath),
-        folderId: workspace?.folderId || undefined,
-        taskRunStatus:
-          session?.cloudStatus ?? task.latest_run?.status ?? undefined,
-        taskRunEnvironment: task.latest_run?.environment ?? undefined,
-        originProduct,
-        slackThreadUrl,
-        folderPath: workspace?.folderPath ?? null,
-        cloudPrUrl,
-        branchName: workspace?.branchName ?? null,
-        linkedBranch: workspace?.linkedBranch ?? null,
-      };
-    });
+        isSlackOrigin: slackTaskIds.has(task.id),
+        slackThreadUrlFallback: slackThreadUrlByTaskId.get(task.id),
+      }),
+    );
   }, [
     allTasks,
     timestamps,
diff --git a/apps/code/src/shared/types/pr-snapshot.ts b/apps/code/src/shared/types/pr-snapshot.ts
new file mode 100644
index 0000000000..ce1b579cff
--- /dev/null
+++ b/apps/code/src/shared/types/pr-snapshot.ts
@@ -0,0 +1,83 @@
+import { z } from "zod";
+
+// Canonical PR snapshot the home tab classifies against. This is the wire
+// contract: today it's produced locally by the gh-backed PrSnapshotService,
+// but the production PostHog backend serialises the *same shape* (see
+// docs/workflow-architecture.md §5). Keep it permanent — both ends share it,
+// and `classify()` reads a structural subset of these fields.
+
+export const prSnapshotState = z.enum(["open", "draft", "merged", "closed"]);
+export type PrSnapshotState = z.infer<typeof prSnapshotState>;
+
+export const prCiStatus = z.enum(["passing", "failing", "pending", "none"]);
+export type PrCiStatus = z.infer<typeof prCiStatus>;
+
+export const prReviewDecision = z.enum([
+  "approved",
+  "changes_requested",
+  "review_required",
+]);
+export type PrReviewDecision = z.infer<typeof prReviewDecision>;
+
+export const prSnapshot = z
+  .object({
+    url: z.string(),
+    number: z.number().int().nonnegative(),
+    title: z.string(),
+    state: prSnapshotState,
+    ciStatus: prCiStatus,
+    reviewDecision: prReviewDecision.nullable(),
+    unresolvedThreads: z.number().int().nonnegative(),
+    /** GitHub mergeability: true / false / null when unknown. */
+    mergeable: z.boolean().nullable(),
+    isCurrentUserRequestedReviewer: z.boolean(),
+    isCurrentUserAuthor: z.boolean(),
+    author: z.string().nullable(),
+    /** Epoch ms of the PR's last update on GitHub. */
+    lastUpdatedAt: z.number(),
+  })
+  .strict();
+export type PrSnapshot = z.infer<typeof prSnapshot>;
+
+export const prSnapshotArray = z.array(prSnapshot);
+
+// Snapshots are keyed by task, not PR URL: a task's PR may live on its branch
+// (resolved server-side / via gh), not just in cloud-run output. Two tasks can
+// still point at the same PR — the home tab groups them by the snapshot's url.
+
+/** What the client knows about a task before resolution: its id + any cloud PR URL. */
+export const taskPrRef = z
+  .object({ taskId: z.string(), cloudPrUrl: z.string().nullable() })
+  .strict();
+export type TaskPrRef = z.infer<typeof taskPrRef>;
+
+/** A resolved snapshot tagged with the task it was resolved for. */
+export const taskPrSnapshot = z
+  .object({ taskId: z.string(), snapshot: prSnapshot })
+  .strict();
+export type TaskPrSnapshot = z.infer<typeof taskPrSnapshot>;
+
+export const taskPrSnapshotArray = z.array(taskPrSnapshot);
+
+// tRPC io ---------------------------------------------------------------------
+
+export const getPrSnapshotsInput = z
+  .object({ tasks: z.array(taskPrRef) })
+  .strict();
+export type GetPrSnapshotsInput = z.infer<typeof getPrSnapshotsInput>;
+
+export const refreshPrSnapshotsInput = z
+  .object({ tasks: z.array(taskPrRef).optional() })
+  .strict();
+export type RefreshPrSnapshotsInput = z.infer<typeof refreshPrSnapshotsInput>;
+
+// Events ----------------------------------------------------------------------
+
+export const PrSnapshotEvent = {
+  // Emitted with only the task snapshots that materially changed since last refresh.
+  Updated: "updated",
+} as const;
+
+export interface PrSnapshotEvents {
+  [PrSnapshotEvent.Updated]: TaskPrSnapshot[];
+}
diff --git a/docs/workflow-architecture.md b/docs/workflow-architecture.md
index 66b842366b..7ed3cce00c 100644
--- a/docs/workflow-architecture.md
+++ b/docs/workflow-architecture.md
@@ -54,8 +54,11 @@ Concern (3) doesn't move — it's a pure TS function in
 │                       LocalWorkflowBackend ───→ SQLite                 │
 │                       (HomeWorkflowRepository)                         │
 │                                                                        │
-│  PR polling: NOT BUILT YET. classify() runs with pr=null in real data; │
-│  fixtures provide rich pr objects for demo mode.                       │
+│  PR polling: BUILT (local). PrSnapshotService ──→ PrSnapshotBackend    │
+│  ──→ LocalPrSnapshotBackend ──→ GitService.getPrFull (gh CLI).         │
+│  Snapshots are cached, polled, and pushed to the renderer via the      │
+│  prSnapshot.onUpdated subscription; classify() now runs with real PR   │
+│  data. (pr=null only until a workstream's first fetch resolves.)       │
 └────────────────────────────────────────────────────────────────────────┘
 ```
 
@@ -74,6 +77,20 @@ Concern (3) doesn't move — it's a pure TS function in
 | Migration `0007_*` (`home_workflow_config` table) | `apps/code/src/main/db/migrations/` | **POC-only.** Drop the table via a follow-up migration once cloud is the source of truth. |
 | tRPC router | `apps/code/src/main/trpc/routers/workflow.ts` | Permanent shape. Same procedures, same Zod schemas — the backend just changes underneath. |
 
+**PR snapshot files (concern 2 — built locally, same swap-point shape):**
+
+| Concern | File | Lifetime |
+|---|---|---|
+| PR snapshot schema (Zod + type) | `apps/code/src/shared/types/pr-snapshot.ts` | Permanent. The wire contract — server serialises the same shape. |
+| `PrSnapshotService` | `apps/code/src/main/services/pr-snapshot/service.ts` | Permanent in shape. Cache + poll + emit; body stays after swap. |
+| `PrSnapshotBackend` interface | `apps/code/src/main/services/pr-snapshot/backend.ts` | Permanent. The swap point. |
+| `LocalPrSnapshotBackend` (gh CLI) | same file | **POC-only.** Deleted post-migration. |
+| `CloudPrSnapshotBackend` | same file | Stub today, the implementation post-migration. |
+| `GitService.getTaskPrSnapshot` / `resolveTaskPrUrl` / `getPrFull` + gh→snapshot mappers | `apps/code/src/main/services/git/service.ts` | **POC-only.** Unused once cloud owns PR polling. |
+| `useHomeTasks` (all-my-tasks source) | `apps/code/src/renderer/features/home/hooks/useHomeTasks.ts` | Permanent in shape; the server will provide the aggregated snapshot later. |
+| tRPC router | `apps/code/src/main/trpc/routers/pr-snapshot.ts` | Permanent shape. `onUpdated` becomes a passthrough to the server feed. |
+| Renderer cache + hook | `stores/prSnapshotStore.ts`, `hooks/usePrSnapshots.ts` | Permanent. Subscription source swaps underneath; renderer unchanged. |
+
 ---
 
 ## 3. Target (production)
@@ -158,12 +175,25 @@ subscription `workflow.onChanged` in this repo becomes a passthrough.
 
 ## 5. The PR polling worker (when we build it)
 
-**POC option** (not built yet, but if needed pre-cloud): A
-`PrSnapshotService` in Electron main, running locally, fetching via the
-`gh` CLI. Owned by the same DI container, exposed via a tRPC
-subscription `pr.onSnapshotUpdated`. The classifier in
-`workflow-classify.ts` already takes an optional `pr` argument so
-plugging in the data is a one-call change in `useHomeSnapshot`.
+**POC option** (BUILT — this is what ships today): A `PrSnapshotService`
+in Electron main, running locally, keyed by **task** (not PR URL) so a PR
+that only exists on a branch is still found. Per task it resolves the PR
+the way the rest of the app does — cloud-run URL → linked-branch lookup
+(`gh pr list --head`) → worktree `getPrStatus` — via
+`GitService.getTaskPrSnapshot` / `resolveTaskPrUrl`, then enriches with
+CI/review state via `getPrFull`. Owned by the same DI container behind a
+`PrSnapshotBackend` interface (`LocalPrSnapshotBackend` now,
+`CloudPrSnapshotBackend` stubbed for the swap). Exposed via tRPC:
+`prSnapshot.getSnapshots` (query over `{ taskId, cloudPrUrl }[]`, also
+registers them for polling), `prSnapshot.refresh` (mutation), and
+`prSnapshot.onUpdated` (subscription). The renderer caches pushes in
+`prSnapshotStore` (keyed by task id) and `useHomeSnapshot` feeds the
+matching snapshot into `buildSnapshotFromTasks` → `classify()`.
+
+Coverage: Home sources **all of the current user's tasks** via
+`useHomeTasks` (the full `useTasks` list, not the sidebar's
+workspace-scoped, paginated slice), so cloud tasks and tasks without a
+local checkout surface too.
 
 **Production**: A Celery beat task in `posthog/` paging through
 `CodeWorkflow` rows, batching the PRs each user is tracking, hitting
@@ -199,9 +229,19 @@ For this Electron app:
    server's realtime event instead of `WorkflowService.emit`. Same
    tRPC contract — renderer doesn't change.
 
-For the PR polling worker, replace the (not-yet-built) local
-`PrSnapshotService` with a passthrough subscription to the server's
-event.
+For the PR polling worker, the local `PrSnapshotService` already exists.
+The swap mirrors the workflow backend:
+
+1. **Implement `CloudPrSnapshotBackend.fetch`** in
+   `apps/code/src/main/services/pr-snapshot/backend.ts` — call the
+   auth'd API, validate with `prSnapshot.safeParse`, return the rows.
+2. **Flip the DI binding** in `apps/code/src/main/di/container.ts` from
+   `LocalPrSnapshotBackend` to `CloudPrSnapshotBackend`. One line.
+3. **Delete the POC-only PR-fetch code:** `LocalPrSnapshotBackend` and
+   `GitService.getPrFull` + its gh→snapshot mappers.
+4. Optionally **rewrite `prSnapshot.onUpdated`** to fan out the server's
+   realtime event instead of the local poll loop's emit. Same tRPC
+   contract — renderer and `prSnapshotStore` don't change.
 
 For the classifier: nothing changes.
 
@@ -211,9 +251,13 @@ For the classifier: nothing changes.
 
 - **No user identity.** Bindings are anonymous, one row per app
   install. Cloud version is per-user.
-- **No real PR polling.** Real data has `pr: null` everywhere — only
-  the demo fixtures populate PR metadata. Situations involving
-  `ci_failing` / `changes_requested` etc. won't fire in real use yet.
+- **Local PR polling, with one gap.** PR/CI snapshots are now fetched
+  locally via the `gh` CLI (`PrSnapshotService`), so `ci_failing`,
+  `changes_requested`, `ready_to_merge`, `in_review`, and `done` all
+  fire on real data. Caveat: `unresolvedThreads` (which drives
+  `comments_waiting`) is only counted for the *current user's own open
+  PRs* — it needs an extra GraphQL call, so we don't pay it elsewhere.
+  The cloud worker will populate it for every PR.
 - **No `auto`-trigger actions.** We dropped the auto trigger
   intentionally — we can't reliably watch for state transitions across
   cloud and local task setups. Once the server-side polling worker

From 3a44cb2f6522f2e88b48145c07653db148b4e8bf Mon Sep 17 00:00:00 2001
From: Peter Kirkham <peter@posthog.com>
Date: Tue, 2 Jun 2026 10:35:31 +0100
Subject: [PATCH 4/6] fix comment clean up

---
 .../repositories/home-workflow-repository.ts  |  26 +--
 apps/code/src/main/di/container.ts            |  13 +-
 apps/code/src/main/services/git/service.ts    |   5 +-
 .../src/main/services/pr-snapshot/backend.ts  |  52 ++---
 .../src/main/services/pr-snapshot/service.ts  |  48 +++--
 .../src/main/services/workflow/backend.ts     |  16 +-
 .../src/main/services/workflow/service.ts     |   6 +-
 .../home/components/HomeBoardView.tsx         |   7 +-
 .../components/HomeWorkstreamDetailPanel.tsx  |  11 +-
 .../home/components/WorkstreamBits.tsx        |  17 +-
 .../home/config/ActionEditorPanel.tsx         |  38 +++-
 .../features/home/config/ConfigMap.tsx        |   3 +-
 .../home/config/SituationOverviewPanel.tsx    |   7 +-
 .../features/home/config/SituationStation.tsx |   7 +-
 .../home/config/WorkflowMapArrows.tsx         |   8 +-
 .../features/home/config/freshActionId.ts     |   6 +
 .../features/home/config/workflowMapLayout.ts |  28 +--
 .../features/home/fixtures/demoSnapshot.ts    |  11 +-
 .../features/home/hooks/useBoundActions.ts    |  10 +-
 .../features/home/hooks/useHomeTasks.ts       |   8 +-
 .../features/home/hooks/usePrSnapshots.ts     |  11 +-
 .../home/hooks/useRunWorkstreamAction.ts      | 180 ++++++++++++++++--
 .../features/home/hooks/useSkillsForPicker.ts |   4 +-
 .../features/home/hooks/useWorkflow.ts        |   3 +-
 .../home/hooks/useWorkstreamPresentation.ts   |  16 +-
 .../features/home/stores/prSnapshotStore.ts   |   4 +-
 .../home/stores/workflowEditorStore.ts        |  23 +--
 .../features/home/utils/boardColumns.ts       |   8 +-
 .../features/home/utils/buildSnapshot.ts      |  54 ++----
 .../features/home/utils/situationDisplay.ts   |  17 +-
 .../features/sidebar/hooks/useSidebarData.ts  |   6 +-
 apps/code/src/shared/types/analytics.ts       |   2 +-
 apps/code/src/shared/types/pr-snapshot.ts     |  17 +-
 .../src/shared/types/workflow-classify.ts     |  38 ++--
 apps/code/src/shared/types/workflow.ts        |   9 +-
 35 files changed, 390 insertions(+), 329 deletions(-)
 create mode 100644 apps/code/src/renderer/features/home/config/freshActionId.ts

diff --git a/apps/code/src/main/db/repositories/home-workflow-repository.ts b/apps/code/src/main/db/repositories/home-workflow-repository.ts
index db4e3a8911..55075b446d 100644
--- a/apps/code/src/main/db/repositories/home-workflow-repository.ts
+++ b/apps/code/src/main/db/repositories/home-workflow-repository.ts
@@ -4,9 +4,7 @@ import { MAIN_TOKENS } from "../../di/tokens";
 import { homeWorkflowConfig } from "../schema";
 import type { DatabaseService } from "../service";
 
-// Persists the Home workflow row for `LocalWorkflowBackend`. Deletion plan
-// when workflow moves to PostHog: see `docs/workflow-architecture.md`.
-
+// Persists the Home workflow row for `LocalWorkflowBackend`.
 export interface PersistedWorkflowRow {
   id: string;
   version: number;
@@ -35,20 +33,14 @@ export class HomeWorkflowRepository {
   }
 
   upsert(row: PersistedWorkflowRow): void {
-    const existing = this.findById(row.id);
-    if (existing) {
-      this.db
-        .update(homeWorkflowConfig)
-        .set({
-          version: row.version,
-          json: row.json,
-          updatedAt: row.updatedAt,
-        })
-        .where(eq(homeWorkflowConfig.id, row.id))
-        .run();
-      return;
-    }
-    this.db.insert(homeWorkflowConfig).values(row).run();
+    this.db
+      .insert(homeWorkflowConfig)
+      .values(row)
+      .onConflictDoUpdate({
+        target: homeWorkflowConfig.id,
+        set: { version: row.version, json: row.json, updatedAt: row.updatedAt },
+      })
+      .run();
   }
 
   delete(id: string): void {
diff --git a/apps/code/src/main/di/container.ts b/apps/code/src/main/di/container.ts
index e7b1103994..5e4bc40e78 100644
--- a/apps/code/src/main/di/container.ts
+++ b/apps/code/src/main/di/container.ts
@@ -58,6 +58,8 @@ import { NewTaskLinkService } from "../services/new-task-link/service";
 import { NotificationService } from "../services/notification/service";
 import { OAuthService } from "../services/oauth/service";
 import { PosthogPluginService } from "../services/posthog-plugin/service";
+import { LocalPrSnapshotBackend } from "../services/pr-snapshot/backend";
+import { PrSnapshotService } from "../services/pr-snapshot/service";
 import { ProcessTrackingService } from "../services/process-tracking/service";
 import { ProvisioningService } from "../services/provisioning/service";
 import { settingsStore } from "../services/settingsStore";
@@ -70,8 +72,6 @@ import { UIService } from "../services/ui/service";
 import { UpdatesService } from "../services/updates/service";
 import { UsageMonitorService } from "../services/usage-monitor/service";
 import { WatcherRegistryService } from "../services/watcher-registry/service";
-import { LocalPrSnapshotBackend } from "../services/pr-snapshot/backend";
-import { PrSnapshotService } from "../services/pr-snapshot/service";
 import { LocalWorkflowBackend } from "../services/workflow/backend";
 import { WorkflowService } from "../services/workflow/service";
 import { WorkspaceService } from "../services/workspace/service";
@@ -159,14 +159,11 @@ container.bind(MAIN_TOKENS.TaskLinkService).to(TaskLinkService);
 container.bind(MAIN_TOKENS.InboxLinkService).to(InboxLinkService);
 container.bind(MAIN_TOKENS.NewTaskLinkService).to(NewTaskLinkService);
 container.bind(MAIN_TOKENS.WatcherRegistryService).to(WatcherRegistryService);
-// Backend choice = the single swap point between POC (local SQLite) and the
-// future PostHog-backed cloud workflow. See docs/workflow-architecture.md
-// and apps/code/src/main/services/workflow/backend.ts for the migration plan.
+// Swap point for the future PostHog-backed workflow (docs/workflow-architecture.md).
 container.bind(MAIN_TOKENS.WorkflowBackend).to(LocalWorkflowBackend);
 container.bind(MAIN_TOKENS.WorkflowService).to(WorkflowService);
-// PR/CI snapshot polling. Same swap-point pattern as the workflow backend:
-// LocalPrSnapshotBackend (gh CLI) today → CloudPrSnapshotBackend when PostHog
-// owns PR polling. See docs/workflow-architecture.md §5–6.
+// Same swap-point pattern: gh CLI today → CloudPrSnapshotBackend when PostHog
+// owns PR polling (docs/workflow-architecture.md §5–6).
 container.bind(MAIN_TOKENS.PrSnapshotBackend).to(LocalPrSnapshotBackend);
 container.bind(MAIN_TOKENS.PrSnapshotService).to(PrSnapshotService);
 container.bind(MAIN_TOKENS.WorkspaceService).to(WorkspaceService);
diff --git a/apps/code/src/main/services/git/service.ts b/apps/code/src/main/services/git/service.ts
index fdd1c3b195..fba2e4b248 100644
--- a/apps/code/src/main/services/git/service.ts
+++ b/apps/code/src/main/services/git/service.ts
@@ -1285,9 +1285,8 @@ export class GitService extends TypedEventEmitter<GitServiceEvents> {
   /**
    * Rich PR snapshot for the home tab: lifecycle state, CI verdict, review
    * decision, mergeability, and (for the user's own open PRs) the unresolved
-   * review-thread count. This is the local gh implementation of the PR-polling
-   * concern; the production PostHog worker produces the same `PrSnapshot`
-   * shape — see docs/workflow-architecture.md §5.
+   * review-thread count. Local gh implementation of the PR-polling concern; the
+   * production PostHog worker produces the same shape (docs/workflow-architecture.md §5).
    */
   public async getPrFull(prUrl: string): Promise<PrSnapshot | null> {
     const ref = parseGithubUrl(prUrl);
diff --git a/apps/code/src/main/services/pr-snapshot/backend.ts b/apps/code/src/main/services/pr-snapshot/backend.ts
index c2d840ef59..9b65215d95 100644
--- a/apps/code/src/main/services/pr-snapshot/backend.ts
+++ b/apps/code/src/main/services/pr-snapshot/backend.ts
@@ -1,23 +1,23 @@
 import { MAIN_TOKENS } from "@main/di/tokens";
 import type { GitService } from "@main/services/git/service";
+import { mapWithConcurrency } from "@posthog/git/concurrency";
 import type { TaskPrRef, TaskPrSnapshot } from "@shared/types/pr-snapshot";
 import { inject, injectable } from "inversify";
 
 /**
- * Single seam between {@link PrSnapshotService} and where PR/CI data comes
- * from. Today: the local gh CLI ({@link LocalPrSnapshotBackend}). When the
- * PostHog backend grows a PR-polling worker, a `CloudPrSnapshotBackend`
- * replaces this binding and the service above is unchanged — see
- * docs/workflow-architecture.md §5–6 for the migration plan.
+ * Single seam between {@link PrSnapshotService} and where PR/CI data comes from.
+ * Today the local gh CLI ({@link LocalPrSnapshotBackend}); a `CloudPrSnapshotBackend`
+ * replaces the binding when PostHog owns PR polling (docs/workflow-architecture.md §5–6).
  *
- * Contract for any implementation:
- * - `fetch` returns a snapshot per task it could resolve a PR for; tasks with
- *   no PR (or a transient failure) are simply omitted, never thrown.
- * - The returned snapshot shape is the canonical `PrSnapshot` regardless of
- *   source; resolution (cloud URL vs branch lookup) is the backend's concern.
+ * Implementations: `fetch` returns one snapshot per resolvable task (omit, never
+ * throw, on no-PR or failure); `onResolved` (optional) fires per task so callers
+ * can stream rather than wait for the slowest.
  */
 export interface PrSnapshotBackend {
-  fetch(tasks: TaskPrRef[]): Promise<TaskPrSnapshot[]>;
+  fetch(
+    tasks: TaskPrRef[],
+    onResolved?: (result: TaskPrSnapshot) => void,
+  ): Promise<TaskPrSnapshot[]>;
 }
 
 // gh is rate-limited and each task is independent network work, so cap how many
@@ -31,29 +31,29 @@ export class LocalPrSnapshotBackend implements PrSnapshotBackend {
     private readonly git: GitService,
   ) {}
 
-  async fetch(tasks: TaskPrRef[]): Promise<TaskPrSnapshot[]> {
-    const queue = [...tasks];
-    const out: TaskPrSnapshot[] = [];
-
-    const worker = async (): Promise<void> => {
-      for (let ref = queue.shift(); ref; ref = queue.shift()) {
+  async fetch(
+    tasks: TaskPrRef[],
+    onResolved?: (result: TaskPrSnapshot) => void,
+  ): Promise<TaskPrSnapshot[]> {
+    const resolved = await mapWithConcurrency(
+      tasks,
+      MAX_CONCURRENCY,
+      async (ref) => {
         const snapshot = await this.git
           .getTaskPrSnapshot(ref.taskId, ref.cloudPrUrl)
           .catch(() => null);
-        if (snapshot) out.push({ taskId: ref.taskId, snapshot });
-      }
-    };
-
-    await Promise.all(
-      Array.from({ length: Math.min(MAX_CONCURRENCY, queue.length) }, worker),
+        if (!snapshot) return null;
+        const result = { taskId: ref.taskId, snapshot };
+        onResolved?.(result);
+        return result;
+      },
     );
-    return out;
+    return resolved.filter((r): r is TaskPrSnapshot => r !== null);
   }
 }
 
 /**
- * Stub for the production path. Implemented when PostHog owns PR polling:
- * call the auth'd API, validate the response with `taskPrSnapshot`, return it.
+ * Production stub: call the auth'd PostHog API and validate with `taskPrSnapshot`.
  * Flipping the DI binding to this is the entire client-side migration.
  */
 @injectable()
diff --git a/apps/code/src/main/services/pr-snapshot/service.ts b/apps/code/src/main/services/pr-snapshot/service.ts
index 94ea7ba0a6..1cebff588c 100644
--- a/apps/code/src/main/services/pr-snapshot/service.ts
+++ b/apps/code/src/main/services/pr-snapshot/service.ts
@@ -13,17 +13,14 @@ import type { PrSnapshotBackend } from "./backend";
 
 const log = logger.scope("pr-snapshot");
 
-// How often the tracked tasks are re-polled. The renderer registers the tasks
-// it cares about via getSnapshots; this loop keeps them fresh in the
-// background. The production worker owns this cadence server-side.
+// How often tracked tasks are re-polled to stay fresh. The production worker
+// owns this cadence server-side.
 const POLL_INTERVAL_MS = 3 * 60 * 1000;
 
 /**
- * Owns the PR-snapshot lifecycle: which tasks to watch, their cached CI/review
- * state, the refresh loop, and the `Updated` event the renderer subscribes to.
- * Resolution + acquisition live behind {@link PrSnapshotBackend} so this
- * service is the same code whether snapshots come from the local gh CLI or,
- * later, a PostHog realtime feed (docs/workflow-architecture.md §5).
+ * Owns the PR-snapshot lifecycle: tracked tasks, cached CI/review state, the
+ * refresh loop, and the `Updated` event the renderer subscribes to. Resolution
+ * lives behind {@link PrSnapshotBackend} (docs/workflow-architecture.md §5).
  */
 @injectable()
 export class PrSnapshotService extends TypedEventEmitter<PrSnapshotEvents> {
@@ -50,15 +47,19 @@ export class PrSnapshotService extends TypedEventEmitter<PrSnapshotEvents> {
   }
 
   /**
-   * Returns the current snapshots for the requested tasks, marking them tracked
-   * for future polls. Tasks not yet cached are resolved inline so first paint
-   * has real data; the rest come from cache and stay fresh via the poll loop.
+   * Returns cached snapshots for the requested tasks and marks them tracked.
+   * Uncached tasks resolve in the background and stream in over `Updated`, so the
+   * home tab fills in progressively rather than blocking on the slowest `gh` call.
    */
   async getSnapshots(tasks: TaskPrRef[]): Promise<TaskPrSnapshot[]> {
     for (const ref of tasks) this.tracked.set(ref.taskId, ref);
 
     const missing = tasks.filter((ref) => !this.cache.has(ref.taskId));
-    if (missing.length > 0) await this.runRefresh(missing);
+    if (missing.length > 0) {
+      void this.runRefresh(missing).catch((error) => {
+        log.warn("Inline PR snapshot resolve failed", { error });
+      });
+    }
 
     const out: TaskPrSnapshot[] = [];
     for (const ref of tasks) {
@@ -90,20 +91,17 @@ export class PrSnapshotService extends TypedEventEmitter<PrSnapshotEvents> {
   }
 
   private async runRefresh(refs: TaskPrRef[]): Promise<void> {
-    const fresh = await this.backend.fetch(refs);
-    const changed: TaskPrSnapshot[] = [];
-
-    for (const { taskId, snapshot } of fresh) {
-      const previous = this.cache.get(taskId);
-      if (!previous || hasMaterialChange(previous, snapshot)) {
-        changed.push({ taskId, snapshot });
-      }
-      this.cache.set(taskId, snapshot);
-    }
+    // Emit per result as the backend resolves it (not one batch) so the renderer
+    // can reposition each workstream as soon as its PR data lands.
+    await this.backend.fetch(refs, (result) => this.applyResult(result));
+  }
 
-    if (changed.length > 0) {
-      this.emit(PrSnapshotEvent.Updated, changed);
-      log.info("PR snapshots updated", { count: changed.length });
+  /** Cache one resolved snapshot and emit it if it materially changed. */
+  private applyResult(result: TaskPrSnapshot): void {
+    const previous = this.cache.get(result.taskId);
+    this.cache.set(result.taskId, result.snapshot);
+    if (!previous || hasMaterialChange(previous, result.snapshot)) {
+      this.emit(PrSnapshotEvent.Updated, [result]);
     }
   }
 }
diff --git a/apps/code/src/main/services/workflow/backend.ts b/apps/code/src/main/services/workflow/backend.ts
index 503907dd25..9ef98312fb 100644
--- a/apps/code/src/main/services/workflow/backend.ts
+++ b/apps/code/src/main/services/workflow/backend.ts
@@ -8,16 +8,12 @@ const log = logger.scope("workflow-backend");
 
 /**
  * Single seam between `WorkflowService` and where the workflow config lives.
- * Today: local SQLite ({@link LocalWorkflowBackend}). When PostHog gains
- * cross-device workflow storage, a `CloudWorkflowBackend` replaces this
- * binding — see `docs/workflow-architecture.md` for the migration plan.
+ * Today local SQLite ({@link LocalWorkflowBackend}); a `CloudWorkflowBackend`
+ * replaces the binding for cross-device storage (docs/workflow-architecture.md).
  *
- * Stability contract for any implementation:
- * - `version` is monotonic. `save` is the only caller that bumps it.
- * - `load()` returns `null` for "no config yet" rather than throwing.
- * - Implementations validate against `workflowConfig` and drop bad rows
- *   on read (returning `null` so the service reseeds).
- * - `delete()` is idempotent.
+ * Implementations: `version` is monotonic (only `save` bumps it); `load()`
+ * returns `null` rather than throwing, validates against `workflowConfig`, and
+ * drops bad rows on read so the service reseeds; `delete()` is idempotent.
  */
 export interface WorkflowBackend {
   load(): Promise<WorkflowConfig | null>;
@@ -50,7 +46,7 @@ export class LocalWorkflowBackend implements WorkflowBackend {
     }
 
     // Authoritative `version` + `updatedAt` come from the row, not the JSON
-    // body, so a stale field in the blob can't shadow the monotonic counter.
+    // body, so a stale blob field can't shadow the monotonic counter.
     const parsed = workflowConfig.safeParse({
       ...(typeof raw === "object" && raw !== null ? raw : {}),
       version: row.version,
diff --git a/apps/code/src/main/services/workflow/service.ts b/apps/code/src/main/services/workflow/service.ts
index c84ab4abf4..91aae380e8 100644
--- a/apps/code/src/main/services/workflow/service.ts
+++ b/apps/code/src/main/services/workflow/service.ts
@@ -17,10 +17,8 @@ const WORKFLOW_ID = "default";
 const log = logger.scope("workflow");
 
 /**
- * Owns the workflow lifecycle (load → seed default → save → emit
- * `WorkflowChanged`). Storage details live behind {@link WorkflowBackend}
- * so this service is the same code whether persistence is local SQLite
- * or a remote PostHog API — see `docs/workflow-architecture.md`.
+ * Owns the workflow lifecycle (load → seed default → save → emit `Changed`).
+ * Storage lives behind {@link WorkflowBackend} (docs/workflow-architecture.md).
  */
 @injectable()
 export class WorkflowService extends TypedEventEmitter<WorkflowEvents> {
diff --git a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
index ce9191a338..d97aaccc8f 100644
--- a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
@@ -1,5 +1,6 @@
 import { ScrollArea } from "@radix-ui/themes";
 import type { SituationId } from "@shared/types/workflow";
+import { useMemo } from "react";
 import { buildBoardColumns, type HomeBoardColumn } from "../utils/boardColumns";
 import type { HomeSnapshot } from "../utils/buildSnapshot";
 import { SITUATION_VISUAL, situationCss } from "../utils/situationDisplay";
@@ -10,9 +11,9 @@ interface HomeBoardViewProps {
 }
 
 export function HomeBoardView({ snapshot }: HomeBoardViewProps) {
-  const columns = buildBoardColumns(
-    snapshot.needsAttention,
-    snapshot.inProgress,
+  const columns = useMemo(
+    () => buildBoardColumns(snapshot.needsAttention, snapshot.inProgress),
+    [snapshot.needsAttention, snapshot.inProgress],
   );
 
   return (
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
index a783c0c875..f55a041998 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
@@ -17,13 +17,13 @@ import { Badge, Button } from "@posthog/quill";
 import { Box, DropdownMenu, Flex, Text } from "@radix-ui/themes";
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
 import type { TaskRunStatus } from "@shared/types";
+import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import { useNavigationStore } from "@stores/navigationStore";
 import { openUrlInBrowser } from "@utils/browser";
 import { formatRelativeTimeShort } from "@utils/time";
 import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
 import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
 import type {
-  HomePullRequest,
   HomeWorkstream,
   HomeWorkstreamTask,
 } from "../utils/buildSnapshot";
@@ -218,7 +218,7 @@ function Section({ title, subtitle, children }: SectionProps) {
   );
 }
 
-function PrBlock({ pr, onOpen }: { pr: HomePullRequest; onOpen: () => void }) {
+function PrBlock({ pr, onOpen }: { pr: PrSnapshot; onOpen: () => void }) {
   return (
     <Section title="Pull request">
       <Flex
@@ -276,14 +276,14 @@ function PrBlock({ pr, onOpen }: { pr: HomePullRequest; onOpen: () => void }) {
   );
 }
 
-function PrStatePill({ pr }: { pr: HomePullRequest }) {
+function PrStatePill({ pr }: { pr: PrSnapshot }) {
   if (pr.state === "merged") return <Badge variant="info">Merged</Badge>;
   if (pr.state === "draft") return <Badge variant="default">Draft</Badge>;
   if (pr.state === "closed") return <Badge variant="default">Closed</Badge>;
   return <Badge variant="success">Open</Badge>;
 }
 
-function CiBadge({ status }: { status: HomePullRequest["ciStatus"] }) {
+function CiBadge({ status }: { status: PrSnapshot["ciStatus"] }) {
   if (status === "passing") {
     return (
       <Flex align="center" gap="1" className="text-(--green-11) text-[11px]">
@@ -364,8 +364,5 @@ function TaskStatusIcon({
       <XCircle size={11} weight="fill" className="shrink-0 text-(--red-9)" />
     );
   }
-  if (status === "cancelled") {
-    return <CircleDashed size={11} className="shrink-0 text-(--gray-10)" />;
-  }
   return <CircleDashed size={11} className="shrink-0 text-(--gray-10)" />;
 }
diff --git a/apps/code/src/renderer/features/home/components/WorkstreamBits.tsx b/apps/code/src/renderer/features/home/components/WorkstreamBits.tsx
index 6f3e59fd14..0b7fbb667f 100644
--- a/apps/code/src/renderer/features/home/components/WorkstreamBits.tsx
+++ b/apps/code/src/renderer/features/home/components/WorkstreamBits.tsx
@@ -15,11 +15,7 @@ import { Fragment } from "react";
 import type { BoundAction } from "../hooks/useBoundActions";
 import { SITUATION_VISUAL, situationCss } from "../utils/situationDisplay";
 
-/**
- * The square status anchor that leads every row / card. A tinted rounded tile
- * carrying the primary situation's glyph in its own hue — the single fastest
- * "what state is this in?" read on the page.
- */
+/** The tinted square status tile that leads every row / card, glyphed by primary situation. */
 export function StatusGlyph({
   sid,
   size = 30,
@@ -46,7 +42,6 @@ export function StatusGlyph({
   );
 }
 
-/** Small solid dot in a situation's colour — used in column headers. */
 export function StatusDot({ sid }: { sid: SituationId }) {
   const c = situationCss(SITUATION_VISUAL[sid].color);
   return (
@@ -100,9 +95,8 @@ export function CiIndicator({
 }
 
 /**
- * GitHub avatar for a PR author. Uses the same `github.com/<login>.png` source
- * + `.github-avatar` loading placeholder convention as the inbox. Hides itself
- * if the image can't load. Renders nothing without a login.
+ * GitHub avatar for a PR author. Same `github.com/<login>.png` source +
+ * `.github-avatar` placeholder as the inbox; hides itself if it can't load.
  */
 export function AuthorAvatar({
   login,
@@ -128,9 +122,8 @@ export function AuthorAvatar({
 }
 
 /**
- * The "more actions" overflow shared by the list row and board card: the
- * non-primary bound actions, then (separated) open-PR / open-task fallbacks.
- * Only the trigger/icon sizing differs between the two surfaces.
+ * The "more actions" overflow shared by the row and card: non-primary bound
+ * actions, then the open-PR / open-task fallbacks.
  */
 export function WorkstreamOverflowMenu({
   restBound,
diff --git a/apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx b/apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx
index 86a3800e26..90f4dcbe45 100644
--- a/apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx
+++ b/apps/code/src/renderer/features/home/config/ActionEditorPanel.tsx
@@ -1,5 +1,8 @@
 import { useSkillsForPicker } from "@features/home/hooks/useSkillsForPicker";
 import { useWorkflowEditorStore } from "@features/home/stores/workflowEditorStore";
+import { UnifiedModelSelector } from "@features/sessions/components/UnifiedModelSelector";
+import { useSettingsStore } from "@features/settings/stores/settingsStore";
+import { usePreviewConfig } from "@features/task-detail/hooks/usePreviewConfig";
 import { ArrowDown, ArrowUp, Trash, X } from "@phosphor-icons/react";
 import { Button } from "@posthog/quill";
 import { Card, Flex, Text, TextArea, TextField } from "@radix-ui/themes";
@@ -8,6 +11,7 @@ import {
   type SituationId,
   type WorkflowAction,
 } from "@shared/types/workflow";
+import { useMemo } from "react";
 import { SITUATION_TONE } from "./workflowMapLayout";
 
 interface Props {
@@ -31,6 +35,18 @@ export function ActionEditorPanel({
   const { skills, isLoading } = useSkillsForPicker();
   const selectedSkill = skills.find((s) => s.name === action.skillId) ?? null;
 
+  const lastUsedAdapter = useSettingsStore((s) => s.lastUsedAdapter);
+  const adapterForModel = action.adapter ?? lastUsedAdapter;
+  const { modelOption, isLoading: modelLoading } =
+    usePreviewConfig(adapterForModel);
+  // Show the action's pinned model in the picker, else the adapter's default.
+  const effectiveModelOption = useMemo(() => {
+    if (!modelOption || modelOption.type !== "select" || !action.model) {
+      return modelOption;
+    }
+    return { ...modelOption, currentValue: action.model };
+  }, [modelOption, action.model]);
+
   const meta = SITUATIONS.find((s) => s.id === situationId);
   const tone = SITUATION_TONE[situationId];
 
@@ -40,8 +56,7 @@ export function ActionEditorPanel({
 
   function handleRemove() {
     removeAction(situationId, action.id);
-    // Fall back to the situation overview so the user keeps context after
-    // deleting the action they were editing.
+    // Fall back to the situation overview so the user keeps context.
     selectSituation(situationId);
   }
 
@@ -114,6 +129,25 @@ export function ActionEditorPanel({
               onChange={(e) => patch({ prompt: e.target.value })}
             />
           </Field>
+
+          <Field label="Model">
+            <div className="self-start">
+              <UnifiedModelSelector
+                modelOption={effectiveModelOption}
+                adapter={adapterForModel}
+                onAdapterChange={(a) => patch({ adapter: a, model: undefined })}
+                onModelChange={(m) =>
+                  patch({ model: m, adapter: adapterForModel })
+                }
+                isConnecting={modelLoading}
+              />
+            </div>
+            {action.model ? null : (
+              <Text className="mt-1 text-[10px] text-gray-10">
+                Runs on your default model unless you pick one.
+              </Text>
+            )}
+          </Field>
         </Card>
 
         <Flex justify="between" align="center" className="mt-3">
diff --git a/apps/code/src/renderer/features/home/config/ConfigMap.tsx b/apps/code/src/renderer/features/home/config/ConfigMap.tsx
index 50bd99eb98..a1f485ab0f 100644
--- a/apps/code/src/renderer/features/home/config/ConfigMap.tsx
+++ b/apps/code/src/renderer/features/home/config/ConfigMap.tsx
@@ -27,7 +27,6 @@ export function ConfigMap() {
   const diagnostics = useWorkflowEditorStore((s) => s.diagnostics);
   const selection = useWorkflowEditorStore((s) => s.selection);
   const beginEdit = useWorkflowEditorStore((s) => s.beginEdit);
-  const discardEdit = useWorkflowEditorStore((s) => s.discardEdit);
   const setDiagnostics = useWorkflowEditorStore((s) => s.setDiagnostics);
   const clearSelection = useWorkflowEditorStore((s) => s.clearSelection);
 
@@ -183,7 +182,7 @@ export function ConfigMap() {
             <Button
               size="xs"
               variant="link-muted"
-              onClick={() => discardEdit(workflow)}
+              onClick={() => beginEdit(workflow)}
               disabled={!dirty}
             >
               Discard
diff --git a/apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx b/apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx
index 9d665c9e12..6bf7927bf5 100644
--- a/apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx
+++ b/apps/code/src/renderer/features/home/config/SituationOverviewPanel.tsx
@@ -7,6 +7,7 @@ import {
   type SituationId,
   type WorkflowAction,
 } from "@shared/types/workflow";
+import { freshActionId } from "./freshActionId";
 import { SITUATION_TONE } from "./workflowMapLayout";
 
 interface Props {
@@ -14,12 +15,6 @@ interface Props {
   actions: WorkflowAction[];
 }
 
-function freshActionId(existing: string[]): string {
-  let n = 1;
-  while (existing.includes(`action_${n}`)) n++;
-  return `action_${n}`;
-}
-
 export function SituationOverviewPanel({ situationId, actions }: Props) {
   const addAction = useWorkflowEditorStore((s) => s.addAction);
   const removeAction = useWorkflowEditorStore((s) => s.removeAction);
diff --git a/apps/code/src/renderer/features/home/config/SituationStation.tsx b/apps/code/src/renderer/features/home/config/SituationStation.tsx
index 7db00e00aa..02a96bf1ac 100644
--- a/apps/code/src/renderer/features/home/config/SituationStation.tsx
+++ b/apps/code/src/renderer/features/home/config/SituationStation.tsx
@@ -7,6 +7,7 @@ import {
   type WorkflowAction,
   type WorkflowBindings,
 } from "@shared/types/workflow";
+import { freshActionId } from "./freshActionId";
 import { SITUATION_TONE, STATION_LAYOUT } from "./workflowMapLayout";
 
 interface Props {
@@ -14,12 +15,6 @@ interface Props {
   bindings: WorkflowBindings;
 }
 
-function freshActionId(existing: string[]): string {
-  let n = 1;
-  while (existing.includes(`action_${n}`)) n++;
-  return `action_${n}`;
-}
-
 export function SituationStation({ id, bindings }: Props) {
   const layout = STATION_LAYOUT[id];
   const tone = SITUATION_TONE[id];
diff --git a/apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx b/apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx
index 7c0700cf5d..a72bd81a81 100644
--- a/apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx
+++ b/apps/code/src/renderer/features/home/config/WorkflowMapArrows.tsx
@@ -48,14 +48,12 @@ export function WorkflowMapArrows() {
         const ca = stationCentre(a);
         const cb = stationCentre(b);
 
-        // Pick start/end points on the *edges* of the station rectangles
-        // along the direction of travel, so the line doesn't run under the
-        // station card.
+        // Start/end on the rectangle edges along the direction of travel, so
+        // the line doesn't run under the station card.
         const start = edgePoint(a, cb);
         const end = edgePoint(b, ca);
 
-        // Slight curve via a quadratic Bézier — control point pulled toward
-        // the midpoint with a small perpendicular offset.
+        // Slight curve via a quadratic Bézier — control point offset perpendicular from the midpoint.
         const mx = (start.x + end.x) / 2;
         const my = (start.y + end.y) / 2;
         const dx = end.x - start.x;
diff --git a/apps/code/src/renderer/features/home/config/freshActionId.ts b/apps/code/src/renderer/features/home/config/freshActionId.ts
new file mode 100644
index 0000000000..b8c0c9dadd
--- /dev/null
+++ b/apps/code/src/renderer/features/home/config/freshActionId.ts
@@ -0,0 +1,6 @@
+// Next unused `action_N` id given the ids already in a situation's binding list.
+export function freshActionId(existing: string[]): string {
+  let n = 1;
+  while (existing.includes(`action_${n}`)) n++;
+  return `action_${n}`;
+}
diff --git a/apps/code/src/renderer/features/home/config/workflowMapLayout.ts b/apps/code/src/renderer/features/home/config/workflowMapLayout.ts
index aab3f46cdf..fe46e4af16 100644
--- a/apps/code/src/renderer/features/home/config/workflowMapLayout.ts
+++ b/apps/code/src/renderer/features/home/config/workflowMapLayout.ts
@@ -1,9 +1,7 @@
 import type { SituationId } from "@shared/types/workflow";
 
-// Fixed canvas layout. Positions are NOT user-editable — the workflow shape
-// is a designer-authored map, not a user-authored graph. Numbers are unitless
-// "canvas points"; the renderer scales them into a responsive container.
-
+// Fixed designer-authored canvas layout, not a user-editable graph. Numbers are
+// unitless "canvas points" the renderer scales into a responsive container.
 export const MAP_WIDTH = 1100;
 export const MAP_HEIGHT = 720;
 
@@ -15,24 +13,13 @@ export interface StationLayout {
 }
 
 export const STATION_LAYOUT: Record<SituationId, StationLayout> = {
-  // Top — entry point
   working: { x: 420, y: 30, w: 260, h: 110 },
-
-  // Hub — most work passes through here
   in_review: { x: 420, y: 200, w: 260, h: 110 },
-
-  // Side stations — attention-needing variants of in_review
   ci_failing: { x: 60, y: 370, w: 260, h: 110 },
   changes_requested: { x: 420, y: 370, w: 260, h: 110 },
   comments_waiting: { x: 780, y: 370, w: 260, h: 110 },
-
-  // Approval gate
   ready_to_merge: { x: 420, y: 540, w: 260, h: 110 },
-
-  // Modifier — parked to the right, can apply at any stage
   stale: { x: 780, y: 30, w: 260, h: 110 },
-
-  // Terminal — bottom right, off the active flow
   done: { x: 780, y: 540, w: 260, h: 110 },
 };
 
@@ -43,10 +30,8 @@ export interface FlowArrow {
   kind: "main" | "branch";
 }
 
-// Decorative arrows. These are NOT runtime edges — they're hand-authored
-// hints about the typical progression of work, drawn dotted/subtle so the
-// user reads them as guidance, not promises. The system doesn't enforce or
-// observe these transitions.
+// Decorative hints about the typical progression of work — NOT runtime edges.
+// The system doesn't enforce or observe these transitions.
 export const FLOW_ARROWS: FlowArrow[] = [
   { from: "working", to: "in_review", kind: "main" },
   { from: "in_review", to: "ci_failing", kind: "branch" },
@@ -59,9 +44,8 @@ export const FLOW_ARROWS: FlowArrow[] = [
   { from: "ready_to_merge", to: "done", kind: "main" },
 ];
 
-// Per-situation accent colours for the canvas station. Indices on the Radix
-// scale (`*-3` bg, `*-8` border) are chosen to read in both light and dark
-// modes without relying on coloured shadows.
+// Per-situation accent colours for the canvas station. Radix scale indices
+// (`*-3` bg, `*-8` border) read in both light and dark modes.
 export const SITUATION_TONE: Record<
   SituationId,
   { accent: string; bg: string; label: string }
diff --git a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
index 6bbbf9e134..6907dc11e4 100644
--- a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
+++ b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
@@ -1,9 +1,6 @@
+import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import { classify } from "@shared/types/workflow-classify";
-import type {
-  HomePullRequest,
-  HomeSnapshot,
-  HomeWorkstream,
-} from "../utils/buildSnapshot";
+import type { HomeSnapshot, HomeWorkstream } from "../utils/buildSnapshot";
 
 function withSituations(
   workstreams: Omit<HomeWorkstream, "situations">[],
@@ -35,9 +32,7 @@ const HOUR = 60 * 60 * 1000;
 const DAY = 24 * HOUR;
 const now = () => Date.now();
 
-function pr(
-  overrides: Partial<HomePullRequest> & { url: string },
-): HomePullRequest {
+function pr(overrides: Partial<PrSnapshot> & { url: string }): PrSnapshot {
   return {
     number: 0,
     title: "",
diff --git a/apps/code/src/renderer/features/home/hooks/useBoundActions.ts b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
index 71a2635a03..0accd8cbc9 100644
--- a/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
+++ b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
@@ -14,11 +14,8 @@ export interface BoundAction extends WorkflowAction {
 }
 
 /**
- * Joins a workstream's classified situations against the persisted workflow's
- * bindings and returns the deduped list of actions the user has bound to any
- * matching situation. Order follows the workstream's situations array (which
- * preserves classifier output order), then the action order within each
- * binding list.
+ * Joins a workstream's situations against the workflow bindings and returns the
+ * deduped actions bound to any matching situation, in situation then binding order.
  */
 export function useBoundActions(workstream: HomeWorkstream): BoundAction[] {
   const { workflow } = useWorkflow();
@@ -31,8 +28,7 @@ export function useBoundActions(workstream: HomeWorkstream): BoundAction[] {
       const actions = bindings?.[sid] ?? [];
       const meta = SITUATIONS.find((s) => s.id === sid);
       for (const action of actions) {
-        // Dedup if the user bound the same action id under multiple
-        // situations — shouldn't happen via the editor but be defensive.
+        // Dedup the same action bound under multiple situations.
         const dedupKey = `${action.skillId}::${action.label}`;
         if (seen.has(dedupKey)) continue;
         seen.add(dedupKey);
diff --git a/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts b/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
index 6a791f737a..030d84482e 100644
--- a/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
+++ b/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
@@ -21,11 +21,9 @@ export interface HomeTasks {
 const byActivity = (a: TaskData, b: TaskData) =>
   b.lastActivityAt - a.lastActivityAt;
 
-// The home tab aggregates ALL of the current user's tasks — not the sidebar's
-// workspace-scoped, paginated slice. It sources the full task list directly
-// (createdBy = me) and reuses the sidebar's Task → TaskData mapping, then lets
-// buildSnapshot group + classify. No history slice, no workspace filter, so
-// cloud tasks and tasks without a local checkout still surface.
+// Home aggregates ALL of the user's tasks, not the sidebar's workspace-scoped
+// slice: it sources the full task list (createdBy = me) and reuses the sidebar's
+// Task → TaskData mapping, so cloud tasks and tasks without a checkout surface.
 export function useHomeTasks(): HomeTasks {
   const showInternal = useSidebarStore((s) => s.showInternal);
   const { data: tasks = [], isLoading } = useTasks({ showInternal });
diff --git a/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts b/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
index 1a71cb2d5c..6ca0b97f40 100644
--- a/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
+++ b/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
@@ -5,13 +5,10 @@ import { useMemo } from "react";
 import { usePrSnapshotStore } from "../stores/prSnapshotStore";
 
 /**
- * Resolves PR/CI snapshots for the given tasks as a `Map` keyed by task id.
- *
- * The query both registers these tasks for background polling in main and
- * seeds the first paint; the subscription registrar
- * (features/home/subscriptions.ts) keeps the store fresh after that, so store
- * values win over the initial query result. Tasks without a PR are simply
- * absent from the map — the classifier treats that as "no PR data".
+ * Resolves PR/CI snapshots for the given tasks as a `Map` keyed by task id. The
+ * query registers the tasks for background polling and seeds the first paint;
+ * the subscription store (features/home/subscriptions.ts) wins after that. Tasks
+ * without a PR are simply absent from the map.
  */
 export function usePrSnapshots(refs: TaskPrRef[]): Map<string, PrSnapshot> {
   const trpc = useTRPC();
diff --git a/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
index 159c7356a0..3f72e9b31d 100644
--- a/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
+++ b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
@@ -1,27 +1,181 @@
+import { useAuthStateValue } from "@features/auth/hooks/authQueries";
+import { resolveDefaultModel } from "@features/inbox/utils/resolveDefaultModel";
+import { useSettingsStore } from "@features/settings/stores/settingsStore";
+import type {
+  TaskCreationInput,
+  TaskService,
+} from "@features/task-detail/service/service";
+import { useCreateTask } from "@features/tasks/hooks/useTasks";
+import { useConnectivity } from "@hooks/useConnectivity";
+import { useUserRepositoryIntegration } from "@hooks/useIntegrations";
+import { get } from "@renderer/di/container";
+import { RENDERER_TOKENS } from "@renderer/di/tokens";
+import { ANALYTICS_EVENTS } from "@shared/types/analytics";
+import { getCloudUrlFromRegion } from "@shared/utils/urls";
 import { useNavigationStore } from "@stores/navigationStore";
+import { pendingTaskPromptStoreApi } from "@stores/pendingTaskPromptStore";
+import { track } from "@utils/analytics";
+import { logger } from "@utils/logger";
 import { toast } from "@utils/toast";
-import { useCallback } from "react";
+import { useCallback, useRef } from "react";
 import type { HomeWorkstream } from "../utils/buildSnapshot";
 import type { BoundAction } from "./useBoundActions";
 
-// Routes a bound workflow action into the new-task screen with the prompt
-// prefilled, rather than firing `taskService.createTask` directly: the user
-// still picks skill/branch/model on that screen, and we don't want to
-// duplicate that picker logic here.
+const log = logger.scope("home-quick-action");
+
+// The agent runs the bound skill when the prompt starts with `/<skill-id>`, so
+// embed it directly; the descriptive prompt follows as the instruction.
+function buildSkillPrompt(action: BoundAction): string {
+  const command = `/${action.skillId}`;
+  const body = action.prompt.trim();
+  return body ? `${command}\n\n${body}` : command;
+}
+
+/**
+ * Runs a bound workflow action as a one-click cloud task: embeds the skill as a
+ * `/<skill-id>` prefix and starts a cloud run on the workstream's repo + branch.
+ * Falls back to the new-task screen (prompt prefilled) when it can't start
+ * cleanly — offline, signed out, or the repo has no GitHub integration.
+ */
 export function useRunWorkstreamAction() {
   const navigateToTaskInput = useNavigationStore((s) => s.navigateToTaskInput);
+  const navigateToTask = useNavigationStore((s) => s.navigateToTask);
+  const navigateToPendingTask = useNavigationStore(
+    (s) => s.navigateToPendingTask,
+  );
+  const isAuthenticated = useAuthStateValue(
+    (state) => state.status === "authenticated",
+  );
+  const cloudRegion = useAuthStateValue((state) => state.cloudRegion);
+  const { isOnline } = useConnectivity();
+  const { invalidateTasks } = useCreateTask();
+  const { getUserIntegrationIdForRepo } = useUserRepositoryIntegration();
+  const lastUsedAdapter = useSettingsStore((s) => s.lastUsedAdapter);
+  const lastUsedModel = useSettingsStore((s) => s.lastUsedModel);
+  const inFlightRef = useRef(false);
 
   return useCallback(
     (action: BoundAction, workstream: HomeWorkstream) => {
-      navigateToTaskInput({
-        initialPrompt: action.prompt,
-        initialCloudRepository: workstream.repoName ?? undefined,
+      const promptText = buildSkillPrompt(action);
+      // The GitHub integration map and cloud repo selector are keyed by the full
+      // "org/repo" slug, so resolve from `repoFullPath`, not the bare `repoName`.
+      const repo = workstream.repoFullPath?.toLowerCase() ?? null;
+      const branch = workstream.branch ?? undefined;
+      const githubUserIntegrationId = repo
+        ? getUserIntegrationIdForRepo(repo)
+        : undefined;
+
+      const fallbackToTaskInput = () => {
+        navigateToTaskInput({
+          initialPrompt: promptText,
+          initialCloudRepository: repo ?? undefined,
+        });
+      };
+
+      // One-click needs an online, authed session and a repo resolvable to a
+      // GitHub integration; anything else routes to the new-task screen.
+      const canOneClick =
+        isAuthenticated && isOnline && !!repo && !!githubUserIntegrationId;
+      if (!canOneClick) {
+        fallbackToTaskInput();
+        return;
+      }
+
+      if (inFlightRef.current) return;
+      inFlightRef.current = true;
+
+      const pendingTaskKey =
+        globalThis.crypto?.randomUUID?.() ?? `pending-${Date.now()}`;
+      pendingTaskPromptStoreApi.set(pendingTaskKey, {
+        promptText,
+        attachments: [],
       });
-      toast.info(
-        action.label,
-        `Pick the "${action.skillId}" skill on the next screen — prompt is prefilled.`,
-      );
+      navigateToPendingTask(pendingTaskKey);
+
+      void (async () => {
+        try {
+          // The cloud runtime requires a model: action-pinned, then last-used,
+          // then the adapter's server default.
+          const adapter = action.adapter ?? lastUsedAdapter;
+          let model = action.model ?? lastUsedModel ?? undefined;
+          if (!model && cloudRegion) {
+            model = await resolveDefaultModel(
+              getCloudUrlFromRegion(cloudRegion),
+              adapter,
+            );
+          }
+          if (!model) {
+            pendingTaskPromptStoreApi.clear(pendingTaskKey);
+            toast.error("Couldn't start task", {
+              description:
+                "No model is configured. Pick a model for this quick action.",
+            });
+            fallbackToTaskInput();
+            return;
+          }
+
+          // `content` carries the skill prefix to the agent; `taskDescription`
+          // is the clean prompt used for the task title and description.
+          const input: TaskCreationInput = {
+            content: promptText,
+            taskDescription: action.prompt.trim() || action.label,
+            repository: repo,
+            workspaceMode: "cloud",
+            branch,
+            githubUserIntegrationId,
+            adapter,
+            model,
+          };
+
+          const taskService = get<TaskService>(RENDERER_TOKENS.TaskService);
+          const result = await taskService.createTask(input, (output) => {
+            invalidateTasks(output.task);
+            pendingTaskPromptStoreApi.move(pendingTaskKey, output.task.id);
+            navigateToTask(output.task);
+          });
+
+          if (result.success) {
+            track(ANALYTICS_EVENTS.TASK_CREATED, {
+              auto_run: false,
+              created_from: "home-quick-action",
+              repository_provider: "github",
+              workspace_mode: "cloud",
+              has_branch: !!branch,
+              cloud_run_source: "manual",
+              adapter,
+            });
+            return;
+          }
+          pendingTaskPromptStoreApi.clear(pendingTaskKey);
+          toast.error("Failed to start task", { description: result.error });
+          log.error("Quick action task creation failed", {
+            failedStep: result.failedStep,
+            error: result.error,
+          });
+          fallbackToTaskInput();
+        } catch (error) {
+          pendingTaskPromptStoreApi.clear(pendingTaskKey);
+          const description =
+            error instanceof Error ? error.message : "Unknown error";
+          toast.error("Failed to start task", { description });
+          log.error("Quick action task creation threw", { error });
+          fallbackToTaskInput();
+        } finally {
+          inFlightRef.current = false;
+        }
+      })();
     },
-    [navigateToTaskInput],
+    [
+      navigateToTaskInput,
+      navigateToTask,
+      navigateToPendingTask,
+      isAuthenticated,
+      isOnline,
+      cloudRegion,
+      invalidateTasks,
+      getUserIntegrationIdForRepo,
+      lastUsedAdapter,
+      lastUsedModel,
+    ],
   );
 }
diff --git a/apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts b/apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts
index ba5d38164c..42e8ef0712 100644
--- a/apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts
+++ b/apps/code/src/renderer/features/home/hooks/useSkillsForPicker.ts
@@ -1,9 +1,7 @@
 import { useTRPC } from "@renderer/trpc";
 import { useQuery } from "@tanstack/react-query";
 
-// Thin wrapper around the existing skills router — used by the workflow
-// action editor to populate the skill dropdown so the user picks a real
-// skill instead of typing an id.
+// Thin wrapper around the skills router for the action editor's skill dropdown.
 export function useSkillsForPicker() {
   const trpc = useTRPC();
   const query = useQuery(trpc.skills.list.queryOptions());
diff --git a/apps/code/src/renderer/features/home/hooks/useWorkflow.ts b/apps/code/src/renderer/features/home/hooks/useWorkflow.ts
index 4925c042ec..5486940860 100644
--- a/apps/code/src/renderer/features/home/hooks/useWorkflow.ts
+++ b/apps/code/src/renderer/features/home/hooks/useWorkflow.ts
@@ -2,8 +2,7 @@ import { useTRPC } from "@renderer/trpc";
 import { useQuery } from "@tanstack/react-query";
 
 // Single-query window into the persisted WorkflowConfig. Subscription updates
-// arrive via features/home/subscriptions.ts and write back through the same
-// query key so consumers re-render without orchestration here.
+// write back through the same query key (features/home/subscriptions.ts).
 export function useWorkflow() {
   const trpc = useTRPC();
   const query = useQuery(trpc.workflow.get.queryOptions());
diff --git a/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts b/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
index 881513d839..b3de913946 100644
--- a/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
+++ b/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
@@ -1,10 +1,11 @@
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import type { SituationId } from "@shared/types/workflow";
+import { pickPrimarySituation } from "@shared/types/workflow-classify";
 import { useNavigationStore } from "@stores/navigationStore";
 import { openUrlInBrowser } from "@utils/browser";
-import type { HomePullRequest, HomeWorkstream } from "../utils/buildSnapshot";
+import type { HomeWorkstream } from "../utils/buildSnapshot";
 import {
-  primarySituationId,
   SITUATION_VISUAL,
   type SituationCss,
   situationCss,
@@ -13,8 +14,7 @@ import { type BoundAction, useBoundActions } from "./useBoundActions";
 import { useRunWorkstreamAction } from "./useRunWorkstreamAction";
 
 export interface WorkstreamPresentation {
-  pr: HomePullRequest | null;
-  headTask: HomeWorkstream["tasks"][number] | undefined;
+  pr: PrSnapshot | null;
   title: string;
   primarySid: SituationId;
   accent: SituationCss;
@@ -35,9 +35,8 @@ export interface WorkstreamPresentation {
 }
 
 /**
- * Shared presentation + action derivation for a workstream. The list row and
- * board card differ only in layout — everything about *what* to show and *what*
- * the affordances do lives here so the two renderings can't drift.
+ * Shared presentation + action derivation for a workstream, so the list row and
+ * board card (which differ only in layout) can't drift on what they show or do.
  */
 export function useWorkstreamPresentation(
   workstream: HomeWorkstream,
@@ -51,7 +50,7 @@ export function useWorkstreamPresentation(
   const headTask = workstream.tasks[0];
   const title =
     pr?.title ?? headTask?.title ?? workstream.branch ?? "Workstream";
-  const primarySid = primarySituationId(workstream.situations) ?? "working";
+  const primarySid = pickPrimarySituation(workstream.situations) ?? "working";
   const accent = situationCss(SITUATION_VISUAL[primarySid].color);
   const author = pr?.author && !pr.isCurrentUserAuthor ? pr.author : null;
   const extraSituations = workstream.situations.filter(
@@ -69,7 +68,6 @@ export function useWorkstreamPresentation(
 
   return {
     pr,
-    headTask,
     title,
     primarySid,
     accent,
diff --git a/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts b/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
index 22265fd6da..70560b24a2 100644
--- a/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
+++ b/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
@@ -2,9 +2,7 @@ import type { PrSnapshot, TaskPrSnapshot } from "@shared/types/pr-snapshot";
 import { create } from "zustand";
 
 // Subscription-fed cache of PR/CI snapshots, keyed by task id. Pure UI state
-// per R2: the main PrSnapshotService owns resolution and freshness; this store
-// just mirrors what it pushes over `prSnapshot.onUpdated` so components
-// re-render.
+// (R2): mirrors what PrSnapshotService pushes over `prSnapshot.onUpdated`.
 interface PrSnapshotStore {
   byTaskId: Record<string, PrSnapshot>;
   upsertMany: (results: TaskPrSnapshot[]) => void;
diff --git a/apps/code/src/renderer/features/home/stores/workflowEditorStore.ts b/apps/code/src/renderer/features/home/stores/workflowEditorStore.ts
index d893fbd0d1..7be0de8058 100644
--- a/apps/code/src/renderer/features/home/stores/workflowEditorStore.ts
+++ b/apps/code/src/renderer/features/home/stores/workflowEditorStore.ts
@@ -9,10 +9,8 @@ import {
 } from "@shared/types/workflow";
 import { create } from "zustand";
 
-// Uncommitted editor state for the Config view. Persisted workflow lives in
-// the tRPC query cache; this store only holds the in-flight draft, dirty
-// flag, and validation diagnostics.
-
+// Uncommitted editor state for the Config view — the in-flight draft, dirty
+// flag, and diagnostics. The persisted workflow lives in the tRPC query cache.
 export type Selection =
   | { kind: "action"; situationId: SituationId; actionId: string }
   | { kind: "situation"; situationId: SituationId }
@@ -26,7 +24,6 @@ interface WorkflowEditorStore {
   selection: Selection;
 
   beginEdit(persisted: WorkflowConfig): void;
-  discardEdit(persisted: WorkflowConfig): void;
   addAction(situation: SituationId, action: WorkflowAction): void;
   updateAction(
     situation: SituationId,
@@ -50,9 +47,8 @@ function serialize(draft: WorkflowDraft): string {
 }
 
 function toDraft(config: WorkflowConfig): WorkflowDraft {
-  // Normalize bindings to cover every situation key (the schema's `z.record`
-  // technically allows partial maps). Consumers can then read
-  // `bindings[sid]` without optional-chaining.
+  // Normalize bindings to cover every situation key (z.record allows partial
+  // maps) so consumers can read `bindings[sid]` without optional-chaining.
   const bindings = Object.fromEntries(
     SITUATION_IDS.map((sid) => [sid, config.bindings[sid] ?? []]),
   ) as WorkflowBindings;
@@ -93,17 +89,6 @@ export const useWorkflowEditorStore = create<WorkflowEditorStore>(
       });
     },
 
-    discardEdit(persisted) {
-      const draft = toDraft(persisted);
-      set({
-        draft,
-        baselineSerialized: serialize(draft),
-        dirty: false,
-        diagnostics: [],
-        selection: null,
-      });
-    },
-
     addAction(situation, action) {
       const { draft, baselineSerialized } = get();
       if (!draft) return;
diff --git a/apps/code/src/renderer/features/home/utils/boardColumns.ts b/apps/code/src/renderer/features/home/utils/boardColumns.ts
index e4f3da8b71..a098e6374a 100644
--- a/apps/code/src/renderer/features/home/utils/boardColumns.ts
+++ b/apps/code/src/renderer/features/home/utils/boardColumns.ts
@@ -9,9 +9,8 @@ export type HomeBoardColumn = {
   workstreams: HomeWorkstream[];
 };
 
-// Columns shown on the board, left → right. We omit `done` from the active
-// view (terminal situations don't need a column — they should fall off) and
-// `stale` (it's a modifier, not a workflow stage; it surfaces as a chip).
+// Board columns, left → right. `done` (terminal) and `stale` (a modifier, shown
+// as a chip) are omitted.
 const BOARD_COLUMN_IDS: SituationId[] = [
   "working",
   "in_review",
@@ -28,8 +27,7 @@ export function columnForWorkstream(
   if (!primary) return null;
   // Push terminal/done situations off the active board.
   if (primary === "done") return null;
-  // `stale` alone (no PR situation) is still useful to surface — bucket it
-  // into `working` since that's where stale-no-PR work belongs visually.
+  // `stale` alone (no PR situation) buckets into `working`.
   if (primary === "stale") return "working";
   return primary;
 }
diff --git a/apps/code/src/renderer/features/home/utils/buildSnapshot.ts b/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
index a34af13f2e..cf27e1c26c 100644
--- a/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
+++ b/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
@@ -15,12 +15,6 @@ export type HomeActiveAgent = {
   cloudPrUrl: string | null;
 };
 
-// The PR/CI snapshot a workstream is classified against. Populated from the
-// gh-backed PrSnapshotService (null until its first fetch resolves) and by demo
-// fixtures; the production PostHog feed produces the same shape — see
-// docs/workflow-architecture.md.
-export type HomePullRequest = PrSnapshot;
-
 export type HomeWorkstreamTask = {
   id: string;
   title: string;
@@ -31,10 +25,16 @@ export type HomeWorkstreamTask = {
 
 export type HomeWorkstream = {
   id: string;
+  /** Bare repo name (e.g. "posthog") — for display only. */
   repoName: string | null;
+  /**
+   * Full "org/repo" slug, lowercased. The key the GitHub integration map and
+   * cloud repo selectors use, so quick actions resolve from this, not `repoName`.
+   */
+  repoFullPath?: string | null;
   branch: string | null;
   prUrl: string | null;
-  pr: HomePullRequest | null;
+  pr: PrSnapshot | null;
   tasks: HomeWorkstreamTask[];
   /** Situations this workstream is in — drives board placement + bound actions. */
   situations: SituationId[];
@@ -52,10 +52,8 @@ const RUNNING_STATUSES: ReadonlySet<TaskRunStatus> = new Set([
   "in_progress",
 ]);
 
-// How long a still-`in_progress` task can go without activity before we stop
-// treating it as actually running. A live run idles for seconds, not half an
-// hour — past this it's a status the server never transitioned to a terminal
-// state, not a live agent.
+// Past this idle gap a still-`in_progress` run is treated as a status the server
+// never closed out, not a live agent.
 const RUNNING_STALE_THRESHOLD_MS = 30 * 60 * 1000;
 
 // Situations that escalate a workstream into the "Needs attention" bucket on
@@ -71,17 +69,10 @@ function isRunning(status?: TaskRunStatus): boolean {
   return !!status && RUNNING_STATUSES.has(status);
 }
 
-// A task only belongs in the "Running" strip if its run status is live *and*
-// it still looks genuinely active. A queued/in_progress status isn't enough on
-// its own:
-//   - Once a PR has been opened the agent has moved past working into review,
-//     even if the cloud run status is still stuck at in_progress.
-//   - A run with no activity for a while is a stale status the server never
-//     transitioned to a terminal state.
-// Both cases fall through to workstream grouping, where classify() routes them
-// to "In review" / "Working" / "Stale". A session that's actively generating
-// or waiting on the user is always live, so it's exempt from the stale check
-// (its activity timestamp may not tick while it waits).
+// "Running" requires a live status AND genuine activity. An open PR means the
+// agent moved past working into review; a long-idle run is a status the server
+// never closed out — both fall through to grouping/classify(). An actively
+// generating or waiting session is always live (its activity timestamp may not tick).
 function isActivelyRunning(
   task: TaskData,
   now: number,
@@ -93,12 +84,9 @@ function isActivelyRunning(
   return now - task.lastActivityAt <= RUNNING_STALE_THRESHOLD_MS;
 }
 
-// Grouping key precedence (per docs/home-tab.md §5):
-// PR URL → repo+branch → worktree path. `prUrl` here is the *resolved* URL
-// (cloud run output or a branch lookup), so a PR that only exists on the branch
-// still groups a task under its PR. Tasks with none of these — e.g. an old
-// cloud task with no PR and no local checkout — return null and are skipped, so
-// Home stays a view of actual code work rather than every historical task.
+// Grouping key precedence (docs/home-tab.md §5): resolved PR URL → repo+branch →
+// worktree path. Tasks with none (e.g. an old cloud task, no PR, no checkout)
+// are skipped, so Home stays a view of actual code work.
 function workstreamKey(task: TaskData, prUrl: string | null): string | null {
   if (prUrl) return `pr:${prUrl}`;
   const repo = task.repository?.name ?? null;
@@ -116,9 +104,8 @@ export function buildSnapshotFromTasks(
   const allTasks = [...pinned, ...flat];
   const now = Date.now();
 
-  // Effective PR per task: a resolved snapshot (cloud run *or* branch lookup)
-  // wins; fall back to the cloud-run URL so grouping still works before the
-  // snapshot resolves.
+  // Effective PR per task: resolved snapshot wins, else the cloud-run URL so
+  // grouping works before the snapshot resolves.
   const prOf = (task: TaskData): PrSnapshot | null =>
     prByTaskId?.get(task.id) ?? null;
   const prUrlOf = (task: TaskData): string | null =>
@@ -163,8 +150,8 @@ export function buildSnapshotFromTasks(
 
     if (tasks.every((t) => taskInStrip.has(t.id))) continue;
 
-    // First task in the group that resolves to a PR carries the snapshot;
-    // grouped-by-PR tasks all share the same URL anyway.
+    // First task that resolves to a PR carries the snapshot; PR-grouped tasks
+    // share the URL anyway.
     let pr: PrSnapshot | null = null;
     let prUrl: string | null = null;
     for (const t of tasks) {
@@ -192,6 +179,7 @@ export function buildSnapshotFromTasks(
     const workstream: HomeWorkstream = {
       id,
       repoName: head.repository?.name ?? null,
+      repoFullPath: head.repository?.fullPath ?? null,
       branch,
       prUrl,
       pr,
diff --git a/apps/code/src/renderer/features/home/utils/situationDisplay.ts b/apps/code/src/renderer/features/home/utils/situationDisplay.ts
index 89610a2b68..faa79f4ed1 100644
--- a/apps/code/src/renderer/features/home/utils/situationDisplay.ts
+++ b/apps/code/src/renderer/features/home/utils/situationDisplay.ts
@@ -10,10 +10,9 @@ import {
   XCircle,
 } from "@phosphor-icons/react";
 import { SITUATIONS, type SituationId } from "@shared/types/workflow";
-import { pickPrimarySituation } from "@shared/types/workflow-classify";
 
-// Radix color scale names we lean on for the status system. Each maps to the
-// full `--<color>-{1..12}` + `--<color>-a{1..12}` token families.
+// Radix color scales the status system uses, each mapping to the full
+// `--<color>-{1..12}` + `--<color>-a{1..12}` token families.
 export type SituationColor =
   | "red"
   | "orange"
@@ -32,9 +31,8 @@ export interface SituationVisual {
   Icon: Icon;
 }
 
-// The colour + glyph each situation reads as. Cool hues (purple/blue) are work
-// in flight; warm hues (red/orange/amber) are "your move"; green is go; gray is
-// dormant. Picked so adjacent board columns stay visually distinct.
+// Colour + glyph each situation reads as: cool hues = work in flight, warm =
+// "your move", green = go, gray = dormant. Adjacent board columns stay distinct.
 const SITUATION_STYLE: Record<
   SituationId,
   { color: SituationColor; Icon: Icon }
@@ -83,10 +81,3 @@ export function situationCss(color: SituationColor): SituationCss {
     wash: `var(--${color}-a2)`,
   };
 }
-
-/** The single most important situation a workstream is in, if any. */
-export function primarySituationId(
-  situations: readonly SituationId[],
-): SituationId | null {
-  return pickPrimarySituation(situations);
-}
diff --git a/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts b/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
index 40078159d5..198a6b42f0 100644
--- a/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
+++ b/apps/code/src/renderer/features/sidebar/hooks/useSidebarData.ts
@@ -94,8 +94,7 @@ function sortTasks(tasks: TaskData[], sortMode: SortMode): TaskData[] {
   );
 }
 
-// Minimal task shape the mapper reads — satisfied by both TaskSummary (sidebar)
-// and the full Task (home tab), so a single mapping serves both.
+// Minimal task shape the mapper reads — satisfied by both TaskSummary and the full Task.
 export interface TaskDataInput {
   id: string;
   title: string;
@@ -134,8 +133,7 @@ export interface TaskDataContext {
   slackThreadUrlFallback?: string;
 }
 
-// Single source of truth for Task → TaskData. Used by the sidebar (over the
-// workspace-scoped summary list) and the home tab (over the full task list).
+// Single source of truth for Task → TaskData, shared by the sidebar and home tab.
 export function toTaskData(
   task: TaskDataInput,
   ctx: TaskDataContext,
diff --git a/apps/code/src/shared/types/analytics.ts b/apps/code/src/shared/types/analytics.ts
index 23053a9b8b..d0bf54d8ab 100644
--- a/apps/code/src/shared/types/analytics.ts
+++ b/apps/code/src/shared/types/analytics.ts
@@ -7,7 +7,7 @@ import type {
 
 type ExecutionType = "cloud" | "local";
 export type RepositoryProvider = "github" | "gitlab" | "local" | "none";
-type TaskCreatedFrom = "cli" | "command-menu";
+type TaskCreatedFrom = "cli" | "command-menu" | "home-quick-action";
 type RepositorySelectSource = "task-creation" | "task-detail";
 type GitActionType =
   | "push"
diff --git a/apps/code/src/shared/types/pr-snapshot.ts b/apps/code/src/shared/types/pr-snapshot.ts
index ce1b579cff..b63fe8a291 100644
--- a/apps/code/src/shared/types/pr-snapshot.ts
+++ b/apps/code/src/shared/types/pr-snapshot.ts
@@ -1,10 +1,8 @@
 import { z } from "zod";
 
-// Canonical PR snapshot the home tab classifies against. This is the wire
-// contract: today it's produced locally by the gh-backed PrSnapshotService,
-// but the production PostHog backend serialises the *same shape* (see
-// docs/workflow-architecture.md §5). Keep it permanent — both ends share it,
-// and `classify()` reads a structural subset of these fields.
+// Canonical PR snapshot the home tab classifies against, and the wire contract:
+// produced locally by the gh-backed PrSnapshotService today; the production
+// PostHog backend serialises the same shape (docs/workflow-architecture.md §5).
 
 export const prSnapshotState = z.enum(["open", "draft", "merged", "closed"]);
 export type PrSnapshotState = z.infer<typeof prSnapshotState>;
@@ -39,11 +37,8 @@ export const prSnapshot = z
   .strict();
 export type PrSnapshot = z.infer<typeof prSnapshot>;
 
-export const prSnapshotArray = z.array(prSnapshot);
-
-// Snapshots are keyed by task, not PR URL: a task's PR may live on its branch
-// (resolved server-side / via gh), not just in cloud-run output. Two tasks can
-// still point at the same PR — the home tab groups them by the snapshot's url.
+// Keyed by task, not PR URL: a task's PR may live on its branch, not just in
+// cloud-run output. Two tasks can point at the same PR — home groups them by url.
 
 /** What the client knows about a task before resolution: its id + any cloud PR URL. */
 export const taskPrRef = z
@@ -64,12 +59,10 @@ export const taskPrSnapshotArray = z.array(taskPrSnapshot);
 export const getPrSnapshotsInput = z
   .object({ tasks: z.array(taskPrRef) })
   .strict();
-export type GetPrSnapshotsInput = z.infer<typeof getPrSnapshotsInput>;
 
 export const refreshPrSnapshotsInput = z
   .object({ tasks: z.array(taskPrRef).optional() })
   .strict();
-export type RefreshPrSnapshotsInput = z.infer<typeof refreshPrSnapshotsInput>;
 
 // Events ----------------------------------------------------------------------
 
diff --git a/apps/code/src/shared/types/workflow-classify.ts b/apps/code/src/shared/types/workflow-classify.ts
index 00de4b6a16..11b21adb85 100644
--- a/apps/code/src/shared/types/workflow-classify.ts
+++ b/apps/code/src/shared/types/workflow-classify.ts
@@ -1,12 +1,9 @@
 import type { SituationId } from "@shared/types/workflow";
 
-// Inputs the classifier needs to decide which situations a piece of work
-// is in. All optional / nullable so the same function works whether we
-// have rich GitHub data, just a local git state, or only task metadata.
+// Inputs the classifier reads. All optional/nullable so it works with rich
+// GitHub data, just local git state, or only task metadata.
 export interface ClassifyInput {
-  /** True if any task on the workstream points at a PR URL. */
   hasPrUrl: boolean;
-  /** PR snapshot (when available — null until a GitHub fetcher is wired up). */
   pr: {
     state: "open" | "draft" | "merged" | "closed";
     ciStatus: "passing" | "failing" | "pending" | "none";
@@ -15,17 +12,16 @@ export interface ClassifyInput {
     isCurrentUserAuthor: boolean;
     mergeable?: boolean | null;
   } | null;
-  /** Local git ahead/behind, when we have a worktree to inspect. */
   gitState?: {
     commitsAhead: number;
     commitsBehind?: number;
     dirty?: boolean;
   } | null;
-  /** Branch the workstream is on (used as a working signal when no PR yet). */
+  /** Working signal when there's no PR yet. */
   branch: string | null;
-  /** Epoch ms of the freshest activity across all tasks in the workstream. */
+  /** Epoch ms, freshest across the workstream's tasks. */
   lastActivityAt: number;
-  /** Now — passed in so unit tests can pin time. */
+  /** Passed in so tests can pin time. */
   now: number;
 }
 
@@ -33,10 +29,8 @@ export interface ClassifyInput {
 const STALE_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000;
 
 /**
- * Pure classifier — takes a single workstream's observed state and emits
- * the (possibly multiple) situations it's in. Deliberately defensive: if
- * a signal is missing, the situation that depended on it simply doesn't
- * fire, rather than producing a misleading bucket.
+ * Pure classifier: emits the (possibly several) situations a workstream is in.
+ * Defensive — a missing signal just means its situation doesn't fire.
  */
 export function classify(input: ClassifyInput): Set<SituationId> {
   const out = new Set<SituationId>();
@@ -62,16 +56,14 @@ export function classify(input: ClassifyInput): Set<SituationId> {
     ) {
       out.add("ready_to_merge");
     }
-    // `in_review` is the catch-all for any PR that's open/draft without a
-    // more-specific situation. We still emit it alongside ci_failing etc. so
-    // the list view can surface the workstream under "In review" too — the
-    // board uses primary-situation priority to decide column placement.
+    // Catch-all for an open/draft PR. Emitted alongside ci_failing etc. so the
+    // list view can show it under "In review"; the board uses primary-situation
+    // priority for column placement.
     if (pr.state === "open" || pr.state === "draft") {
       out.add("in_review");
     }
   } else if (hasPrUrl) {
-    // Workstream has a PR URL stamped on a task but we don't have PR data
-    // yet (the GitHub fetcher isn't wired up). Treat it as in review so it
+    // PR URL stamped on a task but no PR data yet — treat as in review so it
     // doesn't fall into `working`.
     out.add("in_review");
   } else if (branch) {
@@ -80,8 +72,7 @@ export function classify(input: ClassifyInput): Set<SituationId> {
     if (ahead === undefined || ahead > 0) out.add("working");
   }
 
-  // `stale` stacks on top of whatever else applies, except `done` (handled
-  // above with an early return).
+  // `stale` stacks on top of anything except `done` (early-returned above).
   if (now - lastActivityAt > STALE_THRESHOLD_MS) {
     out.add("stale");
   }
@@ -89,9 +80,8 @@ export function classify(input: ClassifyInput): Set<SituationId> {
   return out;
 }
 
-// Priority order for picking the *primary* situation when a workstream is in
-// several at once. Used by the board to decide column placement; the list
-// view can show the workstream in every section it qualifies for.
+// Priority for picking the *primary* situation when several apply — drives
+// board column placement.
 export const SITUATION_PRIORITY: SituationId[] = [
   "done",
   "ready_to_merge",
diff --git a/apps/code/src/shared/types/workflow.ts b/apps/code/src/shared/types/workflow.ts
index 46ec86016e..16440710db 100644
--- a/apps/code/src/shared/types/workflow.ts
+++ b/apps/code/src/shared/types/workflow.ts
@@ -59,13 +59,16 @@ export const workflowAction = z
     label: z.string().min(1).max(120),
     skillId: z.string().min(1),
     prompt: z.string().min(1).max(8_000),
+    // Quick actions run as cloud tasks, which require a model. Pin a model/adapter
+    // per action; unset falls back to the user's last-used / default.
+    adapter: z.enum(["claude", "codex"]).optional(),
+    model: z.string().min(1).optional(),
   })
   .strict();
 export type WorkflowAction = z.infer<typeof workflowAction>;
 
-// Bindings: situation id → ordered list of actions. Every situation appears
-// as a key with at minimum an empty array, so the renderer can iterate
-// SITUATIONS without checking for nulls.
+// situation id → ordered actions. Every situation is present (at least an empty
+// array) so the renderer can iterate SITUATIONS without null checks.
 export const workflowBindings = z.record(situationId, z.array(workflowAction));
 export type WorkflowBindings = z.infer<typeof workflowBindings>;
 

From 040fdafdb13a324b6ee68b22d1e002a037effa54 Mon Sep 17 00:00:00 2001
From: Peter Kirkham <peter@posthog.com>
Date: Wed, 3 Jun 2026 15:41:42 +0100
Subject: [PATCH 5/6] feat: migrate to posthog backend

---
 .../0008_drop_home_workflow_config.sql        |   1 +
 .../src/main/db/migrations/meta/_journal.json |   7 +
 .../repositories/home-workflow-repository.ts  |  52 ---
 apps/code/src/main/db/schema.ts               |   7 -
 apps/code/src/main/di/container.ts            |  15 +-
 apps/code/src/main/di/tokens.ts               |   5 +-
 apps/code/src/main/services/auth/service.ts   |  21 +
 apps/code/src/main/services/git/service.ts    |  43 --
 apps/code/src/main/services/home/service.ts   | 113 +++++
 .../src/main/services/pr-snapshot/backend.ts  |  66 ---
 .../src/main/services/pr-snapshot/service.ts  | 122 -----
 .../src/main/services/workflow/backend.ts     |  77 ----
 .../src/main/services/workflow/service.ts     | 121 ++---
 apps/code/src/main/trpc/router.ts             |   4 +-
 apps/code/src/main/trpc/routers/home.ts       |  31 ++
 .../code/src/main/trpc/routers/pr-snapshot.ts |  35 --
 .../home/components/HomeActiveAgentsStrip.tsx |   2 +-
 .../home/components/HomeBoardView.tsx         |   2 +-
 .../features/home/components/HomeView.tsx     |  98 +---
 .../home/components/HomeWorkstreamCard.tsx    |   2 +-
 .../components/HomeWorkstreamDetailPanel.tsx  |  13 +-
 .../home/components/HomeWorkstreamRow.tsx     |   2 +-
 .../features/home/fixtures/demoSnapshot.ts    | 419 ------------------
 .../features/home/hooks/useBoundActions.ts    |   2 +-
 .../features/home/hooks/useHomeSnapshot.ts    |  58 +--
 .../features/home/hooks/useHomeTasks.ts       |  84 ----
 .../features/home/hooks/usePrSnapshots.ts     |  44 --
 .../home/hooks/useRunWorkstreamAction.ts      |   2 +-
 .../home/hooks/useWorkstreamPresentation.ts   |   2 +-
 .../features/home/stores/homeDemoStore.ts     |  23 -
 .../features/home/stores/prSnapshotStore.ts   |  20 -
 .../renderer/features/home/subscriptions.ts   |  11 +-
 .../features/home/utils/boardColumns.ts       |   2 +-
 .../features/home/utils/buildSnapshot.test.ts | 171 -------
 .../features/home/utils/buildSnapshot.ts      | 208 ---------
 apps/code/src/shared/types/home-snapshot.ts   |  83 ++++
 docs/home-tab.md                              |   8 +
 docs/workflow-architecture.md                 | 316 ++++---------
 38 files changed, 450 insertions(+), 1842 deletions(-)
 create mode 100644 apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql
 delete mode 100644 apps/code/src/main/db/repositories/home-workflow-repository.ts
 create mode 100644 apps/code/src/main/services/home/service.ts
 delete mode 100644 apps/code/src/main/services/pr-snapshot/backend.ts
 delete mode 100644 apps/code/src/main/services/pr-snapshot/service.ts
 delete mode 100644 apps/code/src/main/services/workflow/backend.ts
 create mode 100644 apps/code/src/main/trpc/routers/home.ts
 delete mode 100644 apps/code/src/main/trpc/routers/pr-snapshot.ts
 delete mode 100644 apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
 delete mode 100644 apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
 delete mode 100644 apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
 delete mode 100644 apps/code/src/renderer/features/home/stores/homeDemoStore.ts
 delete mode 100644 apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
 delete mode 100644 apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
 delete mode 100644 apps/code/src/renderer/features/home/utils/buildSnapshot.ts
 create mode 100644 apps/code/src/shared/types/home-snapshot.ts

diff --git a/apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql b/apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql
new file mode 100644
index 0000000000..c8d06f35ba
--- /dev/null
+++ b/apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql
@@ -0,0 +1 @@
+DROP TABLE IF EXISTS `home_workflow_config`;
diff --git a/apps/code/src/main/db/migrations/meta/_journal.json b/apps/code/src/main/db/migrations/meta/_journal.json
index e36df25195..f37f6e71f3 100644
--- a/apps/code/src/main/db/migrations/meta/_journal.json
+++ b/apps/code/src/main/db/migrations/meta/_journal.json
@@ -57,6 +57,13 @@
       "when": 1779956709103,
       "tag": "0007_remarkable_lord_tyger",
       "breakpoints": true
+    },
+    {
+      "idx": 8,
+      "version": "6",
+      "when": 1780000000000,
+      "tag": "0008_drop_home_workflow_config",
+      "breakpoints": true
     }
   ]
 }
\ No newline at end of file
diff --git a/apps/code/src/main/db/repositories/home-workflow-repository.ts b/apps/code/src/main/db/repositories/home-workflow-repository.ts
deleted file mode 100644
index 55075b446d..0000000000
--- a/apps/code/src/main/db/repositories/home-workflow-repository.ts
+++ /dev/null
@@ -1,52 +0,0 @@
-import { eq } from "drizzle-orm";
-import { inject, injectable } from "inversify";
-import { MAIN_TOKENS } from "../../di/tokens";
-import { homeWorkflowConfig } from "../schema";
-import type { DatabaseService } from "../service";
-
-// Persists the Home workflow row for `LocalWorkflowBackend`.
-export interface PersistedWorkflowRow {
-  id: string;
-  version: number;
-  json: string;
-  updatedAt: string;
-}
-
-@injectable()
-export class HomeWorkflowRepository {
-  constructor(
-    @inject(MAIN_TOKENS.DatabaseService)
-    private readonly databaseService: DatabaseService,
-  ) {}
-
-  private get db() {
-    return this.databaseService.db;
-  }
-
-  findById(id: string): PersistedWorkflowRow | null {
-    const row = this.db
-      .select()
-      .from(homeWorkflowConfig)
-      .where(eq(homeWorkflowConfig.id, id))
-      .get();
-    return row ?? null;
-  }
-
-  upsert(row: PersistedWorkflowRow): void {
-    this.db
-      .insert(homeWorkflowConfig)
-      .values(row)
-      .onConflictDoUpdate({
-        target: homeWorkflowConfig.id,
-        set: { version: row.version, json: row.json, updatedAt: row.updatedAt },
-      })
-      .run();
-  }
-
-  delete(id: string): void {
-    this.db
-      .delete(homeWorkflowConfig)
-      .where(eq(homeWorkflowConfig.id, id))
-      .run();
-  }
-}
diff --git a/apps/code/src/main/db/schema.ts b/apps/code/src/main/db/schema.ts
index bc63fda6e2..8823ad2744 100644
--- a/apps/code/src/main/db/schema.ts
+++ b/apps/code/src/main/db/schema.ts
@@ -114,10 +114,3 @@ export const authPreferences = sqliteTable(
     ),
   ],
 );
-
-export const homeWorkflowConfig = sqliteTable("home_workflow_config", {
-  id: text().primaryKey(),
-  version: integer().notNull(),
-  json: text().notNull(),
-  updatedAt: updatedAt(),
-});
diff --git a/apps/code/src/main/di/container.ts b/apps/code/src/main/di/container.ts
index 5e4bc40e78..02d9de4092 100644
--- a/apps/code/src/main/di/container.ts
+++ b/apps/code/src/main/di/container.ts
@@ -5,7 +5,6 @@ import { ArchiveRepository } from "../db/repositories/archive-repository";
 import { AuthPreferenceRepository } from "../db/repositories/auth-preference-repository";
 import { AuthSessionRepository } from "../db/repositories/auth-session-repository";
 import { DefaultAdditionalDirectoryRepository } from "../db/repositories/default-additional-directory-repository";
-import { HomeWorkflowRepository } from "../db/repositories/home-workflow-repository";
 import { RepositoryRepository } from "../db/repositories/repository-repository";
 import { SuspensionRepositoryImpl } from "../db/repositories/suspension-repository";
 import { WorkspaceRepository } from "../db/repositories/workspace-repository";
@@ -47,6 +46,7 @@ import { FsService } from "../services/fs/service";
 import { GitService } from "../services/git/service";
 import { GitHubIntegrationService } from "../services/github-integration/service";
 import { HandoffService } from "../services/handoff/service";
+import { HomeService } from "../services/home/service";
 import { InboxLinkService } from "../services/inbox-link/service";
 import { LinearIntegrationService } from "../services/linear-integration/service";
 import { LlmGatewayService } from "../services/llm-gateway/service";
@@ -58,8 +58,6 @@ import { NewTaskLinkService } from "../services/new-task-link/service";
 import { NotificationService } from "../services/notification/service";
 import { OAuthService } from "../services/oauth/service";
 import { PosthogPluginService } from "../services/posthog-plugin/service";
-import { LocalPrSnapshotBackend } from "../services/pr-snapshot/backend";
-import { PrSnapshotService } from "../services/pr-snapshot/service";
 import { ProcessTrackingService } from "../services/process-tracking/service";
 import { ProvisioningService } from "../services/provisioning/service";
 import { settingsStore } from "../services/settingsStore";
@@ -72,7 +70,6 @@ import { UIService } from "../services/ui/service";
 import { UpdatesService } from "../services/updates/service";
 import { UsageMonitorService } from "../services/usage-monitor/service";
 import { WatcherRegistryService } from "../services/watcher-registry/service";
-import { LocalWorkflowBackend } from "../services/workflow/backend";
 import { WorkflowService } from "../services/workflow/service";
 import { WorkspaceService } from "../services/workspace/service";
 import { MAIN_TOKENS } from "./tokens";
@@ -110,7 +107,6 @@ container.bind(MAIN_TOKENS.SuspensionRepository).to(SuspensionRepositoryImpl);
 container
   .bind(MAIN_TOKENS.DefaultAdditionalDirectoryRepository)
   .to(DefaultAdditionalDirectoryRepository);
-container.bind(MAIN_TOKENS.HomeWorkflowRepository).to(HomeWorkflowRepository);
 container.bind(MAIN_TOKENS.AgentAuthAdapter).to(AgentAuthAdapter);
 container.bind(MAIN_TOKENS.AgentService).to(AgentService);
 container.bind(MAIN_TOKENS.AuthService).to(AuthService);
@@ -159,13 +155,10 @@ container.bind(MAIN_TOKENS.TaskLinkService).to(TaskLinkService);
 container.bind(MAIN_TOKENS.InboxLinkService).to(InboxLinkService);
 container.bind(MAIN_TOKENS.NewTaskLinkService).to(NewTaskLinkService);
 container.bind(MAIN_TOKENS.WatcherRegistryService).to(WatcherRegistryService);
-// Swap point for the future PostHog-backed workflow (docs/workflow-architecture.md).
-container.bind(MAIN_TOKENS.WorkflowBackend).to(LocalWorkflowBackend);
+// Home workflow config + snapshot are owned by PostHog now; these services are
+// thin authenticated clients over the REST API (docs/workflow-architecture.md).
 container.bind(MAIN_TOKENS.WorkflowService).to(WorkflowService);
-// Same swap-point pattern: gh CLI today → CloudPrSnapshotBackend when PostHog
-// owns PR polling (docs/workflow-architecture.md §5–6).
-container.bind(MAIN_TOKENS.PrSnapshotBackend).to(LocalPrSnapshotBackend);
-container.bind(MAIN_TOKENS.PrSnapshotService).to(PrSnapshotService);
+container.bind(MAIN_TOKENS.HomeService).to(HomeService);
 container.bind(MAIN_TOKENS.WorkspaceService).to(WorkspaceService);
 
 container.bind(MAIN_TOKENS.SettingsStore).toConstantValue(settingsStore);
diff --git a/apps/code/src/main/di/tokens.ts b/apps/code/src/main/di/tokens.ts
index 5f95316905..94851e469f 100644
--- a/apps/code/src/main/di/tokens.ts
+++ b/apps/code/src/main/di/tokens.ts
@@ -37,7 +37,6 @@ export const MAIN_TOKENS = Object.freeze({
   DefaultAdditionalDirectoryRepository: Symbol.for(
     "Main.DefaultAdditionalDirectoryRepository",
   ),
-  HomeWorkflowRepository: Symbol.for("Main.HomeWorkflowRepository"),
 
   // Services
   AgentAuthAdapter: Symbol.for("Main.AgentAuthAdapter"),
@@ -85,8 +84,6 @@ export const MAIN_TOKENS = Object.freeze({
   WorkspaceService: Symbol.for("Main.WorkspaceService"),
   EnrichmentService: Symbol.for("Main.EnrichmentService"),
   UsageMonitorService: Symbol.for("Main.UsageMonitorService"),
-  WorkflowBackend: Symbol.for("Main.WorkflowBackend"),
   WorkflowService: Symbol.for("Main.WorkflowService"),
-  PrSnapshotBackend: Symbol.for("Main.PrSnapshotBackend"),
-  PrSnapshotService: Symbol.for("Main.PrSnapshotService"),
+  HomeService: Symbol.for("Main.HomeService"),
 });
diff --git a/apps/code/src/main/services/auth/service.ts b/apps/code/src/main/services/auth/service.ts
index e59051aa16..5e479f92bb 100644
--- a/apps/code/src/main/services/auth/service.ts
+++ b/apps/code/src/main/services/auth/service.ts
@@ -191,6 +191,27 @@ export class AuthService extends TypedEventEmitter<AuthServiceEvents> {
 
     return response;
   }
+
+  /**
+   * Authenticated fetch against a project-scoped PostHog endpoint
+   * (`/api/projects/:projectId/<path>`). Throws if no project is selected.
+   */
+  async authenticatedProjectFetch(
+    path: string,
+    init: RequestInit = {},
+  ): Promise<Response> {
+    const { projectId, cloudRegion } = this.getState();
+    if (projectId == null) {
+      throw new Error("No PostHog project selected");
+    }
+    const apiHost = getCloudUrlFromRegion(cloudRegion ?? "us");
+    return this.authenticatedFetch(
+      fetch,
+      `${apiHost}/api/projects/${projectId}/${path}`,
+      init,
+    );
+  }
+
   async redeemInviteCode(code: string): Promise<AuthState> {
     const { apiHost } = await this.getValidAccessToken();
     const response = await this.authenticatedFetch(
diff --git a/apps/code/src/main/services/git/service.ts b/apps/code/src/main/services/git/service.ts
index fba2e4b248..60a6547e9f 100644
--- a/apps/code/src/main/services/git/service.ts
+++ b/apps/code/src/main/services/git/service.ts
@@ -2233,47 +2233,4 @@ ${truncatedDiff || "(no diff available)"}${contextSection}`;
 
     return { prState: null, hasDiff: false };
   }
-
-  /**
-   * Resolve the PR URL for a task across all task kinds — cloud run output, the
-   * linked branch (`gh pr list --head`), or the worktree's current branch —
-   * mirroring {@link getTaskPrStatus}. Returns null when the task has no PR.
-   */
-  async resolveTaskPrUrl(
-    taskId: string,
-    cloudPrUrl: string | null,
-  ): Promise<string | null> {
-    const workspace = await this.workspaceService.getWorkspace(taskId);
-    if (!workspace) return cloudPrUrl ?? null;
-
-    const { mode, worktreePath, folderPath, linkedBranch } = workspace;
-    const repoPath = worktreePath ?? (folderPath || null);
-
-    if (mode === "cloud") return cloudPrUrl ?? null;
-
-    if (linkedBranch && repoPath) {
-      const prUrl = await this.getPrUrlForBranch(repoPath, linkedBranch);
-      if (prUrl) return prUrl;
-    }
-
-    if (worktreePath) {
-      const prStatus = await this.getPrStatus(worktreePath);
-      if (prStatus.prExists && prStatus.prUrl) return prStatus.prUrl;
-    }
-
-    return cloudPrUrl ?? null;
-  }
-
-  /**
-   * Resolve a task's PR (any kind) and return the rich snapshot the home tab
-   * classifies against. Null when the task has no PR.
-   */
-  async getTaskPrSnapshot(
-    taskId: string,
-    cloudPrUrl: string | null,
-  ): Promise<PrSnapshot | null> {
-    const prUrl = await this.resolveTaskPrUrl(taskId, cloudPrUrl);
-    if (!prUrl) return null;
-    return this.getPrFull(prUrl);
-  }
 }
diff --git a/apps/code/src/main/services/home/service.ts b/apps/code/src/main/services/home/service.ts
new file mode 100644
index 0000000000..4d85d09880
--- /dev/null
+++ b/apps/code/src/main/services/home/service.ts
@@ -0,0 +1,113 @@
+import {
+  EMPTY_HOME_SNAPSHOT,
+  HomeEvent,
+  type HomeEvents,
+  type HomeSnapshot,
+  homeSnapshot,
+} from "@shared/types/home-snapshot";
+import { inject, injectable, postConstruct } from "inversify";
+import { MAIN_TOKENS } from "../../di/tokens";
+import { logger } from "../../utils/logger";
+import { TypedEventEmitter } from "../../utils/typed-event-emitter";
+import type { AuthService } from "../auth/service";
+
+const log = logger.scope("home");
+
+// Client poll cadence. The server worker keeps data fresh independently; this
+// just pulls the latest snapshot so an open Home view stays current without a
+// realtime channel (docs/home-tab.md §10 — REST + client poll for v1).
+const POLL_INTERVAL_MS = 120_000;
+
+/**
+ * Reads the per-user Home snapshot from PostHog. All grouping, PR polling, and
+ * classification happen server-side in the `evaluate-code-workstreams` Temporal
+ * worker; this service is a thin authenticated client + poll loop that emits
+ * {@link HomeEvent.SnapshotUpdated} when the snapshot changes.
+ */
+@injectable()
+export class HomeService extends TypedEventEmitter<HomeEvents> {
+  private timer: ReturnType<typeof setInterval> | null = null;
+  private lastSerialized: string | null = null;
+
+  constructor(
+    @inject(MAIN_TOKENS.AuthService)
+    private readonly authService: AuthService,
+  ) {
+    super();
+  }
+
+  @postConstruct()
+  init(): void {
+    this.timer = setInterval(() => {
+      void this.poll();
+    }, POLL_INTERVAL_MS);
+  }
+
+  dispose(): void {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+
+  async getSnapshot(): Promise<HomeSnapshot> {
+    return (await this.fetchSnapshot()) ?? EMPTY_HOME_SNAPSHOT;
+  }
+
+  async refresh(): Promise<HomeSnapshot> {
+    // Fire-and-forget: the server kicks off an async worker eval. The fresh
+    // result lands via the next poll → onSnapshotUpdated; we just return the
+    // current snapshot so the mutation has a value.
+    await this.requestServerRefresh();
+    return this.getSnapshot();
+  }
+
+  private async poll(): Promise<void> {
+    const snapshot = await this.fetchSnapshot();
+    if (!snapshot) return;
+    const serialized = JSON.stringify(snapshot);
+    if (serialized === this.lastSerialized) return;
+    this.lastSerialized = serialized;
+    this.emit(HomeEvent.SnapshotUpdated, snapshot);
+  }
+
+  private async fetchSnapshot(): Promise<HomeSnapshot | null> {
+    if (this.authService.getState().projectId == null) return null;
+    try {
+      const res = await this.authService.authenticatedProjectFetch(
+        "code_home/",
+        { method: "GET" },
+      );
+      if (!res.ok) {
+        log.warn("Failed to fetch home snapshot", { status: res.status });
+        return null;
+      }
+      const parsed = homeSnapshot.safeParse(await res.json());
+      if (!parsed.success) {
+        log.warn("Home snapshot failed schema validation", {
+          error: parsed.error.message,
+        });
+        return null;
+      }
+      return parsed.data;
+    } catch (err) {
+      log.warn("Error fetching home snapshot", {
+        error: err instanceof Error ? err.message : String(err),
+      });
+      return null;
+    }
+  }
+
+  private async requestServerRefresh(): Promise<void> {
+    if (this.authService.getState().projectId == null) return;
+    try {
+      await this.authService.authenticatedProjectFetch("code_home/refresh/", {
+        method: "POST",
+      });
+    } catch (err) {
+      log.warn("Error requesting home refresh", {
+        error: err instanceof Error ? err.message : String(err),
+      });
+    }
+  }
+}
diff --git a/apps/code/src/main/services/pr-snapshot/backend.ts b/apps/code/src/main/services/pr-snapshot/backend.ts
deleted file mode 100644
index 9b65215d95..0000000000
--- a/apps/code/src/main/services/pr-snapshot/backend.ts
+++ /dev/null
@@ -1,66 +0,0 @@
-import { MAIN_TOKENS } from "@main/di/tokens";
-import type { GitService } from "@main/services/git/service";
-import { mapWithConcurrency } from "@posthog/git/concurrency";
-import type { TaskPrRef, TaskPrSnapshot } from "@shared/types/pr-snapshot";
-import { inject, injectable } from "inversify";
-
-/**
- * Single seam between {@link PrSnapshotService} and where PR/CI data comes from.
- * Today the local gh CLI ({@link LocalPrSnapshotBackend}); a `CloudPrSnapshotBackend`
- * replaces the binding when PostHog owns PR polling (docs/workflow-architecture.md §5–6).
- *
- * Implementations: `fetch` returns one snapshot per resolvable task (omit, never
- * throw, on no-PR or failure); `onResolved` (optional) fires per task so callers
- * can stream rather than wait for the slowest.
- */
-export interface PrSnapshotBackend {
-  fetch(
-    tasks: TaskPrRef[],
-    onResolved?: (result: TaskPrSnapshot) => void,
-  ): Promise<TaskPrSnapshot[]>;
-}
-
-// gh is rate-limited and each task is independent network work, so cap how many
-// we resolve at once. Matches the concurrency cap in docs/home-tab.md §9.
-const MAX_CONCURRENCY = 3;
-
-@injectable()
-export class LocalPrSnapshotBackend implements PrSnapshotBackend {
-  constructor(
-    @inject(MAIN_TOKENS.GitService)
-    private readonly git: GitService,
-  ) {}
-
-  async fetch(
-    tasks: TaskPrRef[],
-    onResolved?: (result: TaskPrSnapshot) => void,
-  ): Promise<TaskPrSnapshot[]> {
-    const resolved = await mapWithConcurrency(
-      tasks,
-      MAX_CONCURRENCY,
-      async (ref) => {
-        const snapshot = await this.git
-          .getTaskPrSnapshot(ref.taskId, ref.cloudPrUrl)
-          .catch(() => null);
-        if (!snapshot) return null;
-        const result = { taskId: ref.taskId, snapshot };
-        onResolved?.(result);
-        return result;
-      },
-    );
-    return resolved.filter((r): r is TaskPrSnapshot => r !== null);
-  }
-}
-
-/**
- * Production stub: call the auth'd PostHog API and validate with `taskPrSnapshot`.
- * Flipping the DI binding to this is the entire client-side migration.
- */
-@injectable()
-export class CloudPrSnapshotBackend implements PrSnapshotBackend {
-  async fetch(): Promise<TaskPrSnapshot[]> {
-    throw new Error(
-      "CloudPrSnapshotBackend not implemented yet — see docs/workflow-architecture.md",
-    );
-  }
-}
diff --git a/apps/code/src/main/services/pr-snapshot/service.ts b/apps/code/src/main/services/pr-snapshot/service.ts
deleted file mode 100644
index 1cebff588c..0000000000
--- a/apps/code/src/main/services/pr-snapshot/service.ts
+++ /dev/null
@@ -1,122 +0,0 @@
-import { MAIN_TOKENS } from "@main/di/tokens";
-import { logger } from "@main/utils/logger";
-import { TypedEventEmitter } from "@main/utils/typed-event-emitter";
-import {
-  type PrSnapshot,
-  PrSnapshotEvent,
-  type PrSnapshotEvents,
-  type TaskPrRef,
-  type TaskPrSnapshot,
-} from "@shared/types/pr-snapshot";
-import { inject, injectable, postConstruct } from "inversify";
-import type { PrSnapshotBackend } from "./backend";
-
-const log = logger.scope("pr-snapshot");
-
-// How often tracked tasks are re-polled to stay fresh. The production worker
-// owns this cadence server-side.
-const POLL_INTERVAL_MS = 3 * 60 * 1000;
-
-/**
- * Owns the PR-snapshot lifecycle: tracked tasks, cached CI/review state, the
- * refresh loop, and the `Updated` event the renderer subscribes to. Resolution
- * lives behind {@link PrSnapshotBackend} (docs/workflow-architecture.md §5).
- */
-@injectable()
-export class PrSnapshotService extends TypedEventEmitter<PrSnapshotEvents> {
-  private readonly cache = new Map<string, PrSnapshot>();
-  private readonly tracked = new Map<string, TaskPrRef>();
-  private inflight: Promise<void> | null = null;
-
-  constructor(
-    @inject(MAIN_TOKENS.PrSnapshotBackend)
-    private readonly backend: PrSnapshotBackend,
-  ) {
-    super();
-  }
-
-  @postConstruct()
-  init(): void {
-    const timer = setInterval(() => {
-      void this.refresh().catch((error) => {
-        log.warn("Scheduled PR snapshot refresh failed", { error });
-      });
-    }, POLL_INTERVAL_MS);
-    // Don't keep the process alive for the poll loop.
-    timer.unref?.();
-  }
-
-  /**
-   * Returns cached snapshots for the requested tasks and marks them tracked.
-   * Uncached tasks resolve in the background and stream in over `Updated`, so the
-   * home tab fills in progressively rather than blocking on the slowest `gh` call.
-   */
-  async getSnapshots(tasks: TaskPrRef[]): Promise<TaskPrSnapshot[]> {
-    for (const ref of tasks) this.tracked.set(ref.taskId, ref);
-
-    const missing = tasks.filter((ref) => !this.cache.has(ref.taskId));
-    if (missing.length > 0) {
-      void this.runRefresh(missing).catch((error) => {
-        log.warn("Inline PR snapshot resolve failed", { error });
-      });
-    }
-
-    const out: TaskPrSnapshot[] = [];
-    for (const ref of tasks) {
-      const snapshot = this.cache.get(ref.taskId);
-      if (snapshot) out.push({ taskId: ref.taskId, snapshot });
-    }
-    return out;
-  }
-
-  /**
-   * Re-resolve the given tasks (or every tracked task), update the cache, and
-   * emit only those that materially changed. Concurrent full refreshes dedupe
-   * onto one in-flight run.
-   */
-  async refresh(tasks?: TaskPrRef[]): Promise<void> {
-    const refs = tasks ?? [...this.tracked.values()];
-    if (refs.length === 0) return;
-
-    if (!tasks && this.inflight) return this.inflight;
-
-    const run = this.runRefresh(refs);
-    if (!tasks) {
-      this.inflight = run.finally(() => {
-        this.inflight = null;
-      });
-      return this.inflight;
-    }
-    return run;
-  }
-
-  private async runRefresh(refs: TaskPrRef[]): Promise<void> {
-    // Emit per result as the backend resolves it (not one batch) so the renderer
-    // can reposition each workstream as soon as its PR data lands.
-    await this.backend.fetch(refs, (result) => this.applyResult(result));
-  }
-
-  /** Cache one resolved snapshot and emit it if it materially changed. */
-  private applyResult(result: TaskPrSnapshot): void {
-    const previous = this.cache.get(result.taskId);
-    this.cache.set(result.taskId, result.snapshot);
-    if (!previous || hasMaterialChange(previous, result.snapshot)) {
-      this.emit(PrSnapshotEvent.Updated, [result]);
-    }
-  }
-}
-
-// Ignore churn (e.g. a bumped `lastUpdatedAt` with no state change) so we don't
-// re-render the home tab for nothing — only the fields the classifier reads.
-function hasMaterialChange(a: PrSnapshot, b: PrSnapshot): boolean {
-  return (
-    a.url !== b.url ||
-    a.state !== b.state ||
-    a.ciStatus !== b.ciStatus ||
-    a.reviewDecision !== b.reviewDecision ||
-    a.unresolvedThreads !== b.unresolvedThreads ||
-    a.mergeable !== b.mergeable ||
-    a.isCurrentUserRequestedReviewer !== b.isCurrentUserRequestedReviewer ||
-    a.title !== b.title
-  );
-}
diff --git a/apps/code/src/main/services/workflow/backend.ts b/apps/code/src/main/services/workflow/backend.ts
deleted file mode 100644
index 9ef98312fb..0000000000
--- a/apps/code/src/main/services/workflow/backend.ts
+++ /dev/null
@@ -1,77 +0,0 @@
-import type { HomeWorkflowRepository } from "@main/db/repositories/home-workflow-repository";
-import { MAIN_TOKENS } from "@main/di/tokens";
-import { logger } from "@main/utils/logger";
-import { type WorkflowConfig, workflowConfig } from "@shared/types/workflow";
-import { inject, injectable } from "inversify";
-
-const log = logger.scope("workflow-backend");
-
-/**
- * Single seam between `WorkflowService` and where the workflow config lives.
- * Today local SQLite ({@link LocalWorkflowBackend}); a `CloudWorkflowBackend`
- * replaces the binding for cross-device storage (docs/workflow-architecture.md).
- *
- * Implementations: `version` is monotonic (only `save` bumps it); `load()`
- * returns `null` rather than throwing, validates against `workflowConfig`, and
- * drops bad rows on read so the service reseeds; `delete()` is idempotent.
- */
-export interface WorkflowBackend {
-  load(): Promise<WorkflowConfig | null>;
-  save(config: WorkflowConfig): Promise<void>;
-  delete(): Promise<void>;
-}
-
-const WORKFLOW_ID = "default";
-
-@injectable()
-export class LocalWorkflowBackend implements WorkflowBackend {
-  constructor(
-    @inject(MAIN_TOKENS.HomeWorkflowRepository)
-    private readonly repository: HomeWorkflowRepository,
-  ) {}
-
-  async load(): Promise<WorkflowConfig | null> {
-    const row = this.repository.findById(WORKFLOW_ID);
-    if (!row) return null;
-
-    let raw: unknown;
-    try {
-      raw = JSON.parse(row.json);
-    } catch (err) {
-      log.warn("Persisted workflow JSON is corrupt — dropping row", {
-        error: err instanceof Error ? err.message : String(err),
-      });
-      this.repository.delete(WORKFLOW_ID);
-      return null;
-    }
-
-    // Authoritative `version` + `updatedAt` come from the row, not the JSON
-    // body, so a stale blob field can't shadow the monotonic counter.
-    const parsed = workflowConfig.safeParse({
-      ...(typeof raw === "object" && raw !== null ? raw : {}),
-      version: row.version,
-      updatedAt: row.updatedAt,
-    });
-    if (!parsed.success) {
-      log.warn("Persisted workflow no longer matches schema — dropping row", {
-        error: parsed.error.message,
-      });
-      this.repository.delete(WORKFLOW_ID);
-      return null;
-    }
-    return parsed.data;
-  }
-
-  async save(config: WorkflowConfig): Promise<void> {
-    this.repository.upsert({
-      id: WORKFLOW_ID,
-      version: config.version,
-      json: JSON.stringify(config),
-      updatedAt: config.updatedAt,
-    });
-  }
-
-  async delete(): Promise<void> {
-    this.repository.delete(WORKFLOW_ID);
-  }
-}
diff --git a/apps/code/src/main/services/workflow/service.ts b/apps/code/src/main/services/workflow/service.ts
index 91aae380e8..5f9646b524 100644
--- a/apps/code/src/main/services/workflow/service.ts
+++ b/apps/code/src/main/services/workflow/service.ts
@@ -1,109 +1,84 @@
 import {
   type SaveInput,
   type SaveResult,
+  saveResult,
   type WorkflowConfig,
   WorkflowEvent,
   type WorkflowEvents,
+  workflowConfig,
 } from "@shared/types/workflow";
-import { validateWorkflow } from "@shared/types/workflow-validate";
-import { inject, injectable, postConstruct } from "inversify";
+import { inject, injectable } from "inversify";
 import { MAIN_TOKENS } from "../../di/tokens";
 import { logger } from "../../utils/logger";
 import { TypedEventEmitter } from "../../utils/typed-event-emitter";
-import type { WorkflowBackend } from "./backend";
+import type { AuthService } from "../auth/service";
 import { buildDefaultWorkflow } from "./default-workflow";
 
-const WORKFLOW_ID = "default";
 const log = logger.scope("workflow");
 
 /**
- * Owns the workflow lifecycle (load → seed default → save → emit `Changed`).
- * Storage lives behind {@link WorkflowBackend} (docs/workflow-architecture.md).
+ * Reads and writes the user's Home workflow config from PostHog
+ * (`/api/projects/:id/code_workflow/`). The server owns persistence, the
+ * monotonic `version`, optimistic concurrency, validation, and the default
+ * seed; this service is a thin authenticated client that emits
+ * {@link WorkflowEvent.Changed} on save/reset. Offline, `get()` falls back to
+ * the built-in default so the editor still renders.
  */
 @injectable()
 export class WorkflowService extends TypedEventEmitter<WorkflowEvents> {
-  private cached: WorkflowConfig | null = null;
-  private inflightLoad: Promise<WorkflowConfig> | null = null;
-
   constructor(
-    @inject(MAIN_TOKENS.WorkflowBackend)
-    private readonly backend: WorkflowBackend,
+    @inject(MAIN_TOKENS.AuthService)
+    private readonly authService: AuthService,
   ) {
     super();
   }
 
-  @postConstruct()
-  init(): void {
-    void this.get();
-  }
-
   async get(): Promise<WorkflowConfig> {
-    if (this.cached) return this.cached;
-    // Dedup concurrent first-load callers behind one in-flight promise.
-    if (this.inflightLoad) return this.inflightLoad;
-    this.inflightLoad = this.loadOrSeed().finally(() => {
-      this.inflightLoad = null;
-    });
-    return this.inflightLoad;
+    const json = await this.request("GET", "code_workflow/");
+    const parsed = workflowConfig.safeParse(json);
+    if (parsed.success) return parsed.data;
+    // Unexpected response shape — render the default rather than breaking the
+    // Home config surface. (Network/auth failures throw and surface as the
+    // query's error state.)
+    return buildDefaultWorkflow();
   }
 
   async save(input: SaveInput): Promise<SaveResult> {
-    const current = await this.get();
-    if (current.version !== input.expectedVersion) {
-      return { status: "conflict", config: current };
-    }
-    const validation = validateWorkflow(input.config);
-    if (!validation.canSave) {
-      return {
-        status: "invalid",
-        config: current,
-        diagnostics: validation.diagnostics,
-      };
-    }
-    const next: WorkflowConfig = {
-      ...input.config,
-      id: WORKFLOW_ID,
-      version: current.version + 1,
-      updatedAt: new Date().toISOString(),
-    };
-    await this.backend.save(next);
-    this.cached = next;
-    this.emit(WorkflowEvent.Changed, next);
-    log.info("Workflow saved", {
-      version: next.version,
-      actionCount: Object.values(next.bindings).reduce(
-        (sum, list) => sum + list.length,
-        0,
-      ),
+    const json = await this.request("POST", "code_workflow/save/", {
+      config: input.config,
+      expectedVersion: input.expectedVersion,
     });
-    return { status: "saved", config: next };
+    const parsed = saveResult.parse(json);
+    if (parsed.status === "saved") {
+      this.emit(WorkflowEvent.Changed, parsed.config);
+      log.info("Workflow saved", { version: parsed.config.version });
+    }
+    return parsed;
   }
 
   async resetToDefault(): Promise<WorkflowConfig> {
-    const current = await this.get();
-    const fresh = buildDefaultWorkflow();
-    const next: WorkflowConfig = {
-      ...fresh,
-      version: current.version + 1,
-      updatedAt: new Date().toISOString(),
-    };
-    await this.backend.save(next);
-    this.cached = next;
-    this.emit(WorkflowEvent.Changed, next);
-    log.info("Workflow reset to default", { version: next.version });
-    return next;
+    const json = await this.request("POST", "code_workflow/reset/");
+    const config = workflowConfig.parse(json);
+    this.emit(WorkflowEvent.Changed, config);
+    log.info("Workflow reset to default", { version: config.version });
+    return config;
   }
 
-  private async loadOrSeed(): Promise<WorkflowConfig> {
-    const loaded = await this.backend.load();
-    if (loaded) {
-      this.cached = loaded;
-      return loaded;
+  private async request(
+    method: "GET" | "POST",
+    path: string,
+    body?: unknown,
+  ): Promise<unknown> {
+    const init: RequestInit = { method };
+    if (body !== undefined) {
+      init.headers = { "Content-Type": "application/json" };
+      init.body = JSON.stringify(body);
+    }
+    const res = await this.authService.authenticatedProjectFetch(path, init);
+    // 409/422 carry a structured SaveResult body the caller validates.
+    if (!res.ok && res.status !== 409 && res.status !== 422) {
+      throw new Error(`Workflow request failed: ${res.status}`);
     }
-    const seed = buildDefaultWorkflow();
-    await this.backend.save(seed);
-    this.cached = seed;
-    log.info("Seeded default workflow", { version: seed.version });
-    return seed;
+    return res.json();
   }
 }
diff --git a/apps/code/src/main/trpc/router.ts b/apps/code/src/main/trpc/router.ts
index 55099545c9..75c3acdd0a 100644
--- a/apps/code/src/main/trpc/router.ts
+++ b/apps/code/src/main/trpc/router.ts
@@ -18,6 +18,7 @@ import { fsRouter } from "./routers/fs";
 import { gitRouter } from "./routers/git";
 import { githubIntegrationRouter } from "./routers/github-integration";
 import { handoffRouter } from "./routers/handoff";
+import { homeRouter } from "./routers/home";
 import { linearIntegrationRouter } from "./routers/linear-integration.js";
 import { llmGatewayRouter } from "./routers/llm-gateway";
 import { logsRouter } from "./routers/logs";
@@ -26,7 +27,6 @@ import { mcpCallbackRouter } from "./routers/mcp-callback";
 import { notificationRouter } from "./routers/notification";
 import { oauthRouter } from "./routers/oauth";
 import { osRouter } from "./routers/os";
-import { prSnapshotRouter } from "./routers/pr-snapshot";
 import { processTrackingRouter } from "./routers/process-tracking";
 import { provisioningRouter } from "./routers/provisioning";
 import { secureStoreRouter } from "./routers/secure-store";
@@ -63,6 +63,7 @@ export const trpcRouter = router({
   git: gitRouter,
   githubIntegration: githubIntegrationRouter,
   handoff: handoffRouter,
+  home: homeRouter,
   linearIntegration: linearIntegrationRouter,
   llmGateway: llmGatewayRouter,
   mcpApps: mcpAppsRouter,
@@ -71,7 +72,6 @@ export const trpcRouter = router({
   oauth: oauthRouter,
   logs: logsRouter,
   os: osRouter,
-  prSnapshot: prSnapshotRouter,
   processTracking: processTrackingRouter,
   provisioning: provisioningRouter,
   sleep: sleepRouter,
diff --git a/apps/code/src/main/trpc/routers/home.ts b/apps/code/src/main/trpc/routers/home.ts
new file mode 100644
index 0000000000..a6e9990c64
--- /dev/null
+++ b/apps/code/src/main/trpc/routers/home.ts
@@ -0,0 +1,31 @@
+import {
+  HomeEvent,
+  type HomeEvents,
+  homeSnapshot,
+} from "@shared/types/home-snapshot";
+import { container } from "../../di/container";
+import { MAIN_TOKENS } from "../../di/tokens";
+import type { HomeService } from "../../services/home/service";
+import { publicProcedure, router } from "../trpc";
+
+const getService = () => container.get<HomeService>(MAIN_TOKENS.HomeService);
+
+function subscribe<K extends keyof HomeEvents>(event: K) {
+  return publicProcedure.subscription(async function* (opts) {
+    const service = getService();
+    const iterable = service.toIterable(event, { signal: opts.signal });
+    for await (const data of iterable) {
+      yield data;
+    }
+  });
+}
+
+export const homeRouter = router({
+  getSnapshot: publicProcedure
+    .output(homeSnapshot)
+    .query(() => getService().getSnapshot()),
+  refresh: publicProcedure
+    .output(homeSnapshot)
+    .mutation(() => getService().refresh()),
+  onSnapshotUpdated: subscribe(HomeEvent.SnapshotUpdated),
+});
diff --git a/apps/code/src/main/trpc/routers/pr-snapshot.ts b/apps/code/src/main/trpc/routers/pr-snapshot.ts
deleted file mode 100644
index e4a69d619f..0000000000
--- a/apps/code/src/main/trpc/routers/pr-snapshot.ts
+++ /dev/null
@@ -1,35 +0,0 @@
-import {
-  getPrSnapshotsInput,
-  PrSnapshotEvent,
-  type PrSnapshotEvents,
-  refreshPrSnapshotsInput,
-  taskPrSnapshotArray,
-} from "@shared/types/pr-snapshot";
-import { container } from "../../di/container";
-import { MAIN_TOKENS } from "../../di/tokens";
-import type { PrSnapshotService } from "../../services/pr-snapshot/service";
-import { publicProcedure, router } from "../trpc";
-
-const getService = () =>
-  container.get<PrSnapshotService>(MAIN_TOKENS.PrSnapshotService);
-
-function subscribe<K extends keyof PrSnapshotEvents>(event: K) {
-  return publicProcedure.subscription(async function* (opts) {
-    const service = getService();
-    const iterable = service.toIterable(event, { signal: opts.signal });
-    for await (const data of iterable) {
-      yield data;
-    }
-  });
-}
-
-export const prSnapshotRouter = router({
-  getSnapshots: publicProcedure
-    .input(getPrSnapshotsInput)
-    .output(taskPrSnapshotArray)
-    .query(({ input }) => getService().getSnapshots(input.tasks)),
-  refresh: publicProcedure
-    .input(refreshPrSnapshotsInput)
-    .mutation(({ input }) => getService().refresh(input.tasks)),
-  onUpdated: subscribe(PrSnapshotEvent.Updated),
-});
diff --git a/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
index ac4bf53bba..cbf8c09e28 100644
--- a/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeActiveAgentsStrip.tsx
@@ -1,10 +1,10 @@
 import { CircleNotch, GitBranch, Warning } from "@phosphor-icons/react";
 import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import type { HomeActiveAgent } from "@shared/types/home-snapshot";
 import { useNavigationStore } from "@stores/navigationStore";
 import { formatRelativeTimeShort } from "@utils/time";
 import { useMemo } from "react";
-import type { HomeActiveAgent } from "../utils/buildSnapshot";
 
 interface HomeActiveAgentsStripProps {
   agents: HomeActiveAgent[];
diff --git a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
index d97aaccc8f..3abf84f16a 100644
--- a/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeBoardView.tsx
@@ -1,8 +1,8 @@
 import { ScrollArea } from "@radix-ui/themes";
+import type { HomeSnapshot } from "@shared/types/home-snapshot";
 import type { SituationId } from "@shared/types/workflow";
 import { useMemo } from "react";
 import { buildBoardColumns, type HomeBoardColumn } from "../utils/boardColumns";
-import type { HomeSnapshot } from "../utils/buildSnapshot";
 import { SITUATION_VISUAL, situationCss } from "../utils/situationDisplay";
 import { HomeWorkstreamCard } from "./HomeWorkstreamCard";
 
diff --git a/apps/code/src/renderer/features/home/components/HomeView.tsx b/apps/code/src/renderer/features/home/components/HomeView.tsx
index 40ac12058c..51df3b8bb3 100644
--- a/apps/code/src/renderer/features/home/components/HomeView.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeView.tsx
@@ -2,22 +2,17 @@ import { DotsCircleSpinner } from "@components/DotsCircleSpinner";
 import { useSetHeaderContent } from "@hooks/useSetHeaderContent";
 import {
   CircleHalf,
-  Flask,
   Graph,
   House,
   Kanban,
   ListBullets,
   Warning,
 } from "@phosphor-icons/react";
-import { Badge, Button } from "@posthog/quill";
+import { Button } from "@posthog/quill";
 import { Box, Flex, ScrollArea, Text } from "@radix-ui/themes";
-import { useEffect, useMemo } from "react";
+import { useEffect } from "react";
 import { ConfigMap } from "../config/ConfigMap";
 import { useHomeSnapshot } from "../hooks/useHomeSnapshot";
-import {
-  type HomeDemoScenario,
-  useHomeDemoStore,
-} from "../stores/homeDemoStore";
 import { type HomeViewMode, useHomeUiStore } from "../stores/homeUiStore";
 import { HomeActiveAgentsStrip } from "./HomeActiveAgentsStrip";
 import { HomeBoardView } from "./HomeBoardView";
@@ -27,10 +22,20 @@ import { HomeWorkstreamRow } from "./HomeWorkstreamRow";
 
 const VIEW_CYCLE: HomeViewMode[] = ["list", "board", "config"];
 
+const HEADER_CONTENT = (
+  <Flex align="center" gap="2" className="w-full min-w-0">
+    <House size={12} className="shrink-0 text-gray-10" />
+    <Text
+      className="truncate whitespace-nowrap font-medium text-[13px]"
+      title="Home"
+    >
+      Home
+    </Text>
+  </Flex>
+);
+
 export function HomeView() {
-  const { snapshot, isLoading, isDemo } = useHomeSnapshot();
-  const demoScenario = useHomeDemoStore((s) => s.scenario);
-  const setDemoScenario = useHomeDemoStore((s) => s.setScenario);
+  const { snapshot, isLoading } = useHomeSnapshot();
   const viewMode = useHomeUiStore((s) => s.viewMode);
   const setViewMode = useHomeUiStore((s) => s.setViewMode);
   const selectedWorkstreamId = useHomeUiStore((s) => s.selectedWorkstreamId);
@@ -38,21 +43,7 @@ export function HomeView() {
     (s) => s.setSelectedWorkstreamId,
   );
 
-  const headerContent = useMemo(
-    () => (
-      <Flex align="center" gap="2" className="w-full min-w-0">
-        <House size={12} className="shrink-0 text-gray-10" />
-        <Text
-          className="truncate whitespace-nowrap font-medium text-[13px]"
-          title="Home"
-        >
-          Home
-        </Text>
-      </Flex>
-    ),
-    [],
-  );
-  useSetHeaderContent(headerContent);
+  useSetHeaderContent(HEADER_CONTENT);
 
   useEffect(() => {
     function onKey(e: KeyboardEvent) {
@@ -97,11 +88,6 @@ export function HomeView() {
       null)
     : null;
 
-  const hasStats =
-    needsAttention.length > 0 ||
-    activeAgents.length > 0 ||
-    inProgress.length > 0;
-
   return (
     <Flex direction="column" className="h-full">
       <Box className="border-(--gray-4) border-b px-5 py-3">
@@ -111,16 +97,8 @@ export function HomeView() {
               <Text className="font-semibold text-[15px] text-gray-12">
                 Home
               </Text>
-              {isDemo ? (
-                <Badge
-                  variant="info"
-                  title="Showing fixture data — not your real workspaces"
-                >
-                  Demo data
-                </Badge>
-              ) : null}
             </Flex>
-            {hasStats ? (
+            {hasContent ? (
               <Flex align="center" gap="3" className="text-[12px]">
                 {needsAttention.length > 0 ? (
                   <Stat
@@ -150,12 +128,6 @@ export function HomeView() {
           </Flex>
           <Flex align="center" gap="2" className="shrink-0">
             <ViewModeToggle value={viewMode} onChange={setViewMode} />
-            {viewMode !== "config" ? (
-              <DemoScenarioPicker
-                value={demoScenario}
-                onChange={setDemoScenario}
-              />
-            ) : null}
           </Flex>
         </Flex>
       </Box>
@@ -169,7 +141,7 @@ export function HomeView() {
           <HomeActiveAgentsStrip agents={activeAgents} />
           <Flex className="min-h-0 flex-1">
             <Box className="min-w-0 flex-1">
-              {!hasContent && totalRows === 0 ? (
+              {!hasContent ? (
                 <HomeEmptyState hasRunningAgents={activeAgents.length > 0} />
               ) : viewMode === "board" ? (
                 <Box className="h-full min-h-0">
@@ -241,40 +213,6 @@ interface SectionProps {
   children: React.ReactNode;
 }
 
-const DEMO_OPTIONS: { value: HomeDemoScenario; label: string }[] = [
-  { value: "off", label: "Real" },
-  { value: "populated", label: "Demo" },
-  { value: "empty", label: "Empty" },
-];
-
-interface DemoScenarioPickerProps {
-  value: HomeDemoScenario;
-  onChange: (next: HomeDemoScenario) => void;
-}
-
-function DemoScenarioPicker({ value, onChange }: DemoScenarioPickerProps) {
-  return (
-    <Flex
-      align="center"
-      gap="1"
-      className="shrink-0 rounded-md border border-(--gray-4) bg-(--gray-2) p-0.5"
-      title="Switch between real data and demo fixtures (prototype only)"
-    >
-      <Flask size={11} className="ml-1 text-(--gray-10)" />
-      {DEMO_OPTIONS.map((opt) => (
-        <Button
-          key={opt.value}
-          size="xs"
-          variant={value === opt.value ? "primary" : "link-muted"}
-          onClick={() => onChange(opt.value)}
-        >
-          {opt.label}
-        </Button>
-      ))}
-    </Flex>
-  );
-}
-
 interface ViewModeToggleProps {
   value: HomeViewMode;
   onChange: (next: HomeViewMode) => void;
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
index 6c41bceb63..15bc69e714 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamCard.tsx
@@ -1,10 +1,10 @@
 import { GitBranch, GitPullRequest, Sparkle } from "@phosphor-icons/react";
 import { Button } from "@posthog/quill";
 import { Box, Flex, Text } from "@radix-ui/themes";
+import type { HomeWorkstream } from "@shared/types/home-snapshot";
 import { formatRelativeTimeShort } from "@utils/time";
 import { useWorkstreamPresentation } from "../hooks/useWorkstreamPresentation";
 import { useHomeUiStore } from "../stores/homeUiStore";
-import type { HomeWorkstream } from "../utils/buildSnapshot";
 import { SITUATION_VISUAL } from "../utils/situationDisplay";
 import { SituationChip } from "./SituationChip";
 import {
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
index f55a041998..86d9aa134d 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamDetailPanel.tsx
@@ -17,16 +17,16 @@ import { Badge, Button } from "@posthog/quill";
 import { Box, DropdownMenu, Flex, Text } from "@radix-ui/themes";
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
 import type { TaskRunStatus } from "@shared/types";
+import type {
+  HomeWorkstream,
+  HomeWorkstreamTask,
+} from "@shared/types/home-snapshot";
 import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import { useNavigationStore } from "@stores/navigationStore";
 import { openUrlInBrowser } from "@utils/browser";
 import { formatRelativeTimeShort } from "@utils/time";
 import { type BoundAction, useBoundActions } from "../hooks/useBoundActions";
 import { useRunWorkstreamAction } from "../hooks/useRunWorkstreamAction";
-import type {
-  HomeWorkstream,
-  HomeWorkstreamTask,
-} from "../utils/buildSnapshot";
 import { SituationChip } from "./SituationChip";
 
 interface Props {
@@ -324,7 +324,10 @@ function TaskRow({
       onClick={onClick}
       className="flex items-center gap-2 rounded-md border border-(--gray-5) bg-(--gray-1) px-2.5 py-1.5 text-left transition-colors hover:border-(--gray-7) hover:bg-(--gray-2)"
     >
-      <TaskStatusIcon status={task.status} isGenerating={task.isGenerating} />
+      <TaskStatusIcon
+        status={task.status ?? undefined}
+        isGenerating={task.isGenerating}
+      />
       <Text className="min-w-0 flex-1 truncate text-[12px] text-gray-12">
         {task.title}
       </Text>
diff --git a/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
index 04878b6430..d3aef6babd 100644
--- a/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
+++ b/apps/code/src/renderer/features/home/components/HomeWorkstreamRow.tsx
@@ -7,10 +7,10 @@ import {
 } from "@phosphor-icons/react";
 import { Button } from "@posthog/quill";
 import { Box, Flex, Text } from "@radix-ui/themes";
+import type { HomeWorkstream } from "@shared/types/home-snapshot";
 import { formatRelativeTimeShort } from "@utils/time";
 import { useWorkstreamPresentation } from "../hooks/useWorkstreamPresentation";
 import { useHomeUiStore } from "../stores/homeUiStore";
-import type { HomeWorkstream } from "../utils/buildSnapshot";
 import { SituationChip } from "./SituationChip";
 import {
   AuthorAvatar,
diff --git a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts b/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
deleted file mode 100644
index 6907dc11e4..0000000000
--- a/apps/code/src/renderer/features/home/fixtures/demoSnapshot.ts
+++ /dev/null
@@ -1,419 +0,0 @@
-import type { PrSnapshot } from "@shared/types/pr-snapshot";
-import { classify } from "@shared/types/workflow-classify";
-import type { HomeSnapshot, HomeWorkstream } from "../utils/buildSnapshot";
-
-function withSituations(
-  workstreams: Omit<HomeWorkstream, "situations">[],
-): HomeWorkstream[] {
-  const now = Date.now();
-  return workstreams.map((ws) => ({
-    ...ws,
-    situations: Array.from(
-      classify({
-        hasPrUrl: !!ws.prUrl,
-        pr: ws.pr
-          ? {
-              state: ws.pr.state,
-              ciStatus: ws.pr.ciStatus,
-              reviewDecision: ws.pr.reviewDecision,
-              unresolvedThreads: ws.pr.unresolvedThreads,
-              isCurrentUserAuthor: ws.pr.isCurrentUserAuthor,
-            }
-          : null,
-        branch: ws.branch,
-        lastActivityAt: ws.lastActivityAt,
-        now,
-      }),
-    ),
-  }));
-}
-
-const HOUR = 60 * 60 * 1000;
-const DAY = 24 * HOUR;
-const now = () => Date.now();
-
-function pr(overrides: Partial<PrSnapshot> & { url: string }): PrSnapshot {
-  return {
-    number: 0,
-    title: "",
-    state: "open",
-    ciStatus: "passing",
-    unresolvedThreads: 0,
-    reviewDecision: null,
-    mergeable: null,
-    isCurrentUserRequestedReviewer: false,
-    isCurrentUserAuthor: true,
-    author: "peter",
-    lastUpdatedAt: now() - HOUR,
-    ...overrides,
-  };
-}
-
-export function buildDemoSnapshot(): HomeSnapshot {
-  const t = now();
-
-  const needsAttention: Omit<HomeWorkstream, "situations">[] = [
-    // ── Critical: CI failing ───────────────────────────────────────────────
-    {
-      id: "demo-attn-ci",
-      repoName: "posthog",
-      branch: "feat/cohort-batch-export",
-      prUrl: "https://github.com/posthog/posthog/pull/29412",
-      pr: pr({
-        url: "https://github.com/posthog/posthog/pull/29412",
-        number: 29412,
-        title: "Batch export support for cohorts",
-        state: "open",
-        ciStatus: "failing",
-        unresolvedThreads: 0,
-        reviewDecision: "review_required",
-        lastUpdatedAt: t - 45 * 60_000,
-      }),
-      tasks: [
-        {
-          id: "demo-task-ci-1",
-          title: "Add cohort batch export endpoint",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 45 * 60_000,
-    },
-
-    // ── Critical: CI failing + unresolved comments (stacked attentions) ────
-    {
-      id: "demo-attn-ci-comments",
-      repoName: "posthog-js",
-      branch: "fix/web-vitals-sampling",
-      prUrl: "https://github.com/posthog/posthog-js/pull/1820",
-      pr: pr({
-        url: "https://github.com/posthog/posthog-js/pull/1820",
-        number: 1820,
-        title: "Sample web-vitals at session boundary",
-        state: "open",
-        ciStatus: "failing",
-        unresolvedThreads: 2,
-        reviewDecision: "changes_requested",
-        lastUpdatedAt: t - 4 * HOUR,
-      }),
-      tasks: [
-        {
-          id: "demo-task-ci-comments-1",
-          title: "Sample web-vitals at session boundary",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-        {
-          id: "demo-task-ci-comments-2",
-          title: "Address review feedback",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 4 * HOUR,
-    },
-
-    // ── Attention: Review requested on me ──────────────────────────────────
-    {
-      id: "demo-attn-review-1",
-      repoName: "posthog",
-      branch: "feat/insights-formula-cleanup",
-      prUrl: "https://github.com/posthog/posthog/pull/29385",
-      pr: pr({
-        url: "https://github.com/posthog/posthog/pull/29385",
-        number: 29385,
-        title: "Refactor insights formula parser",
-        state: "open",
-        ciStatus: "passing",
-        unresolvedThreads: 0,
-        reviewDecision: "review_required",
-        isCurrentUserAuthor: false,
-        isCurrentUserRequestedReviewer: true,
-        author: "thomas",
-        lastUpdatedAt: t - 6 * HOUR,
-      }),
-      tasks: [],
-      lastActivityAt: t - 6 * HOUR,
-    },
-
-    // ── Attention: Review requested on me (urgent / older) ─────────────────
-    {
-      id: "demo-attn-review-2",
-      repoName: "posthog",
-      branch: "fix/billing-quota-display",
-      prUrl: "https://github.com/posthog/posthog/pull/29298",
-      pr: pr({
-        url: "https://github.com/posthog/posthog/pull/29298",
-        number: 29298,
-        title: "Fix billing quota off-by-one in usage modal",
-        state: "open",
-        ciStatus: "passing",
-        unresolvedThreads: 0,
-        reviewDecision: "review_required",
-        isCurrentUserAuthor: false,
-        isCurrentUserRequestedReviewer: true,
-        author: "raquel",
-        lastUpdatedAt: t - 2 * DAY,
-      }),
-      tasks: [],
-      lastActivityAt: t - 2 * DAY,
-    },
-
-    // ── Attention: PR has unresolved comments on my PR ─────────────────────
-    {
-      id: "demo-attn-comments",
-      repoName: "posthog-code",
-      branch: "posthog-code/skill-buttons-v2",
-      prUrl: "https://github.com/posthog/posthog-code/pull/2401",
-      pr: pr({
-        url: "https://github.com/posthog/posthog-code/pull/2401",
-        number: 2401,
-        title: "Skill buttons v2 — bundled, custom, and recent groups",
-        state: "open",
-        ciStatus: "passing",
-        unresolvedThreads: 3,
-        reviewDecision: "changes_requested",
-        lastUpdatedAt: t - 90 * 60_000,
-      }),
-      tasks: [
-        {
-          id: "demo-task-comments-1",
-          title: "Skill buttons v2 layout",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 90 * 60_000,
-    },
-
-    // ── Attention: PR ready to merge ───────────────────────────────────────
-    {
-      id: "demo-attn-merge",
-      repoName: "posthog",
-      branch: "feat/experiments-secondary-metrics",
-      prUrl: "https://github.com/posthog/posthog/pull/29381",
-      pr: pr({
-        url: "https://github.com/posthog/posthog/pull/29381",
-        number: 29381,
-        title: "Secondary metrics in experiments view",
-        state: "open",
-        ciStatus: "passing",
-        unresolvedThreads: 0,
-        reviewDecision: "approved",
-        lastUpdatedAt: t - 30 * 60_000,
-      }),
-      tasks: [
-        {
-          id: "demo-task-merge-1",
-          title: "Add secondary metrics to experiment view",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 30 * 60_000,
-    },
-
-    // ── Quiet: Stale branch with no PR ─────────────────────────────────────
-    {
-      id: "demo-attn-stale-1",
-      repoName: "posthog-code",
-      branch: "posthog-code/onboarding-copy",
-      prUrl: null,
-      pr: null,
-      tasks: [
-        {
-          id: "demo-task-stale-1",
-          title: "Tweak onboarding copy for empty state",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 2 * DAY - 3 * HOUR,
-    },
-
-    // ── Quiet: Stale branch with 2 task runs ───────────────────────────────
-    {
-      id: "demo-attn-stale-2",
-      repoName: "posthog",
-      branch: "exp/funnel-paths-refactor",
-      prUrl: null,
-      pr: null,
-      tasks: [
-        {
-          id: "demo-task-stale-2a",
-          title: "Refactor funnel path computation",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-        {
-          id: "demo-task-stale-2b",
-          title: "Self-review funnel refactor",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 4 * DAY - 12 * HOUR,
-    },
-
-    // ── Quiet: Merged PR with leftover worktree ────────────────────────────
-    {
-      id: "demo-attn-cleanup",
-      repoName: "posthog-js",
-      branch: "fix/autocapture-shadow-dom",
-      prUrl: "https://github.com/posthog/posthog-js/pull/1789",
-      pr: pr({
-        url: "https://github.com/posthog/posthog-js/pull/1789",
-        number: 1789,
-        title: "Capture clicks inside shadow DOM",
-        state: "merged",
-        ciStatus: "passing",
-        unresolvedThreads: 0,
-        reviewDecision: "approved",
-        lastUpdatedAt: t - 5 * DAY,
-      }),
-      tasks: [
-        {
-          id: "demo-task-cleanup-1",
-          title: "Capture clicks inside shadow DOM",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 5 * DAY,
-    },
-  ];
-
-  const inProgress: Omit<HomeWorkstream, "situations">[] = [
-    {
-      id: "demo-ip-pr-open",
-      repoName: "posthog",
-      branch: "feat/cdp-hog-flow-retries",
-      prUrl: "https://github.com/posthog/posthog/pull/29402",
-      pr: pr({
-        url: "https://github.com/posthog/posthog/pull/29402",
-        number: 29402,
-        title: "Hog Flow: per-step retry policy",
-        state: "open",
-        ciStatus: "passing",
-        unresolvedThreads: 0,
-        reviewDecision: "review_required",
-        lastUpdatedAt: t - 5 * HOUR,
-      }),
-      tasks: [
-        {
-          id: "demo-task-ip-pr-open-1",
-          title: "Per-step retry policy for Hog Flow",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 5 * HOUR,
-    },
-    {
-      id: "demo-ip-draft",
-      repoName: "posthog",
-      branch: "exp/web-experiments-headless",
-      prUrl: "https://github.com/posthog/posthog/pull/29397",
-      pr: pr({
-        url: "https://github.com/posthog/posthog/pull/29397",
-        number: 29397,
-        title: "Headless mode for web experiments runner",
-        state: "draft",
-        ciStatus: "pending",
-        unresolvedThreads: 0,
-        reviewDecision: null,
-        lastUpdatedAt: t - 2 * HOUR,
-      }),
-      tasks: [
-        {
-          id: "demo-task-ip-draft-1",
-          title: "Headless mode for web experiments",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 2 * HOUR,
-    },
-    {
-      id: "demo-ip-no-pr",
-      repoName: "posthog-docs",
-      branch: "docs/error-tracking-quickstart",
-      prUrl: null,
-      pr: null,
-      tasks: [
-        {
-          id: "demo-task-ip-no-pr-1",
-          title: "Draft error tracking quickstart",
-          status: "completed",
-          isGenerating: false,
-          needsPermission: false,
-        },
-      ],
-      lastActivityAt: t - 90 * 60_000,
-    },
-  ];
-
-  return {
-    activeAgents: [
-      {
-        taskId: "demo-agent-1",
-        title: "Add Home tab to sidebar",
-        repoName: "posthog-code",
-        branch: "posthog-code/home-tab",
-        status: "in_progress",
-        lastActivityAt: t - 2 * 60_000,
-        needsPermission: false,
-        cloudPrUrl: null,
-      },
-      {
-        taskId: "demo-agent-2",
-        title: "Migrate event ingestion to new schema",
-        repoName: "posthog",
-        branch: "feat/ingest-v2",
-        status: "in_progress",
-        lastActivityAt: t - 18 * 60_000,
-        needsPermission: true,
-        cloudPrUrl: null,
-      },
-      {
-        taskId: "demo-agent-3",
-        title: "Investigate replay player frame drops",
-        repoName: "posthog",
-        branch: "fix/replay-frame-drops",
-        status: "queued",
-        lastActivityAt: t - 35 * 60_000,
-        needsPermission: false,
-        cloudPrUrl: null,
-      },
-      {
-        taskId: "demo-agent-4",
-        title: "Review billing-quota-display PR",
-        repoName: "posthog",
-        branch: "review/29298",
-        status: "in_progress",
-        lastActivityAt: t - 4 * 60_000,
-        needsPermission: false,
-        cloudPrUrl: null,
-      },
-    ],
-    needsAttention: withSituations(needsAttention),
-    inProgress: withSituations(inProgress),
-  };
-}
-
-export const EMPTY_SNAPSHOT: HomeSnapshot = {
-  activeAgents: [],
-  needsAttention: [],
-  inProgress: [],
-};
diff --git a/apps/code/src/renderer/features/home/hooks/useBoundActions.ts b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
index 0accd8cbc9..868fe19b6b 100644
--- a/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
+++ b/apps/code/src/renderer/features/home/hooks/useBoundActions.ts
@@ -1,11 +1,11 @@
 import { useWorkflow } from "@features/home/hooks/useWorkflow";
+import type { HomeWorkstream } from "@shared/types/home-snapshot";
 import {
   SITUATIONS,
   type SituationId,
   type WorkflowAction,
 } from "@shared/types/workflow";
 import { useMemo } from "react";
-import type { HomeWorkstream } from "../utils/buildSnapshot";
 
 export interface BoundAction extends WorkflowAction {
   /** Situation this action came from — used for telemetry + tooltips. */
diff --git a/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
index add715e44e..a3307f3494 100644
--- a/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
+++ b/apps/code/src/renderer/features/home/hooks/useHomeSnapshot.ts
@@ -1,56 +1,22 @@
-import type { TaskPrRef } from "@shared/types/pr-snapshot";
-import { useMemo } from "react";
-import { buildDemoSnapshot, EMPTY_SNAPSHOT } from "../fixtures/demoSnapshot";
-import { useHomeDemoStore } from "../stores/homeDemoStore";
+import { useTRPC } from "@renderer/trpc";
 import {
-  buildSnapshotFromTasks,
+  EMPTY_HOME_SNAPSHOT,
   type HomeSnapshot,
-} from "../utils/buildSnapshot";
-import { useHomeTasks } from "./useHomeTasks";
-import { usePrSnapshots } from "./usePrSnapshots";
+} from "@shared/types/home-snapshot";
+import { useQuery } from "@tanstack/react-query";
 
+// Single-query window into the server-computed Home snapshot. Grouping, PR
+// polling, and classification all run server-side (PostHog's
+// evaluate-code-workstreams worker); the subscription registrar keeps this
+// query fresh (features/home/subscriptions.ts).
 export function useHomeSnapshot(): {
   snapshot: HomeSnapshot;
   isLoading: boolean;
-  isDemo: boolean;
 } {
-  const { pinnedTasks, flatTasks, isLoading } = useHomeTasks();
-  const demoScenario = useHomeDemoStore((s) => s.scenario);
-
-  // Tasks worth resolving a PR for: a cloud PR URL, a branch (which may have a
-  // PR), or a worktree. Skipped in demo mode, which supplies its own fixtures.
-  const prRefs = useMemo<TaskPrRef[]>(() => {
-    if (demoScenario !== "off") return [];
-    const refs: TaskPrRef[] = [];
-    for (const task of [...pinnedTasks, ...flatTasks]) {
-      if (
-        task.cloudPrUrl ||
-        task.linkedBranch ||
-        task.branchName ||
-        task.folderPath
-      ) {
-        refs.push({ taskId: task.id, cloudPrUrl: task.cloudPrUrl });
-      }
-    }
-    return refs;
-  }, [demoScenario, pinnedTasks, flatTasks]);
-
-  const prByTaskId = usePrSnapshots(prRefs);
-
-  const realSnapshot = useMemo(
-    () => buildSnapshotFromTasks(pinnedTasks, flatTasks, prByTaskId),
-    [pinnedTasks, flatTasks, prByTaskId],
-  );
-
-  const snapshot = useMemo(() => {
-    if (demoScenario === "populated") return buildDemoSnapshot();
-    if (demoScenario === "empty") return EMPTY_SNAPSHOT;
-    return realSnapshot;
-  }, [demoScenario, realSnapshot]);
-
+  const trpc = useTRPC();
+  const query = useQuery(trpc.home.getSnapshot.queryOptions());
   return {
-    snapshot,
-    isLoading: demoScenario !== "off" ? false : isLoading,
-    isDemo: demoScenario !== "off",
+    snapshot: query.data ?? EMPTY_HOME_SNAPSHOT,
+    isLoading: query.isLoading,
   };
 }
diff --git a/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts b/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
deleted file mode 100644
index 030d84482e..0000000000
--- a/apps/code/src/renderer/features/home/hooks/useHomeTasks.ts
+++ /dev/null
@@ -1,84 +0,0 @@
-import { useArchivedTaskIds } from "@features/archive/hooks/useArchivedTaskIds";
-import { useSessions } from "@features/sessions/stores/sessionStore";
-import { usePinnedTasks } from "@features/sidebar/hooks/usePinnedTasks";
-import {
-  type TaskData,
-  toTaskData,
-} from "@features/sidebar/hooks/useSidebarData";
-import { useTaskViewed } from "@features/sidebar/hooks/useTaskViewed";
-import { useSidebarStore } from "@features/sidebar/stores/sidebarStore";
-import { useSuspendedTaskIds } from "@features/suspension/hooks/useSuspendedTaskIds";
-import { useTasks } from "@features/tasks/hooks/useTasks";
-import { useWorkspaces } from "@features/workspace/hooks/useWorkspace";
-import { useMemo } from "react";
-
-export interface HomeTasks {
-  pinnedTasks: TaskData[];
-  flatTasks: TaskData[];
-  isLoading: boolean;
-}
-
-const byActivity = (a: TaskData, b: TaskData) =>
-  b.lastActivityAt - a.lastActivityAt;
-
-// Home aggregates ALL of the user's tasks, not the sidebar's workspace-scoped
-// slice: it sources the full task list (createdBy = me) and reuses the sidebar's
-// Task → TaskData mapping, so cloud tasks and tasks without a checkout surface.
-export function useHomeTasks(): HomeTasks {
-  const showInternal = useSidebarStore((s) => s.showInternal);
-  const { data: tasks = [], isLoading } = useTasks({ showInternal });
-  const { data: workspaces, isFetched: workspacesFetched } = useWorkspaces();
-  const sessions = useSessions();
-  const { timestamps } = useTaskViewed();
-  const { pinnedTaskIds } = usePinnedTasks();
-  const suspendedTaskIds = useSuspendedTaskIds();
-  const archivedTaskIds = useArchivedTaskIds();
-
-  const sessionByTaskId = useMemo(() => {
-    const map = new Map<string, (typeof sessions)[string]>();
-    for (const session of Object.values(sessions)) {
-      if (session.taskId) map.set(session.taskId, session);
-    }
-    return map;
-  }, [sessions]);
-
-  const taskData = useMemo(
-    () =>
-      tasks
-        .filter((task) => !archivedTaskIds.has(task.id))
-        .map((task) =>
-          toTaskData(task, {
-            session: sessionByTaskId.get(task.id),
-            workspace: workspaces?.[task.id],
-            taskTimestamps: timestamps[task.id],
-            isPinned: pinnedTaskIds.has(task.id),
-            isSuspended: suspendedTaskIds.has(task.id),
-            isSlackOrigin: false,
-          }),
-        ),
-    [
-      tasks,
-      archivedTaskIds,
-      sessionByTaskId,
-      workspaces,
-      timestamps,
-      pinnedTaskIds,
-      suspendedTaskIds,
-    ],
-  );
-
-  const pinnedTasks = useMemo(
-    () => taskData.filter((t) => t.isPinned).sort(byActivity),
-    [taskData],
-  );
-  const flatTasks = useMemo(
-    () => taskData.filter((t) => !t.isPinned).sort(byActivity),
-    [taskData],
-  );
-
-  return {
-    pinnedTasks,
-    flatTasks,
-    isLoading: isLoading || !workspacesFetched,
-  };
-}
diff --git a/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts b/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
deleted file mode 100644
index 6ca0b97f40..0000000000
--- a/apps/code/src/renderer/features/home/hooks/usePrSnapshots.ts
+++ /dev/null
@@ -1,44 +0,0 @@
-import { useTRPC } from "@renderer/trpc";
-import type { PrSnapshot, TaskPrRef } from "@shared/types/pr-snapshot";
-import { useQuery } from "@tanstack/react-query";
-import { useMemo } from "react";
-import { usePrSnapshotStore } from "../stores/prSnapshotStore";
-
-/**
- * Resolves PR/CI snapshots for the given tasks as a `Map` keyed by task id. The
- * query registers the tasks for background polling and seeds the first paint;
- * the subscription store (features/home/subscriptions.ts) wins after that. Tasks
- * without a PR are simply absent from the map.
- */
-export function usePrSnapshots(refs: TaskPrRef[]): Map<string, PrSnapshot> {
-  const trpc = useTRPC();
-
-  // Dedupe + sort for a stable query key. `refs` is already memoized upstream,
-  // and TanStack serialises the input, so an equal-content list never refetches.
-  const tasks = useMemo(() => {
-    const byId = new Map<string, TaskPrRef>();
-    for (const ref of refs) byId.set(ref.taskId, ref);
-    return [...byId.values()].sort((a, b) => a.taskId.localeCompare(b.taskId));
-  }, [refs]);
-
-  const query = useQuery(
-    trpc.prSnapshot.getSnapshots.queryOptions(
-      { tasks },
-      { enabled: tasks.length > 0, staleTime: 60_000 },
-    ),
-  );
-
-  const byTaskId = usePrSnapshotStore((s) => s.byTaskId);
-
-  return useMemo(() => {
-    const map = new Map<string, PrSnapshot>();
-    for (const { taskId, snapshot } of query.data ?? [])
-      map.set(taskId, snapshot);
-    // Subscription cache is fresher than the initial query — let it win.
-    for (const ref of tasks) {
-      const snapshot = byTaskId[ref.taskId];
-      if (snapshot) map.set(ref.taskId, snapshot);
-    }
-    return map;
-  }, [query.data, byTaskId, tasks]);
-}
diff --git a/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
index 3f72e9b31d..863cecc6e9 100644
--- a/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
+++ b/apps/code/src/renderer/features/home/hooks/useRunWorkstreamAction.ts
@@ -11,6 +11,7 @@ import { useUserRepositoryIntegration } from "@hooks/useIntegrations";
 import { get } from "@renderer/di/container";
 import { RENDERER_TOKENS } from "@renderer/di/tokens";
 import { ANALYTICS_EVENTS } from "@shared/types/analytics";
+import type { HomeWorkstream } from "@shared/types/home-snapshot";
 import { getCloudUrlFromRegion } from "@shared/utils/urls";
 import { useNavigationStore } from "@stores/navigationStore";
 import { pendingTaskPromptStoreApi } from "@stores/pendingTaskPromptStore";
@@ -18,7 +19,6 @@ import { track } from "@utils/analytics";
 import { logger } from "@utils/logger";
 import { toast } from "@utils/toast";
 import { useCallback, useRef } from "react";
-import type { HomeWorkstream } from "../utils/buildSnapshot";
 import type { BoundAction } from "./useBoundActions";
 
 const log = logger.scope("home-quick-action");
diff --git a/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts b/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
index b3de913946..87db5a2e89 100644
--- a/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
+++ b/apps/code/src/renderer/features/home/hooks/useWorkstreamPresentation.ts
@@ -1,10 +1,10 @@
 import { useTasks } from "@renderer/features/tasks/hooks/useTasks";
+import type { HomeWorkstream } from "@shared/types/home-snapshot";
 import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import type { SituationId } from "@shared/types/workflow";
 import { pickPrimarySituation } from "@shared/types/workflow-classify";
 import { useNavigationStore } from "@stores/navigationStore";
 import { openUrlInBrowser } from "@utils/browser";
-import type { HomeWorkstream } from "../utils/buildSnapshot";
 import {
   SITUATION_VISUAL,
   type SituationCss,
diff --git a/apps/code/src/renderer/features/home/stores/homeDemoStore.ts b/apps/code/src/renderer/features/home/stores/homeDemoStore.ts
deleted file mode 100644
index 62adedad5f..0000000000
--- a/apps/code/src/renderer/features/home/stores/homeDemoStore.ts
+++ /dev/null
@@ -1,23 +0,0 @@
-import { electronStorage } from "@utils/electronStorage";
-import { create } from "zustand";
-import { persist } from "zustand/middleware";
-
-export type HomeDemoScenario = "off" | "populated" | "empty";
-
-interface HomeDemoStore {
-  scenario: HomeDemoScenario;
-  setScenario: (scenario: HomeDemoScenario) => void;
-}
-
-export const useHomeDemoStore = create<HomeDemoStore>()(
-  persist(
-    (set) => ({
-      scenario: "off",
-      setScenario: (scenario) => set({ scenario }),
-    }),
-    {
-      name: "home-demo-store",
-      storage: electronStorage,
-    },
-  ),
-);
diff --git a/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts b/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
deleted file mode 100644
index 70560b24a2..0000000000
--- a/apps/code/src/renderer/features/home/stores/prSnapshotStore.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-import type { PrSnapshot, TaskPrSnapshot } from "@shared/types/pr-snapshot";
-import { create } from "zustand";
-
-// Subscription-fed cache of PR/CI snapshots, keyed by task id. Pure UI state
-// (R2): mirrors what PrSnapshotService pushes over `prSnapshot.onUpdated`.
-interface PrSnapshotStore {
-  byTaskId: Record<string, PrSnapshot>;
-  upsertMany: (results: TaskPrSnapshot[]) => void;
-}
-
-export const usePrSnapshotStore = create<PrSnapshotStore>((set) => ({
-  byTaskId: {},
-  upsertMany: (results) =>
-    set((state) => {
-      if (results.length === 0) return state;
-      const byTaskId = { ...state.byTaskId };
-      for (const { taskId, snapshot } of results) byTaskId[taskId] = snapshot;
-      return { byTaskId };
-    }),
-}));
diff --git a/apps/code/src/renderer/features/home/subscriptions.ts b/apps/code/src/renderer/features/home/subscriptions.ts
index b7cfb22006..e1b9794b80 100644
--- a/apps/code/src/renderer/features/home/subscriptions.ts
+++ b/apps/code/src/renderer/features/home/subscriptions.ts
@@ -1,7 +1,6 @@
 import { trpc, trpcClient } from "@renderer/trpc";
 import { logger } from "@utils/logger";
 import { queryClient } from "@utils/queryClient";
-import { usePrSnapshotStore } from "./stores/prSnapshotStore";
 
 const log = logger.scope("home-subscriptions");
 
@@ -15,20 +14,20 @@ export function registerHomeSubscriptions() {
     },
   });
 
-  const prSnapshotUpdated = trpcClient.prSnapshot.onUpdated.subscribe(
+  const homeSnapshotUpdated = trpcClient.home.onSnapshotUpdated.subscribe(
     undefined,
     {
-      onData: (snapshots) => {
-        usePrSnapshotStore.getState().upsertMany(snapshots);
+      onData: (next) => {
+        queryClient.setQueryData(trpc.home.getSnapshot.queryKey(), next);
       },
       onError: (error) => {
-        log.error("prSnapshot.onUpdated subscription error", { error });
+        log.error("home.onSnapshotUpdated subscription error", { error });
       },
     },
   );
 
   return () => {
     workflowChanged.unsubscribe();
-    prSnapshotUpdated.unsubscribe();
+    homeSnapshotUpdated.unsubscribe();
   };
 }
diff --git a/apps/code/src/renderer/features/home/utils/boardColumns.ts b/apps/code/src/renderer/features/home/utils/boardColumns.ts
index a098e6374a..6cb6a65363 100644
--- a/apps/code/src/renderer/features/home/utils/boardColumns.ts
+++ b/apps/code/src/renderer/features/home/utils/boardColumns.ts
@@ -1,6 +1,6 @@
+import type { HomeWorkstream } from "@shared/types/home-snapshot";
 import { SITUATIONS, type SituationId } from "@shared/types/workflow";
 import { pickPrimarySituation } from "@shared/types/workflow-classify";
-import type { HomeWorkstream } from "./buildSnapshot";
 
 export type HomeBoardColumn = {
   id: SituationId;
diff --git a/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts b/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
deleted file mode 100644
index ba2de14120..0000000000
--- a/apps/code/src/renderer/features/home/utils/buildSnapshot.test.ts
+++ /dev/null
@@ -1,171 +0,0 @@
-import type { TaskData } from "@features/sidebar/hooks/useSidebarData";
-import type { PrSnapshot } from "@shared/types/pr-snapshot";
-import { describe, expect, it } from "vitest";
-import { buildSnapshotFromTasks } from "./buildSnapshot";
-
-const MINUTE = 60 * 1000;
-
-function makePr(overrides: Partial<PrSnapshot> = {}): PrSnapshot {
-  return {
-    url: "https://github.com/org/repo/pull/7",
-    number: 7,
-    title: "PR",
-    state: "open",
-    ciStatus: "passing",
-    reviewDecision: null,
-    unresolvedThreads: 0,
-    mergeable: null,
-    isCurrentUserRequestedReviewer: false,
-    isCurrentUserAuthor: true,
-    author: "me",
-    lastUpdatedAt: Date.now(),
-    ...overrides,
-  };
-}
-
-function makeTask(overrides: Partial<TaskData> = {}): TaskData {
-  return {
-    id: "t1",
-    title: "Task",
-    createdAt: Date.now(),
-    lastActivityAt: Date.now(),
-    isGenerating: false,
-    isUnread: false,
-    isPinned: false,
-    needsPermission: false,
-    repository: { fullPath: "org/repo", name: "repo" },
-    isSuspended: false,
-    taskRunStatus: "in_progress",
-    folderPath: null,
-    cloudPrUrl: null,
-    branchName: "feature",
-    linkedBranch: null,
-    ...overrides,
-  };
-}
-
-describe("buildSnapshotFromTasks — Running strip", () => {
-  it("keeps a genuinely live in_progress agent in the Running strip", () => {
-    const { activeAgents, inProgress, needsAttention } = buildSnapshotFromTasks(
-      [],
-      [makeTask({ lastActivityAt: Date.now() - MINUTE })],
-    );
-
-    expect(activeAgents).toHaveLength(1);
-    expect(inProgress).toHaveLength(0);
-    expect(needsAttention).toHaveLength(0);
-  });
-
-  it("drops an agent with an open PR out of Running and into review", () => {
-    const { activeAgents, inProgress } = buildSnapshotFromTasks(
-      [],
-      [
-        makeTask({
-          cloudPrUrl: "https://github.com/org/repo/pull/1",
-          lastActivityAt: Date.now(),
-        }),
-      ],
-    );
-
-    expect(activeAgents).toHaveLength(0);
-    expect(inProgress).toHaveLength(1);
-    expect(inProgress[0]?.situations).toContain("in_review");
-  });
-
-  it("drops a stale in_progress agent out of the Running strip", () => {
-    const { activeAgents, inProgress, needsAttention } = buildSnapshotFromTasks(
-      [],
-      [makeTask({ lastActivityAt: Date.now() - 45 * MINUTE })],
-    );
-
-    expect(activeAgents).toHaveLength(0);
-    // Branch with no PR + recent-enough to not be 7-day stale → "Working".
-    expect(inProgress).toHaveLength(1);
-    expect(inProgress[0]?.situations).toContain("working");
-    expect(needsAttention).toHaveLength(0);
-  });
-
-  it("keeps a stale-by-timestamp agent in Running while it awaits permission", () => {
-    const { activeAgents } = buildSnapshotFromTasks(
-      [],
-      [
-        makeTask({
-          needsPermission: true,
-          lastActivityAt: Date.now() - 45 * MINUTE,
-        }),
-      ],
-    );
-
-    expect(activeAgents).toHaveLength(1);
-  });
-
-  it("keeps a stale-by-timestamp agent in Running while it is generating", () => {
-    const { activeAgents } = buildSnapshotFromTasks(
-      [],
-      [
-        makeTask({
-          isGenerating: true,
-          lastActivityAt: Date.now() - 45 * MINUTE,
-        }),
-      ],
-    );
-
-    expect(activeAgents).toHaveLength(1);
-  });
-});
-
-describe("buildSnapshotFromTasks — resolved PR snapshots (branch PRs)", () => {
-  it("surfaces a branch PR with failing CI under Needs attention", () => {
-    const task = makeTask({
-      id: "t-ci",
-      taskRunStatus: "completed",
-      cloudPrUrl: null, // PR lives on the branch, not cloud-run output
-      linkedBranch: "feature",
-    });
-    const prByTaskId = new Map([
-      [task.id, makePr({ ciStatus: "failing", state: "open" })],
-    ]);
-
-    const { needsAttention, inProgress, activeAgents } = buildSnapshotFromTasks(
-      [],
-      [task],
-      prByTaskId,
-    );
-
-    expect(activeAgents).toHaveLength(0);
-    expect(needsAttention).toHaveLength(1);
-    expect(needsAttention[0]?.situations).toContain("ci_failing");
-    expect(needsAttention[0]?.prUrl).toBe("https://github.com/org/repo/pull/7");
-    expect(needsAttention[0]?.pr?.ciStatus).toBe("failing");
-    expect(inProgress).toHaveLength(0);
-  });
-
-  it("groups a task under its resolved PR even without a cloud PR URL", () => {
-    const task = makeTask({
-      id: "t-rev",
-      taskRunStatus: "completed",
-      cloudPrUrl: null,
-    });
-    const prByTaskId = new Map([[task.id, makePr({ state: "open" })]]);
-
-    const { inProgress } = buildSnapshotFromTasks([], [task], prByTaskId);
-
-    expect(inProgress).toHaveLength(1);
-    expect(inProgress[0]?.situations).toContain("in_review");
-  });
-
-  it("drops an in_progress agent with a resolved branch PR out of Running", () => {
-    const task = makeTask({ cloudPrUrl: null, lastActivityAt: Date.now() });
-    const prByTaskId = new Map([[task.id, makePr({ state: "open" })]]);
-
-    const { activeAgents, inProgress } = buildSnapshotFromTasks(
-      [],
-      [task],
-      prByTaskId,
-    );
-
-    expect(activeAgents).toHaveLength(0);
-    expect(inProgress).toHaveLength(1);
-    expect(inProgress[0]?.situations).toContain("in_review");
-  });
-});
diff --git a/apps/code/src/renderer/features/home/utils/buildSnapshot.ts b/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
deleted file mode 100644
index cf27e1c26c..0000000000
--- a/apps/code/src/renderer/features/home/utils/buildSnapshot.ts
+++ /dev/null
@@ -1,208 +0,0 @@
-import type { TaskData } from "@features/sidebar/hooks/useSidebarData";
-import type { TaskRunStatus } from "@shared/types";
-import type { PrSnapshot } from "@shared/types/pr-snapshot";
-import type { SituationId } from "@shared/types/workflow";
-import { classify } from "@shared/types/workflow-classify";
-
-export type HomeActiveAgent = {
-  taskId: string;
-  title: string;
-  repoName: string | null;
-  branch: string | null;
-  status: TaskRunStatus;
-  lastActivityAt: number;
-  needsPermission: boolean;
-  cloudPrUrl: string | null;
-};
-
-export type HomeWorkstreamTask = {
-  id: string;
-  title: string;
-  status?: TaskRunStatus;
-  isGenerating: boolean;
-  needsPermission: boolean;
-};
-
-export type HomeWorkstream = {
-  id: string;
-  /** Bare repo name (e.g. "posthog") — for display only. */
-  repoName: string | null;
-  /**
-   * Full "org/repo" slug, lowercased. The key the GitHub integration map and
-   * cloud repo selectors use, so quick actions resolve from this, not `repoName`.
-   */
-  repoFullPath?: string | null;
-  branch: string | null;
-  prUrl: string | null;
-  pr: PrSnapshot | null;
-  tasks: HomeWorkstreamTask[];
-  /** Situations this workstream is in — drives board placement + bound actions. */
-  situations: SituationId[];
-  lastActivityAt: number;
-};
-
-export type HomeSnapshot = {
-  activeAgents: HomeActiveAgent[];
-  needsAttention: HomeWorkstream[];
-  inProgress: HomeWorkstream[];
-};
-
-const RUNNING_STATUSES: ReadonlySet<TaskRunStatus> = new Set([
-  "queued",
-  "in_progress",
-]);
-
-// Past this idle gap a still-`in_progress` run is treated as a status the server
-// never closed out, not a live agent.
-const RUNNING_STALE_THRESHOLD_MS = 30 * 60 * 1000;
-
-// Situations that escalate a workstream into the "Needs attention" bucket on
-// the list view. Everything else falls into "In progress".
-const ATTENTION_SITUATIONS: ReadonlySet<SituationId> = new Set([
-  "ci_failing",
-  "changes_requested",
-  "comments_waiting",
-  "stale",
-]);
-
-function isRunning(status?: TaskRunStatus): boolean {
-  return !!status && RUNNING_STATUSES.has(status);
-}
-
-// "Running" requires a live status AND genuine activity. An open PR means the
-// agent moved past working into review; a long-idle run is a status the server
-// never closed out — both fall through to grouping/classify(). An actively
-// generating or waiting session is always live (its activity timestamp may not tick).
-function isActivelyRunning(
-  task: TaskData,
-  now: number,
-  hasPr: boolean,
-): boolean {
-  if (!isRunning(task.taskRunStatus)) return false;
-  if (hasPr) return false;
-  if (task.isGenerating || task.needsPermission) return true;
-  return now - task.lastActivityAt <= RUNNING_STALE_THRESHOLD_MS;
-}
-
-// Grouping key precedence (docs/home-tab.md §5): resolved PR URL → repo+branch →
-// worktree path. Tasks with none (e.g. an old cloud task, no PR, no checkout)
-// are skipped, so Home stays a view of actual code work.
-function workstreamKey(task: TaskData, prUrl: string | null): string | null {
-  if (prUrl) return `pr:${prUrl}`;
-  const repo = task.repository?.name ?? null;
-  const branch = task.linkedBranch ?? task.branchName ?? null;
-  if (repo && branch) return `branch:${repo}#${branch}`;
-  if (task.folderPath) return `path:${task.folderPath}`;
-  return null;
-}
-
-export function buildSnapshotFromTasks(
-  pinned: TaskData[],
-  flat: TaskData[],
-  prByTaskId?: ReadonlyMap<string, PrSnapshot>,
-): HomeSnapshot {
-  const allTasks = [...pinned, ...flat];
-  const now = Date.now();
-
-  // Effective PR per task: resolved snapshot wins, else the cloud-run URL so
-  // grouping works before the snapshot resolves.
-  const prOf = (task: TaskData): PrSnapshot | null =>
-    prByTaskId?.get(task.id) ?? null;
-  const prUrlOf = (task: TaskData): string | null =>
-    prOf(task)?.url ?? task.cloudPrUrl ?? null;
-
-  const activeAgents: HomeActiveAgent[] = [];
-  const groups = new Map<string, TaskData[]>();
-  const taskInStrip = new Set<string>();
-
-  for (const task of allTasks) {
-    const prUrl = prUrlOf(task);
-    if (isActivelyRunning(task, now, !!prUrl)) {
-      activeAgents.push({
-        taskId: task.id,
-        title: task.title,
-        repoName: task.repository?.name ?? null,
-        branch: task.linkedBranch ?? task.branchName ?? null,
-        status: task.taskRunStatus as TaskRunStatus,
-        lastActivityAt: task.lastActivityAt,
-        needsPermission: task.needsPermission,
-        cloudPrUrl: task.cloudPrUrl,
-      });
-      taskInStrip.add(task.id);
-      continue;
-    }
-    const key = workstreamKey(task, prUrl);
-    if (!key) continue;
-    const bucket = groups.get(key);
-    if (bucket) bucket.push(task);
-    else groups.set(key, [task]);
-  }
-
-  activeAgents.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-
-  const needsAttention: HomeWorkstream[] = [];
-  const inProgress: HomeWorkstream[] = [];
-
-  for (const [id, tasks] of groups) {
-    tasks.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-    const head = tasks[0];
-    if (!head) continue;
-
-    if (tasks.every((t) => taskInStrip.has(t.id))) continue;
-
-    // First task that resolves to a PR carries the snapshot; PR-grouped tasks
-    // share the URL anyway.
-    let pr: PrSnapshot | null = null;
-    let prUrl: string | null = null;
-    for (const t of tasks) {
-      const snap = prOf(t);
-      const url = snap?.url ?? t.cloudPrUrl ?? null;
-      if (url) {
-        pr = snap;
-        prUrl = url;
-        break;
-      }
-    }
-    const branch = head.linkedBranch ?? head.branchName ?? null;
-    const lastActivityAt = head.lastActivityAt;
-
-    const situations = Array.from(
-      classify({
-        hasPrUrl: !!prUrl,
-        pr,
-        branch,
-        lastActivityAt,
-        now,
-      }),
-    );
-
-    const workstream: HomeWorkstream = {
-      id,
-      repoName: head.repository?.name ?? null,
-      repoFullPath: head.repository?.fullPath ?? null,
-      branch,
-      prUrl,
-      pr,
-      tasks: tasks.map((t) => ({
-        id: t.id,
-        title: t.title,
-        status: t.taskRunStatus,
-        isGenerating: t.isGenerating,
-        needsPermission: t.needsPermission,
-      })),
-      situations,
-      lastActivityAt,
-    };
-
-    if (situations.some((s) => ATTENTION_SITUATIONS.has(s))) {
-      needsAttention.push(workstream);
-    } else {
-      inProgress.push(workstream);
-    }
-  }
-
-  needsAttention.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-  inProgress.sort((a, b) => b.lastActivityAt - a.lastActivityAt);
-
-  return { activeAgents, needsAttention, inProgress };
-}
diff --git a/apps/code/src/shared/types/home-snapshot.ts b/apps/code/src/shared/types/home-snapshot.ts
new file mode 100644
index 0000000000..2dfd7c9ad5
--- /dev/null
+++ b/apps/code/src/shared/types/home-snapshot.ts
@@ -0,0 +1,83 @@
+import { z } from "zod";
+import { prSnapshot } from "./pr-snapshot";
+import { situationId } from "./workflow";
+
+// The Home snapshot wire contract. Produced server-side by PostHog's
+// `evaluate-code-workstreams` Temporal worker and served by
+// `GET /api/projects/:id/code_home/`; the main process validates the response
+// against this schema before handing it to the renderer.
+
+// Mirrors TaskRunStatus in @shared/types (the canonical type lives there; this
+// is the runtime enum the snapshot schema validates against).
+export const taskRunStatus = z.enum([
+  "not_started",
+  "queued",
+  "in_progress",
+  "completed",
+  "failed",
+  "cancelled",
+]);
+
+export const homeActiveAgent = z
+  .object({
+    taskId: z.string(),
+    title: z.string(),
+    repoName: z.string().nullable(),
+    branch: z.string().nullable(),
+    status: taskRunStatus,
+    lastActivityAt: z.number(),
+    needsPermission: z.boolean(),
+    cloudPrUrl: z.string().nullable(),
+  })
+  .strict();
+export type HomeActiveAgent = z.infer<typeof homeActiveAgent>;
+
+export const homeWorkstreamTask = z
+  .object({
+    id: z.string(),
+    title: z.string(),
+    status: taskRunStatus.nullable(),
+    isGenerating: z.boolean(),
+    needsPermission: z.boolean(),
+  })
+  .strict();
+export type HomeWorkstreamTask = z.infer<typeof homeWorkstreamTask>;
+
+export const homeWorkstream = z
+  .object({
+    id: z.string(),
+    repoName: z.string().nullable(),
+    repoFullPath: z.string().nullable(),
+    branch: z.string().nullable(),
+    prUrl: z.string().nullable(),
+    pr: prSnapshot.nullable(),
+    tasks: z.array(homeWorkstreamTask),
+    situations: z.array(situationId),
+    lastActivityAt: z.number(),
+  })
+  .strict();
+export type HomeWorkstream = z.infer<typeof homeWorkstream>;
+
+export const homeSnapshot = z
+  .object({
+    activeAgents: z.array(homeActiveAgent),
+    needsAttention: z.array(homeWorkstream),
+    inProgress: z.array(homeWorkstream),
+  })
+  .strict();
+export type HomeSnapshot = z.infer<typeof homeSnapshot>;
+
+export const EMPTY_HOME_SNAPSHOT: HomeSnapshot = {
+  activeAgents: [],
+  needsAttention: [],
+  inProgress: [],
+};
+
+export const HomeEvent = {
+  // Emitted by HomeService whenever a fresh snapshot differs from the last one.
+  SnapshotUpdated: "snapshotUpdated",
+} as const;
+
+export interface HomeEvents {
+  [HomeEvent.SnapshotUpdated]: HomeSnapshot;
+}
diff --git a/docs/home-tab.md b/docs/home-tab.md
index e04c782914..b8cf6081fb 100644
--- a/docs/home-tab.md
+++ b/docs/home-tab.md
@@ -329,6 +329,14 @@ The user's choice persists across sessions via `homeUiStore.viewMode: "list" | "
 
 ## 8. Architecture
 
+> **Shipped architecture note.** Workstream grouping, PR polling, and situation
+> classification run **server-side in PostHog** (`products/tasks/`, a Temporal
+> worker), not in Electron main. The desktop app is a thin authenticated client:
+> `HomeService` / `WorkflowService` call the PostHog REST API and the renderer
+> reads `home.getSnapshot` / `workflow.get`. See
+> [docs/workflow-architecture.md](./workflow-architecture.md). The original
+> Electron-main design below is kept for historical context.
+
 **Main (`apps/code/src/main/services/home/`)**
 
 - `HomeService` — aggregation, classification, ranking, action dispatch. Reads the active workflow from `WorkflowService` and uses it to assign each workstream a `nodeId`.
diff --git a/docs/workflow-architecture.md b/docs/workflow-architecture.md
index 7ed3cce00c..5ddd41007d 100644
--- a/docs/workflow-architecture.md
+++ b/docs/workflow-architecture.md
@@ -1,11 +1,13 @@
-# Workflow architecture: POC → productionisation
+# Home workflow architecture (production)
 
-This doc explains where the Home **workflow** feature lives today, where it
-needs to land for production, and what the seams are so the migration is
-mechanical rather than a rewrite.
+The Home tab's data layer — workstream grouping, PR polling, situation
+classification, and workflow-config persistence — runs **server-side in
+PostHog**, in the `tasks` product (`products/tasks/` in the posthog repo). The
+Electron app is a thin authenticated client.
 
-If you change anything substantive about how workflow config is persisted
-or how PR / situation data is computed, update this doc.
+This replaced the original local POC (Electron `gh` polling + SQLite workflow
+storage + client-side classification). If you change the wire shapes or the
+classification logic, update both sides and this doc.
 
 ---
 
@@ -16,259 +18,101 @@ A user-authored mapping of **situations** a piece of work can be in
 `ready_to_merge`, `stale`, `done`) → **actions** (skill + prompt) the user
 wants available when work lands in each situation.
 
-Three concerns sit on top of that data:
+Three concerns sit on top of that:
 
-1. **Storage** — where the bindings JSON lives.
-2. **PR / signal polling** — fetching CI status, review decision, etc. for
-   each PR so situations can be classified accurately.
-3. **Classification** — pure function `(workstream, pr) → Set<SituationId>`,
-   plus the renderer logic that joins situations to bindings to surface
-   quick-action buttons.
+1. **Storage** — the per-user bindings JSON (`CodeWorkflowConfig`).
+2. **PR / signal polling** — CI status, review decision, threads, mergeability
+   for each tracked PR (`CodePrSnapshot`).
+3. **Grouping + classification** — group a user's tasks into workstreams and
+   compute the situations each is in (`CodeWorkstream`).
 
-Concern (3) doesn't move — it's a pure TS function in
-`apps/code/src/shared/types/workflow-classify.ts` and stays that way. Concerns
-(1) and (2) move to PostHog when we productionise.
+All three live in PostHog now.
 
 ---
 
-## 2. Today (POC, this repo only)
+## 2. Server (PostHog `products/tasks/backend/`)
 
-```
-┌────────────────────────────────────────────────────────────────────────┐
-│  Electron renderer (apps/code/src/renderer/features/home)              │
-│                                                                        │
-│  • ConfigList edits the workflow via tRPC                              │
-│  • useHomeSnapshot groups TaskData → HomeWorkstream                    │
-│  • classify() in @shared/ computes situations per workstream           │
-│  • useBoundActions joins situations → workflow.bindings → action list  │
-│  • HomeWorkstreamRow/Card render situation chips + bound buttons       │
-└──────────────────────────────┬─────────────────────────────────────────┘
-                               │ tRPC (workflow.* router)
-                               ▼
-┌────────────────────────────────────────────────────────────────────────┐
-│  Electron main                                                         │
-│                                                                        │
-│  WorkflowService  ──→  WorkflowBackend (interface)                     │
-│                              │                                         │
-│                              ▼                                         │
-│                       LocalWorkflowBackend ───→ SQLite                 │
-│                       (HomeWorkflowRepository)                         │
-│                                                                        │
-│  PR polling: BUILT (local). PrSnapshotService ──→ PrSnapshotBackend    │
-│  ──→ LocalPrSnapshotBackend ──→ GitService.getPrFull (gh CLI).         │
-│  Snapshots are cached, polled, and pushed to the renderer via the      │
-│  prSnapshot.onUpdated subscription; classify() now runs with real PR   │
-│  data. (pr=null only until a workstream's first fetch resolves.)       │
-└────────────────────────────────────────────────────────────────────────┘
-```
+**Pure logic** (ported 1:1 from the original TypeScript; unit-tested without
+Django) — `code_workstreams/`:
 
-**Where the actual files are:**
+- `situations.py` — situation ids, priority order, attention set.
+- `classify.py` — `classify(input) → set[SituationId]`, `pick_primary_situation`.
+- `grouping.py` — `build_workstreams(tasks, pr_by_task, now)`: groups tasks
+  (PR URL → repo+branch → path), extracts the active-agent set, classifies, and
+  buckets into needs-attention / in-progress.
+- `default_workflow.py`, `validation.py` — default bindings + save validation.
 
-| Concern | File | Lifetime |
-|---|---|---|
-| Schema (Zod + types) | `apps/code/src/shared/types/workflow.ts` | Permanent. Server will share the shape. |
-| Classifier (pure) | `apps/code/src/shared/types/workflow-classify.ts` | Permanent. Server may port to Python; same logic. |
-| Validation (pure) | `apps/code/src/shared/types/workflow-validate.ts` | Permanent. Runs both client-side (instant feedback) and inside `WorkflowService.save` (defense in depth). Server re-validates on save with the same rules — port to Python during migration. |
-| WorkflowService | `apps/code/src/main/services/workflow/service.ts` | Permanent in shape. Body stays the same after swap. |
-| `WorkflowBackend` interface | `apps/code/src/main/services/workflow/backend.ts` | Permanent. The swap point. |
-| `LocalWorkflowBackend` | same file | **POC-only.** Deleted post-migration. |
-| `CloudWorkflowBackend` | same file | Stub today, the implementation post-migration. |
-| SQLite repo | `apps/code/src/main/db/repositories/home-workflow-repository.ts` | **POC-only.** Deleted with the migration. |
-| Migration `0007_*` (`home_workflow_config` table) | `apps/code/src/main/db/migrations/` | **POC-only.** Drop the table via a follow-up migration once cloud is the source of truth. |
-| tRPC router | `apps/code/src/main/trpc/routers/workflow.ts` | Permanent shape. Same procedures, same Zod schemas — the backend just changes underneath. |
+**Models** (`models.py`):
 
-**PR snapshot files (concern 2 — built locally, same swap-point shape):**
+- `CodeWorkflowConfig` — per `(team, user)` bindings + monotonic `version`.
+- `CodePrSnapshot` — per `(team, pr_url)` polled GitHub state (shared across a
+  team's users).
+- `CodeWorkstream` — per `(team, user, key)` grouped + classified workstream;
+  the API reads these rows directly.
 
-| Concern | File | Lifetime |
-|---|---|---|
-| PR snapshot schema (Zod + type) | `apps/code/src/shared/types/pr-snapshot.ts` | Permanent. The wire contract — server serialises the same shape. |
-| `PrSnapshotService` | `apps/code/src/main/services/pr-snapshot/service.ts` | Permanent in shape. Cache + poll + emit; body stays after swap. |
-| `PrSnapshotBackend` interface | `apps/code/src/main/services/pr-snapshot/backend.ts` | Permanent. The swap point. |
-| `LocalPrSnapshotBackend` (gh CLI) | same file | **POC-only.** Deleted post-migration. |
-| `CloudPrSnapshotBackend` | same file | Stub today, the implementation post-migration. |
-| `GitService.getTaskPrSnapshot` / `resolveTaskPrUrl` / `getPrFull` + gh→snapshot mappers | `apps/code/src/main/services/git/service.ts` | **POC-only.** Unused once cloud owns PR polling. |
-| `useHomeTasks` (all-my-tasks source) | `apps/code/src/renderer/features/home/hooks/useHomeTasks.ts` | Permanent in shape; the server will provide the aggregated snapshot later. |
-| tRPC router | `apps/code/src/main/trpc/routers/pr-snapshot.ts` | Permanent shape. `onUpdated` becomes a passthrough to the server feed. |
-| Renderer cache + hook | `stores/prSnapshotStore.ts`, `hooks/usePrSnapshots.ts` | Permanent. Subscription source swaps underneath; renderer unchanged. |
+**Temporal worker** (`temporal/code_workstreams/`, task queue
+`TASKS_TASK_QUEUE`):
 
----
-
-## 3. Target (production)
-
-```
-┌───────────────────────────────┐         ┌────────────────────────────────────┐
-│ Electron renderer (unchanged) │         │  posthog/ backend                  │
-│                               │         │                                    │
-│  ConfigList, useHomeSnapshot, │         │  • CodeWorkflow Django model       │
-│  classify(), useBoundActions  │         │  • REST endpoints (see §4)         │
-│  …all identical               │         │  • Celery beat task: per-user GH   │
-└───────────────┬───────────────┘         │    PR poll, writes CodePrSnapshot  │
-                │ tRPC (unchanged)        │  • SSE/WebSocket: pushes           │
-                ▼                         │    WorkflowChanged +               │
-┌───────────────────────────────┐         │    PrSnapshotUpdated to clients    │
-│ Electron main                 │         └──────────────────┬─────────────────┘
-│                               │                            │
-│  WorkflowService              │                            │
-│    │                          │                            │
-│    ▼                          │   HTTPS (auth'd)           │
-│  CloudWorkflowBackend ────────┼────────────────────────────┘
-│  (calls posthog API)          │
-│                               │
-│  No more SQLite for workflow. │
-│  No more local PR polling.    │
-└───────────────────────────────┘
-```
+- `evaluate-code-workstreams` (dispatcher) — a Temporal **Schedule** every 3 min
+  enumerates teams with recent code activity and fans out one child workflow per
+  team (bounded concurrency).
+- `evaluate-team-code-workstreams` — per team: `load_team_pr_urls` →
+  `poll_team_pull_requests` (GitHub GraphQL via the team integration, rate-limit
+  aware, heartbeated) → `rebuild_team_workstreams` (group + classify + upsert
+  `CodeWorkstream`, prune stale).
+- On-demand refresh: `client.trigger_team_code_workstreams_evaluation(team_id)`.
 
-**What moves to `posthog/`:**
+PR state is fetched with `GitHubIntegration.get_pull_request_snapshot(pr_url)`
+(a single GraphQL call: state, draft, mergeable, review decision, CI rollup,
+unresolved threads, requested reviewers).
 
-1. **Workflow persistence.** Per-user, syncs across devices, optimistic
-   concurrency on a monotonic `version` (same as today's local SQLite logic).
-2. **PR polling worker.** One server-side worker walks every user's
-   tracked PRs, batches by host, respects per-user `gh`/PAT rate-limit
-   budgets, and writes snapshots into a `CodePrSnapshot` table that
-   downstream services read.
-3. **Snapshot delivery.** Server pushes `WorkflowChanged` and
-   `PrSnapshotUpdated` over an existing realtime channel (SSE or
-   WebSocket). The renderer subscribes via tRPC — the same shape as
-   today's `workflow.onChanged`, just sourced from upstream.
+**REST API** (`code_home_api.py`, registered under `/api/projects/:id/`):
 
-**What stays in `apps/code/`:**
+- `GET    /code_workflow/`        → `WorkflowConfig` (seeds the default first time)
+- `POST   /code_workflow/save/`   → `{ config, expectedVersion }` → `SaveResult`
+  (`saved` | `conflict` (409) | `invalid` (422)); optimistic concurrency + validation
+- `POST   /code_workflow/reset/`  → reseed default
+- `GET    /code_home/`            → `HomeSnapshot { activeAgents, needsAttention, inProgress }`
+  (workstreams from `CodeWorkstream`; `activeAgents` computed live from `TaskRun`)
+- `POST   /code_home/refresh/`    → trigger an on-demand evaluation (202)
 
-1. The UI — ConfigList, list/board views, action firing.
-2. `WorkflowService`, `WorkflowBackend` interface, classifier — same
-   files, same shapes.
-3. `TaskCreationSaga` invocation when a user clicks a bound action.
-   Already cloud, no change.
-4. Local task grouping in `useHomeSnapshot` — eventually moves
-   server-side too, but it's not on the critical migration path.
+Responses use the exact camelCase wire shapes the Electron app validates.
 
 ---
 
-## 4. Server-side API sketch
+## 3. Electron app (`apps/code/`)
 
-Subject to backend design review; this is what the Electron side expects.
+Thin authenticated clients over the REST API — no local persistence, no `gh`
+polling, no client-side classification:
 
-```
-GET    /api/projects/:project_id/code_workflow/
-       → 200 WorkflowConfig
-       → 404 (no config yet — client seeds default)
+| Concern | File |
+|---|---|
+| Snapshot wire schema (Zod, source of truth for the renderer types) | `apps/code/src/shared/types/home-snapshot.ts` |
+| Workflow config wire schema | `apps/code/src/shared/types/workflow.ts` |
+| Snapshot client + poll loop | `apps/code/src/main/services/home/service.ts` (`HomeService`) |
+| Workflow config client | `apps/code/src/main/services/workflow/service.ts` (`WorkflowService`) |
+| tRPC routers | `apps/code/src/main/trpc/routers/{home,workflow}.ts` |
+| Renderer query hooks | `features/home/hooks/{useHomeSnapshot,useWorkflow}.ts` |
+| Subscription registrar (keeps the query caches fresh) | `features/home/subscriptions.ts` |
+| Board column projection (pure, renderer-only) | `features/home/utils/boardColumns.ts` |
 
-PUT    /api/projects/:project_id/code_workflow/
-       body: { config: WorkflowConfig, expected_version: number }
-       → 200 { status: "saved", config }
-       → 409 { status: "conflict", config }       (version drifted)
-       → 422 { status: "invalid", diagnostics }   (schema violation)
+Delivery for v1 is **REST + client poll**: `HomeService` polls
+`GET /code_home/` and emits `home.onSnapshotUpdated`; `WorkflowService` calls the
+config endpoints and emits `workflow.onChanged`. Both subscriptions write back
+into the TanStack Query cache. A realtime push channel (SSE) is a future
+enhancement — the tRPC subscription contract wouldn't change.
 
-DELETE /api/projects/:project_id/code_workflow/
-       → 200 WorkflowConfig (the reseeded default)
-```
-
-The `WorkflowConfig` Zod schema in `@shared/types/workflow.ts` is the
-contract — the backend serialises it as-is. If we add fields, we add
-them once in the shared schema and both ends pick them up.
-
-For real-time updates, ride whichever channel `posthog/` already uses
-for live data (today: long-poll + the new task SSE channel). The tRPC
-subscription `workflow.onChanged` in this repo becomes a passthrough.
+`WorkflowService.get()` falls back to the built-in default
+(`workflow/default-workflow.ts`) when offline so the config canvas still renders.
 
 ---
 
-## 5. The PR polling worker (when we build it)
-
-**POC option** (BUILT — this is what ships today): A `PrSnapshotService`
-in Electron main, running locally, keyed by **task** (not PR URL) so a PR
-that only exists on a branch is still found. Per task it resolves the PR
-the way the rest of the app does — cloud-run URL → linked-branch lookup
-(`gh pr list --head`) → worktree `getPrStatus` — via
-`GitService.getTaskPrSnapshot` / `resolveTaskPrUrl`, then enriches with
-CI/review state via `getPrFull`. Owned by the same DI container behind a
-`PrSnapshotBackend` interface (`LocalPrSnapshotBackend` now,
-`CloudPrSnapshotBackend` stubbed for the swap). Exposed via tRPC:
-`prSnapshot.getSnapshots` (query over `{ taskId, cloudPrUrl }[]`, also
-registers them for polling), `prSnapshot.refresh` (mutation), and
-`prSnapshot.onUpdated` (subscription). The renderer caches pushes in
-`prSnapshotStore` (keyed by task id) and `useHomeSnapshot` feeds the
-matching snapshot into `buildSnapshotFromTasks` → `classify()`.
-
-Coverage: Home sources **all of the current user's tasks** via
-`useHomeTasks` (the full `useTasks` list, not the sidebar's
-workspace-scoped, paginated slice), so cloud tasks and tasks without a
-local checkout surface too.
-
-**Production**: A Celery beat task in `posthog/` paging through
-`CodeWorkflow` rows, batching the PRs each user is tracking, hitting
-the GitHub API with the user's stored PAT, writing snapshots into
-`CodePrSnapshot`, and emitting a realtime event when a snapshot
-changes. Clients subscribe; the Electron tRPC subscription becomes a
-passthrough.
-
-In both cases the shape we hand to `classify()` is identical:
-`{ state, ciStatus, reviewDecision, unresolvedThreads, mergeable, … }`.
-
----
-
-## 6. The actual swap (when PostHog is ready)
-
-For this Electron app:
-
-1. **Implement `CloudWorkflowBackend.load/save/delete`** in
-   `apps/code/src/main/services/workflow/backend.ts` — replacing the
-   `throw new Error("not implemented yet")` stubs. Use the existing
-   auth'd HTTP client. Validate the response with
-   `workflowConfig.safeParse` before returning; on shape mismatch,
-   return `null` so the service reseeds.
-2. **Flip the DI binding** in `apps/code/src/main/di/container.ts`
-   from `LocalWorkflowBackend` to `CloudWorkflowBackend`. One line.
-3. **Add a follow-up Drizzle migration** that drops the
-   `home_workflow_config` table.
-4. **Delete the POC-only files:** `home-workflow-repository.ts`, the
-   `homeWorkflowConfig` table in `schema.ts`, the `0007_*` migration
-   stays in place (historical) but the drop migration succeeds it.
-5. **Rewrite `workflow.onChanged`** in
-   `apps/code/src/main/trpc/routers/workflow.ts` to fan out the
-   server's realtime event instead of `WorkflowService.emit`. Same
-   tRPC contract — renderer doesn't change.
-
-For the PR polling worker, the local `PrSnapshotService` already exists.
-The swap mirrors the workflow backend:
-
-1. **Implement `CloudPrSnapshotBackend.fetch`** in
-   `apps/code/src/main/services/pr-snapshot/backend.ts` — call the
-   auth'd API, validate with `prSnapshot.safeParse`, return the rows.
-2. **Flip the DI binding** in `apps/code/src/main/di/container.ts` from
-   `LocalPrSnapshotBackend` to `CloudPrSnapshotBackend`. One line.
-3. **Delete the POC-only PR-fetch code:** `LocalPrSnapshotBackend` and
-   `GitService.getPrFull` + its gh→snapshot mappers.
-4. Optionally **rewrite `prSnapshot.onUpdated`** to fan out the server's
-   realtime event instead of the local poll loop's emit. Same tRPC
-   contract — renderer and `prSnapshotStore` don't change.
-
-For the classifier: nothing changes.
-
----
-
-## 7. Things we deliberately did NOT do in the POC
-
-- **No user identity.** Bindings are anonymous, one row per app
-  install. Cloud version is per-user.
-- **Local PR polling, with one gap.** PR/CI snapshots are now fetched
-  locally via the `gh` CLI (`PrSnapshotService`), so `ci_failing`,
-  `changes_requested`, `ready_to_merge`, `in_review`, and `done` all
-  fire on real data. Caveat: `unresolvedThreads` (which drives
-  `comments_waiting`) is only counted for the *current user's own open
-  PRs* — it needs an extra GraphQL call, so we don't pay it elsewhere.
-  The cloud worker will populate it for every PR.
-- **No `auto`-trigger actions.** We dropped the auto trigger
-  intentionally — we can't reliably watch for state transitions across
-  cloud and local task setups. Once the server-side polling worker
-  exists it could fire auto actions, but that's a deliberate future
-  decision.
-- **No cross-device sync.** Implicit, but worth naming: today, if you
-  edit the workflow on one machine and open the app on another, the
-  second machine has its own row.
-- **No action firing.** `useBoundActions` toasts "not wired yet" when a
-  user clicks a button. The seam to `TaskCreationSaga` is the next
-  slice — independent of the cloud migration.
+## 4. What is intentionally NOT here yet
 
-Each of these is a follow-up slice with its own clear seam — none of
-them require redesigning what the POC already built.
+- **`unresolvedThreads` for PRs the user doesn't author** — only the M3 reviewer
+  flow needs it; `is_current_user_requested_reviewer` defaults false.
+- **Realtime push (SSE)** — v1 is client poll; the worker keeps server data fresh.
+- **Snooze / mute / viewed** (`home_attention_state`) — M4, not migrated yet.
+- **`auto`-trigger actions** — deliberately omitted.
+- **Continue-as-new batching in the dispatcher** — current active-team counts
+  fan out in one pass (capped + logged); page with continue-as-new at larger scale.

From 56a1d577a9f6c2f2cc1f8014902d41cac43183cc Mon Sep 17 00:00:00 2001
From: Peter Kirkham <peter@posthog.com>
Date: Wed, 3 Jun 2026 16:14:33 +0100
Subject: [PATCH 6/6] fix: remove old references

---
 .../migrations/0007_remarkable_lord_tyger.sql |   6 -
 .../0008_drop_home_workflow_config.sql        |   1 -
 .../db/migrations/meta/0007_snapshot.json     | 629 ------------------
 .../src/main/db/migrations/meta/_journal.json |  14 -
 .../src/main/services/git/service.test.ts     |  86 +--
 apps/code/src/main/services/git/service.ts    | 190 +-----
 apps/code/src/shared/types/pr-snapshot.ts     |  44 +-
 docs/home-tab.md                              | 145 ++--
 docs/workflow-architecture.md                 |   7 +-
 9 files changed, 66 insertions(+), 1056 deletions(-)
 delete mode 100644 apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql
 delete mode 100644 apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql
 delete mode 100644 apps/code/src/main/db/migrations/meta/0007_snapshot.json

diff --git a/apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql b/apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql
deleted file mode 100644
index f81209e20a..0000000000
--- a/apps/code/src/main/db/migrations/0007_remarkable_lord_tyger.sql
+++ /dev/null
@@ -1,6 +0,0 @@
-CREATE TABLE `home_workflow_config` (
-	`id` text PRIMARY KEY NOT NULL,
-	`version` integer NOT NULL,
-	`json` text NOT NULL,
-	`updated_at` text DEFAULT (CURRENT_TIMESTAMP) NOT NULL
-);
diff --git a/apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql b/apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql
deleted file mode 100644
index c8d06f35ba..0000000000
--- a/apps/code/src/main/db/migrations/0008_drop_home_workflow_config.sql
+++ /dev/null
@@ -1 +0,0 @@
-DROP TABLE IF EXISTS `home_workflow_config`;
diff --git a/apps/code/src/main/db/migrations/meta/0007_snapshot.json b/apps/code/src/main/db/migrations/meta/0007_snapshot.json
deleted file mode 100644
index f0215de664..0000000000
--- a/apps/code/src/main/db/migrations/meta/0007_snapshot.json
+++ /dev/null
@@ -1,629 +0,0 @@
-{
-  "version": "6",
-  "dialect": "sqlite",
-  "id": "ebf61ecd-8a8d-4e18-9a0d-46f6634b381e",
-  "prevId": "805d2ed3-331d-4ba6-8379-30f926268064",
-  "tables": {
-    "archives": {
-      "name": "archives",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "text",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "workspace_id": {
-          "name": "workspace_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "branch_name": {
-          "name": "branch_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "checkpoint_id": {
-          "name": "checkpoint_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "archived_at": {
-          "name": "archived_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {
-        "archives_workspaceId_unique": {
-          "name": "archives_workspaceId_unique",
-          "columns": [
-            "workspace_id"
-          ],
-          "isUnique": true
-        }
-      },
-      "foreignKeys": {
-        "archives_workspace_id_workspaces_id_fk": {
-          "name": "archives_workspace_id_workspaces_id_fk",
-          "tableFrom": "archives",
-          "tableTo": "workspaces",
-          "columnsFrom": [
-            "workspace_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "auth_preferences": {
-      "name": "auth_preferences",
-      "columns": {
-        "account_key": {
-          "name": "account_key",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "cloud_region": {
-          "name": "cloud_region",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "last_selected_project_id": {
-          "name": "last_selected_project_id",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {
-        "auth_preferences_account_region_idx": {
-          "name": "auth_preferences_account_region_idx",
-          "columns": [
-            "account_key",
-            "cloud_region"
-          ],
-          "isUnique": false
-        }
-      },
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "auth_sessions": {
-      "name": "auth_sessions",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "integer",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "refresh_token_encrypted": {
-          "name": "refresh_token_encrypted",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "cloud_region": {
-          "name": "cloud_region",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "selected_project_id": {
-          "name": "selected_project_id",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "scope_version": {
-          "name": "scope_version",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {},
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "default_additional_directories": {
-      "name": "default_additional_directories",
-      "columns": {
-        "path": {
-          "name": "path",
-          "type": "text",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {},
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "home_workflow_config": {
-      "name": "home_workflow_config",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "text",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "version": {
-          "name": "version",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "json": {
-          "name": "json",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {},
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "repositories": {
-      "name": "repositories",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "text",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "path": {
-          "name": "path",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "remote_url": {
-          "name": "remote_url",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "last_accessed_at": {
-          "name": "last_accessed_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {
-        "repositories_path_unique": {
-          "name": "repositories_path_unique",
-          "columns": [
-            "path"
-          ],
-          "isUnique": true
-        }
-      },
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "suspensions": {
-      "name": "suspensions",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "text",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "workspace_id": {
-          "name": "workspace_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "branch_name": {
-          "name": "branch_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "checkpoint_id": {
-          "name": "checkpoint_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "suspended_at": {
-          "name": "suspended_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "reason": {
-          "name": "reason",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {
-        "suspensions_workspaceId_unique": {
-          "name": "suspensions_workspaceId_unique",
-          "columns": [
-            "workspace_id"
-          ],
-          "isUnique": true
-        }
-      },
-      "foreignKeys": {
-        "suspensions_workspace_id_workspaces_id_fk": {
-          "name": "suspensions_workspace_id_workspaces_id_fk",
-          "tableFrom": "suspensions",
-          "tableTo": "workspaces",
-          "columnsFrom": [
-            "workspace_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "workspaces": {
-      "name": "workspaces",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "text",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "task_id": {
-          "name": "task_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "repository_id": {
-          "name": "repository_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "mode": {
-          "name": "mode",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "linked_branch": {
-          "name": "linked_branch",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "pinned_at": {
-          "name": "pinned_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "last_viewed_at": {
-          "name": "last_viewed_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "last_activity_at": {
-          "name": "last_activity_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false,
-          "autoincrement": false
-        },
-        "additional_directories": {
-          "name": "additional_directories",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "'[]'"
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {
-        "workspaces_taskId_unique": {
-          "name": "workspaces_taskId_unique",
-          "columns": [
-            "task_id"
-          ],
-          "isUnique": true
-        },
-        "workspaces_repository_id_idx": {
-          "name": "workspaces_repository_id_idx",
-          "columns": [
-            "repository_id"
-          ],
-          "isUnique": false
-        }
-      },
-      "foreignKeys": {
-        "workspaces_repository_id_repositories_id_fk": {
-          "name": "workspaces_repository_id_repositories_id_fk",
-          "tableFrom": "workspaces",
-          "tableTo": "repositories",
-          "columnsFrom": [
-            "repository_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "set null",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    },
-    "worktrees": {
-      "name": "worktrees",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "text",
-          "primaryKey": true,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "workspace_id": {
-          "name": "workspace_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "name": {
-          "name": "name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "path": {
-          "name": "path",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "autoincrement": false,
-          "default": "(CURRENT_TIMESTAMP)"
-        }
-      },
-      "indexes": {
-        "worktrees_workspaceId_unique": {
-          "name": "worktrees_workspaceId_unique",
-          "columns": [
-            "workspace_id"
-          ],
-          "isUnique": true
-        }
-      },
-      "foreignKeys": {
-        "worktrees_workspace_id_workspaces_id_fk": {
-          "name": "worktrees_workspace_id_workspaces_id_fk",
-          "tableFrom": "worktrees",
-          "tableTo": "workspaces",
-          "columnsFrom": [
-            "workspace_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "checkConstraints": {}
-    }
-  },
-  "views": {},
-  "enums": {},
-  "_meta": {
-    "schemas": {},
-    "tables": {},
-    "columns": {}
-  },
-  "internal": {
-    "indexes": {}
-  }
-}
\ No newline at end of file
diff --git a/apps/code/src/main/db/migrations/meta/_journal.json b/apps/code/src/main/db/migrations/meta/_journal.json
index f37f6e71f3..9f591534c7 100644
--- a/apps/code/src/main/db/migrations/meta/_journal.json
+++ b/apps/code/src/main/db/migrations/meta/_journal.json
@@ -50,20 +50,6 @@
       "when": 1777639303535,
       "tag": "0006_youthful_warstar",
       "breakpoints": true
-    },
-    {
-      "idx": 7,
-      "version": "6",
-      "when": 1779956709103,
-      "tag": "0007_remarkable_lord_tyger",
-      "breakpoints": true
-    },
-    {
-      "idx": 8,
-      "version": "6",
-      "when": 1780000000000,
-      "tag": "0008_drop_home_workflow_config",
-      "breakpoints": true
     }
   ]
 }
\ No newline at end of file
diff --git a/apps/code/src/main/services/git/service.test.ts b/apps/code/src/main/services/git/service.test.ts
index 5ed070233c..afe6a4ff4f 100644
--- a/apps/code/src/main/services/git/service.test.ts
+++ b/apps/code/src/main/services/git/service.test.ts
@@ -26,14 +26,7 @@ vi.mock("../../utils/logger.js", () => ({
 import type { AgentService } from "../agent/service";
 import type { LlmGatewayService } from "../llm-gateway/service";
 import type { WorkspaceService } from "../workspace/service";
-import {
-  GitService,
-  mapCiStatus,
-  mapPrMergeable,
-  mapPrReviewDecision,
-  mapPrSnapshotState,
-  mapPrState,
-} from "./service";
+import { GitService, mapPrState } from "./service";
 
 describe("GitService.getPrChangedFiles", () => {
   let service: GitService;
@@ -327,83 +320,6 @@ describe("mapPrState", () => {
   });
 });
 
-describe("mapPrSnapshotState", () => {
-  it("maps merged/closed regardless of draft", () => {
-    expect(mapPrSnapshotState("MERGED", false)).toBe("merged");
-    expect(mapPrSnapshotState("CLOSED", true)).toBe("closed");
-  });
-
-  it("maps open PRs, honouring draft", () => {
-    expect(mapPrSnapshotState("OPEN", false)).toBe("open");
-    expect(mapPrSnapshotState("OPEN", true)).toBe("draft");
-    expect(mapPrSnapshotState(undefined, false)).toBe("open");
-  });
-});
-
-describe("mapPrReviewDecision", () => {
-  it("lowercases known decisions", () => {
-    expect(mapPrReviewDecision("APPROVED")).toBe("approved");
-    expect(mapPrReviewDecision("CHANGES_REQUESTED")).toBe("changes_requested");
-    expect(mapPrReviewDecision("REVIEW_REQUIRED")).toBe("review_required");
-  });
-
-  it("returns null for empty/unknown (no review required)", () => {
-    expect(mapPrReviewDecision("")).toBeNull();
-    expect(mapPrReviewDecision(null)).toBeNull();
-    expect(mapPrReviewDecision(undefined)).toBeNull();
-  });
-});
-
-describe("mapPrMergeable", () => {
-  it("maps to a tri-state boolean", () => {
-    expect(mapPrMergeable("MERGEABLE")).toBe(true);
-    expect(mapPrMergeable("CONFLICTING")).toBe(false);
-    expect(mapPrMergeable("UNKNOWN")).toBeNull();
-    expect(mapPrMergeable(undefined)).toBeNull();
-  });
-});
-
-describe("mapCiStatus", () => {
-  it("returns none when there are no checks", () => {
-    expect(mapCiStatus(undefined)).toBe("none");
-    expect(mapCiStatus([])).toBe("none");
-  });
-
-  it("returns passing when every check succeeded", () => {
-    expect(
-      mapCiStatus([
-        { __typename: "CheckRun", status: "COMPLETED", conclusion: "SUCCESS" },
-        { __typename: "CheckRun", status: "COMPLETED", conclusion: "SKIPPED" },
-        { __typename: "StatusContext", state: "SUCCESS" },
-      ]),
-    ).toBe("passing");
-  });
-
-  it("returns failing when any check failed, even alongside pending ones", () => {
-    expect(
-      mapCiStatus([
-        { __typename: "CheckRun", status: "IN_PROGRESS", conclusion: null },
-        { __typename: "CheckRun", status: "COMPLETED", conclusion: "FAILURE" },
-      ]),
-    ).toBe("failing");
-    expect(mapCiStatus([{ __typename: "StatusContext", state: "ERROR" }])).toBe(
-      "failing",
-    );
-  });
-
-  it("returns pending when checks are still running and none failed", () => {
-    expect(
-      mapCiStatus([
-        { __typename: "CheckRun", status: "COMPLETED", conclusion: "SUCCESS" },
-        { __typename: "CheckRun", status: "QUEUED", conclusion: null },
-      ]),
-    ).toBe("pending");
-    expect(
-      mapCiStatus([{ __typename: "StatusContext", state: "PENDING" }]),
-    ).toBe("pending");
-  });
-});
-
 describe("GitService.getPrReviewComments", () => {
   let service: GitService;
 
diff --git a/apps/code/src/main/services/git/service.ts b/apps/code/src/main/services/git/service.ts
index 60a6547e9f..99ee93a957 100644
--- a/apps/code/src/main/services/git/service.ts
+++ b/apps/code/src/main/services/git/service.ts
@@ -5,7 +5,7 @@ import { promisify } from "node:util";
 
 const execFileAsync = promisify(execFile);
 
-import { execGh, execGhWithRetry } from "@posthog/git/gh";
+import { execGh } from "@posthog/git/gh";
 import {
   getAllBranches,
   getBranchDiffPatchesByPath,
@@ -37,7 +37,6 @@ import { DiscardFileChangesSaga } from "@posthog/git/sagas/discard";
 import { PullSaga } from "@posthog/git/sagas/pull";
 import { PushSaga } from "@posthog/git/sagas/push";
 import { parseGithubUrl } from "@posthog/git/utils";
-import type { PrSnapshot } from "@shared/types/pr-snapshot";
 import { inject, injectable } from "inversify";
 import { MAIN_TOKENS } from "../../di/tokens";
 import { logger } from "../../utils/logger";
@@ -114,95 +113,6 @@ export function mapPrState(
   return null;
 }
 
-// gh's PR `state` is OPEN | CLOSED | MERGED; draftness is a separate flag.
-// Collapse both into the PrSnapshot lifecycle the classifier understands.
-export function mapPrSnapshotState(
-  state: string | null | undefined,
-  isDraft: boolean | undefined,
-): PrSnapshot["state"] {
-  switch (state?.toUpperCase()) {
-    case "MERGED":
-      return "merged";
-    case "CLOSED":
-      return "closed";
-    default:
-      return isDraft ? "draft" : "open";
-  }
-}
-
-export function mapPrReviewDecision(
-  decision: string | null | undefined,
-): PrSnapshot["reviewDecision"] {
-  switch (decision?.toUpperCase()) {
-    case "APPROVED":
-      return "approved";
-    case "CHANGES_REQUESTED":
-      return "changes_requested";
-    case "REVIEW_REQUIRED":
-      return "review_required";
-    default:
-      return null;
-  }
-}
-
-export function mapPrMergeable(
-  mergeable: string | null | undefined,
-): boolean | null {
-  switch (mergeable?.toUpperCase()) {
-    case "MERGEABLE":
-      return true;
-    case "CONFLICTING":
-      return false;
-    default:
-      return null;
-  }
-}
-
-type GhCheckRollupEntry = {
-  __typename?: string;
-  // CheckRun
-  status?: string | null;
-  conclusion?: string | null;
-  // StatusContext
-  state?: string | null;
-};
-
-const FAILING_CHECK_CONCLUSIONS = new Set([
-  "FAILURE",
-  "TIMED_OUT",
-  "CANCELLED",
-  "ACTION_REQUIRED",
-  "STARTUP_FAILURE",
-]);
-
-// Aggregate gh's per-check `statusCheckRollup` into a single CI verdict.
-// Precedence is failing > pending > passing: one red check makes the PR red
-// even if others are still running.
-export function mapCiStatus(
-  rollup: GhCheckRollupEntry[] | null | undefined,
-): PrSnapshot["ciStatus"] {
-  if (!rollup || rollup.length === 0) return "none";
-  let pending = false;
-  for (const entry of rollup) {
-    if (entry.__typename === "StatusContext") {
-      const state = entry.state?.toUpperCase();
-      if (state === "FAILURE" || state === "ERROR") return "failing";
-      if (state === "PENDING" || state === "EXPECTED") pending = true;
-      continue;
-    }
-    // CheckRun (the common case for GitHub Actions).
-    const status = entry.status?.toUpperCase();
-    if (status !== "COMPLETED") {
-      pending = true;
-      continue;
-    }
-    const conclusion = entry.conclusion?.toUpperCase() ?? null;
-    if (conclusion && FAILING_CHECK_CONCLUSIONS.has(conclusion))
-      return "failing";
-  }
-  return pending ? "pending" : "passing";
-}
-
 /**
  * Wraps a GitHub API per-file patch (hunk content only) with
  * the `diff --git` / `---` / `+++` header so that unified-diff
@@ -223,9 +133,6 @@ function toUnifiedDiffPatch(
 @injectable()
 export class GitService extends TypedEventEmitter<GitServiceEvents> {
   private lastFetchTime = new Map<string, number>();
-  // Resolved once: the gh-authenticated user, used to decide whether a PR is
-  // "mine". `undefined` = not looked up yet, `null` = lookup failed/unknown.
-  private viewerLogin: string | null | undefined;
 
   constructor(
     @inject(MAIN_TOKENS.LlmGatewayService)
@@ -1274,101 +1181,6 @@ export class GitService extends TypedEventEmitter<GitServiceEvents> {
     }
   }
 
-  private async getViewerLogin(): Promise<string | null> {
-    if (this.viewerLogin !== undefined) return this.viewerLogin;
-    const result = await execGh(["api", "user", "--jq", ".login"]);
-    this.viewerLogin =
-      result.exitCode === 0 ? result.stdout.trim() || null : null;
-    return this.viewerLogin;
-  }
-
-  /**
-   * Rich PR snapshot for the home tab: lifecycle state, CI verdict, review
-   * decision, mergeability, and (for the user's own open PRs) the unresolved
-   * review-thread count. Local gh implementation of the PR-polling concern; the
-   * production PostHog worker produces the same shape (docs/workflow-architecture.md §5).
-   */
-  public async getPrFull(prUrl: string): Promise<PrSnapshot | null> {
-    const ref = parseGithubUrl(prUrl);
-    if (ref?.kind !== "pr") return null;
-
-    const result = await execGhWithRetry(
-      [
-        "pr",
-        "view",
-        prUrl,
-        "--json",
-        "number,title,state,isDraft,mergeable,reviewDecision,statusCheckRollup,author,reviewRequests,updatedAt,url",
-      ],
-      { timeoutMs: 15_000 },
-    );
-
-    if (result.exitCode !== 0) {
-      log.warn("Failed to fetch PR snapshot", {
-        prUrl,
-        error: result.stderr || result.error,
-      });
-      return null;
-    }
-
-    let data: {
-      number?: number;
-      title?: string;
-      state?: string;
-      isDraft?: boolean;
-      mergeable?: string;
-      reviewDecision?: string;
-      statusCheckRollup?: GhCheckRollupEntry[];
-      author?: { login?: string } | null;
-      reviewRequests?: Array<{ login?: string }>;
-      updatedAt?: string;
-      url?: string;
-    };
-    try {
-      data = JSON.parse(result.stdout);
-    } catch (error) {
-      log.warn("PR snapshot JSON is not parseable", { prUrl, error });
-      return null;
-    }
-
-    const viewer = await this.getViewerLogin();
-    const authorLogin = data.author?.login ?? null;
-    const isCurrentUserAuthor = !!viewer && authorLogin === viewer;
-    const isCurrentUserRequestedReviewer =
-      !!viewer && (data.reviewRequests ?? []).some((r) => r.login === viewer);
-    const state = mapPrSnapshotState(data.state, data.isDraft);
-
-    // Unresolved threads only drive the `comments_waiting` situation, which is
-    // scoped to the author's own live PRs — so only pay for the extra GraphQL
-    // call there, and never block the snapshot if it fails.
-    let unresolvedThreads = 0;
-    if (isCurrentUserAuthor && (state === "open" || state === "draft")) {
-      try {
-        const threads = await this.getPrReviewComments(prUrl);
-        unresolvedThreads = threads.filter((t) => !t.isResolved).length;
-      } catch (error) {
-        log.warn("Failed to count unresolved review threads", { prUrl, error });
-      }
-    }
-
-    return {
-      url: data.url ?? prUrl,
-      number: data.number ?? ref.number,
-      title: data.title ?? "",
-      state,
-      ciStatus: mapCiStatus(data.statusCheckRollup),
-      reviewDecision: mapPrReviewDecision(data.reviewDecision),
-      unresolvedThreads,
-      mergeable: mapPrMergeable(data.mergeable),
-      isCurrentUserRequestedReviewer,
-      isCurrentUserAuthor,
-      author: authorLogin,
-      lastUpdatedAt: data.updatedAt
-        ? new Date(data.updatedAt).getTime()
-        : Date.now(),
-    };
-  }
-
   public async updatePrByUrl(
     prUrl: string,
     action: PrActionType,
diff --git a/apps/code/src/shared/types/pr-snapshot.ts b/apps/code/src/shared/types/pr-snapshot.ts
index b63fe8a291..a93c33fc62 100644
--- a/apps/code/src/shared/types/pr-snapshot.ts
+++ b/apps/code/src/shared/types/pr-snapshot.ts
@@ -1,8 +1,8 @@
 import { z } from "zod";
 
-// Canonical PR snapshot the home tab classifies against, and the wire contract:
-// produced locally by the gh-backed PrSnapshotService today; the production
-// PostHog backend serialises the same shape (docs/workflow-architecture.md §5).
+// Canonical PR snapshot the home tab classifies against. Produced server-side
+// by PostHog and embedded in each workstream of the home snapshot
+// (docs/workflow-architecture.md §5).
 
 export const prSnapshotState = z.enum(["open", "draft", "merged", "closed"]);
 export type PrSnapshotState = z.infer<typeof prSnapshotState>;
@@ -36,41 +36,3 @@ export const prSnapshot = z
   })
   .strict();
 export type PrSnapshot = z.infer<typeof prSnapshot>;
-
-// Keyed by task, not PR URL: a task's PR may live on its branch, not just in
-// cloud-run output. Two tasks can point at the same PR — home groups them by url.
-
-/** What the client knows about a task before resolution: its id + any cloud PR URL. */
-export const taskPrRef = z
-  .object({ taskId: z.string(), cloudPrUrl: z.string().nullable() })
-  .strict();
-export type TaskPrRef = z.infer<typeof taskPrRef>;
-
-/** A resolved snapshot tagged with the task it was resolved for. */
-export const taskPrSnapshot = z
-  .object({ taskId: z.string(), snapshot: prSnapshot })
-  .strict();
-export type TaskPrSnapshot = z.infer<typeof taskPrSnapshot>;
-
-export const taskPrSnapshotArray = z.array(taskPrSnapshot);
-
-// tRPC io ---------------------------------------------------------------------
-
-export const getPrSnapshotsInput = z
-  .object({ tasks: z.array(taskPrRef) })
-  .strict();
-
-export const refreshPrSnapshotsInput = z
-  .object({ tasks: z.array(taskPrRef).optional() })
-  .strict();
-
-// Events ----------------------------------------------------------------------
-
-export const PrSnapshotEvent = {
-  // Emitted with only the task snapshots that materially changed since last refresh.
-  Updated: "updated",
-} as const;
-
-export interface PrSnapshotEvents {
-  [PrSnapshotEvent.Updated]: TaskPrSnapshot[];
-}
diff --git a/docs/home-tab.md b/docs/home-tab.md
index b8cf6081fb..82b8ea88e5 100644
--- a/docs/home-tab.md
+++ b/docs/home-tab.md
@@ -298,8 +298,7 @@ The board renders one column per step/queue node in the order above; the list re
 
 Per R1 / R2 / R3: even though the canvas is the most visually expensive surface in the app, no business logic lives in the renderer.
 
-- **`WorkflowService` (main).** Owns the canonical `WorkflowConfig`, validation, version bumps, the built-in default, and the `match`-predicate evaluator used by `HomeService` for classification. Pure functions; no `electron` imports. Emits `WorkflowChanged` events that `HomeService` subscribes to so a config edit immediately reclassifies every workstream and pushes a new snapshot.
-- **`WorkflowRepository` (main).** SQLite table `home_workflow_config(id, version, json, updated_at)`. Single-row per user for v1. Migration ships the default workflow as version 1.
+- **`WorkflowService` (main).** Thin authenticated client over `/code_workflow/*`: reads/writes the canonical `WorkflowConfig`, emits `workflow.onChanged`, and falls back to the built-in default (`workflow/default-workflow.ts`) when offline. Persistence, version bumps, validation, the default seed, and classification all live server-side in PostHog.
 - **tRPC `workflow.*` router (main).** One-liners only: `workflow.get` (query, returns `WorkflowConfig`), `workflow.save` (mutation, `{ config, expectedVersion }` → new version or `ConflictError`), `workflow.resetToDefault` (mutation), `workflow.onChanged` (subscription, `WorkflowConfig` diff stream).
 - **`useWorkflow` (renderer hook).** Single `useQuery` against `workflow.get`, kept fresh by the subscription registrar in `features/home/subscriptions.ts` per R9. No multi-query orchestration in the hook.
 - **`workflowEditorStore` (renderer Zustand, R2-clean).** Holds *only* uncommitted edit state: `viewport: { x, y, zoom }`, `selectedNodeId`, `selectedEdgeId`, `draftConfig` (deep-clone of the persisted config the moment editing starts), `dirty`, `validationErrors` (fed from main on each draft change via `workflow.validateDraft`). The persisted `WorkflowConfig` is *not* in this store — it's the `useQuery` result. Save action is one `useMutation` call; the store's job ends there.
@@ -318,95 +317,67 @@ The user's choice persists across sessions via `homeUiStore.viewMode: "list" | "
 
 ## 7. Data sources
 
-| Source | Data | Mechanism |
-|---|---|---|
-| Tasks (PostHog API) | `Task` + `TaskRun` status, branch, `output.pr_url` | existing `useTasks` poll piped into main; live runs via `CloudTaskService` SSE |
-| Workspaces (SQLite) | `linkedBranch`, `branchName`, `lastActivityAt`, `lastViewedAt`, `pinnedAt` | `WorkspaceService` events (`BranchChanged`, `LinkedBranchChanged`) |
-| Git state | branch, ahead/behind, default-branch diff | `GitService` + `FileWatcherService` `GitStateChanged` |
-| GitHub PR metadata | title, state, draft, mergeable, CI, reviewers, threads, comments | new `gh` helpers (see §9) |
-| GitHub review requests | PRs where current user is requested as reviewer | `gh pr list --search "review-requested:@me"` |
-| Snooze / mute / viewed | per-attention-item persistence | new `home_attention_state` SQLite table |
-
-## 8. Architecture
-
-> **Shipped architecture note.** Workstream grouping, PR polling, and situation
-> classification run **server-side in PostHog** (`products/tasks/`, a Temporal
-> worker), not in Electron main. The desktop app is a thin authenticated client:
-> `HomeService` / `WorkflowService` call the PostHog REST API and the renderer
-> reads `home.getSnapshot` / `workflow.get`. See
-> [docs/workflow-architecture.md](./workflow-architecture.md). The original
-> Electron-main design below is kept for historical context.
-
-**Main (`apps/code/src/main/services/home/`)**
+The snapshot is assembled **server-side in PostHog** (`products/tasks/`, see
+[docs/workflow-architecture.md](./workflow-architecture.md)) — the Electron app
+reads the finished snapshot over the REST API and renders it; it does not
+aggregate these sources itself.
 
-- `HomeService` — aggregation, classification, ranking, action dispatch. Reads the active workflow from `WorkflowService` and uses it to assign each workstream a `nodeId`.
-- `HomeRepository` — SQLite persistence for snooze/mute and last-viewed timestamps.
-- `schemas.ts` — Zod for snapshot, attention items, and action requests.
-- Dependencies (constructor injected): `WorkspaceService`, `GitService`, `CloudTaskService`, `AgentService`, `PostHogApiClient`, `HomeRepository`, `WorkflowService`, platform `urlOpener`.
-
-**Main (`apps/code/src/main/services/workflow/`)**
+| Source | Data |
+|---|---|
+| Tasks / task runs | status, branch, PR URL; the live active-agent set |
+| GitHub PR metadata | title, state, draft, mergeable, CI rollup, review decision, unresolved threads, requested reviewers |
+| GitHub review requests | PRs where the current user is a requested reviewer |
 
-- `WorkflowService` — owns the canonical `WorkflowConfig`, validates drafts, evaluates `match` predicates, emits `WorkflowChanged`. Host-agnostic (no `electron` imports).
-- `WorkflowRepository` — SQLite `home_workflow_config(id, version, json, updated_at)`. Single-row per user for v1. Default workflow installed by the migration as version 1.
-- `schemas.ts` — Zod for `WorkflowConfig`, `WorkflowNode`, `WorkflowEdge`, `WorkflowMatch`, `AgentBinding`, validation diagnostics.
-- Dependencies (constructor injected): `WorkflowRepository`, skill registry (read-only).
+Snooze / mute / viewed (`home_attention_state`) is not implemented yet — see
+[docs/workflow-architecture.md](./workflow-architecture.md) §4.
 
-**tRPC routers — one-liners with Zod input/output:**
+## 8. Architecture
 
-`apps/code/src/main/trpc/routers/home.ts`:
+The data layer — workstream grouping, PR polling, and situation classification —
+runs **server-side in PostHog** (`products/tasks/`, a Temporal worker). The
+Electron app is a thin authenticated client. Full server design and wire shapes:
+[docs/workflow-architecture.md](./workflow-architecture.md).
 
-- `home.getSnapshot(input)` — query.
-- `home.refresh()` — mutation; forces a fresh PR poll.
-- `home.snooze({ attentionId, untilHours? })` — mutation.
-- `home.mute({ attentionId })` — mutation.
-- `home.markViewed({ workstreamId })` — mutation.
-- `home.startAction({ workstreamId, actionId })` — mutation; returns navigation target or new task id.
-- `home.onSnapshotUpdated` — subscription; diff stream.
+**Main (`apps/code/src/main/`)** — thin clients over the REST API, no local
+persistence and no `gh` polling:
 
-`apps/code/src/main/trpc/routers/workflow.ts`:
+- `services/home/service.ts` (`HomeService`) — polls `GET /code_home/` and emits `home.onSnapshotUpdated` when the snapshot changes.
+- `services/workflow/service.ts` (`WorkflowService`) — reads/writes the workflow config via `/code_workflow/*`, emits `workflow.onChanged`, and falls back to the built-in default (`workflow/default-workflow.ts`) when offline.
+- `services/auth/service.ts` (`authenticatedProjectFetch`) — the project-scoped authenticated fetch both services share.
+- tRPC routers (`trpc/routers/home.ts`, `trpc/routers/workflow.ts`) — one-liners over the two services: `home.getSnapshot` / `home.refresh` / `home.onSnapshotUpdated`, and `workflow.get` / `workflow.save` / `workflow.resetToDefault` / `workflow.onChanged`.
 
-- `workflow.get()` — query; returns active `WorkflowConfig`.
-- `workflow.save({ config, expectedVersion })` — mutation; rejects with `ConflictError` if version drifted.
-- `workflow.validateDraft({ config })` — query; returns diagnostics without persisting (canvas re-runs on edit).
-- `workflow.resetToDefault()` — mutation.
-- `workflow.onChanged` — subscription.
+Wire shapes (Zod, the shared source of truth for the renderer types):
+`shared/types/home-snapshot.ts`, `shared/types/workflow.ts`,
+`shared/types/pr-snapshot.ts`.
 
 **Renderer (`apps/code/src/renderer/features/home/`)**
 
-- `components/HomeView.tsx` — top-level layout, header, view toggle.
-- `components/HomeActiveAgentsStrip.tsx` — shared strip across all three views.
-- `components/HomeWorkstreamRow.tsx` — list view row.
-- `components/HomeWorkstreamCard.tsx` — board view card (denser than row).
-- `components/HomeBoardView.tsx` — kanban column layout, columns derived from workflow.
-- `components/HomeDetailPane.tsx`, `HomeEmptyStates.tsx`.
-- `config/ConfigCanvas.tsx`, `config/NodePalette.tsx`, `config/NodeInspector.tsx`, `config/EdgeInspector.tsx`, `config/ValidationBanner.tsx` — Config view.
-- `utils/boardColumns.ts` — pure projection `(workflow, snapshot) → BoardColumn[]`. No I/O, no React, no predicate evaluation (that's main).
-- `hooks/useHomeSnapshot.ts` — single `useQuery` against `home.getSnapshot`, kept in sync via subscription.
-- `hooks/useWorkflow.ts` — single `useQuery` against `workflow.get`, kept in sync via subscription.
-- `stores/homeUiStore.ts` — Zustand, UI only: `viewMode: "list" | "board" | "config"`, `selectedWorkstreamId`, `expanded.{ inProgress, watching }`, `keyboardCursor`.
-- `stores/workflowEditorStore.ts` — Zustand, UI only: `draftConfig`, `dirty`, `selectedNodeId`, `selectedEdgeId`, `viewport`, `validationErrors`. No persisted state, no tRPC orchestration beyond a single mutation call.
-- `services/workflowCanvasService.ts` — `@injectable()` renderer service: drag-and-drop, snap, hit-testing, edge routing. R3 escape hatch. No data, no tRPC, no cross-store reach-ins.
-- `subscriptions.ts` — start `home.onSnapshotUpdated` *and* `workflow.onChanged` at boot per R9.
-
-**Column projection belongs to the renderer; predicate evaluation does not.** The `match` evaluator is a main-side concern (it reads workstream internals like `attentions`, PR metadata, staleness windows). The renderer only joins `snapshot.workstreams[].nodeId` to the workflow's ordered node list to render columns. This keeps `WorkflowMatch` private to main and means the renderer never reasons about "is this PR stale?".
+- `components/` — `HomeView`, `HomeActiveAgentsStrip`, `HomeWorkstreamRow`, `HomeWorkstreamCard`, `HomeBoardView`, `HomeWorkstreamDetailPanel`, `HomeEmptyState`.
+- `config/` — the workflow editor (`ConfigMap` and friends).
+- `utils/boardColumns.ts` — pure projection of the snapshot into board columns. No I/O, no React.
+- `hooks/useHomeSnapshot.ts`, `hooks/useWorkflow.ts` — one `useQuery` each, kept fresh by `subscriptions.ts` (registered once at boot per R9).
+- `stores/homeUiStore.ts` — UI state only (view mode, selection). `stores/workflowEditorStore.ts` — the uncommitted editor draft only.
 
-**Rules honoured:** R1 (main owns workflow + classification), R2 (editor store is uncommitted UI state only), R3 (canvas service is the documented escape hatch, no data), R4 (one `useQuery` per surface), R5 (main emits `WorkflowChanged`, both Home and Workflow renderer stores react via subscriptions), R6 (Zod everywhere, inferred types), R7 (SQLite via `WorkflowRepository`), R8 (constructor injection), R9 (subscriptions registered once), R10 (router one-liners).
+Situation classification is authoritative on the server. The renderer reuses the
+same pure logic (`shared/types/workflow-classify.ts`) only to project the
+snapshot's `situations` into board columns — it never re-derives situations from
+PR state.
 
-## 9. New `gh` helpers
+**Rules honoured:** R1 (main owns the client + orchestration), R2 (stores are UI state + subscription caches only), R4 (one `useQuery` per surface), R5 (main emits `workflow.onChanged`; Home reacts via its subscription registrar), R6 (Zod everywhere, inferred types), R9 (subscriptions registered once at boot), R10 (router one-liners).
 
-Land in `packages/git/src/gh.ts`, expose via `GitService`:
+## 9. PR data
 
-- `listReviewRequestedPrs(owner?)` — `gh pr list --search "review-requested:@me state:open"`.
-- `getPrFull(prUrl)` — `gh pr view <url> --json number,title,state,isDraft,mergeable,mergeStateStatus,statusCheckRollup,reviewDecision,reviewRequests,reviews,reviewThreads,latestReviews,comments,updatedAt,headRefName,baseRefName,url`.
-- `getPrFullBatch(prUrls)` — concurrency cap 3.
+PR metadata (state, draft, mergeable, CI rollup, review decision, unresolved
+threads, requested reviewers) is fetched **server-side** by the PostHog worker
+via `GitHubIntegration.get_pull_request_snapshot` — the Electron app does not
+poll `gh` for the home tab. The serialised shape is `PrSnapshot`
+(`shared/types/pr-snapshot.ts`).
 
 ## 10. Polling & rate-limit strategy
 
-- Cadence: PR refresh **3 min** focused, **15 min** blurred, **paused** hidden. Add 0–20% jitter.
-- Scope: only PRs touched (either side) in last 30 days, plus pinned, plus review-requested-on-me. Cap at 50 PRs per cycle.
-- On-demand: when a workstream row enters the viewport, fetch its PR within 250ms if cache is >60s old.
-- `gh` errors / rate-limit responses → exponential backoff per host; surface a warning chip in the header.
-- Cloud task SSE already streams in real time — `activeAgents` strip is fed by it, no polling.
+- **Server worker** keeps PR snapshots fresh: a Temporal schedule fans out a per-team evaluation every ~3 min that polls each tracked PR (GitHub GraphQL via the team integration, rate-limit aware) and rebuilds the workstreams.
+- **Client** just pulls the latest snapshot: `HomeService` polls `GET /code_home/` on a fixed cadence and emits `home.onSnapshotUpdated` on change; `home.refresh` triggers an on-demand server evaluation. No `gh` calls, no rate-limit handling in the app.
+- Active agents stream from the existing cloud-task SSE, not from polling.
 
 ## 11. Classification & ranking
 
@@ -462,7 +433,7 @@ This is a blocker for M3, not an open question.
 - **Mute** — hide until the underlying state changes (new commit on the branch, new comment, CI flip, reviewer change). Cleared automatically by `HomeService` when the watermark moves.
 - **markViewed** — updates `lastUserViewedAt`; powers `pr.newCommentsSinceViewed`.
 
-Persistence: `home_attention_state(attentionId, snoozedUntil, mutedAt, mutedAtSha)`.
+Persistence (`home_attention_state`) is server-side and not implemented yet — see [docs/workflow-architecture.md](./workflow-architecture.md) §4.
 
 ## 15. Analytics events
 
@@ -490,29 +461,29 @@ Follow naming conventions in `docs/conventions.md`.
 - `HomeService.getSnapshot` built from existing `useTasks` data + `WorkspaceService` state piped to main.
 - **Active agents strip** wired to existing `CloudTaskService` stream (zero new infra).
 - Kinds that work without new `gh` calls: `stale_no_pr`.
-- **List and board ship together with the built-in default workflow.** No editor yet. The board reads the default `WorkflowConfig` from `WorkflowService.getDefault()` (no SQLite write needed at this stage). Column projection lives in `utils/boardColumns.ts`.
+- **List and board ship together with the built-in default workflow.** No editor yet. The board reads the built-in default `WorkflowConfig` (`workflow/default-workflow.ts`); no server round-trip needed at this stage. Column projection lives in `utils/boardColumns.ts`.
 - Ships visible value immediately and validates the layout.
 
 ### M2 — PR enrichment
 
-- New `gh` helpers (`getPrFull`, batch), polling loop, rate-limit handling.
+- Server-side PR enrichment: the worker polls each tracked PR and serialises a `PrSnapshot`.
 - New kinds: `pr_ci_failed`, `pr_comments`, `pr_ready_to_merge`, `branch_cleanup`.
-- PR row UI; refresh button; rate-limit warning chip.
+- PR row UI; refresh button.
 
 ### M3 — Reviewer flow + code-review skill
 
-- `listReviewRequestedPrs`, `pr_review_requested` kind.
+- `pr_review_requested` kind (PRs where the user is a requested reviewer).
 - **Ship the `code-review` skill in this same milestone.**
 - "Review with agent" action wired through `TaskCreationSaga`.
 
 ### M4 — Inbox-zero controls
 
 - Snooze, mute, `lastUserViewedAt`, keyboard shortcuts (`j`/`k`/`s`/`m`/`Enter`).
-- `home_attention_state` migration.
+- Server-side `home_attention_state` for snooze/mute/viewed.
 
 ### M5 — Config canvas (workflow editor)
 
-- `WorkflowService` + `WorkflowRepository` + migration; persist the default workflow on first run.
+- `WorkflowService` client + server-side workflow config persistence (`code_workflow/*`); the default workflow is seeded server-side on first read.
 - `workflow.*` tRPC router with Zod schemas.
 - Renderer: `ConfigCanvas`, palette, inspectors, validation banner.
 - `workflowEditorStore` + `workflowCanvasService` (R3 escape hatch).
@@ -533,11 +504,11 @@ Follow naming conventions in `docs/conventions.md`.
 
 - [ ] Rename existing `HomeItem.tsx` to free the filename.
 - [ ] Add `home` to `ViewType` + `navigateToHome`.
-- [ ] Scaffold `HomeService`, `HomeRepository`, schemas, router, DI token, root router wiring.
-- [ ] Scaffold `WorkflowService.getDefault()` returning the hardcoded default `WorkflowConfig` (no SQLite yet); `HomeService` reads from it for classification.
-- [ ] SQLite migration: `home_attention_state` + ensure `workspaces.lastViewedAt` covers what we need.
-- [ ] Wire `WorkspaceService` / `CloudTaskService` / `FileWatcherService` events into `HomeService` (subscriptions, not polling).
-- [ ] M2: `gh` helpers + `HomeService.refreshPullRequests` polling loop with rate-limit handling.
+- [ ] Scaffold `HomeService` (REST client), schemas, router, DI token, root router wiring.
+- [ ] Add the built-in default `WorkflowConfig` (`workflow/default-workflow.ts`); `WorkflowService` falls back to it when offline.
+- [ ] Server-side `home_attention_state` for snooze/mute/viewed.
+- [ ] `HomeService` poll loop → `home.onSnapshotUpdated`, kept fresh by the subscription registrar.
+- [ ] M2: server-side PR enrichment; `home.refresh` triggers an on-demand evaluation.
 - [ ] M3: `code-review` skill in `apps/code/skills/code-review/`.
 - [ ] Renderer: `useHomeSnapshot` (query + subscription), `HomeView`, active-agents strip, row + card components, board view, view toggle in header, detail pane, empty states.
 - [ ] `utils/boardColumns.ts` — column projection from `(workflow, snapshot) → BoardColumn[]` + unit tests covering every attention combination.
@@ -549,7 +520,7 @@ Follow naming conventions in `docs/conventions.md`.
 
 **M5 (Config canvas):**
 
-- [ ] `WorkflowService` (validation, predicate evaluator, default workflow, `WorkflowChanged` event) + `WorkflowRepository` + SQLite migration `home_workflow_config`.
+- [ ] `WorkflowService` client (default workflow, `workflow.onChanged` event) + server-side workflow config persistence.
 - [ ] `workflow.*` tRPC router with Zod input/output schemas (`get`, `save`, `validateDraft`, `resetToDefault`, `onChanged`).
 - [ ] `useWorkflow` hook (query + subscription); subscription wired in `features/home/subscriptions.ts`.
 - [ ] `workflowEditorStore` (Zustand, UI-only) + `workflowCanvasService` (R3 escape hatch for drag/snap/hit-test).
diff --git a/docs/workflow-architecture.md b/docs/workflow-architecture.md
index 5ddd41007d..8dfb20e0ab 100644
--- a/docs/workflow-architecture.md
+++ b/docs/workflow-architecture.md
@@ -1,13 +1,12 @@
-# Home workflow architecture (production)
+# Home workflow architecture
 
 The Home tab's data layer — workstream grouping, PR polling, situation
 classification, and workflow-config persistence — runs **server-side in
 PostHog**, in the `tasks` product (`products/tasks/` in the posthog repo). The
 Electron app is a thin authenticated client.
 
-This replaced the original local POC (Electron `gh` polling + SQLite workflow
-storage + client-side classification). If you change the wire shapes or the
-classification logic, update both sides and this doc.
+The Electron app and the PostHog `tasks` product share wire shapes and
+classification logic — if you change either, update both sides and this doc.
 
 ---