Fix upgrade command documentation - clarify repository scope

[Copilot]

The upgrade command documentation incorrectly stated it "upgrades the gh-aw extension." The command only upgrades repository files (agent templates, workflows) and validates the extension version—it does not upgrade the extension itself.

Changes

• Command description: Removed misleading "upgrade the gh-aw extension" text, clarified it upgrades repository agent files and workflows
• Example comment: Changed "Upgrade extension and all workflows" → "Upgrade repository agent files and all workflows"

Context

The command checks if the extension is current (ensureLatestExtensionVersion) but prompts users to run gh extension upgrade githubnext/gh-aw separately if outdated. Documentation now matches implementation behavior in pkg/cli/upgrade_command.go.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[cli-consistency] Missing upgrade command in main CLI documentation</issue_title>
<issue_description>## Issue Description

Command: gh aw upgrade
Type: Documentation gap
Priority: Medium
Location: docs/src/content/docs/setup/cli.md

Current State

The upgrade command exists in source code (pkg/cli/upgrade_command.go) and is registered in main.go, but is not documented in the main CLI reference at docs/src/content/docs/setup/cli.md.

Command Details (from source)

Use:   "upgrade"
Short: "Upgrade repository with latest agent files and apply codemods to all workflows"
Long:  "Upgrade the repository for the latest version of agentic workflows."

Evidence

From cmd/gh-aw/main.go:

rootCmd.AddCommand(upgradeCmd)

From documentation search:

$ grep -i "upgrade" docs/src/content/docs/setup/cli.md
# Upgrade pinned version

Only mentions "upgrade" in context of upgrading the gh extension itself, not the gh aw upgrade command.

Impact

Users cannot discover the upgrade command through documentation, which is important for:

• Upgrading repository agent files to latest versions
• Applying codemods automatically to all workflows
• Maintaining compatibility with new gh-aw features

Suggested Fix

Add documentation section for the upgrade command under the Management category (after update):

#### `upgrade`

Upgrade repository with latest agent files and apply codemods to all workflows.

```bash wrap
gh aw upgrade                              # Upgrade agent files and apply codemods
gh aw upgrade --verbose                    # Upgrade with detailed output
```

**Options:** `--verbose`

This command:
- Updates repository agent files to the latest version
- Applies all available codemods to workflows
- Ensures compatibility with the latest gh-aw features

Related Commands

• update - Updates workflows from source repositories
• fix - Applies specific codemods without upgrading
• init - Initial repository setup
  Related to [cli-consistency] CLI Consistency Issues - January 2026 #11286

AI generated by CLI Consistency Checker

Comments on the Issue (you are @copilot in this section)

• Fixes [cli-consistency] Missing upgrade command in main CLI documentation #11288

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.