From bd22aa59d8d217944c663e39ed4287e31d85b791 Mon Sep 17 00:00:00 2001 From: andrew Date: Mon, 20 Jul 2026 20:07:11 -0700 Subject: [PATCH] Document gh CLI version requirement for GitHub provider gh 2.45.0 (Ubuntu 24.04) fails 'gh pr edit' with a GraphQL projectCards deprecation error, silently disabling plan/stats injection into PR bodies. Note the requirement and symptom. Co-Authored-By: Claude Fable 5 --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 877c081..b83d00b 100644 --- a/README.md +++ b/README.md @@ -511,6 +511,8 @@ Auth: `GITHUB_TOKEN` (repo read/write + issues read/write; org admin only needed **Limitations:** no attachment uploads (logs are posted as inline comment excerpts instead); status changes made by humans in field mode are discovered by polling, not webhooks (GitHub emits no event for field-value changes); api.github.com only (no Enterprise Server); `trigger.statusType` only works when `statusTypes` buckets are configured — otherwise triggers match the exact status name. If you use `teamRepos` to map issues to clone URLs, key it with the same casing as `github.repos` (lookup is case-sensitive). +**`gh` version:** use gh ≥ 2.96 (or at least newer than 2.45). Older releases — including the gh 2.45.0 shipped by Ubuntu 24.04 — fail `gh pr edit` with `GraphQL: Projects (classic) is being deprecated… (repository.pullRequest.projectCards)` on some repos, which silently disables Critters' plan/stats injection into PR bodies (logged as `Failed to update PR body with plan (non-fatal)`). Everything else still works. + ## Documentation - [Self-Hosting Guide](docs/self-hosting.md) — deployment, systemd, remote access, monitoring