@thinkai/tai-api-contract 2.204.0 → 2.205.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.204.0
+  version: 2.205.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -2391,12 +2391,18 @@ paths:
     get:
       tags: [Workspace]
       summary: Effective org chart status (structure + identity)
+      description: >
+        Returns structure source, HRIS identity mismatch samples, effective chart summary,
+        and inactive-VCS identity samples (roster handles with no matching productivity
+        contributor activity in the lookback). When the workspace has zero known VCS
+        actors in the lookback, `identity.inactiveVcs.waitingForProductivitySync` is true
+        and samples stay empty (no mass false positives).
       operationId: getWorkspaceOrgChartStatus
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
       responses:
         "200":
-          description: Structure source, identity mappings, and effective chart summary
+          description: Structure source, identity mappings, inactive-VCS samples, and effective chart summary
           content:
             application/json:
               schema:
@@ -15555,6 +15561,91 @@ components:
         githubUsername:
           type: string
 
+    OrgChartInactiveVcsProviderDto:
+      type: string
+      enum: [github, bitbucket, gitlab]
+      description: Connected VCS provider family for an inactive handle sample.
+
+    OrgChartInactiveVcsFieldDto:
+      type: string
+      enum: [githubUsername, gitlabUsername, bitbucketNickname, bitbucketUuid]
+      description: Roster identity field that did not match productivity actors in the lookback.
+
+    OrgChartInactiveVcsIdentitySampleDto:
+      type: object
+      additionalProperties: false
+      required: [personId, provider, field, handle]
+      description: >
+        One roster VCS handle with no case-insensitive match against known productivity /
+        contributor actors in the lookback. Severity is warning; does not block Save.
+      properties:
+        personId:
+          type: string
+          description: Org-chart person id (typically work email).
+        email:
+          type: string
+          description: Primary work email when known.
+        displayName:
+          type: string
+          description: Person display name from the org chart when known.
+        provider:
+          $ref: "#/components/schemas/OrgChartInactiveVcsProviderDto"
+        field:
+          $ref: "#/components/schemas/OrgChartInactiveVcsFieldDto"
+        handle:
+          type: string
+          description: The roster handle value that did not match (trimmed, as stored).
+
+    OrgChartInactiveVcsIdentityDto:
+      type: object
+      additionalProperties: false
+      required:
+        [
+          waitingForProductivitySync,
+          lookbackDays,
+          lookbackFrom,
+          lookbackTo,
+          actorCount,
+          inactiveVcsCount,
+          inactiveVcsSample,
+        ]
+      description: >
+        Inactive-VCS identity quality for the org-structure page. Lookback prefers the
+        workspace productivity ingest coverage window when productivity ingest has started;
+        otherwise the last 90 days. When `actorCount` is 0, `waitingForProductivitySync`
+        is true and samples stay empty.
+      properties:
+        waitingForProductivitySync:
+          type: boolean
+          description: >
+            True when no known VCS actors exist in the lookback (informational empty state;
+            do not treat every roster handle as inactive).
+        lookbackDays:
+          type: integer
+          minimum: 1
+        lookbackFrom:
+          type: string
+          format: date
+          description: Inclusive lookback start (UTC calendar day, YYYY-MM-DD).
+        lookbackTo:
+          type: string
+          format: date
+          description: Inclusive lookback end (UTC calendar day, YYYY-MM-DD).
+        actorCount:
+          type: integer
+          minimum: 0
+          description: Distinct known VCS actor handles observed in the lookback.
+        inactiveVcsCount:
+          type: integer
+          minimum: 0
+          description: Full count of inactive roster handles (not capped).
+        inactiveVcsSample:
+          type: array
+          maxItems: 25
+          description: Sample of inactive handles (cap ≥ unmatchedSample; at least 25).
+          items:
+            $ref: "#/components/schemas/OrgChartInactiveVcsIdentitySampleDto"
+
     OrgChartStatusDto:
       type: object
       additionalProperties: false
@@ -15584,7 +15675,7 @@ components:
         identity:
           type: object
           additionalProperties: false
-          required: [mappingCount, updatedAt, unmatchedCount, unmatchedSample]
+          required: [mappingCount, updatedAt, unmatchedCount, unmatchedSample, inactiveVcs]
           properties:
             mappingCount:
               type: integer
@@ -15600,6 +15691,8 @@ components:
               type: array
               items:
                 $ref: "#/components/schemas/OrgChartUnmatchedIdentitySampleDto"
+            inactiveVcs:
+              $ref: "#/components/schemas/OrgChartInactiveVcsIdentityDto"
         effective:
           type: object
           additionalProperties: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.204.0",
+  "version": "2.205.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -725,7 +725,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Effective org chart status (structure + identity) */
+        /**
+         * Effective org chart status (structure + identity)
+         * @description Returns structure source, HRIS identity mismatch samples, effective chart summary, and inactive-VCS identity samples (roster handles with no matching productivity contributor activity in the lookback). When the workspace has zero known VCS actors in the lookback, `identity.inactiveVcs.waitingForProductivitySync` is true and samples stay empty (no mass false positives).
+         */
         get: operations["getWorkspaceOrgChartStatus"];
         put?: never;
         post?: never;
@@ -5925,6 +5928,51 @@ export interface components {
             employeeId?: string;
             githubUsername?: string;
         };
+        /**
+         * @description Connected VCS provider family for an inactive handle sample.
+         * @enum {string}
+         */
+        OrgChartInactiveVcsProviderDto: "github" | "bitbucket" | "gitlab";
+        /**
+         * @description Roster identity field that did not match productivity actors in the lookback.
+         * @enum {string}
+         */
+        OrgChartInactiveVcsFieldDto: "githubUsername" | "gitlabUsername" | "bitbucketNickname" | "bitbucketUuid";
+        /** @description One roster VCS handle with no case-insensitive match against known productivity / contributor actors in the lookback. Severity is warning; does not block Save. */
+        OrgChartInactiveVcsIdentitySampleDto: {
+            /** @description Org-chart person id (typically work email). */
+            personId: string;
+            /** @description Primary work email when known. */
+            email?: string;
+            /** @description Person display name from the org chart when known. */
+            displayName?: string;
+            provider: components["schemas"]["OrgChartInactiveVcsProviderDto"];
+            field: components["schemas"]["OrgChartInactiveVcsFieldDto"];
+            /** @description The roster handle value that did not match (trimmed, as stored). */
+            handle: string;
+        };
+        /** @description Inactive-VCS identity quality for the org-structure page. Lookback prefers the workspace productivity ingest coverage window when productivity ingest has started; otherwise the last 90 days. When `actorCount` is 0, `waitingForProductivitySync` is true and samples stay empty. */
+        OrgChartInactiveVcsIdentityDto: {
+            /** @description True when no known VCS actors exist in the lookback (informational empty state; do not treat every roster handle as inactive). */
+            waitingForProductivitySync: boolean;
+            lookbackDays: number;
+            /**
+             * Format: date
+             * @description Inclusive lookback start (UTC calendar day, YYYY-MM-DD).
+             */
+            lookbackFrom: string;
+            /**
+             * Format: date
+             * @description Inclusive lookback end (UTC calendar day, YYYY-MM-DD).
+             */
+            lookbackTo: string;
+            /** @description Distinct known VCS actor handles observed in the lookback. */
+            actorCount: number;
+            /** @description Full count of inactive roster handles (not capped). */
+            inactiveVcsCount: number;
+            /** @description Sample of inactive handles (cap ≥ unmatchedSample; at least 25). */
+            inactiveVcsSample: components["schemas"]["OrgChartInactiveVcsIdentitySampleDto"][];
+        };
         OrgChartStatusDto: {
             structure: {
                 /** @enum {string} */
@@ -5941,6 +5989,7 @@ export interface components {
                 updatedAt: string | null;
                 unmatchedCount: number;
                 unmatchedSample: components["schemas"]["OrgChartUnmatchedIdentitySampleDto"][];
+                inactiveVcs: components["schemas"]["OrgChartInactiveVcsIdentityDto"];
             };
             effective: {
                 personCount: number;
@@ -13324,6 +13373,10 @@ export type OrgChartSaveResultDto = components['schemas']['OrgChartSaveResultDto
 export type OrgStructureSourceBodyDto = components['schemas']['OrgStructureSourceBodyDto'];
 export type OrgChartStructureAvailabilityDto = components['schemas']['OrgChartStructureAvailabilityDto'];
 export type OrgChartUnmatchedIdentitySampleDto = components['schemas']['OrgChartUnmatchedIdentitySampleDto'];
+export type OrgChartInactiveVcsProviderDto = components['schemas']['OrgChartInactiveVcsProviderDto'];
+export type OrgChartInactiveVcsFieldDto = components['schemas']['OrgChartInactiveVcsFieldDto'];
+export type OrgChartInactiveVcsIdentitySampleDto = components['schemas']['OrgChartInactiveVcsIdentitySampleDto'];
+export type OrgChartInactiveVcsIdentityDto = components['schemas']['OrgChartInactiveVcsIdentityDto'];
 export type OrgChartStatusDto = components['schemas']['OrgChartStatusDto'];
 export type TenantSourceEntryDto = components['schemas']['TenantSourceEntryDto'];
 export type CursorSourceDto = components['schemas']['CursorSourceDto'];
@@ -16349,7 +16402,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Structure source, identity mappings, and effective chart summary */
+            /** @description Structure source, identity mappings, inactive-VCS samples, and effective chart summary */
             200: {
                 headers: {
                     [name: string]: unknown;