chore: release main

[ryanrozich]

Summary

Catalyst 8.2.0 introduces event-driven workflows with the new catalyst-filter daemon for intelligent event routing using Groq-powered semantic filtering. This release transforms the plugin ecosystem from polling-based operations to reactive, real-time processing of GitHub and Linear events.

What's New

• catalyst-filter daemon: New Groq-powered semantic event routing system that intelligently filters and routes events to the appropriate workers, eliminating the need for constant polling
• Bidirectional worker communication: Workers can now read inbound messages at phase boundaries, enabling real-time coordination between different parts of your workflow
• Event-driven monitoring: The orch-monitor now provides a real-time activity feed showing the global event stream across your development workflow
• wait-for-github skill: New two-phase event waiting system with diagnostic checkpoints that replaces inefficient polling loops in PR creation and merging
• Linear webhook integration: Full end-to-end webhook delivery from Linear via smee.io, enabling reactive responses to issue updates
• Heartbeat watchdog: Built-in worker health monitoring in the filter daemon that detects stalled processes without requiring LLM inference
• Webhook tunnel status: The catalyst-monitor status --json command now exposes webhook tunnel state for better debugging
• Auto-recovery for git conflicts: The orchestrator now automatically recovers from DIRTY merge states
• Persistent event subscriptions: Multi-event PR lifecycle subscriptions that maintain state across worker restarts
• Enhanced documentation: New event schema reference documentation derived from TypeScript types and SKILL.md protocol documentation for orchestrators

Bug Fixes

• Fixed missing catalyst-events and catalyst-filter in CLI installation scripts
• Corrected webhook tunnel field names and added missing smee-client dependency
• Updated fixup/followup templates to use the proper exit-at-merging contract
• Fixed worker directory fallback handling in orchestrate-fixup/followup scripts
• Improved scope-aware monitoring with better filtering and warning messages
• Added proper GitHub webhook verification to configuration templates
• Enhanced setup prerequisite checks for event-driven pipeline requirements

---

Conventional Changelog (auto-generated)

🤖 I have created a release beep boop

catalyst-dev: 8.2.0

8.2.0 (2026-05-06)

Features

• dev: add catalyst-filter to plugin install scripts (CTL-259) (#423) (20b7807)
• dev: bidirectional comms — workers read inbound messages at phase boundaries (CTL-249) (#403) (79aa258)
• dev: catalyst-filter daemon — Groq-powered semantic event routing (CTL-256) (#421) (ceeb0ee)
• dev: event-schema reference doc — derive from TypeScript types so agents don't guess field names (#430) (e0b0821)
• dev: expose webhookTunnel state in catalyst-monitor status --json (CTL-244) (#398) (643055d)
• dev: heartbeat watchdog in filter daemon — detect stalled workers without LLM (CTL-261) (#428) (c8e337b)
• dev: Linear issue events → filter daemon wake via bot-skip suppression (CTL-263) (#426) (a2bd391)
• dev: orch-monitor activity feed for global event stream (CTL-225) (#358) (db72cf7)
• dev: orch-monitor daemon liveness check as skill prerequisite (CTL-223) (#356) (7e906ce)
• dev: orch-monitor version drift self-check on startup (CTL-237) (#381) (ab2edcf)
• dev: orchestrate Phase 4 — event-driven Monitor + catalyst-events tail (CTL-243) (#378) (7f3e728)
• dev: orchestrator DIRTY merge auto-recovery (CTL-232) (#386) (59222b6)
• dev: persist Linear webhook registration to Layer 2 (CTL-238) (#382) (a730499)
• dev: persistent interests + explicit deregistration in filter daemon (CTL-262) (#425) (d0ac7d9)
• dev: reactive multi-event PR lifecycle subscription (CTL-228) (#379) (e407c24)
• dev: SKILL.md for catalyst-filter — protocol docs for orchestrators (CTL-258) (#422) (e42a4ac)
• dev: wait-for-github diagnostic checkpoint — update callers to two-phase pattern (CTL-251) (#404) (e03f455)
• dev: wait-for-github skill — two-phase event wait with diagnostic checkpoint (CTL-247) (7738683)
• dev: wire catalyst-filter into orchestrate Phase 4 (CTL-257) (#424) (43e36ff)
• dev: wire Linear webhook delivery via smee.io end-to-end (CTL-242) (#396) (e58ae5f)
• dev: worker-status-change emitter — severity tiers, coalesce, PR enrichment (CTL-229) (#387) (682e817)

Bug Fixes

• dev: add monitor.* to config templates + verify GitHub webhook registration (CTL-254) (#409) (e09d077)
• dev: add wait-for-github and catalyst-filter to CLAUDE_SNIPPET.md (CTL-268) (0b1adc4)
• dev: add worker done comms hook to oneshot Phase 5 (CTL-236) (#388) (a8d4030)
• dev: correct webhookTunnel field and add smee-client dependency (#435) (10edb77)
• dev: install-cli.sh adds catalyst-events + defaults to ~/.local/bin (CTL-227) (#357) (5dfa3ac)
• dev: make orchestrate-roll-usage.sh observable (CTL-233) (#380) (b61941d)
• dev: orchestrate-fixup/followup WORKER_DIR fallback (CTL-231) (#377) (9386849)
• dev: render DASHBOARD.md every Phase 4 cycle (CTL-230) (#385) (a618055)
• dev: replace polling loops in merge-pr and create-pr with wait-for-github (CTL-250) (#402) (96ab764)
• dev: scope-aware Monitor filter + no-awk-pipe warning (CTL-240) (#390) (7efc119)
• dev: stamp orchestrator on github.* webhook events (CTL-234) (#391) (56083c9)
• dev: update fixup/followup templates to CTL-133 exit-at-merging contract (CTL-248) (#401) (2454b19)
• dev: upgrade setup prereq checks for event-driven pipeline (CTL-253) (#408) (2d7b8bf)

---

This PR was generated with Release Please. See documentation.

[cloudflare-workers-and-pages]

Deploying catalyst with    Cloudflare Pages

Latest commit:	48fded5
Status:	✅  Deploy successful!
Preview URL:	https://a46e79cf.catalyst-7jq.pages.dev
Branch Preview URL:	https://release-please--branches--ma-2wi2.catalyst-7jq.pages.dev

View logs

[ryanrozich]

🤖 Created releases:

• catalyst-dev-v8.2.0

🌻