testbox-listeners

What problem does it solve?

Provides structured, event-driven hooks into TestBox test runs so you can monitor progress, capture failures, and react to lifecycle events without invasive changes to test suites or reporters.

Core Features & Use Cases

• Lifecycle Callbacks: Receive onBundleStart, onBundleEnd, onSuiteStart, onSuiteEnd, onSpecStart, and onSpecEnd events with detailed results structs for real-time reaction.
• Integrations & Reporting: Build progress bars, live dashboards, CI annotations, or custom loggers that respond to each spec or suite as it executes.
• Reusable Patterns: Use closures or class-based listeners to aggregate failures, profile timings, or emit external notifications (webhooks, Slack, observability systems).
• Use Case: Stream test run events to a CI pipeline to generate immediate GitHub Actions annotations for failing specs and a summary report at bundle end.

Quick Start

Use the testbox-listeners skill to capture onSpecEnd failures and emit GitHub Actions annotations in real time.