# 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 Hive Prior API
  version: 1.0.0
extends: openapi/thehiveryiq-com-hive-prior-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: 6
- target: $.paths['/v1/prior/issue'].post
  update:
    x-apievangelist-phrasing:
      intent: Stamp a patent priority record for an invention
      effect: write
      questions:
      - How do I timestamp an invention disclosure so I can prove I had it first?
      - What does a USPTO-tier priority stamp require beyond the content hash?
      - Is the priority record signed with a post-quantum signature?
      instructions:
      - text: Stamp priority for content hash {content_hash} by inventor {inventor_did}.
        slots:
          content_hash: requestBody.content_hash
          inventor_did: requestBody.inventor_did
      - text: Issue a {classification} priority record titled {title} for hash {content_hash} and inventor {inventor_did}.
        slots:
          classification: requestBody.classification
          title: requestBody.title
          content_hash: requestBody.content_hash
          inventor_did: requestBody.inventor_did
      - text: File a uspto-tier stamp for {content_hash} by {inventor_did} with application serial {uspto_application_serial}.
        slots:
          content_hash: requestBody.content_hash
          inventor_did: requestBody.inventor_did
          uspto_application_serial: requestBody.uspto_application_serial
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/prior/verify/{prior_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Verify a patent priority record
      effect: read
      questions:
      - Is a given priority record genuine and are both signatures valid?
      - Can I look up a priority stamp by its id and re-check it?
      instructions:
      - text: Verify priority record {prior_id}.
        slots:
          prior_id: path.prior_id
      - text: Re-check the dual signature on prior {prior_id}.
        slots:
          prior_id: path.prior_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/prior/by-hash/{content_hash}'].get
  update:
    x-apievangelist-phrasing:
      intent: Find who stamped a content hash first
      effect: read
      questions:
      - Who stamped a particular invention hash first?
      - Can more than one inventor stamp the same content hash?
      instructions:
      - text: List priority records for content hash {content_hash} in chronological order.
        slots:
          content_hash: path.content_hash
      - text: Show who first stamped {content_hash}.
        slots:
          content_hash: path.content_hash
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/prior/by-inventor/{inventor_did}'].get
  update:
    x-apievangelist-phrasing:
      intent: List an inventor's priority records
      effect: read
      questions:
      - Which disclosures has an inventor DID stamped, newest first?
      - Can I page through one inventor's priority records?
      instructions:
      - text: List priority records for inventor {inventor_did}.
        slots:
          inventor_did: path.inventor_did
      - text: Show {limit} records for {inventor_did} from offset {offset}.
        slots:
          limit: query.limit
          inventor_did: path.inventor_did
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/prior/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the priority stamping service health
      effect: read
      questions:
      - Is the patent priority service healthy and able to write records?
      - How many priority records are stored right now?
      instructions:
      - text: Check the priority service health and record count.
      - text: Run the priority service write probe.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/prior/leaderboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Rank inventors by priority stamps issued
      effect: read
      questions:
      - Which inventors have stamped the most disclosures in the last month?
      - Can I change the time window of the inventor leaderboard?
      instructions:
      - text: Show the top inventors by priority receipts.
      - text: Rank inventors over the last {days} days.
        slots:
          days: query.days
      method: generated
      generated: '2026-09-26'