@thinkai/tai-api-contract 2.84.0 → 2.89.0-pr.986.c95d8ece

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.84.0
+  version: 2.89.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -5484,10 +5484,11 @@ paths:
         (issues plus optional remediation from `criteriaDetails`).
 
         The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section
-        lists matching issues sorted by severity. Default filter is outstanding issues
-        (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is
-        true (default), each issue includes a Remediation section from the matching criterion when
-        available.
+        lists matching issues sorted by severity. Issue sections include severity in the heading
+        and do not emit per-issue `Fix status` / `Fix tier` lines. Default filter is outstanding
+        issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria`
+        is true (default), each issue includes a Remediation section from the matching criterion when
+        available. Timestamps use the optional `timeZone` query (IANA; default `UTC`).
 
         The response sets `Content-Disposition: attachment` with filename
         `readiness-issues-{providerSlug}-{date}.md`.
@@ -5522,6 +5523,16 @@ paths:
           schema:
             type: boolean
             default: true
+        - name: timeZone
+          in: query
+          required: false
+          description: >
+            IANA time zone for human-readable `Last analyzed` / `Exported` timestamps and the
+            calendar date in the attachment filename (e.g. `Europe/Berlin`). Defaults to `UTC`.
+          schema:
+            type: string
+            maxLength: 64
+            example: Europe/Berlin
       responses:
         "200":
           description: Markdown file of readiness issues
@@ -7297,6 +7308,43 @@ paths:
         "404":
           description: Not found
 
+  /workspaces/{workspaceId}/code-chat/indexes/{indexId}/wiki/export:
+    get:
+      tags: [CodeChat]
+      summary: Export the wiki as an Open Knowledge Format (OKF) v0.2 bundle
+      description: >-
+        Adapter over the stored wiki for OKF-aware platforms and agents. Does not
+        change the live pages. Rewrites `wiki:` links to relative concept paths,
+        adds YAML front matter plus reserved `index.md` / `log.md`, and validates
+        Mermaid (invalid diagrams are demoted to a text fence inside the export).
+      operationId: exportCodeChatWikiOkf
+      x-test-coverage-skip: covered by code-context okf-export unit tests
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: indexId
+          in: path
+          required: true
+          schema: { type: string, format: uuid }
+        - name: format
+          in: query
+          required: false
+          schema: { type: string, enum: [okf], default: okf }
+      responses:
+        "200":
+          description: OKF bundle (JSON with a files array of path/content pairs)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CodeChatWikiOkfExportDto"
+        "400":
+          description: Unsupported format
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: Index not found
+        "409":
+          description: Wiki has no pages yet
+
   /workspaces/{workspaceId}/code-chat/indexes/{indexId}/wiki/{slug}:
     get:
       tags: [CodeChat]
@@ -16938,6 +16986,12 @@ components:
         edgeCount: { type: integer }
         commitSha: { type: string, nullable: true }
         errorMessage: { type: string, nullable: true }
+        progressMessage:
+          type: string
+          nullable: true
+          description: >
+            Human-readable indexing stage while a job is running (queued, clone, graph,
+            save, wiki). Cleared when the index is ready or failed.
         indexedAt: { type: string, format: date-time, nullable: true }
         createdAt: { type: string, format: date-time }
         updatedAt: { type: string, format: date-time }
@@ -16966,6 +17020,12 @@ components:
           type: array
           items: { type: string, format: uuid }
           description: Optional subset; omit or empty to enqueue all readiness GitHub repos.
+        force:
+          type: boolean
+          default: false
+          description: >
+            When true, re-enqueue even if the repository is already indexing or was
+            indexed within the last 10 minutes.
 
     CodeChatSyncIndexesResultDto:
       type: object
@@ -16988,7 +17048,7 @@ components:
         repoName: { type: string }
         code:
           type: string
-          enum: [repo_ineligible]
+          enum: [repo_ineligible, indexed_recently, index_in_progress]
           description: Stable machine-readable skip reason
 
     CodeChatThreadDto:
@@ -17164,6 +17224,32 @@ components:
           type: array
           items: { $ref: "#/components/schemas/CodeChatWikiPageDto" }
 
+    CodeChatWikiOkfExportDto:
+      type: object
+      description: >-
+        Portable OKF v0.2 knowledge bundle. Unpack `files` into a directory tree
+        for OKF-aware tools; the in-app wiki is unchanged.
+      required: [kind, okfVersion, generatedAt, repoName, files, demotedDiagrams]
+      properties:
+        kind: { type: string, enum: [okf-bundle] }
+        okfVersion: { type: string, enum: ["0.2"] }
+        generatedAt: { type: string, format: date-time }
+        repoName: { type: string }
+        files:
+          type: array
+          items:
+            type: object
+            required: [path, content]
+            properties:
+              path:
+                type: string
+                description: Path inside the bundle (e.g. concepts/overview.md)
+              content: { type: string }
+        demotedDiagrams:
+          type: array
+          description: Concept paths whose Mermaid failed validation and was exported as a text fence
+          items: { type: string }
+
     CodeChatSymbolQueryBodyDto:
       type: object
       required: [query]
@@ -17327,8 +17413,21 @@ components:
     CodeChatVisualizeBodyDto:
       type: object
       properties:
-        kind: { type: string, enum: [dependency, blast, atlas] }
-        symbol: { type: string }
+        kind:
+          type: string
+          enum: [auto, dependency, module, focus, impact, blast, atlas]
+          description: >-
+            Omit or send `auto` to let the server pick the most informative view for the
+            repository. `blast` traces `query` as a symbol and falls back to a focused
+            subgraph, or to impact hotspots when `query` is empty.
+        query:
+          type: string
+          description: >-
+            Symbol, path, or plain-language request ("how does billing reach the ledger").
+            Free text is resolved against the graph to seed a focused view.
+        symbol:
+          type: string
+          description: Deprecated alias for `query`.
         repoIds:
           type: array
           items: { type: string, format: uuid }
@@ -17347,6 +17446,34 @@ components:
             note:
               type: string
               description: Set when dependency edges could not be resolved and a fallback view is shown.
+            architectureBrief:
+              type: string
+              description: >-
+                Short plain-prose narrative for the Engineering Context Graph panel.
+                LLM-written when the workspace has an agent execution key, otherwise a
+                deterministic reading of hubs and areas from the graph.
+            kind:
+              type: string
+              enum: [dependency, module, focus, impact, blast]
+              description: >-
+                Which reading of the repository this diagram is. `module` rolls files up
+                into source groups when too few file dependencies resolved for a file map,
+                `focus` answers a plain-language request, `impact` shows the most
+                depended-on files, and `blast` traces one symbol.
+            insights:
+              type: array
+              description: Measured facts about the graph — hubs, dependency coverage, test share, route count.
+              items: { type: string }
+            focus:
+              type: object
+              description: Present when free text drove the view.
+              required: [query, paths]
+              properties:
+                query: { type: string }
+                paths:
+                  type: array
+                  description: Files that matched the request and seeded the graph.
+                  items: { type: string }
             nodes:
               type: array
               items:
@@ -17356,6 +17483,17 @@ components:
                   id: { type: string }
                   label: { type: string }
                   kind: { type: string }
+                  path: { type: string }
+                  summary: { type: string }
+                  group: { type: string }
+                  inDegree: { type: integer }
+                  outDegree: { type: integer }
+                  isFocus:
+                    type: boolean
+                    description: File matched the request; highlight it as the answer.
+                  weight:
+                    type: integer
+                    description: Files behind a module box.
             edges:
               type: array
               items:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.84.0",
+  "version": "2.89.0-pr.986.c95d8ece",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -2133,7 +2133,7 @@ export interface paths {
         /**
          * Export repository readiness issues as Markdown
          * @description Download outstanding readiness issues for one repository as a Markdown (`.md`) attachment for local IDE workflows. Reuses the same scorecard as `GET .../readiness/repos/{repoId}` (issues plus optional remediation from `criteriaDetails`).
-         *     The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section lists matching issues sorted by severity. Default filter is outstanding issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is true (default), each issue includes a Remediation section from the matching criterion when available.
+         *     The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section lists matching issues sorted by severity. Issue sections include severity in the heading and do not emit per-issue `Fix status` / `Fix tier` lines. Default filter is outstanding issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is true (default), each issue includes a Remediation section from the matching criterion when available. Timestamps use the optional `timeZone` query (IANA; default `UTC`).
          *     The response sets `Content-Disposition: attachment` with filename `readiness-issues-{providerSlug}-{date}.md`.
          */
         get: operations["exportReadinessRepoIssuesMarkdown"];
@@ -2848,6 +2848,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/wiki/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export the wiki as an Open Knowledge Format (OKF) v0.2 bundle
+         * @description Adapter over the stored wiki for OKF-aware platforms and agents. Does not change the live pages. Rewrites `wiki:` links to relative concept paths, adds YAML front matter plus reserved `index.md` / `log.md`, and validates Mermaid (invalid diagrams are demoted to a text fence inside the export).
+         */
+        get: operations["exportCodeChatWikiOkf"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/wiki/{slug}": {
         parameters: {
             query?: never;
@@ -7334,6 +7354,8 @@ export interface components {
             edgeCount: number;
             commitSha?: string | null;
             errorMessage?: string | null;
+            /** @description Human-readable indexing stage while a job is running (queued, clone, graph, save, wiki). Cleared when the index is ready or failed. */
+            progressMessage?: string | null;
             /** Format: date-time */
             indexedAt?: string | null;
             /** Format: date-time */
@@ -7353,6 +7375,11 @@ export interface components {
         CodeChatSyncIndexesBodyDto: {
             /** @description Optional subset; omit or empty to enqueue all readiness GitHub repos. */
             repoIds?: string[];
+            /**
+             * @description When true, re-enqueue even if the repository is already indexing or was indexed within the last 10 minutes.
+             * @default false
+             */
+            force: boolean;
         };
         CodeChatSyncIndexesResultDto: {
             enqueued: number;
@@ -7368,7 +7395,7 @@ export interface components {
              * @description Stable machine-readable skip reason
              * @enum {string}
              */
-            code: "repo_ineligible";
+            code: "repo_ineligible" | "indexed_recently" | "index_in_progress";
         };
         CodeChatThreadDto: {
             /** Format: uuid */
@@ -7495,6 +7522,23 @@ export interface components {
         CodeChatWikiPageListDto: {
             items: components["schemas"]["CodeChatWikiPageDto"][];
         };
+        /** @description Portable OKF v0.2 knowledge bundle. Unpack `files` into a directory tree for OKF-aware tools; the in-app wiki is unchanged. */
+        CodeChatWikiOkfExportDto: {
+            /** @enum {string} */
+            kind: "okf-bundle";
+            /** @enum {string} */
+            okfVersion: "0.2";
+            /** Format: date-time */
+            generatedAt: string;
+            repoName: string;
+            files: {
+                /** @description Path inside the bundle (e.g. concepts/overview.md) */
+                path: string;
+                content: string;
+            }[];
+            /** @description Concept paths whose Mermaid failed validation and was exported as a text fence */
+            demotedDiagrams: string[];
+        };
         CodeChatSymbolQueryBodyDto: {
             query: string;
             repoIds?: string[];
@@ -7595,8 +7639,14 @@ export interface components {
             }[];
         };
         CodeChatVisualizeBodyDto: {
-            /** @enum {string} */
-            kind?: "dependency" | "blast" | "atlas";
+            /**
+             * @description Omit or send `auto` to let the server pick the most informative view for the repository. `blast` traces `query` as a symbol and falls back to a focused subgraph, or to impact hotspots when `query` is empty.
+             * @enum {string}
+             */
+            kind?: "auto" | "dependency" | "module" | "focus" | "impact" | "blast" | "atlas";
+            /** @description Symbol, path, or plain-language request ("how does billing reach the ledger"). Free text is resolved against the graph to seed a focused view. */
+            query?: string;
+            /** @description Deprecated alias for `query`. */
             symbol?: string;
             repoIds?: string[];
         };
@@ -7611,10 +7661,34 @@ export interface components {
                 source: string;
                 /** @description Set when dependency edges could not be resolved and a fallback view is shown. */
                 note?: string;
+                /** @description Short plain-prose narrative for the Engineering Context Graph panel. LLM-written when the workspace has an agent execution key, otherwise a deterministic reading of hubs and areas from the graph. */
+                architectureBrief?: string;
+                /**
+                 * @description Which reading of the repository this diagram is. `module` rolls files up into source groups when too few file dependencies resolved for a file map, `focus` answers a plain-language request, `impact` shows the most depended-on files, and `blast` traces one symbol.
+                 * @enum {string}
+                 */
+                kind?: "dependency" | "module" | "focus" | "impact" | "blast";
+                /** @description Measured facts about the graph — hubs, dependency coverage, test share, route count. */
+                insights?: string[];
+                /** @description Present when free text drove the view. */
+                focus?: {
+                    query: string;
+                    /** @description Files that matched the request and seeded the graph. */
+                    paths: string[];
+                };
                 nodes: {
                     id: string;
                     label: string;
                     kind?: string;
+                    path?: string;
+                    summary?: string;
+                    group?: string;
+                    inDegree?: number;
+                    outDegree?: number;
+                    /** @description File matched the request; highlight it as the answer. */
+                    isFocus?: boolean;
+                    /** @description Files behind a module box. */
+                    weight?: number;
                 }[];
                 edges: {
                     from: string;
@@ -8314,6 +8388,7 @@ export type CodeChatModuleInventoryRowDto = components['schemas']['CodeChatModul
 export type CodeChatStructuredBlockDto = components['schemas']['CodeChatStructuredBlockDto'];
 export type CodeChatWikiPageDto = components['schemas']['CodeChatWikiPageDto'];
 export type CodeChatWikiPageListDto = components['schemas']['CodeChatWikiPageListDto'];
+export type CodeChatWikiOkfExportDto = components['schemas']['CodeChatWikiOkfExportDto'];
 export type CodeChatSymbolQueryBodyDto = components['schemas']['CodeChatSymbolQueryBodyDto'];
 export type CodeChatSymbolHitDto = components['schemas']['CodeChatSymbolHitDto'];
 export type CodeChatSymbolHitListDto = components['schemas']['CodeChatSymbolHitListDto'];
@@ -13925,6 +14000,8 @@ export interface operations {
                 severity?: "critical" | "high" | "medium" | "low";
                 /** @description Include remediation from criteriaDetails (default true). */
                 includeCriteria?: boolean;
+                /** @description IANA time zone for human-readable `Last analyzed` / `Exported` timestamps and the calendar date in the attachment filename (e.g. `Europe/Berlin`). Defaults to `UTC`. */
+                timeZone?: string;
             };
             header?: never;
             path: {
@@ -15836,6 +15913,53 @@ export interface operations {
             };
         };
     };
+    exportCodeChatWikiOkf: {
+        parameters: {
+            query?: {
+                format?: "okf";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                indexId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OKF bundle (JSON with a files array of path/content pairs) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatWikiOkfExportDto"];
+                };
+            };
+            /** @description Unsupported format */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Index not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Wiki has no pages yet */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCodeChatWikiPage: {
         parameters: {
             query?: never;