Surface claim-failed age on dw system:operator-metrics

Renders the workflow-v2 task-path claim-failed age pair on the
operator-metrics CLI surface so HTTP-only operators can read "how
long has the worst-case task been sitting with an uncleared claim
error?" — the primary lease-conflict and duplicate-risk age
indicator on the claim path — directly from `dw system:operator-metrics`.

`OperatorMetricsCommand::renderTasks()` now emits two new rows
right after the existing oldest-dispatch-overdue rows:

Oldest claim-failed age:  <ms>
Oldest claim failed at:   <ISO-8601>

Both rows degrade gracefully when the snapshot predates the
contract (workflow alpha < 2.0.0-alpha.17, where 6089777
"Surface claim-failed age on operator metrics and task_transport
health" is not yet on a published tag): the renderer omits the
rows and the existing `claim failed <count>` cell on the
duplicate-risk roll-up still renders.

Pins `tasks.oldest_claim_failed_at` and `tasks.max_claim_failed_age_ms`
on `schemas/output/operator-metrics.schema.json` next to the
existing `oldest_dispatch_overdue_since` / `max_dispatch_overdue_age_ms`
pair, and adds `test_operator_metrics_schema_pins_claim_failed_age_keys`
plus `test_operator_metrics_command_omits_claim_failed_age_when_snapshot_predates_contract`
to guard the schema declaration and the renderer fallback.

Author: durable-workflow-ops

schemas/output/operator-metrics.schema.json

@@ -39,6 +39,8 @@
             "max_ready_due_age_ms": { "type": ["integer", "null"] },
             "oldest_dispatch_overdue_since": { "type": ["string", "null"] },
             "max_dispatch_overdue_age_ms": { "type": ["integer", "null"] },
+            "oldest_claim_failed_at": { "type": ["string", "null"] },
+            "max_claim_failed_age_ms": { "type": ["integer", "null"] },
             "unhealthy": { "type": ["integer", "null"] }
           },
           "additionalProperties": true

src/Commands/SystemCommand/OperatorMetricsCommand.php

@@ -162,6 +162,15 @@ private function renderTasks(OutputInterface $output, array $tasks): void
         if (is_string($tasks['oldest_dispatch_overdue_since'] ?? null)) {
             $output->writeln(sprintf('  Oldest dispatch-overdue since: %s', $tasks['oldest_dispatch_overdue_since']));
         }
+        if (array_key_exists('max_claim_failed_age_ms', $tasks)) {
+            $output->writeln(sprintf(
+                '  Oldest claim-failed age:  %d ms',
+                (int) ($tasks['max_claim_failed_age_ms'] ?? 0),
+            ));
+        }
+        if (is_string($tasks['oldest_claim_failed_at'] ?? null)) {
+            $output->writeln(sprintf('  Oldest claim failed at:   %s', $tasks['oldest_claim_failed_at']));
+        }
         $output->writeln('');
     }
 

tests/Commands/SystemCommandTest.php

@@ -522,6 +522,8 @@ public function test_operator_metrics_command_renders_rollout_safety_signals():
         self::assertStringContainsString('Oldest ready-due at:      2026-04-24T11:29:45Z', $display);
         self::assertStringContainsString('Oldest dispatch-overdue age: 55000 ms', $display);
         self::assertStringContainsString('Oldest dispatch-overdue since: 2026-04-24T11:29:05Z', $display);
+        self::assertStringContainsString('Oldest claim-failed age:  65000 ms', $display);
+        self::assertStringContainsString('Oldest claim failed at:   2026-04-24T11:28:55Z', $display);
 
         self::assertStringContainsString('Runnable tasks:       7', $display);
         self::assertStringContainsString('Delayed tasks:        3', $display);
@@ -664,6 +666,20 @@ 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_claim_failed_age_keys(): void
+    {
+        $schema = json_decode(
+            (string) file_get_contents(__DIR__.'/../../schemas/output/operator-metrics.schema.json'),
+            true,
+            flags: JSON_THROW_ON_ERROR,
+        );
+
+        $tasks = $schema['properties']['operator_metrics']['properties']['tasks']['properties'];
+
+        self::assertSame(['string', 'null'], $tasks['oldest_claim_failed_at']['type']);
+        self::assertSame(['integer', 'null'], $tasks['max_claim_failed_age_ms']['type']);
+    }
+
     public function test_operator_metrics_schema_pins_run_wait_age_keys(): void
     {
         $schema = json_decode(
@@ -714,6 +730,27 @@ public function test_operator_metrics_schema_pins_activities_retrying_age_keys()
         self::assertSame(['integer', 'null'], $activities['max_attempt_count']['type']);
     }
 
+    public function test_operator_metrics_command_omits_claim_failed_age_when_snapshot_predates_contract(): void
+    {
+        $payload = self::operatorMetricsPayload();
+        unset(
+            $payload['operator_metrics']['tasks']['oldest_claim_failed_at'],
+            $payload['operator_metrics']['tasks']['max_claim_failed_age_ms'],
+        );
+
+        $command = new OperatorMetricsCommand();
+        $command->setServerClient(new SystemFakeClient($payload));
+
+        $tester = new CommandTester($command);
+        self::assertSame(Command::SUCCESS, $tester->execute([]));
+
+        $display = $tester->getDisplay();
+
+        self::assertStringNotContainsString('Oldest claim-failed age', $display);
+        self::assertStringNotContainsString('Oldest claim failed at', $display);
+        self::assertStringContainsString('claim failed 3', $display);
+    }
+
     public function test_operator_metrics_command_omits_activities_block_when_payload_lacks_it(): void
     {
         $payload = self::operatorMetricsPayload();
@@ -801,6 +838,8 @@ private static function operatorMetricsPayload(): array
                     'max_ready_due_age_ms' => 15000,
                     'oldest_dispatch_overdue_since' => '2026-04-24T11:29:05Z',
                     'max_dispatch_overdue_age_ms' => 55000,
+                    'oldest_claim_failed_at' => '2026-04-24T11:28:55Z',
+                    'max_claim_failed_age_ms' => 65000,
                     'unhealthy' => 11,
                 ],
                 'backlog' => [