@thinkai/tai-api-contract 2.62.0 → 2.63.0

package/src/generated/openapi.ts

@@ -923,6 +923,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/sdlc/overview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * SDLC insights — Engineering Health overview
+         * @description Engineering Health dashboard for `/insights/sdlc/overview`. Returns precomputed DORA, CI, collaboration, security, governance, and operational metrics aggregated at calendar-day granularity for the selected window. Filter params mirror other Measure insights routes plus optional `repoIds` scope.
+         */
+        get: operations["getSdlcInsightsOverview"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/sdlc/drilldown/{metricId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * SDLC insights — metric drill-down entities
+         * @description Paginated entity list for a single Engineering Health metric (failed workflow runs, PRs, alerts, etc.). Available only when the overview marks `drilldownAvailable: true`.
+         */
+        get: operations["getSdlcInsightsDrilldown"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/members": {
         parameters: {
             query?: never;
@@ -6116,6 +6156,79 @@ export interface components {
              */
             lastSeenAt: string;
         };
+        /** @enum {string} */
+        SdlcModuleId: "dora" | "ci-pipeline" | "collaboration-pr" | "security-risk" | "governance-architecture" | "financial-operational";
+        /** @enum {string} */
+        SdlcMetricId: "dora-deployment-frequency" | "dora-lead-time" | "dora-cfr" | "dora-mttr" | "ci-success-rate" | "ci-duration-p50-p95" | "ci-flakiness" | "ci-queue-wait" | "ci-cache-hit" | "pr-review-time" | "pr-bus-factor" | "pr-size" | "pr-abandonment" | "pr-review-depth" | "pr-draft-duration" | "pr-merge-conflicts" | "pr-commit-density" | "sec-dependabot-backlog" | "sec-vuln-mttr" | "sec-secret-scanning" | "sec-self-approvals" | "sec-unreviewed-merge" | "gov-branch-protection" | "gov-stale-branches" | "gov-orphaned-repos" | "gov-readme-health" | "gov-codeowners" | "gov-issue-pr-linkage" | "fin-gha-minutes" | "fin-copilot-utilization" | "fin-org-inactivity" | "fin-env-drift" | "fin-release-cadence" | "fin-api-rate-limit";
+        /** @enum {string} */
+        SdlcMetricDataStatus: "live" | "preview" | "unavailable";
+        /** @enum {string} */
+        SdlcMetricHealthStatus: "healthy" | "warning" | "critical" | "unknown";
+        /** @enum {string} */
+        SdlcBenchmarkBand: "elite" | "high" | "medium" | "low";
+        SdlcMetricTrendDto: {
+            /** @enum {string} */
+            direction: "up" | "down" | "flat";
+            deltaPercent?: number;
+        };
+        SdlcDailySeriesPointDto: {
+            /**
+             * Format: date
+             * @description Inclusive ISO calendar day (UTC).
+             */
+            date: string;
+            value: number;
+        };
+        SdlcMetricDto: {
+            id: components["schemas"]["SdlcMetricId"];
+            name: string;
+            dataStatus: components["schemas"]["SdlcMetricDataStatus"];
+            healthStatus: components["schemas"]["SdlcMetricHealthStatus"];
+            value: (number | string) | null;
+            unit?: string;
+            secondaryValue?: (number | string) | null;
+            secondaryLabel?: string;
+            trend?: components["schemas"]["SdlcMetricTrendDto"];
+            benchmarkBand?: components["schemas"]["SdlcBenchmarkBand"];
+            drilldownAvailable: boolean;
+            dailySeries?: components["schemas"]["SdlcDailySeriesPointDto"][];
+            unavailableReason?: string;
+        };
+        SdlcModuleDto: {
+            id: components["schemas"]["SdlcModuleId"];
+            name: string;
+            metrics: components["schemas"]["SdlcMetricDto"][];
+        };
+        SdlcOverviewDto: {
+            rangeId: string;
+            /** Format: date */
+            from: string;
+            /** Format: date */
+            to: string;
+            department: string;
+            team: string;
+            repoIds: string[];
+            /** Format: date-time */
+            asOf: string;
+            modules: components["schemas"]["SdlcModuleDto"][];
+        };
+        SdlcDrilldownItemDto: {
+            id: string;
+            title: string;
+            subtitle?: string;
+            /** Format: uri */
+            url?: string;
+            /** Format: date-time */
+            occurredAt?: string;
+            metadata?: {
+                [key: string]: string | number;
+            };
+        };
+        SdlcDrilldownDto: {
+            metricId: components["schemas"]["SdlcMetricId"];
+            items: components["schemas"]["SdlcDrilldownItemDto"][];
+            nextCursor?: string;
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -6169,6 +6282,8 @@ export interface components {
         InsightsProductivityFrom: string;
         /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
         InsightsProductivityTo: string;
+        /** @description Day-level Measure window. Presets: `7d`, `30d`, `90d`, `180d`. Custom inclusive calendar range: `cr:YYYY-MM-DD:YYYY-MM-DD` (max span 180 days). */
+        InsightsSdlcRangeId: string;
         /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
         InsightsDepartmentFilter: string;
         /** @description Page size (default 25, max 100). */
@@ -6495,6 +6610,18 @@ export type HrisProviderSyncResultDto = components['schemas']['HrisProviderSyncR
 export type ActivityLogPageDto = components['schemas']['ActivityLogPageDto'];
 export type ReadinessTokenUsageRowDto = components['schemas']['ReadinessTokenUsageRowDto'];
 export type ReadinessTokenUsageByDimensionRowDto = components['schemas']['ReadinessTokenUsageByDimensionRowDto'];
+export type SdlcModuleId = components['schemas']['SdlcModuleId'];
+export type SdlcMetricId = components['schemas']['SdlcMetricId'];
+export type SdlcMetricDataStatus = components['schemas']['SdlcMetricDataStatus'];
+export type SdlcMetricHealthStatus = components['schemas']['SdlcMetricHealthStatus'];
+export type SdlcBenchmarkBand = components['schemas']['SdlcBenchmarkBand'];
+export type SdlcMetricTrendDto = components['schemas']['SdlcMetricTrendDto'];
+export type SdlcDailySeriesPointDto = components['schemas']['SdlcDailySeriesPointDto'];
+export type SdlcMetricDto = components['schemas']['SdlcMetricDto'];
+export type SdlcModuleDto = components['schemas']['SdlcModuleDto'];
+export type SdlcOverviewDto = components['schemas']['SdlcOverviewDto'];
+export type SdlcDrilldownItemDto = components['schemas']['SdlcDrilldownItemDto'];
+export type SdlcDrilldownDto = components['schemas']['SdlcDrilldownDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ResponseZenHrSyncInProgress = components['responses']['ZenHrSyncInProgress'];
@@ -6509,6 +6636,7 @@ export type ParameterFixId = components['parameters']['FixId'];
 export type ParameterInsightsProductivityRangeId = components['parameters']['InsightsProductivityRangeId'];
 export type ParameterInsightsProductivityFrom = components['parameters']['InsightsProductivityFrom'];
 export type ParameterInsightsProductivityTo = components['parameters']['InsightsProductivityTo'];
+export type ParameterInsightsSdlcRangeId = components['parameters']['InsightsSdlcRangeId'];
 export type ParameterInsightsDepartmentFilter = components['parameters']['InsightsDepartmentFilter'];
 export type ParameterPaginationLimit = components['parameters']['PaginationLimit'];
 export type ParameterPaginationOffset = components['parameters']['PaginationOffset'];
@@ -9101,6 +9229,112 @@ export interface operations {
             };
         };
     };
+    getSdlcInsightsOverview: {
+        parameters: {
+            query?: {
+                /** @description Day-level Measure window. Presets: `7d`, `30d`, `90d`, `180d`. Custom inclusive calendar range: `cr:YYYY-MM-DD:YYYY-MM-DD` (max span 180 days). */
+                rangeId?: components["parameters"]["InsightsSdlcRangeId"];
+                /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
+                department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description Team name filter; send `All teams` to include every team. */
+                team?: string;
+                /** @description Comma-separated internal repo ids; omit or empty for all repos. */
+                repoIds?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Engineering Health overview payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdlcOverviewDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getSdlcInsightsDrilldown: {
+        parameters: {
+            query?: {
+                /** @description Day-level Measure window. Presets: `7d`, `30d`, `90d`, `180d`. Custom inclusive calendar range: `cr:YYYY-MM-DD:YYYY-MM-DD` (max span 180 days). */
+                rangeId?: components["parameters"]["InsightsSdlcRangeId"];
+                /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
+                department?: components["parameters"]["InsightsDepartmentFilter"];
+                team?: string;
+                repoIds?: string;
+                /** @description Opaque pagination cursor from a prior response. */
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                metricId: components["schemas"]["SdlcMetricId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Drill-down page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdlcDrilldownDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or metric not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getAiToolMembers: {
         parameters: {
             query?: {

package/src/index.ts

@@ -1423,6 +1423,120 @@ export interface AiToolMemberDetailDto {
   heatmap: AiToolMemberHeatmapDayDto[];
 }
 
+/** Canonical SDLC Engineering Health module ids. */
+export const SDL_C_MODULE_IDS = [
+  "dora",
+  "ci-pipeline",
+  "collaboration-pr",
+  "security-risk",
+  "governance-architecture",
+  "financial-operational",
+] as const;
+export type SdlcModuleId = (typeof SDL_C_MODULE_IDS)[number];
+
+/** Canonical SDLC Engineering Health metric ids (34). */
+export const SDL_C_METRIC_IDS = [
+  "dora-deployment-frequency",
+  "dora-lead-time",
+  "dora-cfr",
+  "dora-mttr",
+  "ci-success-rate",
+  "ci-duration-p50-p95",
+  "ci-flakiness",
+  "ci-queue-wait",
+  "ci-cache-hit",
+  "pr-review-time",
+  "pr-bus-factor",
+  "pr-size",
+  "pr-abandonment",
+  "pr-review-depth",
+  "pr-draft-duration",
+  "pr-merge-conflicts",
+  "pr-commit-density",
+  "sec-dependabot-backlog",
+  "sec-vuln-mttr",
+  "sec-secret-scanning",
+  "sec-self-approvals",
+  "sec-unreviewed-merge",
+  "gov-branch-protection",
+  "gov-stale-branches",
+  "gov-orphaned-repos",
+  "gov-readme-health",
+  "gov-codeowners",
+  "gov-issue-pr-linkage",
+  "fin-gha-minutes",
+  "fin-copilot-utilization",
+  "fin-org-inactivity",
+  "fin-env-drift",
+  "fin-release-cadence",
+  "fin-api-rate-limit",
+] as const;
+export type SdlcMetricId = (typeof SDL_C_METRIC_IDS)[number];
+
+export type SdlcMetricDataStatus = "live" | "preview" | "unavailable";
+export type SdlcMetricHealthStatus = "healthy" | "warning" | "critical" | "unknown";
+export type SdlcBenchmarkBand = "elite" | "high" | "medium" | "low";
+
+export interface SdlcMetricTrendDto {
+  direction: "up" | "down" | "flat";
+  deltaPercent?: number;
+}
+
+export interface SdlcDailySeriesPointDto {
+  date: string;
+  value: number;
+}
+
+export interface SdlcMetricDto {
+  id: SdlcMetricId;
+  name: string;
+  dataStatus: SdlcMetricDataStatus;
+  healthStatus: SdlcMetricHealthStatus;
+  value: number | string | null;
+  unit?: string;
+  secondaryValue?: number | string | null;
+  secondaryLabel?: string;
+  trend?: SdlcMetricTrendDto;
+  benchmarkBand?: SdlcBenchmarkBand;
+  drilldownAvailable: boolean;
+  dailySeries?: SdlcDailySeriesPointDto[];
+  unavailableReason?: string;
+}
+
+export interface SdlcModuleDto {
+  id: SdlcModuleId;
+  name: string;
+  metrics: SdlcMetricDto[];
+}
+
+/** Response for GET /workspaces/:workspaceId/insights/sdlc/overview */
+export interface SdlcOverviewDto {
+  rangeId: string;
+  from: string;
+  to: string;
+  department: string;
+  team: string;
+  repoIds: string[];
+  asOf: string;
+  modules: SdlcModuleDto[];
+}
+
+export interface SdlcDrilldownItemDto {
+  id: string;
+  title: string;
+  subtitle?: string;
+  url?: string;
+  occurredAt?: string;
+  metadata?: Record<string, string | number>;
+}
+
+/** Response for GET /workspaces/:workspaceId/insights/sdlc/drilldown/{metricId} */
+export interface SdlcDrilldownDto {
+  metricId: SdlcMetricId;
+  items: SdlcDrilldownItemDto[];
+  nextCursor?: string;
+}
+
 export {
   JOURNEY_STEP_IDS,
   JOURNEY_STEP_REGISTRY,