API Evangelist enhancements for SpectrumOutage API

# authorship: generated by API Evangelist tooling. Stamped 2026-08-18
# on the file's own generator header (roadmap#64). An unmarked file is
# NOT assumed to be ours -- absence of evidence was never stamped.
x-method: generated
overlay: 1.0.0
info:
  title: API Evangelist enhancements for SpectrumOutage API
  version: 1.0.0
x-generated: '2026-08-11'
x-method: generated
x-source: openapi/spectrumoutage-api-openapi.yml
extends: openapi/spectrumoutage-api-openapi.yml
actions:
  - target: $.info
    description: Record the API Evangelist profile and the artifacts derived from this specification.
    update:
      x-apievangelist-profile: https://apis.io/provider/spectrumoutage-api/
      x-apievangelist-artifacts:
        authentication: authentication/spectrumoutage-api-authentication.yml
        conventions: conventions/spectrumoutage-api-conventions.yml
        errors: errors/spectrumoutage-api-problem-types.yml
        lifecycle: lifecycle/spectrumoutage-api-lifecycle.yml
        rate_limits: rate-limits/spectrumoutage-api-rate-limits.yml
        plans: plans/spectrumoutage-api-plans-pricing.yml
        data_model: data-model/spectrumoutage-api-data-model.yml
        skills: skills/_index.yml
  - target: $.info
    description: >-
      Record the observed availability of the documented base URL. Every documented operation returned an
      HTML 404 at https://spectrumoutage.us/api/v1 when probed anonymously and with a bearer header on
      2026-08-11. See lifecycle/spectrumoutage-api-lifecycle.yml for the full probe table.
    update:
      x-apievangelist-availability:
        checked: '2026-08-11'
        base_url: https://spectrumoutage.us/api/v1
        observed_status: 404
        observed_content_type: text/html
        note: unauthenticated probe only; a key is issued by email and could not be obtained for this check
  - target: $.info
    description: Record the agent-facing surface the provider serves, and the convention deviation on its path.
    update:
      x-apievangelist-agent-surface:
        llms_txt: https://api.spectrumoutage.us/llm.txt
        llms_txt_deviation: served at /llm.txt (singular); /llms.txt returns 404 on both hosts
        mcp_server: none
        agent_card: none
        agent_skills: skills/_index.yml (generated by API Evangelist, not provider-published)
  - target: $.paths['/reports'].post
    description: >-
      Flag that the only write operation carries no idempotency contract — a retried submission creates a
      duplicate report.
    update:
      x-apievangelist-idempotency:
        supported: false
        note: no idempotency key header or request-deduplication guidance is documented
  - target: $.components.schemas.CityResponse.properties.data
    description: Flag an untyped response payload that an agent cannot bind to.
    update:
      x-apievangelist-schema-gap: payload declared as a bare object with no properties
  - target: $.components.schemas.StateResponse.properties.data
    description: Flag an untyped response payload that an agent cannot bind to.
    update:
      x-apievangelist-schema-gap: payload declared as a bare object with no properties
  - target: $.components.schemas.StatesListResponse.properties.data
    description: Flag an untyped response payload that an agent cannot bind to.
    update:
      x-apievangelist-schema-gap: free-form slug-to-count map with no properties declared
  - target: $.components.schemas.MapResponse.properties.data
    description: Flag an untyped response payload that an agent cannot bind to.
    update:
      x-apievangelist-schema-gap: payload declared as a bare object with no properties