Skip to content

copilot-instructions: repo-wide bot-node-id fallback for headless cold start - #295

Merged
ptr727 merged 4 commits into
developfrom
copilot-instructions-headless-botid-bootstrap
Jul 14, 2026
Merged

copilot-instructions: repo-wide bot-node-id fallback for headless cold start#295
ptr727 merged 4 commits into
developfrom
copilot-instructions-headless-botid-bootstrap

Conversation

@ptr727

@ptr727 ptr727 commented Jul 14, 2026

Copy link
Copy Markdown
Owner

Closes #294.

Problem

The headless Copilot-review loop needs the Copilot reviewer's bot node id to drive round 1 via the requestReviews mutation. On a cold-start PR - freshly opened, auto-review-on-open not yet landed, so no formal review and no issue comment on the PR yet - the runbook's only documented source for that id was manual UI seeding, which defeats a headless/cron run. Surfaced running the loop fully headless on ptr727/HomeAssistant-Config PR #7.

Fix

The Copilot reviewer's bot node id is the reviewer bot account's node id and is stable repo-wide. Verified empirically - identical across every recent PR in two repos:

HomeAssistant-Config -> BOT_kgDOCnlnWA
ProjectTemplate      -> BOT_kgDOCnlnWA

So document reading the id from any prior Copilot review anywhere in the repo as the preferred cold-start fallback (a pullRequests(last:20) GraphQL query), positioned before UI seeding. UI seeding drops to a true last resort: only a repo that has never had a Copilot review at all, where no prior id exists to read.

Doc-only change to .github/copilot-instructions.md; the requestReviews mutation itself is unchanged. markdownlint + cspell clean.

🤖 Generated with Claude Code

…d start (#294)

On a freshly opened PR with no formal review and no issue comment yet,
the only documented way to obtain the Copilot reviewer's bot node id was
manual UI seeding, which defeats a headless/cron review loop.

The reviewer's bot node id is the bot account's node id and is stable
repo-wide (verified: identical across every PR in HomeAssistant-Config
and ProjectTemplate). Document reading it from any prior Copilot review
in the repo as the preferred cold-start fallback, before UI seeding.
UI seeding drops to a true last resort: only a repo that has never had a
Copilot review at all.

Filed from ptr727/HomeAssistant-Config PR #7 headless run.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 14, 2026 02:42

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Copilot PR review runbook to support fully headless “cold start” operation by documenting a repo-wide fallback method to obtain the Copilot reviewer bot node id before a new PR has any Copilot activity.

Changes:

  • Adds guidance for cold-start bootstrapping of the Copilot reviewer bot node id using a repo-wide GraphQL query.
  • Reorders/clarifies fallback options (repo-wide lookup, PR issue-comment author, UI seeding as last resort).

Comment thread .github/copilot-instructions.md
Comment thread .github/copilot-instructions.md Outdated
Comment thread .github/copilot-instructions.md Outdated
…rg/global claim

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 14, 2026 02:59

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread .github/copilot-instructions.md Outdated
Comment thread .github/copilot-instructions.md Outdated
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 14, 2026 03:02

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread .github/copilot-instructions.md
Comment thread .github/copilot-instructions.md Outdated
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 14, 2026 03:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

@ptr727
ptr727 merged commit 9646f39 into develop Jul 14, 2026
7 checks passed
@ptr727
ptr727 deleted the copilot-instructions-headless-botid-bootstrap branch July 14, 2026 03:09
ptr727 added a commit that referenced this pull request Jul 14, 2026
)

Promotes the current `develop` snapshot to `main`.

## Changes

- **copilot-instructions: repo-wide bot-node-id fallback for headless
cold start (#295)** - documents reading the Copilot reviewer's bot node
id from any prior Copilot review repo-wide (`pullRequests(first: 20,
orderBy: { field: CREATED_AT, direction: DESC })`) as the preferred
cold-start fallback, before UI seeding. Closes #294.

Doc-only; `.github/copilot-instructions.md`. Already reviewed clean by
Copilot and merged to `develop`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
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.

2 participants