Trace-Replay

The Shift Toward Granular Request Tracking Debugging in Laravel has long been dominated by staples like Laravel Debugbar and Telescope, yet Trace-Replay introduces a distinct philosophy. Created by Ismile Azaran, this package functions less like a simple log and more like a flight recorder for your application. It excels at capturing the sequential flow of Livewire updates and HTTP requests, offering a dashboard that organizes complex processes into digestible timelines. While competitors provide a snapshot of state, Trace-Replay focuses on the journey of the data through your stack. Prerequisites and Integration To get started, you should have a solid grasp of Laravel architecture and modern frontend integration via Livewire. The package is designed for local development environments and aims to replace or augment existing debuggers. You will need a working Laravel 10 or 11 installation to utilize the tracing functions effectively. Essential Debugging APIs * **Trace-Replay**: The core package providing the dashboard and interceptors. * **OpenAI / Anthropic**: Optional drivers for automated error fixing. * **Ollama**: Local AI integration for privacy-focused debugging. Strategic Tracing in the Codebase Unlike Telescope, which often acts as a passive observer, Trace-Replay allows you to define explicit "checkpoints" within your logic. By using the following syntax pattern, you can isolate specific segments of a controller or component: ```php // Define the start of a logical process trace_replay_start('Booking Process', ['user_id' => $user->id]); // Perform sub-tasks trace_replay_step('Validating Slot'); // Finalize the trace trace_replay_end('Success'); ``` These tags allow the dashboard to group SQL queries and payloads under specific headers, making it infinitely easier to find which exact line of code triggered a problematic database call. AI-Driven Recovery and Replays The standout feature is the **Replay** button. When a request fails, you can modify your code and hit replay directly from the dashboard to compare the original 500 error with the new response. If the solution isn't obvious, the AI Fix Prompt generates a markdown-formatted context block optimized for LLMs like ChatGPT or Claude. It sends just enough metadata to provide a solution without bloating the token count, a significant efficiency gain over manual copy-pasting. Tips and Debugging Best Practices Always remember that Trace-Replay is a development tool; do not ship these trace functions to production. If you are seeing empty dashboards, ensure your local environment is correctly configured to log HTTP requests. For those who value privacy, hooking into Ollama allows you to use the AI fix features without your source code ever leaving your local machine.