# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Governance API
  version: 1.0.0
extends: openapi/thehiveryiq-com-governance-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/v1/governance/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check governance service health and signer
      effect: read
      questions:
      - Is the AI governance receipt service up?
      - Which signing key fingerprint is the governance service using for samples?
      instructions:
      - text: Check governance service health.
      - text: Get the governance sample-signer fingerprint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/sample-receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: View a static example AI-use receipt
      effect: read
      questions:
      - What does an Ed25519-signed AI-use receipt look like?
      - Is there a free reference example of the receipt governance pilots get?
      instructions:
      - text: Show me the static example AI-use receipt.
      - text: Fetch the public reference receipt shape without signing anything new.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/sample-receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue a signed sample receipt for a use case
      effect: write
      questions:
      - How do I generate a signed AI-use receipt for my own use case?
      - Can the sample receipt include my model family and routing policy?
      instructions:
      - text: Issue a signed sample receipt for use case {use_case}.
        slots:
          use_case: requestBody.use_case
      - text: Generate a sample receipt for {use_case} at {enterprise_label} using model family {model_family}.
        slots:
          use_case: requestBody.use_case
          enterprise_label: requestBody.enterprise_label
          model_family: requestBody.model_family
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/sample-receipt/{receipt_id}.pdf'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a sample receipt as PDF
      effect: read
      questions:
      - Can I download a sample governance receipt as a PDF?
      - How do I get a printable version of a sample receipt?
      instructions:
      - text: Download sample receipt {receipt_id} as a PDF.
        slots:
          receipt_id: path.receipt_id
      - text: Get the PDF rendering of receipt {receipt_id}.
        slots:
          receipt_id: path.receipt_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/sample-receipt/{receipt_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sample receipt as JSON
      effect: read
      questions:
      - How do I fetch a sample receipt I generated in machine-readable JSON?
      - Where is the raw JSON of a sample governance receipt?
      instructions:
      - text: Get sample receipt {receipt_id} as JSON.
        slots:
          receipt_id: path.receipt_id
      - text: Fetch the JSON for receipt {receipt_id}.
        slots:
          receipt_id: path.receipt_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/lead'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit interest in the governance pilot
      effect: write
      questions:
      - How do I sign up for the AI governance pilot?
      - Can I leave my company and use case to be contacted about governance receipts?
      instructions:
      - text: Register {email} from {company} for the governance pilot.
        slots:
          email: requestBody.email
          company: requestBody.company
      - text: Submit a governance pilot lead for {company} with use case {use_case}.
        slots:
          company: requestBody.company
          use_case: requestBody.use_case
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/leads'].get
  update:
    x-apievangelist-phrasing:
      intent: List recent governance pilot leads (admin)
      effect: read
      questions:
      - Who has signed up for the governance pilot recently?
      - Can an admin pull the full list of pilot leads with contact details?
      instructions:
      - text: List the most recent governance leads.
      - text: Show the last {limit} governance pilot sign-ups.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/leads/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get aggregate governance lead counts
      effect: read
      questions:
      - How many governance pilot leads have come in, without seeing personal details?
      - Is there a free summary count of pilot sign-ups?
      instructions:
      - text: Give me the aggregate governance lead counts.
      - text: Summarize pilot sign-ups without any PII.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/governance/leads/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the governance leads log health
      effect: read
      questions:
      - Is the governance leads log writable and alive?
      - Can I check the leads log without an admin token?
      instructions:
      - text: Check the health of the governance leads log under /v1/governance.
      - text: Ping the versioned leads log liveness endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/leads/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Probe the top-level lead pipeline health
      effect: read
      questions:
      - Is the top-level lead-capture pipeline healthy?
      - Is there an unversioned health probe for lead capture?
      instructions:
      - text: Probe the top-level /leads/health endpoint.
      - text: Check the unversioned lead-capture pipeline health.
      method: generated
      generated: '2026-09-26'