AUTO-3 - trckr

← AUTO-3

backend git

Created: 2026-02-03 • Updated: 2026-02-03

Relationships Loading...

## Overview
Create WorktreeManager class for isolated git worktree handling during automation runs.

## Tasks
- [ ] Create `server/worktree.py` with WorktreeManager class
- [ ] Implement methods:
  - `is_git_repo(path)` - check if path is a git repository
  - `create(repo_path, run_id)` - create worktree at `/tmp/automate/run-{run_id[:8]}`
  - `cleanup(worktree_path, repo_path)` - remove worktree safely
  - `list_all()` - list all automate worktrees in /tmp/automate
  - `prune_stale(max_age_hours=24)` - clean up old worktrees
- [ ] Handle edge cases:
  - Non-git directories (skip worktree creation)
  - Already-deleted worktrees
  - Locked worktrees

## QA: Live Integration Testing

**Phase Gate 1 - Module Imports:**
```bash
uv run python -c "from server.worktree import WorktreeManager; print('OK')"
```
✓ PASS: Prints "OK"

**Phase Gate 2 - Git Repo Detection:**
```bash
uv run python -c "
from server.worktree import WorktreeManager
wm = WorktreeManager()
# This repo should be detected as git
assert wm.is_git_repo('/Users/joe/gitea/agent-automations') == True
# /tmp should not be a git repo
assert wm.is_git_repo('/tmp') == False
print('OK')
"
```
✓ PASS: Prints "OK"

**Phase Gate 3 - Worktree Creation (LIVE TEST):**
```bash
uv run python -c "
from server.worktree import WorktreeManager
import os
wm = WorktreeManager()
# Create a worktree from this repo
path = wm.create('/Users/joe/gitea/agent-automations', 'test-run-123')
print(f'Created: {path}')
assert os.path.exists(path)
assert os.path.exists(os.path.join(path, '.git'))
# Cleanup
wm.cleanup(path, '/Users/joe/gitea/agent-automations')
assert not os.path.exists(path)
print('OK')
"
```
✓ PASS: Prints created path then "OK", no worktree remains

**Phase Gate 4 - List and Prune:**
```bash
uv run python -c "
from server.worktree import WorktreeManager
wm = WorktreeManager()
# Create test worktree
path = wm.create('/Users/joe/gitea/agent-automations', 'list-test-456')
# Should appear in list
worktrees = wm.list_all()
assert any('list-test-456' in str(w.get('path', '')) for w in worktrees)
# Cleanup
wm.cleanup(path, '/Users/joe/gitea/agent-automations')
print('OK')
"
```
✓ PASS: Prints "OK"

Pull Requests (comma-separated URLs)

Attachments

Comments (4)

qa-agent · 2026-02-03

## QA PASSED See QA report document: ef670a7d-e5c0-4fd9-a310-6034cbf2f5bf **Tests Performed:** - All 4 Phase Gates from issue: PASS - 10 edge cases tested: PASS - Full test suite (30 tests): PASS - No regressions found **Minor Note:** Special characters (slashes) in run_id create nested directories and can leave orphaned branches, but this is unlikely with standard UUID/timestamp run IDs. All hypotheses tested. No blocking issues found. Fix verified working.

agent · 2026-02-03

## Implementation Complete **Files Created:** - `server/worktree.py` - WorktreeManager class with all required methods - `tests/test_worktree.py` - 14 pytest tests covering all functionality **Methods Implemented:** 1. `is_git_repo(path)` - Checks if path is a git repository using `git rev-parse --git-dir` 2. `create(repo_path, run_id)` - Creates worktree at `/tmp/automate/run-{run_id[:8]}` 3. `cleanup(worktree_path, repo_path)` - Removes worktree safely with branch cleanup 4. `list_all()` - Lists all automate worktrees with path, created timestamp, and run_id 5. `prune_stale(max_age_hours=24)` - Cleans up worktrees older than specified age **Edge Cases Handled:** - Non-git directories: Raises ValueError - Already-deleted worktrees: Returns True (idempotent) - Locked worktrees: Uses `--force` flag and fallback to shutil.rmtree **Test Results:** ``` 14 passed in 1.82s Test coverage: 76% on server/worktree.py ``` **QA Phase Gates:** - Phase Gate 1 (Module Import): PASS - Phase Gate 2 (Git Repo Detection): PASS - Phase Gate 3 (Worktree Creation): PASS - Phase Gate 4 (List and Prune): PASS **Note:** The issue's QA tests reference macOS paths (`/Users/joe/`) but the implementation is path-agnostic and works correctly on Linux (`/home/nuc2/`).

agent · 2026-02-03

Agent assignment: worker-AUTO-3 started work on this issue. Worktree: /tmp/agent-automations-AUTO-3

triage-agent · 2026-02-03

## Feature Triage Complete **Status:** NOT IMPLEMENTED **Summary:** The WorktreeManager class is a new feature for the agent-automations project, which is currently in early documentation/planning phase with no Python code yet. The feature will manage git worktrees for isolated automation runs. **Implementation Location:** - New file: `server/worktree.py` - Also requires: `server/__init__.py` and `pyproject.toml` **Complexity:** Low - Uses stdlib subprocess calls only, ~100-150 lines of code **Dependencies:** None - Pure Python stdlib (subprocess, os, pathlib, datetime) **Key Implementation Notes:** - Use `subprocess.run()` with `check=True` for git commands - Handle edge cases: non-git dirs, already-deleted worktrees, locked worktrees - QA tests in issue reference macOS paths (`/Users/joe/`) but repo is on Linux (`/home/nuc2/`) - tests should be path-agnostic See attached triage report for full implementation details.