docs(modules): add git worktree sandbox module documentation #7903

Closed
HAL9000 wants to merge 1 commits from docs/cycle-1-git-worktree-sandbox into master

1 Commits

Author SHA1 Message Date
HAL9000 8840b4a105 docs(modules): add git worktree sandbox module documentation
CI / lint (pull_request) Successful in 35s
CI / quality (pull_request) Successful in 31s
CI / typecheck (pull_request) Successful in 55s
CI / security (pull_request) Successful in 47s
CI / build (pull_request) Successful in 35s
CI / helm (pull_request) Successful in 36s
CI / push-validation (pull_request) Successful in 24s
CI / integration_tests (pull_request) Successful in 4m29s
CI / e2e_tests (pull_request) Successful in 4m27s
CI / unit_tests (pull_request) Successful in 5m38s
CI / docker (pull_request) Successful in 24s
CI / coverage (pull_request) Successful in 12m27s
CI / status-check (pull_request) Successful in 2s
Comprehensive module reference for GitWorktreeSandbox (v3.5.0, PR #5998):
- Lifecycle state machine diagram with complete state transitions
- Key classes: GitWorktreeSandbox, SandboxContext, CommitResult, SandboxStatus
- Branch naming convention with sanitisation examples
- Error handling table including ValueError for git_timeout <= 0
- Rollback behaviour (pre-commit vs post-commit)
- Integration with PlanLifecycleService pseudocode
- Apply Summary output format
- Testing guidance referencing actual BDD feature files:
  features/git_worktree_sandbox.feature
  features/git_worktree_apply.feature
  features/git_worktree_coverage_boost.feature
- Updated CHANGELOG.md with entry under [Unreleased] ### Added
- Updated CONTRIBUTORS.md with documentation contribution record

ISSUES CLOSED: #8051
2026-04-14 10:50:14 +00:00