fix: preserve unknown health state and handle edge case container states

This commit fixes container health status aggregation to correctly handle
unknown health states and edge case container states across all resource types.

Changes:

1. **Preserve Unknown Health State**
   - Add three-way priority: unhealthy > unknown > healthy
   - Detect containers without healthchecks (null health) as unknown
   - Apply across GetContainersStatus, ComplexStatusCheck, and Service models

2. **Handle Edge Case Container States**
   - Add support for: created, starting, paused, dead, removing
   - Map to appropriate statuses: starting (unknown), paused (unknown), degraded (unhealthy)
   - Prevent containers in transitional states from showing incorrect status

3. **Add :excluded Suffix for Excluded Containers**
   - Parse exclude_from_hc flag from docker-compose YAML
   - Append :excluded suffix to individual container statuses
   - Skip :excluded containers in non-excluded aggregation sections
   - Strip :excluded suffix in excluded aggregation sections
   - Makes it clear in UI which containers are excluded from monitoring

Files Modified:
- app/Actions/Docker/GetContainersStatus.php
- app/Actions/Shared/ComplexStatusCheck.php
- app/Models/Service.php
- tests/Unit/ContainerHealthStatusTest.php

Tests: 18 passed (82 assertions)

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

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

app/Actions/Docker/GetContainersStatus.php

@@ -224,14 +224,40 @@ class GetContainersStatus
             if ($serviceLabelId) {
                 $subType = data_get($labels, 'coolify.service.subType');
                 $subId = data_get($labels, 'coolify.service.subId');
-                $service = $services->where('id', $serviceLabelId)->first();
-                if (! $service) {
+                $parentService = $services->where('id', $serviceLabelId)->first();
+                if (! $parentService) {
                     continue;
                 }
+
+                // Check if this container is excluded from health checks
+                $containerName = data_get($labels, 'com.docker.compose.service');
+                $isExcluded = false;
+                if ($containerName) {
+                    $dockerComposeRaw = data_get($parentService, 'docker_compose_raw');
+                    if ($dockerComposeRaw) {
+                        try {
+                            $dockerCompose = \Symfony\Component\Yaml\Yaml::parse($dockerComposeRaw);
+                            $serviceConfig = data_get($dockerCompose, "services.{$containerName}", []);
+                            $excludeFromHc = data_get($serviceConfig, 'exclude_from_hc', false);
+                            $restartPolicy = data_get($serviceConfig, 'restart', 'always');
+                            if ($excludeFromHc || $restartPolicy === 'no') {
+                                $isExcluded = true;
+                            }
+                        } catch (\Exception $e) {
+                            // If we can't parse, treat as not excluded
+                        }
+                    }
+                }
+
+                // Append :excluded suffix if container is excluded
+                if ($isExcluded) {
+                    $containerStatus = str_replace(')', ':excluded)', $containerStatus);
+                }
+
                 if ($subType === 'application') {
-                    $service = $service->applications()->where('id', $subId)->first();
+                    $service = $parentService->applications()->where('id', $subId)->first();
                 } else {
-                    $service = $service->databases()->where('id', $subId)->first();
+                    $service = $parentService->databases()->where('id', $subId)->first();
                 }
                 if ($service) {
                     $foundServices[] = "$service->id-$service->name";
@@ -461,7 +487,11 @@ class GetContainersStatus
         $hasRunning = false;
         $hasRestarting = false;
         $hasUnhealthy = false;
+        $hasUnknown = false;
         $hasExited = false;
+        $hasStarting = false;
+        $hasPaused = false;
+        $hasDead = false;
 
         foreach ($relevantStatuses as $status) {
             if (str($status)->contains('restarting')) {
@@ -471,9 +501,18 @@ class GetContainersStatus
                 if (str($status)->contains('unhealthy')) {
                     $hasUnhealthy = true;
                 }
+                if (str($status)->contains('unknown')) {
+                    $hasUnknown = true;
+                }
             } elseif (str($status)->contains('exited')) {
                 $hasExited = true;
                 $hasUnhealthy = true;
+            } elseif (str($status)->contains('created') || str($status)->contains('starting')) {
+                $hasStarting = true;
+            } elseif (str($status)->contains('paused')) {
+                $hasPaused = true;
+            } elseif (str($status)->contains('dead') || str($status)->contains('removing')) {
+                $hasDead = true;
             }
         }
 
@@ -491,7 +530,25 @@ class GetContainersStatus
         }
 
         if ($hasRunning) {
-            return $hasUnhealthy ? 'running (unhealthy)' : 'running (healthy)';
+            if ($hasUnhealthy) {
+                return 'running (unhealthy)';
+            } elseif ($hasUnknown) {
+                return 'running (unknown)';
+            } else {
+                return 'running (healthy)';
+            }
+        }
+
+        if ($hasDead) {
+            return 'degraded (unhealthy)';
+        }
+
+        if ($hasPaused) {
+            return 'paused (unknown)';
+        }
+
+        if ($hasStarting) {
+            return 'starting (unknown)';
         }
 
         // All containers are exited with no restart count - truly stopped

app/Actions/Shared/ComplexStatusCheck.php

@@ -84,7 +84,11 @@ class ComplexStatusCheck
         $hasRunning = false;
         $hasRestarting = false;
         $hasUnhealthy = false;
+        $hasUnknown = false;
         $hasExited = false;
+        $hasStarting = false;
+        $hasPaused = false;
+        $hasDead = false;
         $relevantContainerCount = 0;
 
         foreach ($containers as $container) {
@@ -104,12 +108,20 @@ class ComplexStatusCheck
                 $hasUnhealthy = true;
             } elseif ($containerStatus === 'running') {
                 $hasRunning = true;
-                if ($containerHealth && $containerHealth === 'unhealthy') {
+                if ($containerHealth === 'unhealthy') {
                     $hasUnhealthy = true;
+                } elseif ($containerHealth === null) {
+                    $hasUnknown = true;
                 }
             } elseif ($containerStatus === 'exited') {
                 $hasExited = true;
                 $hasUnhealthy = true;
+            } elseif ($containerStatus === 'created' || $containerStatus === 'starting') {
+                $hasStarting = true;
+            } elseif ($containerStatus === 'paused') {
+                $hasPaused = true;
+            } elseif ($containerStatus === 'dead' || $containerStatus === 'removing') {
+                $hasDead = true;
             }
         }
 
@@ -119,7 +131,11 @@ class ComplexStatusCheck
             $excludedHasRunning = false;
             $excludedHasRestarting = false;
             $excludedHasUnhealthy = false;
+            $excludedHasUnknown = false;
             $excludedHasExited = false;
+            $excludedHasStarting = false;
+            $excludedHasPaused = false;
+            $excludedHasDead = false;
 
             foreach ($containers as $container) {
                 $labels = data_get($container, 'Config.Labels', []);
@@ -138,12 +154,20 @@ class ComplexStatusCheck
                     $excludedHasUnhealthy = true;
                 } elseif ($containerStatus === 'running') {
                     $excludedHasRunning = true;
-                    if ($containerHealth && $containerHealth === 'unhealthy') {
+                    if ($containerHealth === 'unhealthy') {
                         $excludedHasUnhealthy = true;
+                    } elseif ($containerHealth === null) {
+                        $excludedHasUnknown = true;
                     }
                 } elseif ($containerStatus === 'exited') {
                     $excludedHasExited = true;
                     $excludedHasUnhealthy = true;
+                } elseif ($containerStatus === 'created' || $containerStatus === 'starting') {
+                    $excludedHasStarting = true;
+                } elseif ($containerStatus === 'paused') {
+                    $excludedHasPaused = true;
+                } elseif ($containerStatus === 'dead' || $containerStatus === 'removing') {
+                    $excludedHasDead = true;
                 }
             }
 
@@ -156,7 +180,25 @@ class ComplexStatusCheck
             }
 
             if ($excludedHasRunning) {
-                return 'running:excluded';
+                if ($excludedHasUnhealthy) {
+                    return 'running:unhealthy:excluded';
+                } elseif ($excludedHasUnknown) {
+                    return 'running:unknown:excluded';
+                } else {
+                    return 'running:healthy:excluded';
+                }
+            }
+
+            if ($excludedHasDead) {
+                return 'degraded:excluded';
+            }
+
+            if ($excludedHasPaused) {
+                return 'paused:excluded';
+            }
+
+            if ($excludedHasStarting) {
+                return 'starting:excluded';
             }
 
             return 'exited:excluded';
@@ -171,7 +213,25 @@ class ComplexStatusCheck
         }
 
         if ($hasRunning) {
-            return $hasUnhealthy ? 'running:unhealthy' : 'running:healthy';
+            if ($hasUnhealthy) {
+                return 'running:unhealthy';
+            } elseif ($hasUnknown) {
+                return 'running:unknown';
+            } else {
+                return 'running:healthy';
+            }
+        }
+
+        if ($hasDead) {
+            return 'degraded:unhealthy';
+        }
+
+        if ($hasPaused) {
+            return 'paused:unknown';
+        }
+
+        if ($hasStarting) {
+            return 'starting:unknown';
         }
 
         return 'exited:unhealthy';