charles/claude-hooks

Fork 0

Tracking: persistent workdirs and sessions #10

New issue

Closed

opened 2026-04-16 22:45:57 +00:00 by claude-desktop · 1 comment

claude-desktop commented

2026-04-16 22:45:57 +00:00

Collaborator

Purpose

Tracks the milestone "Persistent workdirs and sessions". Replaces per-task mkdtemp + git clone with a cache clone plus per-(agent, branch) worktree, and persists Claude Agent SDK session ids per (agent, repo, issue) so re-dispatches resume their prior conversation instead of starting fresh.

Each story carries a ## Dependencies footer with its direct edges; this issue owns the full tree.

Dependency graph

Layer 0 — de-risk
  #2  Spike: SDK resume + git identity strategy ........ ✅

Layer 1 — workdir cache
  #3  Workdir module .................................. ✅ PR #13
  #4  Cleanup webhooks ................................ ✅ PR #12

Layer 2 — integration
  #5  runAgent integration ............................ ✅ PR #14

Layer 3 — sessions
  #6  Sessions store + resume ......................... ← next up

Layer 4 — housekeeping (parallel once #6 lands)
  #7  Daily expiration sweeper ........................ <-- #6
  #9  Admin /reset endpoint ........................... ✅ PR #16

  Dashboard observability (parallel once #5 lands)
  #8  Dashboard disk-usage card ....................... ✅ PR #15

PR stacking strategy

Same convention as the peon repo: a downstream story branches off the upstream story's branch and targets it as the PR base, so work parallelises while the upstream PR is still in review. When the upstream merges to main, the downstream PR is rebased and retargeted at main.

Branch naming: issue-<N>-<slug>.

Recommended execution order

Wave 1 (de-risk): #2 — ✅ done
Wave 2 (parallel): #3 (after #2), #4 — ✅ done
Wave 3: #5 — ✅ done
Wave 4: #6 — ← next
Wave 5 (parallel on top of #6): #7 (#9 ✅ done)
Side-quest (parallel from Wave 3 onward): #8 — ✅ done

Critical path: #2 → #3 → #5 → #6 → #7.

Decisions log

Spike (#2) output lands here as comments. Key decisions to capture:

Where session_id lives in the SDK message stream
Whether resume requires the original cwd
Git identity: env vars (option A) vs. extensions.worktreeConfig (option B)
Git auth: GIT_ASKPASS vs. URL rewrite vs. credential helper
Cache clone strategy: --filter=blob:none vs. --depth=N

Out of scope for this milestone

Per-agent disk-usage breakdown on the dashboard (#8 ships the headline number only)
Authentication on admin endpoints (#9 inherits whatever exists)
Skill prompt content quality tuning for the resume case (#6 only enforces the delta-vs-full split)
Session sharing across agents (sessionKey includes agent name on purpose)

## Purpose Tracks the milestone "Persistent workdirs and sessions". Replaces per-task `mkdtemp + git clone` with a cache clone plus per-(agent, branch) worktree, and persists Claude Agent SDK session ids per (agent, repo, issue) so re-dispatches resume their prior conversation instead of starting fresh. Each story carries a `## Dependencies` footer with its direct edges; this issue owns the full tree. ## Dependency graph ```text Layer 0 — de-risk #2 Spike: SDK resume + git identity strategy ........ ✅ Layer 1 — workdir cache #3 Workdir module .................................. ✅ PR #13 #4 Cleanup webhooks ................................ ✅ PR #12 Layer 2 — integration #5 runAgent integration ............................ ✅ PR #14 Layer 3 — sessions #6 Sessions store + resume ......................... ← next up Layer 4 — housekeeping (parallel once #6 lands) #7 Daily expiration sweeper ........................ <-- #6 #9 Admin /reset endpoint ........................... ✅ PR #16 Dashboard observability (parallel once #5 lands) #8 Dashboard disk-usage card ....................... ✅ PR #15 ``` ## PR stacking strategy Same convention as the peon repo: a downstream story branches off the upstream story's branch and targets it as the PR base, so work parallelises while the upstream PR is still in review. When the upstream merges to `main`, the downstream PR is rebased and retargeted at `main`. Branch naming: `issue-<N>-<slug>`. ## Recommended execution order - **Wave 1 (de-risk):** #2 — ✅ done - **Wave 2 (parallel):** #3 (after #2), #4 — ✅ done - **Wave 3:** #5 — ✅ done - **Wave 4:** #6 — ← next - **Wave 5 (parallel on top of #6):** #7 (#9 ✅ done) - **Side-quest (parallel from Wave 3 onward):** #8 — ✅ done Critical path: `#2 → #3 → #5 → #6 → #7`. ## Decisions log Spike (#2) output lands here as comments. Key decisions to capture: - Where `session_id` lives in the SDK message stream - Whether `resume` requires the original `cwd` - Git identity: env vars (option A) vs. `extensions.worktreeConfig` (option B) - Git auth: `GIT_ASKPASS` vs. URL rewrite vs. credential helper - Cache clone strategy: `--filter=blob:none` vs. `--depth=N` ## Out of scope for this milestone - Per-agent disk-usage breakdown on the dashboard (#8 ships the headline number only) - Authentication on admin endpoints (#9 inherits whatever exists) - Skill prompt content quality tuning for the resume case (#6 only enforces the delta-vs-full split) - Session sharing across agents (sessionKey includes agent name on purpose)

claude-desktop added this to the Persistent workdirs and sessions milestone

2026-04-16 22:45:57 +00:00

claude-desktop added the

area:meta

type:meta

labels

2026-04-16 22:45:57 +00:00

claude-desktop referenced this issue

2026-04-16 22:46:26 +00:00

Spike: validate Claude SDK resume + pick git identity strategy #2

claude-desktop referenced this issue

2026-04-16 22:46:45 +00:00

Workdir module — cache clone, worktree lifecycle, per-agent git identity #3

claude-desktop referenced this issue

2026-04-16 22:46:59 +00:00

Cleanup webhooks — issues.closed and pull_request.merged #4

claude-desktop referenced this issue

2026-04-16 22:47:14 +00:00

runAgent integration — swap mkdtemp+clone for worktree #5

claude-desktop referenced this issue

2026-04-16 22:47:31 +00:00

Sessions store + resume — disk-backed map and delta-prompt flow #6

claude-desktop referenced this issue

2026-04-16 22:47:43 +00:00

Daily expiration sweeper for sessions and worktrees #7

claude-desktop referenced this issue

2026-04-16 22:47:55 +00:00

Dashboard disk-usage card #8

claude-desktop referenced this issue

2026-04-16 22:48:05 +00:00

Admin /reset endpoint — manual escape hatch #9

claude-desktop referenced this issue

2026-04-17 12:44:51 +00:00

Tracking: containerised workers #17

claude-desktop commented

2026-04-18 14:35:54 +00:00

Author

Collaborator

Closing: milestone complete. All children resolved — #6 (sessions store), #7 (sweeper), #3/#4/#5 (workdir + cleanup + runAgent), #8 (dashboard), #9 (admin reset) all landed. Sessions + worktrees have been live since 2026-04-17 and are in daily use across boss/dev/reviewer.

Closing: milestone complete. All children resolved — `#6` (sessions store), `#7` (sweeper), `#3`/`#4`/`#5` (workdir + cleanup + runAgent), `#8` (dashboard), `#9` (admin reset) all landed. Sessions + worktrees have been live since 2026-04-17 and are in daily use across boss/dev/reviewer.

claude-desktop closed this issue

2026-04-18 14:35:59 +00:00