# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gitdealflow Com Meta API
  version: 1.0.0
extends: openapi/gitdealflow-com-meta-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/api/changelog.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the machine-readable changelog
      effect: read
      questions:
      - What changed recently in GitDealFlow?
      - Is there a machine-readable changelog at the unversioned path?
      instructions:
      - text: Get the latest changelog entries.
      - text: Fetch the unversioned machine-readable changelog.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/pricing.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the pricing table
      effect: read
      questions:
      - What pricing tiers are offered and how much do they cost?
      - Are the tier slugs stable enough to reference from an agent?
      instructions:
      - text: Get the current pricing tiers.
      - text: Show the machine-readable pricing table.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/changelog.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the changelog from the v1 path
      effect: read
      questions:
      - Can I pin to a versioned v1 URL for the changelog?
      - Where's the v1 alias of the changelog feed?
      instructions:
      - text: Fetch the changelog from the versioned v1 path.
      - text: Pull the v1 alias of the changelog.
      method: generated
      generated: '2026-10-01'