pdftract/docs/test-hygiene
jedarden 724321d610 docs(bf-58z9ib): add common issues and resolutions to orphaned process troubleshooting
Add comprehensive "Common Issues and Resolutions" section documenting
5 frequently encountered orphaned process scenarios with step-by-step
resolution procedures:

1. Address Already in Use Error - Port conflicts from stale servers
2. Test Suite Hangs Indefinitely - Pipe buffer blocking wait()
3. Multiple Orphaned Processes After CI Timeout - Fuzz harness interruption
4. Zombie Process Accumulation - Unreaped children
5. Permission Denied on Verification Script - Missing execute bit

Each issue includes:
- Clear symptom description
- Root cause analysis
- Step-by-step resolution commands
- Code examples for fixes
- Prevention strategies

Resolves bead bf-58z9ib acceptance criteria:
- Lists at least 3 common issues with resolutions  (5 documented)
- File is committed to git 

Process pattern explanations (pdftract mcp, TH-0, TH_0) already exist
in docs/test-hygiene/orphaned-process-verification.md lines 110-251.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-07 03:27:44 -04:00
..
orphaned-process-verification.md docs(bf-vqcg3g): add reference to post-test integration documentation 2026-07-07 03:17:28 -04:00
post-test-orphan-verification-integration.md docs(bf-51qlcf): add manual verification usage examples 2026-07-07 03:21:46 -04:00
troubleshooting-orphaned-processes.md docs(bf-58z9ib): add common issues and resolutions to orphaned process troubleshooting 2026-07-07 03:27:44 -04:00