API Evangelist conversational phrasing for Live Direct Marketing Online Development Pipeline API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Live Direct Marketing Online Development Pipeline API
  version: 1.0.0
extends: openapi/live-direct-marketing-online-development-pipeline-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: 13
- target: $.paths['/api/development-pipeline/board'].get
  update:
    x-apievangelist-phrasing:
      intent: View the development delivery board
      effect: read
      questions:
      - Which issues are in queue, with agents, in merge or deploying right now?
      - Where can I see the four-stage delivery board?
      instructions:
      - text: Show the development pipeline board across all four stages.
      - text: Display what is in queue, agents, merge and deploy.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/attention'].get
  update:
    x-apievangelist-phrasing:
      intent: See what in the pipeline needs an owner
      effect: read
      questions:
      - Which red tasks, failed deploys or agent questions need my attention?
      - Are there findings without an issue or branches waiting for merge approval?
      instructions:
      - text: Show the needs-an-owner block and delivery strip.
      - text: List everything in the pipeline waiting on me.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/prod-counter'].get
  update:
    x-apievangelist-phrasing:
      intent: Count issues shipped to production
      effect: read
      questions:
      - How many issues have actually shipped to prod with a green smoke check?
      - What counts toward the IN PROD showcase?
      instructions:
      - text: Show the IN PROD counter of shipped issues.
      - text: List issues that reached production through the main pipeline.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/ci-runs-per-merge'].get
  update:
    x-apievangelist-phrasing:
      intent: Measure CI runs per merge
      effect: read
      questions:
      - How many CI runs does each merge take on average?
      - What is the CI-runs-per-merge KPI over the last few hours?
      instructions:
      - text: Compute CI runs per merge over the last {minutes} minutes.
        slots:
          minutes: query.minutes
      - text: Show the CI runs per merge KPI for a {minutes}-minute window.
        slots:
          minutes: query.minutes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/journal'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the tester journal
      effect: read
      questions:
      - What rules, roles and findings are in the tester journal?
      - Did the tester journal integrity gate pass?
      instructions:
      - text: Show the tester journal snapshot.
      - text: Fetch the journal findings and integrity gate status.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/journal/findings/{findingId}/create-issue'].post
  update:
    x-apievangelist-phrasing:
      intent: Open an issue from a journal finding
      effect: write
      questions:
      - How do I turn a tester journal finding into a tracked issue?
      - Can I file a finding that has no issue number into a specific project?
      instructions:
      - text: Create an issue from journal finding {findingId} in project {projectId}.
        slots:
          findingId: path.findingId
          projectId: requestBody.projectId
      - text: File finding {findingId} as a from::journal issue.
        slots:
          findingId: path.findingId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/journal/findings'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a finding to the tester journal
      effect: write
      questions:
      - How do I append a new finding line to the tester journal?
      - Can an agent add a journal finding without rewriting the whole description?
      instructions:
      - text: Append the finding {line} to the tester journal.
        slots:
          line: requestBody.line
      - text: 'Log this line in journal Block 2: {line}.'
        slots:
          line: requestBody.line
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/issues/{iid}/pause'].patch
  update:
    x-apievangelist-phrasing:
      intent: Pause or unpause a development issue
      effect: write
      questions:
      - How do I stop agents from picking up an issue for now?
      - Can I remove the paused label from an issue?
      instructions:
      - text: Set paused to {paused} on issue {iid}.
        slots:
          paused: requestBody.paused
          iid: path.iid
      - text: Pause issue {iid} in project {projectId}.
        slots:
          iid: path.iid
          projectId: requestBody.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/issues/priority-triage'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign priorities to all unprioritized issues
      effect: write
      questions:
      - How do I give every open issue without a P label a priority?
      - Can I preview the priority triage before it changes anything?
      instructions:
      - text: Run priority triage on open issues in project {projectId}.
        slots:
          projectId: requestBody.projectId
      - text: Dry-run priority triage with dryRun {dryRun}.
        slots:
          dryRun: requestBody.dryRun
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/issues/{iid}/priority'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set an issue's priority
      effect: write
      questions:
      - How do I mark an issue P1-critical?
      - Which priority levels can a development issue have?
      instructions:
      - text: Set issue {iid} to priority {priority}.
        slots:
          iid: path.iid
          priority: requestBody.priority
      - text: Mark issue {iid} as P3-ux.
        slots:
          iid: path.iid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/issues/{iid}/model'].patch
  update:
    x-apievangelist-phrasing:
      intent: Choose the model that works an issue
      effect: write
      questions:
      - How do I change which executor model handles an issue?
      - Which executor models can I assign to a development issue?
      instructions:
      - text: Assign executor model {model} to issue {iid}.
        slots:
          model: requestBody.model
          iid: path.iid
      - text: Have opus work issue {iid} instead of the default.
        slots:
          iid: path.iid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/issues/{iid}/take-next'].patch
  update:
    x-apievangelist-phrasing:
      intent: Move an issue to the front of the queue
      effect: write
      questions:
      - How do I make an issue the very next thing agents pick up?
      - Can I unpause an issue and bump it to P1 in one step?
      instructions:
      - text: Take issue {iid} next.
        slots:
          iid: path.iid
      - text: Unpause issue {iid} and put it at the front of the queue.
        slots:
          iid: path.iid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/development-pipeline/issues/{iid}/close'].patch
  update:
    x-apievangelist-phrasing:
      intent: Close an issue on the owner's behalf
      effect: destructive
      questions:
      - How do I close a development issue as the owner with an audit trail?
      - What label is added when an owner closes an issue?
      instructions:
      - text: Close issue {iid} as owner.
        slots:
          iid: path.iid
      - text: Close issue {iid} in project {projectId} with a closed-by-owner comment.
        slots:
          iid: path.iid
          projectId: requestBody.projectId
      method: generated
      generated: '2026-10-01'