@thinkai/tai-api-contract 2.98.0 → 2.100.0

package/src/generated/openapi.ts

@@ -1315,7 +1315,11 @@ export interface paths {
          */
         get: operations["getCodeInsightsRepoDetail"];
         put?: never;
-        post?: never;
+        /**
+         * Code Insights — enqueue Design risks analysis
+         * @description Enqueues an on-demand Design risks run (`run_kind=code_insights_design`) for the repository. Reuses the readiness worker queue but never grades the readiness rubric. Editor/admin only. Returns `409` when a design run is already queued or running for the same provider slug (independent of readiness runs).
+         */
+        post: operations["postCodeInsightsDesignAnalyze"];
         delete?: never;
         options?: never;
         head?: never;
@@ -7128,7 +7132,7 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed";
         ActivityLogActorDto: {
             /** Format: uuid */
             userId: string;
@@ -8082,10 +8086,10 @@ export interface components {
         /** @enum {string} */
         CodeInsightsFindingSeverity: "critical" | "high" | "medium" | "low";
         /**
-         * @description Deterministic categories (`duplication`, `complexity`, `proliferation`, `coverage`) plus LLM semantic detectors (`anemic_domain`, `context_leak`, `tx_boundary`, `error_handling`, `config_cohesion`, `resilience_patterns`).
+         * @description Deterministic categories (`duplication`, `complexity`, `proliferation`, `coverage`, `circular_deps`, `fan_in_hotspot`) plus LLM semantic detectors (`anemic_domain`, `context_leak`, `tx_boundary`, `error_handling`, `config_cohesion`, `resilience_patterns`). Coupling categories are written only by Design risks runs (`source=deterministic` on the design run id).
          * @enum {string}
          */
-        CodeInsightsFindingCategory: "duplication" | "complexity" | "proliferation" | "coverage" | "anemic_domain" | "context_leak" | "tx_boundary" | "error_handling" | "config_cohesion" | "resilience_patterns";
+        CodeInsightsFindingCategory: "duplication" | "complexity" | "proliferation" | "coverage" | "anemic_domain" | "context_leak" | "tx_boundary" | "error_handling" | "config_cohesion" | "resilience_patterns" | "circular_deps" | "fan_in_hotspot";
         /**
          * @description `deterministic` = measured Code Insights rules; `llm` = AI-detected semantic findings (separate agent pass; never blended in scoring).
          * @enum {string}
@@ -8204,8 +8208,27 @@ export interface components {
             /** @description Null when the repo is pending its first metrics scan. */
             metrics: components["schemas"]["CodeInsightsMetricsDto"] | null;
             hotspots: components["schemas"]["CodeInsightsHotspotDto"][];
-            /** @description Findings from the latest scan only (history is retention-bounded). */
+            /** @description Deterministic findings from the latest metrics scan plus LLM findings from the latest **succeeded** Design risks run only. Stale LLM rows from older design runs are not returned. */
             findings: components["schemas"]["CodeInsightsFindingDto"][];
+            /** @description Latest Design risks run of any status (for UI polling). Null when Design risks has never been enqueued for this repo. */
+            designAnalysis: components["schemas"]["CodeInsightsDesignAnalysisDto"] | null;
+        };
+        CodeInsightsDesignAnalysisDto: {
+            /** Format: uuid */
+            runId: string;
+            /** @enum {string} */
+            status: "queued" | "running" | "succeeded" | "failed" | "partial_failed";
+            /** Format: date-time */
+            finishedAt: string | null;
+            errorCode: string | null;
+            errorDetail: string | null;
+        };
+        CodeInsightsDesignAnalyzeResponseDto: {
+            /**
+             * Format: uuid
+             * @description Enqueued Design risks run id (`tai_workspace_readiness_runs.id`).
+             */
+            runId: string;
         };
         CodeInsightsOrgHotspotDto: components["schemas"]["CodeInsightsHotspotDto"] & {
             /** Format: uuid */
@@ -8766,6 +8789,8 @@ export type CodeInsightsFindingsBySeverityDto = components['schemas']['CodeInsig
 export type CodeInsightsRepoListItemDto = components['schemas']['CodeInsightsRepoListItemDto'];
 export type CodeInsightsRepoListDto = components['schemas']['CodeInsightsRepoListDto'];
 export type CodeInsightsRepoDetailDto = components['schemas']['CodeInsightsRepoDetailDto'];
+export type CodeInsightsDesignAnalysisDto = components['schemas']['CodeInsightsDesignAnalysisDto'];
+export type CodeInsightsDesignAnalyzeResponseDto = components['schemas']['CodeInsightsDesignAnalyzeResponseDto'];
 export type CodeInsightsOrgHotspotDto = components['schemas']['CodeInsightsOrgHotspotDto'];
 export type CodeInsightsSonarDto = components['schemas']['CodeInsightsSonarDto'];
 export type CodeInsightsSummaryDto = components['schemas']['CodeInsightsSummaryDto'];
@@ -12412,6 +12437,59 @@ export interface operations {
             };
         };
     };
+    postCodeInsightsDesignAnalyze: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Internal repo UUID (`tai_workspace_repos.id`). */
+                repoId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Design risks analysis enqueued */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeInsightsDesignAnalyzeResponseDto"];
+                };
+            };
+            /** @description Malformed repoId, unsupported provider, or GitHub not connected */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repo does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description An active Design risks run already exists for this repo slug */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAiToolMembers: {
         parameters: {
             query?: {

package/src/index.ts

@@ -31,7 +31,7 @@ export interface ScoreDto {
   createdAt?: string;
   tenantId?: string;
   personId?: string;
-   /** Optional fingerprint of sources config used when this score was computed. */
+  /** Optional fingerprint of sources config used when this score was computed. */
   sourcesVersion?: string;
   metrics: Record<string, number>;
   dimensionScores: Record<string, number>;
@@ -892,11 +892,7 @@ export type AiAssistedCodeDataQuality = "estimated" | "measured";
 
 /** How AI-assisted code % was derived when not measured from productivity ingest. */
 export type AiAssistedCodeEstimationSource =
-  | "ingest"
-  | "token_volume"
-  | "spend_proxy"
-  | "adoption"
-  | "unavailable";
+  "ingest" | "token_volume" | "spend_proxy" | "adoption" | "unavailable";
 
 /** One weekly bucket in the AI-assisted code percentage series. */
 export interface AiUsageSpendAiAssistedCodeWeekDto {

package/src/journeySteps.test.ts

@@ -36,7 +36,10 @@ if (droppedUnknown.unknown?.length !== 1 || droppedUnknown.unknown[0] !== "/stal
 }
 
 const rejectUnknown = parseJourneyStepInputs(["/stale/route"], { rejectUnknown: true });
-if (rejectUnknown.error !== "Unknown journey step" || rejectUnknown.unknown?.[0] !== "/stale/route") {
+if (
+  rejectUnknown.error !== "Unknown journey step" ||
+  rejectUnknown.unknown?.[0] !== "/stale/route"
+) {
   throw new Error(`rejectUnknown failed: ${JSON.stringify(rejectUnknown)}`);
 }