@thinkai/tai-api-contract 2.5.17 → 2.6.0

package/src/generated/openapi.ts

@@ -1335,6 +1335,150 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/your-ai-journey/analytics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Combined analytics summary for the /dashboard page
+         * @description Returns a single aggregated payload combining journey step progress, readiness summary, and PR-signal headline metrics. Covers issue #268. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyAnalytics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/pr-signals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Weekly PR velocity and change-failure-rate time series
+         * @description Returns a per-week time series of PR throughput and DORA change-failure-rate metrics, sourced from stored dashboard metrics. Covers issue #269. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyPrSignals"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/readiness/aggregate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-dimension readiness aggregate across all repos
+         * @description Aggregates stored readiness scores across all workspace repos by dimension. Covers issue #270. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyReadinessAggregate"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/journey/progress": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace journey step completion
+         * @description Returns the workspace-scoped journey progress state. Returns an empty `completedSteps` list with a synthetic `updatedAt` if no row exists yet. Covers issue #271.
+         */
+        get: operations["getYourAiJourneyProgress"];
+        /**
+         * Replace workspace journey completed steps
+         * @description Idempotent replace-all of completed route strings for the workspace journey. Requires editor role. Covers issue #271.
+         */
+        put: operations["putYourAiJourneyProgress"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/agentic-foundation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Agentic foundation dashboard slice for /dashboard
+         * @description Returns the same `AgenticFoundationDashboardDto` payload as `GET /agentic-foundation/dashboard`, scoped to the /dashboard page context. Covers issue #272. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyAgenticFoundation"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/productivity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace productivity metrics for /dashboard
+         * @description Returns the most recent stored dashboard productivity metrics snapshot that overlaps the requested window (defaults to the trailing 7 days). Same schema as `GET /dashboard/productivity`. Covers issue #273. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyProductivity"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/ai-spend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI tool spend and usage aggregated by week and provider
+         * @description Returns token usage and spend aggregated from connected AI tool sources (e.g. Cursor) over the requested range, broken down by week and provider. Covers issue #274. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyAiSpend"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -1580,6 +1724,10 @@ export interface components {
             personId: string;
             personName: string;
             teamName?: string;
+            /** @description True when the contributor GitHub login is not mapped in the org chart. */
+            notInOrgChart?: boolean;
+            /** @description GitHub login for unattributed contributors (when notInOrgChart is true). */
+            githubLogin?: string;
             weeks: components["schemas"]["ProductivityInsightsMergedPrTrendWeekDto"][];
         };
         ProductivityInsightsMergedPrTrendsDto: {
@@ -1590,7 +1738,7 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
-            /** @description Portfolio aggregate merged PR counts (sum of filtered contributors per week). */
+            /** @description Portfolio aggregate merged PR counts from org-scope metrics (all merged PRs in window). */
             weeks: components["schemas"]["ProductivityInsightsMergedPrTrendWeekDto"][];
             contributors: components["schemas"]["ProductivityInsightsMergedPrContributorRowDto"][];
         };
@@ -2438,6 +2586,115 @@ export interface components {
             /** @description Path in `org-charts` bucket after Supabase upload */
             storagePath: string;
         };
+        YourAiJourneyPrSignalsWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            /** @description Display label in MM/DD format. */
+            weekLabel: string;
+            prsPerDeveloperPerWeek: number;
+            changeFailureRatePercent: number;
+        };
+        YourAiJourneyPrSignalsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            /** Format: date-time */
+            windowStart: string;
+            /** Format: date-time */
+            windowEnd: string;
+            weeks: components["schemas"]["YourAiJourneyPrSignalsWeekDto"][];
+            summary: {
+                avgPrsPerDeveloperPerWeek: number;
+                avgFailureRatePercent: number;
+                prVelocityDeltaPercent: number;
+            };
+        };
+        YourAiJourneyReadinessDimensionDto: {
+            dimensionId: string;
+            name: string;
+            totalScore: number;
+            maxScore: number;
+            /** @description Rounded percentage 0–100. */
+            percent: number;
+        };
+        YourAiJourneyReadinessAggregateDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            dimensions: components["schemas"]["YourAiJourneyReadinessDimensionDto"][];
+            summary: {
+                avgScore: number;
+                repoCount: number;
+                fixRate: number;
+                totalOpenIssues: number;
+                totalFixedIssues: number;
+            };
+        };
+        YourAiJourneyAnalyticsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            /** Format: date-time */
+            windowStart: string;
+            /** Format: date-time */
+            windowEnd: string;
+            journey: {
+                completedSteps: string[];
+                /** Format: date-time */
+                updatedAt: string | null;
+            };
+            readiness: {
+                avgScore: number;
+                repoCount: number;
+                fixRate: number;
+                totalOpenIssues: number;
+                totalFixedIssues: number;
+            };
+            prSignals: {
+                avgPrsPerDeveloperPerWeek: number;
+                prVelocityDeltaPercent: number;
+                avgFailureRatePercent: number;
+            };
+        };
+        YourAiJourneyAiSpendWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            weekLabel: string;
+            mergedPrCount: number;
+            tokenCount: number;
+        };
+        YourAiJourneyAiSpendDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            /** Format: date-time */
+            windowStart: string;
+            /** Format: date-time */
+            windowEnd: string;
+            totalSpendCents: number;
+            totalTokenCount: number;
+            activeUsers: number;
+            /** @description Fraction 0–1 of PRs that are AI-assisted. */
+            aiAssistedPrRatio: number;
+            prThroughputDeltaPercent: number;
+            usageDeltaPercent: number;
+            weeks: components["schemas"]["YourAiJourneyAiSpendWeekDto"][];
+            providers: {
+                providerId: string;
+                providerName: string;
+                tokenCount: number;
+                spendCents: number;
+                activeUsers: number;
+            }[];
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -2600,6 +2857,13 @@ export type PreferencesDto = components['schemas']['PreferencesDto'];
 export type ValidationIssueDto = components['schemas']['ValidationIssueDto'];
 export type PreferencesValidationErrorDto = components['schemas']['PreferencesValidationErrorDto'];
 export type OrgChartImportBodyDto = components['schemas']['OrgChartImportBodyDto'];
+export type YourAiJourneyPrSignalsWeekDto = components['schemas']['YourAiJourneyPrSignalsWeekDto'];
+export type YourAiJourneyPrSignalsDto = components['schemas']['YourAiJourneyPrSignalsDto'];
+export type YourAiJourneyReadinessDimensionDto = components['schemas']['YourAiJourneyReadinessDimensionDto'];
+export type YourAiJourneyReadinessAggregateDto = components['schemas']['YourAiJourneyReadinessAggregateDto'];
+export type YourAiJourneyAnalyticsDto = components['schemas']['YourAiJourneyAnalyticsDto'];
+export type YourAiJourneyAiSpendWeekDto = components['schemas']['YourAiJourneyAiSpendWeekDto'];
+export type YourAiJourneyAiSpendDto = components['schemas']['YourAiJourneyAiSpendDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
@@ -5728,4 +5992,299 @@ export interface operations {
             };
         };
     };
+    getYourAiJourneyAnalytics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Analytics summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyAnalyticsDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyPrSignals: {
+        parameters: {
+            query?: {
+                /** @description Number of weekly buckets to return (1–52; default 8). */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Weekly PR signals */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyPrSignalsDto"];
+                };
+            };
+            /** @description Invalid query parameter (limit out of range) */
+            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"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyReadinessAggregate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Readiness aggregate */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyReadinessAggregateDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyProgress: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Journey progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["JourneyProgressDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putYourAiJourneyProgress: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["JourneyProgressUpdateDto"];
+            };
+        };
+        responses: {
+            /** @description Saved progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["JourneyProgressDto"];
+                };
+            };
+            /** @description Body fails validation (non-array, invalid entries, too many steps) */
+            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"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyAgenticFoundation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Agentic foundation dashboard */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgenticFoundationDashboardDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyProductivity: {
+        parameters: {
+            query?: {
+                /** @description Upper bound of the requested window (ISO 8601; defaults to now). */
+                windowEnd?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Productivity metrics snapshot */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DashboardProductivityDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyAiSpend: {
+        parameters: {
+            query?: {
+                /** @description Time range — `4w` (4 weeks), `8w` (8 weeks), or `q` (quarter, 12 weeks). */
+                rangeId?: "4w" | "8w" | "q";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description AI spend aggregation */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyAiSpendDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
 }