@plainconceptsplatform/workflows 0.4.33 → 0.5.1

package/loops/workflows/work-router.yml

@@ -1,551 +1,862 @@
-# Managed by @plainconceptsplatform/workflows. Source: loops/workflows/work-router.yml. Update with `workflows update --force`; consumer edits may be overwritten.
-name: "All Work Router"
-
-# Owns every repository automation trigger. Classifies each event into exactly one route,
-# then calls at most one worker or runs one deterministic job. No model runs here.
-
-# GitHub titles an issue-triggered run with the issue title, so every run on one issue reads
-# the same. Name it after the event instead. This is evaluated before any job, so it can
-# describe the trigger but not the route the classifier picks.
-run-name: >-
-  ${{ github.event_name == 'issues'
-  && github.event.label.name == 'bot-working'
-  && contains(github.event.issue.labels.*.name, 'implement')
-  && format('Working (Implement): {0} (#{1})', github.event.issue.title, github.event.issue.number)
-  || github.event_name == 'issues'
-  && github.event.label.name == 'bot-working'
-  && contains(github.event.issue.labels.*.name, 'refine')
-  && format('Working (Refine): {0} (#{1})', github.event.issue.title, github.event.issue.number)
-  || github.event_name == 'issues'
-  && github.event.label.name == 'bot-working'
-  && contains(github.event.issue.labels.*.name, 'direct')
-  && format('Working (Direct): {0} (#{1})', github.event.issue.title, github.event.issue.number)
-  || github.event_name == 'issues'
-  && github.event.label.name == 'bot-working'
-  && format('Working: {0} (#{1})', github.event.issue.title, github.event.issue.number)
-  || github.event_name == 'issues'
-  && format('{0} label on #{1} by {2}', github.event.label.name, github.event.issue.number, github.actor)
-  || github.event_name == 'issue_comment'
-  && format('comment on #{0} by {1}', github.event.issue.number, github.actor)
-  || github.event_name == 'pull_request_review'
-  && format('review on PR #{0} by {1}', github.event.pull_request.number, github.actor)
-  || github.event_name == 'pull_request_review_comment'
-  && format('review comment on PR #{0} by {1}', github.event.pull_request.number, github.actor)
-  || github.event_name == 'pull_request_target'
-  && format('PR #{0} {1} by {2}', github.event.pull_request.number, github.event.action, github.actor)
-  || github.event_name == 'workflow_run'
-  && format('CI {0} on {1}', github.event.workflow_run.conclusion, github.event.workflow_run.head_branch)
-  || github.event_name == 'workflow_dispatch'
-  && format('dispatch: {0}', inputs.operation)
-  || github.event_name == 'schedule'
-  && format('schedule {0}', github.event.schedule)
-  || github.event_name }}
-
-on:
-  issues:
-    types: [labeled]
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  pull_request_review:
-    types: [submitted]
-
-  pull_request_target:
-    types: [opened, synchronize, reopened, labeled]
-  workflow_run:
-    workflows: ["App: CI", "CI"]
-    types: [completed]
-    branches:
-      - "fix/*"
-      - "bugfix/*"
-      - "feature/*"
-      - "bot/*"
-      - "patch/*"
-      - "hotfix/*"
-
-  # Cron to route mapping lives in .github/actions/classify-route/classify-route.sh.
-  schedule:
-    - cron: "17 1 * * 1"
-    - cron: "43 3 * * *"
-    - cron: "0 6 * * *"
-    - cron: "*/30 * * * *"
-    - cron: "29 7 * * *"
-
-  workflow_dispatch:
-    inputs:
-      operation:
-        description: "Operation to run"
-        required: true
-        type: choice
-        options:
-          - refine
-          - implement
-          - direct
-          - apply-review
-          - merge-gate
-          - audit
-          - propose
-          - audit-close
-          - cleanup-artifacts
-          - reconcile-bot-pr-runs
-          - validate
-      issue-number:
-        description: "Issue number (required for refine / implement / direct)"
-        required: false
-        type: string
-      pr-number:
-        description: "Pull request number (required for apply-review / merge-gate)"
-        required: false
-        type: string
-      mode:
-        description: "Refine mode: first or rerefine"
-        required: false
-        type: choice
-        options:
-          - first
-          - rerefine
-      ci-conclusion:
-        description: "CI conclusion for merge-gate dispatch"
-        required: false
-        type: choice
-        options:
-          - success
-          - failure
-          - action_required
-      ci-run-id:
-        description: "CI workflow run ID for merge-gate dispatch"
-        required: false
-        type: string
-      trigger-kind:
-        description: "Audit trigger: scheduled or manual"
-        required: false
-        type: choice
-        options:
-          - manual
-          - scheduled
-
-permissions:
-  contents: read
-
-jobs:
-  # Public repositories must check repository permission before an event can start a model.
-  authorize:
-    runs-on: RunnerLandingZone
-    timeout-minutes: 5
-    permissions:
-      contents: read
-    outputs:
-      trusted: ${{ steps.check.outputs.trusted }}
-    steps:
-      - name: Check the actor can start an agent
-        id: check
-        env:
-          GH_TOKEN: ${{ github.token }}
-          ACTOR: ${{ github.actor }}
-          EVENT: ${{ github.event_name }}
-        run: |
-          set -euo pipefail
-
-          # Events with no human actor. `schedule` and `workflow_run` are the fleet triggering
-          # itself; `workflow_dispatch` is already restricted by GitHub to write and above.
-          case "$EVENT" in
-            schedule | workflow_run | workflow_dispatch)
-              echo "trusted=true" >> "$GITHUB_OUTPUT"
-              echo "::notice::$EVENT has no untrusted actor."
-              exit 0
-              ;;
-          esac
-
-          # Platform bot owns Safe Outputs. Its label changes must be able to
-          # start the follow-on worker, even though GitHub does not report it
-          # as a repository collaborator.
-          if [ "$ACTOR" = "github-actions[bot]" ] || [ "$ACTOR" = "platform-devbox[bot]" ]; then
-            echo "trusted=true" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          permission=$(gh api "repos/$GITHUB_REPOSITORY/collaborators/$ACTOR/permission" \
-            --jq '.permission' 2>/dev/null || echo "none")
-
-          case "$permission" in
-            admin | maintain | write)
-              echo "trusted=true" >> "$GITHUB_OUTPUT"
-              echo "::notice::$ACTOR has $permission permission."
-              ;;
-            *)
-              echo "trusted=false" >> "$GITHUB_OUTPUT"
-              echo "::notice::$ACTOR has '$permission' permission on this repository. No agent will run."
-              ;;
-          esac
-
-  classify:
-    runs-on: RunnerLandingZone
-    timeout-minutes: 5
-    permissions:
-      contents: read
-      pull-requests: read
-    outputs:
-      route: ${{ steps.route.outputs.route }}
-      issue-number: ${{ steps.route.outputs.issue-number }}
-      pr-number: ${{ steps.route.outputs.pr-number }}
-      linked-issue: ${{ steps.route.outputs.linked-issue }}
-      ci-conclusion: ${{ steps.route.outputs.ci-conclusion }}
-      ci-run-id: ${{ steps.route.outputs.ci-run-id }}
-      refine-mode: ${{ steps.route.outputs.refine-mode }}
-      direct-mode: ${{ steps.route.outputs.direct-mode }}
-      trigger-kind: ${{ steps.route.outputs.trigger-kind }}
-    steps:
-      - name: Checkout workflow actions
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-      - name: Classify event into a single route
-        id: route
-        uses: ./.github/actions/classify-route
-        with:
-          token: ${{ github.token }}
-
-  call-refine:
-    needs: [classify, authorize]
-    if: needs.classify.outputs.route == 'refine' && needs.authorize.outputs.trusted == 'true'
-    uses: ./.github/workflows/agent-refine.lock.yml
-    concurrency:
-      group: refine-${{ needs.classify.outputs.issue-number }}
-      cancel-in-progress: false
-    # write-all, not a narrower map: every worker's agent job declares `permissions: read-all`,
-    # which requests read on every scope. A caller granting less cannot satisfy it, and GitHub
-    # rejects the call with a startup failure before any job is created. The real boundary is the
-    # worker's own read-all plus safe-outputs, not this grant.
-    permissions: write-all
-    with:
-      issue-number: ${{ needs.classify.outputs.issue-number }}
-      mode: ${{ needs.classify.outputs.refine-mode }}
-    secrets:
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-
-  # Checks whether an open bot PR already exists for the issue. If it does, implement is
-  # skipped — the merge-gate will handle fixing the existing PR. This prevents duplicate
-  # PRs when retries are triggered after a merge-gate failure.
-  check-implement-pr:
-    needs: [classify, authorize]
-    if: needs.classify.outputs.route == 'implement' && needs.authorize.outputs.trusted == 'true'
-    runs-on: RunnerLandingZone
-    timeout-minutes: 3
-    permissions:
-      contents: read
-      pull-requests: read
-    outputs:
-      has-open-pr: ${{ steps.check.outputs.has-open-pr }}
-    steps:
-      - name: Check for existing open bot PR
-        id: check
-        env:
-          GH_TOKEN: ${{ github.token }}
-          REPO: ${{ github.repository }}
-          ISSUE_NUMBER: ${{ needs.classify.outputs.issue-number }}
-        run: |
-          set -euo pipefail
-          existing=$(gh pr list --repo "$REPO" --state open \
-            --search "is:pr linked:issue $ISSUE_NUMBER" \
-            --json number,author --jq '[.[] | select(.author.login | test("[bot]$"))] | length')
-          if [ "$existing" -gt 0 ]; then
-            echo "has-open-pr=true" >> "$GITHUB_OUTPUT"
-            echo "::notice::Issue #$ISSUE_NUMBER already has an open bot PR. Skipping implement to prevent duplicates."
-          else
-            echo "has-open-pr=false" >> "$GITHUB_OUTPUT"
-          fi
-
-  call-implement:
-    needs: [classify, authorize, check-implement-pr]
-    if: needs.classify.outputs.route == 'implement' && needs.authorize.outputs.trusted == 'true' && needs.check-implement-pr.outputs.has-open-pr != 'true'
-    uses: ./.github/workflows/agent-implement.lock.yml
-    concurrency:
-      group: write-pipeline-${{ needs.classify.outputs.issue-number }}
-      cancel-in-progress: false
-    permissions: write-all
-    with:
-      issue-number: ${{ needs.classify.outputs.issue-number }}
-    secrets:
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-
-  call-direct:
-    needs: [classify, authorize]
-    if: needs.classify.outputs.route == 'direct' && needs.authorize.outputs.trusted == 'true'
-    uses: ./.github/workflows/agent-direct.lock.yml
-    concurrency:
-      group: direct-${{ needs.classify.outputs.issue-number }}
-      cancel-in-progress: false
-    permissions: write-all
-    with:
-      issue-number: ${{ needs.classify.outputs.issue-number }}
-      mode: ${{ needs.classify.outputs.direct-mode }}
-    secrets:
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-
-  call-apply-review:
-    needs: [classify, authorize]
-    if: needs.classify.outputs.route == 'apply-review' && needs.authorize.outputs.trusted == 'true'
-    uses: ./.github/workflows/agent-apply-review.lock.yml
-    concurrency:
-      group: pr-feedback-${{ needs.classify.outputs.pr-number }}
-      cancel-in-progress: false
-    permissions: write-all
-    with:
-      pr-number: ${{ needs.classify.outputs.pr-number }}
-      linked-issue: ${{ needs.classify.outputs.linked-issue }}
-    secrets:
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-
-  # Shares the write-pipeline group with implement so the two never race on one issue.
-  # Falls back to the pull request number only when the closing issue cannot be resolved.
-  call-merge-gate:
-    needs: classify
-    if: needs.classify.outputs.route == 'merge-gate'
-    uses: ./.github/workflows/agent-merge-gate.lock.yml
-    concurrency:
-      group: write-pipeline-${{ needs.classify.outputs.linked-issue || format('pr-{0}', needs.classify.outputs.pr-number) }}
-      cancel-in-progress: false
-    permissions: write-all
-    with:
-      pr-number: ${{ needs.classify.outputs.pr-number }}
-      linked-issue: ${{ needs.classify.outputs.linked-issue }}
-      ci-conclusion: ${{ needs.classify.outputs.ci-conclusion }}
-      ci-run-id: ${{ needs.classify.outputs.ci-run-id }}
-    secrets:
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-
-  call-audit:
-    needs: classify
-    if: needs.classify.outputs.route == 'audit'
-    uses: ./.github/workflows/agent-audit.lock.yml
-    concurrency:
-      group: audit
-      cancel-in-progress: false
-    permissions: write-all
-    with:
-      trigger-kind: ${{ needs.classify.outputs.trigger-kind }}
-    secrets:
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-
-  call-propose:
-    needs: classify
-    if: needs.classify.outputs.route == 'propose'
-    uses: ./.github/workflows/agent-propose.lock.yml
-    concurrency:
-      group: propose
-      cancel-in-progress: false
-    permissions: write-all
-    with:
-      trigger-kind: ${{ needs.classify.outputs.trigger-kind }}
-    secrets:
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-
-  bot-approve:
-    needs: classify
-    if: >
-      needs.classify.outputs.route == 'bot-approve' &&
-        (github.actor == 'app/github-actions' || github.actor == 'platform-devbox[bot]')
-    runs-on: RunnerLandingZone
-    timeout-minutes: 5
-    permissions:
-      actions: write
-    steps:
-      - name: Approve pending workflow runs
-        env:
-          GH_TOKEN: ${{ github.token }}
-          REPO: ${{ github.repository }}
-          BRANCH: ${{ github.head_ref }}
-        run: |
-          set -euo pipefail
-
-          mapfile -t run_ids < <(
-            gh api "repos/$REPO/actions/runs?status=action_required&branch=$BRANCH" \
-              --jq '.workflow_runs[].id'
-          )
-
-          if [ "${#run_ids[@]}" -eq 0 ]; then
-            echo "No runs awaiting approval on branch $BRANCH"
-            exit 0
-          fi
-
-          for run_id in "${run_ids[@]}"; do
-            echo "Approving run $run_id"
-            gh api "repos/$REPO/actions/runs/$run_id/approve" --method POST
-          done
-
-  reconcile-bot-pr-runs:
-    needs: classify
-    if: needs.classify.outputs.route == 'reconcile-bot-pr-runs'
-    runs-on: RunnerLandingZone
-    timeout-minutes: 5
-    permissions:
-      contents: read
-      actions: write
-      pull-requests: read
-    env:
-      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
-      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
-    steps:
-      - name: Checkout for App token action
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-      - name: Generate App token
-        id: app-token
-        uses: actions/create-github-app-token@df432ceedc7162793a195dd1713ff69aefc7379e # v2.0.6
-        with:
-          app-id: ${{ secrets.BOT_APP_ID }}
-          private-key: ${{ secrets.BOT_PRIVATE_KEY }}
-      # Runs only the default-branch workflow and never checks out pull-request code.
-      # External users cannot impersonate github-actions[bot].
-      - name: Approve checks and dispatch Merge Gate for trusted bot pull requests
-        env:
-          GH_TOKEN: ${{ steps.app-token.outputs.token }}
-          REPO: ${{ github.repository }}
-          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
-        run: |
-          set -euo pipefail
-
-          gh api "repos/$REPO/pulls?state=open&per_page=100" |
-            jq -r --arg repo "$REPO" '
-              .[]
-              | select(
-                  (.user.login == "github-actions[bot]" or .user.login == "app/github-actions" or .user.login == "platform-devbox[bot]")
-                  and .head.repo.full_name == $repo
-                  and .mergeable_state != "dirty"
-                )
-              | [.number, .head.ref] | @tsv
-            ' |
-            while IFS=$'\t' read -r pr_number branch; do
-              gh api "repos/$REPO/actions/runs?status=action_required&branch=$branch" \
-                --jq '.workflow_runs[]
-                  | select(
-                      .event == "pull_request"
-                      and (.name == "App: CI" or .name == "Visual evidence")
-                    )
-                  | .id' |
-                while IFS= read -r run_id; do
-                  echo "Approving trusted bot run $run_id"
-                  gh api "repos/$REPO/actions/runs/$run_id/approve" --method POST
-                done
-
-              # Check if merge-gate already ran for this PR (comment on PR or linked issue)
-              gate_recorded=$(gh api "repos/$REPO/issues/$pr_number/comments?per_page=100" \
-                --jq 'any(.[]; .body | contains("<!-- agent-merge-gate -->"))')
-              if [ "$gate_recorded" = "true" ]; then
-                echo "Merge gate already recorded for PR #$pr_number, skipping"
-                continue
-              fi
-
-              # Also check the linked issue comments if the PR closes an issue
-              linked_issue=$(gh pr view "$pr_number" --repo "$REPO" --json closingIssuesReferences --jq '.closingIssuesReferences[0].number // empty' 2>/dev/null || true)
-              if [ -n "$linked_issue" ]; then
-                gate_recorded=$(gh api "repos/$REPO/issues/$linked_issue/comments?per_page=100" \
-                  --jq 'any(.[]; .body | contains("<!-- agent-merge-gate -->"))')
-                if [ "$gate_recorded" = "true" ]; then
-                  echo "Merge gate already recorded on issue #$linked_issue for PR #$pr_number, skipping"
-                  continue
-                fi
-              fi
-
-              ci=$(gh api "repos/$REPO/actions/runs?branch=$branch&per_page=100" \
-                --jq '[.workflow_runs[]
-                  | select(
-                      .name == "App: CI"
-                      and .event == "pull_request"
-                      and .status == "completed"
-                      and (.conclusion == "success" or .conclusion == "failure")
-                    )
-                  ] | sort_by(.created_at) | last // empty | [.id, .conclusion] | @tsv')
-              if [ -z "$ci" ]; then
-                continue
-              fi
-
-              IFS=$'\t' read -r ci_run_id ci_conclusion <<<"$ci"
-              echo "Dispatching Merge Gate for PR #$pr_number ($ci_conclusion, run $ci_run_id)"
-              gh api "repos/$REPO/actions/workflows/work-router.yml/dispatches" \
-                --method POST \
-                -f ref="$DEFAULT_BRANCH" \
-                -f "inputs[operation]=merge-gate" \
-                -f "inputs[pr-number]=$pr_number" \
-                -f "inputs[ci-conclusion]=$ci_conclusion" \
-                -f "inputs[ci-run-id]=$ci_run_id"
-            done
-
-  audit-close:
-    needs: classify
-    if: needs.classify.outputs.route == 'audit-close'
-    runs-on: RunnerLandingZone
-    timeout-minutes: 15
-    concurrency:
-      group: audit-close
-      cancel-in-progress: false
-    permissions:
-      contents: read
-      issues: write
-    steps:
-      - name: Checkout workflow actions
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-      - uses: ./.github/actions/audit-close
-        with:
-          token: ${{ github.token }}
-
-  cleanup-artifacts:
-    needs: classify
-    if: needs.classify.outputs.route == 'cleanup-artifacts' && !github.event.repository.fork
-    runs-on: RunnerLandingZone
-    timeout-minutes: 15
-    concurrency:
-      group: cleanup-artifacts
-      cancel-in-progress: false
-    permissions:
-      contents: read
-      actions: write
-    steps:
-      - name: Checkout workflow actions
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-      - uses: ./.github/actions/cleanup-artifacts
-        with:
-          token: ${{ github.token }}
-          artifact-retention-days: ${{ vars.ARTIFACT_RETENTION_DAYS }}
-
-  validate:
-    needs: classify
-    if: needs.classify.outputs.route == 'validate'
-    runs-on: RunnerLandingZone
-    timeout-minutes: 10
-    permissions:
-      contents: read
-    steps:
-      - name: Checkout workflow actions
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-      - uses: ./.github/actions/verify-route-matrix
-      - uses: ./.github/actions/verify-composite-actions
+# Managed by @plainconceptsplatform/workflows. Source: loops/workflows/work-router.yml. Update with `workflows update --force`; consumer edits may be overwritten.
+name: "All Work Router"
+
+# Owns every repository automation trigger. Classifies each event into exactly one route,
+# then calls at most one worker or runs one deterministic job. No model runs here.
+
+# GitHub titles an issue-triggered run with the issue title, so every run on one issue reads
+# the same. Name it after the event instead. This is evaluated before any job, so it can
+# describe the trigger but not the route the classifier picks.
+run-name: >-
+  ${{ github.event_name == 'issues'
+  && github.event.action == 'opened'
+  && format('Issue opened: {0} (#{1}) by {2}', github.event.issue.title, github.event.issue.number, github.actor)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'bot-working'
+  && contains(github.event.issue.labels.*.name, 'implement')
+  && format('Working (Implement): {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'bot-working'
+  && contains(github.event.issue.labels.*.name, 'refine')
+  && format('Working (Refine): {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'bot-working'
+  && contains(github.event.issue.labels.*.name, 'direct')
+  && format('Working (Direct): {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'bot-working'
+  && contains(github.event.issue.labels.*.name, 'triage')
+  && format('Working (Triage): {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'bot-working'
+  && format('Working: {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'implement'
+  && endsWith(github.actor, '[bot]')
+  && format('Working (Implement): {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'refine'
+  && endsWith(github.actor, '[bot]')
+  && format('Working (Refine): {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && github.event.label.name == 'direct'
+  && endsWith(github.actor, '[bot]')
+  && format('Working (Direct): {0} (#{1})', github.event.issue.title, github.event.issue.number)
+  || github.event_name == 'issues'
+  && format('{0} label on #{1} by {2}', github.event.label.name, github.event.issue.number, github.actor)
+  || github.event_name == 'issue_comment'
+  && format('comment on #{0} by {1}', github.event.issue.number, github.actor)
+  || github.event_name == 'pull_request_review'
+  && format('review on PR #{0} by {1}', github.event.pull_request.number, github.actor)
+  || github.event_name == 'pull_request_review_comment'
+  && format('review comment on PR #{0} by {1}', github.event.pull_request.number, github.actor)
+  || github.event_name == 'pull_request_target'
+  && format('PR #{0} {1} by {2}', github.event.pull_request.number, github.event.action, github.actor)
+  || github.event_name == 'workflow_run'
+  && format('CI {0} on {1}', github.event.workflow_run.conclusion, github.event.workflow_run.head_branch)
+  || github.event_name == 'workflow_dispatch'
+  && inputs.operation == 'triage'
+  && format('Working (Triage): #{0}', inputs.issue-number)
+  || github.event_name == 'workflow_dispatch'
+  && inputs.operation == 'refine'
+  && format('Working (Refine): #{0}', inputs.issue-number)
+  || github.event_name == 'workflow_dispatch'
+  && inputs.operation == 'implement'
+  && format('Working (Implement): #{0}', inputs.issue-number)
+  || github.event_name == 'workflow_dispatch'
+  && inputs.operation == 'merge-gate'
+  && format('Working (Merge Gate): PR #{0}', inputs.pr-number)
+  || github.event_name == 'workflow_dispatch'
+  && inputs.operation == 'batch'
+  && format('Working (Batch): #{0}', inputs.issue-number)
+  || github.event_name == 'workflow_dispatch'
+  && format('dispatch: {0}', inputs.operation)
+  || github.event_name == 'schedule'
+  && format('schedule {0}', github.event.schedule)
+  || github.event_name }}
+
+on:
+  issues:
+    types: [opened, labeled]
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  pull_request_review:
+    types: [submitted]
+
+  pull_request_target:
+    # opened / reopened / synchronize feed conflict detection (detect-pr-conflicts) and
+    # bot-approve. closed feeds detect-pr-conflicts: when a PR merges, the target branch
+    # moved and previously-mergeable sibling bot PRs may now conflict.
+    types: [opened, synchronize, reopened, labeled, closed]
+
+  # CI completion on a pull request. Enabled so a FAILED CI run dispatches the Merge Gate
+  # immediately instead of waiting for the hourly reconcile. The classifier admits only
+  # conclusion == failure with an attached pull request; a green run still reaches merge
+  # through app-ci's dispatch-merge-gate and the reconcile belt, so routing success here
+  # would double-fire the gate on every passing PR.
+  #
+  # Caveat that still holds (2026-08-28): GitHub does not deliver workflow_run for CI runs
+  # whose originating event came from GITHUB_TOKEN, so a bot-opened PR's own CI completion
+  # may never arrive here — reconcile-bot-pr-runs remains the belt for that gap. Security:
+  # workflow_run runs from the default branch with secrets, but the gate's subject job
+  # rejects any PR that is not open and bot-authored, so a fork PR's failing CI cannot
+  # start privileged work.
+  workflow_run:
+    workflows: ["App: CI"]
+    types: [completed]
+
+  # Cron to route mapping lives in .github/actions/classify-route/classify-route.sh.
+  schedule:
+    # Slot 0. Every consumer installs this same file, and the agent fleet is one shared,
+    # two-VM scale set, so a second repository left on slot 0 audits at the same minute as
+    # the first. Pick a free slot per repository: see "Scheduling across repositories" in the
+    # package README, and change AUDIT_CRON in classify-route.sh to match, or the run fires
+    # and classifies to no route.
+    - cron: "17 1 * * 1"
+    - cron: "43 3 * * *"
+    - cron: "0 6 * * *"
+    - cron: "17 * * * *"
+    - cron: "29 7 * * *"
+
+  workflow_dispatch:
+    inputs:
+      operation:
+        description: "Operation to run"
+        required: true
+        type: choice
+        options:
+          - refine
+          - implement
+          - triage
+          - apply-review
+          - merge-gate
+          - audit
+          - audit-close
+          - cleanup-artifacts
+          - reconcile-bot-pr-runs
+          - validate
+          - release
+      issue-number:
+        description: "Issue number (required for refine / implement / direct)"
+        required: false
+        type: string
+      pr-number:
+        description: "Pull request number (required for apply-review / merge-gate)"
+        required: false
+        type: string
+      mode:
+        description: "Refine mode: first or rerefine"
+        required: false
+        type: choice
+        options:
+          - first
+          - rerefine
+      ci-conclusion:
+        description: "CI conclusion for merge-gate dispatch"
+        required: false
+        type: choice
+        options:
+          - success
+          - failure
+          - action_required
+      ci-run-id:
+        description: "CI workflow run ID for merge-gate dispatch"
+        required: false
+        type: string
+      trigger-kind:
+        description: "Audit trigger: scheduled or manual"
+        required: false
+        type: choice
+        options:
+          - manual
+          - scheduled
+      version-bump:
+        description: "Release version bump: patch, minor, major, or auto"
+        required: false
+        type: choice
+        options:
+          - auto
+          - patch
+          - minor
+          - major
+
+permissions:
+  contents: read
+
+jobs:
+  # Public repositories must check repository permission before an event can start a model.
+  authorize:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+    outputs:
+      trusted: ${{ steps.check.outputs.trusted }}
+      is_outside_collaborator: ${{ steps.check.outputs.is_outside_collaborator }}
+    steps:
+      - name: Check the actor can start an agent
+        id: check
+        env:
+          GH_TOKEN: ${{ github.token }}
+          ACTOR: ${{ github.actor }}
+          EVENT: ${{ github.event_name }}
+        run: |
+          set -euo pipefail
+
+          # Events with no human actor. `schedule` and `workflow_run` are the fleet triggering
+          # itself; `workflow_dispatch` is already restricted by GitHub to write and above.
+          case "$EVENT" in
+            schedule | workflow_run | workflow_dispatch)
+              echo "trusted=true" >> "$GITHUB_OUTPUT"
+              echo "is_outside_collaborator=false" >> "$GITHUB_OUTPUT"
+              echo "::notice::$EVENT has no untrusted actor."
+              exit 0
+              ;;
+          esac
+
+          # Platform bot owns Safe Outputs. Its label changes must be able to
+          # start the follow-on worker, even though GitHub does not report it
+          # as a repository collaborator.
+          if [ "$ACTOR" = "github-actions[bot]" ] || [ "$ACTOR" = "platform-devbox[bot]" ]; then
+            echo "trusted=true" >> "$GITHUB_OUTPUT"
+            echo "is_outside_collaborator=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          permission=$(gh api "repos/$GITHUB_REPOSITORY/collaborators/$ACTOR/permission" \
+            --jq '.permission' 2>/dev/null || echo "none")
+
+          # Check if the actor is an organization member. Outside collaborators can have
+          # write/maintain permission on a repo without being org members. Triage is for
+          # outside collaborators only — a non-member with write access is still outside.
+          org=$(echo "$GITHUB_REPOSITORY" | cut -d/ -f1)
+          is_member=false
+          if gh api "orgs/$org/members/$ACTOR" >/dev/null 2>&1; then
+            is_member=true
+          fi
+
+          case "$permission" in
+            admin | maintain | write)
+              if [ "$is_member" = "true" ]; then
+                echo "trusted=true" >> "$GITHUB_OUTPUT"
+                echo "is_outside_collaborator=false" >> "$GITHUB_OUTPUT"
+                echo "::notice::$ACTOR has $permission permission and is an org member."
+              else
+                echo "trusted=true" >> "$GITHUB_OUTPUT"
+                echo "is_outside_collaborator=true" >> "$GITHUB_OUTPUT"
+                echo "::notice::$ACTOR has $permission permission but is NOT an org member (outside collaborator). Triage route eligible."
+              fi
+              ;;
+            read)
+              echo "trusted=false" >> "$GITHUB_OUTPUT"
+              echo "is_outside_collaborator=true" >> "$GITHUB_OUTPUT"
+              echo "::notice::$ACTOR is an outside collaborator (read permission). Triage route eligible."
+              ;;
+            *)
+              echo "trusted=false" >> "$GITHUB_OUTPUT"
+              echo "is_outside_collaborator=false" >> "$GITHUB_OUTPUT"
+              echo "::notice::$ACTOR has '$permission' permission on this repository. No agent will run."
+              ;;
+          esac
+
+  classify:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      route: ${{ steps.route.outputs.route }}
+      issue-number: ${{ steps.route.outputs.issue-number }}
+      pr-number: ${{ steps.route.outputs.pr-number }}
+      linked-issue: ${{ steps.route.outputs.linked-issue }}
+      ci-conclusion: ${{ steps.route.outputs.ci-conclusion }}
+      ci-run-id: ${{ steps.route.outputs.ci-run-id }}
+      refine-mode: ${{ steps.route.outputs.refine-mode }}
+      triage-mode: ${{ steps.route.outputs.triage-mode }}
+      trigger-kind: ${{ steps.route.outputs.trigger-kind }}
+    steps:
+      - name: Checkout workflow actions
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Classify event into a single route
+        id: route
+        uses: ./.github/actions/classify-route
+        with:
+          token: ${{ github.token }}
+
+  call-refine:
+    needs: [classify, authorize]
+    if: needs.classify.outputs.route == 'refine' && needs.authorize.outputs.trusted == 'true'
+    uses: ./.github/workflows/agent-refine.lock.yml
+    concurrency:
+      group: refine-${{ needs.classify.outputs.issue-number }}
+      cancel-in-progress: false
+    # write-all, not a narrower map: every worker's agent job declares `permissions: read-all`,
+    # which requests read on every scope. A caller granting less cannot satisfy it, and GitHub
+    # rejects the call with a startup failure before any job is created. The real boundary is the
+    # worker's own read-all plus safe-outputs, not this grant.
+    permissions: write-all
+    with:
+      issue-number: ${{ needs.classify.outputs.issue-number }}
+      mode: ${{ needs.classify.outputs.refine-mode }}
+    secrets:
+      OPENAI_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      CODEX_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      COPILOT_GITHUB_TOKEN: ${{ secrets.FORGE_API_KEY }}
+      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
+      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
+      AGENTMEMORY_SECRET: ${{ secrets.AGENTMEMORY_SECRET }}
+
+  # Checks whether an open bot PR already exists for the issue. If it does, implement is
+  # skipped — the merge-gate will handle fixing the existing PR. This prevents duplicate
+  # PRs when retries are triggered after a merge-gate failure.
+  check-implement-pr:
+    needs: [classify, authorize]
+    if: needs.classify.outputs.route == 'implement' && needs.authorize.outputs.trusted == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      has-open-pr: ${{ steps.check.outputs.has-open-pr }}
+    steps:
+      - name: Check for existing open bot PR
+        id: check
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+          ISSUE_NUMBER: ${{ needs.classify.outputs.issue-number }}
+        run: |
+          set -euo pipefail
+          # A refine-to-implement transition emits two label events (the implement label,
+          # then the worker re-adding bot-working) and each one classifies to implement.
+          # The older router run wins: a younger run that finds an older live implement
+          # route for the same issue skips instead of queueing a duplicate worker. Only
+          # bot-actor titles are counted, so a human's "waiting for bot-working" run can
+          # never block the real one.
+          for st in in_progress queued; do
+            dupes=$(gh api "repos/$REPO/actions/workflows/work-router.yml/runs?status=$st&per_page=100"               --jq "[.workflow_runs[]
+                | select(.id < $GITHUB_RUN_ID)
+                | select(
+                    ((.display_title | startswith(\"Working (Implement)\")) and (.display_title | contains(\"(#${ISSUE_NUMBER})\")))
+                    or
+                    ((.display_title | contains(\"implement label on #${ISSUE_NUMBER} by\")) and (.display_title | endswith(\"[bot]\")))
+                  )
+              ] | length" 2>/dev/null || echo 0)
+            if [ "${dupes:-0}" -gt 0 ]; then
+              echo "has-open-pr=true" >> "$GITHUB_OUTPUT"
+              echo "::notice::An older router run is already implementing #$ISSUE_NUMBER; skipping the duplicate."
+              exit 0
+            fi
+          done
+
+          # Marker-first: implement stamps <!-- implement-pr: N --> on the issue when its
+          # pull request is created, so the duplicate check is an exact lookup. Only an
+          # OPEN marker PR blocks; a merged or closed one means a re-implement is legitimate.
+          marker_pr=$(gh issue view "$ISSUE_NUMBER" --repo "$REPO" --json body --jq '.body // ""' \
+            | grep -oE '<!-- implement-pr: [0-9]+ -->' | head -1 | grep -oE '[0-9]+' || true)
+          if [ -n "$marker_pr" ]; then
+            state=$(gh pr view "$marker_pr" --repo "$REPO" --json state --jq '.state' 2>/dev/null || echo GONE)
+            if [ "$state" = "OPEN" ]; then
+              echo "has-open-pr=true" >> "$GITHUB_OUTPUT"
+              echo "::notice::Issue #$ISSUE_NUMBER is marked as implemented by open PR #$marker_pr. Skipping duplicate implement."
+              exit 0
+            fi
+            echo "Marker PR #$marker_pr is $state; a fresh implement is allowed."
+          fi
+
+          existing=$(gh pr list --repo "$REPO" --state open --json number,author,body \
+            --jq "[.[]
+              | select(.author.login | startswith(\"app/\") or endswith(\"[bot]\"))
+              | (.body | ascii_downcase) as \$body
+              | select(\$body | contains(\"close #${ISSUE_NUMBER}\") or contains(\"closes #${ISSUE_NUMBER}\") or contains(\"closed #${ISSUE_NUMBER}\") or contains(\"fix #${ISSUE_NUMBER}\") or contains(\"fixes #${ISSUE_NUMBER}\") or contains(\"fixed #${ISSUE_NUMBER}\") or contains(\"resolve #${ISSUE_NUMBER}\") or contains(\"resolves #${ISSUE_NUMBER}\") or contains(\"resolved #${ISSUE_NUMBER}\"))
+            ] | length")
+          if [ "$existing" -gt 0 ]; then
+            echo "has-open-pr=true" >> "$GITHUB_OUTPUT"
+            echo "::notice::Issue #$ISSUE_NUMBER already has an open bot PR. Skipping implement to prevent duplicates."
+          else
+            echo "has-open-pr=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  call-implement:
+    needs: [classify, authorize, check-implement-pr]
+    if: needs.classify.outputs.route == 'implement' && needs.authorize.outputs.trusted == 'true' && needs.check-implement-pr.outputs.has-open-pr != 'true'
+    uses: ./.github/workflows/agent-implement.lock.yml
+    concurrency:
+      group: implement-global
+      cancel-in-progress: false
+      # FIFO, up to 100 waiting. Without this the default `queue: single` cancels whatever
+      # was pending, so labelling six issues at once implements one and drops the rest.
+      queue: max
+    permissions: write-all
+    with:
+      issue-number: ${{ needs.classify.outputs.issue-number }}
+    secrets:
+      OPENAI_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      CODEX_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      COPILOT_GITHUB_TOKEN: ${{ secrets.FORGE_API_KEY }}
+      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
+      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
+      AGENTMEMORY_SECRET: ${{ secrets.AGENTMEMORY_SECRET }}
+
+  dispatch-triage:
+    needs: [classify, authorize]
+    if: needs.classify.outputs.route == 'triage' && needs.authorize.outputs.is_outside_collaborator == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      actions: write
+      contents: read
+    steps:
+      - name: Create bot token
+        id: app-token
+        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
+        with:
+          client-id: ${{ secrets.BOT_APP_ID }}
+          private-key: ${{ secrets.BOT_PRIVATE_KEY }}
+      - name: Dispatch trusted triage run
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          REPO: ${{ github.repository }}
+          REF: ${{ github.event.repository.default_branch }}
+          ISSUE_NUMBER: ${{ needs.classify.outputs.issue-number }}
+          MODE: ${{ needs.classify.outputs.triage-mode }}
+        run: |
+          set -euo pipefail
+          gh workflow run work-router.yml --repo "$REPO" --ref "$REF" \
+            -f operation=triage \
+            -f issue-number="$ISSUE_NUMBER" \
+            -f mode="$MODE"
+
+  call-triage:
+    needs: [classify, authorize]
+    # Triage on issue open is for outside collaborators only (handled by dispatch-triage).
+    # A trusted actor who opens an issue should not start triage — they can add refine/implement/direct
+    # labels or manually dispatch triage. All other triage routes (labeled, comment, dispatch) are trusted.
+    if: needs.classify.outputs.route == 'triage' && needs.authorize.outputs.trusted == 'true' && !(github.event_name == 'issues' && github.event.action == 'opened')
+    uses: ./.github/workflows/agent-triage.lock.yml
+    concurrency:
+      group: triage-${{ needs.classify.outputs.issue-number }}
+      cancel-in-progress: false
+    permissions: write-all
+    with:
+      issue-number: ${{ needs.classify.outputs.issue-number }}
+      mode: ${{ needs.classify.outputs.triage-mode }}
+    secrets:
+      OPENAI_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      CODEX_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      COPILOT_GITHUB_TOKEN: ${{ secrets.FORGE_API_KEY }}
+      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
+      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
+      AGENTMEMORY_SECRET: ${{ secrets.AGENTMEMORY_SECRET }}
+
+  call-apply-review:
+    needs: [classify, authorize]
+    if: needs.classify.outputs.route == 'apply-review' && needs.authorize.outputs.trusted == 'true'
+    uses: ./.github/workflows/agent-apply-review.lock.yml
+    concurrency:
+      group: pr-feedback-${{ needs.classify.outputs.pr-number }}
+      cancel-in-progress: false
+    permissions: write-all
+    with:
+      pr-number: ${{ needs.classify.outputs.pr-number }}
+      linked-issue: ${{ needs.classify.outputs.linked-issue }}
+    secrets:
+      OPENAI_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      CODEX_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      COPILOT_GITHUB_TOKEN: ${{ secrets.FORGE_API_KEY }}
+      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
+      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
+      AGENTMEMORY_SECRET: ${{ secrets.AGENTMEMORY_SECRET }}
+
+  # Shares the write-pipeline group with implement so the two never race on one issue.
+  # Falls back to the pull request number only when the closing issue cannot be resolved.
+  call-merge-gate:
+    needs: classify
+    if: needs.classify.outputs.route == 'merge-gate'
+    uses: ./.github/workflows/agent-merge-gate.lock.yml
+    concurrency:
+      group: write-pipeline-${{ needs.classify.outputs.linked-issue || format('pr-{0}', needs.classify.outputs.pr-number) }}
+      cancel-in-progress: false
+    permissions: write-all
+    with:
+      pr-number: ${{ needs.classify.outputs.pr-number }}
+      linked-issue: ${{ needs.classify.outputs.linked-issue }}
+      ci-conclusion: ${{ needs.classify.outputs.ci-conclusion }}
+      ci-run-id: ${{ needs.classify.outputs.ci-run-id }}
+    secrets:
+      OPENAI_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      CODEX_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      COPILOT_GITHUB_TOKEN: ${{ secrets.FORGE_API_KEY }}
+      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
+      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
+      AGENTMEMORY_SECRET: ${{ secrets.AGENTMEMORY_SECRET }}
+
+  call-audit:
+    needs: classify
+    if: needs.classify.outputs.route == 'audit'
+    uses: ./.github/workflows/agent-audit.lock.yml
+    concurrency:
+      group: audit
+      cancel-in-progress: false
+    permissions: write-all
+    with:
+      trigger-kind: ${{ needs.classify.outputs.trigger-kind }}
+    secrets:
+      OPENAI_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      CODEX_API_KEY: ${{ secrets.FORGE_API_KEY }}
+      COPILOT_GITHUB_TOKEN: ${{ secrets.FORGE_API_KEY }}
+      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
+      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
+      AGENTMEMORY_SECRET: ${{ secrets.AGENTMEMORY_SECRET }}
+
+  call-release:
+    needs: [classify, authorize]
+    if: needs.classify.outputs.route == 'release' && needs.authorize.outputs.trusted == 'true'
+    uses: ./.github/workflows/agent-release.lock.yml
+    permissions: write-all
+    with:
+      version-bump: ${{ github.event.inputs.version-bump || 'auto' }}
+    secrets:
+      OPENAI_API_KEY: ${{ secrets.FORGE_API_KEY }}
+
+  bot-approve:
+    needs: classify
+    if: >
+      needs.classify.outputs.route == 'bot-approve' &&
+        (github.actor == 'app/github-actions' || github.actor == 'platform-devbox[bot]')
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      actions: write
+    steps:
+      - name: Approve pending workflow runs
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+          BRANCH: ${{ github.head_ref }}
+        run: |
+          set -euo pipefail
+
+          mapfile -t run_ids < <(
+            gh api "repos/$REPO/actions/runs?status=action_required&branch=$BRANCH" \
+              --jq '.workflow_runs[].id'
+          )
+
+          if [ "${#run_ids[@]}" -eq 0 ]; then
+            echo "No runs awaiting approval on branch $BRANCH"
+            exit 0
+          fi
+
+          for run_id in "${run_ids[@]}"; do
+            echo "Approving run $run_id"
+            gh api "repos/$REPO/actions/runs/$run_id/approve" --method POST
+          done
+
+  # Conflict watcher for bot pull requests. Merge-conflict state is only available from the
+  # mergeability API, which the pure classifier cannot read, so this is an event-gated
+  # deterministic dispatcher rather than a classify route (it runs alongside bot-approve on
+  # the same pull_request_target event). It NEVER checks out or runs pull request code — it
+  # reads mergeability through the API and dispatches the Merge Gate — so it is safe on
+  # pull_request_target. Two entry points:
+  #   opened / reopened / synchronize → check the pull request that changed. Gated to this
+  #     repository's own branches so a fork PR never starts this App-token job.
+  #   closed & merged                 → the target branch moved, so re-check every open bot
+  #     pull request that may have just become conflicted (the "main changed after another PR
+  #     merged" case). A merge into the default branch is an inherently trusted internal event.
+  # It dispatches only for bot-authored, open, non-draft pull requests whose head is this
+  # repository AND whose CI has already concluded (dispatching while CI is still pending would
+  # make the gate read a 'pending' verdict and prematurely ask for human review; that PR is
+  # covered by the CI-completion route instead). The gate's subject job re-validates ownership
+  # before any agent runs.
+  detect-pr-conflicts:
+    needs: classify
+    if: >
+      github.event_name == 'pull_request_target' &&
+      (
+        (github.event.action == 'closed' && github.event.pull_request.merged == true) ||
+        (
+          (github.event.action == 'opened' ||
+           github.event.action == 'reopened' ||
+           github.event.action == 'synchronize') &&
+          github.event.pull_request.head.repo.full_name == github.repository
+        )
+      )
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      pull-requests: read
+      actions: write
+    steps:
+      - name: Checkout for App token action
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Generate App token
+        id: app-token
+        uses: actions/create-github-app-token@df432ceedc7162793a195dd1713ff69aefc7379e # v2.0.6
+        with:
+          app-id: ${{ secrets.BOT_APP_ID }}
+          private-key: ${{ secrets.BOT_PRIVATE_KEY }}
+      - name: Dispatch Merge Gate for conflicting bot pull requests
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          REPO: ${{ github.repository }}
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+          ACTION: ${{ github.event.action }}
+          EVENT_PR: ${{ github.event.pull_request.number }}
+        run: |
+          set -euo pipefail
+
+          # Dispatch the Merge Gate for one pull request when it is a conflicting, open,
+          # non-draft, bot-authored pull request on this repository whose CI has concluded.
+          maybe_dispatch() {
+            pr="$1"
+            [ -n "$pr" ] || return 0
+
+            meta=$(gh api "repos/$REPO/pulls/$pr" \
+              --jq '{state:.state, draft:.draft, bot:.user.type, head:(.head.repo.full_name // "")}' \
+              2>/dev/null || echo '')
+            [ -n "$meta" ] || return 0
+            [ "$(jq -r '.state' <<<"$meta")" = "open" ] || return 0
+            [ "$(jq -r '.draft' <<<"$meta")" = "false" ] || return 0
+            [ "$(jq -r '.bot'   <<<"$meta")" = "Bot" ] || return 0
+            [ "$(jq -r '.head'  <<<"$meta")" = "$REPO" ] || return 0
+
+            # GitHub computes mergeability asynchronously; poll until it is known (not null).
+            mergeable=""
+            for _ in 1 2 3 4 5 6; do
+              mergeable=$(gh api "repos/$REPO/pulls/$pr" --jq '.mergeable // "null"' 2>/dev/null || echo null)
+              [ "$mergeable" = "null" ] || break
+              sleep 5
+            done
+            # mergeable == false means a git-level conflict (mergeable_state "dirty").
+            if [ "$mergeable" != "false" ]; then
+              echo "PR #$pr mergeable=$mergeable; no conflict dispatch."
+              return 0
+            fi
+
+            # Only dispatch when CI has already concluded. A conflict while CI is still
+            # running is handled by the CI-completion route; dispatching now would make the
+            # gate read a 'pending' conclusion and prematurely ask for human review.
+            head_sha=$(gh api "repos/$REPO/pulls/$pr" --jq '.head.sha')
+            ci=$(gh api "repos/$REPO/actions/runs?head_sha=$head_sha&per_page=100" \
+              --jq '[.workflow_runs[]
+                | select(.name == "App: CI" and .status == "completed"
+                         and (.conclusion == "success" or .conclusion == "failure"))]
+                | sort_by(.created_at) | last // empty')
+            if [ -z "$ci" ]; then
+              echo "PR #$pr conflicts but CI has not concluded; deferring to the CI-completion route."
+              return 0
+            fi
+            ci_conclusion=$(jq -r '.conclusion' <<<"$ci")
+            ci_run_id=$(jq -r '.id' <<<"$ci")
+
+            echo "PR #$pr is conflicting (CI $ci_conclusion); dispatching Merge Gate."
+            gh api "repos/$REPO/actions/workflows/work-router.yml/dispatches" \
+              --method POST \
+              -f ref="$DEFAULT_BRANCH" \
+              -f "inputs[operation]=merge-gate" \
+              -f "inputs[pr-number]=$pr" \
+              -f "inputs[ci-conclusion]=$ci_conclusion" \
+              -f "inputs[ci-run-id]=$ci_run_id"
+          }
+
+          if [ "$ACTION" = "closed" ]; then
+            # The target branch just moved. Any previously-mergeable bot PR may now conflict.
+            # The just-merged PR is now closed and is skipped by maybe_dispatch's state check.
+            gh api "repos/$REPO/pulls?state=open&per_page=100" \
+              --jq '.[] | select(.user.type == "Bot" and .draft == false) | .number' |
+              while IFS= read -r pr; do
+                maybe_dispatch "$pr"
+              done
+          else
+            maybe_dispatch "$EVENT_PR"
+          fi
+
+  reconcile-bot-pr-runs:
+    needs: classify
+    if: needs.classify.outputs.route == 'reconcile-bot-pr-runs'
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+      actions: write
+      pull-requests: read
+      # the stale reservation sweep clears bot-working from parked issues
+      issues: write
+    env:
+      BOT_APP_ID: ${{ secrets.BOT_APP_ID }}
+      BOT_PRIVATE_KEY: ${{ secrets.BOT_PRIVATE_KEY }}
+    steps:
+      - name: Checkout for App token action
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Generate App token
+        id: app-token
+        uses: actions/create-github-app-token@df432ceedc7162793a195dd1713ff69aefc7379e # v2.0.6
+        with:
+          app-id: ${{ secrets.BOT_APP_ID }}
+          private-key: ${{ secrets.BOT_PRIVATE_KEY }}
+      # Runs only the default-branch workflow and never checks out pull-request code.
+      # External users cannot impersonate github-actions[bot].
+      - name: Approve checks and dispatch Merge Gate for trusted bot pull requests
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          REPO: ${{ github.repository }}
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+        run: |
+          set -euo pipefail
+
+          # Stale reservation sweep. Labelling ten issues at once labels all ten immediately,
+          # because authorize-bot-work is keyed per issue, while implement-global lets exactly
+          # one run at a time. A queued run that is cancelled therefore leaves its issue
+          # carrying bot-working with no run and no pull request: parked, invisible, and not
+          # re-triggerable, because classify refuses an issue that is already reserved.
+          gh issue list --repo "$REPO" --label bot-working --state open --limit 100 \
+            --json number --jq '.[].number' |
+            while IFS= read -r issue; do
+              [ -n "$issue" ] || continue
+
+              live=$(gh api "repos/$REPO/actions/runs?per_page=100" \
+                --jq "[.workflow_runs[]
+                  | select(.status == \"queued\" or .status == \"in_progress\" or .status == \"pending\" or .status == \"waiting\")
+                  | select(.display_title | test(\"#${issue}\\b\"))] | length")
+              [ "${live:-0}" -eq 0 ] || continue
+
+              has_pr=$(gh pr list --repo "$REPO" --state open --json body \
+                --jq "[.[] | select((.body // \"\") | ascii_downcase | test(\"clos(e|es|ed) #${issue}\\b|fix(es|ed)? #${issue}\\b|resolves? #${issue}\\b\"))] | length")
+              [ "${has_pr:-0}" -eq 0 ] || continue
+
+              echo "Clearing a stale bot-working reservation on #$issue: no run, no pull request."
+              gh issue edit "$issue" --repo "$REPO" --remove-label bot-working
+            done
+
+          gh api "repos/$REPO/pulls?state=open&per_page=100" |
+            jq -r --arg repo "$REPO" '
+              .[]
+              | select(
+                    (.user.login == "github-actions[bot]" or .user.login == "app/github-actions" or .user.login == "platform-devbox[bot]")
+                    and .draft == false
+                    and .head.repo.full_name == $repo
+                 )
+              | [.number, .head.ref, .head.sha] | @tsv
+            ' |
+            while IFS=$'\t' read -r pr_number branch head_sha; do
+              gh api "repos/$REPO/actions/runs?status=action_required&branch=$branch" \
+                --jq '.workflow_runs[]
+                  | select(
+                      .event == "pull_request"
+                      and .name == "App: CI"
+                    )
+                  | .id' |
+                while IFS= read -r run_id; do
+                  echo "Approving trusted bot run $run_id"
+                  gh api "repos/$REPO/actions/runs/$run_id/approve" --method POST
+                done
+
+              ci=$(gh api "repos/$REPO/actions/runs?head_sha=$head_sha&per_page=100" \
+                --jq '[.workflow_runs[]
+                  | select(
+                      .name == "App: CI"
+                      and .event == "pull_request"
+                      and .status == "completed"
+                      and (.conclusion == "success" or .conclusion == "failure")
+                    )
+                  ] | sort_by(.created_at) | last // empty | [.id, .conclusion, .updated_at] | @tsv')
+              if [ -z "$ci" ]; then
+                continue
+              fi
+
+              IFS=$'\t' read -r ci_run_id ci_conclusion ci_finished <<<"$ci"
+
+              # A recorded verdict only counts when it is NEWER than the latest CI run.
+              # The old existence check made the gate one-shot per PR: after any verdict
+              # (say remediated), a later CI completion could never reopen the gate, so
+              # the fix-CI loop starved. ISO-8601 timestamps compare lexicographically.
+              latest_marker=$(gh api "repos/$REPO/issues/$pr_number/comments?per_page=100" \
+                --jq '[.[] | select(.body | contains("<!-- agent-merge-gate -->")) | .created_at] | max // empty')
+              linked_issue=$(gh pr view "$pr_number" --repo "$REPO" --json closingIssuesReferences --jq '.closingIssuesReferences[0].number // empty' 2>/dev/null || true)
+              if [ -n "$linked_issue" ]; then
+                issue_marker=$(gh api "repos/$REPO/issues/$linked_issue/comments?per_page=100" \
+                  --jq '[.[] | select(.body | contains("<!-- agent-merge-gate -->")) | .created_at] | max // empty')
+                if [ -n "$issue_marker" ] && { [ -z "$latest_marker" ] || [ "$issue_marker" \> "$latest_marker" ]; }; then
+                  latest_marker="$issue_marker"
+                fi
+              fi
+              if [ -n "$latest_marker" ] && [ "$latest_marker" \> "$ci_finished" ]; then
+                echo "Merge gate verdict ($latest_marker) is newer than CI ($ci_finished) for PR #$pr_number, skipping"
+                continue
+              fi
+              echo "Dispatching Merge Gate for PR #$pr_number ($ci_conclusion, run $ci_run_id)"
+              gh api "repos/$REPO/actions/workflows/work-router.yml/dispatches" \
+                --method POST \
+                -f ref="$DEFAULT_BRANCH" \
+                -f "inputs[operation]=merge-gate" \
+                -f "inputs[pr-number]=$pr_number" \
+                -f "inputs[ci-conclusion]=$ci_conclusion" \
+                -f "inputs[ci-run-id]=$ci_run_id"
+            done
+
+  audit-close:
+    needs: classify
+    if: needs.classify.outputs.route == 'audit-close'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    concurrency:
+      group: audit-close
+      cancel-in-progress: false
+    permissions:
+      contents: read
+      issues: write
+    steps:
+      - name: Checkout workflow actions
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: ./.github/actions/audit-close
+        with:
+          token: ${{ github.token }}
+
+  cleanup-artifacts:
+    needs: classify
+    if: needs.classify.outputs.route == 'cleanup-artifacts' && !github.event.repository.fork
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    concurrency:
+      group: cleanup-artifacts
+      cancel-in-progress: false
+    permissions:
+      contents: read
+      actions: write
+    steps:
+      - name: Checkout workflow actions
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: ./.github/actions/cleanup-artifacts
+        with:
+          token: ${{ github.token }}
+          artifact-retention-days: ${{ vars.ARTIFACT_RETENTION_DAYS }}
+
+  validate:
+    needs: classify
+    if: needs.classify.outputs.route == 'validate'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout workflow actions
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: ./.github/actions/verify-route-matrix
+      - uses: ./.github/actions/verify-composite-actions