Skip to content

docs(infra): CI check-name convention + no-op edited-run suppression (RIG-2791) - #663

Open
rigel-mintaka wants to merge 1 commit into
mainfrom
compass-repo/rig-2791-ci-check-naming
Open

docs(infra): CI check-name convention + no-op edited-run suppression (RIG-2791)#663
rigel-mintaka wants to merge 1 commit into
mainfrom
compass-repo/rig-2791-ci-check-naming

Conversation

@rigel-mintaka

Copy link
Copy Markdown
Contributor

Design record for RIG-2791, ruling Matt's two-part ask on PR #591:

  • A (ruled A1): a slash-namespaced kebab check-name convention — every ci.yml
    gate job renames to ci / <job>; the required CI rollup stays CI so
    ruleset 20090117 is untouched; sibling single-job workflows take the bare
    kebab stem. Absorbs RIG-2739 (dogfood-e2e -> e2e).
  • B (goal ruled B1; mechanism open): suppress the no-op pull_request.edited
    phantom run jj-vine fires on every PR. A triggered run cannot post zero
    contexts, so edited must leave ci.yml's types: behind a dedicated
    guard workflow. The re-trigger mechanism is the one load-bearing Open
    Question (OQ1) — dispatch-mode recommended after a red-team surfaced two
    blockers in the label-bounce path (the GITHUB_TOKEN no-trigger rule; and
    Renovate labelling every dependency PR).

Diagnosis grounded in #591's check-runs: affected detection is NOT broken —
the real run ran the full TS battery green. The phantom is the second,
self-skipped edited run double-listing contexts (incl. a raw
Moon battery (${{ matrix.group }}) and a skipped CI), a cosmetic
artifact today with a latent skipped-required-as-passing false-green.

Ledger-impact: adds DL-264 (naming convention) and DL-265 (edited-run
suppression) under a new ## Infrastructure & CI section.

Co-authored-by: Matt Wilkinson matt@rigel.build

@linear-code

linear-code Bot commented Aug 27, 2026

Copy link
Copy Markdown

RIG-2791

…(RIG-2791)

Design record for RIG-2791, ruling Matt's two-part ask on PR #591:

- A (ruled A1): a slash-namespaced kebab check-name convention — every ci.yml
  gate job renames to `ci / <job>`; the required `CI` rollup stays `CI` so
  ruleset 20090117 is untouched; sibling single-job workflows take the bare
  kebab stem. Absorbs RIG-2739 (dogfood-e2e -> e2e).
- B (goal ruled B1; mechanism open): suppress the no-op `pull_request.edited`
  phantom run jj-vine fires on every PR. A triggered run cannot post zero
  contexts, so `edited` must leave ci.yml's `types:` behind a dedicated
  guard workflow. The re-trigger mechanism is the one load-bearing Open
  Question (OQ1) — dispatch-mode recommended after a red-team surfaced two
  blockers in the label-bounce path (the GITHUB_TOKEN no-trigger rule; and
  Renovate labelling every dependency PR).

Diagnosis grounded in #591's check-runs: affected detection is NOT broken —
the real run ran the full TS battery green. The phantom is the second,
self-skipped `edited` run double-listing contexts (incl. a raw
`Moon battery (${{ matrix.group }})` and a `skipped` `CI`), a cosmetic
artifact today with a latent skipped-required-as-passing false-green.

Ledger-impact: adds DL-269 (naming convention) and DL-270 (edited-run
suppression) under a new `## Infrastructure & CI` section. Ids are
provisional against concurrent ledger appends; reconciled at merge.

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@rigel-mintaka
rigel-mintaka force-pushed the compass-repo/rig-2791-ci-check-naming branch from b79542f to dff5f4b Compare August 27, 2026 02:33
@github-actions

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-repo-rig-2791-ci-che.compass-eng-docs.pages.dev

Deployed from compass-repo/rig-2791-ci-check-naming at dff5f4b.

Changed pages:

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant