@thinkai/tai-api-contract 2.132.0 → 2.134.0

package/src/generated/openapi.ts

@@ -4135,6 +4135,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/ingest-runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List durable ingest runs
+         * @description Newest-first history of ingest worker ticks that polled. Quiet skips (lock held, rate-limit deferral, and other non-poll skips) are omitted. This wave writes `productivity_github` only; other kinds return an empty list. Requires workspace membership. Does not include run history on ingest-coverage.
+         */
+        get: operations["getWorkspaceIngestRuns"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/hris/status": {
         parameters: {
             query?: never;
@@ -6855,6 +6875,36 @@ export interface components {
              */
             cursorKeySource?: "workspace_execution_token" | "platform_env_key" | null;
         };
+        /**
+         * @description Where a CI setup criterion's evidence came from. `in_repo` — this repository's CI config contributed. `linked_platform` — a linked CI templates platform repo (role `ci_templates` or the `jenkins_shared` alias) contributed.
+         * @enum {string}
+         */
+        CriterionEvidenceKind: "in_repo" | "linked_platform";
+        /** @description One evidence chip for a CI setup criterion (CI on change, CI runs build, CI runs tests, CI static analysis). `role` and `providerSlug` are present when `kind` is `linked_platform` and omitted for `in_repo`. */
+        CriterionEvidenceSourceDto: {
+            kind: components["schemas"]["CriterionEvidenceKind"];
+            /** @description Chip text shown in the UI (for example "In this repo" or "CI templates · org/platform-ci"). */
+            label: string;
+            /** @description Topology role when `kind` is `linked_platform` (for example `ci_templates` or `jenkins_shared`). Omit for `in_repo`. */
+            role?: string;
+            /** @description Platform repository `owner/name` when `kind` is `linked_platform`. Omit for `in_repo`. */
+            providerSlug?: string;
+        };
+        /**
+         * @description Stable "Improve this scan" code for Agentic Foundation CI setup honesty. `configure_linked_ci_templates` — map a linked CI templates repo. `scan_linked_ci_templates` — the mapped platform repo still needs a fresh scan. `view_ci_health_in_insights` — CI config is present; live pass/fail health is in SDLC Insights.
+         * @enum {string}
+         */
+        ScanImprovementCode: "configure_linked_ci_templates" | "scan_linked_ci_templates" | "view_ci_health_in_insights";
+        /** @description One repo-level recommendation on a readiness scorecard. Display copy is `title` and `description`; clients may also route from `code`. */
+        ScanImprovementDto: {
+            code: components["schemas"]["ScanImprovementCode"];
+            title: string;
+            description: string;
+            /** @description Optional SPA path for the recommendation (linked-platform settings or SDLC Insights). Not a scored URL. */
+            href?: string;
+            /** @description Platform repository `owner/name` when the recommendation names a specific linked repo (typically `scan_linked_ci_templates`). */
+            providerSlug?: string;
+        };
         CriterionDetailDto: {
             /** @description Rubric criterion id (e.g. A1, B3) */
             rubricId: string;
@@ -6881,6 +6931,8 @@ export interface components {
              * @description UUID of the linked open issue in tai_workspace_repo_issues. Present only for gap/partial criteria that have a corresponding issue row. Use this to navigate to the Fix flow.
              */
             issueId?: string | null;
+            /** @description Sources that contributed to CI setup criteria (CI on change, CI runs build, CI runs tests, CI static analysis). Met or Partial on those rows includes at least one entry (`in_repo` and/or `linked_platform`). Omitted on other criteria and when the scan did not record evidence. */
+            evidenceUsed?: components["schemas"]["CriterionEvidenceSourceDto"][];
         };
         ReadinessCriteriaSummaryDto: {
             total: number;
@@ -7248,6 +7300,8 @@ export interface components {
             platformArchetype?: "terraform_platform" | "gitops_platform" | "ci_templates" | "api_contracts_platform" | null;
             /** @description Federated readiness completeness for service repos: which linked platform roles (terraform/gitops/ci_templates/api_contracts, from the workspace delivery topology) are still missing scan evidence. Absent/null when no topology is configured or every declared role has fresh metadata (`complete: true`). */
             linkedRoleAssessment?: components["schemas"]["LinkedRoleAssessmentDto"] | null;
+            /** @description Repo-level "Improve this scan" recommendations for Agentic Foundation CI setup (at most three). Omitted when the scan emitted none. Does not change criterion scores; live CI health stays in SDLC Insights. */
+            scanImprovements?: components["schemas"]["ScanImprovementDto"][];
         };
         LinkedRolePendingDto: {
             /** @description Topology role key, e.g. terraform | gitops | ci_templates | api_contracts. */
@@ -7326,6 +7380,8 @@ export interface components {
             platformArchetype?: "terraform_platform" | "gitops_platform" | "ci_templates" | "api_contracts_platform" | null;
             /** @description See RepoReadinessScoreDto.linkedRoleAssessment. */
             linkedRoleAssessment?: components["schemas"]["LinkedRoleAssessmentDto"] | null;
+            /** @description See RepoReadinessScoreDto.scanImprovements. */
+            scanImprovements?: components["schemas"]["ScanImprovementDto"][];
         };
         AgenticFoundationDashboardSummaryDto: {
             repoCount: number;
@@ -8166,6 +8222,27 @@ export interface components {
             /** Format: date-time */
             generatedAt?: string;
         };
+        IngestRunDto: {
+            /** Format: uuid */
+            runId: string;
+            /** @enum {string} */
+            kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+            /** Format: date-time */
+            startedAt: string;
+            /** Format: date-time */
+            completedAt: string | null;
+            /** @enum {string} */
+            outcome: "in_progress" | "ok" | "partial" | "failed" | "cancelled";
+            reposPolled: number | null;
+            reposOk: number | null;
+            reposFailed: number | null;
+            errorSummary: string | null;
+            /** @description ISO lastIngestAt after the cursor moved; null when it did not. */
+            watermark: string | null;
+        };
+        IngestRunListDto: {
+            runs: components["schemas"]["IngestRunDto"][];
+        };
         HrisSyncStatusDto: {
             /** @description Provider identifier (e.g. 'personio', 'zenhr'). */
             provider: string;
@@ -10223,6 +10300,10 @@ export type ReadinessAnalyzeResponseDto = components['schemas']['ReadinessAnalyz
 export type ReadinessRunStatusDto = components['schemas']['ReadinessRunStatusDto'];
 export type ReadinessRepoAnalysisStatusDto = components['schemas']['ReadinessRepoAnalysisStatusDto'];
 export type ReadinessRunSummaryDto = components['schemas']['ReadinessRunSummaryDto'];
+export type CriterionEvidenceKind = components['schemas']['CriterionEvidenceKind'];
+export type CriterionEvidenceSourceDto = components['schemas']['CriterionEvidenceSourceDto'];
+export type ScanImprovementCode = components['schemas']['ScanImprovementCode'];
+export type ScanImprovementDto = components['schemas']['ScanImprovementDto'];
 export type CriterionDetailDto = components['schemas']['CriterionDetailDto'];
 export type ReadinessCriteriaSummaryDto = components['schemas']['ReadinessCriteriaSummaryDto'];
 export type ReadinessIssueDto = components['schemas']['ReadinessIssueDto'];
@@ -10350,6 +10431,8 @@ export type IngestCoverageSdlcDetailDto = components['schemas']['IngestCoverageS
 export type IngestCoverageSyncDetailDto = components['schemas']['IngestCoverageSyncDetailDto'];
 export type IngestCoveragePipelineDto = components['schemas']['IngestCoveragePipelineDto'];
 export type IngestCoverageDto = components['schemas']['IngestCoverageDto'];
+export type IngestRunDto = components['schemas']['IngestRunDto'];
+export type IngestRunListDto = components['schemas']['IngestRunListDto'];
 export type HrisSyncStatusDto = components['schemas']['HrisSyncStatusDto'];
 export type HrisSyncStatusListDto = components['schemas']['HrisSyncStatusListDto'];
 export type ZenHrReconnectResultDto = components['schemas']['ZenHrReconnectResultDto'];
@@ -20968,6 +21051,55 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    getWorkspaceIngestRuns: {
+        parameters: {
+            query?: {
+                /** @description Coverage pipeline kind. Omit to list every kind stored for the workspace. */
+                kind?: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+                /** @description Page size. Default 20. Values above 100 are rejected. */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ingest runs, newest startedAt first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "runs": []
+                     *     }
+                     */
+                    "application/json": components["schemas"]["IngestRunListDto"];
+                };
+            };
+            /** @description Invalid kind or limit */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Invalid ingest-runs query",
+                     *       "code": "invalid_query"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
     getHrisSyncStatus: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -1443,6 +1443,30 @@ export interface IngestCoverageDto {
   generatedAt?: string;
 }
 
+export type IngestRunKind = IngestCoveragePipelineKind;
+
+/** Finish state for one durable ingest tick. `cancelled` is legal and unused this wave. */
+export type IngestRunOutcome = "in_progress" | "ok" | "partial" | "failed" | "cancelled";
+
+/** One persisted ingest tick from GET /workspaces/:id/ingest-runs. */
+export interface IngestRunDto {
+  runId: string;
+  kind: IngestRunKind;
+  startedAt: string;
+  completedAt: string | null;
+  outcome: IngestRunOutcome;
+  reposPolled: number | null;
+  reposOk: number | null;
+  reposFailed: number | null;
+  errorSummary: string | null;
+  watermark: string | null;
+}
+
+/** Response body for GET /workspaces/:id/ingest-runs. */
+export interface IngestRunListDto {
+  runs: IngestRunDto[];
+}
+
 /** Sync status for a single HRIS provider connected to a workspace. */
 export interface HrisSyncStatusDto {
   /** Provider identifier ('personio', 'zenhr', …). */