fix: exclude .test-index from file-overlap conflict detection (4298-db75) (merge worktree-20260324-164324)

Author: JoeOakhartNava

plugins/dso/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dso",
-  "version": "0.26.4",
+  "version": "0.26.5",
   "description": "Workflow infrastructure plugin for Claude Code projects",
   "commands": "./commands/",
   "skills": "./skills/",

plugins/dso/scripts/sprint-next-batch.sh

@@ -716,6 +716,13 @@ candidates.sort(key=lambda c: (c.classify_priority, c.tk_priority, c.id))
 
 # ── Greedy selection with file-overlap and opus cap ───────────────────────────
 
+# Files that are shared-by-design and support concurrent additive edits.
+# These are excluded from the file-overlap conflict check to avoid false
+# positive serialization between unrelated tasks.
+OVERLAP_SAFE_FILES = {
+    ".test-index",
+}
+
 claimed_files   = {}   # file -> task_id that claimed it
 batch           = []   # Candidate objects in batch
 opus_in_batch   = 0
@@ -728,10 +735,12 @@ for c in candidates:
     if limit > 0 and len(batch) >= limit:
         break
 
-    # File conflict check
+    # File conflict check (skip overlap-safe shared files)
     conflict_file = None
     conflict_task = None
     for f in c.files:
+        if f in OVERLAP_SAFE_FILES:
+            continue
         if f in claimed_files:
             conflict_file = f
             conflict_task = claimed_files[f]

tests/scripts/test-sprint-next-batch.sh

@@ -786,6 +786,22 @@ test_sprint_next_batch_no_TK_variable() {
 }
 test_sprint_next_batch_no_TK_variable
 
+# ── Test: .test-index excluded from file-overlap conflict detection ────────────
+# Bug 4298-db75: .test-index is a shared registry that many agents modify
+# concurrently (adding test entries). Flagging it as a file-overlap conflict
+# creates false positive serialization between unrelated tasks.
+test_test_index_overlap_safe() {
+    echo "Test: .test-index is in overlap-safe exclusion list"
+    if grep -q 'test-index' "$PLUGIN_SCRIPT" && grep -qE 'OVERLAP_SAFE|overlap_safe' "$PLUGIN_SCRIPT"; then
+        echo "  PASS: .test-index appears in an overlap-safe exclusion list"
+        (( PASS++ ))
+    else
+        echo "  FAIL: sprint-next-batch.sh must exclude .test-index from file-overlap conflicts" >&2
+        (( FAIL++ ))
+    fi
+}
+test_test_index_overlap_safe
+
 echo ""
 echo "Results: $PASS passed, $FAIL failed"
 [ "$FAIL" -eq 0 ]