trail-boss/docs/notes
jedarden 270d908181 docs(tb-2tc5): design normalized event API endpoint for tmux adapter
Add POST /event/normalized endpoint that accepts pre-normalized stuck/unstuck/
registered/ended events directly from harness-agnostic adapters.

Decision rationale:
- Keeps adapter layer clean — adapters emit normalized events directly
- Avoids coupling non-Claude sources to Claude-specific data structures
- The normalized contract is already the internal model — we expose it directly

Event schema matches daemon/types.ts NormalizedEvent union type.

This enables the tmux detector to post events without wrapping them in
Claude hook format, making the adapter layer harness-agnostic.
2026-07-02 23:10:27 -04:00
..
decisions.md docs(tb-4xha): strengthen alignment between normalized event decision and plan 2026-07-02 22:32:51 -04:00
normalized-event-contract.md docs(normalized-event-contract): add comprehensive harness-agnostic adapter contract specification 2026-07-02 09:38:57 -04:00
normalized-event-schema.md docs(tb-4wur): document normalized event schema for stuck/unstuck 2026-07-02 22:17:40 -04:00
tb-1fk8-event-schema.md docs(tb-1fk8): document normalized stuck/unstuck event schema 2026-07-02 22:35:04 -04:00
tb-1hkf-submission-contract.md docs(tb-1hkf): document tmux detector event submission contract 2026-07-02 22:43:23 -04:00
tb-1v8t-analysis.md docs(tb-1v8t): analyze false positives and negatives in tmux detector 2026-07-02 17:16:32 -04:00
tb-2tc5-api-design-decision.md docs(tb-2tc5): document normalized event API endpoint design decision 2026-07-02 22:06:42 -04:00
tb-2tc5.md docs(tb-2tc5): design normalized event API endpoint for tmux adapter 2026-07-02 23:10:27 -04:00
tb-9k49-normalized-event-api-comparison.md docs(tb-9k49): document normalized event API approach comparison 2026-07-02 22:17:39 -04:00
tb-r4ly-review.md docs(tb-r4ly): review current /event endpoint and tmux adapter implementation 2026-07-02 22:29:31 -04:00
tmux-detector-design.md docs(tmux-detector): add comprehensive detector poller design 2026-07-02 09:41:48 -04:00
tmux-detector-submission-contract.md docs(tb-ndwx): document tmux detector event submission contract 2026-07-02 22:20:48 -04:00