Skip to content

docs(issues): weekly triage report 2026-08-02 #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
cursor wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

docs(issues): weekly triage report 2026-08-02 #21

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 49 additions & 0 deletions docs/issues/triage-reports/2026-08-02.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Issue triage report — 2026-08-02

## Summary

One issue was open at the start of this run (`shared-worktree-branch-race`, high
severity). It was still reproducible in principle on shared Mac worktrees (Cursor
can silently drift HEAD when agents share a checkout or move the agent root).
The fix adds a small `devops.git.assert_branch` guard and agent-skill guidance
rather than changing Cursor platform behavior. One fix PR was opened; the issue
record was moved to `resolved/`. No issues were deferred.

## Fixes (PRs for review)

| Issue | Severity | Fix type | PR | Notes |
|-------|----------|----------|-----|-------|
| [shared-worktree-branch-race](resolved/2026-08-02-shared-worktree-branch-race.md) | high | Deliberated | [#20](https://github.com/Al-does/RL-Harness/pull/20) | Branch assertion helper + skill guidance |

## Deliberated fixes

### shared-worktree-branch-race

- **Bug:** Concurrent agent sessions or agent-root moves can change the active
branch in a shared worktree, so check-then-write git sequences target the
wrong branch.
- **Approach chosen:** Add `devops.git.assert_branch` (Python helper + CLI) and
document calling it before mutating git commands in agent skills.
- **Alternatives considered:** Enforcing separate git worktrees per agent in
repo automation (cannot be mandated from this library); wrapping all git
writes in a harness CLI (too invasive for a local orchestration issue).
- **Tradeoffs:** Does not prevent HEAD drift; fails fast before writes. Cursor
UI behavior unchanged.
- **Why not simpler:** A pure documentation fix would not give agents a
concrete, testable guard at the moment of git mutation.

## Updated but not fixed

| Issue | Reason deferred | Next step |
|-------|-----------------|-----------|

## No change

| Issue | Reason |
|-------|--------|

## Reviewer action

Inspect fix PR [#20](https://github.com/Al-does/RL-Harness/pull/20) and this
triage report PR targeting `main`. Merge each PR individually after review. Do
not auto-merge.