feat: Trigger Lagoon Deployments for App Instances

[dan2k3k4]

Introduces the ability to trigger Lagoon deployments for Polydock App Instances directly from the Polydock Engine.

Adds two new Artisan commands for bulk or single-instance deployments and integrates a "Trigger Deploy" action into the Filament Admin UI.

Key Changes

1. New Console Commands
   • polydock:instances:run-lagoon-command:
     • Method: Uses the Lagoon GraphQL API (via FreedomtechHosting\FtLagoonPhp\Client).
     • Features:
       • Supports concurrency (default: 1) for faster bulk operations.
       • Includes a --variables-only flag for env var updates without full rebuilds.
       • Interactive mode allows selecting specific instances from a list (unless --force is used).
       • Handles authentication via SSH key exchange for Lagoon tokens.
   • polydock:instances:trigger-deploy:
     • Method: Wrapper around the system's lagoon CLI tool.
     • Features: Simple execution of lagoon deploy -p [project] -e [branch] for running instances.
2. Admin UI Updates
   • ViewPolydockAppInstance:
     • Added a Trigger Deploy header action.
     • Displays a modal confirming the branch and showing the "Last Deployment Date".
     • Executes the deployment via the local lagoon CLI.
3. Model Updates
   • PolydockAppInstance: Added getName() and setName() convenience methods.
   4. Testing
   • Added tests/Feature/Console/Commands/RunLagoonCommandOnAppInstancesTest.php covering:
     • Serial vs. Concurrent execution.
     • Variable-only deployments.
     • Error handling for missing metadata.
     • Interactive prompts.

How to Test

CLI (API-based):

# Dry run / Interactive selection
php artisan polydock:instances:run-lagoon-command {app_uuid}

# Force run on all instances concurrently
php artisan polydock:instances:run-lagoon-command {app_uuid} --force --concurrency=5

CLI (Lagoon CLI-based):
php artisan polydock:instances:trigger-deploy {app_uuid}

Admin UI:

1. Navigate to a Polydock App Instance view page.
2. Click the new Trigger Deploy button in the header.
3. Confirm the action in the modal.

[bomoko]

This should be done with the php library.