Add setup-cli action for installing gh-aw CLI by release tag

[Copilot]

Adds actions/setup-cli to install gh-aw CLI extension by release tag with fallback installation strategies and checksum verification.

New Action

actions/setup-cli/

• Mandatory version input: accepts release tags (e.g., v0.37.18)
• Installation strategy: attempts gh extension install first, falls back to direct binary download
• SHA256 checksum verification: Validates downloaded binaries for security
• Outputs: installed-version for workflow consumption

- uses: githubnext/gh-aw/actions/setup-cli@v0.37.18
  with:
    version: v0.37.18

Enhanced install-gh-aw.sh

Added capabilities while maintaining backward compatibility:

• INPUT_VERSION: reads version from environment for GitHub Actions integration
• --gh-install: flag to enable gh extension install attempt
• Release validation via GitHub API before installation
• Checksum validation: Enabled automatically in GitHub Actions context (SKIP_CHECKSUM=false when INPUT_VERSION is set)
• GITHUB_OUTPUT: writes installed_version for action outputs

Build Integration

Makefile

• New sync-action-scripts target copies install-gh-aw.sh → actions/setup-cli/install.sh
• Runs automatically during make build
• Marks actions/setup-cli/install.sh as linguist-generated=true in .gitattributes

Copilot Setup Integration

Action Mode Support for copilot-setup-steps.yml

• Modified pkg/cli/copilot_setup.go to generate different YAML based on action mode:
  • Release mode: Uses githubnext/gh-aw/actions/setup-cli@{version} with dynamic version from GetVersion()
  • Dev mode: Uses curl to download install-gh-aw.sh (backward compatible)
• Updated ensureCopilotSetupSteps() to accept action mode and version parameters
• Enhanced injectExtensionInstallStep() to inject appropriate steps for each mode with dynamic versioning
• Supports updating existing .yml files with new action syntax
• Dynamic versioning: Both action reference tag and version parameter use GetVersion() in release mode

Example outputs:

Release mode (using GetVersion() = "v1.2.3"):

- uses: githubnext/gh-aw/actions/setup-cli@v1.2.3
  with:
    version: v1.2.3

Dev mode:

- run: curl -fsSL https://raw.githubusercontent.com/githubnext/gh-aw/refs/heads/main/install-gh-aw.sh | bash

Testing

• Shell script tests: 6 validation tests in actions/setup-cli/install_test.sh
• Integration test: Added pkg/cli/setup_cli_action_integration_test.go with 8 test cases covering script syntax, INPUT_VERSION support, gh extension install logic, release validation, checksum enablement, and sync verification
• Copilot setup tests: 15 comprehensive tests covering:
  • File creation (release/dev modes)
  • File updates (release/dev modes)
  • Skip logic when install already exists
  • Step injection with dynamic versioning
  • All create/update scenarios
• Total: 29 tests, all passing ✅

Original prompt

Create a new action folder actions/setup-cli that installs the gh-aw extension for a given version (tag). The version field is mandatory and must be a release tag or a long sha that can be resolved back to a release

• install.sh should support long sha as well
• validates release still exists
• attempts to install using "gh extensions install ..." if failing uses install.sh to do the download

the build should copy install.sh in the action folder, mark as git attribute generated

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[pelikhan]

@copilot do not support long sha, only releases tags

[pelikhan]

@copilot the install.sh script should do a checksum validation

[pelikhan]

@copilot add integration test

[Copilot]

@copilot do not support long sha, only releases tags

Removed SHA support. The action now only accepts release tags. Commit: 3fef50e

[Copilot]

@copilot the install.sh script should do a checksum validation

Enabled checksum validation for GitHub Actions context. When INPUT_VERSION is set, SKIP_CHECKSUM is now set to false. Commit: 46995e9

@copilot add integration test

Added integration test in pkg/cli/setup_cli_action_integration_test.go with 8 test cases covering script syntax, INPUT_VERSION support, gh extension install logic, release validation, checksum enablement, and sync verification. All tests passing. Commit: 46995e9

[pelikhan]

Use the current action mode to decide how to generate the steps in the copilot setup step .yml file. In release mode, it should use the new GitHub action.

Update the copilot step setup configuration code to support updating an existing .yml file with the new step syntax.

[pelikhan]

@copilot Use the current action mode to decide how to generate the steps in the copilot setup step .yml file. In release mode, it should use the new GitHub action.

Update the copilot step setup configuration code to support updating an existing .yml file with the new step syntax.

[Copilot]

@copilot Use the current action mode to decide how to generate the steps in the copilot setup step .yml file. In release mode, it should use the new GitHub action.

Update the copilot step setup confi...

Implemented action mode support. In release mode, copilot-setup-steps.yml now uses githubnext/gh-aw/actions/setup-cli@main with checkout step. In dev mode, it uses the curl method. Updated ensureCopilotSetupSteps() and injectExtensionInstallStep() to accept action mode parameter. Added tests for both modes. Commit: 8efae96

[pelikhan]

@copilot the copilot template should use the release tag for the action and the version . See release tag constant

[Copilot]

@copilot the copilot template should use the release tag for the action and the version . See release tag constant

Updated to use GetVersion() dynamically for both the action reference tag and version parameter. In release mode, generates githubnext/gh-aw/actions/setup-cli@{version} with version: {version}. In dev mode, uses @main. Commit: efe9402

[pelikhan]

@copilot add tests for create/update copilot step file tests.

[Copilot]

@copilot add tests for create/update copilot step file tests.

Added 8 new comprehensive test cases for create/update scenarios:

• TestEnsureCopilotSetupSteps_CreateWithReleaseMode - creates new file with release mode
• TestEnsureCopilotSetupSteps_CreateWithDevMode - creates new file with dev mode
• TestEnsureCopilotSetupSteps_UpdateExistingWithReleaseMode - updates existing file to release mode
• TestEnsureCopilotSetupSteps_UpdateExistingWithDevMode - updates existing file to dev mode
• TestEnsureCopilotSetupSteps_SkipsUpdateWhenActionExists - verifies no update when action already exists
• TestEnsureCopilotSetupSteps_SkipsUpdateWhenCurlExists - verifies no update when curl install exists
• TestInjectExtensionInstallStep_ReleaseMode - tests injection with release mode and dynamic version
• TestInjectExtensionInstallStep_DevMode - tests injection with dev mode

Total: 15 copilot setup tests, all passing. Commit: f7c885c