📦 Other Changes
docs: plan artifact repositories, signatures, and offline workflows @osterman (#3581)
- Adds the Artifacts product requirements and implementation plan, covering repository backends, signing and verification, locks and pins, automation, CI summaries, offline restoration, acceptance tests, and migration to
oras-go/v2.
feat(artifacts): contracts, configuration, and repository registry @osterman (#3588)
- Defines the Artifacts contracts and
artifacts.repositoriesconfiguration, including verification and locking policies, repository-kind registration, and relative local paths anchored to the declaring configuration file. It also adds compatibility fixtures that preserve existing CI planfile and plugin-release digests.
feat(artifacts): ORAS transport, shared signing, and artifact service @osterman (#3589)
- Adds the ORAS-backed OCI transport in
pkg/oci, shared signing and verification inpkg/signature, and the artifact service operations for publishing, pulling, copying, inspecting, listing, searching, deleting, showing, signing, verifying, and pinning artifacts. It also adds file production, deterministic archives, safe extraction, and bounded snapshotting. - The pre-commit file-count limit now uses a stacked branch's
branch.<name>.stackbaseorATMOS_BRANCH_BASE_REFwhen available.
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 object tags, while preserving the existing CI store wire formats. Adds
local/dirandlocal/archiveartifact repositories with pending/completed publication, file locks, shared record layouts, and detached signature evidence.
feat(artifacts): S3 and OCI artifact repositories @osterman (#3591)
- Adds the
aws/s3,oci/registry, andoci/layoutartifact repositories with conditional reference writes, paginated listing, owner-claim locks, native OCI graph transfer, tag-safe deletion, plugin-release immutability, and shared Sigstore signing and verification.
feat(artifacts): atmos artifacts commands @osterman (#3592)
- Adds the
atmos artifactscommandspublish,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
listandsearch, the optionalAtmosArtifactCatalogwithatmos artifacts catalog build|publish|add|remove|sync, and theartifactstep for workflows, custom commands, scripts, andkind: stephooks. Also adds 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 an indented code block, so hidden markers render correctly and release links remain clickable.
Add Anthropic OSS Scanner build files @osterman (#3680)
- Adds
.oss-scanner/Dockerfileand.oss-scanner/threat_model.mdfor Anthropic's OSS Scanner, including a pinned Atmos release, anatmos buildfrom source, and precompiled tests for offline audits.
refactor: resolve lint debt in config, exec and plugin packages @osterman (#3689)
- No user-facing CLI behavior changes; this PR resolves existing lint findings and aligns the custom lint version and no-network CI allowlist.
✨ Features
feat(artifacts): CI summaries, docs, and changelog @osterman (#3594)
- Adds CI summaries and output variables for artifact operations, including
ci.templates.artifactsoverrides, one report per operation, masking, and truncation across the CLI, workflows, custom commands, and hooks. Documentation and CLI snapshots now cover artifact commands, catalogs, theartifactstep, kinds, and configuration.
feat(ci): add native Gitea Actions CI provider @osterman (#3656)
- Adds the native
gitea-actionsCI provider, selected whenGITEA_ACTIONS=true, with Gitea commit statuses, marker-based PR comment updates, affected-component detection, job outputs, environment and path files, log groups, and job summaries. Credentials useATMOS_CI_GITEA_TOKENorGITEA_TOKEN, and the API URL usesATMOS_CI_GITEA_API_URLor runner/server defaults; HTTPS is required unlessATMOS_CI_GITEA_ALLOW_INSECURE=true.
feat(starlark): add browser.open for launching URLs from scripts @osterman (#3658)
- Adds the Starlark
browser.open(url)function for opening validated absolutehttpandhttpsURLs in the system browser. Invalid URLs, dry runs, and canceled executions do not launch anything; failed launches fail the script.
feat(container): support IP:port host mappings @osterman (#3660)
- 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. Numeric ports remain supported, port0requests automatic assignment, and malformed or out-of-range host ports are rejected before runtime operations across containers, workflow sandboxes, steps, background services, and emulators.
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 in detached mode. The requested revision takes precedence over configured branches, URI?ref=, and CI context;--refcannot be combined with--branch, and elevated fork events require--allow-unsafe-fork.
fix(auth): keep long AWS SSO verification URLs out of the dialog box @osterman (#3667)
- Long AWS SSO verification URLs now stay outside the authentication dialog box. The new
settings.terminal.links,ATMOS_TERMINAL_LINKS, and global--linksoption selectauto,osc8,clipboard, orrawdelivery, with--no-open, CI, and failed browser launches using the same delivery behavior while--print-onlycontinues to print the bare URL.
feat(examples): add Backstage self-service infrastructure portal @osterman (#3682)
- Adds a runnable Backstage self-service infrastructure portal example with native Atmos containers, Git and AWS emulators, a Gitea Actions runner, TechDocs, reusable Starlark modules, and a flow that scaffolds Atmos 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 @osterman (#3687)
- Git pushes now retry concurrent
cannot lock refraces with bounded rebase-and-push backoff. Apush.retrypolicy undergit.repositories.<name>controls attempts, backoff, jitter, elapsed-time budgets, 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. Hooks receiveATMOS_DOCS_TYPE,ATMOS_DOCS_OUTPUT_PATH, andATMOS_DOCS_BASE_DIR, honor--skip-hooksandATMOS_SKIP_HOOKS, run in deterministic order, and can be filtered withwhen: success|failure|always. - CI plan comments now include a
View full runlink, including when output is truncated.
🐛 Bug Fixes
fix(terraform): report resolved component name in exec metadata for path-style args @pcbeingused333 (#3586)
- Terraform exec metadata now records the resolved component name for path-style arguments such as
./components/terraform/vpc, reportingvpcinstead of 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, including responses with only cached input.tokens.promptinatmos ai exec --format jsonand displayed usage totals now match the providers' total prompt-token semantics;CacheReadTokensandCacheCreationTokensare unchanged.
fix(ci): parse terraform plans that import, move or replace resources @osterman (#3666)
- Terraform plan parsing now reports imports, moves, replacements, tainted and deposed resources, and
for_eachkeys containing spaces correctly. It also preserves apply outputs with hyphens, brackets, or heredocs, treatscreate_before_destroyas one replacement, and ignoresNo changes.text embedded in 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. Results are blocked when cleanup fails, and bounded cleanup runs during SIGINT/SIGTERM cancellation; session lifetime remains the default.
fix(auth): display native device prompts and enforce deadlines @noeljackson (#3669)
- Interactive authentication now displays validated native device-code instructions, including the verification URL and user code, on stderr. 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 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_PROFILEnames a missing profile. Commands that explicitly require configuration continue to report their own profile errors.
fix(eks): preserve region and working directory in kubeconfig @osterman (#3675)
- EKS kubeconfig generation now derives an omitted region from the returned cluster ARN and preserves the effective absolute working directory in
ATMOS_CHDIRfor direct identity and integration modes. Existing kubeconfigs may need regeneration to include the corrected authentication context.
fix(security): patch Dependabot and code-scanning alerts (Nov 2026) @osterman (#3688)
- Registry-cache keys are now validated against the cache root for objects, sidecars, temporary files, and locks; invalid traversal keys receive HTTP
400before any upstream fetch. Updates Go and vulnerable module versions, patches website and example npm dependencies, and pins scanner and Helm example images by digest.
fix(helm): respect install-only CRDs in release plans @osterman (#3709)
- Native Helm
diff/planandstack plannow follow install-only CRD behavior: existing releases omitcrds/files, while first installs show only CRDs missing from the cluster. CRD diffs intemplates/, full template output, offline comparisons, enabled subcharts, and lookup errors are preserved.
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 and keeping component context visible throughout long logs. Saved per-component log files remain raw, with masking, stream destinations, and no-change suppression unchanged.