Scope Waterline health snapshots to the configured namespace

Expose the configured namespace in Waterline health responses.
Reuse normalized namespace handling for both compatibility and native namespace-scoped workflow health snapshots.

Author: durable-workflow-ops

app/Http/Controllers/V2HealthController.php

@@ -12,9 +12,11 @@ class V2HealthController extends Controller
     public function show()
     {
         $engineSource = WorkflowEngineSourceResolver::status();
+        $namespace = $this->namespace();
 
         if (($engineSource['uses_v2'] ?? false) !== true) {
             return response()->json([
+                'namespace' => $namespace,
                 'generated_at' => now()->toJSON(),
                 'status' => 'error',
                 'healthy' => false,
@@ -50,6 +52,7 @@ public function show()
                 'issue_count' => count(is_array($engineSource['issues'] ?? null) ? $engineSource['issues'] : []),
             ],
         ]);
+        $snapshot['namespace'] = $namespace;
         $snapshot['engine_source'] = $engineSource;
         $snapshot['readiness_contract'] = $engineSource['readiness_contract'] ?? null;
 
@@ -64,7 +67,7 @@ public function show()
      */
     private function snapshotForConfiguredNamespace(): array
     {
-        $namespace = config('waterline.namespace');
+        $namespace = $this->namespace();
         $now = now();
 
         if ((new \ReflectionMethod(HealthCheck::class, 'snapshot'))->getNumberOfParameters() >= 2) {
@@ -110,4 +113,11 @@ private static function invokeLegacyHealthCheck(string $method, mixed ...$args):
             HealthCheck::class,
         )($method, $args);
     }
+
+    private function namespace(): ?string
+    {
+        $namespace = config('waterline.namespace');
+
+        return is_string($namespace) && trim($namespace) !== '' ? trim($namespace) : null;
+    }
 }

tests/Feature/V2HealthControllerTest.php

@@ -34,6 +34,7 @@ public function testHealthEndpointReturnsV2HealthSnapshot(): void
 
         $this->get('/waterline/api/v2/health')
             ->assertStatus(200)
+            ->assertJsonPath('namespace', null)
             ->assertJsonPath('status', 'ok')
             ->assertJsonPath('healthy', true)
             ->assertJsonPath('checks.0.name', 'engine_source')
@@ -63,6 +64,7 @@ public function testHealthEndpointScopesSnapshotToConfiguredNamespace(): void
 
         $this->get('/waterline/api/v2/health')
             ->assertStatus(200)
+            ->assertJsonPath('namespace', 'billing')
             ->assertJsonPath('status', 'ok')
             ->assertJsonPath('operator_metrics.runs.total', 1)
             ->assertJsonPath('operator_metrics.tasks.ready_due', 1)