feat: add Laravel Kick integration (#62)

* feat: add Laravel Kick integration

Integrate laravel-kick for enhanced application introspection. When an app
has KICK_TOKEN and KICK_ENABLED=true in its environment variables, a new
"Kick" tab appears in the dashboard showing:

- Health checks (database, cache, storage, redis)
- System stats (CPU, memory, disk, uptime)
- Log viewer with level filtering and search
- Queue status and failed jobs list
- Artisan command execution

Backend:
- KickClient: HTTP client for kick endpoints
- KickRepository: Contract for kick integration
- CoolifyKickRepository: Implementation that fetches config from Coolify
- KickController: API endpoints proxying to remote kick
- DashboardStatsController: Includes kick availability in stats

Frontend:
- Kick.vue: Full-featured page with tabs for all kick features
- Layout.vue: Conditionally shows Kick nav item
- api.js: Kick API methods

Configuration:
- coolify.kick.enabled: Toggle integration globally
- coolify.kick.cache_ttl: Cache config lookups
- coolify.kick.timeout: Request timeout

* docs: add Laravel Kick integration section to README

* fix: downgrade to Tailwind v3 for compatibility

* fix: migrate to Tailwind v4 properly

* ui: show app name and environment in Kick header

* test: add comprehensive tests for Kick integration

Add tests for KickClient, KickRepository, and KickController covering:
- Health, stats, logs, queue, and artisan endpoints
- Authentication and error handling
- Config retrieval from Coolify env vars
- Caching behavior

* fix: address PR review feedback for Kick integration

- Add logging to exception catch blocks instead of silent failures
- Catch specific exceptions (CoolifyApiException, KickApiException, etc.)
- Add path traversal validation in logRead endpoint
- Add clearCache() method to KickRepository interface
- Add declare(strict_types=1) to KickRepository interface
- Add rate limiting (10/min) to artisan execution endpoint
- Use onBeforeUnmount for guaranteed cleanup in Vue component
- Fix DashboardTest HTTP fake for kick config lookup

Author: StuMason

.github/workflows/claude-code-review.yml

@@ -41,7 +41,7 @@ jobs:
             - Potential bugs or issues
             - Performance considerations
             - Security concerns
-            - Test coverage
+            - Test coverage 
 
             Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
 

README.md

@@ -73,6 +73,28 @@ The dashboard shows everything at a glance:
 - Recent deployments with inline build logs
 - Quick actions for deploy, restart, stop
 
+### Laravel Kick Integration
+
+Install [laravel-kick](https://github.com/StuMason/laravel-kick) on your deployed app for enhanced introspection:
+
+```bash
+# On your deployed app
+composer require stumason/laravel-kick
+```
+
+Add to the app's Coolify environment:
+```
+KICK_ENABLED=true
+KICK_TOKEN=your-secure-token
+```
+
+A new **Kick** tab appears with:
+- Health checks (database, cache, storage, redis)
+- System stats (CPU, memory, disk, uptime)
+- Log viewer with filtering and search
+- Queue status and failed jobs
+- Artisan command execution
+
 ## Artisan Commands
 
 | Command | Description |

config/coolify.php

@@ -222,4 +222,32 @@
         ],
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Laravel Kick Integration
+    |--------------------------------------------------------------------------
+    |
+    | Enable integration with laravel-kick for enhanced application monitoring.
+    | When enabled, the dashboard will check if apps have KICK_TOKEN configured
+    | in their environment variables and display health, stats, logs, and
+    | queue information from the kick endpoints.
+    |
+    | For an application to show the Kick tab, it needs:
+    | - KICK_TOKEN=your_secret_token (in its Coolify environment variables)
+    | - KICK_ENABLED=true (in its Coolify environment variables)
+    | - Optionally: KICK_PREFIX=custom_path (defaults to 'kick')
+    |
+    */
+
+    'kick' => [
+        // Enable or disable kick integration globally
+        'enabled' => env('COOLIFY_KICK_ENABLED', true),
+
+        // How long to cache kick configuration lookups (seconds)
+        'cache_ttl' => env('COOLIFY_KICK_CACHE_TTL', 60),
+
+        // Timeout for kick API requests (seconds)
+        'timeout' => env('COOLIFY_KICK_TIMEOUT', 10),
+    ],
+
 ];