cloudposse/atmos v1.205.1-rc.1

on GitHub

• Move toolchain package from repository root to pkg/toolchain to align with project architecture guidelines
• Update 90 import statements across 145 files to reference github.com/cloudposse/atmos/pkg/toolchain
• Regenerate mocks with updated import paths
• Update documentation references in PRD files

why

The toolchain package was incorrectly placed at the repository root in PR #1686. Project architecture guidelines (CLAUDE.md) specify that all business logic packages belong in pkg/. Moving toolchain to pkg/toolchain ensures consistency with other business logic packages like config, stack, component, store, git, and auth.

references

Aligns with project architecture guidelines in CLAUDE.md: All business logic belongs in pkg/ packages, not at the repository root.

Summary by CodeRabbit

• Chores
  • Internal package reorganization for improved code structure and maintainability. No user-facing functionality changes or behavioral impact.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

• Register terraform compound subcommands (state, providers, workspace) as proper Cobra child commands
• Register per-subcommand compat flags for all 15 compound terraform subcommands
• Add dedicated documentation pages for all compound subcommands with detailed "Native Terraform Flags" sections
• Update screengrabs for all CLI commands
• Fix quoted compound terraform subcommands like "providers lock"
• Add compound subcommand argument parsing (parseCompoundSubcommand, processTerraformCompoundSubcommand)
• Add website documentation updates (templates defaults, stores, hooks)

why

Terraform compound subcommands registered in Cobra command tree (#2018)

Previously, compound terraform subcommands (state list, providers lock, workspace select, etc.) were handled entirely by argument parsing in processArgsAndFlags. This had several limitations:

• Tab completion didn't work for subcommands
• Help text didn't show subcommands with [command] suffix
• Quoted forms like "providers lock" weren't supported

Fix (Part 1 — argument parsing): Added modular helper functions (parseCompoundSubcommand, parseQuotedCompoundSubcommand, parseSeparateCompoundSubcommand, processTerraformCompoundSubcommand) with configurable subcommand lists for workspace, state, providers, and write commands. Supports both quoted ("providers lock") and separate (providers lock) forms.

Fix (Part 2 — Cobra command tree registration): Registered compound subcommands as proper Cobra child commands:

• cmd/terraform/state.go — list, mv, pull, push, replace-provider, rm, show as children of stateCmd
• cmd/terraform/providers.go — lock, mirror, schema as children of providersCmd
• cmd/terraform/workspace.go — list, select, new, delete, show as children of workspaceCmd
• cmd/terraform/utils.go — newTerraformPassthroughSubcommand() helper creates Cobra child commands that delegate to the parent command's execution flow

The legacy compound subcommand parsing in processArgsAndFlags is retained as a fallback for the interactive UI path (which bypasses Cobra) and backward compatibility.

Files: internal/exec/cli_utils.go, internal/exec/cli_utils_test.go, cmd/terraform/utils.go, cmd/terraform/state.go, cmd/terraform/providers.go, cmd/terraform/workspace.go, cmd/terraform/subcommands_test.go

Per-subcommand compat flags for compound terraform subcommands

Added per-subcommand compat flag definitions for all 15 compound terraform subcommands, registered them with the command registry, and documented them in the website docs.

Compat flags registered per subcommand:

Note: Terraform's -dry-run on state mv/state rm is intentionally excluded to avoid conflict with Atmos's --dry-run flag.

Files: cmd/terraform/compat_flags.go, cmd/terraform/state.go, cmd/terraform/providers.go, cmd/terraform/workspace.go, cmd/terraform/subcommands_test.go

Website documentation for compound subcommands

Added dedicated documentation pages for 15 terraform compound subcommands across 3 command families, each with detailed "Native Terraform Flags" sections documenting all supported terraform flags per subcommand:

• providers/ — lock, mirror, schema
• state/ — list, mv, pull, push, replace-provider, rm, show
• workspace/ — list, select, new, delete, show

Each page follows the existing documentation pattern with frontmatter, Intro component, Screengrab, Usage, Examples, Arguments, Flags, Native Terraform Flags, and See Also sections.

Updated screengrabs

Regenerated all CLI command screengrabs to reflect current help text including the new compound subcommand [command] suffixes.

references

• Closes #2018