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

docs(spec): document GitWorktreeSandbox, ContextTierHydrator, and idempotent execute dispatch #6988

Closed
HAL9000 wants to merge 1 commits from spec/architecture-cycle2-impl-clarifications into master
pull from: spec/architecture-cycle2-impl-clarifications
merge into: cleveragents:master
Conversation 15 Commits 1 Files Changed 1
+22 -1

1 Commits

Author SHA1 Message Date
HAL9000 30a3288c3d docs(spec): document GitWorktreeSandbox, ContextTierHydrator, and idempotent execute dispatch
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / push-validation (pull_request) Successful in 17s
Details
CI / lint (pull_request) Successful in 23s
Details
CI / helm (pull_request) Successful in 24s
Details
CI / quality (pull_request) Successful in 31s
Details
CI / build (pull_request) Successful in 37s
Details
CI / security (pull_request) Successful in 1m0s
Details
CI / typecheck (pull_request) Successful in 3m58s
Details
CI / unit_tests (pull_request) Failing after 4m59s
Details
CI / docker (pull_request) Has been skipped
Details
CI / e2e_tests (pull_request) Successful in 6m20s
Details
CI / integration_tests (pull_request) Successful in 7m5s
Details
CI / coverage (pull_request) Successful in 10m25s
Details
CI / status-check (pull_request) Failing after 1s
Details
CI / benchmark-regression (pull_request) Successful in 59m57s
Details 
Minor clarifications documenting implementation details discovered from merged PRs.

Changes:
1. GitWorktreeSandbox implementation details (Issue #6958, PR #5998):
   - Added 'Implementation class: GitWorktreeSandbox' note to §Sandbox Implementation Strategies
   - Documents worktree path (.worktrees/plan-<plan_id>) and branch naming (cleveragents/plan-<plan_id>)
   - Documents non-git fallback: filesystem_copy strategy using shutil.copy2

2. Idempotent execute dispatch (Issue #6958, PR #5998):
   - Added idempotency note to _cleveragents/plan/execute in §Complete Method Routing
   - Prevents duplicate dispatch errors in multi-agent scenarios

3. ContextTierHydrator (Issue #6953, PR #4219):
   - Added new §Context Tier Hydration subsection after §Three Storage Tiers
   - Documents ContextTierHydrator component: file discovery, fragment creation, injection point
   - Documents constructor injection pattern (no get_container() calls)
   - Documents sandbox root path (.cleveragents/sandbox/)
   - Added ContextFragment metadata type constraint warning (strings required in metadata dict)

All changes are minor clarifications — no new architectural decisions, no interface changes.

Closes #6953 (ContextTierHydrator documentation)
Closes #6958 (GitWorktreeSandbox documentation)

ISSUES CLOSED: #6953, #6958

---
Automated by CleverAgents Bot
Supervisor: Architecture Designer | Agent: AUTO-ARCH | Cycle: 2
 2026-04-13 03:59:52 +00:00