@thinkai/tai-api-contract 2.8.4 → 2.8.5

package/dist/generated/openapi.d.ts

@@ -934,6 +934,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/audit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Foundation activity audit log
+         * @description Paginated chronological feed of Agentic Foundation events for a workspace: readiness scans, fix requests, PR merges, and score changes derived from existing run and fix tables. Never includes secrets or raw tokens. Config-change events are not included until dedicated event storage exists (issue #473).
+         */
+        get: operations["listReadinessAudit"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/score-history": {
         parameters: {
             query?: never;
@@ -2047,10 +2067,15 @@ export interface components {
             items: components["schemas"]["AiUsageSpendKeyInsightItemDto"][];
         };
         /**
-         * @description **measured** — derived from scoped productivity ingest (`aiAdoption.aiAssistedContributionRatioPercent`). **estimated** — derived from AI-tool token volume heuristics when ingest ratios are absent for that bucket.
+         * @description **measured** — derived from scoped productivity ingest (`aiAdoption.aiAssistedContributionRatioPercent`). **estimated** — derived from AI-tool token volume, spend proxy, or adoption heuristics when ingest ratios are absent.
          * @enum {string}
          */
         AiAssistedCodeDataQuality: "estimated" | "measured";
+        /**
+         * @description Primary signal for the period rollup. **ingest** — productivity metrics; **token_volume** — AI-tool tokens ÷ LOC heuristic; **spend_proxy** — spend converted to proxy tokens when usage rows omit counts; **adoption** — active AI-tool users vs org headcount; **unavailable** — no usable signal for the selected scope.
+         * @enum {string}
+         */
+        AiAssistedCodeEstimationSource: "ingest" | "token_volume" | "spend_proxy" | "adoption" | "unavailable";
         AiUsageSpendAiAssistedCodeWeekDto: {
             /** Format: date-time */
             bucketStart: string;
@@ -2084,6 +2109,11 @@ export interface components {
             targetMinPercent: number;
             /** @default 75 */
             targetMaxPercent: number;
+            estimationSource?: components["schemas"]["AiAssistedCodeEstimationSource"];
+            /** @description Scoped AI-tool token volume for the selected period. */
+            totalTokenCount?: number;
+            /** @description Scoped AI-tool spend in cents for the selected period. */
+            totalSpendCents?: number;
             weeks: components["schemas"]["AiUsageSpendAiAssistedCodeWeekDto"][];
         };
         AiUsageSpendAiToolUsageSpendProviderItemDto: {
@@ -2550,6 +2580,39 @@ export interface components {
         ReadinessFixListDto: components["schemas"]["PageMetaDto"] & {
             items: components["schemas"]["FixRequestDto"][];
         };
+        /** @enum {string} */
+        ReadinessAuditEventType: "scan-started" | "scan-completed" | "fix-requested" | "pr-merged" | "score-changed";
+        /** @enum {string} */
+        ReadinessAuditOutcome: "success" | "partial" | "failed";
+        ReadinessAuditEntryDto: {
+            /** @description Stable event identifier within the workspace feed. */
+            id: string;
+            /** Format: date-time */
+            occurredAt: string;
+            eventType: components["schemas"]["ReadinessAuditEventType"];
+            /** @description Human-readable summary of the action. */
+            actionLabel: string;
+            actorName: string;
+            /** @description Omitted for system actors. */
+            actorEmail?: string | null;
+            /** @description Present for fix and score events; null for repo-wide scans. */
+            dimensionId?: components["schemas"]["ReadinessDimensionId"] | null;
+            /** Format: uuid */
+            repoId?: string | null;
+            repoName?: string | null;
+            outcome?: components["schemas"]["ReadinessAuditOutcome"] | null;
+            /** @description Short label for linked PR, fix queue item, or run. */
+            artifactLabel?: string | null;
+            /** @description External URL when available (e.g. GitHub PR). */
+            artifactUrl?: string | null;
+            /** Format: uuid */
+            runId?: string | null;
+            /** Format: uuid */
+            fixId?: string | null;
+        };
+        ReadinessAuditListDto: components["schemas"]["PageMetaDto"] & {
+            items: components["schemas"]["ReadinessAuditEntryDto"][];
+        };
         AgenticFoundationDimensionAggregateDto: {
             dimensionId: components["schemas"]["ReadinessDimensionId"];
             /** @description Mean dimension score percent across repos with maxScore > 0. */
@@ -3007,6 +3070,7 @@ export type AiUsageSpendContributorToolHeatmapDto = components['schemas']['AiUsa
 export type AiUsageSpendKeyInsightItemDto = components['schemas']['AiUsageSpendKeyInsightItemDto'];
 export type AiUsageSpendKeyInsightsDto = components['schemas']['AiUsageSpendKeyInsightsDto'];
 export type AiAssistedCodeDataQuality = components['schemas']['AiAssistedCodeDataQuality'];
+export type AiAssistedCodeEstimationSource = components['schemas']['AiAssistedCodeEstimationSource'];
 export type AiUsageSpendAiAssistedCodeWeekDto = components['schemas']['AiUsageSpendAiAssistedCodeWeekDto'];
 export type AiUsageSpendAiAssistedCodePercentageDto = components['schemas']['AiUsageSpendAiAssistedCodePercentageDto'];
 export type AiUsageSpendAiToolUsageSpendProviderItemDto = components['schemas']['AiUsageSpendAiToolUsageSpendProviderItemDto'];
@@ -3061,6 +3125,10 @@ export type AgenticFoundationDashboardSummaryDto = components['schemas']['Agenti
 export type PageMetaDto = components['schemas']['PageMetaDto'];
 export type ReadinessRepoListDto = components['schemas']['ReadinessRepoListDto'];
 export type ReadinessFixListDto = components['schemas']['ReadinessFixListDto'];
+export type ReadinessAuditEventType = components['schemas']['ReadinessAuditEventType'];
+export type ReadinessAuditOutcome = components['schemas']['ReadinessAuditOutcome'];
+export type ReadinessAuditEntryDto = components['schemas']['ReadinessAuditEntryDto'];
+export type ReadinessAuditListDto = components['schemas']['ReadinessAuditListDto'];
 export type AgenticFoundationDimensionAggregateDto = components['schemas']['AgenticFoundationDimensionAggregateDto'];
 export type ReadinessFixStatusSummaryDto = components['schemas']['ReadinessFixStatusSummaryDto'];
 export type GithubInstalledRepoListDto = components['schemas']['GithubInstalledRepoListDto'];
@@ -5485,6 +5553,61 @@ export interface operations {
             };
         };
     };
+    listReadinessAudit: {
+        parameters: {
+            query?: {
+                limit?: number;
+                offset?: number;
+                order?: "asc" | "desc";
+                /** @description Sort column for the activity feed. */
+                sort?: "occurredAt" | "actorName" | "repoName" | "eventType" | "dimensionId";
+                /** @description Case-insensitive match on actor name or email. */
+                search?: string;
+                eventType?: components["schemas"]["ReadinessAuditEventType"];
+                dimensionId?: components["schemas"]["ReadinessDimensionId"];
+                repoId?: string;
+                /** @description ISO-8601 lower bound on `occurredAt` (inclusive). */
+                since?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated audit entries */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReadinessAuditListDto"];
+                };
+            };
+            /** @description Invalid query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getReadinessScoreHistory: {
         parameters: {
             query?: {