From 75f426b1ebbad1bdba8a459858f1e2ed7e3fb18e Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 2 Jul 2026 10:31:45 +0000
Subject: [PATCH] docs(constants): add bot_constants.go to overview and
 document CopilotBotNames

Add the missing bot_constants.go file to the package file overview table
and document the CopilotBotNames exported variable that was introduced
in that file but omitted from the specification.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 pkg/constants/README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/pkg/constants/README.md b/pkg/constants/README.md
index d4f3b37e298..f273b7dcaaa 100644
--- a/pkg/constants/README.md
+++ b/pkg/constants/README.md
@@ -11,6 +11,7 @@ The package is organized into focused files:
 | File | Contents |
 |------|----------|
 | `constants.go` | Core types, formatting constants, runtime config, container images, mounts, AWF |
+| `bot_constants.go` | Canonical Copilot bot identity lists |
 | `engine_constants.go` | AI engine names, options, system secrets, model env vars, Copilot CLI commands |
 | `feature_constants.go` | Feature flag identifiers |
 | `job_constants.go` | GitHub Actions job names, step IDs, artifact names, output keys |
@@ -140,6 +141,19 @@ constants.CopilotBYOKDummyAPIKey // "dummy-byok-key-for-offline-mode" — placeh
 constants.CopilotBYOKDefaultModel // "claude-sonnet-4.6" — explicit fallback used when GH_AW_MODEL_*_COPILOT is unset
 ```
 
+### Copilot Bot Names
+
+`CopilotBotNames` (`[]string`) is the canonical list of all GitHub identifiers associated with the Copilot family — both runtime bot logins and recognised input aliases. When any entry from this list appears in a workflow's `bots:` field, it is expanded to the entire set.
+
+```go
+constants.CopilotBotNames // []string{
+                          //   "copilot-swe-agent",     // Copilot Coding Agent runtime login
+                          //   "Copilot",               // @Copilot interactive bot
+                          //   "copilot",               // base copilot bot form / canonical alias
+                          //   "@app/copilot-swe-agent", // GitHub App slug alias
+                          // }
+```
+
 ### Copilot Stem Commands
 
 `CopilotStemCommands` (`map[string]bool`) lists the shell commands (e.g. `git`, `gh`, `npm`) that the Copilot CLI is permitted to invoke. Used during security validation.