openapi: 3.1.0
info:
  title: "Smart Bootstrap Manager REST API"
  description: "Central OpenAPI contract generated during Smart Repository release packaging."
  version: 1.8.2
servers:
  -
    url: https://example.com/wp-json
    description: "Replace with the target WordPress site REST root"
tags:
  -
    name: AI
  -
    name: Sources
  -
    name: Effects
  -
    name: Governance
  -
    name: Audit
  -
    name: Documentation
paths:
  /smart-bootstrap-manager/v1/design-governance:
    get:
      tags:
        - Governance
      summary: "Design governance"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
    put:
      tags:
        - Governance
      summary: "Update design governance"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/effects:
    get:
      tags:
        - Effects
      summary: "UI/FX effects settings and catalog"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
    put:
      tags:
        - Effects
      summary: "Update effects settings"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/ai/context:
    get:
      tags:
        - AI
      summary: "AI context"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/capabilities:
    get:
      tags:
        - AI
      summary: "Runtime capabilities and compatibility report"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/consumer-contract:
    get:
      tags:
        - AI
      summary: "Consumer contract for themes and plugins"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/schema:
    get:
      tags:
        - AI
      summary: "AI writable schema"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/openapi:
    get:
      tags:
        - Documentation
      summary: "OpenAPI JSON document"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/openapi:
    get:
      tags:
        - Documentation
      summary: "OpenAPI JSON document alias"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/ai/openapi.yaml:
    get:
      tags:
        - Documentation
      summary: "OpenAPI YAML document"
      responses:
        200:
          description: "Successful YAML response"
          content:
            application/yaml:
              schema:
                "$ref": "#/components/schemas/OpenAPI"
  /smart-bootstrap-manager/v1/openapi.yaml:
    get:
      tags:
        - Documentation
      summary: "OpenAPI YAML document alias"
      responses:
        200:
          description: "Successful YAML response"
          content:
            application/yaml:
              schema:
                "$ref": "#/components/schemas/OpenAPI"
  /smart-bootstrap-manager/v1/ai/options:
    get:
      tags:
        - AI
      summary: "Read framework options"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
    patch:
      tags:
        - AI
      summary: "Update framework options"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/ai/options/export:
    get:
      tags:
        - AI
      summary: "Export framework options"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/options/reset:
    get:
      tags:
        - AI
      summary: "Reset framework options"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/presets:
    get:
      tags:
        - AI
      summary: "Presets and motion catalogs"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/audit:
    get:
      tags:
        - Audit
      summary: "Read AI audit log"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/revisions:
    get:
      tags:
        - Audit
      summary: "Read AI revisions"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
  /smart-bootstrap-manager/v1/ai/validate:
    post:
      tags:
        - AI
      summary: "Validate options without saving"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/ai/options/import:
    post:
      tags:
        - AI
      summary: "Import framework options"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/ai/sources/refresh:
    post:
      tags:
        - Sources
      summary: "Refresh source cache buster"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/ai/sources/check:
    post:
      tags:
        - Sources
      summary: "Check latest Bootstrap online version"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
  /smart-bootstrap-manager/v1/ai/sources/download:
    post:
      tags:
        - Sources
      summary: "Download Bootstrap assets locally"
      security:
        -
          wpNonce: []
        -
          applicationPassword: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/GenericObject"
      responses:
        200:
          description: "Successful response"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GenericObject"
components:
  securitySchemes:
    wpNonce:
      type: apiKey
      in: header
      name: X-WP-Nonce
    applicationPassword:
      type: http
      scheme: basic
  schemas:
    GenericObject:
      type: object
      additionalProperties: true
    OpenAPI:
      type: object
      additionalProperties: true
x-smart-repository:
  product: smart-bootstrap-manager
  type: plugin
  source: scripts/release-package.ps1
