Repository navigation
Description
Upcoming release v1.235.0
This issue is a preview, not a release approval. Use atmos release cut to publish after all milestone PRs merge.
Included pull requests
📦 Other Changes
-
fix(release): bind 1.235.0 signing to release tags #3538 — fix(release): bind 1.235.0 signing to release tags (open)
- Stable releases and release candidates starting with 1.235.0 now build, sign, and attest in
release-tag-build.ymldispatched from the reserved release tag, while publication remains in the trusted parent workflow. Release validation binds the tag, source and workflow SHAs, parent and child runs, artifacts, request IDs, authorized actors, and RC reservations; historical, nightly, and feature-release flows are unchanged. - Release sealing and publication now verify staged binaries against freshly fetched Aqua metadata and its signer policy, preventing publication when the configured signer workflow or Aqua revision is incompatible.
- Stable releases and release candidates starting with 1.235.0 now build, sign, and attest in
-
test(terraform): add reproducible lifecycle field scenarios #3563 — test(terraform): add reproducible lifecycle field scenarios (open)
- Add reusable disposable Terraform/OpenTofu scenarios covering lifecycle contracts, backend provisioning, provider and module caches, source vendoring, and the documented relative-path workdir limitation. Generated scaffold fixtures are retained, while runtime logs and disposable state remain outside version control.
-
docs: plan artifact repositories, signatures, and offline workflows #3581 — docs: plan artifact repositories, signatures, and offline workflows (merged)
- Add the Atmos Artifacts PRD and implementation plan covering shared API and storage contracts, OCI/S3/local repositories, signing and verification, locks and pins, automation, CI summaries, offline restoration, and migration to
oras-go/v2.
- Add the Atmos Artifacts PRD and implementation plan covering shared API and storage contracts, OCI/S3/local repositories, signing and verification, locks and pins, automation, CI summaries, offline restoration, and migration to
-
fix(terragrunt): harden native errors, imports, and saved plans #3582 — fix(terragrunt): harden native errors, imports, and saved plans (open)
- Harden native Terragrunt support with structured secret-safe errors, full
--allvalidation,terragrunt://imports and overrides, shared discovery matchers, saved-plan retention and--from-plan, source refresh notices, generated-file cleanup, hook handling, affected-file tracking, and first-use plugin configuration validation.
- Harden native Terragrunt support with structured secret-safe errors, full
-
feat(artifacts): contracts, configuration, and repository registry #3588 — feat(artifacts): contracts, configuration, and repository registry (merged)
- Add Artifacts domain contracts, the
artifacts.repositoriesconfiguration with verification and locking policies, repository-kind registration, and validation. Relative local repository paths resolve from the declaring configuration file, and compatibility fixtures preserve existing artifact digests.
- Add Artifacts domain contracts, the
-
feat(artifacts): ORAS transport, shared signing, and artifact service #3589 — feat(artifacts): ORAS transport, shared signing, and artifact service (merged)
- Add ORAS-backed OCI transport in
pkg/oci, shared signing and verification inpkg/signature, and the artifact service for publish, pull, copy, inspect, list, search, delete, show, sign, verify, and pin operations. File production, bounded snapshotting, deterministic archives, safe extraction, and repository conformance support are included. - The pre-commit file-count check can now measure against a stacked branch base using
branch.<name>.stackbaseorATMOS_BRANCH_BASE_REF.
- Add ORAS-backed OCI transport in
-
feat(artifacts): blob I/O and local directory/archive repositories #3590 — feat(artifacts): blob I/O and local directory/archive repositories (merged)
- Add local directory and archive artifact repositories with shared layouts, pending and completed publication, OS file locks, and detached signature evidence. Blob I/O for local and S3 storage now lives in
pkg/artifact/blob, while existing CI stores use it without changing wire formats.
- Add local directory and archive artifact repositories with shared layouts, pending and completed publication, OS file locks, and detached signature evidence. Blob I/O for local and S3 storage now lives in
-
feat(artifacts): S3 and OCI artifact repositories #3591 — feat(artifacts): S3 and OCI artifact repositories (merged)
- Add AWS S3 artifact repositories with per-file or archive payloads, conditional writes, object tags, paginated listing, and non-expiring owner-claim locks. Add OCI registry and layout repositories with Atmos package assembly, native graph transfer, tag-safe deletion, plugin-release immutability, and shared Sigstore signing and verification.
-
feat(artifacts): atmos artifacts commands #3592 — feat(artifacts): atmos artifacts commands (merged)
- Add the
atmos artifactscommands for publishing, pulling, copying, inspecting, listing, searching, deleting, signing, and verifying artifacts, plusshow readme|changelog. Repository composition uses shared lazy signer, verifier, and identity resolution;signaccepts either the resolved digest or Record digest.
- Add the
-
feat(artifacts): discovery, catalogs, artifact step, and producers #3593 — feat(artifacts): discovery, catalogs, artifact step, and producers (open)
- Add cached and offline artifact
listandsearch, optionalAtmosArtifactCatalogcommands (build,publish,add,remove, andsync), theartifactstep for workflows, custom commands, scripts, and hooks, and scaffold andcomponent/terraformproducers. OCI materializers can select Atmos payloads.
- Add cached and offline artifact
-
feat(terragrunt): support errors, exclude, IAM, and registry sources #3598 — feat(terragrunt): support errors, exclude, IAM, and registry sources (open)
- Add native Terragrunt support for
terraform_binary,errors,exclude, feature flags, lifecycle hooks, IAM role and web-identity authentication, remote-state encryption anddisable_init, andtfr://registry sources. Stack and unit configuration now controls these settings, and provider import routing uses the configuration adapter.
- Add native Terragrunt support for
-
feat(terragrunt): typed flags, Pro support, and executable mode #3599 — feat(terragrunt): typed flags, Pro support, and executable mode (open)
- Add typed Terragrunt provider flags, exact input-value transport, plugin AWS credential resolution, masked scoped logging, Atmos Pro plan and affected-component support, and experimental executable mode (
mode: executable). Executable mode runs pinnedterragrunt runoperations under Atmos scheduling and authentication, but does not support Atmos-managed saved plans, stack overrides, orterraform shell.
- Add typed Terragrunt provider flags, exact input-value transport, plugin AWS credential resolution, masked scoped logging, Atmos Pro plan and affected-component support, and experimental executable mode (
-
feat(plugin): deliver Terragrunt log events live #3600 — feat(plugin): deliver Terragrunt log events live (open)
- Terragrunt plugins can now stream
Logevents while discovery, preparation, or state calls are running. Atmos renders masked, scoped events at the invocation's log level, applies bounded backpressure without dropping entries, and reports undelivered events on cancellation or when the log service is unavailable.
- Terragrunt plugins can now stream
-
fix(terraform): write nested maps and lists of maps as valid HCL varfiles #3686 — fix(terraform): write nested maps and lists of maps as valid HCL varfiles (open)
atmos terraform generate varfiles --format hclandgenerate backends --format backend-confignow write nested maps as HCL objects and lists of maps as tuples usinghclwrite, preserving values such asnull, non-identifier keys, and interpolated strings. Generated files are opened withO_TRUNC, so shorter output no longer retains stale trailing content.
✨ Features
-
feat(ci): annotate stale Atmos versions during CI runs #3549 — feat(ci): annotate stale Atmos versions during CI runs (open)
- CI commands can asynchronously emit one stderr annotation when the installed Atmos version is at least 10 minor versions behind within the same major, with installation-aware upgrade guidance. Configure the behavior with
version.check.ci.enabledandversion.check.ci.minor_thresholdor their environment overrides; the existing master flag and localatmos version --checkbehavior remain in effect.
- CI commands can asynchronously emit one stderr annotation when the installed Atmos version is at least 10 minor versions behind within the same major, with installation-aware upgrade guidance. Configure the behavior with
-
feat(plugin): add native Terragrunt discovery and execution #3571 — feat(plugin): add native Terragrunt discovery and execution (open)
- Add opt-in native Terragrunt discovery and execution through independent component discovery, validation, preparation, and state contracts. Local units and nested stacks enter the normal Atmos compiler and listing output, while Atmos owns Terraform/OpenTofu execution, dependencies, authentication, toolchains, and isolated workdirs.
-
feat(terragrunt): run hooks, saved plans, and state under native adaptation #3576 — feat(terragrunt): run hooks, saved plans, and state under native adaptation (open)
- Native Terragrunt support now evaluates hooks and
extra_arguments, binds saved plans to their execution context, reads state and outputs through configuration providers, supportsterragrunt://imports and revision-aware affected detection, manages backends and generated files, and preserves toolchainPATHsettings.list instancesshows Type and Engine columns, and installed-package acceptance coverage is included.
- Native Terragrunt support now evaluates hooks and
-
feat(artifacts): CI summaries, docs, and changelog #3594 — feat(artifacts): CI summaries, docs, and changelog (open)
- Add CI job summaries and output variables for artifact operations, configurable through
ci.templates.artifacts, with one masked and truncated report per operation. Document the artifacts commands, catalogs,artifactstep, kinds, and configuration, and add the changelog and roadmap entry.
- Add CI job summaries and output variables for artifact operations, configurable through
-
feat(helm): add kube_version and api_versions for client-side renders #3620 — feat(helm): add kube_version and api_versions for client-side renders (closed, unmerged — blocks release)
- Native Helm components now support
kube_versionandapi_versions, with matching flags onatmos helm template,diff,plan,apply, anddeploy; CLI values take precedence and--api-versionsreplaces the component list. These values affect client-side renders and GitOps delivery, while live cluster installs and upgrades continue using server capabilities.
- Native Helm components now support
-
feat(auth): add native GitLab CI OIDC provider #3645 — feat(auth): add native GitLab CI OIDC provider (open)
- Add the native
gitlab/oidcauthentication provider for GitLab CI/CD. It reads an ID token fromATMOS_OIDC_TOKENby default or a configuredspec.token_environment_variable, then integrates with AWS assume-role identities and chained cross-account authentication.
- Add the native
-
feat(ci): add native Gitea Actions CI provider #3656 — feat(ci): add native Gitea Actions CI provider (merged)
- Add the native
gitea-actionsCI provider, selected byGITEA_ACTIONS=true, with Gitea commit statuses, marker-based owned PR comments, affected-commit detection, runner outputs and summaries, and GitHub-compatible metadata fallbacks. Credentials useATMOS_CI_GITEA_TOKENorGITEA_TOKEN; Gitea runs no longer select the GitHub provider orgithub/artifactsstore.
- Add the native
-
feat(starlark): add browser.open for launching URLs from scripts #3658 — feat(starlark): add browser.open for launching URLs from scripts (merged)
- Add
browser.open(url)to Starlark automation for launching validated absolutehttpandhttpsURLs in the system browser. Invalid schemes, paths, credentials, malformed URLs, dry runs, and canceled executions are rejected without launching; launch failures fail the script.
- Add
-
feat(container): support IP:port host mappings #3660 — feat(container): support IP:port host mappings (merged)
- Container port mappings now accept address-and-port values such as
host: "127.0.0.1:8080"withcontainer: 3000, including IPv4 and bracketed IPv6 endpoints. The validated conversion is shared by container components, workflow sandboxes and steps, background services, and emulators; malformed and out-of-range host ports are rejected before runtime.
- Container port mappings now accept address-and-port values such as
-
feat(git): add --ref to atmos git clone for exact commit/tag checkout #3661 — feat(git): add --ref to atmos git clone for exact commit/tag checkout (merged)
- Add
--refandATMOS_GIT_REFtoatmos git clonefor detached checkout of branches, tags, full refs, or commit SHAs. Existing checkouts reconcile exactly to the requested revision, with--depthand--filterapplied to fetches;--refoverrides configured or CI branches and cannot be combined with--branch.
- Add
-
fix(auth): keep long AWS SSO verification URLs out of the dialog box #3667 — fix(auth): keep long AWS SSO verification URLs out of the dialog box (merged)
- AWS SSO verification URLs longer than 80 columns are displayed outside the dialog box. Configure delivery with
settings.terminal.links,ATMOS_TERMINAL_LINKS, or global--links:auto,osc8,clipboard, orraw;atmos auth consoleuses the same delivery for non-browser flows, while--print-onlycontinues to print the bare URL.
- AWS SSO verification URLs longer than 80 columns are displayed outside the dialog box. Configure delivery with
-
Let remote reads name an Atmos Auth identity; fix identity environment delivery #3676 — Let remote reads name an Atmos Auth identity; fix identity environment delivery (open)
- Remote vendored sources, component sources, and object-form stack imports can now select an Atmos Auth identity, with defaults from
vendor.identityandimports.identity;--identitytakes precedence foratmos vendor pull. Identity environments are scoped to each fetch, and stored plugin credentials can be restored in fresh processes. atmos gitandatmos ansible playbooknow deliver configured identity environments to their subprocesses.
- Remote vendored sources, component sources, and object-form stack imports can now select an Atmos Auth identity, with defaults from
-
Add the cloudposse/ssh plugin: SSH keys as Atmos identities #3677 — Add the cloudposse/ssh plugin: SSH keys as Atmos identities (open)
- Add the official
cloudposse/sshplugin, which exposes SSH keys as Atmos identities using Secure Enclave keys on macOS and key files elsewhere. It provides scoped signing and login agent sockets, optional GitHub authority enrollment, generated Git and Ansible environment settings, per-user daemon management, andatmos sshkey, agent, and test commands.
- Add the official
-
feat(examples): add Backstage self-service infrastructure portal #3682 — feat(examples): add Backstage self-service infrastructure portal (merged)
- Add a runnable Backstage self-service infrastructure portal example with native Atmos container builds, local Git/AWS emulators, Gitea Actions, TechDocs, reusable Starlark modules, and a flow that scaffolds stacks, opens a Gitea PR, plans before merge, provisions a local S3 bucket, and registers the service.
-
fix(git): retry concurrent push races with backoff and rate limits #3687 — fix(git): retry concurrent push races with backoff and rate limits (merged)
- Git pushes now retry concurrent
cannot lock refraces with bounded rebase-and-push attempts and backoff. Configuregit.repositories.<name>.push.retrywith shared retry settings; rate-limited responses honorRetry-AfterandX-RateLimit-Reset, waiting and retrying without rebasing, while legacypush.retriesremains supported.
- Git pushes now retry concurrent
-
feat(docs): add hooks and policy support to docs generate #3716 — feat(docs): add hooks and policy support to docs generate (open)
- Add
before.docs.generateandafter.docs.generatelifecycle events anddocs.generate.<type>.hooksforcommand,step, andstepshooks. Hooks receiveATMOS_DOCS_TYPE,ATMOS_DOCS_OUTPUT_PATH,ATMOS_DOCS_BASE_DIR, and template values;when,--skip-hooks,ATMOS_SKIP_HOOKS, and operation policies are supported. - Hook execution is deterministic, errors identify the hook and event, and before-hook failures prevent file writes. CI plan comments also include a job-summary link when output is truncated.
- Add
🐛 Bug Fixes
-
fix: tolerate OpenTofu provider iteration in component loading #3484 — fix: tolerate OpenTofu provider iteration in component loading (open)
- OpenTofu provider iteration such as
provider = aws.by_account[each.key]is now recognized as a supported parser limitation during component loading, affected detection, anddescribe component. Other diagnostics, including conditional provider expressions, remain fatal, and the skip is recorded ascomponent_info.validation_skipped_provider_iteration.
- OpenTofu provider iteration such as
-
refactor(terraform): extract the component provider runtime #3561 — refactor(terraform): extract the component provider runtime (open)
- Terraform lifecycle execution, queries, and artifact generation now run through the registered component provider, while host adapters retain shared configuration, authentication, and deferred stack evaluation. Archive inventories validate local paths on every host and reject Windows drive paths and alternate data streams.
-
fix(terraform): preserve state and lifecycle safety #3562 — fix(terraform): preserve state and lifecycle safety (open)
- Preserve Terraform state, saved plans, generated files, and source ownership during vendoring and initialization, while retaining backend provisioning, reference caches, stream routing, authentication opt-outs, and detailed plan exit codes.
- Source publication uses the native cross-platform file lock, and the legacy workdir guard validates paths before reading them so regular files are not mistaken for missing directories on Windows.
- AWS credential/config transactions now use the native file lock on Windows, and authentication-aware provisioning fingerprints use a process-local HMAC-SHA256 secret without persisting credential digests.
-
fix(terraform): report resolved component name in exec metadata for path-style args #3586 — fix(terraform): report resolved component name in exec metadata for path-style args (merged)
- Terraform exec metadata now records the resolved logical component name when commands use a path-style argument such as
./components/terraform/vpc, instead of storing the raw path.
- Terraform exec metadata now records the resolved logical component name when commands use a path-style argument such as
-
fix(ai): apply ai.timeout_seconds to Gemini requests #3614 — fix(ai): apply ai.timeout_seconds to Gemini requests (open)
- Gemini requests now honor
ai.timeout_seconds, defaulting to the 60-secondbase.DefaultRequestTimeoutwhen unset, matching the other AI providers.
- Gemini requests now honor
-
fix(list): quote CSV/TSV fields that contain the delimiter, quotes or newlines #3617 — fix(list): quote CSV/TSV fields that contain the delimiter, quotes or newlines (open)
atmos list ... --format csv|tsvnow quotes fields containing delimiters, quotes, or newlines when the delimiter is supported byencoding/csv, preserving valid rows and headers. Multi-character and otherwise unsupported delimiters retain the previous join behavior.
-
fix(ai): count prompt cache reads and writes in Anthropic and Bedrock input tokens #3662 — fix(ai): count prompt cache reads and writes in Anthropic and Bedrock input tokens (merged)
- Anthropic and Bedrock usage totals now include prompt cache reads and writes in
InputTokensandTotalTokens, including replies containing only cached input.atmos ai exec --format jsonand token displays therefore report total prompt input consistently with OpenAI-compatible and Gemini providers.
- Anthropic and Bedrock usage totals now include prompt cache reads and writes in
-
fix(ci): parse terraform plans that import, move or replace resources #3666 — fix(ci): parse terraform plans that import, move or replace resources (merged)
- Terraform plan parsing now reports imports, moves, replacements, tainted and deposed resources, and
create_before_destroyreplacements correctly. It also preserves apply outputs with hyphens, brackets, or heredocs and no longer treatsNo changes.inside an attribute value as an empty plan.
- Terraform plan parsing now reports imports, moves, replacements, tainted and deposed resources, and
-
feat(stores): add operation-scoped Vault identity cleanup #3668 — feat(stores): add operation-scoped Vault identity cleanup (merged)
- Vault and OpenBao stores support opt-in
options.identity_lifetime: operation, authenticating an isolated target identity and logging it out before returning secrets while preserving existing sessions. Failed cleanup blocks results, and bounded cleanup runs during SIGINT/SIGTERM cancellation; session lifetime remains the default.
- Vault and OpenBao stores support opt-in
-
fix(auth): display native device prompts and enforce deadlines #3669 — fix(auth): display native device prompts and enforce deadlines (merged)
- Interactive authentication now displays validated native device-code instructions on stderr, including the verification URL and user code. Provider and identity authentication and logout RPCs honor invocation deadlines and cancellation.
-
fix: correct command discovery and quick-start examples #3670 — fix: correct command discovery and quick-start examples (merged)
- Configured command aliases now forward discovery flags to their target commands, advanced quick-start workflows no longer include redundant spinner steps, and generated Markdown keeps definition descriptions together with inline code.
-
fix(telemetry): degrade config-load failures to DEBUG instead of WARN #3671 — fix(telemetry): degrade config-load failures to DEBUG instead of WARN (merged)
- Best-effort telemetry configuration-load failures now log at
DEBUGinstead of displaying a user-facingWARN, so commands such asatmos versionremain quiet whenATMOS_PROFILEnames a profile unavailable in the current directory. Command-level configuration errors are unchanged.
- Best-effort telemetry configuration-load failures now log at
-
fix(eks): preserve region and working directory in kubeconfig #3675 — fix(eks): preserve region and working directory in kubeconfig (merged)
- EKS kubeconfigs now derive an omitted region from the returned cluster ARN and preserve the effective absolute working directory in
ATMOS_CHDIRfor direct-identity and integration modes, keeping generated token authentication independent of the caller's later directory.
- EKS kubeconfigs now derive an omitted region from the returned cluster ARN and preserve the effective absolute working directory in
-
feat(ai): add ai.web_search.google_base_url for the Google search engine #3681 — feat(ai): add ai.web_search.google_base_url for the Google search engine (open)
- Add optional
ai.web_search.google_base_urlto override the Google Custom Search endpoint used by the Google web search engine. When unset, requests continue usinghttps://www.googleapis.com/customsearch/v1; trailing slashes in configured URLs are trimmed.
- Add optional
-
fix(terraform): truncate backend.tf when regenerating it in HCL format #3683 — fix(terraform): truncate backend.tf when regenerating it in HCL format (open)
atmos terraform generate backends --format hclnow opensbackend.tfwithO_TRUNC, replacing shorter regenerated configurations completely instead of leaving stale bytes from the previous file.
-
fix(security): patch Dependabot and code-scanning alerts (Nov 2026) #3688 — fix(security): patch Dependabot and code-scanning alerts (Nov 2026) (merged)
- Registry-cache keys are now validated against the cache root for object, sidecar, temporary, and lock paths; invalid keys receive HTTP 400 before any upstream fetch. The release also updates Go and patched dependencies, pins selected Docker images by digest, and applies website and example npm dependency overrides for addressed advisories.
-
fix(helm): respect install-only CRDs in release plans #3709 — fix(helm): respect install-only CRDs in release plans (merged)
- Native Helm
diff,plan, andstack plannow handle install-only CRDs separately from stored release manifests: first installs show only CRDs missing from the cluster, while existing releases omit unchangedcrds/files. Template and offline comparisons retain CRDs, and regular template diffs remain visible.
- Native Helm
-
fix(terraform): prefix grouped logs with stack and component #3718 — fix(terraform): prefix grouped logs with stack and component (open)
- Grouped Terraform stdout and stderr lines now carry a
[stack/component]prefix, keeping execution context visible throughout long logs. Saved per-component log files remain raw, with masking, stream destinations, and no-change suppression unchanged.
- Grouped Terraform stdout and stderr lines now carry a
Activity