v1.226.0-rc.1

feat(toolchain): support Aqua `github_archive` package type Erik Osterman (Cloud Posse) (@osterman) (#2416)

## what

• Add github_archive package type to the Aqua-compatible toolchain registry parser and installer.
• Resolve downloads to https://github.com/{owner}/{repo}/archive/refs/tags/{version}.tar.gz, matching upstream aquaproj/aqua semantics.
• Hardcode tar.gz (mirroring aqua's GetFormat()); asset, url, format, and format_overrides are intentionally ignored for this type.
• Extend resetByPkgType so version overrides that switch a tool to github_archive clear stale asset/url.
• Add unit + registry-parsing tests plus a fixture modeled on the adr-tools example; cover validation, version-prefix handling, format-ignored semantics, URL pattern, and {{trimV .Version}}/path template idiom.
• Add changelog blog post and a shipped milestone under the Extensibility initiative on the roadmap.

why

• Aqua's upstream registry uses github_archive for tools shipped as repository source archives (e.g., adr-tools, tfenv, tgswitch, and many single-script projects). Without this type, those entries failed with unsupported tool type: github_archive.
• Adding parity with aqua unblocks all such registry entries with no user-side changes — pull the upstream definition as-is and it just works.

references

• Aqua source: https://github.com/aquaproj/aqua/blob/main/pkg/download/github_archive.go
• Aqua docs: https://aquaproj.github.io/docs/reference/registry-config/github-archive-package/

Summary by CodeRabbit

• New Features

  • Added support for Aqua’s github_archive packages, downloading GitHub tag archives.
  • Added support for github_content packages, downloading individual repository files.
  • Added validation for repository details and safe relative paths.
  • Added support for nested paths, version-specific overrides, and archive-root templates.

• Bug Fixes

  • Improved reliability when acquiring shared file locks.

• Documentation

  • Updated toolchain documentation, roadmap entries, and blog content with configuration guidance and supported package types.