Why
Public docs should eventually use go install github.com/akua-dev/cli/cmd/cnap@latest, but the akua-dev/cli repository currently declares module github.com/cnap-tech/cli in go.mod. Go rejects the new install path with a module path mismatch, so the docs have to keep the legacy Go module coordinate until the CLI module is migrated.
Compatibility risks
- GitHub repository redirects do not make Go module paths compatible when
go.mod declares a different module path.
- Existing users may still run
go install github.com/cnap-tech/cli/cmd/cnap@latest or pin old versions through the Go module proxy.
- Tags published before the rename still describe the old module path, so release/tag ordering needs an explicit plan.
- If any downstream code imports CLI packages, changing
module is a breaking import-path change for those consumers.
Required migration steps
- Audit
akua-dev/cli for github.com/cnap-tech/cli references in go.mod, imports, README, release config, and generated metadata.
- Decide the compatibility story for the old module path: keep old tags/repo redirects available, publish a final legacy note, or document the break.
- Change
go.mod to module github.com/akua-dev/cli and update any internal imports.
- Cut a new release tag from the renamed module path.
- Verify
go install github.com/akua-dev/cli/cmd/cnap@latest in a clean GOPATH/GOMODCACHE.
- Update CNAP/Akua public install docs from
github.com/cnap-tech/cli to github.com/akua-dev/cli after verification.
Acceptance criteria
go install github.com/akua-dev/cli/cmd/cnap@latest succeeds from a clean environment.
- The old-path compatibility behavior is documented intentionally.
- Public docs no longer need the
github.com/cnap-tech/cli Go install exception.
Why
Public docs should eventually use
go install github.com/akua-dev/cli/cmd/cnap@latest, but theakua-dev/clirepository currently declaresmodule github.com/cnap-tech/cliingo.mod. Go rejects the new install path with a module path mismatch, so the docs have to keep the legacy Go module coordinate until the CLI module is migrated.Compatibility risks
go.moddeclares a different module path.go install github.com/cnap-tech/cli/cmd/cnap@latestor pin old versions through the Go module proxy.moduleis a breaking import-path change for those consumers.Required migration steps
akua-dev/cliforgithub.com/cnap-tech/clireferences ingo.mod, imports, README, release config, and generated metadata.go.modtomodule github.com/akua-dev/cliand update any internal imports.go install github.com/akua-dev/cli/cmd/cnap@latestin a cleanGOPATH/GOMODCACHE.github.com/cnap-tech/clitogithub.com/akua-dev/cliafter verification.Acceptance criteria
go install github.com/akua-dev/cli/cmd/cnap@latestsucceeds from a clean environment.github.com/cnap-tech/cliGo install exception.