@thinkai/tai-api-contract 2.152.0 → 2.154.0-pr.1317.ba1b741d

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.152.0
+  version: 2.154.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -8613,9 +8613,10 @@ paths:
       tags: [CodeChat]
       summary: Generate a workspace-scoped PRD draft
       description: >-
-        Builds a PRD draft from ready repository wikis, code graphs, and platform evidence
-        (readiness, quality, delivery, AI adoption, monitoring). Upserts one workspace
-        knowledge page (`prd-<slug>` / `prd-draft`) without replacing the whole knowledge base.
+        Builds a PRD draft from ready code maps (required) plus optional wiki pages and
+        platform evidence (readiness, quality, delivery, AI adoption, monitoring). Wiki is
+        optional — scan at least one repository first. Upserts one workspace knowledge page
+        (`prd-<slug>` / `prd-draft`) without replacing the whole knowledge base.
       operationId: generatePrdDraft
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
@@ -8641,6 +8642,70 @@ paths:
         "409":
           description: No ready code map in scope
 
+  /workspaces/{workspaceId}/knowledge-pages/rfc/generate:
+    post:
+      tags: [CodeChat]
+      summary: Generate a workspace-scoped RFC draft
+      description: >-
+        Same grounding as PRD generate (ready code maps required; wiki optional; platform
+        evidence when available). Upserts `rfc-<slug>` / `rfc-draft` without replacing the KB.
+      operationId: generateRfcDraft
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/GeneratePrdDraftBodyDto"
+      responses:
+        "200":
+          description: Generated RFC draft page
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GeneratePrdDraftResultDto"
+        "400":
+          description: Missing or invalid featureIntent
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Code Intelligence is disabled for this workspace
+        "409":
+          description: No ready code map in scope
+
+  /workspaces/{workspaceId}/knowledge-pages/adr/generate:
+    post:
+      tags: [CodeChat]
+      summary: Generate a workspace-scoped ADR draft
+      description: >-
+        Same grounding as PRD generate (ready code maps required; wiki optional; platform
+        evidence when available). Upserts `adr-<slug>` / `adr-draft` without replacing the KB.
+      operationId: generateAdrDraft
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/GeneratePrdDraftBodyDto"
+      responses:
+        "200":
+          description: Generated ADR draft page
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GeneratePrdDraftResultDto"
+        "400":
+          description: Missing or invalid featureIntent
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Code Intelligence is disabled for this workspace
+        "409":
+          description: No ready code map in scope
+
   /workspaces/{workspaceId}/knowledge-graph:
     get:
       tags: [CodeChat]
@@ -9664,6 +9729,27 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
 
+  /workspaces/{workspaceId}/notifications/{id}/unread:
+    post:
+      tags: [Notifications]
+      summary: Mark notification unread
+      description: Clears read state for the current member's row. Does not follow a route.
+      operationId: postNotificationUnread
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - $ref: "#/components/parameters/NotificationId"
+      responses:
+        "204":
+          description: Updated
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: Notification was not found for this member
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/notifications/read-all:
     post:
       tags: [Notifications]
@@ -22529,7 +22615,7 @@ components:
           type: string
           minLength: 1
           maxLength: 4000
-          description: Feature or change the PRD should describe
+          description: Feature or change the PRD, RFC, or ADR should describe
         repoIds:
           type: array
           description: Ready repository indexes to analyze. Omit or send empty for all ready indexes.
@@ -22541,18 +22627,24 @@ components:
 
     GeneratePrdDraftResultDto:
       type: object
-      required: [item, mode, repoIds, slug]
+      required: [item, mode, kind, repoIds, slug]
       properties:
         item: { $ref: "#/components/schemas/WorkspaceKnowledgePageDto" }
         mode:
           type: string
           enum: [deterministic, llm]
+        kind:
+          type: string
+          enum: [prd, rfc, adr]
+          description: Artifact kind that was generated
         repoIds:
           type: array
           items: { type: string, format: uuid }
         slug:
           type: string
-          description: Persisted workspace knowledge page slug (prd-draft or prd-<safe-slug>)
+          description: >-
+            Persisted workspace knowledge page slug (`prd-draft` / `prd-<safe-slug>`,
+            or the `rfc-` / `adr-` equivalents)
         usage:
           $ref: "#/components/schemas/CodeIntelligenceUsageDto"
 
@@ -22578,7 +22670,8 @@ components:
           type: string
           description: >-
             Page slug. `workspace-agent` is the canonical hub; supporting pages include
-            `workspace-overview`, `cross-repo-map`, `shared-concepts`, and `prd-*` drafts.
+            `workspace-overview`, `cross-repo-map`, `shared-concepts`, and
+            `prd-*` / `rfc-*` / `adr-*` drafts.
         title: { type: string }
         bodyMd: { type: string }
         sortOrder: { type: integer }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.152.0",
+  "version": "2.154.0-pr.1317.ba1b741d",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -3353,7 +3353,7 @@ export interface paths {
         put?: never;
         /**
          * Generate a workspace-scoped PRD draft
-         * @description Builds a PRD draft from ready repository wikis, code graphs, and platform evidence (readiness, quality, delivery, AI adoption, monitoring). Upserts one workspace knowledge page (`prd-<slug>` / `prd-draft`) without replacing the whole knowledge base.
+         * @description Builds a PRD draft from ready code maps (required) plus optional wiki pages and platform evidence (readiness, quality, delivery, AI adoption, monitoring). Wiki is optional — scan at least one repository first. Upserts one workspace knowledge page (`prd-<slug>` / `prd-draft`) without replacing the whole knowledge base.
          */
         post: operations["generatePrdDraft"];
         delete?: never;
@@ -3362,6 +3362,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/knowledge-pages/rfc/generate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Generate a workspace-scoped RFC draft
+         * @description Same grounding as PRD generate (ready code maps required; wiki optional; platform evidence when available). Upserts `rfc-<slug>` / `rfc-draft` without replacing the KB.
+         */
+        post: operations["generateRfcDraft"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/knowledge-pages/adr/generate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Generate a workspace-scoped ADR draft
+         * @description Same grounding as PRD generate (ready code maps required; wiki optional; platform evidence when available). Upserts `adr-<slug>` / `adr-draft` without replacing the KB.
+         */
+        post: operations["generateAdrDraft"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/knowledge-graph": {
         parameters: {
             query?: never;
@@ -3910,6 +3950,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/notifications/{id}/unread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark notification unread
+         * @description Clears read state for the current member's row. Does not follow a route.
+         */
+        post: operations["postNotificationUnread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/notifications/read-all": {
         parameters: {
             query?: never;
@@ -9737,7 +9797,7 @@ export interface components {
             };
         };
         GeneratePrdDraftBodyDto: {
-            /** @description Feature or change the PRD should describe */
+            /** @description Feature or change the PRD, RFC, or ADR should describe */
             featureIntent: string;
             /** @description Ready repository indexes to analyze. Omit or send empty for all ready indexes. */
             repoIds?: string[];
@@ -9751,8 +9811,13 @@ export interface components {
             item: components["schemas"]["WorkspaceKnowledgePageDto"];
             /** @enum {string} */
             mode: "deterministic" | "llm";
+            /**
+             * @description Artifact kind that was generated
+             * @enum {string}
+             */
+            kind: "prd" | "rfc" | "adr";
             repoIds: string[];
-            /** @description Persisted workspace knowledge page slug (prd-draft or prd-<safe-slug>) */
+            /** @description Persisted workspace knowledge page slug (`prd-draft` / `prd-<safe-slug>`, or the `rfc-` / `adr-` equivalents) */
             slug: string;
             usage?: components["schemas"]["CodeIntelligenceUsageDto"];
         };
@@ -9761,7 +9826,7 @@ export interface components {
             id: string;
             /** Format: uuid */
             workspaceId: string;
-            /** @description Page slug. `workspace-agent` is the canonical hub; supporting pages include `workspace-overview`, `cross-repo-map`, `shared-concepts`, and `prd-*` drafts. */
+            /** @description Page slug. `workspace-agent` is the canonical hub; supporting pages include `workspace-overview`, `cross-repo-map`, `shared-concepts`, and `prd-*` / `rfc-*` / `adr-*` drafts. */
             slug: string;
             title: string;
             bodyMd: string;
@@ -20250,6 +20315,102 @@ export interface operations {
             };
         };
     };
+    generateRfcDraft: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GeneratePrdDraftBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Generated RFC draft page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GeneratePrdDraftResultDto"];
+                };
+            };
+            /** @description Missing or invalid featureIntent */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Code Intelligence is disabled for this workspace */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No ready code map in scope */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    generateAdrDraft: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GeneratePrdDraftBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Generated ADR draft page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GeneratePrdDraftResultDto"];
+                };
+            };
+            /** @description Missing or invalid featureIntent */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Code Intelligence is disabled for this workspace */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No ready code map in scope */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getWorkspaceKnowledgeGraph: {
         parameters: {
             query?: never;
@@ -21486,6 +21647,37 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    postNotificationUnread: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                id: components["parameters"]["NotificationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Updated */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Notification was not found for this member */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     postNotificationsReadAll: {
         parameters: {
             query?: never;