extends:
  - "spectral:oas"

formats:
  - "oas3"

rules:
  stella-info-title:
    description: "OpenAPI info.title must be present"
    message: "Add a descriptive `info.title`"
    given: "$.info.title"
    severity: error
    then:
      function: truthy

  stella-info-version:
    description: "OpenAPI info.version must be present"
    message: "Set `info.version` (SemVer or release tag)"
    given: "$.info.version"
    severity: error
    then:
      function: truthy

  stella-servers-https:
    description: "Servers should use https"
    given: "$.servers[*].url"
    severity: warn
    then:
      function: pattern
      functionOptions:
        match: "^https://"

  operation-operationId-required:
    description: "Every operation must have an operationId"
    message: "Add an `operationId` for this operation"
    given: "$.paths[*][*]"
    severity: error
    then:
      field: operationId
      function: truthy