@thinkai/tai-api-contract 2.96.0 → 2.98.0

package/src/generated/openapi.ts

@@ -561,6 +561,27 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/delivery-topology": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Set workspace delivery topology
+         * @description Persist the workspace delivery topology used by federated readiness assessment: which connected repos hold terraform / gitops / ci_templates / api_contracts artifacts, plus optional per-service overrides. Role and override `providerSlug` values must reference repos connected to this workspace, otherwise the request is rejected with `400 invalid_delivery_topology`. Send `null` (or `{ "deliveryTopology": null }`) to clear the topology.
+         *     Requires editor or admin workspace role.
+         */
+        put: operations["putWorkspaceDeliveryTopology"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/sources": {
         parameters: {
             query?: never;
@@ -4182,6 +4203,52 @@ export interface components {
             codeIntelligenceClaudeModel?: string | null;
             /** @description True when a dedicated `code_intelligence` source has a stored executionToken. */
             hasCodeIntelligenceExecutionToken?: boolean;
+            /** @description Federated-readiness delivery topology: which connected repos hold terraform / gitops / ci_templates / api_contracts truth for this workspace. Null when not configured. Change via `PUT /workspaces/{workspaceId}/delivery-topology`. */
+            deliveryTopology?: components["schemas"]["DeliveryTopologyDto"] | null;
+        };
+        DeliveryRoleConfigDto: {
+            /** @description Connected workspace repo (`owner/repo`) that holds this role's artifacts. */
+            providerSlug: string;
+            /**
+             * @description IaC engine hint (terraform role only).
+             * @enum {string}
+             */
+            engine?: "terraform" | "pulumi" | "cdk";
+            /**
+             * @description CI templates flavor (ci_templates role only).
+             * @enum {string}
+             */
+            type?: "reusable_workflows";
+            /** @description Set true for extension roles outside the known role keys. */
+            custom?: boolean;
+        };
+        RepoDeliveryOverrideDto: {
+            /** @enum {string} */
+            deliveryModel?: "auto" | "k8s_microservices" | "mobile_store" | "web_hosting" | "data_pipelines" | "monorepo" | "library" | "hybrid";
+            /** @description Per-service role → providerSlug overrides (merged over workspace roles). */
+            roles?: {
+                [key: string]: string;
+            };
+            /** @description Path prefix inside platform repos where this service's artifacts live. */
+            targetPathHint?: string;
+        };
+        DeliveryTopologyDto: {
+            /** @enum {string} */
+            deliveryModel: "auto" | "k8s_microservices" | "mobile_store" | "web_hosting" | "data_pipelines" | "monorepo" | "library" | "hybrid";
+            /** @enum {string} */
+            ciProvider: "github_actions" | "jenkins" | "gitlab" | "bitbucket" | "hybrid" | "external_documented";
+            /** @description True when infra/delivery artifacts live outside service repos. */
+            splitInfra: boolean;
+            /** @description Role → platform repo mapping. Known keys: terraform, gitops, ci_templates, jenkins_shared, mobile_release, hosting, data_platform, api_contracts, sonar_config. */
+            roles: {
+                [key: string]: components["schemas"]["DeliveryRoleConfigDto"];
+            };
+            /** @description Optional path template inside platform repos, e.g. `services/{repo_name}/` (`{repo_name}` and `{provider_slug}` placeholders supported). */
+            servicePathConvention?: string | null;
+            /** @description Per-service-repo overrides keyed by provider slug. */
+            repoOverrides: {
+                [key: string]: components["schemas"]["RepoDeliveryOverrideDto"];
+            };
         };
         TestConnectionResponseDto: {
             success: boolean;
@@ -4575,13 +4642,17 @@ export interface components {
             failures: string[];
             /** @description Failed GitHub Actions workflow runs for this UTC day when CI ingest is enabled. */
             failureItems?: components["schemas"]["ProductivityInsightsContributorFailureItemDto"][];
-            /** @description Optional PR rows with GitHub links when ingest stored URLs. */
+            /** @description Optional merged PR rows for day drilldown (label, optional GitHub URL, optional ship-weight score / pending flag). Includes label-only rows so unscored or URL-less merges still surface ship-weight state. */
             mergedPrItems?: components["schemas"]["ProductivityInsightsContributorMergedPrItemDto"][];
         };
         ProductivityInsightsContributorMergedPrItemDto: {
             label: string;
             /** Format: uri */
             url?: string;
+            /** @description v13 ship-weight score for this PR when scored (typically 0–10). */
+            shipWeight?: number;
+            /** @description True when this GitHub PR is still awaiting ship-weight scoring. */
+            shipWeightPending?: boolean;
         };
         ProductivityInsightsContributorFailureItemDto: {
             label: string;
@@ -6369,6 +6440,33 @@ export interface components {
             }[] | null;
             /** @description GitHub-reported repository size in KB (includes git history), refreshed on each readiness scan (#729). Compare against `eligibilityLimits.maxRepoSizeKb` on the list response to show per-repo "size / limit". When the size exceeds the limit the latest scan is recorded as `partial_failed` with `lastRunErrorCode = exceeded_repo_size_limit` and the repo is marked `ineligible`. Null until a scan has populated it. */
             sizeKb?: number | null;
+            /**
+             * @description Federated readiness: set when the repo was classified as a platform repository and scored with the reduced platform rubric profile. Null for service repos. The UI shows a "Platform repository" badge instead of comparing its score against service repos.
+             * @enum {string|null}
+             */
+            platformArchetype?: "terraform_platform" | "gitops_platform" | "ci_templates" | "api_contracts_platform" | null;
+            /** @description Federated readiness completeness for service repos: which linked platform roles (terraform/gitops/ci_templates/api_contracts, from the workspace delivery topology) are still missing scan evidence. Absent/null when no topology is configured or every declared role has fresh metadata (`complete: true`). */
+            linkedRoleAssessment?: components["schemas"]["LinkedRoleAssessmentDto"] | null;
+        };
+        LinkedRolePendingDto: {
+            /** @description Topology role key, e.g. terraform | gitops | ci_templates | api_contracts. */
+            role: string;
+            /** @description Platform repo (`owner/repo`) that must be scanned to satisfy this role. */
+            providerSlug: string;
+            /**
+             * @description `no_scan` — the platform repo has no successful readiness run yet; `no_metadata_emitted` — it was scanned but emitted no linkage for this service (wrong archetype or scan predates federated readiness); `stale` — metadata is older than the hard TTL (30 days) and must be refreshed by re-scanning the platform repo.
+             * @enum {string}
+             */
+            reason: "no_scan" | "no_metadata_emitted" | "stale";
+            /**
+             * Format: date-time
+             * @description Latest succeeded scan of the platform repo, when one exists.
+             */
+            lastRunAt?: string | null;
+        };
+        LinkedRoleAssessmentDto: {
+            complete: boolean;
+            pending: components["schemas"]["LinkedRolePendingDto"][];
         };
         /** @description Single-repo detail response. Identical to RepoReadinessScoreDto except dimensions use DimensionScoreDetailDto (criteriaDetails required per dimension). */
         RepoReadinessScoreDetailDto: {
@@ -6420,6 +6518,13 @@ export interface components {
             }[] | null;
             /** @description GitHub-reported repository size in KB, refreshed on each scan. See RepoReadinessScoreDto.sizeKb. */
             sizeKb?: number | null;
+            /**
+             * @description See RepoReadinessScoreDto.platformArchetype.
+             * @enum {string|null}
+             */
+            platformArchetype?: "terraform_platform" | "gitops_platform" | "ci_templates" | "api_contracts_platform" | null;
+            /** @description See RepoReadinessScoreDto.linkedRoleAssessment. */
+            linkedRoleAssessment?: components["schemas"]["LinkedRoleAssessmentDto"] | null;
         };
         AgenticFoundationDashboardSummaryDto: {
             repoCount: number;
@@ -7426,6 +7531,8 @@ export interface components {
             /** Format: date */
             weekStartIso: string;
             mergedPrs: number;
+            /** @description Sum of ship-weight scores for merged PRs in this week bucket. */
+            shipWeightSum?: number;
             ciFailRatePct: number;
             /** @description False when CI metrics were not available for this week bucket. */
             hasCiMetrics?: boolean;
@@ -7434,6 +7541,8 @@ export interface components {
             weeks: components["schemas"]["InsightsVelocityQualityWeek"][];
             targetFailRatePct: number;
             volumeGrowthPct: number;
+            /** @description Ship-weight volume growth vs the prior equal-length window. */
+            shipWeightVolumeGrowthPct?: number;
         };
         InsightsRecommendationsVelocityQualityResponse: components["schemas"]["InsightsRecommendationsVelocityQuality"] & {
             _meta: components["schemas"]["InsightsResponseMeta"];
@@ -8291,6 +8400,9 @@ export type JiraSourceConfigDto = components['schemas']['JiraSourceConfigDto'];
 export type AgentExecutionProviderDto = components['schemas']['AgentExecutionProviderDto'];
 export type PutCodeIntelligenceSettingsDto = components['schemas']['PutCodeIntelligenceSettingsDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
+export type DeliveryRoleConfigDto = components['schemas']['DeliveryRoleConfigDto'];
+export type RepoDeliveryOverrideDto = components['schemas']['RepoDeliveryOverrideDto'];
+export type DeliveryTopologyDto = components['schemas']['DeliveryTopologyDto'];
 export type TestConnectionResponseDto = components['schemas']['TestConnectionResponseDto'];
 export type CursorKeyUsageDto = components['schemas']['CursorKeyUsageDto'];
 export type AiToolSeatDto = components['schemas']['AiToolSeatDto'];
@@ -8464,6 +8576,8 @@ export type ReadinessScoreHistoryPointDto = components['schemas']['ReadinessScor
 export type ReadinessRepoScoreHistoryDto = components['schemas']['ReadinessRepoScoreHistoryDto'];
 export type WorkspaceReadinessScoreHistoryDto = components['schemas']['WorkspaceReadinessScoreHistoryDto'];
 export type RepoReadinessScoreDto = components['schemas']['RepoReadinessScoreDto'];
+export type LinkedRolePendingDto = components['schemas']['LinkedRolePendingDto'];
+export type LinkedRoleAssessmentDto = components['schemas']['LinkedRoleAssessmentDto'];
 export type RepoReadinessScoreDetailDto = components['schemas']['RepoReadinessScoreDetailDto'];
 export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
 export type PageMetaDto = components['schemas']['PageMetaDto'];
@@ -10242,6 +10356,50 @@ export interface operations {
             };
         };
     };
+    putWorkspaceDeliveryTopology: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeliveryTopologyDto"] | null;
+            };
+        };
+        responses: {
+            /** @description Topology persisted (or cleared). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid topology payload or unconnected repo referenced. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     putTenantSources: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -686,6 +686,10 @@ export interface ProductivityInsightsContributorProfileDto {
 export interface ProductivityInsightsContributorMergedPrItemDto {
   label: string;
   url?: string;
+  /** v13 ship-weight score for this PR when scored. */
+  shipWeight?: number;
+  /** True when this PR is still awaiting ship-weight scoring. */
+  shipWeightPending?: boolean;
 }
 
 /** One failed GitHub Actions workflow run on a contributor activity day. */
@@ -1617,6 +1621,8 @@ export interface InsightsRecommendationsRoiQuadrant {
 export interface InsightsVelocityQualityWeek {
   weekStartIso: string;
   mergedPrs: number;
+  /** Sum of ship-weight scores for merged PRs in this week bucket. */
+  shipWeightSum?: number;
   ciFailRatePct: number;
   /** False when CI metrics were not available for this week bucket. */
   hasCiMetrics?: boolean;
@@ -1626,6 +1632,8 @@ export interface InsightsRecommendationsVelocityQuality {
   weeks: InsightsVelocityQualityWeek[];
   targetFailRatePct: number;
   volumeGrowthPct: number;
+  /** Ship-weight volume growth vs prior equal-length window. */
+  shipWeightVolumeGrowthPct?: number;
 }
 
 export const INSIGHTS_REVIEW_STAGE_IDS = [