Skip to content

Commit 03ac0c5

Browse files
mathvbaroneSnowboard Bot
andauthored
docs(ops): record ESLint 10 as a blocked upgrade (#70)
Adds a "Blocked upgrades" section to docs/ops/dependency-policy.md tracking the eslint 9 → 10 bump that was held back today. eslint-plugin-react@7.37.5 (latest) caps its eslint peer at ^9.7 and ESLint 10 removed the RuleContext API the plugin uses (upstream PRs jsx-eslint/eslint-plugin-react#3972 and #3979 open, no release). PR #68 was closed via @dependabot ignore this major version. A scheduled remote agent re-checks upstream monthly. Signed-off-by: Snowboard Bot <bot@example.com> Co-authored-by: Snowboard Bot <bot@example.com>
1 parent cf1dbad commit 03ac0c5

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

docs/ops/dependency-policy.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,16 @@ If a vulnerability cannot be patched (no upstream fix yet, or upstream fix carri
3434
2. Tag `@mathvbarone` for sign-off in the PR adding the exception.
3535
3. The CI security gate can be told to ignore the advisory ID via `package.json#overrides` only if the override actually neutralises the risk — never as a way to silence the gate.
3636

37+
## Blocked upgrades
38+
39+
Major-version bumps that cannot land today because a transitive plugin in our ESLint/build/test stack has not published a compatible release. We track them here so Dependabot is told to ignore the major (preventing repeated failing-CI noise) and we revisit when upstream catches up.
40+
41+
| Package | Stuck on | Blocker | Re-evaluate when | Tracking |
42+
| --- | --- | --- | --- | --- |
43+
| `eslint` | `^9.x` | `eslint-plugin-react@7.37.5` peer caps at `^9.7`; ESLint 10 also removed the `RuleContext` API the plugin uses (upstream PRs [jsx-eslint/eslint-plugin-react#3972](https://github.com/jsx-eslint/eslint-plugin-react/pull/3972), [#3979](https://github.com/jsx-eslint/eslint-plugin-react/pull/3979) open, no release). `@eslint/js` would also need a sibling bump. | `eslint-plugin-react@8` (or successor with `eslint: "^10"` peer) is published. | PR [#68](https://github.com/mathvbarone/snowboard-trip-advisor/pull/68) closed via `@dependabot ignore this major version` on 2026-05-02. Recurring agent re-checks upstream every 4 weeks. |
44+
45+
When an entry's blocker clears: remove the row, drop the corresponding `ignore` from `.github/dependabot.yml` (if one was added there as a belt-and-braces alongside the PR-comment ignore), and let Dependabot reopen the bump. The upgrade itself ships in its own PR, not bundled with unrelated changes (per atomic-PR discipline in [AGENTS.md](../../AGENTS.md)).
46+
3747
## Bot-PR DCO policy
3848

3949
The repo's required `dco` CI check (`.github/workflows/ci.yml`) rejects every commit that lacks a `Signed-off-by:` trailer. Bot accounts (Dependabot, Renovate, etc.) do not add DCO trailers by default, so bot PRs would be permanently blocked from merge.

0 commit comments

Comments
 (0)