Skip to content
CAI
Software that uses CAICheck a score

laravel/horizon

41.5

Weak · 17 November 2026

10.8k

lines of production code

PHP

with JavaScript

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.