@thinkai/tai-api-contract 2.147.0 → 2.148.0

package/dist/generated/openapi.d.ts

@@ -2871,8 +2871,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get scan-time fix instruction guide (G1–G5)
-         * @description Returns the markdown fix guide written during the latest successful scan for this issue. Applies only to platform-governance criteria **G1–G5** (`guidance` tier). **G6** and other rubrics must use the Automations PR Fix it flow (`POST .../readiness/fixes`). When no guide exists for a legacy run, returns `404` — re-scan the repository to generate instructions.
+         * Get fix instructions for a readiness issue
+         * @description G1–G5 return the markdown guide written during the latest successful scan. Every other issue returns the remediation already stored for that issue (latest succeeded criterion row, otherwise the issue description). When that text is missing, returns `404` so the page can show the empty-guide state.
          */
         get: operations["getReadinessIssueFixGuide"];
         put?: never;
@@ -3707,7 +3707,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Paginated notifications */
+        /**
+         * Paginated notifications
+         * @description Inbox for the current user in this workspace. Applies the same notification-type preference filter and routine-title exclusion as the unread badge. `view` defaults to `all` so a client that omits it still receives success rows. Severity is the stored column and is not recomputed per request.
+         */
         get: operations["listNotifications"];
         put?: never;
         post?: never;
@@ -3724,7 +3727,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Unread notification count */
+        /**
+         * Unread notification count
+         * @description Unread rows for the current user in this workspace after the notification-type preference filter and the routine-title exclusion. `count` is not capped. `hasUnreadCritical` is true when at least one of those rows has severity `destructive`.
+         */
         get: operations["getNotificationUnreadCount"];
         put?: never;
         post?: never;
@@ -3851,7 +3857,7 @@ export interface paths {
         };
         /**
          * App chrome bootstrap payload
-         * @description Returns the authenticated user's profile, workspace list, and preferences in one response. When `workspaceId` is provided and resolves to a workspace the caller belongs to, also returns platform banner, unread notification count, journey progress, and connectors snapshot. Invalid, unknown, or non-member `workspaceId` values do not produce 403/404 — the response is still 200 with only `me`, `workspaces`, and `preferences` (workspace-scoped fields omitted).
+         * @description Returns the authenticated user's profile, workspace list, and preferences in one response. When `workspaceId` is provided and resolves to a workspace the caller belongs to, also returns platform banner, unread notification count (`count` and `hasUnreadCritical`), journey progress, and connectors snapshot. Invalid, unknown, or non-member `workspaceId` values do not produce 403/404 — the response is still 200 with only `me`, `workspaces`, and `preferences` (workspace-scoped fields omitted).
          */
         get: operations["getAppShell"];
         put?: never;
@@ -7739,7 +7745,7 @@ export interface components {
             issueId: string;
             /** Format: uuid */
             repoId: string;
-            /** @description G1–G5 rubric criterion id */
+            /** @description Rubric criterion id (G1–G5 guides, or any other issue with stored remediation) */
             rubricId: string;
             /**
              * Format: uuid
@@ -7879,8 +7885,11 @@ export interface components {
             /** Format: date-time */
             createdAt: string;
             route?: string;
-            /** @enum {string} */
-            severity?: "success" | "warning" | "destructive" | "muted" | "neutral";
+            /**
+             * @description Stored on the notification row at fan-out. `destructive` is the only critical severity.
+             * @enum {string}
+             */
+            severity: "success" | "warning" | "destructive" | "muted" | "neutral";
             triggeredBy?: string | null;
         };
         NotificationListDto: {
@@ -7888,7 +7897,10 @@ export interface components {
             total: number;
         };
         NotificationUnreadCountDto: {
+            /** @description Unread rows after the type-preference filter and routine-title exclusion. Not capped. */
             count: number;
+            /** @description True when at least one of those unread rows has severity `destructive`. */
+            hasUnreadCritical: boolean;
         };
         EffectiveTaskRowDto: {
             id: string;
@@ -18652,7 +18664,7 @@ export interface operations {
                     "application/json": components["schemas"]["ReadinessFixGuideDto"];
                 };
             };
-            /** @description Issue rubric is not G1–G5 (use PR Fix it for G6 and other criteria) */
+            /** @description issueId is not a UUID */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -20579,6 +20591,10 @@ export interface operations {
             query?: {
                 limit?: number;
                 offset?: number;
+                /** @description `all` returns every severity. `needs_action` returns only `warning` and `destructive`. Omitted is `all`. */
+                view?: "all" | "needs_action";
+                /** @description Omit to include read and unread rows. `true` is unread only. `false` is read only. */
+                unread?: boolean;
             };
             header?: never;
             path: {
@@ -20597,6 +20613,15 @@ export interface operations {
                     "application/json": components["schemas"]["NotificationListDto"];
                 };
             };
+            /** @description Invalid `view` or `unread` */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
             401: components["responses"]["Unauthorized"];
         };
     };