Update Laravel Automations documentation with detailed environment variables and database connection checks

Author: jaydrogers

docs/content/docs/4.laravel/1.laravel-automations.md

@@ -13,15 +13,26 @@ layout: docs
 In order for this script to run,`AUTORUN_ENABLED` must be set to `true`. Once the main part of the script is enabled, you can control the individual tasks by setting the corresponding environment variables to `true` or `false`. See our [variable reference document](/docs/reference/environment-variable-specification) for more details.
 ::
 
-| Environment Variable | Laravel Command | Description |
+| Environment Variable | Default | Description |
 | -------------------- | -------------- | ----------- |
-| `AUTORUN_LARAVEL_STORAGE_LINK` | `php artisan storage:link` | Creates a symbolic link from `public/storage` to `storage/app/public`. |
-| `AUTORUN_LARAVEL_MIGRATION` | `php artisan migrate` | Runs migrations. |
-| `AUTORUN_LARAVEL_OPTIMIZE` | `php artisan optimize` | Optimizes the application. |
-| `AUTORUN_LARAVEL_CONFIG_CACHE` | `php artisan config:cache` | Caches the configuration files into a single file. |
-| `AUTORUN_LARAVEL_ROUTE_CACHE` | `php artisan route:cache` | Caches the routes. |
-| `AUTORUN_LARAVEL_VIEW_CACHE` | `php artisan view:cache` | Caches the views. |
-| `AUTORUN_LARAVEL_EVENT_CACHE` | `php artisan event:cache` | Creates a manifest of all your application's events and listeners. |
+| `AUTORUN_ENABLED` | `false` | Enables the Laravel Automations script. <br> **ℹ️ Note:** This must be set to `true` for the script to run. |
+| `AUTORUN_DEBUG` | `false` | Enables a special debug mode, specifically for the Laravel Automations script. |
+| `AUTORUN_LARAVEL_CONFIG_CACHE` | `true` | `php artisan config:cache`: Caches the configuration files into a single file. |
+| `AUTORUN_LARAVEL_EVENT_CACHE` | `true` | `php artisan event:cache`: Creates a manifest of all your application's events and listeners. |
+| `AUTORUN_LARAVEL_MIGRATION` | `true` | `php artisan migrate`: Runs migrations. |
+| `AUTORUN_LARAVEL_MIGRATION_ISOLATION` | `false` | Run your migrations with the [`--isolated`](https://laravel.com/docs/12.x/migrations#running-migrations) flag. <br> **ℹ️ Note:** Requires Laravel v9.38.0+ |
+| `AUTORUN_LARAVEL_MIGRATION_TIMEOUT` | `30` | Number of seconds to wait for database connection before timing out during migrations. |
+| `AUTORUN_LARAVEL_OPTIMIZE` | `true` | `php artisan optimize`: Optimizes the application. |
+| `AUTORUN_LARAVEL_ROUTE_CACHE` | `true` | `php artisan route:cache`: Caches the routes. |
+| `AUTORUN_LARAVEL_STORAGE_LINK` | `true` | `php artisan storage:link`: Creates a symbolic link from `public/storage` to `storage/app/public`. |
+| `AUTORUN_LARAVEL_VIEW_CACHE` | `true` | `php artisan view:cache`: Caches the views. |
+
+## Database Connection Checks
+Before running migrations, the script performs database connection checks to ensure the database is ready. It will:
+- Clear the Laravel configuration cache before attempting migrations
+- Try to connect to the database for up to `AUTORUN_LARAVEL_MIGRATION_TIMEOUT` seconds (default: 30)
+- Automatically detect and handle SQLite databases differently
+- Show detailed connection attempts when `AUTORUN_DEBUG` is enabled
 
 ## php artisan storage:link
 Creates a symbolic link from `public/storage` to `storage/app/public`.