Versioning dashboard and proxy for release post 12.24

Author: timgit

packages/dashboard/README.md

@@ -18,7 +18,7 @@ A web-based dashboard for monitoring and managing [pg-boss](https://github.com/t
 
 - Node.js 22.12+
 - PostgreSQL database with pg-boss schema
-- pg-boss 12.11+
+- pg-boss 12.24+ recommended (12.21 minimum; queue metrics history and ready-count sparklines require 12.24)
 
 ## Installation
 

packages/dashboard/app/lib/queries.server.ts

@@ -45,7 +45,7 @@ const QUEUE_SORT_COLUMNS: Record<string, string> = {
   storage: 'partition',
   queued: 'queued_count',
   deferred: 'deferred_count',
-  ready: 'GREATEST(queued_count - deferred_count, 0)',
+  ready: 'ready_count',
   active: 'active_count',
   failed: 'failed_count',
   total: 'total_count',
@@ -97,7 +97,7 @@ const QUEUE_COLUMNS = `
   deletion_seconds as "deleteAfterSeconds",
   deferred_count as "deferredCount",
   queued_count as "queuedCount",
-  GREATEST(queued_count - deferred_count, 0) as "readyCount",
+  ready_count as "readyCount",
   active_count as "activeCount",
   failed_count as "failedCount",
   total_count as "totalCount",
@@ -781,7 +781,7 @@ export async function getQueueStats (
     SELECT
       COALESCE(SUM(deferred_count), 0)::int as "totalDeferred",
       COALESCE(SUM(queued_count), 0)::int as "totalQueued",
-      COALESCE(SUM(GREATEST(queued_count - deferred_count, 0)), 0)::int as "totalReady",
+      COALESCE(SUM(ready_count), 0)::int as "totalReady",
       COALESCE(SUM(active_count), 0)::int as "totalActive",
       COALESCE(SUM(failed_count), 0)::int as "totalFailed",
       COALESCE(SUM(total_count), 0)::int as "totalJobs",

packages/dashboard/app/lib/types.ts

@@ -26,8 +26,9 @@ export interface QueueResult extends PgBossQueueResult {
   maintainOn: Date | null;
   // Stats fields (declared locally so the dashboard typechecks against older
   // installed pg-boss versions whose published types predate these columns).
-  // readyCount = queuedCount - deferredCount (jobs runnable now); failedCount =
-  // failed jobs still retained in the table.
+  // readyCount = queue.ready_count, the count of jobs runnable now (start_after <= now),
+  // persisted by pg-boss as GREATEST(queued - deferred, 0) since schema v32 (alongside
+  // failed_count); failedCount = failed jobs still retained in the table.
   readyCount: number;
   failedCount: number;
   // Sliding window of recent ready counts (newest first) maintained by pg-boss on every monitor