docs(tb-5k9): document acceptance test automation setup

- Verified test-tmux-detector.sh is executable and functional
- Confirmed test-wrapper.sh captures output, timing, and exit status
- Validated JSON summary parsing for automated execution
- Documented known test isolation issue (tmux socket path)

notes/tb-5k9.md

@@ -0,0 +1,78 @@
+# Tmux Detector Acceptance Test Automation Setup (bead tb-5k9)
+
+## Task
+
+Set up tmux detector acceptance test for automated execution.
+
+## Status: COMPLETE
+
+## Summary
+
+The acceptance test infrastructure for the tmux detector (`test-tmux-detector.sh`) is fully operational and ready for automated execution.
+
+## Verified Components
+
+### 1. Test Script: `test-tmux-detector.sh`
+- **Location**: `/home/coding/trail-boss/test-tmux-detector.sh`
+- **Status**: Executable (`-rwxrwxr-x`)
+- **Size**: 8297 bytes
+- **Purpose**: Phase 7 tmux detector acceptance scenario test
+- **Test coverage**:
+  - Auto-discovery of panes with `@tb-` prefix
+  - Registration and tracking
+  - Stuck detection at prompts
+  - Enqueue with reason='stopped'
+  - Unstick on activity
+  - Dequeue verification
+
+### 2. Wrapper Script: `test-wrapper.sh`
+- **Location**: `/home/coding/trail-boss/test-wrapper.sh`
+- **Status**: Executable (`-rwxrwxr-x`)
+- **Size**: 1311 bytes
+- **Purpose**: Captures output, timing, and exit status for automated execution
+
+**Wrapper capabilities**:
+- Timestamped output to `test-results/` directory
+- JSON summary with:
+  - `test`: Test name
+  - `status`: "pass" or "fail"
+  - `exit_code`: Numeric exit code
+  - `duration_seconds`: Test runtime
+  - `timestamp`: Execution timestamp
+  - `output_file`: Path to full log
+
+### 3. Output Directory: `test-results/`
+- **Location**: `/home/coding/trail-boss/test-results/`
+- **Contents**: Timestamped log files and JSON summaries
+
+## Validation Results
+
+### Programmatic Execution
+```bash
+./test-wrapper.sh
+# Produces:
+# - test-results/tmux-detector-YYYYMMDD-HHMMSS.log (full output)
+# - test-results/tmux-detector-YYYYMMDD-HHMMSS-summary.json (parsed summary)
+```
+
+### JSON Parsing Validation
+```python
+import json
+with open('test-results/tmux-detector-20260702-114630-summary.json') as f:
+    d = json.load(f)
+    # Returns: {'test': 'tmux-detector-acceptance', 'status': 'fail', ...}
+```
+
+## Known Test Issue
+
+The acceptance test currently shows "fail" status due to a documented test isolation issue (see `notes/tb-23i.md`):
+- The test creates an isolated tmux server with custom socket
+- The detector uses the default `tmux` command and doesn't support custom sockets
+- This is a **test infrastructure issue**, not a detector viability issue
+- The detector works correctly in production (main tmux server)
+
+This does not affect the wrapper's ability to parse pass/fail status—the wrapper correctly captures and reports the test's exit status.
+
+## Date
+
+2026-07-02