@thinkai/tai-api-contract 2.199.0 → 2.201.0

package/openapi/x-test-status-map.json

@@ -281,6 +281,16 @@
       "method": "PUT",
       "path": "/workspaces/{workspaceId}/productivity-targets"
     },
+    "getWorkspaceDimensionTargets": {
+      "status": "implemented",
+      "method": "GET",
+      "path": "/workspaces/{workspaceId}/agentic-foundation/dimension-targets"
+    },
+    "putWorkspaceDimensionTargets": {
+      "status": "implemented",
+      "method": "PUT",
+      "path": "/workspaces/{workspaceId}/agentic-foundation/dimension-targets"
+    },
     "putTenantSources": {
       "status": "implemented",
       "method": "PUT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.199.0",
+  "version": "2.201.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -20,8 +20,8 @@
   },
   "devDependencies": {
     "@stoplight/spectral-cli": "^6.17.0",
-    "@types/node": "^26.6.5",
-    "jsonpath-plus": "^11.2.1",
+    "@types/node": "^26.6.6",
+    "jsonpath-plus": "^11.2.2",
     "openapi-typescript": "^7.13.0",
     "typescript": "~6.0.3"
   },

package/src/generated/openapi.ts

@@ -943,6 +943,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/agentic-foundation/dimension-targets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Agentic Foundation dimension targets
+         * @description Workspace target percent per readiness dimension, plus optional per-repository overrides. Omitted targets mean 100. A repository override may disable scoring for a dimension and set its own target. Empty object means every dimension is scored at 100. Member-level read access.
+         */
+        get: operations["getWorkspaceDimensionTargets"];
+        /**
+         * Set Agentic Foundation dimension targets
+         * @description Full-replace workspace dimension targets and repository overrides. Omit a target or send 100 to keep the default. `PUT {}` or `null` clears overrides so every dimension is scored at 100. Repository ids must be in Agentic Foundation scan scope. Requires workspace **admin**.
+         */
+        put: operations["putWorkspaceDimensionTargets"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/sources": {
         parameters: {
             query?: never;
@@ -5216,7 +5240,7 @@ export interface paths {
         };
         /**
          * Ingest / backfill data coverage
-         * @description Read-only snapshot of historical ingest coverage for connected pipelines (productivity GitHub, AI usage/spend per provider, SDLC components, monitoring, HRIS). Aggregates existing watermarks and stored day/week evidence — does not trigger ingest or refresh. Every pipeline includes always-present `dataTrust` (`status` + `verificationMethod`) as a unified trust summary derived from existing coverage signals (stale, gaps, productivity `verificationStatus`, AI `spendReconciliationStatus`, pipeline `status`). It does not replace Source verified, Spend matched, or Backfill complete fields. Productivity detail may include `selfHeal` (latest depth scan and week reconcile) read from stored activity rows; this GET does not run a scan. `selfHeal` is null when neither event exists. AI usage detail includes spend reconciliation (`spendReconciliationStatus`, `spendDataQuality`, provider and stored cent totals, `spendReconcileCheckedAt`) read from the refresh-status snapshot. This GET does not call Cursor or Claude. Productivity, HR, monitoring, and SDLC pipelines omit those fields. `nextScheduledAt` is the scheduled poll instant for `ai_usage`, `hris`, and `monitoring`. It is null for productivity and SDLC, when that sync worker is disabled, or when there has been no attempt (`hris`/`monitoring` use last status `never`). For `hris` and `monitoring`, the value is the next PHASE2 daily UTC cron after now (`15 2` / `30 2`, not lastAttempt plus interval) and is therefore in the future when set. For `ai_usage`, it is the next weekly workspace slot and a past instant means that poll is overdue; it is not moved forward to now and is not an ETA. Monitoring `sync` copies stored `issueCount`, `deploymentCount`, and `eventCount` (null when unset). HRIS leaves those three null. Requires workspace membership. Disconnected sources are omitted. Insights / Measure / Engineering Health response DTOs do not include `dataTrust`.
+         * @description Read-only snapshot of historical ingest coverage for connected pipelines (productivity GitHub/Bitbucket, AI usage/spend per provider, SDLC components, monitoring, HRIS, Jira, PagerDuty). Aggregates existing watermarks and stored day/week evidence — does not trigger ingest or refresh. Every pipeline includes always-present `dataTrust` (`status` + `verificationMethod`) as a unified trust summary derived from existing coverage signals (stale, gaps, productivity `verificationStatus`, AI `spendReconciliationStatus`, optional pipeline `sourceReconcile`, pipeline `status`). It does not replace Source verified, Spend matched, or Backfill complete fields. Optional `sourceReconcile` generalizes Source verified (count/checksum vs provider) for L2 reconcilers; omit/null when no scheduled reconcile snapshot exists. Productivity detail may include `selfHeal` (latest depth scan and week reconcile) read from stored activity rows; this GET does not run a scan. `selfHeal` is null when neither event exists. AI usage detail includes spend reconciliation (`spendReconciliationStatus`, `spendDataQuality`, provider and stored cent totals, `spendReconcileCheckedAt`) read from the refresh-status snapshot. This GET does not call Cursor or Claude. Productivity, HR, monitoring, and SDLC pipelines omit those spend fields. `nextScheduledAt` is the scheduled poll instant for `ai_usage`, `hris`, and `monitoring`. It is null for productivity and SDLC, when that sync worker is disabled, or when there has been no attempt (`hris`/`monitoring` use last status `never`). For `hris` and `monitoring`, the value is the next PHASE2 daily UTC cron after now (`15 2` / `30 2`, not lastAttempt plus interval) and is therefore in the future when set. For `ai_usage`, it is the next weekly workspace slot and a past instant means that poll is overdue; it is not moved forward to now and is not an ETA. Monitoring `sync` copies stored `issueCount`, `deploymentCount`, and `eventCount` (null when unset). HRIS leaves those three null. Requires workspace membership. Disconnected sources are omitted. Insights / Measure / Engineering Health response DTOs do not include `dataTrust`.
          */
         get: operations["getWorkspaceIngestCoverage"];
         put?: never;
@@ -6516,6 +6540,31 @@ export interface components {
             /** @description Ceiling — stay at or below this many CI failures per engineer per week. `0` is valid. */
             ciFailuresPerEngineerPerWeek?: number | null;
         };
+        /** @description Omitted dimension means a target of 100. Values of 100 are not stored. */
+        DimensionTargetPercentsDto: {
+            "ai-agent-readiness"?: number | null;
+            "token-efficiency"?: number | null;
+            "repo-hygiene"?: number | null;
+            "stack-quality"?: number | null;
+            "tests-qa"?: number | null;
+            observability?: number | null;
+            "api-contracts"?: number | null;
+            "platform-governance"?: number | null;
+            delivery?: number | null;
+        };
+        DimensionTargetsRepoOverrideDto: {
+            /** @description Dimensions left out of this repository's score. */
+            disabledDimensions?: components["schemas"]["ReadinessDimensionId"][];
+            targets?: components["schemas"]["DimensionTargetPercentsDto"];
+        };
+        /** @description Agentic Foundation dimension targets. Empty object means every dimension is scored and the target is 100. */
+        DimensionTargetsDto: {
+            targets?: components["schemas"]["DimensionTargetPercentsDto"];
+            /** @description Keys are in-scope repository ids. */
+            repoOverrides?: {
+                [key: string]: components["schemas"]["DimensionTargetsRepoOverrideDto"];
+            };
+        };
         AiEmailAliasEntryDto: {
             /**
              * Format: email
@@ -10813,6 +10862,36 @@ export interface components {
             /** @description Monitoring meta event count. Null for HRIS and when the stored count is unset. */
             eventCount?: number | null;
         };
+        /**
+         * @description Pipeline-level source reconcile outcome (L2). Same values as productivity Source verified, plus `not_applicable` when the provider has no countable or checksum reconcile surface.
+         * @enum {string}
+         */
+        IngestCoverageSourceReconcileStatus: "unverified" | "verified" | "below_target" | "insufficient_sample" | "stale" | "not_applicable";
+        /**
+         * @description Which L2 reconcile check produced `sourceReconcile.verificationStatus`. Prefer `source_count` or `checksum` when mapping into `dataTrust.verificationMethod`.
+         * @enum {string}
+         */
+        IngestCoverageSourceReconcileMethod: "source_count" | "checksum" | "none";
+        /** @description Generalized Source verified / reconcile snapshot on a coverage pipeline. Optional until a scheduled reconciler writes a row. Does not replace nested productivity verify fields or AI spend reconcile. */
+        IngestCoverageSourceReconcileDto: {
+            verificationStatus: components["schemas"]["IngestCoverageSourceReconcileStatus"];
+            /** @description Minimum provider-vs-stored capture for a count reconcile (0–100, up to two decimals). Null when the check is checksum-only, thin, not applicable, or no sample exists. */
+            sourceCapturePercent: number | null;
+            verificationMethod: components["schemas"]["IngestCoverageSourceReconcileMethod"];
+            /**
+             * Format: date-time
+             * @description When the snapshot was written. Null when unverified with no row.
+             */
+            checkedAt: string | null;
+            /** @description Provider-side count for the reconcile window. Null when unset or N/A. */
+            providerCount: number | null;
+            /** @description Stored platform count for the reconcile window. Null when unset or N/A. */
+            storedCount: number | null;
+            /** @description Provider-side checksum (opaque). Null when method is not checksum. */
+            providerChecksum: string | null;
+            /** @description Stored platform checksum (opaque). Null when method is not checksum. */
+            storedChecksum: string | null;
+        };
         /**
          * @description Unified data-trust summary for one ingest-coverage pipeline. Derived from existing coverage signals; does not rename Source verified, Spend matched, or Backfill complete.
          * @enum {string}
@@ -10846,7 +10925,7 @@ export interface components {
         IngestCoveragePipelineDto: {
             id: string;
             /** @enum {string} */
-            kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+            kind: "productivity_github" | "productivity_bitbucket" | "ai_usage" | "sdlc_github" | "monitoring" | "hris" | "jira" | "pagerduty";
             provider?: string | null;
             /** @enum {string} */
             status: "not_started" | "backfilling" | "incremental" | "complete" | "failed" | "in_progress";
@@ -10879,6 +10958,8 @@ export interface components {
             ai?: components["schemas"]["IngestCoverageAiDetailDto"];
             sdlc?: components["schemas"]["IngestCoverageSdlcDetailDto"];
             sync?: components["schemas"]["IngestCoverageSyncDetailDto"];
+            /** @description Optional L2 source-reconcile snapshot (count / checksum vs provider API). Null when no scheduled reconcile has written a row for this pipeline. Does not replace nested productivity verify fields or AI spend reconcile. */
+            sourceReconcile?: components["schemas"]["IngestCoverageSourceReconcileDto"] | null;
             dataTrust: components["schemas"]["DataTrustDto"];
         };
         IngestCoverageDto: {
@@ -10890,7 +10971,7 @@ export interface components {
             /** Format: uuid */
             runId: string;
             /** @enum {string} */
-            kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+            kind: "productivity_github" | "productivity_bitbucket" | "ai_usage" | "sdlc_github" | "monitoring" | "hris" | "jira" | "pagerduty";
             /** Format: date-time */
             startedAt: string;
             /** Format: date-time */
@@ -13284,6 +13365,9 @@ export type AiModelPolicyConfigDto = components['schemas']['AiModelPolicyConfigD
 export type AiModelPolicyPersonOverrideDto = components['schemas']['AiModelPolicyPersonOverrideDto'];
 export type AiModelPolicyDto = components['schemas']['AiModelPolicyDto'];
 export type ProductivityTargetsDto = components['schemas']['ProductivityTargetsDto'];
+export type DimensionTargetPercentsDto = components['schemas']['DimensionTargetPercentsDto'];
+export type DimensionTargetsRepoOverrideDto = components['schemas']['DimensionTargetsRepoOverrideDto'];
+export type DimensionTargetsDto = components['schemas']['DimensionTargetsDto'];
 export type AiEmailAliasEntryDto = components['schemas']['AiEmailAliasEntryDto'];
 export type AiEmailAliasesDto = components['schemas']['AiEmailAliasesDto'];
 export type TestConnectionResponseDto = components['schemas']['TestConnectionResponseDto'];
@@ -13644,6 +13728,9 @@ export type IngestCoverageAiDetailDto = components['schemas']['IngestCoverageAiD
 export type IngestCoverageSdlcComponentDto = components['schemas']['IngestCoverageSdlcComponentDto'];
 export type IngestCoverageSdlcDetailDto = components['schemas']['IngestCoverageSdlcDetailDto'];
 export type IngestCoverageSyncDetailDto = components['schemas']['IngestCoverageSyncDetailDto'];
+export type IngestCoverageSourceReconcileStatus = components['schemas']['IngestCoverageSourceReconcileStatus'];
+export type IngestCoverageSourceReconcileMethod = components['schemas']['IngestCoverageSourceReconcileMethod'];
+export type IngestCoverageSourceReconcileDto = components['schemas']['IngestCoverageSourceReconcileDto'];
 export type DataTrustStatus = components['schemas']['DataTrustStatus'];
 export type DataTrustVerificationMethod = components['schemas']['DataTrustVerificationMethod'];
 export type DataTrustDto = components['schemas']['DataTrustDto'];
@@ -16836,6 +16923,91 @@ export interface operations {
             };
         };
     };
+    getWorkspaceDimensionTargets: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current targets (may be empty) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DimensionTargetsDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putWorkspaceDimensionTargets: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DimensionTargetsDto"];
+            };
+        };
+        responses: {
+            /** @description Targets persisted (or cleared). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid payload or repository is not in scan scope */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Forbidden — workspace admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     putTenantSources: {
         parameters: {
             query?: never;
@@ -28104,7 +28276,7 @@ export interface operations {
         parameters: {
             query?: {
                 /** @description Coverage pipeline kind. Omit to list every kind stored for the workspace. */
-                kind?: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+                kind?: "productivity_github" | "productivity_bitbucket" | "ai_usage" | "sdlc_github" | "monitoring" | "hris" | "jira" | "pagerduty";
                 /** @description Page size. Default 20. Values above 100 are rejected. */
                 limit?: number;
             };

package/src/index.ts

@@ -1457,6 +1457,47 @@ export interface IngestCoverageProductivitySelfHealDto {
 export type IngestCoverageVerificationStatus =
   "unverified" | "verified" | "below_target" | "insufficient_sample" | "stale";
 
+/**
+ * Pipeline-level source reconcile outcome (L2).
+ * Reuses the productivity Source verified statuses and adds `not_applicable`
+ * when a connected provider exposes no countable/checksum reconcile surface.
+ */
+export type IngestCoverageSourceReconcileStatus =
+  IngestCoverageVerificationStatus | "not_applicable";
+
+/**
+ * Which L2 reconcile check produced `sourceReconcile.verificationStatus`.
+ * Maps into L1 `dataTrust.verificationMethod` (`source_count` / `checksum`).
+ */
+export type IngestCoverageSourceReconcileMethod = "source_count" | "checksum" | "none";
+
+/**
+ * Generalized Source verified / reconcile snapshot on a coverage pipeline.
+ * Optional until a scheduled reconciler has written a row. Productivity GitHub
+ * keeps nested `productivity.verificationStatus` / `sourceCapturePercent`;
+ * AI spend stays on `ai.spendReconciliationStatus`.
+ */
+export interface IngestCoverageSourceReconcileDto {
+  verificationStatus: IngestCoverageSourceReconcileStatus;
+  /**
+   * Minimum provider-vs-stored capture for a count reconcile (0–100, up to two
+   * decimals). Null when the check is checksum-only, thin, not applicable, or
+   * no sample exists.
+   */
+  sourceCapturePercent: number | null;
+  verificationMethod: IngestCoverageSourceReconcileMethod;
+  /** When the snapshot was written. Null when status is unverified with no row. */
+  checkedAt: string | null;
+  /** Provider-side count for the reconcile window. Null when unset or N/A. */
+  providerCount: number | null;
+  /** Stored platform count for the reconcile window. Null when unset or N/A. */
+  storedCount: number | null;
+  /** Provider-side checksum (opaque). Null when method is not checksum. */
+  providerChecksum: string | null;
+  /** Stored platform checksum (opaque). Null when method is not checksum. */
+  storedChecksum: string | null;
+}
+
 export interface IngestCoverageProductivityDetailDto {
   phase?: "recent" | "historical" | "complete" | null;
   historicalWeekStart?: string | null;
@@ -1564,7 +1605,14 @@ export interface IngestCoverageSyncDetailDto {
 }
 
 export type IngestCoveragePipelineKind =
-  "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+  | "productivity_github"
+  | "productivity_bitbucket"
+  | "ai_usage"
+  | "sdlc_github"
+  | "monitoring"
+  | "hris"
+  | "jira"
+  | "pagerduty";
 
 export type IngestCoveragePipelineStatus =
   "not_started" | "backfilling" | "incremental" | "complete" | "failed" | "in_progress";
@@ -1628,6 +1676,12 @@ export interface IngestCoveragePipelineDto {
   ai?: IngestCoverageAiDetailDto;
   sdlc?: IngestCoverageSdlcDetailDto;
   sync?: IngestCoverageSyncDetailDto;
+  /**
+   * Optional L2 source-reconcile snapshot (count / checksum vs provider API).
+   * Null/omit when no scheduled reconcile has written a row for this pipeline.
+   * Does not replace nested productivity verify fields or AI spend reconcile.
+   */
+  sourceReconcile?: IngestCoverageSourceReconcileDto | null;
   /**
    * Always present. Unified Data trust summary for this pipeline.
    * Additive to Source verified / Spend matched / Backfill complete.