trail-boss/PROGRESS.md

Trail Boss — Marathon Progress

Phase 1: Probe PermissionRequest ✅ COMPLETE

Done: Confirmed PermissionRequest fires for gate types and captured payload shape.

Findings documented in docs/research/claude-code-mechanics.md:

• PermissionRequest fires when a tool requires permission (tested with Edit)
• Payload includes tool_name + tool_input — exactly what the queue needs to display the proposed operation
• $TMUX_PANE is available in hook environment (confirmed via %461 in probe)
• permission_mode, session_id, transcript_path, cwd all present
• Permission block emits PermissionRequest and no Stop (confirmed)

Phase 2: Emitter ✅ COMPLETE

Done: Built trailboss-emit.sh that forwards hook payloads to collector and injects $TMUX_PANE. Wired all hooks in .claude/settings.json.

Verified: Stub collector logged POSTs with session_id, cwd, and pane_id. Demonstrated bare curl drops $TMUX_PANE — proving the wrapper is required.

Files:

• .claude/trailboss-emit.sh — emitter script
• .claude/settings.json — hook wiring

Phase 3: Daemon (IN PROGRESS)

Goal: Build the daemon with ingest endpoint, SQLite state, self-healing registry, transcript reconcile loop, and FIFO queue.

Next:

• Choose tech stack (Bun + SQLite per plan, or alternative)
• Design normalized stuck/unstuck adapter contract
• Implement ingest endpoint (loopback only)
• Implement SQLite state + session_id → pane registry
• Implement transcript reconcile loop
• Implement FIFO queue with /next and /skip endpoints

Phase 4: Navigation (PENDING)

Phase 5: Presentation (PENDING)

Phase 6: Walking Skeleton (PENDING)

Phase 7: Iterate (PENDING)