feat: add validation for YAML parsing, integer parameters, and Docker Compose custom fields

This commit adds comprehensive validation improvements and DRY principles for handling Coolify's custom Docker Compose extensions.

## Changes

### 1. Created Reusable stripCoolifyCustomFields() Function
- Added shared helper in bootstrap/helpers/docker.php
- Removes all Coolify custom fields (exclude_from_hc, content, isDirectory, is_directory)
- Handles both long syntax (arrays) and short syntax (strings) for volumes
- Well-documented with comprehensive docblock
- Follows DRY principle for consistent field stripping

### 2. Fixed Docker Compose Modal Validation
- Updated validateComposeFile() to use stripCoolifyCustomFields()
- Now removes ALL custom fields before Docker validation (previously only removed content)
- Fixes validation errors when using templates with custom fields (e.g., traccar.yaml)
- Users can now validate compose files with Coolify extensions in UI

### 3. Enhanced YAML Validation in CalculatesExcludedStatus
- Added proper exception handling with ParseException vs generic Exception
- Added structure validation (checks if parsed result and services are arrays)
- Comprehensive logging with context (error message, line number, snippet)
- Maintains safe fallback behavior (returns empty collection on error)

### 4. Added Integer Validation to ContainerStatusAggregator
- Validates maxRestartCount parameter in both aggregateFromStrings() and aggregateFromContainers()
- Corrects negative values to 0 with warning log
- Logs warnings for suspiciously high values (> 1000)
- Prevents logic errors in crash loop detection

### 5. Comprehensive Unit Tests
- tests/Unit/StripCoolifyCustomFieldsTest.php (NEW) - 9 tests, 43 assertions
- tests/Unit/ContainerStatusAggregatorTest.php - Added 6 tests for integer validation
- tests/Unit/ExcludeFromHealthCheckTest.php - Added 4 tests for YAML validation
- All tests passing with proper Log facade mocking

### 6. Documentation
- Added comprehensive Docker Compose extensions documentation to .ai/core/deployment-architecture.md
- Documents all custom fields: exclude_from_hc, content, isDirectory/is_directory
- Includes examples, use cases, implementation details, and test references
- Updated .ai/README.md with navigation links to new documentation

## Benefits
- Better UX: Users can validate compose files with custom fields
- Better Debugging: Comprehensive logging for errors
- Better Code Quality: DRY principle with reusable validation
- Better Reliability: Prevents logic errors from invalid parameters
- Better Maintainability: Easy to add new custom fields in future

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

tests/Unit/ContainerStatusAggregatorTest.php

@@ -1,6 +1,7 @@
 <?php
 
 use App\Services\ContainerStatusAggregator;
+use Illuminate\Support\Facades\Log;
 
 beforeEach(function () {
     $this->aggregator = new ContainerStatusAggregator;
@@ -461,3 +462,79 @@ describe('state priority enforcement', function () {
         expect($result)->toBe('running:unknown');
     });
 });
+
+describe('maxRestartCount validation', function () {
+    test('negative maxRestartCount is corrected to 0 in aggregateFromStrings', function () {
+        // Mock the Log facade to avoid "facade root not set" error in unit tests
+        Log::shouldReceive('warning')->once();
+
+        $statuses = collect(['exited']);
+
+        // With negative value, should be treated as 0 (no restarts)
+        $result = $this->aggregator->aggregateFromStrings($statuses, maxRestartCount: -5);
+
+        // Should return exited:unhealthy (not degraded) since corrected to 0
+        expect($result)->toBe('exited:unhealthy');
+    });
+
+    test('negative maxRestartCount is corrected to 0 in aggregateFromContainers', function () {
+        // Mock the Log facade to avoid "facade root not set" error in unit tests
+        Log::shouldReceive('warning')->once();
+
+        $containers = collect([
+            [
+                'State' => [
+                    'Status' => 'exited',
+                    'ExitCode' => 1,
+                ],
+            ],
+        ]);
+
+        // With negative value, should be treated as 0 (no restarts)
+        $result = $this->aggregator->aggregateFromContainers($containers, maxRestartCount: -10);
+
+        // Should return exited:unhealthy (not degraded) since corrected to 0
+        expect($result)->toBe('exited:unhealthy');
+    });
+
+    test('zero maxRestartCount works correctly', function () {
+        $statuses = collect(['exited']);
+
+        $result = $this->aggregator->aggregateFromStrings($statuses, maxRestartCount: 0);
+
+        // Zero is valid default - no crash loop detection
+        expect($result)->toBe('exited:unhealthy');
+    });
+
+    test('positive maxRestartCount works correctly', function () {
+        $statuses = collect(['exited']);
+
+        $result = $this->aggregator->aggregateFromStrings($statuses, maxRestartCount: 5);
+
+        // Positive value enables crash loop detection
+        expect($result)->toBe('degraded:unhealthy');
+    });
+
+    test('crash loop detection still functions after validation', function () {
+        $statuses = collect(['exited']);
+
+        // Test with various positive restart counts
+        expect($this->aggregator->aggregateFromStrings($statuses, maxRestartCount: 1))
+            ->toBe('degraded:unhealthy');
+
+        expect($this->aggregator->aggregateFromStrings($statuses, maxRestartCount: 100))
+            ->toBe('degraded:unhealthy');
+
+        expect($this->aggregator->aggregateFromStrings($statuses, maxRestartCount: 999))
+            ->toBe('degraded:unhealthy');
+    });
+
+    test('default maxRestartCount parameter works', function () {
+        $statuses = collect(['exited']);
+
+        // Call without specifying maxRestartCount (should default to 0)
+        $result = $this->aggregator->aggregateFromStrings($statuses);
+
+        expect($result)->toBe('exited:unhealthy');
+    });
+});