@thinkai/tai-api-contract 2.61.0 → 2.63.0

package/src/index.ts

@@ -1145,6 +1145,14 @@ export interface YourAiJourneyAnalyticsDto {
 /** 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/hero — first-paint BFF. */
+export interface YourAiJourneyHeroDto {
+  workspaceId: string;
+  generatedAt: string;
+  analytics: YourAiJourneyAnalyticsDto;
+  productivity: YourAiJourneyProductivityDto;
+}
+
 /** Response for GET /workspaces/:workspaceId/your-ai-journey/agentic-foundation — same shape as AgenticFoundationDashboardDto. */
 export type YourAiJourneyAgenticFoundationDto = AgenticFoundationDashboardDto;
 
@@ -1415,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,