@cat-factory/server 0.134.0 → 0.136.0

package/dist/runtime/platformHealth.js

@@ -0,0 +1,74 @@
+import { distinctAccountIds, evaluatePlatformHealth, platformAlertReasons, platformHealthCardContent, } from '@cat-factory/orchestration';
+/**
+ * Run one platform-health alert pass across every account. Returns the number of workspaces a
+ * card was raised on and the number cleared. Enumerates accounts from the workspace projection
+ * (`workspaceService.list(null)` → distinct non-null account ids), the same tenant-enumeration
+ * shape the platform-metrics + artifact-retention sweeps use — NOT a per-row point-read.
+ *
+ * Time comes from the services' injected clock (`summarize`, `raise` and `clearByType` all
+ * stamp `now` themselves), so this helper takes no `now` — unlike `escalateStaleNotifications`,
+ * whose cutoff is caller-supplied.
+ */
+export async function sweepPlatformHealth(container, logger) {
+    const cfg = container.config.platformAlerts;
+    const notifications = container.notifications;
+    const observability = container.platformObservability;
+    if (!cfg.enabled || !notifications || !observability)
+        return { raised: 0, cleared: 0 };
+    const workspaces = await container.workspaceService.list(null);
+    // Group workspaces by account so each account is summarized ONCE (five GROUP BY queries),
+    // then the verdict is fanned to every workspace in the account. Legacy null-account boards
+    // are skipped: the platform-metrics read is account-scoped (matches `distinctAccountIds`).
+    const byAccount = new Map();
+    for (const ws of workspaces) {
+        if (!ws.accountId)
+            continue;
+        const list = byAccount.get(ws.accountId);
+        if (list)
+            list.push(ws.id);
+        else
+            byAccount.set(ws.accountId, [ws.id]);
+    }
+    // Which workspaces already hold an open `platform_health` card, learned in ONE batched read
+    // up front rather than a `findOpenByType` point-read per workspace inside the loop (that N+1
+    // would run across the whole deployment every sweep — every couple of minutes). A healthy
+    // workspace with no card is the steady-state common case, and it is now skipped entirely: we
+    // only touch `clearByType` for a workspace that actually has a card to clear.
+    const withOpenCard = new Set((await notifications.service.listOpenByType(workspaces.map((ws) => ws.id), 'platform_health')).keys());
+    let raised = 0;
+    let cleared = 0;
+    for (const accountId of distinctAccountIds(workspaces)) {
+        const workspaceIds = byAccount.get(accountId) ?? [];
+        try {
+            const snapshot = await observability.summarize(accountId, cfg.window);
+            const reasons = platformAlertReasons(evaluatePlatformHealth(snapshot, cfg.thresholds));
+            for (const workspaceId of workspaceIds) {
+                if (reasons.length > 0) {
+                    const { title, body } = platformHealthCardContent(reasons, cfg.window);
+                    await notifications.service.raise(workspaceId, {
+                        type: 'platform_health',
+                        blockId: null,
+                        executionId: null,
+                        title,
+                        body,
+                        payload: { platformWindow: cfg.window, platformAlerts: reasons },
+                    });
+                    raised += 1;
+                }
+                else if (withOpenCard.has(workspaceId) &&
+                    (await notifications.service.clearByType(workspaceId, 'platform_health'))) {
+                    cleared += 1;
+                }
+            }
+        }
+        catch (err) {
+            logger?.warn({
+                scope: 'platform-health',
+                accountId,
+                err: err instanceof Error ? err.message : String(err),
+            }, 'platform-health: failed to evaluate account');
+        }
+    }
+    return { raised, cleared };
+}
+//# sourceMappingURL=platformHealth.js.map

package/dist/runtime/platformHealth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformHealth.js","sourceRoot":"","sources":["../../src/runtime/platformHealth.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/server",
-  "version": "0.134.0",
+  "version": "0.136.0",
   "description": "Runtime-neutral HTTP layer for the Agent Architecture Board: the Hono controllers, middleware (auth/authz/CORS/error), request helpers and the gateway seams shared by every deployment facade (Cloudflare Worker, Node service).",
   "repository": {
     "type": "git",
@@ -31,13 +31,13 @@
     "p-map": "^7.0.5",
     "pino": "^10.3.1",
     "valibot": "^1.4.2",
-    "@cat-factory/agents": "0.62.6",
-    "@cat-factory/contracts": "0.145.0",
-    "@cat-factory/integrations": "0.85.3",
-    "@cat-factory/kernel": "0.138.0",
-    "@cat-factory/orchestration": "0.121.0",
-    "@cat-factory/prompt-fragments": "0.13.34",
-    "@cat-factory/spend": "0.12.47"
+    "@cat-factory/agents": "0.62.8",
+    "@cat-factory/contracts": "0.147.0",
+    "@cat-factory/integrations": "0.86.0",
+    "@cat-factory/kernel": "0.139.0",
+    "@cat-factory/orchestration": "0.123.0",
+    "@cat-factory/prompt-fragments": "0.13.36",
+    "@cat-factory/spend": "0.12.49"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",