@thinkai/tai-api-contract 2.54.0 → 2.56.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.54.0
+  version: 2.56.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -1099,6 +1099,48 @@ paths:
         "403":
           $ref: "#/components/responses/Forbidden"
 
+  /workspaces/{workspaceId}/org-chart/members/me:
+    patch:
+      tags: [Workspace]
+      summary: Update current user's org chart member row
+      description: >
+        Updates the signed-in user's row in the workspace org chart snapshot (`thinkai_org_structure`),
+        matched by work email. Any workspace member may update their own row; workspace editor role is not required.
+      operationId: patchMyOrgChartMember
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateMyOrgChartMemberBodyDto"
+      responses:
+        "200":
+          description: Updated org chart member row
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/OrgChartPersonDto"
+        "400":
+          description: Invalid request body
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: >
+            Org chart not found (no persisted chart for the workspace), or the caller's email
+            is not present in the org chart roster.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/config:
     get:
       tags: [TechStack]
@@ -4624,6 +4666,53 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/agentic-foundation/repo-scope:
+    put:
+      tags: [AgenticFoundation]
+      summary: Update Agentic Foundation repository scope
+      description: >
+        Bulk include/exclude materialized repos from Agentic Foundation by toggling the existing
+        `user_removed` archive state. Excluded repos remain integrated for productivity metrics.
+        Only workspace admins may call this endpoint. Partial failures are reported per repo.
+      operationId: putAgenticFoundationRepoScope
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PutAgenticFoundationRepoScopeBodyDto"
+            example:
+              changes:
+                - repoId: 00000000-0000-0000-0000-000000000101
+                  included: false
+                - repoId: 00000000-0000-0000-0000-000000000102
+                  included: true
+      responses:
+        "200":
+          description: Scope changes applied (possibly with per-repo failures)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PutAgenticFoundationRepoScopeResponseDto"
+        "400":
+          description: Invalid request body
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/agentic-foundation/dashboard:
     get:
       tags: [AgenticFoundation]
@@ -6774,6 +6863,27 @@ components:
           type: string
           description: Bitbucket account UUID (e.g. "{aeefb6b0-...}") to attribute merged PRs and reviews to this person in productivity ingest. Preferred over bitbucketNickname — Bitbucket PR payloads expose a stable uuid but not nickname. Resolves to the same person_id (email) as githubUsername.
 
+    UpdateMyOrgChartMemberBodyDto:
+      type: object
+      additionalProperties: false
+      properties:
+        name:
+          type: string
+        title:
+          type: string
+        department:
+          type: string
+        team:
+          type: string
+        location:
+          type: string
+        githubUsername:
+          type: string
+        bitbucketNickname:
+          type: string
+        bitbucketUuid:
+          type: string
+
     OrgChartImportResultDto:
       type: object
       additionalProperties: false
@@ -11066,8 +11176,8 @@ components:
         archivedReason:
           type: string
           nullable: true
-          enum: [github_removed, installation_disconnected, installation_replaced, superseded]
-          description: Why the repo was archived. Only present when `archivedAt` is set.
+          enum: [github_removed, installation_disconnected, installation_replaced, superseded, user_removed]
+          description: Why the repo was archived. `user_removed` means excluded from Agentic Foundation scope only. Only present when `archivedAt` is set.
         eligibilityStatus:
           type: string
           enum: [eligible, ineligible]
@@ -11210,7 +11320,7 @@ components:
         archivedReason:
           type: string
           nullable: true
-          enum: [github_removed, installation_disconnected, installation_replaced, superseded]
+          enum: [github_removed, installation_disconnected, installation_replaced, superseded, user_removed]
         eligibilityStatus:
           type: string
           enum: [eligible, ineligible]
@@ -12390,6 +12500,77 @@ components:
           nullable: true
           description: ID of the freshly enqueued readiness scan run (only present on re-add).
 
+    PutAgenticFoundationRepoScopeChangeDto:
+      type: object
+      required: [repoId, included]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        included:
+          type: boolean
+          description: >
+            `true` to include in Agentic Foundation scope (unarchive user_removed).
+            `false` to exclude (soft-archive with archived_reason user_removed).
+
+    PutAgenticFoundationRepoScopeBodyDto:
+      type: object
+      required: [changes]
+      properties:
+        changes:
+          type: array
+          minItems: 1
+          maxItems: 200
+          items:
+            $ref: "#/components/schemas/PutAgenticFoundationRepoScopeChangeDto"
+
+    PutAgenticFoundationRepoScopeAppliedDto:
+      type: object
+      required: [repoId, status]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        status:
+          type: string
+          enum: [Active, Inactive]
+        runId:
+          type: string
+          format: uuid
+          nullable: true
+
+    PutAgenticFoundationRepoScopeFailureDto:
+      type: object
+      required: [repoId, code, message]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        code:
+          type: string
+          enum:
+            - not_found
+            - scan_in_progress
+            - not_archived
+            - already_active
+            - system_archived
+            - forbidden
+        message:
+          type: string
+
+    PutAgenticFoundationRepoScopeResponseDto:
+      type: object
+      required: [applied, failures]
+      properties:
+        applied:
+          type: array
+          items:
+            $ref: "#/components/schemas/PutAgenticFoundationRepoScopeAppliedDto"
+        failures:
+          type: array
+          items:
+            $ref: "#/components/schemas/PutAgenticFoundationRepoScopeFailureDto"
+
     ActivityLogEventTypeDto:
       type: string
       description: Type of workspace lifecycle event.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.54.0",
+  "version": "2.56.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -21,7 +21,7 @@
   "dependencies": {},
   "devDependencies": {
     "@stoplight/spectral-cli": "^6.16.1",
-    "@types/node": "^26.0.1",
+    "@types/node": "^26.1.1",
     "jsonpath-plus": "^10.3.0",
     "openapi-typescript": "^7.13.0",
     "typescript": "~6.0.3"

package/src/generated/openapi.ts

@@ -400,6 +400,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/org-chart/members/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Update current user's org chart member row
+         * @description Updates the signed-in user's row in the workspace org chart snapshot (`thinkai_org_structure`), matched by work email. Any workspace member may update their own row; workspace editor role is not required.
+         */
+        patch: operations["patchMyOrgChartMember"];
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/config": {
         parameters: {
             query?: never;
@@ -1659,6 +1679,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/agentic-foundation/repo-scope": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Update Agentic Foundation repository scope
+         * @description Bulk include/exclude materialized repos from Agentic Foundation by toggling the existing `user_removed` archive state. Excluded repos remain integrated for productivity metrics. Only workspace admins may call this endpoint. Partial failures are reported per repo.
+         */
+        put: operations["putAgenticFoundationRepoScope"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/agentic-foundation/dashboard": {
         parameters: {
             query?: never;
@@ -2587,6 +2627,16 @@ export interface components {
             /** @description Bitbucket account UUID (e.g. "{aeefb6b0-...}") to attribute merged PRs and reviews to this person in productivity ingest. Preferred over bitbucketNickname — Bitbucket PR payloads expose a stable uuid but not nickname. Resolves to the same person_id (email) as githubUsername. */
             bitbucketUuid?: string;
         };
+        UpdateMyOrgChartMemberBodyDto: {
+            name?: string;
+            title?: string;
+            department?: string;
+            team?: string;
+            location?: string;
+            githubUsername?: string;
+            bitbucketNickname?: string;
+            bitbucketUuid?: string;
+        };
         OrgChartImportResultDto: {
             persons: components["schemas"]["OrgChartPersonDto"][];
             errors: string[];
@@ -4640,10 +4690,10 @@ export interface components {
              */
             archivedAt?: string | null;
             /**
-             * @description Why the repo was archived. Only present when `archivedAt` is set.
+             * @description Why the repo was archived. `user_removed` means excluded from Agentic Foundation scope only. Only present when `archivedAt` is set.
              * @enum {string|null}
              */
-            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | null;
+            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
             /**
              * @description Whether the repo can be analyzed (#44/#729). Language support no longer makes a repo `ineligible` — a missing v1-supported stack is surfaced via `warnings` and the repo stays analyzable. It becomes `ineligible` when the most recent scan hit a hard size/file-count limit (e.g. code-size or file-count exceeded): the repo is then restricted here too so this surface matches the GitHub connect list's size gate after the scan. Null until the first sync/scan computes it.
              * @enum {string|null}
@@ -4698,7 +4748,7 @@ export interface components {
             /** Format: date-time */
             archivedAt?: string | null;
             /** @enum {string|null} */
-            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | null;
+            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
             /**
              * @description See RepoReadinessScoreDto.eligibilityStatus. Language support is advisory (#729) and surfaced via `warnings`.
              * @enum {string|null}
@@ -5224,6 +5274,34 @@ export interface components {
              */
             runId?: string | null;
         };
+        PutAgenticFoundationRepoScopeChangeDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @description `true` to include in Agentic Foundation scope (unarchive user_removed). `false` to exclude (soft-archive with archived_reason user_removed). */
+            included: boolean;
+        };
+        PutAgenticFoundationRepoScopeBodyDto: {
+            changes: components["schemas"]["PutAgenticFoundationRepoScopeChangeDto"][];
+        };
+        PutAgenticFoundationRepoScopeAppliedDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @enum {string} */
+            status: "Active" | "Inactive";
+            /** Format: uuid */
+            runId?: string | null;
+        };
+        PutAgenticFoundationRepoScopeFailureDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @enum {string} */
+            code: "not_found" | "scan_in_progress" | "not_archived" | "already_active" | "system_archived" | "forbidden";
+            message: string;
+        };
+        PutAgenticFoundationRepoScopeResponseDto: {
+            applied: components["schemas"]["PutAgenticFoundationRepoScopeAppliedDto"][];
+            failures: components["schemas"]["PutAgenticFoundationRepoScopeFailureDto"][];
+        };
         /**
          * @description Type of workspace lifecycle event.
          * @enum {string}
@@ -5550,6 +5628,7 @@ export type OrgChartTreeNodeDto = components['schemas']['OrgChartTreeNodeDto'];
 export type ScoringOrgChartDto = components['schemas']['ScoringOrgChartDto'];
 export type OrgChartDto = components['schemas']['OrgChartDto'];
 export type OrgChartPersonDto = components['schemas']['OrgChartPersonDto'];
+export type UpdateMyOrgChartMemberBodyDto = components['schemas']['UpdateMyOrgChartMemberBodyDto'];
 export type OrgChartImportResultDto = components['schemas']['OrgChartImportResultDto'];
 export type OrgChartSaveResultDto = components['schemas']['OrgChartSaveResultDto'];
 export type OrgStructureSourceBodyDto = components['schemas']['OrgStructureSourceBodyDto'];
@@ -5786,6 +5865,11 @@ export type YourAiJourneyAiSpendWeekDto = components['schemas']['YourAiJourneyAi
 export type YourAiJourneyAiSpendDto = components['schemas']['YourAiJourneyAiSpendDto'];
 export type PatchRepoArchiveBodyDto = components['schemas']['PatchRepoArchiveBodyDto'];
 export type PatchRepoArchiveResponseDto = components['schemas']['PatchRepoArchiveResponseDto'];
+export type PutAgenticFoundationRepoScopeChangeDto = components['schemas']['PutAgenticFoundationRepoScopeChangeDto'];
+export type PutAgenticFoundationRepoScopeBodyDto = components['schemas']['PutAgenticFoundationRepoScopeBodyDto'];
+export type PutAgenticFoundationRepoScopeAppliedDto = components['schemas']['PutAgenticFoundationRepoScopeAppliedDto'];
+export type PutAgenticFoundationRepoScopeFailureDto = components['schemas']['PutAgenticFoundationRepoScopeFailureDto'];
+export type PutAgenticFoundationRepoScopeResponseDto = components['schemas']['PutAgenticFoundationRepoScopeResponseDto'];
 export type ActivityLogEventTypeDto = components['schemas']['ActivityLogEventTypeDto'];
 export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
 export type ActivityLogEntryDto = components['schemas']['ActivityLogEntryDto'];
@@ -6989,6 +7073,52 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    patchMyOrgChartMember: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateMyOrgChartMemberBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Updated org chart member row */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrgChartPersonDto"];
+                };
+            };
+            /** @description Invalid request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Org chart not found (no persisted chart for the workspace), or the caller's email is not present in the org chart roster. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getWorkspaceConfig: {
         parameters: {
             query?: never;
@@ -10240,6 +10370,66 @@ export interface operations {
             };
         };
     };
+    putAgenticFoundationRepoScope: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "changes": [
+                 *         {
+                 *           "repoId": "00000000-0000-0000-0000-000000000101",
+                 *           "included": false
+                 *         },
+                 *         {
+                 *           "repoId": "00000000-0000-0000-0000-000000000102",
+                 *           "included": true
+                 *         }
+                 *       ]
+                 *     }
+                 */
+                "application/json": components["schemas"]["PutAgenticFoundationRepoScopeBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Scope changes applied (possibly with per-repo failures) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PutAgenticFoundationRepoScopeResponseDto"];
+                };
+            };
+            /** @description Invalid request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAgenticFoundationDashboard: {
         parameters: {
             query?: never;