feat(cloud): resume logic and tree tracking (#679)

Author: joshsny

.github/workflows/agent-release.yml

@@ -59,6 +59,9 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
+      - name: Build shared (agent dependency)
+        run: pnpm --filter @posthog/shared run build
+
       - name: Build the package
         run: pnpm --filter agent run build
 

.github/workflows/build.yml

@@ -33,6 +33,9 @@ jobs:
       - name: Build electron-trpc
         run: pnpm --filter @posthog/electron-trpc build
 
+      - name: Build shared
+        run: pnpm --filter @posthog/shared build
+
       - name: Build agent
         run: pnpm --filter agent build
 

.github/workflows/test.yml

@@ -78,6 +78,7 @@ jobs:
       - name: Build packages
         run: |
           pnpm --filter @posthog/electron-trpc build &
+          pnpm --filter @posthog/shared build
           pnpm --filter agent build &
           wait
 

.github/workflows/twig-release.yml

@@ -67,6 +67,9 @@ jobs:
       - name: Build electron-trpc package
         run: pnpm --filter @posthog/electron-trpc run build
 
+      - name: Build shared package
+        run: pnpm --filter @posthog/shared run build
+
       - name: Build agent package
         run: pnpm --filter @posthog/agent run build
 

CLAUDE.md

@@ -9,6 +9,7 @@
 - `packages/agent` - TypeScript agent framework wrapping Claude Agent SDK
 - `packages/core` - Shared business logic for jj/GitHub operations
 - `packages/electron-trpc` - Custom tRPC package for Electron IPC
+- `packages/shared` - Shared utilities (Saga pattern, etc.) used across packages
 
 ## Commands
 
@@ -35,6 +36,12 @@
 - `pnpm --filter agent dev` - Watch mode build
 - `pnpm --filter agent typecheck` - Type check agent
 
+### Shared Package Specific
+
+- `pnpm --filter @posthog/shared build` - Build shared with tsup
+- `pnpm --filter @posthog/shared dev` - Watch mode build
+- `pnpm --filter @posthog/shared typecheck` - Type check shared
+
 ## Code Style
 
 - Prefer writing our own solution over adding external packages when the fix is simple
@@ -92,6 +99,12 @@ See [ARCHITECTURE.md](./apps/twig/ARCHITECTURE.md) for detailed patterns (DI, se
 
 - Shared business logic for jj/GitHub operations
 
+### Shared Package (packages/shared)
+
+- Zero-dependency shared utilities used across packages
+- Saga pattern for atomic multi-step operations with automatic rollback
+- Built with tsup, outputs ESM
+
 ## Agent Integration Guidelines
 
 - **No rawInput**: Don't use Claude Code SDK's `rawInput` - only use Zod validated meta fields. This keeps us agent agnostic and gives us a maintainable, extensible format for logs.

README.md

@@ -58,7 +58,8 @@ twig/
 ├── packages/
 │   ├── agent/      # TypeScript agent framework
 │   ├── core/       # Shared business logic
-│   └── electron-trpc/  # tRPC for Electron IPC
+│   ├── electron-trpc/  # tRPC for Electron IPC
+│   └── shared/     # Shared utilities (Saga pattern, etc.)
 ```
 
 ## Documentation

apps/twig/package.json

@@ -108,6 +108,7 @@
     "@phosphor-icons/react": "^2.1.10",
     "@posthog/agent": "workspace:*",
     "@posthog/electron-trpc": "workspace:*",
+    "@posthog/shared": "workspace:*",
     "@radix-ui/react-collapsible": "^1.1.12",
     "@radix-ui/react-icons": "^1.3.2",
     "@radix-ui/themes": "^3.2.1",

apps/twig/src/renderer/sagas/task/task-creation.ts

@@ -2,11 +2,11 @@ import type { PostHogAPIClient } from "@api/posthogClient";
 import { buildPromptBlocks } from "@features/editor/utils/prompt-builder";
 import { getSessionActions } from "@features/sessions/stores/sessionStore";
 import { useWorkspaceStore } from "@features/workspace/stores/workspaceStore";
+import { Saga, type SagaLogger } from "@posthog/shared";
 import { logger } from "@renderer/lib/logger";
 import { useTaskDirectoryStore } from "@renderer/stores/taskDirectoryStore";
 import { trpcVanilla } from "@renderer/trpc";
 import { getTaskRepository } from "@renderer/utils/repository";
-import { Saga, type SagaLogger } from "@shared/lib/saga";
 import type {
   ExecutionMode,
   Task,

apps/twig/src/renderer/services/task/service.ts

@@ -3,8 +3,8 @@ import { useDraftStore } from "@features/message-editor/stores/draftStore";
 import { useSettingsStore } from "@features/settings/stores/settingsStore";
 import { useTaskExecutionStore } from "@features/task-detail/stores/taskExecutionStore";
 import { useWorkspaceStore } from "@features/workspace/stores/workspaceStore";
+import type { SagaResult } from "@posthog/shared";
 import { logger } from "@renderer/lib/logger";
-import type { SagaResult } from "@shared/lib/saga";
 import { injectable } from "inversify";
 import {
   type TaskCreationInput,

apps/twig/src/renderer/stores/sagas/focusSagas.ts

@@ -1,7 +1,7 @@
 import type { FocusResult, FocusSession } from "@main/services/focus/schemas";
+import { Saga, type SagaLogger } from "@posthog/shared";
 import { logger } from "@renderer/lib/logger";
 import { trpcVanilla } from "@renderer/trpc";
-import { Saga, type SagaLogger } from "@shared/lib/saga";
 
 const log = logger.scope("focus-saga");