API Evangelist conversational phrasing for SCVD General Store Corpus API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for SCVD General Store Corpus API
  version: 1.0.0
extends: openapi/scvd-store-corpus-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: 9
- target: $.paths['/corpus/index.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Page through the compact corpus index
      effect: read
      questions:
      - Can I page through snapshot metadata without downloading every snapshot body?
      - How do I follow the cursor through the compact corpus index?
      instructions:
      - text: List the compact corpus index.
      - text: Get {limit} corpus index rows starting at cursor {cursor}.
        slots:
          limit: query.limit
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/host/{host}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one host's recorded corpus history
      effect: read
      questions:
      - What history has the corpus recorded for one x402 host?
      - Is there a stable view of a host's history I can revalidate with ETags?
      instructions:
      - text: Get the corpus history for {host}.
        slots:
          host: path.host
      - text: Read {host}'s recorded history in the {view} view.
        slots:
          host: path.host
          view: query.view
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/{sequence}/evidence/{host}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the raw evidence capture behind a sealed row
      effect: read
      questions:
      - Where is the raw probe capture that a sealed row's evidence digest commits to?
      - Can I hash the evidence bytes myself to check them against the snapshot row?
      instructions:
      - text: Get the evidence capture for {host} in snapshot {sequence}.
        slots:
          host: path.host
          sequence: path.sequence
      - text: Fetch the verbatim PAYMENT-REQUIRED capture for {host} from sequence {sequence}.
        slots:
          host: path.host
          sequence: path.sequence
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/asked.json'].get
  update:
    x-apievangelist-phrasing:
      intent: See hosts people asked about that were never probed
      effect: read
      questions:
      - Which hosts have people asked about that the signed chain never probed?
      - Is a host I asked about queued for this week's walk?
      instructions:
      - text: Show the asked-for queue.
      - text: List unprobed hosts by number of asks and where each stands this week.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/tiers.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List every host's passport tier
      effect: read
      questions:
      - What passport tier does each host carry, and from what fraction of rounds?
      - Which hosts are established, standing or broken?
      instructions:
      - text: Get every host's passport tier.
      - text: List hosts alphabetically with their tier and the weeks it spans.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/trajectory.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the corpus as a time series
      effect: read
      questions:
      - How have x402 verdict counts changed across the signed weekly snapshots?
      - Can I see doors per rail and failure classes week over week?
      instructions:
      - text: Get the corpus trajectory.
      - text: Show one point per signed weekly snapshot with its verdict counts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/battery-delta.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Compare what the v2 battery catches over v1
      effect: read
      questions:
      - How many doors would v1 call ready that the stricter v2 battery catches?
      - Which v2-only checks catch the most doors each week?
      instructions:
      - text: Get the battery delta.
      - text: Show where the v1 and v2 preflight batteries disagree, per signed week.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/wallet-facts.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count receiving addresses shared across doors
      effect: read
      questions:
      - How many receiving addresses are shared across more than one x402 door?
      - What is the largest cluster of doors paying into one address?
      instructions:
      - text: Get the wallet facts.
      - text: Count this week's receiving addresses and how many serve several doors.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/corpus/diff.json'].get
  update:
    x-apievangelist-phrasing:
      intent: See what changed since a signed week
      effect: read
      questions:
      - What doors appeared or disappeared since a given signed week?
      - Which doors changed verdict or drifted in price since that week?
      instructions:
      - text: Diff the corpus since week {since}.
        slots:
          since: query.since
      - text: Show verdict transitions and price drift since {since}.
        slots:
          since: query.since
      method: generated
      generated: '2026-09-26'