@cat-factory/kernel 0.341.0 → 0.342.0

package/dist/ports/notification-repositories.d.ts

@@ -9,6 +9,18 @@ export interface NotificationRepository {
      * a re-driven run doesn't stack identical cards on the same block.
      */
     findOpenByBlock(workspaceId: string, blockId: string, type: NotificationType): Promise<Notification | null>;
+    /**
+     * Every open notification on ONE block, newest first, of ANY type.
+     *
+     * The narrow read behind "does this block already have a card telling the human something is
+     * waiting". The engine used to answer that by pulling the workspace's WHOLE open inbox (each
+     * row's `body` + `payload` JSON) on every run-state transition and filtering in JS, which grows
+     * with the workspace's un-actioned inbox rather than with the block. `type` is deliberately not
+     * a parameter here: the caller asks whether ANY card points at the block, so narrowing to one
+     * type would raise a duplicate beside a card of a different type. Served by the existing
+     * `(workspace_id, block_id, type, status)` index on its leading columns.
+     */
+    listOpenByBlock(workspaceId: string, blockId: string): Promise<Notification[]>;
     /**
      * The open, BLOCK-LESS notification of `type` for a workspace (`block_id IS NULL`), if any.
      * The block-less analogue of {@link findOpenByBlock}: it de-duplicates deployment/workspace-
@@ -78,6 +90,20 @@ export interface NotificationRepository {
      * re-deliver each for the real-time inbox re-render. Nothing matches → empty array.
      */
     escalateStaleOpen(workspaceId: string, cutoff: number): Promise<Notification[]>;
+    /**
+     * Dismiss EVERY open, block-less notification of `type` for a workspace in ONE statement,
+     * returning the dismissed rows so the caller can re-deliver each for the real-time inbox
+     * re-render. Nothing open → empty array.
+     *
+     * Plural on purpose. A block-less card has no unique index to lean on: the partial index that
+     * makes the block-scoped raise atomic exempts them, because NULLs are distinct in a unique
+     * index, so `raise` still de-dupes them with a read-before-write and two sweeps racing on one
+     * workspace can leave two open rows. A clear that settled only the newest would leave the other
+     * open forever, and the escalation sweep would later flip it red for a condition that has since
+     * cleared: the exact lingering-stale-alert failure the clear exists to prevent. Settling the
+     * whole set is therefore both the clear AND the heal, and costs one indexed write either way.
+     */
+    dismissOpenByType(workspaceId: string, type: NotificationType, resolvedAt: number): Promise<Notification[]>;
     /**
      * Prune resolved notifications (status `acted`/`dismissed`) whose `resolvedAt` is at or
      * before `cutoff`, across all workspaces, returning the number of rows removed. The

package/dist/ports/notification-repositories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-repositories.d.ts","sourceRoot":"","sources":["../../src/ports/notification-repositories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAMxE,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAClE,iGAAiG;IACjG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACtD;;;OAGG;IACH,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAC/B;;;;;;OAMG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IACzF;;;;;;;;;OASG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAClG;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IACrC;sDACkD;IAClD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE;;;;;;;;;OASG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IACjG;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC1F;;;;;OAKG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC/E;;;;;;;;OAQG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACzD"}
+{"version":3,"file":"notification-repositories.d.ts","sourceRoot":"","sources":["../../src/ports/notification-repositories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAMxE,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAClE,iGAAiG;IACjG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACtD;;;OAGG;IACH,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAC/B;;;;;;;;;;OAUG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC9E;;;;;;OAMG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IACzF;;;;;;;;;OASG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAClG;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IACrC;sDACkD;IAClD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE;;;;;;;;;OASG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IACjG;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC1F;;;;;OAKG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC/E;;;;;;;;;;;;OAYG;IACH,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC1B;;;;;;;;OAQG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACzD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/kernel",
-  "version": "0.341.0",
+  "version": "0.342.0",
   "description": "Shared vocabulary, pure logic, and port interfaces for the Agent Architecture Board.",
   "repository": {
     "type": "git",