Download the PHP package noir4y/laravel-root-cause without Composer
On this page you can find all versions of the php package noir4y/laravel-root-cause. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download noir4y/laravel-root-cause
More information about noir4y/laravel-root-cause
Files in noir4y/laravel-root-cause
Package laravel-root-cause
Short Description Deterministic root-cause diagnostics for Laravel applications.
License MIT
Homepage https://github.com/noir4y/laravel-root-cause
Informations about the package laravel-root-cause
Laravel Root Cause
Deterministic root-cause diagnostics for Laravel failures.
Laravel Root Cause turns requests, validation failures, exceptions, and query pathologies into reproducible diagnoses with structured JSON output. It is built for cases where you want a deterministic answer, not a generic observability dashboard.
Why This Exists
Telescope is broad observability. Debugbar is a local debugging UI. Ray is a workflow-friendly inspector. Laravel Root Cause is narrower: it classifies the failure, explains why it matched, and exports AI-consumable JSON with candidate fixes.
| Tool | Best for | Output |
|---|---|---|
| Telescope | Wide framework observability | UI-heavy trace inspection |
| Debugbar | Local page-level debugging | Browser overlay and debug panels |
| Ray | Fast feedback in your workflow | Interactive developer console |
| Laravel Root Cause | Deterministic diagnosis of a failing request | CLI summary + structured JSON |
Try It In 3 Minutes
The package auto-registers request collection for the web and api groups by default. Collection is enabled automatically in APP_ENV=local and stays off elsewhere until you set ROOT_CAUSE_ENABLED=true. Traces are written to storage/app/root-cause.
For Users
If you are adopting the package in an application, start with the install and export flow in Try It In 3 Minutes.
Use these docs as the canonical follow-up:
- Quickstart for install and first diagnosis flow
- JSON contract for stable machine-readable fields
- Production safety for non-local environments
What The Output Looks Like
CLI diagnosis:
JSON export:
Screenshots:
Public Docs
- Quickstart
- JSON contract
- Production safety
- Validation failure incident
- Exception incident
- Query pathology incident
- v0.2.0 release notes
- Demo app:
examples/laravel12-demoIt reproduces the same incident classes locally; canonical snapshots live underdocs/incidents.
Commands
For Contributors
Optional Git hooks:
Local Git hooks live in .githooks/. Run composer hooks:install only if you want local commits to execute composer lint, composer analyse, and composer test before the commit is created.
Data Model
Each stored artifact is a TraceEnvelope containing:
- entrypoint metadata
- sanitized request context
- normalized signals
- a deterministic
DiagnosisReport
The JSON export compatibility policy for downstream tooling is documented in JSON contract.
All versions of laravel-root-cause with dependencies
illuminate/console Version ^11.0|^12.0
illuminate/contracts Version ^11.0|^12.0
illuminate/database Version ^11.0|^12.0
illuminate/http Version ^11.0|^12.0
illuminate/support Version ^11.0|^12.0
illuminate/validation Version ^11.0|^12.0