Render run-wait-age on the Waterline dashboard

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), plus the matching waiting_runs / oldest_wait_started_at /
max_wait_age_ms forward on the durable_resume_paths health check data. The
signal counts running runs parked at a durable resume point — signal,
update, timer, or compatibility-blocked — so operators can answer "how
long has the worst-case run been waiting for its next durable resume?"
from the metric alone.

Render the trio as a Waiting runs tile on the Operator metrics panel with
"oldest N parked (since ISO)" meta line, sibling to the existing Repair
needed runs, Claim failed runs, and Compatibility blocked tiles.

Gated by operatorRunWaitAvailable() / operatorRunWaitAgeAvailable() so
dashboards backed by pre-contract workflow packages still render cleanly
without flickering null-only meta lines. Adds V2DashboardStatsControllerTest::
testIndexExposesRunWaitAge which pins the contract against the v2 stats
endpoint and self-skips when the vendored workflow package predates the
contract, mirroring the existing stuck-lease, ready-due, and
dispatch-overdue self-skips.

Assets: public/app.js + public/mix-manifest.json rebuilt with
npm run development (Laravel Mix).

Author: durable-workflow-ops

public/app.js

@@ -1,5 +1,5 @@
 {
-    "/app.js": "/app.js?id=2da3db07039ecaab3c6709cc7c78e192",
+    "/app.js": "/app.js?id=3597e7e86873ed4d45ca663ba65b46c9",
     "/app-dark.css": "/app-dark.css?id=14bdc4fb1d6331a94030dc13821344fb",
     "/app.css": "/app.css?id=3d56d0e6a90f99083d111a8474a3c271",
     "/img/favicon.png": "/img/favicon.png?id=7c006241b093796d6abfa3049df93a59",

public/mix-manifest.json

@@ -342,6 +342,16 @@
                                     </template>
                                 </div>
                             </div>
+                            <div class="wl-operator-metric" v-if="operatorRunWaitAvailable()">
+                                <div class="wl-operator-metric__label">Waiting runs</div>
+                                <div class="wl-operator-metric__value">{{ operatorMetricLabel('runs', 'waiting') }}</div>
+                                <div v-if="operatorRunWaitAgeAvailable()" class="wl-operator-metric__meta">
+                                    oldest {{ operatorDurationMetricLabel('runs', 'max_wait_age_ms') }} parked
+                                    <template v-if="operatorRunWaitOldestStartedAt()">
+                                        (since {{ operatorRunWaitOldestStartedAt() }})
+                                    </template>
+                                </div>
+                            </div>
                             <div class="wl-operator-metric">
                                 <div class="wl-operator-metric__label">Active workers</div>
                                 <div class="wl-operator-metric__value">{{ operatorMetricLabel('workers', 'active_workers') }}</div>
@@ -1188,6 +1198,29 @@ export default {
             return tasks.oldest_dispatch_overdue_since || null;
         },
 
+        operatorRunWaitAvailable() {
+            const runs = (this.operatorMetrics && this.operatorMetrics.runs) || {};
+
+            return runs.waiting !== undefined && runs.waiting !== null;
+        },
+
+        operatorRunWaitAgeAvailable() {
+            const runs = (this.operatorMetrics && this.operatorMetrics.runs) || {};
+
+            if (runs.max_wait_age_ms === undefined || runs.max_wait_age_ms === null) {
+                return false;
+            }
+
+            return Number(runs.waiting || 0) > 0
+                || Number(runs.max_wait_age_ms || 0) > 0;
+        },
+
+        operatorRunWaitOldestStartedAt() {
+            const runs = (this.operatorMetrics && this.operatorMetrics.runs) || {};
+
+            return runs.oldest_wait_started_at || null;
+        },
+
         operatorSchedulesAvailable() {
             const schedules = this.operatorMetrics && this.operatorMetrics.schedules;
 

resources/js/screens/dashboard.vue

@@ -822,4 +822,36 @@ public function testIndexExposesDispatchOverdueAge(): void
             'operator_metrics.tasks.max_dispatch_overdue_age_ms must be null or integer milliseconds',
         );
     }
+
+    public function testIndexExposesRunWaitAge(): void
+    {
+        config()->set('waterline.engine_source', 'v2');
+
+        $response = $this->get('/waterline/api/stats')->assertStatus(200);
+
+        $runs = $response->json('operator_metrics.runs');
+
+        $this->assertIsArray($runs);
+
+        if (! array_key_exists('waiting', $runs)
+            || ! array_key_exists('oldest_wait_started_at', $runs)
+            || ! array_key_exists('max_wait_age_ms', $runs)) {
+            $this->markTestSkipped(
+                'Vendored workflow package predates the run-wait-age rollout-safety contract '
+                . '(operator_metrics.runs.waiting / oldest_wait_started_at / max_wait_age_ms).',
+            );
+        }
+
+        $this->assertIsInt($runs['waiting']);
+        $this->assertTrue(
+            $runs['oldest_wait_started_at'] === null
+                || is_string($runs['oldest_wait_started_at']),
+            'operator_metrics.runs.oldest_wait_started_at must be null or ISO-8601 string',
+        );
+        $this->assertTrue(
+            $runs['max_wait_age_ms'] === null
+                || is_int($runs['max_wait_age_ms']),
+            'operator_metrics.runs.max_wait_age_ms must be null or integer milliseconds',
+        );
+    }
 }