@thinkai/tai-api-contract 2.5.17 → 2.7.0

package/src/index.ts

@@ -3,6 +3,8 @@
  * The ONLY package the frontend may import.
  */
 
+import type { AgenticFoundationDashboardDto } from "./generated/openapi.js";
+
 /** Run metadata (window, ruleset, created). M5.4: optional tenantId, personId. */
 export interface RunMetadataDto {
   runId: string;
@@ -287,6 +289,8 @@ export interface DashboardProductivityMetricsDto {
   velocity?: {
     avgFirstCommitToPrDays?: number;
     prsPerDeveloperPerWeek?: number;
+    /** Raw merged PR count in the metrics window (all scopes). */
+    mergedPrCount?: number;
     avgPrMergeTimeHours?: number;
   };
   quality?: {
@@ -470,6 +474,10 @@ export interface ProductivityInsightsMergedPrContributorRowDto {
   personId: string;
   personName: string;
   teamName?: string;
+  /** True when the contributor is a GitHub login not mapped in the org chart. */
+  notInOrgChart?: boolean;
+  /** GitHub login for unattributed contributors (`notInOrgChart: true`). */
+  githubLogin?: string;
   weeks: ProductivityInsightsMergedPrTrendWeekDto[];
 }
 
@@ -832,4 +840,117 @@ export interface ExportEventsResponseDto {
 }
 
 /** OpenAPI path and operation typings (generated from `openapi/openapi.yaml`). */
-export type { paths, operations } from "./generated/openapi.js";
+export type { paths, operations, AgenticFoundationDashboardDto } from "./generated/openapi.js";
+
+// ---------------------------------------------------------------------------
+// Your AI Journey — /workspaces/:workspaceId/your-ai-journey/...
+// ---------------------------------------------------------------------------
+
+/** One week bucket in the PR-signals time series. */
+export interface YourAiJourneyPrSignalsWeekDto {
+  bucketStart: string;
+  bucketEnd: string;
+  weekLabel: string;
+  /** Average PRs per developer per week (from stored metrics). */
+  prsPerDeveloperPerWeek: number;
+  /** Change failure rate percent (from stored DORA metrics). */
+  changeFailureRatePercent: number;
+}
+
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/pr-signals */
+export interface YourAiJourneyPrSignalsDto {
+  workspaceId: string;
+  generatedAt: string;
+  windowStart: string;
+  windowEnd: string;
+  weeks: YourAiJourneyPrSignalsWeekDto[];
+  summary: {
+    avgPrsPerDeveloperPerWeek: number;
+    avgFailureRatePercent: number;
+    prVelocityDeltaPercent: number;
+  };
+}
+
+/** One dimension entry in the readiness aggregate. */
+export interface YourAiJourneyReadinessDimensionDto {
+  dimensionId: string;
+  name: string;
+  totalScore: number;
+  maxScore: number;
+  percent: number;
+}
+
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/readiness/aggregate */
+export interface YourAiJourneyReadinessAggregateDto {
+  workspaceId: string;
+  generatedAt: string;
+  dimensions: YourAiJourneyReadinessDimensionDto[];
+  summary: {
+    avgScore: number;
+    repoCount: number;
+    fixRate: number;
+    totalOpenIssues: number;
+    totalFixedIssues: number;
+  };
+}
+
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/analytics */
+export interface YourAiJourneyAnalyticsDto {
+  workspaceId: string;
+  generatedAt: string;
+  windowStart: string;
+  windowEnd: string;
+  journey: {
+    completedSteps: string[];
+    updatedAt: string | null;
+  };
+  readiness: {
+    avgScore: number;
+    repoCount: number;
+    fixRate: number;
+    totalOpenIssues: number;
+    totalFixedIssues: number;
+  };
+  prSignals: {
+    avgPrsPerDeveloperPerWeek: number;
+    prVelocityDeltaPercent: number;
+    avgFailureRatePercent: number;
+  };
+}
+
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/productivity — same shape as DashboardProductivityDto. */
+export type YourAiJourneyProductivityDto = DashboardProductivityDto;
+
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/agentic-foundation — same shape as AgenticFoundationDashboardDto. */
+export type YourAiJourneyAgenticFoundationDto = AgenticFoundationDashboardDto;
+
+/** One week in the AI spend series. */
+export interface YourAiJourneyAiSpendWeekDto {
+  bucketStart: string;
+  bucketEnd: string;
+  weekLabel: string;
+  mergedPrCount: number;
+  tokenCount: number;
+}
+
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/ai-spend */
+export interface YourAiJourneyAiSpendDto {
+  workspaceId: string;
+  generatedAt: string;
+  windowStart: string;
+  windowEnd: string;
+  totalSpendCents: number;
+  totalTokenCount: number;
+  activeUsers: number;
+  aiAssistedPrRatio: number;
+  prThroughputDeltaPercent: number;
+  usageDeltaPercent: number;
+  weeks: YourAiJourneyAiSpendWeekDto[];
+  providers: {
+    providerId: string;
+    providerName: string;
+    tokenCount: number;
+    spendCents: number;
+    activeUsers: number;
+  }[];
+}