📦 Other Changes
test(terraform): add reproducible lifecycle field scenarios @osterman (#3563)
- Adds reusable disposable Terraform/OpenTofu lifecycle scenarios covering backend provisioning, provider and module caches, source vendoring, lifecycle contracts, and the documented relative-path workdir limitation.
docs: plan artifact repositories, signatures, and offline workflows @osterman (#3581)
- Adds the Atmos Artifacts PRD and implementation plan covering repository APIs and storage, OCI/S3/local backends, signing and verification, locks and pins, automation, CI summaries, offline restoration, and migration to
oras-go/v2.
feat(artifacts): contracts, configuration, and repository registry @osterman (#3588)
- Defines the Artifacts contracts,
artifacts.repositoriesconfiguration, verification and locking policies, repository-kind registry, and byte-exact compatibility fixtures. Relative local repository paths are resolved from the configuration file that declares them.
feat(artifacts): ORAS transport, shared signing, and artifact service @osterman (#3589)
- Adds the ORAS OCI transport, shared signing and verification, and the artifact service for publishing, pulling, copying, inspecting, listing, searching, deleting, showing, signing, verifying, and pinning artifacts. It also adds deterministic archives, safe extraction, bounded snapshotting, and branch-parent handling for the 150-file pre-commit limit.
feat(artifacts): blob I/O and local directory/archive repositories @osterman (#3590)
- Adds shared blob I/O for local and S3 stores, including conditional writes, multipart uploads, and tags, while preserving the CI stores' wire formats. Adds
local/dirandlocal/archiveartifact repositories with publication state, file locks, and detached signature evidence.
feat(artifacts): S3 and OCI artifact repositories @osterman (#3591)
- Adds the
aws/s3,oci/registry, andoci/layoutartifact repositories with conditional references, object tags, pagination, owner-claim locks, native OCI graph transfer, tag-safe deletion, plugin-release immutability, and Sigstore signing and verification.
feat(artifacts): atmos artifacts commands @osterman (#3592)
- Adds the
atmos artifactscommands forpublish,pull,copy,inspect,list,search,delete,sign,verify, andshow readme|changelog. Repository locks now delegate throughlocking.repository, andsignaccepts either the resolved digest or Record digest.
feat(artifacts): discovery, catalogs, artifact step, and producers @osterman (#3593)
- Adds cached and offline artifact discovery, the optional
AtmosArtifactCatalog, andatmos artifacts catalog build|publish|add|remove|sync. Also adds theartifactworkflow step, scaffold andcomponent/terraformproducers,atmos scaffold publish, and Atmos-payload selection for existing OCI materializers.
chore: bump Claude Code plugin version to v1.234.1 @cloudposse-releaser[bot] (#3664)
- Updates the Claude Code plugin to version
v1.234.1.
fix(ci): render release PR comments as markdown, not a code block @osterman (#3679)
- Release notification comments are now rendered as Markdown instead of indented code blocks, so hidden markers render correctly and release links remain clickable.
Add Anthropic OSS Scanner build files @osterman (#3680)
- Adds the
.oss-scanner/Dockerfileand.oss-scanner/threat_model.mdbuild files for Anthropic's OSS Scanner. The Dockerfile installs a pinned Atmos release, builds Atmos from source, and compiles tests to warm the offline audit cache.
refactor: resolve lint debt in config, exec and plugin packages @osterman (#3689)
- Resolves existing lint debt across configuration, execution, plugin, Helmfile, and script packages, including wrapped static errors, smaller configuration helpers, pointer-passed option structs, and aligned CI lint versions. This changes no application behavior or user-facing flags, commands, or configuration.
✨ Features
feat(plugin): add native Terragrunt discovery and execution @osterman (#3571)
- Adds experimental native Terragrunt discovery and execution through an independently built local plugin. Discovered units and nested stacks enter the normal Atmos compiler and list/describe output, while Atmos retains control of Terraform/OpenTofu execution, dependency scheduling, environments, toolchains, workdirs, and state paths.
feat(terragrunt): run hooks, saved plans, and state under native adaptation @osterman (#3576)
- Extends native Terragrunt support with hooks and
extra_arguments, saved-plan validation,!terraform.stateand!terraform.output,terragrunt://imports, revision-aware affected selection, backend and generated-file policies, toolchain propagation, and richerlist instancesinventory. New plugin installs default to the product name as their alias.
feat(artifacts): CI summaries, docs, and changelog @osterman (#3594)
- Adds CI summaries and output variables for artifact operations, configurable through
ci.templates.artifacts, with one masked and truncated report per operation. Documents artifact commands, catalogs, theartifactstep, kinds, and configuration, and updates the changelog and roadmap.
feat(ci): add native Gitea Actions CI provider @osterman (#3656)
- Adds native Gitea Actions CI support, selected when
GITEA_ACTIONS=true, for commit statuses, marker-based pull-request comments, affected-component detection, runner outputs and summaries, and Gitea metadata. Credentials useATMOS_CI_GITEA_TOKENorGITEA_TOKEN; the API URL supports Atmos and runner variables, and HTTPS is required unlessATMOS_CI_GITEA_ALLOW_INSECURE=true.
feat(starlark): add browser.open for launching URLs from scripts @osterman (#3658)
- Adds
browser.open(url)to Starlark automation for launching validated absolutehttporhttpsURLs in the system browser. Invalid URLs, dry runs, canceled executions, and failed launches are handled without opening a browser.
feat(container): support IP:port host mappings @osterman (#3660)
- Container port mappings now accept an address and port in
host, such as127.0.0.1:8080or[::1]:8080, while numeric ports remain supported. The validated syntax is shared across containers, workflow sandboxes and steps, background services, and emulators; malformed and out-of-range host ports are rejected before runtime operations.
feat(git): add --ref to atmos git clone for exact commit/tag checkout @osterman (#3661)
- Adds
--refandATMOS_GIT_REFtoatmos git clonefor checking out a branch, tag, full ref, or commit SHA detached at the exact requested revision. It overrides configured branches and URI or CI refs, is mutually exclusive with--branch, and requires--allow-unsafe-forkfor explicit refs in elevated fork events.
fix(auth): keep long AWS SSO verification URLs out of the dialog box @osterman (#3667)
- Adds
settings.terminal.links,ATMOS_TERMINAL_LINKS, and the global--linksflag to control long AWS sign-in URL delivery asauto,osc8,clipboard, orraw. AWS SSO andatmos auth consolenow keep long URLs out of dialog boxes while supporting terminal hyperlinks, clipboard or OSC 52 copying, and raw output fallbacks.
feat(examples): add Backstage self-service infrastructure portal @osterman (#3682)
- Adds a runnable Backstage self-service infrastructure portal example with Atmos container builds, local Git/AWS emulators, Gitea Actions, TechDocs, reusable Starlark modules, and a flow that scaffolds stacks and catalog entities, opens a PR, plans before merge, provisions a local S3 bucket, and registers the service.
fix(git): retry concurrent push races with backoff and rate limits @osterman (#3687)
- Git push now retries concurrent remote ref-lock races using bounded rebase-and-push backoff. A
push.retrypolicy undergit.repositories.<name>supports attempts, backoff, jitter, elapsed-time limits, and message conditions, while rate-limited responses honorRetry-AfterandX-RateLimit-Resetwithout rebasing.
feat(docs): add hooks and policy support to docs generate @osterman (#3716)
- Adds
before.docs.generateandafter.docs.generatelifecycle events, withdocs.generate.<type>.hooksinatmos.yamlsupportingcommand,step, andstepshooks,whenfiltering,--skip-hooks,ATMOS_SKIP_HOOKS, andATMOS_DOCS_*environment variables. Hooks can also be governed byon: operationpolicies for document generation. - CI plan comments now include a run link for full output, including when the plan is truncated.
🐛 Bug Fixes
refactor(terraform): extract the component provider runtime @osterman (#3561)
- Moves Terraform lifecycle execution, queries, and artifact generation into the registered component provider while retaining host adapters for shared configuration, authentication, and deferred stack evaluation. Archive inventory validation now rejects Windows drive paths and alternate data streams on every host.
fix(terraform): preserve state and lifecycle safety @osterman (#3562)
- Preserves Terraform state, saved plans, generated files, source ownership, backend provisioning, reference caches, authentication opt-outs, and detailed plan exit codes across lifecycle entry points. Source publication and Windows AWS credential transactions now use native cross-platform file locks.
- Provisioning source and output reuse keys now use HMAC-SHA256 with a process-local secret, so unchanged credentials reuse work while rotated credentials trigger reprovisioning without persisting credential digests.
fix(terraform): report resolved component name in exec metadata for path-style args @pcbeingused333 (#3586)
- Terraform exec metadata now reports the resolved logical component name for path-style arguments such as
./components/terraform/vpc, instead of recording the raw path.
fix(ai): count prompt cache reads and writes in Anthropic and Bedrock input tokens @Haarris (#3662)
- Anthropic and Bedrock
InputTokensandTotalTokensnow include prompt cache reads and writes, matching the OpenAI-compatible and Gemini providers. Cache-only responses retain usage, whileCacheReadTokensandCacheCreationTokensremain unchanged.
fix(ci): parse terraform plans that import, move or replace resources @osterman (#3666)
- Terraform plan parsing now recognizes imports, moves, replacements, tainted and deposed resources,
for_eachkeys containing spaces, andcreate_before_destroyas a single replacement. It also preserves apply outputs with hyphens, brackets, or heredocs and ignoresNo changes.text inside attribute values.
feat(stores): add operation-scoped Vault identity cleanup @noeljackson (#3668)
- Vault and OpenBao stores support opt-in
options.identity_lifetime: operation, which authenticates an isolated target identity and logs it out before returning secrets while preserving existing sessions. Failed cleanup blocks results, and cancellation performs bounded cleanup.
fix(auth): display native device prompts and enforce deadlines @noeljackson (#3669)
- Native authentication device-code instructions are now displayed on stderr during interactive login after validating the verification URL and user code. Provider and identity authentication and logout RPCs now honor invocation deadlines and cancellation.
fix: correct command discovery and quick-start examples @osterman (#3670)
- Configured command aliases now forward discovery flags to their target commands, including subcommands.
- Advanced quick-start workflows no longer include redundant spinner steps, and generated Markdown keeps definition descriptions together with their inline code.
fix(telemetry): degrade config-load failures to DEBUG instead of WARN @aknysh (#3671)
- Best-effort telemetry configuration-load failures now log at
DEBUGinstead of displaying a user-facingWARN, so commands such asatmos versionremain quiet whenATMOS_PROFILErefers to a missing profile.
fix(eks): preserve region and working directory in kubeconfig @osterman (#3675)
- EKS kubeconfig generation now derives an omitted region from the cluster ARN and preserves the effective absolute working directory in
ATMOS_CHDIRfor direct identity and integration modes.
fix(security): patch Dependabot and code-scanning alerts (Nov 2026) @osterman (#3688)
- Registry proxy cache keys are validated against the cache root, rejecting traversal attempts with HTTP
400before any upstream fetch. Every object, sidecar, temporary-file, and lock path is covered. - Updates Go and vulnerable module versions, pins scanner and example Docker images by digest, and applies website and example lockfile dependency overrides for patched npm versions.
fix(helm): respect install-only CRDs in release plans @osterman (#3709)
- Native Helm
diff/planandstack plannow follow install-only CRD behavior: existing releases omitcrds/resources from comparisons, while first installs show only CRDs missing from the cluster. CRDs intemplates/, subchart behavior, offline comparisons, and real template diffs remain supported.
fix(terraform): prefix grouped logs with stack and component @zack-is-cool (#3718)
- Grouped Terraform stdout and stderr lines now carry a
[stack/component]prefix, matching stream mode. Saved per-component logs remain raw, and masking, stream destinations, and no-change suppression are unchanged.
test(artifacts): make claim cancellation tests deterministic @osterman (#3721)
- Makes artifact claim-cancellation regression scenarios deterministic by distinguishing a confirmed lock conflict from a late S3 claim after cancellation. The diagnostic identifies the ambiguous claim while production claim behavior remains unchanged.