Surface run-wait-age on dw system:operator-metrics

The operator-metrics rollout-safety contract now freezes
operator_metrics.runs.waiting (integer), operator_metrics.runs.oldest_wait_started_at
(ISO-8601 or null), and operator_metrics.runs.max_wait_age_ms (integer
milliseconds) as the run-wait-age surface — the count of running runs parked at
a durable resume point, the earliest wait_started_at among them, and the
largest wait age in milliseconds. The signal covers every kind of wait
(signal, update, timer, compatibility-blocked) because each is a durable
resume point the system is parked on.

Render the trio on the Runs section of dw system:operator-metrics as
"Waiting (durable resume): N", "Oldest wait age: N ms", and "Oldest wait
started at: ISO", sibling to the existing Repair needed / Claim failed /
Compatibility blocked counts. Pin all three keys under runs in
schemas/output/operator-metrics.schema.json for --json consumers so the
contract is enforced regardless of the textual renderer. Extends
SystemCommandTest with schema and human-rendering assertions pinned
unconditionally, mirroring the existing dispatch-overdue and ready-due age
pins.

Author: durable-workflow-ops

schemas/output/operator-metrics.schema.json

@@ -15,7 +15,10 @@
           "properties": {
             "repair_needed": { "type": ["integer", "null"] },
             "claim_failed": { "type": ["integer", "null"] },
-            "compatibility_blocked": { "type": ["integer", "null"] }
+            "compatibility_blocked": { "type": ["integer", "null"] },
+            "waiting": { "type": ["integer", "null"] },
+            "oldest_wait_started_at": { "type": ["string", "null"] },
+            "max_wait_age_ms": { "type": ["integer", "null"] }
           },
           "additionalProperties": true
         },

src/Commands/SystemCommand/OperatorMetricsCommand.php

@@ -94,6 +94,18 @@ private function renderRuns(OutputInterface $output, array $runs): void
         $output->writeln(sprintf('  Repair needed:        %d', (int) ($runs['repair_needed'] ?? 0)));
         $output->writeln(sprintf('  Claim failed:         %d', (int) ($runs['claim_failed'] ?? 0)));
         $output->writeln(sprintf('  Compatibility blocked: %d', (int) ($runs['compatibility_blocked'] ?? 0)));
+        if (array_key_exists('waiting', $runs)) {
+            $output->writeln(sprintf('  Waiting (durable resume): %d', (int) ($runs['waiting'] ?? 0)));
+        }
+        if (array_key_exists('max_wait_age_ms', $runs)) {
+            $output->writeln(sprintf(
+                '  Oldest wait age:      %d ms',
+                (int) ($runs['max_wait_age_ms'] ?? 0),
+            ));
+        }
+        if (is_string($runs['oldest_wait_started_at'] ?? null)) {
+            $output->writeln(sprintf('  Oldest wait started at: %s', $runs['oldest_wait_started_at']));
+        }
         $output->writeln('');
     }
 

tests/Commands/SystemCommandTest.php

@@ -507,6 +507,9 @@ public function test_operator_metrics_command_renders_rollout_safety_signals():
         self::assertStringContainsString('Repair needed:        4', $display);
         self::assertStringContainsString('Claim failed:         2', $display);
         self::assertStringContainsString('Compatibility blocked: 1', $display);
+        self::assertStringContainsString('Waiting (durable resume): 6', $display);
+        self::assertStringContainsString('Oldest wait age:      285000 ms', $display);
+        self::assertStringContainsString('Oldest wait started at: 2026-04-24T11:25:15Z', $display);
 
         self::assertStringContainsString('Queue depth:          9 ready (7 due), 3 delayed, 5 leased', $display);
         self::assertStringContainsString(
@@ -650,6 +653,21 @@ public function test_operator_metrics_schema_pins_dispatch_overdue_age_keys(): v
         self::assertSame(['integer', 'null'], $tasks['max_dispatch_overdue_age_ms']['type']);
     }
 
+    public function test_operator_metrics_schema_pins_run_wait_age_keys(): void
+    {
+        $schema = json_decode(
+            (string) file_get_contents(__DIR__.'/../../schemas/output/operator-metrics.schema.json'),
+            true,
+            flags: JSON_THROW_ON_ERROR,
+        );
+
+        $runs = $schema['properties']['operator_metrics']['properties']['runs']['properties'];
+
+        self::assertSame(['integer', 'null'], $runs['waiting']['type']);
+        self::assertSame(['string', 'null'], $runs['oldest_wait_started_at']['type']);
+        self::assertSame(['integer', 'null'], $runs['max_wait_age_ms']['type']);
+    }
+
     public function test_operator_metrics_command_tolerates_minimal_payload(): void
     {
         $command = new OperatorMetricsCommand();
@@ -679,6 +697,9 @@ private static function operatorMetricsPayload(): array
                     'repair_needed' => 4,
                     'claim_failed' => 2,
                     'compatibility_blocked' => 1,
+                    'waiting' => 6,
+                    'oldest_wait_started_at' => '2026-04-24T11:25:15Z',
+                    'max_wait_age_ms' => 285000,
                 ],
                 'tasks' => [
                     'ready' => 9,