@thinkai/tai-api-contract 2.196.1 → 2.197.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.196.1
+  version: 2.197.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -27507,12 +27507,47 @@ components:
             Active knowledge job for this repo when status is queued/running — phase, tracks,
             and token/cost rollups for SPA transparency (Wave 1).
         indexedAt: { type: string, format: date-time, nullable: true }
+        lastCheckedAt:
+          type: string
+          format: date-time
+          nullable: true
+          description: >
+            When cadence last compared the remote tip SHA to commitSha without rebuilding
+            the graph (change-block skip). Distinct from indexedAt.
+        lastChange:
+          allOf:
+            - $ref: "#/components/schemas/CodeChatIndexLastChangeDto"
+          nullable: true
+          description: >
+            Paths/counts changed between the prior and current commitSha on the last rebuild.
         createdAt: { type: string, format: date-time }
         updatedAt: { type: string, format: date-time }
         hasCodeExcerpts:
           type: boolean
           description: True when the indexed graph stores durable code excerpts (required for useful chat answers).
 
+    CodeChatIndexLastChangeDto:
+      type: object
+      required: [priorCommitSha, commitSha, fileCount, files, capturedAt]
+      properties:
+        priorCommitSha: { type: string }
+        commitSha: { type: string }
+        fileCount:
+          type: integer
+          minimum: 0
+          description: Total files changed (may exceed files.length when capped).
+        files:
+          type: array
+          maxItems: 50
+          items:
+            type: object
+            required: [path, status]
+            properties:
+              path: { type: string }
+              status:
+                { type: string, description: "GitHub compare status (added, modified, removed, …)" }
+        capturedAt: { type: string, format: date-time }
+
     CodeKnowledgeJobDto:
       type: object
       required:
@@ -27627,12 +27662,22 @@ components:
         repoName: { type: string }
         code:
           type: string
-          enum: [repo_ineligible, indexed_recently, index_in_progress, ecg_source_off, index_failed]
+          enum:
+            [
+              repo_ineligible,
+              indexed_recently,
+              index_in_progress,
+              ecg_source_off,
+              index_failed,
+              content_unchanged,
+            ]
           description: >
             Stable machine-readable skip reason. `ecg_source_off` covers a source turned off
             for Engineering Context Graph and non-GitHub providers that stay listed but are
             never indexed. `index_failed` means indexing already failed after three attempts
-            and stays failed until an admin force sync.
+            and stays failed until an admin force sync. `content_unchanged` means the remote
+            tip SHA matched the stored index commit during a daily/weekly cadence tick
+            (check-only; no clone/Graphify).
 
     CodeChatThreadDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.196.1",
+  "version": "2.197.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -11428,6 +11428,13 @@ export interface components {
             knowledgeJob?: components["schemas"]["CodeKnowledgeJobDto"] | null;
             /** Format: date-time */
             indexedAt?: string | null;
+            /**
+             * Format: date-time
+             * @description When cadence last compared the remote tip SHA to commitSha without rebuilding the graph (change-block skip). Distinct from indexedAt.
+             */
+            lastCheckedAt?: string | null;
+            /** @description Paths/counts changed between the prior and current commitSha on the last rebuild. */
+            lastChange?: components["schemas"]["CodeChatIndexLastChangeDto"] | null;
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
@@ -11435,6 +11442,19 @@ export interface components {
             /** @description True when the indexed graph stores durable code excerpts (required for useful chat answers). */
             hasCodeExcerpts?: boolean;
         };
+        CodeChatIndexLastChangeDto: {
+            priorCommitSha: string;
+            commitSha: string;
+            /** @description Total files changed (may exceed files.length when capped). */
+            fileCount: number;
+            files: {
+                path: string;
+                /** @description GitHub compare status (added, modified, removed, …) */
+                status: string;
+            }[];
+            /** Format: date-time */
+            capturedAt: string;
+        };
         CodeKnowledgeJobDto: {
             /** Format: uuid */
             id: string;
@@ -11508,10 +11528,10 @@ export interface components {
             repoId: string;
             repoName: string;
             /**
-             * @description Stable machine-readable skip reason. `ecg_source_off` covers a source turned off for Engineering Context Graph and non-GitHub providers that stay listed but are never indexed. `index_failed` means indexing already failed after three attempts and stays failed until an admin force sync.
+             * @description Stable machine-readable skip reason. `ecg_source_off` covers a source turned off for Engineering Context Graph and non-GitHub providers that stay listed but are never indexed. `index_failed` means indexing already failed after three attempts and stays failed until an admin force sync. `content_unchanged` means the remote tip SHA matched the stored index commit during a daily/weekly cadence tick (check-only; no clone/Graphify).
              * @enum {string}
              */
-            code: "repo_ineligible" | "indexed_recently" | "index_in_progress" | "ecg_source_off" | "index_failed";
+            code: "repo_ineligible" | "indexed_recently" | "index_in_progress" | "ecg_source_off" | "index_failed" | "content_unchanged";
         };
         CodeChatThreadDto: {
             /** Format: uuid */
@@ -13631,6 +13651,7 @@ export type InsightsRecommendationsPageBundleResponse = components['schemas']['I
 export type CodeChatIndexStatus = components['schemas']['CodeChatIndexStatus'];
 export type CodeChatIndexer = components['schemas']['CodeChatIndexer'];
 export type CodeChatIndexDto = components['schemas']['CodeChatIndexDto'];
+export type CodeChatIndexLastChangeDto = components['schemas']['CodeChatIndexLastChangeDto'];
 export type CodeKnowledgeJobDto = components['schemas']['CodeKnowledgeJobDto'];
 export type CodeKnowledgeTrackStatus = components['schemas']['CodeKnowledgeTrackStatus'];
 export type CodeChatIndexListDto = components['schemas']['CodeChatIndexListDto'];