naftiko: "1.0.0-alpha2"

info:
  title: Kong Service Catalog Publish
  description: >-
    Publishes Naftiko-built capabilities into the Kong Konnect Service
    Catalog — Konnect's centralized inventory of services, resources,
    and scorecards across the org. Lets a Naftiko capability appear in
    the same catalog Konnect uses to track maturity, ownership, and
    API mappings for the broader gateway estate.
  tags:
    - Naftiko
    - Kong
    - Partnership
    - Service-Catalog
    - Konnect
    - Discovery
  created: '2026-05-15'
  modified: '2026-05-15'

binds:
  - namespace: kong-konnect
    description: Kong Konnect Platform API endpoint + token.
    keys:
      KONG_KONNECT_BASE: KONG_KONNECT_BASE
      KONG_KONNECT_TOKEN: KONG_KONNECT_TOKEN

capability:
  consumes:
    - namespace: kong
      type: http
      baseUri: '{{KONG_KONNECT_BASE}}'
      authentication:
        type: bearer
        token: '{{KONG_KONNECT_TOKEN}}'
      resources:
        - name: catalog-services
          path: '/v1/catalog/services'
          operations:
            - name: list-catalog-services
              method: GET
            - name: create-catalog-service
              method: POST
        - name: catalog-service
          path: '/v1/catalog/services/{{service_id}}'
          operations:
            - name: get-catalog-service
              method: GET
              inputParameters:
                - { name: service_id, in: path, required: true }
            - name: update-catalog-service
              method: PATCH
              inputParameters:
                - { name: service_id, in: path, required: true }
            - name: delete-catalog-service
              method: DELETE
              inputParameters:
                - { name: service_id, in: path, required: true }
        - name: catalog-resources
          path: '/v1/catalog/services/{{service_id}}/resources'
          operations:
            - name: list-catalog-resources
              method: GET
              inputParameters:
                - { name: service_id, in: path, required: true }
            - name: create-catalog-resource
              method: POST
              inputParameters:
                - { name: service_id, in: path, required: true }
        - name: catalog-scorecards
          path: '/v1/catalog/services/{{service_id}}/scorecards'
          operations:
            - name: list-catalog-scorecards
              method: GET
              inputParameters:
                - { name: service_id, in: path, required: true }
        - name: catalog-api-mappings
          path: '/v1/catalog/services/{{service_id}}/api-mappings'
          operations:
            - name: list-api-mappings
              method: GET
              inputParameters:
                - { name: service_id, in: path, required: true }
            - name: create-api-mapping
              method: POST
              inputParameters:
                - { name: service_id, in: path, required: true }

  exposes:
    - type: rest
      address: 0.0.0.0
      port: 8080
      namespace: kong-service-catalog-publish-rest
      description: REST surface for publishing Naftiko capabilities into Kong Konnect Service Catalog.
      resources:
        - name: catalog-services
          path: '/catalog/services'
          operations:
            - name: list-catalog-services
              method: GET
              call: kong.list-catalog-services
            - name: create-catalog-service
              method: POST
              call: kong.create-catalog-service
        - name: catalog-service
          path: '/catalog/services/{service_id}'
          operations:
            - name: get-catalog-service
              method: GET
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.get-catalog-service
            - name: update-catalog-service
              method: PATCH
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.update-catalog-service
            - name: delete-catalog-service
              method: DELETE
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.delete-catalog-service
        - name: catalog-resources
          path: '/catalog/services/{service_id}/resources'
          operations:
            - name: list-catalog-resources
              method: GET
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.list-catalog-resources
            - name: create-catalog-resource
              method: POST
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.create-catalog-resource
        - name: catalog-scorecards
          path: '/catalog/services/{service_id}/scorecards'
          operations:
            - name: list-catalog-scorecards
              method: GET
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.list-catalog-scorecards
        - name: catalog-api-mappings
          path: '/catalog/services/{service_id}/api-mappings'
          operations:
            - name: list-api-mappings
              method: GET
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.list-api-mappings
            - name: create-api-mapping
              method: POST
              inputParameters:
                - { name: service_id, in: path, type: string, required: true }
              call: kong.create-api-mapping

    - type: mcp
      address: 0.0.0.0
      port: 3010
      namespace: kong-service-catalog-publish-mcp
      description: MCP server for publishing Naftiko capabilities into Kong Konnect Service Catalog.
      tools:
        - name: list-catalog-services
          description: List entries in the Kong Konnect Service Catalog.
          hints: { readOnly: true }
          call: kong.list-catalog-services
        - name: create-catalog-service
          description: Publish a new entry into the Kong Konnect Service Catalog (typically a Naftiko-built capability).
          hints: { destructiveHint: false }
          call: kong.create-catalog-service
        - name: get-catalog-service
          description: Get a single Kong Service Catalog entry.
          hints: { readOnly: true }
          inputParameters:
            - { name: service_id, type: string, required: true }
          call: kong.get-catalog-service
        - name: update-catalog-service
          description: Update a Kong Service Catalog entry.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: service_id, type: string, required: true }
          call: kong.update-catalog-service
        - name: delete-catalog-service
          description: Delete a Kong Service Catalog entry.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: service_id, type: string, required: true }
          call: kong.delete-catalog-service
        - name: list-catalog-resources
          description: List resources attached to a Kong Service Catalog entry.
          hints: { readOnly: true }
          inputParameters:
            - { name: service_id, type: string, required: true }
          call: kong.list-catalog-resources
        - name: create-catalog-resource
          description: Attach a resource (spec, repo, doc) to a Kong Service Catalog entry.
          hints: { destructiveHint: false }
          inputParameters:
            - { name: service_id, type: string, required: true }
          call: kong.create-catalog-resource
        - name: list-catalog-scorecards
          description: List Konnect Service Catalog scorecards (maturity, ownership, governance signals) for a service.
          hints: { readOnly: true }
          inputParameters:
            - { name: service_id, type: string, required: true }
          call: kong.list-catalog-scorecards
        - name: create-api-mapping
          description: Map a published Konnect API to a Service Catalog entry.
          hints: { destructiveHint: false }
          inputParameters:
            - { name: service_id, type: string, required: true }
          call: kong.create-api-mapping