feat(workbench): route actionable notifications

src/features/workbench/utils/operational-notification-routing.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import { getOperationalNotificationRoute } from "./operational-notification-routing";
+
+describe("getOperationalNotificationRoute", () => {
+  it.each(["task_created", "report_updated", "task_completed"] as const)(
+    "keeps normal lifecycle notification %s out of exception handling",
+    (kind) => expect(getOperationalNotificationRoute(kind)).toBeNull()
+  );
+
+  it("routes failures, approvals, human input, and external coordination", () => {
+    expect(getOperationalNotificationRoute("task_failed")).toEqual({
+      category: "task_exception",
+      severity: "critical"
+    });
+    expect(getOperationalNotificationRoute("access_approval_pending")?.category)
+      .toBe("human_approval");
+    expect(getOperationalNotificationRoute("action_approval_pending")?.category)
+      .toBe("human_approval");
+    expect(getOperationalNotificationRoute("human_input_required")?.category)
+      .toBe("human_input");
+    expect(getOperationalNotificationRoute("external_coordination_failed")).toEqual({
+      category: "external_coordination",
+      severity: "critical"
+    });
+  });
+
+  it("keeps legacy action notifications visible during the database rollout", () => {
+    expect(getOperationalNotificationRoute("action_pending")?.category)
+      .toBe("human_approval");
+  });
+});

src/features/workbench/utils/operational-notification-routing.ts

@@ -0,0 +1,33 @@
+import type { OperationalTaskNotification } from "../api/operational-task-client";
+
+export type OperationalNotificationCategory =
+  | "task_exception"
+  | "human_approval"
+  | "human_input"
+  | "external_coordination";
+
+export type OperationalNotificationRoute = {
+  category: OperationalNotificationCategory;
+  severity: "warning" | "critical";
+};
+
+const NOTIFICATION_ROUTES: Partial<
+  Record<OperationalTaskNotification["kind"], OperationalNotificationRoute>
+> = {
+  task_failed: { category: "task_exception", severity: "critical" },
+  run_delivery_degraded: { category: "task_exception", severity: "critical" },
+  action_pending: { category: "human_approval", severity: "warning" },
+  access_approval_pending: { category: "human_approval", severity: "warning" },
+  action_approval_pending: { category: "human_approval", severity: "warning" },
+  human_input_required: { category: "human_input", severity: "warning" },
+  external_coordination_failed: {
+    category: "external_coordination",
+    severity: "critical"
+  }
+};
+
+export function getOperationalNotificationRoute(
+  kind: OperationalTaskNotification["kind"]
+): OperationalNotificationRoute | null {
+  return NOTIFICATION_ROUTES[kind] ?? null;
+}