@thinkai/tai-api-contract 2.189.0 → 2.190.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.189.0
+  version: 2.190.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -9397,16 +9397,94 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/rules-skills/create:
+    post:
+      tags: [AgenticFoundation]
+      summary: Draft Rules & Skills via agent execution
+      description: >
+        Generates hub (≥1 of `AGENTS.md` / `CLAUDE.md` per assessed tools) plus ≥1 rule
+        and ≥1 skill with correct stack paths using workspace **agent execution**
+        (`ThinkAiAgent` / same credential path as the fix processor — not Fix Processor
+        enqueue). Runs the shared soft-quality gate from the validate engine.
+        Soft failures block Open PR unless `overrideSoftQuality` + `overrideReason`
+        (audited). Structural failures are never overridable. Requires workspace
+        editor or admin. Assessed tools come from the latest succeeded readiness scan.
+      operationId: postRulesSkillsCreate
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/RulesSkillsCreateRequestDto"
+            examples:
+              create:
+                value:
+                  repoId: "11111111-1111-4111-8111-111111111111"
+                  criterionIds: [A1, A3]
+                  intent: "Add a skill for running the monorepo test suite"
+      responses:
+        "200":
+          description: Drafts generated (may include soft-quality blockingFailures)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RulesSkillsCreateResponseDto"
+        "400":
+          description: >
+            Missing intent and criterionIds, or override without reason
+            (`code: intent_or_criterion_required` | `override_reason_required`)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace, repository, or GitHub installation not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "422":
+          description: >
+            No succeeded readiness scan (`readiness_scan_required`), non-GitHub repo,
+            or agent drafts missing required hub/rule/skill coverage
+            (`rules_skills_create_incomplete`)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "429":
+          description: Create rate limit exceeded
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "503":
+          description: >
+            Agent execution credential missing (`agent_execution_unavailable`) or
+            clone/agent run failed (`rules_skills_create_failed`)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/rules-skills/pull-requests:
     post:
       tags: [AgenticFoundation]
       summary: Open a Rules & Skills remediation pull request
       description: >
-        Applies `proposedFiles` (or a future create-mode session) onto a non-default
+        Applies `proposedFiles` (from validate or create drafts) onto a non-default
         branch via the Automations GitHub App installation and opens a pull request.
         Never pushes to the default branch. PR title/body identify the change as
         platform-generated and link back to `/agentic-foundation/rules-skills`.
         Requires workspace editor or admin. Same write-permission gate as readiness fixes.
+        For create mode, pass the `drafts` returned by `POST .../rules-skills/create`
+        as `proposedFiles` after soft-quality passes or a logged override.
       operationId: postRulesSkillsPullRequest
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
@@ -22865,6 +22943,66 @@ components:
           type: string
           description: Quiet-case note (e.g. empty tree under pathPrefixes).
 
+    RulesSkillsCreateRequestDto:
+      type: object
+      additionalProperties: false
+      required: [repoId]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        criterionIds:
+          type: array
+          maxItems: 16
+          items:
+            type: string
+            enum: [A1, A2, A3, A3a, A3b, A3c, A11]
+          description: >
+            Optional criterion targets. At least one of `intent` or non-empty
+            `criterionIds` is required.
+        intent:
+          type: string
+          maxLength: 4000
+          description: Free-text create intent (required when criterionIds is empty).
+        notes:
+          type: string
+          maxLength: 8000
+        overrideSoftQuality:
+          type: boolean
+          description: >
+            When true, soft-quality fails are omitted from `blockingFailures`
+            (structural fails always remain). Requires `overrideReason`; audited.
+        overrideReason:
+          type: string
+          maxLength: 2000
+          description: Required when overrideSoftQuality is true.
+
+    RulesSkillsCreateResponseDto:
+      type: object
+      additionalProperties: false
+      required: [assessedTools, drafts, softQuality, blockingFailures, softQualityOverridden]
+      properties:
+        assessedTools:
+          $ref: "#/components/schemas/RulesSkillsAssessedTools"
+        drafts:
+          type: array
+          items:
+            $ref: "#/components/schemas/RulesSkillsProposedFileDto"
+          description: Draft patches for review; pass to open-PR as proposedFiles.
+        softQuality:
+          $ref: "#/components/schemas/RulesSkillsSoftQualitySummaryDto"
+        blockingFailures:
+          type: array
+          items:
+            $ref: "#/components/schemas/RulesSkillsFindingDto"
+          description: >
+            Structural fails always; soft fails unless softQualityOverridden.
+            Open PR should wait until empty (or soft override was logged).
+        softQualityOverridden:
+          type: boolean
+        note:
+          type: string
+
     RulesSkillsOpenPullRequestRequestDto:
       type: object
       additionalProperties: false
@@ -22879,7 +23017,7 @@ components:
         sessionId:
           type: string
           format: uuid
-          description: Reserved for Create-mode sessions; validate mode uses proposedFiles.
+          description: Reserved for persisted create sessions; currently pass proposedFiles.
         proposedFiles:
           type: array
           minItems: 1
@@ -24124,6 +24262,7 @@ components:
         - integrations.agent_execution.provider_changed
         - integrations.repo_eligibility.overrides_changed
         - integrations.repo_eligibility.languages_refresh_requested
+        - rules_skills.soft_quality.override
         - integrations.cursor.platform_key_enabled
         - integrations.cursor.platform_key_disabled
         - member.invited

package/package.json

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

package/src/generated/openapi.ts

@@ -3364,6 +3364,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/rules-skills/create": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Draft Rules & Skills via agent execution
+         * @description Generates hub (≥1 of `AGENTS.md` / `CLAUDE.md` per assessed tools) plus ≥1 rule and ≥1 skill with correct stack paths using workspace **agent execution** (`ThinkAiAgent` / same credential path as the fix processor — not Fix Processor enqueue). Runs the shared soft-quality gate from the validate engine. Soft failures block Open PR unless `overrideSoftQuality` + `overrideReason` (audited). Structural failures are never overridable. Requires workspace editor or admin. Assessed tools come from the latest succeeded readiness scan.
+         */
+        post: operations["postRulesSkillsCreate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/rules-skills/pull-requests": {
         parameters: {
             query?: never;
@@ -3375,7 +3395,7 @@ export interface paths {
         put?: never;
         /**
          * Open a Rules & Skills remediation pull request
-         * @description Applies `proposedFiles` (or a future create-mode session) onto a non-default branch via the Automations GitHub App installation and opens a pull request. Never pushes to the default branch. PR title/body identify the change as platform-generated and link back to `/agentic-foundation/rules-skills`. Requires workspace editor or admin. Same write-permission gate as readiness fixes.
+         * @description Applies `proposedFiles` (from validate or create drafts) onto a non-default branch via the Automations GitHub App installation and opens a pull request. Never pushes to the default branch. PR title/body identify the change as platform-generated and link back to `/agentic-foundation/rules-skills`. Requires workspace editor or admin. Same write-permission gate as readiness fixes. For create mode, pass the `drafts` returned by `POST .../rules-skills/create` as `proposedFiles` after soft-quality passes or a logged override.
          */
         post: operations["postRulesSkillsPullRequest"];
         delete?: never;
@@ -9367,6 +9387,29 @@ export interface components {
             /** @description Quiet-case note (e.g. empty tree under pathPrefixes). */
             note?: string;
         };
+        RulesSkillsCreateRequestDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @description Optional criterion targets. At least one of `intent` or non-empty `criterionIds` is required. */
+            criterionIds?: ("A1" | "A2" | "A3" | "A3a" | "A3b" | "A3c" | "A11")[];
+            /** @description Free-text create intent (required when criterionIds is empty). */
+            intent?: string;
+            notes?: string;
+            /** @description When true, soft-quality fails are omitted from `blockingFailures` (structural fails always remain). Requires `overrideReason`; audited. */
+            overrideSoftQuality?: boolean;
+            /** @description Required when overrideSoftQuality is true. */
+            overrideReason?: string;
+        };
+        RulesSkillsCreateResponseDto: {
+            assessedTools: components["schemas"]["RulesSkillsAssessedTools"];
+            /** @description Draft patches for review; pass to open-PR as proposedFiles. */
+            drafts: components["schemas"]["RulesSkillsProposedFileDto"][];
+            softQuality: components["schemas"]["RulesSkillsSoftQualitySummaryDto"];
+            /** @description Structural fails always; soft fails unless softQualityOverridden. Open PR should wait until empty (or soft override was logged). */
+            blockingFailures: components["schemas"]["RulesSkillsFindingDto"][];
+            softQualityOverridden: boolean;
+            note?: string;
+        };
         RulesSkillsOpenPullRequestRequestDto: {
             /** Format: uuid */
             repoId: string;
@@ -9374,7 +9417,7 @@ export interface components {
             mode: "validate" | "create";
             /**
              * Format: uuid
-             * @description Reserved for Create-mode sessions; validate mode uses proposedFiles.
+             * @description Reserved for persisted create sessions; currently pass proposedFiles.
              */
             sessionId?: string;
             proposedFiles?: components["schemas"]["RulesSkillsProposedFileDto"][];
@@ -9942,7 +9985,7 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.suspended" | "integration.github.unsuspended" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.datadog.added" | "integrations.datadog.removed" | "integrations.datadog.sync_completed" | "integrations.datadog.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed" | "report.exported" | "report.assessment_stored" | "report.assessment_link_sent" | "report.assessment_link_revoked" | "report.assessment_downloaded" | "report.assessment_hidden" | "report.assessment_restored" | "workspace.aggregate_use.changed" | "workspace.assessment_rollout.changed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.suspended" | "integration.github.unsuspended" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "rules_skills.soft_quality.override" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.datadog.added" | "integrations.datadog.removed" | "integrations.datadog.sync_completed" | "integrations.datadog.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed" | "report.exported" | "report.assessment_stored" | "report.assessment_link_sent" | "report.assessment_link_revoked" | "report.assessment_downloaded" | "report.assessment_hidden" | "report.assessment_restored" | "workspace.aggregate_use.changed" | "workspace.assessment_rollout.changed";
         /** @description Current legal-approved opt-in notice, or `unset` while opt-in is unavailable. */
         AggregateUseNoticeStatusDto: {
             /** @enum {string} */
@@ -13285,6 +13328,8 @@ export type RulesSkillsSoftQualityCheckDto = components['schemas']['RulesSkillsS
 export type RulesSkillsSoftQualitySummaryDto = components['schemas']['RulesSkillsSoftQualitySummaryDto'];
 export type RulesSkillsProposedFileDto = components['schemas']['RulesSkillsProposedFileDto'];
 export type RulesSkillsValidateResponseDto = components['schemas']['RulesSkillsValidateResponseDto'];
+export type RulesSkillsCreateRequestDto = components['schemas']['RulesSkillsCreateRequestDto'];
+export type RulesSkillsCreateResponseDto = components['schemas']['RulesSkillsCreateResponseDto'];
 export type RulesSkillsOpenPullRequestRequestDto = components['schemas']['RulesSkillsOpenPullRequestRequestDto'];
 export type RulesSkillsOpenPullRequestResponseDto = components['schemas']['RulesSkillsOpenPullRequestResponseDto'];
 export type PhaseRoleDto = components['schemas']['PhaseRoleDto'];
@@ -23087,6 +23132,79 @@ export interface operations {
             };
         };
     };
+    postRulesSkillsCreate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RulesSkillsCreateRequestDto"];
+            };
+        };
+        responses: {
+            /** @description Drafts generated (may include soft-quality blockingFailures) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RulesSkillsCreateResponseDto"];
+                };
+            };
+            /** @description Missing intent and criterionIds, or override without reason (`code: intent_or_criterion_required` | `override_reason_required`) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace, repository, or GitHub installation not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description No succeeded readiness scan (`readiness_scan_required`), non-GitHub repo, or agent drafts missing required hub/rule/skill coverage (`rules_skills_create_incomplete`) */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Create rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Agent execution credential missing (`agent_execution_unavailable`) or clone/agent run failed (`rules_skills_create_failed`) */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     postRulesSkillsPullRequest: {
         parameters: {
             query?: never;