From e678f52363c852358c929e8186a82f8b05cb78ec Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 2 Aug 2026 10:04:59 +0000 Subject: [PATCH] docs(issues): weekly triage report 2026-08-02 Co-authored-by: Alex Vardakostas --- docs/issues/triage-reports/2026-08-02.md | 49 ++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 docs/issues/triage-reports/2026-08-02.md diff --git a/docs/issues/triage-reports/2026-08-02.md b/docs/issues/triage-reports/2026-08-02.md new file mode 100644 index 0000000..ec1bd80 --- /dev/null +++ b/docs/issues/triage-reports/2026-08-02.md @@ -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.