Skip to content

[devx] The required context is still named ADR maintainer approval after the gate stopped checking who approved — renaming needs an org-settings action first #8173

Description

@hotlong

Restart-when: any PR edits the required-context registry in scripts/check-required-contexts.mjs or the main ruleset required contexts (order: ruleset, then .github/workflows/adr-merge-approval.yml job name, then the registry + its self-test fixture)

Observation filed unassigned by the dev seat that implemented #8161 (PR #8172). Not a defect — nothing is broken today. Recording it so the stale name is a decision rather than a thing nobody noticed.

The state after #8161

Per the maintainer ruling of 2026-08-12 (「门禁改成只要求「APPROVED review 存在」」/「不要指定具体的人」), scripts/check-adr-merge-approval.mjs no longer judges WHO approved. Its check context is still published under the job name:

  adr-merge-approval:
    name: ADR maintainer approval

The word "maintainer" now over-claims: any account with review rights satisfies the gate. A reader who trusts the context name will believe a guarantee the check does not provide.

Why it was not renamed in that PR, measured

The name is not cosmetic — it is the required-status-context string, in two coupled places:

Renaming the job alone leaves the ruleset waiting for a context that never reports, which hangs the merge queue until the ruleset's 60-minute timeout — the objectui#3523 failure shape. So the rename is gated on a settings change nobody in CI can perform, and the ordering is: update the ruleset first (or add the new context alongside the old), then rename the job, then update the registry.

A comment on the job in .github/workflows/adr-merge-approval.yml records this, so the next reader does not "fix" the name in a code PR.

If it is taken up

Candidate spellings, all honest about what runs: ADR approval required, ADR review approval, ADR merge gate. Whether it is worth an org-settings round-trip is a judgement call — leaving it is defensible, since the header prose in both files now states plainly what the gate does and does not guarantee.

Related: #8161 (the ruling), #8012 (the auto-merge arming gap, open).


Generated by Claude Code

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions