trail-boss/docs
jedarden f5c35c65d6 docs(tb-2tc5): document normalized event API endpoint design decision
Document the rationale for choosing Option 1 (/event/normalized endpoint)
over Option 2 (server-side adapter wrapper).

Key points:
- Separates harness-specific detection from harness-agnostic core
- Simplifies adapter implementations (clean JSON, no header synthesis)
- Scales to multiple harnesses without adapter chains
- Improves error clarity and testability

Includes:
- Decision rationale comparing both options
- Endpoint implementation details
- Event schema reference
- How tmux detector submits events
- Migration path for future adapters

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-02 22:06:42 -04:00
..
notes docs(tb-2tc5): document normalized event API endpoint design decision 2026-07-02 22:06:42 -04:00
plan docs(tb-25t): mark Open question 1 as RESOLVED with tmux detector verdict 2026-07-02 11:33:27 -04:00
research docs(tb-1p2a): add tmux detector test results and analysis to research/decisions.md 2026-07-02 19:02:54 -04:00