overlay: 1.0.0
info:
  title: API Evangelist enhancements — _done Hacker News Data
  version: 1.0.0
extends: openapi/done-hackernews-data-openapi.yml
x-generated: '2026-08-11'
x-method: generated
x-source: openapi/_original/done-hackernews-data-openapi.json
x-note: 'Non-destructive. Captures API Evangelist enhancements only: catalog provenance, a canonical resource tag
  in place of the SEO keyword tag list (keywords preserved under x-keywords), and a service-namespaced canonical
  operationId. The provider spec is never mutated.'
actions:
- target: $.info
  description: Record API Evangelist provenance and the catalog identity of this service.
  update:
    x-api-evangelist:
      provider: _done
      slug: done
      catalog: https://apis.io/provider/done/
      harvested: '2026-08-11'
      source: https://hackernews-data.underscoredone.com/openapi.json
      payment_protocol: x402
      price_usd: 0.01
- target: $.paths["/fetch"].post
  description: Collapse 15 SEO keyword tags to one canonical resource tag "hacker news". The original keyword list
    is preserved as x-keywords so nothing is lost.
  update:
    tags:
    - hacker news
    x-keywords:
    - hacker news
    - hackernews
    - hacker news api
    - news
    - hn front page
    - tech news
    - hacker news stories
    - top stories
    - ask hn
    - show hn
    - hn comments
    - trending tech news
    - developer news
    - tech sentiment
    - hn jobs
- target: $.paths["/fetch"].post
  description: Namespace the operationId by service — operationIds collide across the 26 _done specs.
  update:
    x-canonical-operation-id: hackernews_data_handler_fetch_post
- target: $.tags
  description: Reduce the 15-entry SEO tag list to one canonical resource tag.
  update:
  - name: hacker news
    description: Hacker News Data