laravel/horizon
41.5
Weak · 17 November 2026
10.8k
lines of production code
PHP
with JavaScript
5
measurements over time
What this system is
Features
Added Horizon configuration skill with reference documentation
A new 'configuring-horizon' skill has been added to the Boost resources, providing structured guidance for installing, configuring, and troubleshooting Laravel Horizon. The skill covers the full lifecycle including supervisor setup, dashboard authorization, job tagging, and notification routing, and is supported by detailed reference documents for supervisors, metrics, notifications, and tags to help users resolve common issues like blank metrics dashboards and queue priority handling.
resources/boost · high confidence
Added Horizon service provider and default user for workbench
The workbench now includes a Horizon service provider that enables access to the Laravel Horizon dashboard by defining a permissive gate, and a database seeder that creates a default 'Laravel Horizon' user account to facilitate local testing and integration.
workbench · high confidence
Introduce Batches management screens
Added the Batches index and preview screens to the Horizon UI, allowing users to list, search, and paginate through job batches. The preview screen displays batch details (ID, name, queue, connection, timestamps, job counts) and provides a button to retry failed jobs within a batch. The implementation includes a polling component for real-time updates and handles batch statuses such as pending, finished, and cancelled.
resources/js/screens/batches · high confidence
Introduce dedicated Monitoring screens for tag-based job tracking
The Monitoring section now features a dedicated UI for managing and viewing jobs by tag. Users can add new tags via a modal, view a list of monitored tags with their job counts, and stop monitoring specific tags. Clicking a tag navigates to a detailed view that displays recent and failed jobs associated with that tag, including job names, queue information, timestamps, and runtime metrics. The interface supports pagination and periodic polling to refresh job data, with a 'Load New Entries' button appearing when new jobs arrive if auto-loading is disabled.
resources/js/screens/monitoring · high confidence
New Recent Jobs screen with Silenced support and Delayed visibility
The recent jobs interface has been restructured into a dedicated screen that lists Pending, Completed, and Silenced jobs. Users can now view Silenced jobs alongside other job types, and the job list and detail views display a 'Delayed' badge with human-readable timing for jobs that are pending or reserved. The job detail view also exposes the connection, batch ID, and tags, while the list view shows queued and completed timestamps and runtime for non-pending jobs.
resources/js/screens/recentJobs · high confidence
New UI components for alerts, charts, polling, and theme toggling
This change introduces five new Vue components in the frontend interface: Alert.vue provides a standardized modal for displaying messages and handling confirmations; LineChart.vue renders line graphs using Chart.js with specific formatting for Y-axis labels; Poll.vue implements a configurable polling mechanism that respects browser visibility states to optimize resource usage; SchemeToggler.vue allows users to switch between light, dark, and system color schemes, persisting the choice in localStorage; and Stacktrace.vue displays exception stack traces with a toggle to show all lines. These components collectively enhance the user interface's interactivity, data visualization, and accessibility features.
resources/js/components · high confidence
New dashboard screen with polling and stats display
A new dashboard screen has been added to the application, providing an overview of job metrics including jobs per minute, recent jobs, and failed jobs. The component utilizes a new Poll component to refresh statistics every 5 seconds and displays the current system status (running or paused) with appropriate icons. It also fetches and displays worker master information and workload data via API calls.
resources/js/screens · high confidence
New job lifecycle events and enhanced supervisor memory tracking
This update introduces new event classes to provide finer-grained visibility into job and supervisor states. A new \JobPending\ event is added to signal when a job is pushed to the queue, allowing metadata to be captured before workers pick it up. The \SupervisorOutOfMemory\ event now includes a \memoryUsage\ property and methods to record and retrieve the specific memory consumption that triggered the event, while a new \MasterSupervisorOutOfMemory\ event tracks memory issues at the master level. Additionally, the \JobReleased\ event now exposes a \delay\ property, informing users when a job is scheduled for future execution rather than immediate processing.
src/Events · high confidence
Removals
Removal of bundled public JavaScript assets
The bundled \public/js/app.js\ file, which previously included the Moment.js library and application logic, has been deleted. This change indicates that the frontend assets are no longer served from this specific location, likely due to a shift in the build pipeline or asset management strategy.
public/js · high confidence
Removal of legacy Line chart component
The \Line.js\ component within the \BaseCharts\ directory has been removed from the codebase. This file previously defined a Vue-based line chart implementation using Chart.js, including specific default options for Y-axis scaling and X-axis label formatting, as well as a lifecycle hook for chart cleanup. Its deletion indicates that this specific chart type is no longer supported or has been replaced by a different implementation elsewhere in the application.
resources/assets/js/components/Charts/BaseCharts · high confidence
Removal of legacy Vue.js frontend assets
The entire legacy Vue.js frontend codebase located in resources/assets/js has been removed. This includes the main application entry point (app.js), the root App component, and all associated sub-components such as charts, modals, panels, and page views (Dashboard, Failed Jobs, Metrics, Monitoring, Recent Jobs). This change eliminates the previous client-side rendering layer for the Horizon dashboard.
resources/assets/js · high confidence
Behavioural changes
Add mail notifications and update Slack formatting for long wait alerts
The LongWaitDetected notification now supports email delivery when the Horizon email configuration is set, providing an additional channel for users to be alerted about queue backlogs. The Slack notification format has been updated to use the newer Block Kit API for Laravel 11 compatibility while maintaining fallback support for older versions, and the notification body now includes the application name for better context. Additionally, internal property names for connection and queue have been prefixed with 'longWait' to improve clarity and avoid potential naming conflicts.
src/Notifications · high confidence
Complete UI theme overhaul with new color system and dark mode
The application's visual appearance has been significantly updated with a fresh design language. A new centralized color palette (defining gray, red, amber, emerald, blue, and violet scales) has been introduced to standardize styling. This supports a new dark mode theme alongside the existing light mode, allowing users to switch between distinct visual themes. The UI components, including the sidebar, cards, tables, and buttons, have been restyled with updated typography (Figtree font), border radii, and spacing to match the new aesthetic.
resources/sass · high confidence
Expanded Horizon configuration with new environment and operational settings
The Horizon configuration file has been significantly expanded to support new operational features. Users can now configure the Horizon instance name, domain, and path via environment variables. A configurable Redis prefix is added to support multiple Horizon installations on the same server. New settings allow for job trimming times, silencing specific jobs or tags from the completed list, and configuring metrics snapshot retention. Additionally, fast termination for deployments, memory limits, and detailed default supervisor settings (including balance strategy, scaling strategy, and process limits) are now exposed in the config.
config · high confidence
Expanded job status tracking and repository contract updates
The Horizon contracts now support tracking additional job states—pending, completed, and silenced—by adding corresponding retrieval and counting methods to the JobRepository interface. New interfaces, LongWaitDetectedNotification and Silenced, have been introduced to support notification overrides and silenced job handling. Repository contracts for supervisors, master supervisors, and metrics have been updated to include expiration flushing (flushExpired) and metrics clearing (clear), while the WorkloadRepository return type is now explicitly defined to improve type safety.
src/Contracts · high confidence
Failed Jobs screen displays retry history, connection details, and exception context
The Failed Jobs interface now provides deeper visibility into job failures and retry attempts. The job detail view includes a dedicated 'Connection' field and displays the number of 'Retries' alongside the original 'Attempts'. For jobs that have been retried, the interface shows the ID of the original job and links to its batch if applicable. Additionally, the view now renders the full exception stack trace and the exception context as formatted JSON, helping users diagnose failures more effectively.
resources/js/screens/failedJobs · high confidence
Horizon 5.x: Signal handling, auto-scaling, and configuration overhaul
This release introduces Horizon 5.x with significant behavioral changes. Process management now uses a new \ListensForSignals\ trait for graceful termination, restart, and pause/resume operations, and supports non-standard PHP binaries via the \PhpBinary\ class. The auto-scaler (\AutoScaler\) has been rewritten to support logarithmic scaling strategies, configurable max-shift limits, and explicit balancing modes that show workload per queue even when balancing is disabled. Configuration is now centralized in a published \horizon.php\ file with support for default environment options, custom route domains/paths, CSP nonces, and Redis cluster support. The event system has been updated to include a \JobPending\ event for pre-push metadata, and jobs can now be silenced via configuration or the \Silenced\ interface. Additionally, the dashboard supports dark mode, and the \horizon:purge\ command has been optimized to prevent excessive process kills.
src · high confidence
Horizon API refactored to return JSON arrays and support batch operations
The Horizon HTTP controllers have been refactored to return structured JSON arrays instead of HTTP responses, enabling a more consistent API for the frontend. This change introduces new controllers for managing job batches (BatchesController) and silenced jobs (SilencedJobsController), while renaming RecentJobsController to CompletedJobsController to better reflect its purpose. The DashboardStatsController now exposes paused master counts and configurable time periods for metrics. Additionally, the MasterSupervisorController has been updated to display inactive supervisors defined in the provisioning plan, and the FailedJobsController now includes exception context and properly sorts retry history.
src/Http/Controllers · high confidence
Horizon console commands refactored and expanded with new management capabilities
The \src/Console\ directory has been significantly updated to modernize command structure and add new operational features. New commands have been introduced: \horizon:install\ for scaffolding, \horizon:listen\ for file-watching auto-restarts, \horizon:clear\ and \horizon:clear-metrics\ for queue and metric management, \horizon:forget\ for deleting failed jobs, and \horizon:status\/\horizon:supervisor-status\ for monitoring. Supervisor control is now granular with \horizon:pause-supervisor\ and \horizon:continue-supervisor\. The \horizon:publish\ command is deprecated in favor of \horizon:install\. Existing commands like \horizon:work\, \horizon:supervisor\, \horizon:purge\, \horizon:terminate\, \horizon:pause\, and \horizon:continue\ have been refactored to use dependency injection, support new options (such as \--backoff\, \--max-jobs\, \--max-time\, \--nice\, \--json\, \--signal\), and provide improved error reporting and output formatting.
src/Console · high confidence
Horizon dashboard receives a major UI overhaul with new navigation and layout
The Horizon dashboard has been completely redesigned with a new layout structure, replacing the previous single-page app wrapper with a dedicated sidebar navigation. This update introduces new navigation items for 'Batches', 'Completed Jobs', and 'Silenced Jobs', alongside the existing Dashboard, Monitoring, Metrics, Pending Jobs, and Failed Jobs. The visual style has been updated to use the Figtree font and Bootstrap 5 utility classes, and the application title now dynamically includes the configured Horizon instance name. A maintenance mode warning banner is also displayed when the application is down for maintenance.
resources/views · high confidence
Listeners refactor: configurable trimming, memory monitoring, and job lifecycle updates
This change updates the listener components in src/Listeners to improve resource management and observability. Trimming for failed, recent, and monitored jobs is now configurable via horizon config (trim.failed, trim.monitored) and uses CarbonImmutable instead of Chronos. Memory monitoring for supervisors and the master supervisor now respects the horizon.memory\_limit config and emits specific OutOfMemory events with usage details. Job lifecycle listeners were updated to handle the new JobPending event, track job silencing status, record job delay, and ensure timers are forgotten on failure or completion. Wait time monitoring now uses a Redis lock to prevent race conditions and respects per-queue wait thresholds. Notifications now support email routes, and docblocks were standardized to use fully qualified class names.
src/Listeners · high confidence
Metrics screens refactored with unified loading states and base path support
The Metrics screens (Jobs, Queues, and Preview) have been restructured to use a consistent loading indicator and a new \Horizon.basePath\ configuration for API requests. The Jobs and Queues views now display a spinner while data loads and show a simple text message when no items are found, replacing the previous custom message component. Additionally, navigation links in these views have been updated to point to the new \metrics-preview\ route, which displays throughput and runtime charts for the selected item.
resources/js/screens/metrics · high confidence
Migrate Horizon frontend to Vue 3 and Vite
The Horizon JavaScript frontend has been upgraded from Vue 2 to Vue 3, utilizing the Composition API via \createApp\ and \vue-router\ for navigation. This change includes a shift in the asset build toolchain to Vite, replacing the previous Laravel Mix setup. The application now uses \axios\ for HTTP requests with CSRF token handling, integrates \vue-json-pretty\ for JSON visualization, and supports dynamic theming via a \SchemeToggler\ component. Routing is now explicitly defined in \routes.js\, supporting dashboard, monitoring, metrics, recent jobs, failed jobs, and batches screens.
resources/js · high confidence
New ForbiddenException for unauthorized access
A new ForbiddenException class has been added to the exceptions namespace, extending Symfony's HttpException to return a 403 status code. This provides a specific exception type for handling unauthorized access scenarios within the application.
src/Exceptions · high confidence
New file-watcher utility with improved wildcard extension handling
A new bin/file-watcher.cjs script has been added to provide file system monitoring capabilities using the chokidar library. This utility now includes improved logic for extracting file extensions from wildcard patterns (e.g., \*.php), ensuring correct filtering behavior. It also detects the installed chokidar version and adapts its configuration accordingly, specifically handling the removal of glob support in chokidar version 4 by manually filtering paths based on the extracted extensions.
bin · high confidence
PHP 8.1+ constructor property promotion and improved job retry timeout handling
Jobs in the src/Jobs directory now use PHP 8.1 promoted properties, removing explicit property declarations and constructors for MonitorTag, RetryFailedJob, and StopMonitoringTag. RetryFailedJob has been updated to use Carbon for calculating retry timeouts, ensuring the retryUntil value is correctly preserved when jobs are retried. Additionally, StopMonitoringTag now uses pagination to delete monitored jobs, improving performance for tags with many associated jobs.
src/Jobs · high confidence
Project configuration and asset build tooling overhaul
The repository has been restructured with several new configuration files and a migration of the asset build system. A new \.editorconfig\ enforces consistent coding styles (UTF-8, LF, 4-space indentation), while \.gitattributes\ and \.npmrc\ configure Git diff drivers and npm behavior. The asset build pipeline has switched from Gulp/Laravel Elixir to Vite, evidenced by the new \vite.config.js\ and the deletion of \gulpfile.js\. Additionally, the PHPUnit configuration has been renamed from \phpunit.xml\ to \phpunit.xml.dist\ to follow best practices, and a \phpstan.neon.dist\ file has been added for static analysis. Documentation files like \README.md\ and \UPGRADE.md\ have also been standardized.
(repo-wide) · high confidence
Removal of legacy LESS stylesheet system
The entire legacy LESS stylesheet system has been removed from the application. This includes the main entry point (app.less) and all associated component, helper, object, and settings files (such as buttons, modals, panels, typography, and color definitions). As a result, the custom UI styles defined in these files are no longer applied, which will likely cause the interface to revert to default browser styles or rely on stylesheets provided by other systems.
resources/assets/less · high confidence
Removal of legacy public CSS assets
The \public/css/app.css\ stylesheet and its corresponding source map (\app.css.map\) have been deleted from the repository. This change removes the compiled CSS bundle and its debugging metadata from the public-facing assets, indicating a shift in how styles are served or managed in the application.
public/css · high confidence
Reworked API routes with prefixing, naming, and new endpoints
The API routes in web.php have been restructured to use a common 'api' prefix, simplifying URL paths (e.g., '/api/stats' becomes '/stats' within the group). All API endpoints are now assigned explicit named routes (e.g., 'horizon.stats.index'), which improves URL generation and consistency. Additionally, new endpoints have been added to support batch management ('/batches') and viewing specific job statuses like pending, completed, and silenced jobs, while the catch-all route for the frontend view has been updated to be optional and named.
routes · high confidence
Support block\_for and after\_commit queue configuration options
The Redis connector now passes the 'block\_for' and 'after\_commit' configuration parameters to the underlying Redis queue. These options default to null, allowing users to configure blocking behavior and commit handling for Redis-based queues without requiring code changes.
src/Connectors · high confidence
Throws ForbiddenException on unauthorized access
The Authenticate middleware now throws a Laravel\\Horizon\\Exceptions\\ForbiddenException when Horizon::check() returns false, replacing the previous behavior of calling abort(403). This change ensures that unauthorized access attempts are handled via a specific exception rather than a generic HTTP 403 response.
src/Http/Middleware · high confidence
Unified Redis connections and configurable job expiration in repositories
The repository layer now consolidates Redis access to use the default 'horizon' connection instead of separate connections for supervisors, processes, tags, and metrics, simplifying configuration. Additionally, job retention is now configurable via the horizon config file (e.g., horizon.trim.recent, horizon.trim.completed), allowing users to control how long recent, pending, completed, failed, and monitored jobs are stored in Redis. The repositories also introduce support for Redis Cluster by using a cluster-aware pipeline that falls back to transactions when necessary, and switch from Chronos to Carbon for time handling.
src/Repositories · high confidence
Updated Horizon service provider stub with explicit null default for user parameter
The Horizon service provider stub now defines the \viewHorizon\ gate closure with an explicit \$user = null\ default value. This change improves developer experience by ensuring the gate function signature is robust against null inputs, preventing potential errors when the user context is not immediately available during gate evaluation.
stubs · high confidence
Updated frontend assets with new tree component styles and dependency upgrades
The distributed CSS and JavaScript bundles have been regenerated to include styles for the new Poll component (specifically \.vjs-tree-brackets\ and \.vjs-check-controller\ classes) and to reflect underlying dependency updates. The JavaScript bundle now includes Axios v1.20.0, which introduces changes to request handling and error codes, alongside Vue shared utilities v3.5.4. These changes standardize polling behavior in the UI and update the HTTP client library used for network requests.
dist · high confidence
Fixes
Fixes Symfony Process instantiation and default working directory
The AddSupervisor command now uses Process::fromShellCommandline instead of the direct constructor to create Symfony Process instances, addressing deprecated process calls. Additionally, the default working directory for new supervisors is corrected to base\_path() when the options directory is not explicitly set, ensuring processes start in the expected location.
src/MasterSupervisorCommands · high confidence
Test coverage
Added test fixtures for event listeners, jobs, and supervisors; Added tests for job completion and tag storage listeners; Added unit tests for Redis metrics repository and updated test assertions; Expanded controller test coverage for Horizon API endpoints; Expanded test coverage for Horizon features; Test infrastructure modernization and Redis Cluster support; Updated test fakes for pool scaling and exception handling.
Dependencies
Major dependency upgrades and build system migration
This release upgrades the project to PHP 8.0+ and Laravel 9–13, replacing the legacy CakePHP Chronos library with nesbot/carbon and updating the Ramsey UUID package to v4. The frontend build system has migrated from Gulp/Laravel Elixir to Vite, which includes upgrading Vue from v2 to v3, Bootstrap to v5.1, and Axios to v1.20+. Additionally, the composer.json now requires POSIX and PCNTL extensions, and the package now registers a Horizon facade alias.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 42.4 → 41.5 (-0.9)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 47.0 → 41.3 (-5.7)
- Architecture 71.1 → 73.7 (+2.6)
- Maturity 56.3 → 56.5 (+0.2)
- Readiness 52.0 → 51.1 (-0.9)
- Security 83.2 → 84.6 (+1.4)
- Accessibility 29.9 → 31.1 (+1.2)
Resolved (5)
- Further sole-owners (lower concentration)
- High secret: WD-SECRET-0005 (package-lock.json)
- Off-boarding risk: anonymized user #1
- Projects may be oversized for their cohesion
- Rotate the exposed credentials — git history can't be un-committed
New (12)
- Circular dependency (src/HorizonServiceProvider.php)
- Edited copies of one member (3 members, 17+ corresponding lines) (src/Repositories/RedisJobRepository.php)
- Edited copies of one member (3 members, 18+ corresponding lines) (src/Console/ContinueCommand.php)
- Edited copies of one member (3 members, 9+ corresponding lines) (src/Listeners/TrimFailedJobs.php)
- Edited copy of a member (15 corresponding lines) (src/MasterSupervisor.php)
- Edited copy of a member (16 corresponding lines) (src/Console/ContinueSupervisorCommand.php)
- Edited copy of a member (22 corresponding lines) (src/Repositories/RedisMasterSupervisorRepository.php)
- Edited copy of a member (3 corresponding lines) (src/MasterSupervisor.php)
- Edited copy of a member (4 corresponding lines) (src/Http/Controllers/FailedJobsController.php)
- Edited copy of a member (7 corresponding lines) (src/Repositories/RedisMetricsRepository.php)
- Off the main sequence: src/Exceptions
- Off-boarding risk: anonymized user #1
Changes since last survey
- 6 commits — 5 feature/other, 1 fixes
By area
- (root) — 4 commits
- (repo) — 1 commit
- dist/app.css — 1 commit
Notable commits
- fix: Merge pull request #1850 from mchlbowyer/fix-vite-8-assets
- change: Compile Assets
- change: Dependency floor bump
- change: Merge pull request #1848 from laravel/dependency-floor-bump
- change: Update CHANGELOG
- change: Update CHANGELOG
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
laravel/horizon was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit b86d5aa87ca474db352ea2668bdd1df3a90bf8aa — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.