enosix API Rules

# authorship: generated by API Evangelist tooling (derive-rules.py, 2026-10-20). x-method: generated
# Every rule below was MEASURED against enosix's own contract before it was written; a rule is present only
# when the contract satisfies it at 80% or more. Severity: 100% -> error, >= 90% -> warn, else info.
# Provenance:
#   - operation-has-description: 100%
#   - operation-has-success-response: 100%
#   - operation-declares-4xx: 100%
#   - path-segment-casing-camel: 100%
#   - path-no-trailing-slash: 100%
#   - path-params-in-braces: 100%
#   - list-pagination-parameter: 100%
#   - response-media-type: 100%
#   - info-has-description: 100%
x-method: generated
x-generator: derive-rules.py
x-generated: '2026-10-20'
x-source:
- openapi/enosix-sales-document-openapi.json
extends:
- - spectral:oas
  - recommended
formats:
- oas3
rules:
  operation-has-description:
    description: 'Every operation has a description (measured: 100% of this contract)'
    severity: info
    given: $.paths[*][get,post,put,patch,delete]
    then:
      field: description
      function: truthy
  operation-has-success-response:
    description: 'Every operation declares a 2xx response (measured: 100% of this contract)'
    severity: warn
    given: $.paths[*][get,post,put,patch,delete].responses
    then:
      function: schema
      functionOptions:
        schema:
          type: object
          patternProperties:
            ^2\d\d$: {}
          minProperties: 1
  operation-declares-4xx:
    description: 'Every operation declares at least one 4xx response (measured: 100% of this contract)'
    severity: error
    given: $.paths[*][get,post,put,patch,delete].responses
    then:
      function: schema
      functionOptions:
        schema:
          type: object
          patternProperties:
            ^4\d\d$: {}
          minProperties: 1
  path-segment-casing-camel:
    description: 'Path segments are camel case (measured: 100% of this contract)'
    severity: error
    given: $.paths[*]~
    then:
      function: pattern
      functionOptions:
        match: ^(/[a-z][a-zA-Z0-9]*|/\{[^}]+\})+/?$
  path-no-trailing-slash:
    description: 'Paths carry no trailing slash (measured: 100% of this contract)'
    severity: error
    given: $.paths[*]~
    then:
      function: pattern
      functionOptions:
        notMatch: ./$
  path-params-in-braces:
    description: 'Path parameters use {braces}, not :colon (measured: 100% of this contract)'
    severity: error
    given: $.paths[*]~
    then:
      function: pattern
      functionOptions:
        notMatch: ':'
  list-pagination-parameter:
    description: 'Collection GETs take the `pageNumber` pagination parameter (measured: 100% of this contract)'
    severity: error
    given: $.paths[*].get
    then:
      field: parameters
      function: schema
      functionOptions:
        schema:
          type: array
          contains:
            type: object
            properties:
              name:
                const: pageNumber
            required:
            - name
  response-media-type:
    description: 'Responses are served as application/json (measured: 100% of this contract)'
    severity: error
    given: $.paths[*][get,post,put,patch,delete].responses[*].content
    then:
      function: schema
      functionOptions:
        schema:
          type: object
          required:
          - application/json
  info-has-description:
    description: 'The contract''s info block carries a description (measured: 100% of this contract)'
    severity: error
    given: $.info
    then:
      field: description
      function: truthy