We > Ultrarich — wealth inequality briefing

arazzo: 1.0.1
info:
  title: We > Ultrarich — wealth inequality briefing
  version: 1.0.0
  summary: >-
    Discover the available wealth expressions, run a direction-aware them-vs-you comparison, then add a
    purchasing-power lens on the ultrarich side — the three calls behind a quotable inequality briefing.
sourceDescriptions:
- name: comparisonApi
  url: ../openapi/wegtultrarich-comparison-api-openapi.yml
  type: openapi
- name: discoveryApi
  url: ../openapi/wegtultrarich-discovery-api-openapi.yml
  type: openapi
- name: wealthExpressionApi
  url: ../openapi/wegtultrarich-wealth-expression-api-openapi.yml
  type: openapi
workflows:
- workflowId: wealthInequalityBriefing
  summary: Build a quotable them-vs-you briefing from one user wealth and one ultrarich wealth.
  description: >-
    No authentication is required. Step 1 discovers the expression routes at runtime. Step 2 is the
    single call that carries the story — it returns both results plus the direction-aware ratio. Step 3
    adds a second lens on the ultrarich figure alone. Quote the `sentence` fields; branch on `scale`,
    which is null by design when a result is too small to anchor; append the attribution string.
  inputs:
    type: object
    required: [wealthYours, wealthTheirs]
    properties:
      wealthYours:
        type: string
        description: The user's wealth. Plain, formatted or shorthand — words are not valid.
        default: '100000'
      wealthTheirs:
        type: string
        description: The ultrarich wealth to compare against.
        default: '1T'
      spend:
        type: string
        description: Daily spend used by the durationOfDailySpend expression.
        default: '1000'
      typeOfItem:
        type: string
        description: Purchasing-power slug for the third step.
        default: year_of_salary_65k
  steps:
  - stepId: discoverExpressions
    description: List the available wealth-expression routes.
    operationId: expressions
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      routes: $response.body#/data
  - stepId: compareWealths
    description: Compare both wealths through the duration-of-daily-spend lens and get the ratio.
    operationId: comparison
    parameters:
    - name: expression
      in: query
      value: durationOfDailySpend
    - name: wealthYours
      in: query
      value: $inputs.wealthYours
    - name: wealthTheirs
      in: query
      value: $inputs.wealthTheirs
    - name: spend
      in: query
      value: $inputs.spend
    successCriteria:
    - condition: $statusCode == 200
    - context: $response.body
      condition: $.status == "success"
      type: jsonpath
    outputs:
      ratioSentence: $response.body#/data/ratio/sentence
      ratioScale: $response.body#/data/ratio/scale
      theirsSentence: $response.body#/data/resultTheirs/sentence
      yoursSentence: $response.body#/data/resultYours/sentence
  - stepId: purchasingPowerLens
    description: Add a purchasing-power line for the ultrarich wealth.
    operationId: numberOfItems
    parameters:
    - name: wealth
      in: query
      value: $inputs.wealthTheirs
    - name: typeOfItem
      in: query
      value: $inputs.typeOfItem
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      itemsSentence: $response.body#/data/sentence
      itemsScale: $response.body#/data/scale
  outputs:
    ratio: $steps.compareWealths.outputs.ratioSentence
    ratioScale: $steps.compareWealths.outputs.ratioScale
    theirs: $steps.compareWealths.outputs.theirsSentence
    yours: $steps.compareWealths.outputs.yoursSentence
    purchasingPower: $steps.purchasingPowerLens.outputs.itemsSentence
x-attribution: 'Source: We > Ultrarich (wegtultrarich.org).'
x-generated: '2026-08-09'
x-method: generated
x-rate-limit: 100 requests/minute per IP across all of /v1 — this workflow makes 3 calls.