Add gh run watch integration for immediate CI notification

[newhook]

Summary

Replaces polling-based CI status checking with gh run watch for immediate notification when workflow runs complete. This reduces CI feedback latency from the poll interval (default 10 minutes) to immediate notification.

Before: Poll every 10 minutes, check if runs complete, fetch results
After: Watch runs directly with gh run watch, fetch results exactly once when done

Changes

New Components

• WatchWorkflowRun task type (internal/db/scheduler.go): New scheduled task type for watching workflow runs
• handler_watch_run.go (internal/control/): Handler that:
  • Runs gh run watch <run-id> --exit-status which blocks until completion
  • Schedules immediate PRFeedback task when run completes
  • Handles context cancellation gracefully (for work destruction)
  • Uses idempotency key (watch_run_<id>) to prevent duplicate watchers

Modified Components

• handler_pr_feedback.go: After fetching PR status, spawns watchers for any in-progress or queued workflow runs
• plane.go: Registers the new WatchWorkflowRun handler

Documentation & Tooling

• CLAUDE.md: Added note about beads version alignment requirement
• mise.toml and mise.tmpl: Pin beads to v0.49.2 for schema compatibility

How It Works

Detect in_progress/queued run (during PRFeedback)
    ↓
WatchWorkflowRun task exists for this run_id? → skip (idempotent)
    ↓
No → schedule WatchWorkflowRun task
    ↓
WatchWorkflowRun handler:
    gh run watch <run-id> --exit-status  // blocks until done
    ↓
    schedule PRFeedback task (immediate)
    ↓
PRFeedback handler:
    fetches logs, parses failures, creates beads

Issues Resolved

• ac-7f7o: Instead of polling gh should we use gh run watch?
• ac-7f7o.1: Add gh run watch for in-progress workflow runs
• ac-7f7o.3: Add tests for WatchWorkflowRun handler

Testing

• Added comprehensive test suite in handler_watch_run_test.go:
  • Missing metadata validation (run_id, repo)
  • Invalid run_id handling
  • Context cancellation (graceful shutdown)
  • Duplicate prevention via idempotency key
  • Multiple watchers for different run_ids
  • Handler registration verification

All tests passing:

=== RUN   TestHandleWatchWorkflowRunTask
--- PASS: TestHandleWatchWorkflowRunTask (0.32s)
=== RUN   TestScheduleWatchWorkflowRun  
--- PASS: TestScheduleWatchWorkflowRun (0.00s)
=== RUN   TestGetTaskHandlers_IncludesWatchWorkflowRun
--- PASS: TestGetTaskHandlers_IncludesWatchWorkflowRun (0.00s)

Notes

• gh run watch replaces polling only for CI/workflow runs. Periodic polling is still needed for:
  • PR reviews and comments
  • Merge conflict detection
  • New runs triggered by subsequent pushes

🤖 Generated with Claude Code