`gh pr create`: login-based reviewer requests and search-based interactive selection by BagToad · Pull Request #12627 · cli/cli

BagToad · 2026-02-06T18:00:26Z

Description

Brings the same reviewer performance improvements from gh pr edit (#12567) to gh pr create. On supported hosts (github.com), reviewers are now requested via the requestReviewsByLogin GraphQL mutation using logins/slugs directly, eliminating the expensive paginated fetch of all assignable users and teams to resolve IDs. Interactive mode gains search-based reviewer selection via MultiSelectWithSearch. GHES falls back to the existing ID-resolution path.

Additionally addresses several bugs found during acceptance testing: @copilot not resolving in gh pr create, PR author appearing in suggested reviewers, and duplicate reviewers in gh pr edit interactive mode.

fixes #11501

Key changes

Login-based reviewer requests on github.com: CreatePullRequest branches on whether userReviewerLogins/botReviewerLogins/teamReviewerSlugs are present (github.com) vs userReviewerIds/teamReviewerIds (GHES), calling RequestReviewsByLogin directly in the former case.
Bot reviewer support: Reviewers are partitioned into users, bots, and teams — mirroring pr edit's partitionReviewersByType. Bot logins (e.g. Copilot) are passed via botReviewerLogins so RequestReviewsByLogin can append the [bot] suffix correctly.
@copilot support in gh pr create: Wired CopilotReviewerReplacer into NewIssueState so --reviewer @copilot resolves to copilot-pull-request-reviewer, matching gh pr edit behavior.
SuggestedReviewerActorsForRepo: New query that fetches reviewer candidates (collaborators + org teams) for a repo without an existing PR, using a cascading quota (5 base per source, unfilled quota rolls over). Also surfaces Copilot availability by inspecting an open PR's suggestedReviewerActors. Queries viewer { login } to exclude the current user from results.
Author exclusion in SuggestedReviewerActors: Added author { login } to the PR-based query and pre-seeds the seen map so the PR author is excluded from all sources (suggestions, collaborators, teams) — not just the isAuthor-flagged suggestions.
Duplicate reviewer fix in gh pr edit: MultiSelectWithSearch for reviewers now receives DefaultLogins (keys) instead of Default (display names) so the dedup logic correctly matches pre-selected reviewers against search results.
Search-based interactive selection: When ActorIsAssignable is detected, MetadataSurvey uses MultiSelectWithSearch backed by SuggestedReviewerActorsForRepo instead of pre-fetching all reviewers into a static list. The expensive Reviewers/TeamReviewers metadata fetch is skipped entirely when the search function is available.
ActorReviewers flag on IssueMetadataState: Controls whether AddMetadataToIssueParams passes logins or resolves IDs, and skips the RepositoryAssignableUsers/OrganizationTeamList fetches when IDs aren't needed.
Extracted helper: toGitHubV4Strings deduplicates githubv4.String slice conversion with optional suffix support.
Test split: Test_createRun now uses EnabledDetectorMock (github.com path); GHES-specific tests (dry-run with all opts, org team fetching, ID-based mutations) moved to Test_createRun_GHES with DisabledDetectorMock.
Cleanup TODOs: Added // TODO requestReviewsByLoginCleanup comments at all GHES feature detection branch points for future cleanup when GHES supports requestReviewsByLogin.

Notes for reviewers

The Copilot detection in SuggestedReviewerActorsForRepo piggybacks on pullRequests(first: 1, states: [OPEN]) — it requires at least one open PR to detect Copilot availability. This is a pragmatic tradeoff; there's no repo-level API to check Copilot reviewer eligibility without a PR context.
The organization query gracefully handles personal repos by checking for the "Could not resolve to an Organization" error and continuing with partial data.
Dry-run tests with --reviewer that previously ran under the github.com path now live in Test_createRun_GHES since they test the legacy ID-resolution flow. The github.com path test ("request reviewers by login") validates the new RequestReviewsByLogin mutation directly.
The /slug team shorthand (auto-prefixing repo owner) has been removed — team reviewers must be fully qualified as org/teamname.

Acceptance testing

github.com (10 scenarios, 10/10 passed): Acceptance test results

GHES 3.20 (7 scenarios, 6/6 passed, 1 skipped): GHES acceptance test results

Bugs found and fixed during acceptance testing:

gh pr create --reviewer @copilot was not resolving @copilot to the bot login
PR author appeared as a suggested reviewer in gh pr create (viewer) and gh pr edit (author)
Duplicate reviewers appeared in gh pr edit when an existing reviewer was also in search results

Address PR review comments: code consistency and DRY improvements - Add botTypeName const for consistency with teamTypeName - Create extractTeamSlugs helper using strings.SplitN to simplify team slug extraction logic - Replace duplicate code in AddPullRequestReviews and RemovePullRequestReviews with extractTeamSlugs helper - Fix ClientMutationId naming with explicit graphql tag for consistency with other mutations in the codebase

Copilot

Pull request overview

This PR updates gh pr create to avoid expensive reviewer ID-resolution on GitHub.com by using login-based review requests, and adds search-based interactive reviewer selection to improve performance on large repos while retaining GHES compatibility.

Changes:

Add login-based reviewer requesting for gh pr create (via requestReviewsByLogin) on hosts that support it, with GHES fallback to the legacy ID-based flow.
Introduce SuggestedReviewerActorsForRepo to provide reviewer candidates for repos without an existing PR, enabling search-driven interactive selection.
Wire search-based reviewer selection into MetadataSurvey and thread through new state/params (ActorReviewers) to control whether IDs need resolving.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
pkg/cmd/pr/shared/survey_test.go	Updates `MetadataSurvey` call sites for the new `reviewerSearchFunc` parameter.
pkg/cmd/pr/shared/survey.go	Adds optional `MultiSelectWithSearch` path for reviewer selection in metadata survey.
pkg/cmd/pr/shared/state.go	Adds `ActorReviewers` flag to control login-vs-ID reviewer behavior.
pkg/cmd/pr/shared/params.go	Skips reviewer ID resolution when `ActorReviewers` is enabled; passes logins/slugs into params.
pkg/cmd/pr/create/create_test.go	Splits GitHub.com vs GHES behaviors and updates reviewer-request mutation expectations.
pkg/cmd/pr/create/create.go	Detects feature support, enables search-based reviewer selection, and sets `ActorReviewers`.
pkg/cmd/issue/create/create.go	Updates `MetadataSurvey` call signature (passes `nil` search func).
api/queries_pr_test.go	Adds unit tests for the new `SuggestedReviewerActorsForRepo` query behavior.
api/queries_pr.go	Uses `RequestReviewsByLogin` during PR creation when login-based params are present; adds `SuggestedReviewerActorsForRepo`.

Comments suppressed due to low confidence (1)

pkg/cmd/pr/shared/survey.go:269

MultiSelectWithSearch introduces a new reviewers-selection branch, but there’s no test coverage asserting that it’s invoked and that the returned keys correctly populate state.Reviewers (especially for teams and bots). Adding a focused unit test for the reviewerSearchFunc != nil path would help prevent regressions.

		if reviewerSearchFunc != nil {
			// Use search-based selection (github.com with ActorIsAssignable)
			selectedReviewers, err := p.MultiSelectWithSearch(
				"Reviewers",
				"Search reviewers",
				state.Reviewers,
				[]string{},
				reviewerSearchFunc)
			if err != nil {
				return err
			}
			values.Reviewers = selectedReviewers
		} else if len(reviewers) > 0 {

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

pkg/cmd/pr/create/create_test.go

pkg/cmd/pr/shared/survey.go

pkg/cmd/pr/shared/params.go

api/queries_pr.go

pkg/cmd/pr/create/create.go

pkg/cmd/pr/shared/survey.go

pkg/cmd/pr/shared/params.go

pkg/cmd/pr/create/create.go

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Consolidate all review-related types, methods, and functions into queries_pr_review.go for better code organization. The file is now ordered by logical sections: review data types, review status, review requests, reviewer candidates, API operations, and helpers. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

api/queries_pr.go

api/queries_pr_review.go

pkg/cmd/pr/shared/survey.go

pkg/cmd/pr/shared/params.go

babakks

LGTM! @BagToad and I reviewed this in sync.

Add a cleanup TODO comment above the GHES feature detection branch in CreatePullRequest so we can track removing the ID-based reviewer request path once GHES supports requestReviewsByLogin. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Mark the piggyback-on-open-PR technique for detecting Copilot reviewer availability as a HACK, since there is no repo-level API to check Copilot eligibility without a PR context. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Gate search-based reviewer selection on both state.ActorReviewers and the search function being available, consistent with the ActorAssignees pattern used for assignees. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Mark the legacy static MultiSelect reviewer path for cleanup once GHES supports requestReviewsByLogin and search-based selection can be used universally. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Team reviewers must be provided as fully qualified org/teamname. Remove the /slug shorthand that auto-prefixed the repo owner, as this format is not supported. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Mark the GHES ID-resolution branch in AddMetadataToIssueParams for cleanup once GHES supports requestReviewsByLogin. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Wire CopilotReviewerReplacer into NewIssueState so that `gh pr create --reviewer @copilot` correctly resolves to the copilot-pull-request-reviewer bot login, matching the behavior already implemented in gh pr edit. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Query the viewer login in SuggestedReviewerActorsForRepo and pre-seed the seen map so the current user is filtered out of collaborator results. You cannot review your own PR. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Use DefaultLogins instead of Default display names when calling MultiSelectWithSearch for reviewers. The dedup logic in the prompter compares keys (logins) against defaults, so passing display names like 'mxie (Melissa Xie)' prevented deduplication against search result keys like 'mxie'. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add author { login } to the SuggestedReviewerActors GraphQL query and pre-seed the seen map with the author login so they are excluded from all sources (suggestions, collaborators, teams). Previously the author was only skipped via the isAuthor flag in the suggestions loop but could still appear as a collaborator. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Replace the top-level organization(login: $owner) query with repository.owner { ... on Organization { teams } }. This uses GraphQL inline fragments to conditionally fetch team data only when the repo owner is an Organization, eliminating the need to handle 'Could not resolve to an Organization' errors for personal repos. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

This MR contains the following updates: | Package | Update | Change | |---|---|---| | [cli/cli](https://github.com/cli/cli) | minor | `v2.87.3` → `v2.88.1` | MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot). **Proposed changes to behavior should be submitted there as MRs.** --- ### Release Notes <details> <summary>cli/cli (cli/cli)</summary> ### [`v2.88.1`](https://github.com/cli/cli/releases/tag/v2.88.1): GitHub CLI 2.88.1 [Compare Source](cli/cli@v2.88.0...v2.88.1) #### Fix `pr` commands failing with `read:project` scope error v2.88.0 introduced a regression where `pr` commands would fail with the error: ``` error: your authentication token is missing required scopes [read:project] To request it, run: gh auth refresh -s read:project ``` Previously, missing read:project scope was gracefully handled, and project data was silently skipped. A change inadvertently broke the error matching that enabled this graceful degradation. v2.88.1 reverts these changes so that `pr` commands work correctly without requiring the `read:project` scope. #### What's Changed - Migrate Windows code signing from client secret to OIDC by [@BagToad](https://github.com/BagToad) in [#12911](cli/cli#12911) - Revert "refactor: deduplicate scope error handling between api/client.go and project queries" by [@williammartin](https://github.com/williammartin) in [#12914](cli/cli#12914) - Revert "fix: clarify scope error while creating issues for projects" by [@williammartin](https://github.com/williammartin) in [#12915](cli/cli#12915) **Full Changelog**: <cli/cli@v2.88.0...v2.88.1> ### [`v2.88.0`](https://github.com/cli/cli/releases/tag/v2.88.0): GitHub CLI 2.88.0 [Compare Source](cli/cli@v2.87.3...v2.88.0) ####

Request Copilot Code Review from `gh` <img width="80%" height="80%" alt="image" src="https://github.com/user-attachments/assets/c9b86700-5934-44b6-9210-227495a18d8e" /> `gh pr create` and `gh pr edit` now support [Copilot Code Review](https://docs.github.com/en/copilot/using-github-copilot/code-review/using-copilot-code-review) as a reviewer. Request a review with `--add-reviewer @copilot`, or select Copilot interactively from the searchable reviewer prompt. Create a pull request and request review from Copilot: ``` gh pr create --reviewer @copilot ``` Edit a pull request and request review from Copilot: ``` gh pr edit --add-reviewer @copilot ``` #### Close issues as duplicates with `gh issue close --duplicate-of` You can now close issues as duplicates and link to a duplicate issue directly from the CLI. The new `--duplicate-of` flag accepts an issue number or URL and marks the closed issue as a duplicate of the referenced one. You can also use `--reason duplicate` to set the close reason without linking a specific issue. ``` # Close as duplicate, linking to the original issue gh issue close 123 --duplicate-of 456 # Close with duplicate reason only gh issue close 123 --reason duplicate ``` #### JSON support for `gh agent-task` `gh agent-task list` and `gh agent-task view` now support `--json`, `--jq`, and `--template` flags, consistent with other `gh` commands. ``` gh agent-task list --json id,name,state gh agent-task view <id> --json state --jq '.state' ``` #### What's Changed ##### ✨ Features - `gh pr create`: login-based reviewer requests and search-based interactive selection by [@BagToad](https://github.com/BagToad) in [#12627](cli/cli#12627) - `gh pr view` and `gh issue view`: show friendly display names for all actors by [@BagToad](https://github.com/BagToad) in [#12854](cli/cli#12854) - `gh issue close`: add `--duplicate-of` flag and duplicate reason by [@tksohishi](https://github.com/tksohishi) in [#12811](cli/cli#12811) - `gh pr diff`: add `--exclude` flag to filter files from diff output by [@yuvrajangadsingh](https://github.com/yuvrajangadsingh) in [#12655](cli/cli#12655) - `gh pr view/list`: add `changeType` field to files JSON output by [@yuvrajangadsingh](https://github.com/yuvrajangadsingh) in [#12657](cli/cli#12657) - `gh repo clone`: add `--no-upstream` flag by [@4RH1T3CT0R7](https://github.com/4RH1T3CT0R7) in [#12686](cli/cli#12686) - `gh repo edit`: add `--squash-merge-commit-message` flag by [@yuvrajangadsingh](https://github.com/yuvrajangadsingh) in [#12846](cli/cli#12846) - `gh browse`: add `--blame` flag by [@masonmcelvain](https://github.com/masonmcelvain) in [#11486](cli/cli#11486) - `gh agent-task list`: add `--json` support by [@maxbeizer](https://github.com/maxbeizer) in [#12806](cli/cli#12806) - `gh agent-task view`: add `--json` support by [@maxbeizer](https://github.com/maxbeizer) in [#12807](cli/cli#12807) - `gh copilot`: set `COPILOT_GH` env var when launching Copilot CLI by [@devm33](https://github.com/devm33) in [#12821](cli/cli#12821) ##### 🐛 Fixes - Fix `gh project item-edit` error when editing Draft Issue with only one (`--title`/`--body`) flag by [@ManManavadaria](https://github.com/ManManavadaria) in [#12787](cli/cli#12787) - Fix extension install error message showing raw struct instead of `owner/repo` by [@Copilot](https://github.com/Copilot) in [#12836](cli/cli#12836) - Fix incorrect integer conversion from int to uint16 in port forwarder by [@BagToad](https://github.com/BagToad) in [#12831](cli/cli#12831) - Fix invalid ANSI SGR escape code in JSON and diff colorization by [@BagToad](https://github.com/BagToad) in [#12720](cli/cli#12720) - Fix assignees `databaseId` always being `0` in `--json` output by [@srt32](https://github.com/srt32) in [#12783](cli/cli#12783) - Fix error when `--remote` flag used with repo argument by [@majiayu000](https://github.com/majiayu000) in [#12375](cli/cli#12375) - Fix redundant API call in `gh issue view --comments` by [@VishnuVV27](https://github.com/VishnuVV27) in [#12652](cli/cli#12652) - Clarify scope error while creating issues for projects by [@elijahthis](https://github.com/elijahthis) in [#12596](cli/cli#12596) - Reject pull request-only search qualifiers in `gh issue list` by [@LouisLau-art](https://github.com/LouisLau-art) in [#12623](cli/cli#12623) - Prevent `.git/config` corruption on repeated `issue develop --name` invocation by [@gunadhya](https://github.com/gunadhya) in [#12651](cli/cli#12651) - Use pre-compiled regexp for matching Content-Type by [@itchyny](https://github.com/itchyny) in [#12781](cli/cli#12781) - Isolate generated licenses per platform (os/arch) by [@babakks](https://github.com/babakks) in [#12774](cli/cli#12774) ##### 📚 Docs & Chores - Add examples to `gh issue close` help text by [@BagToad](https://github.com/BagToad) in [#12830](cli/cli#12830) - Customizable install `prefix` in Makefile by [@scarf005](https://github.com/scarf005) in [#11714](cli/cli#11714) - Deduplicate scope error handling between `api/client.go` and project queries by [@yuvrajangadsingh](https://github.com/yuvrajangadsingh) in [#12845](cli/cli#12845) - Remove unnecessary `StateReason` and `StateReasonDuplicate` feature detection by [@BagToad](https://github.com/BagToad) in [#12838](cli/cli#12838) - Update Go version requirement to 1.26+ by [@BagToad](https://github.com/BagToad) in [#12864](cli/cli#12864) - Add monthly pitch surfacing workflow by [@tidy-dev](https://github.com/tidy-dev) in [#12894](cli/cli#12894) #####

Dependencies - Bump Go from 1.25.7 to 1.26.1 by [@BagToad](https://github.com/BagToad) in [#12860](cli/cli#12860) - chore(deps): bump golang.org/x/sync from 0.19.0 to 0.20.0 by [@dependabot](https://github.com/dependabot)\[bot] in [#12886](cli/cli#12886) - chore(deps): bump google.golang.org/grpc from 1.79.1 to 1.79.2 by [@dependabot](https://github.com/dependabot)\[bot] in [#12851](cli/cli#12851) - chore(deps): bump github.com/docker/cli from 29.0.3+incompatible to 29.2.0+incompatible by [@dependabot](https://github.com/dependabot)\[bot] in [#12842](cli/cli#12842) - chore(deps): bump google.golang.org/grpc from 1.78.0 to 1.79.1 by [@dependabot](https://github.com/dependabot)\[bot] in [#12759](cli/cli#12759) - chore(deps): bump goreleaser/goreleaser-action from 6.4.0 to 7.0.0 by [@dependabot](https://github.com/dependabot)\[bot] in [#12760](cli/cli#12760) - chore(deps): bump actions/upload-artifact from 6 to 7 by [@dependabot](https://github.com/dependabot)\[bot] in [#12797](cli/cli#12797) - chore(deps): bump actions/download-artifact from 7 to 8 by [@dependabot](https://github.com/dependabot)\[bot] in [#12796](cli/cli#12796) - chore(deps): bump actions/attest-build-provenance from 3.2.0 to 4.1.0 by [@dependabot](https://github.com/dependabot)\[bot] in [#12795](cli/cli#12795) - chore(deps): bump github.com/gabriel-vasile/mimetype from 1.4.11 to 1.4.13 by [@dependabot](https://github.com/dependabot)\[bot] in [#12615](cli/cli#12615) #### New Contributors - [@srt32](https://github.com/srt32) made their first contribution in [#12783](cli/cli#12783) - [@itchyny](https://github.com/itchyny) made their first contribution in [#12781](cli/cli#12781) - [@VishnuVV27](https://github.com/VishnuVV27) made their first contribution in [#12652](cli/cli#12652) - [@elijahthis](https://github.com/elijahthis) made their first contribution in [#12596](cli/cli#12596) - [@ManManavadaria](https://github.com/ManManavadaria) made their first contribution in [#12787](cli/cli#12787) - [@maxbeizer](https://github.com/maxbeizer) made their first contribution in [#12806](cli/cli#12806) - [@LouisLau-art](https://github.com/LouisLau-art) made their first contribution in [#12623](cli/cli#12623) - [@4RH1T3CT0R7](https://github.com/4RH1T3CT0R7) made their first contribution in [#12686](cli/cli#12686) - [@yuvrajangadsingh](https://github.com/yuvrajangadsingh) made their first contribution in [#12657](cli/cli#12657) - [@masonmcelvain](https://github.com/masonmcelvain) made their first contribution in [#11486](cli/cli#11486) - [@scarf005](https://github.com/scarf005) made their first contribution in [#11714](cli/cli#11714) - [@tksohishi](https://github.com/tksohishi) made their first contribution in [#12811](cli/cli#12811) - [@tidy-dev](https://github.com/tidy-dev) made their first contribution in [#12894](cli/cli#12894) **Full Changelog**: <cli/cli@v2.87.3...v2.88.0> </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this MR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this MR, check this box --- This MR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).

BagToad added 3 commits February 4, 2026 14:56

gh pr create: CCR and multiselectwithsearch

9904f7d

Add toGitHubV4Strings helper to reduce code duplication

78aaa87

BagToad temporarily deployed to cli-automation February 6, 2026 18:00 — with GitHub Actions Inactive

Merge branch 'trunk' into kw/pr-create-multi-select-with-search-ccr

8456963

BagToad changed the title ~~gh pr create: login-based reviewer requests and search-based interactive selection~~ gh pr create: login-based reviewer requests and search-based interactive selection Feb 6, 2026

Merge branch 'trunk' into kw/pr-create-multi-select-with-search-ccr

6d9cac6

BagToad marked this pull request as ready for review February 10, 2026 17:37

BagToad requested a review from a team as a code owner February 10, 2026 17:37

BagToad requested review from babakks and Copilot February 10, 2026 17:37

BagToad temporarily deployed to cli-automation February 10, 2026 17:37 — with GitHub Actions Inactive

cliAutomation assigned BagToad Feb 10, 2026

Merge branch 'trunk' into kw/pr-create-multi-select-with-search-ccr

c187b88

Copilot started reviewing on behalf of BagToad February 10, 2026 17:37 View session

Copilot AI reviewed Feb 10, 2026

View reviewed changes

BagToad commented Feb 10, 2026

View reviewed changes

pkg/cmd/pr/shared/survey.go Outdated Show resolved Hide resolved

pkg/cmd/pr/shared/params.go Outdated Show resolved Hide resolved

pkg/cmd/pr/create/create.go Outdated Show resolved Hide resolved

pkg/cmd/pr/create/create.go Outdated Show resolved Hide resolved

BagToad and others added 13 commits February 10, 2026 10:53

Remove redundant comments

620261f

Don't swallow error from FD

dd9ab71

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Remove redundant comment

7373de3

Apply suggestion from @BagToad

cf08f4d

Preserve org/slug format for team reviewer slugs

db167d3

Partition bot reviewers separately for RequestReviewsByLogin

1209b24

Wire bot reviewer logins through CreatePullRequest

ad64d10

Update test assertions to expect org/slug team format

3866164

Skip reviewer metadata fetch when using search-based selection

e361335

Include bot logins in login-based reviewer mutation guard

a8655bc

Normalize /slug team shorthand to org/slug and fix docs

1cb7763

Use org/slug format in test fixtures and remove /slug normalization

1d73095

Clarify ReviewerCandidate relationship to AssignableActor

ceb9044

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>