# Safety net OPS18: when a PR merges to main with `Related #N`, promote Issues # that are still awaiting their intention plan (`blocked` + docs/plans/ link) # to `ready`. Idempotent with `pnpm agent:ready` (agent happy path). OPS76: # the PR and the issues live on GitHub — the job passes the PR body via PR_BODY # and scripts/agent-promote-related-on-merge.mjs flips labels on the GitHub API # (repo GITHUB_TOKEN, `issues: write`). # # Does NOT run on open PRs — only after merge — so the claim race stays closed. # Job is gated on Related # in the body so non-plan merges skip checkout/Node. # Fork guard: on a merged fork PR the checkout pulls the fork's own script, # which would run with the repo PAT (RCE — same class as # agent-pr-ready-automerge.yml). # # OPS71-FLIP: `workflow_dispatch` is the MANUAL recovery path — the `closed` # event does NOT create a run when the merge was performed by # github-actions[bot] (auto-merge armed with the built-in GITHUB_TOKEN; # GitHub's anti-recursion, live finding PR #746). Dispatch with the PR number: # the job fetches the PR via `gh` (same contract: merged + base main + # same-repo) and runs the same promotion. name: Promote plan-issue Related on main merge on: pull_request: types: [closed] branches: [main] workflow_dispatch: inputs: pr: description: 'PR number (manual recovery when the closed event did not create a run)' required: true type: number permissions: contents: read pull-requests: read issues: write jobs: plan-issue-ready: if: >- (github.event_name == 'pull_request' && github.event.pull_request.merged == true && github.event.pull_request.head.repo.full_name == github.repository && (contains(github.event.pull_request.body, 'Related #') || contains(github.event.pull_request.body, 'related #') || contains(github.event.pull_request.body, 'RELATED #'))) || (github.event_name == 'workflow_dispatch' && inputs.pr != '') runs-on: ubuntu-latest timeout-minutes: 5 env: # The github-api.mjs client reads GITHUB_TOKEN; the built-in token has # `issues: write` scoped to this repo (the tracker is on GitHub). GH_TOKEN: ${{ github.token }} steps: - uses: actions/checkout@v5 # Script is plain Node (stdlib) — no pnpm. Disable # package-manager-cache: setup-node@v5 defaults to true and looks for # pnpm (packageManager in package.json) before pnpm/action-setup. - uses: actions/setup-node@v5 with: node-version: 24 package-manager-cache: false - name: Fetch PR metadata (manual recovery — bot auto-merges skip the closed event) if: github.event_name == 'workflow_dispatch' id: pr run: | PR="${{ inputs.pr }}" STATE="$(gh pr view "$PR" --json state -q .state)" if [ "$STATE" != "MERGED" ]; then echo "PR #$PR não mergeada (state=$STATE) — skip" exit 0 fi BASE="$(gh pr view "$PR" --json baseRefName -q .baseRefName)" REPO="$(gh pr view "$PR" --json headRepository -q .headRepository.nameWithOwner)" if [ "$BASE" != "main" ] || [ "$REPO" != "${{ github.repository }}" ]; then echo "PR #$PR fora do contrato (base=$BASE repo=$REPO — precisa main + same-repo) — skip" exit 0 fi BODY="$(gh pr view "$PR" --json body -q .body)" { echo "valid=true" echo "pr_number=$PR" echo "pr_body<> "$GITHUB_OUTPUT" - name: Promote Related #N awaiting plan → ready if: steps.pr.outputs.valid == 'true' || github.event_name == 'pull_request' env: PR_BODY: ${{ steps.pr.outputs.pr_body || github.event.pull_request.body }} run: node scripts/agent-promote-related-on-merge.mjs --pr "${{ steps.pr.outputs.pr_number || github.event.pull_request.number }}"