cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

docs(spec): correct git worktree sandbox path format to use system temp directory #6378

Closed
HAL9000 wants to merge 1 commits from spec/arch-sandbox-path-correction-cycle9 into master
pull from: spec/arch-sandbox-path-correction-cycle9
merge into: cleveragents:master
Conversation 14 Commits 1 Files Changed 3
+45 -22

1 Commits

Author SHA1 Message Date
HAL9000 792d78d6ed docs(spec): describe git worktree sandbox path via temp dir placeholder
CI / push-validation (pull_request) Successful in 17s
Details
CI / helm (pull_request) Successful in 23s
Details
CI / lint (pull_request) Successful in 26s
Details
CI / build (pull_request) Successful in 36s
Details
CI / security (pull_request) Successful in 52s
Details
CI / quality (pull_request) Successful in 3m41s
Details
CI / typecheck (pull_request) Successful in 3m59s
Details
CI / e2e_tests (pull_request) Successful in 4m18s
Details
CI / integration_tests (pull_request) Successful in 4m23s
Details
CI / unit_tests (pull_request) Successful in 6m29s
Details
CI / docker (pull_request) Successful in 1m59s
Details
CI / coverage (pull_request) Successful in 11m8s
Details
CI / status-check (pull_request) Successful in 1s
Details
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Successful in 57m7s
Details 
The GitWorktreeSandbox implementation (PR #5998) creates worktrees in the
system temp directory using tempfile.mkdtemp() with the prefix
ca-sandbox-<plan_id>-, producing OS-specific paths (e.g.,
&lt;SYSTEM_TEMP_DIR&gt;/ca-sandbox-<PLAN_ULID>-XXXXXX/).

The spec previously showed the worktree path as a .worktrees/ subdirectory
inside the repository (e.g., /repos/api/.worktrees/plan-01HXM8). This was
incorrect and inconsistent with the implementation.

Changes:
- Update all plan execute output examples (Rich/Plain/JSON/YAML) to use the
  <SYSTEM_TEMP_DIR> prefix placeholder instead of hard-coding /tmp
- Update the end-to-end workflow examples (strategize + execute panels)
- Add explicit documentation of the git worktree path format in the
  Sandbox Implementation Strategies section, including rationale
- Update the changelog to reference the cross-platform placeholder

Triggered by: merged PR #5998 (GitWorktreeSandbox implementation)
ISSUES CLOSED: #6343
 2026-04-12 19:36:49 +00:00