SSH API Rules

extends: spectral:oas
rules:
  ssh-operation-summary-title-case:
    description: All operation summaries must use Title Case
    severity: warn
    given: "$.paths[*][*].summary"
    then:
      function: pattern
      functionOptions:
        match: "^([A-Z][a-z0-9]*\\s?)+$"

  ssh-operationid-camel-case:
    description: operationId must use camelCase
    severity: warn
    given: "$.paths[*][*].operationId"
    then:
      function: pattern
      functionOptions:
        match: "^[a-z][a-zA-Z0-9]*$"

  ssh-tags-required:
    description: Every operation must have at least one tag
    severity: error
    given: "$.paths[*][*]"
    then:
      field: tags
      function: truthy

  ssh-description-required:
    description: All operations must have a description
    severity: warn
    given: "$.paths[*][*].description"
    then:
      function: truthy

  ssh-key-operations-security:
    description: All key management operations must require authentication
    severity: error
    given: "$.paths[*/keys*][*]"
    then:
      field: security
      function: truthy

  ssh-response-success-required:
    description: All operations must define a success response
    severity: error
    given: "$.paths[*][get,post,put,delete]"
    then:
      field: responses
      function: truthy