Architectural Design Patterns API — Patterns

naftiko: 1.0.0-alpha2
info:
  label: Architectural Design Patterns API — Patterns
  description: 'Architectural Design Patterns API — Patterns. 4 operations. Lead operation: List architectural design patterns.
    Self-contained Naftiko capability covering one Architectural Design Patterns business surface.'
  tags:
  - Architectural Design Patterns
  - Patterns
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ARCHITECTURAL_DESIGN_PATTERNS_API_KEY: ARCHITECTURAL_DESIGN_PATTERNS_API_KEY
capability:
  consumes:
  - type: http
    namespace: architectural-design-patterns-patterns
    baseUri: https://api.apievangelist.com/v1/architectural-design-patterns
    description: Architectural Design Patterns API — Patterns business capability. Self-contained, no shared references.
    resources:
    - name: patterns
      path: /patterns
      operations:
      - name: listpatterns
        method: GET
        description: List architectural design patterns
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: category
          in: query
          type: string
          description: Filter by pattern category
        - name: tag
          in: query
          type: string
          description: Filter by tag
        - name: limit
          in: query
          type: integer
        - name: offset
          in: query
          type: integer
    - name: patterns-patternId
      path: /patterns/{patternId}
      operations:
      - name: getpattern
        method: GET
        description: Get design pattern details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: patternId
          in: path
          type: string
          description: The unique pattern identifier
          required: true
    - name: patterns-patternId-examples
      path: /patterns/{patternId}/examples
      operations:
      - name: getpatternexamples
        method: GET
        description: Get implementation examples for a pattern
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: patternId
          in: path
          type: string
          required: true
        - name: language
          in: query
          type: string
          description: Programming language for examples
    - name: patterns-patternId-relationships
      path: /patterns/{patternId}/relationships
      operations:
      - name: getpatternrelationships
        method: GET
        description: Get relationships for a pattern
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: patternId
          in: path
          type: string
          required: true
  exposes:
  - type: rest
    namespace: architectural-design-patterns-patterns-rest
    port: 8080
    description: REST adapter for Architectural Design Patterns API — Patterns. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/patterns
      name: patterns
      description: REST surface for patterns.
      operations:
      - method: GET
        name: listpatterns
        description: List architectural design patterns
        call: architectural-design-patterns-patterns.listpatterns
        with:
          category: rest.category
          tag: rest.tag
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/patterns/{patternid}
      name: patterns-patternid
      description: REST surface for patterns-patternId.
      operations:
      - method: GET
        name: getpattern
        description: Get design pattern details
        call: architectural-design-patterns-patterns.getpattern
        with:
          patternId: rest.patternId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/patterns/{patternid}/examples
      name: patterns-patternid-examples
      description: REST surface for patterns-patternId-examples.
      operations:
      - method: GET
        name: getpatternexamples
        description: Get implementation examples for a pattern
        call: architectural-design-patterns-patterns.getpatternexamples
        with:
          patternId: rest.patternId
          language: rest.language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/patterns/{patternid}/relationships
      name: patterns-patternid-relationships
      description: REST surface for patterns-patternId-relationships.
      operations:
      - method: GET
        name: getpatternrelationships
        description: Get relationships for a pattern
        call: architectural-design-patterns-patterns.getpatternrelationships
        with:
          patternId: rest.patternId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: architectural-design-patterns-patterns-mcp
    port: 9090
    transport: http
    description: MCP adapter for Architectural Design Patterns API — Patterns. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: list-architectural-design-patterns
      description: List architectural design patterns
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: architectural-design-patterns-patterns.listpatterns
      with:
        category: tools.category
        tag: tools.tag
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: get-design-pattern-details
      description: Get design pattern details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: architectural-design-patterns-patterns.getpattern
      with:
        patternId: tools.patternId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-implementation-examples-pattern
      description: Get implementation examples for a pattern
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: architectural-design-patterns-patterns.getpatternexamples
      with:
        patternId: tools.patternId
        language: tools.language
      outputParameters:
      - type: object
        mapping: $.
    - name: get-relationships-pattern
      description: Get relationships for a pattern
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: architectural-design-patterns-patterns.getpatternrelationships
      with:
        patternId: tools.patternId
      outputParameters:
      - type: object
        mapping: $.