@thinkai/tai-api-contract 2.34.0 → 2.35.0

package/dist/generated/openapi.d.ts

@@ -394,7 +394,7 @@ export interface paths {
         };
         /**
          * Productivity insights — contributor drilldown
-         * @description Weekly and daily activity rollups for a single contributor on `/phase-c/c4/contributors/:id`. Distributes weekly merged PR counts from precomputed person metrics across weekdays; includes fail-rate signals and period-over-period summary deltas. Accepts org-chart person ids (typically email) and synthetic GitHub scopes (`__github:{login}`) for contributors not in the org chart.
+         * @description Weekly and daily activity rollups for a single contributor on `/insights/productivity/contributors/:loginOrId`. Accepts GitHub login slugs (preferred public URL), org-chart person ids (typically email), and synthetic GitHub scopes (`__github:{login}`) for contributors not in the org chart.
          */
         get: operations["getProductivityInsightsContributor"];
         put?: never;
@@ -641,7 +641,7 @@ export interface paths {
         put?: never;
         /**
          * Create GitHub App installation URL
-         * @description Creates a GitHub App installation URL scoped to the workspace and caller. Body is optional; when omitted, defaults to `/phase-a/p4` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
+         * @description Creates a GitHub App installation URL scoped to the workspace and caller. Body is optional; when omitted, defaults to `/onboarding/integrations` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
          */
         post: operations["postGithubInstallUrl"];
         delete?: never;
@@ -1120,6 +1120,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/repos/by-slug/{providerSlug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Single repo readiness by provider slug
+         * @description Returns one stored repository scorecard keyed by `providerSlug` (`owner/repo`). Same response as `GET .../readiness/repos/{repoId}`. Unknown slug returns `404`.
+         */
+        get: operations["getReadinessRepoBySlug"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/repos/{repoId}": {
         parameters: {
             query?: never;
@@ -1900,7 +1920,7 @@ export interface paths {
         };
         /**
          * 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.
+         * @description Returns the workspace-scoped journey progress state. Returns an empty `completedStepIds` array when no row exists yet (updatedAt is synthetic in that case). Values are canonical step IDs (see `JourneyStepId`); legacy route strings are accepted on PUT and normalized. Covers issue #271.
          */
         get: operations["getYourAiJourneyProgress"];
         /**
@@ -3762,14 +3782,31 @@ export interface components {
         AiStrategyPlanDto: {
             phases: components["schemas"]["AiStrategyPhaseBlockDto"][];
         };
+        /**
+         * @description Canonical journey step identifier (stable across URL reshuffles).
+         * @enum {string}
+         */
+        JourneyStepId: "onboarding.workspace" | "onboarding.ai_readiness" | "onboarding.integrations" | "readiness.dashboard" | "readiness.fix_queue" | "readiness.activity" | "insights.productivity" | "insights.productivity.by_user" | "insights.productivity.by_team" | "insights.ai_usage" | "insights.ai_usage.by_user" | "insights.ai_usage.by_team" | "insights.ai_usage.by_model";
         JourneyProgressDto: {
-            completedSteps: string[];
+            /** @description Canonical completed journey step IDs. */
+            completedStepIds: components["schemas"]["JourneyStepId"][];
+            /**
+             * @deprecated
+             * @description Deprecated alias of completedStepIds (legacy clients). Omitted on new responses when empty.
+             */
+            completedSteps?: string[];
             /** Format: date-time */
             updatedAt: string;
         };
         JourneyProgressUpdateDto: {
-            completedSteps: string[];
-        };
+            /** @description Idempotent replace-all of completed step IDs. */
+            completedStepIds?: components["schemas"]["JourneyStepId"][];
+            /**
+             * @deprecated
+             * @description Deprecated input alias — route strings and legacy `/phase-*` paths are normalized to step IDs.
+             */
+            completedSteps?: string[];
+        } | unknown | unknown;
         /** @enum {string} */
         ThemePreference: "light" | "dark" | "system";
         NotificationPreferencesDto: {
@@ -3891,7 +3928,9 @@ export interface components {
             /** Format: date-time */
             windowEnd: string;
             journey: {
-                completedSteps: string[];
+                completedStepIds: components["schemas"]["JourneyStepId"][];
+                /** @deprecated */
+                completedSteps?: string[];
                 /** Format: date-time */
                 updatedAt: string | null;
             };
@@ -4214,6 +4253,8 @@ export interface components {
     parameters: {
         WorkspaceId: string;
         RepoId: string;
+        /** @description Provider repository slug in `owner/repo` form (GitHub). Used for shareable public URLs; resolves to the same row as `repoId` UUID internally. */
+        ProviderSlug: string;
         ProjectId: string;
         NotificationId: string;
         /** @description Workspace member user id (`tai_users.id`). */
@@ -4423,6 +4464,7 @@ export type AiStrategyRecommendBodyDto = components['schemas']['AiStrategyRecomm
 export type AiStrategyTaskRecommendationDto = components['schemas']['AiStrategyTaskRecommendationDto'];
 export type AiStrategyPhaseBlockDto = components['schemas']['AiStrategyPhaseBlockDto'];
 export type AiStrategyPlanDto = components['schemas']['AiStrategyPlanDto'];
+export type JourneyStepId = components['schemas']['JourneyStepId'];
 export type JourneyProgressDto = components['schemas']['JourneyProgressDto'];
 export type JourneyProgressUpdateDto = components['schemas']['JourneyProgressUpdateDto'];
 export type ThemePreference = components['schemas']['ThemePreference'];
@@ -4460,6 +4502,7 @@ export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
 export type ParameterRepoId = components['parameters']['RepoId'];
+export type ParameterProviderSlug = components['parameters']['ProviderSlug'];
 export type ParameterProjectId = components['parameters']['ProjectId'];
 export type ParameterNotificationId = components['parameters']['NotificationId'];
 export type ParameterWorkspaceMemberId = components['parameters']['WorkspaceMemberId'];
@@ -5509,7 +5552,7 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                /** @description Org-chart person id or synthetic GitHub scope id (`__github:{login}`). */
+                /** @description GitHub login slug, org-chart person id, or synthetic `__github:{login}` scope id. */
                 contributorId: string;
             };
             cookie?: never;
@@ -7318,6 +7361,50 @@ export interface operations {
             };
         };
     };
+    getReadinessRepoBySlug: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Provider repository slug in `owner/repo` form (GitHub). Used for shareable public URLs; resolves to the same row as `repoId` UUID internally. */
+                providerSlug: components["parameters"]["ProviderSlug"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repo score */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDetailDto"];
+                };
+            };
+            /** @description Malformed providerSlug */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repository not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getReadinessRepo: {
         parameters: {
             query?: never;
@@ -8908,7 +8995,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Progress (empty completedSteps when no row exists yet; updatedAt is synthetic in that case) */
+            /** @description Progress (empty completedStepIds when no row exists yet; updatedAt is synthetic in that case) */
             200: {
                 headers: {
                     [name: string]: unknown;