Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
67 commits
Select commit Hold shift + click to select a range
eac7507
docs(plugin): define package identity and repository naming
osterman Oct 30, 2026
f4b527a
feat(terragrunt): run hooks, saved plans, and state under native adap…
osterman Oct 30, 2026
791f67a
test(list): refresh list instances snapshots for the Type and Engine …
osterman Oct 31, 2026
db714c9
fix(terragrunt): repair CI for the compatibility layer
osterman Nov 1, 2026
4ba7d3a
fix(casts): reach the terragrunt-native cast validator from the cast …
osterman Nov 1, 2026
35c2d43
test(terraform): make the hook and toolchain process tests pass on Wi…
osterman Nov 8, 2026
84ed25a
fix(list): match OpenTofu engine detection to execution
osterman Nov 8, 2026
e932f16
fix(terraform): check required var files before init and drop --var o…
osterman Nov 8, 2026
7cf2fa6
fix(terragrunt): accept project-root and aliased imports, reject glob…
osterman Nov 8, 2026
5a15479
fix(plugin): keep the publisher-qualified default alias for earlier e…
osterman Nov 8, 2026
8f14ce2
docs(terragrunt): document the coordinates of an imported unit
osterman Nov 8, 2026
e833877
fix(terragrunt): keep discovery and output reads working with data fi…
osterman Nov 8, 2026
b8db866
fix(terraform): keep plan hooks, engine checks, and plan digests cons…
osterman Nov 10, 2026
40d7bd2
fix(affected): validate watch_excludes and reuse the filtered watch i…
osterman Nov 10, 2026
c73d7f9
fix(plugin): preserve binary request in plan fingerprint
osterman Nov 11, 2026
d0408c3
fix(terragrunt): initialize empty local backend configuration
osterman Nov 11, 2026
eda517c
fix(affected): reuse filtered indexes per change set
osterman Nov 11, 2026
1b1bbe8
test(terragrunt): verify installed unit identities
osterman Nov 11, 2026
08fc1c9
fix(output): anchor default local state paths
osterman Nov 11, 2026
65a62af
fix(terraform): bind downloaded modules to saved plans
osterman Nov 11, 2026
91a0a31
test(terraform): verify reviewed plan reaches apply
osterman Nov 11, 2026
707401c
refactor(configuration): own provider import and watch policy
osterman Nov 11, 2026
21b6991
fix(terraform): bind effective plan output arguments
osterman Nov 11, 2026
2f81e29
fix(terraform): reject plan output flags from TF_CLI_ARGS
osterman Nov 13, 2026
ff18c58
fix(terraform): select policy plan artifacts from effective arguments
osterman Nov 13, 2026
427a071
fix(terraform): stream error hook output from temporary files
osterman Nov 13, 2026
ce62ac3
Merge origin/feat/component-plugin-contracts into feat/terragrunt-nat…
osterman Nov 13, 2026
cfdb818
fix: address L5 configuration review findings
osterman Nov 13, 2026
114daa7
fix(terragrunt): label incomplete dry-run previews
osterman Nov 13, 2026
9568d8e
fix(terragrunt): address L5 saved-plan and execution review findings
osterman Nov 13, 2026
8921b1b
test(execution): drive lifecycle tests through a generated Runner mock
osterman Nov 13, 2026
d061c17
test(terraform): use generated mocks for the reviewed-plan runtime
osterman Nov 13, 2026
4f695f6
test(output): resolve configuration state through a generated runtime…
osterman Nov 13, 2026
78de52d
test(terraform): restore the unchanged configuration runtime mock header
osterman Nov 13, 2026
f3b275d
test(configuration): generate the provider mock with its identity cap…
osterman Nov 13, 2026
d79bbcb
Merge published L4 head 23be87e025 into feat/terragrunt-native-compat…
osterman Nov 13, 2026
9fb30e2
docs(plugin): clarify L5 component service status
osterman Nov 13, 2026
22fc3a6
ci(plugin): authenticate official package checks to GHCR
osterman Nov 13, 2026
dcff908
test(terraform): fold PATH regression into toolchain suite
osterman Nov 13, 2026
a7f639c
fix(terragrunt): preserve effective plan and preparation inputs
osterman Nov 14, 2026
e7bb17f
Merge updated component plugin contracts into Terragrunt compatibility
osterman Nov 14, 2026
68de053
Merge remote-tracking branch 'origin/feat/component-plugin-contracts'…
osterman Nov 14, 2026
41e3c83
Merge remote-tracking branch 'origin/feat/component-plugin-contracts'…
osterman Nov 14, 2026
05b95b4
Merge remote-tracking branch 'origin/feat/component-plugin-contracts'…
osterman Nov 14, 2026
47decc5
fix(terragrunt): evaluate apply-time execution with the request's dow…
osterman Nov 14, 2026
d85769c
fix(terraform): harden plan preflight and toolchain PATH selection
osterman Nov 14, 2026
f738b5c
fix(terraform): tokenize TF_CLI_ARGS with the engine's rules when gua…
osterman Nov 15, 2026
ebe0057
refactor(terragrunt): split unit resolution out of resolve
osterman Nov 15, 2026
4bc6f03
fix(terraform): bind the saved plan to the configuration Terraform read
osterman Nov 15, 2026
e237006
Merge branch 'feat/component-plugin-contracts' into feat/terragrunt-n…
osterman Nov 15, 2026
a755afd
Merge branch 'feat/component-plugin-contracts' into feat/terragrunt-n…
osterman Nov 15, 2026
d786620
Merge branch 'feat/component-plugin-contracts' into feat/terragrunt-n…
osterman Nov 16, 2026
70f57c9
fix(terraform): keep hook failures, init file flags and plan bytes ho…
osterman Nov 16, 2026
8249097
Merge branch 'feat/component-plugin-contracts' into feat/terragrunt-n…
osterman Nov 16, 2026
83b3418
fix(terraform): bind the engine that ran Terraform, not the one prese…
osterman Nov 16, 2026
9d62a30
Merge remote-tracking branch 'origin/feat/component-plugin-contracts'…
osterman Nov 16, 2026
84b9194
test(terraform): give the engine copy an executable extension on Windows
osterman Nov 16, 2026
2bd897b
Merge remote-tracking branch 'origin/feat/component-plugin-contracts'…
osterman Nov 16, 2026
a81adae
fix(terraform): honor explicit -detailed-exitcode values in plan stat…
osterman Nov 16, 2026
f8eba99
fix(terraform): resolve workdir digest paths before excluding the pla…
osterman Nov 16, 2026
c129827
fix(terragrunt): decide prevent_destroy from syntax when the guard pa…
osterman Nov 16, 2026
a170c89
fix(terragrunt): enforce destroy protection for environment arguments
osterman Nov 17, 2026
833fff1
refactor(terragrunt): simplify provider discovery and preparation ass…
osterman Nov 17, 2026
0792a6c
Merge L4 plugin-contract checkpoint into L5 native Terragrunt
osterman Nov 17, 2026
51c8aae
Merge L4 projection consolidation and group destroy guard tests
osterman Nov 17, 2026
0e80d24
fix(terraform): finish plugin output init policy and shell mocks
osterman Nov 17, 2026
9bcf0a3
fix(terragrunt): integrate predecessor repairs and finish L5 lint
osterman Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/plugin-packages.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ on:
workflow_call:
permissions:
contents: read
packages: read
env:
ATMOS_CI: 'true'
CGO_ENABLED: '0'
Expand Down Expand Up @@ -47,6 +48,8 @@ jobs:
GOCACHE: ${{ runner.temp }}/plugin-go-build
GOMODCACHE: ${{ runner.temp }}/plugin-go-mod
RELEASE_BASE: ${{ steps.base.outputs.ref }}
GITHUB_TOKEN: ${{ github.token }}
ATMOS_GITHUB_USERNAME: ${{ github.actor }}
run: atmos plugin release --inventory plugins/releases.yaml --check ${RELEASE_BASE:+--base "$RELEASE_BASE"}

release:
Expand Down
6 changes: 6 additions & 0 deletions demo/casts/atmos.d/all.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@ commands:
- type: shell
name: native-terraform
command: atmos casts generate demo fixtures native-terraform
- type: shell
name: terragrunt-native
command: atmos casts generate demo fixtures terragrunt-native
- type: shell
name: streaming-ui
command: atmos casts generate demo fixtures streaming-ui
Expand Down Expand Up @@ -56,6 +59,9 @@ commands:
- type: shell
name: native-terraform
command: atmos casts validate demo fixtures native-terraform
- type: shell
name: terragrunt-native
command: atmos casts validate demo fixtures terragrunt-native
- type: shell
name: streaming-ui
command: atmos casts validate demo fixtures streaming-ui
Expand Down
6 changes: 6 additions & 0 deletions demo/casts/atmos.d/demo/fixtures/all.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,9 @@ commands:
- type: shell
name: casts-fixtures-native-terraform-output
command: atmos casts generate demo fixtures native-terraform output
- type: shell
name: casts-fixtures-terragrunt-native-plan
command: atmos casts generate demo fixtures terragrunt-native plan
- type: shell
name: casts-fixtures-demo-vendoring-pull
command: atmos casts generate demo fixtures demo-vendoring pull
Expand Down Expand Up @@ -47,6 +50,9 @@ commands:
- type: shell
name: casts-fixtures-native-terraform-output
command: atmos casts validate demo fixtures native-terraform output
- type: shell
name: casts-fixtures-terragrunt-native-plan
command: atmos casts validate demo fixtures terragrunt-native plan
- type: shell
name: casts-fixtures-demo-vendoring-pull
command: atmos casts validate demo fixtures demo-vendoring pull
Expand Down
15 changes: 15 additions & 0 deletions demo/casts/atmos.d/demo/fixtures/terragrunt-native/all.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
commands:
- name: casts generate demo fixtures terragrunt-native
description: Regenerate casts sourced from demo/casts/fixtures/terragrunt-native
env: !include cast-defaults.yaml .env.command
steps:
- type: shell
name: casts-fixtures-terragrunt-native-plan
command: atmos casts generate demo fixtures terragrunt-native plan
- name: casts validate demo fixtures terragrunt-native
description: Validate casts sourced from demo/casts/fixtures/terragrunt-native
env: !include cast-defaults.yaml .env.command
steps:
- type: shell
name: casts-fixtures-terragrunt-native-plan
command: atmos casts validate demo fixtures terragrunt-native plan
89 changes: 89 additions & 0 deletions demo/casts/atmos.d/demo/fixtures/terragrunt-native/plan.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
commands:
- name: casts generate demo fixtures terragrunt-native plan
description: Record native Terragrunt discovery and an OpenTofu plan
env:
PATH: '{{ env "PWD" }}/../../build:{{ env "PATH" }}'
ATMOS_TELEMETRY_ENABLED: 'false'
steps:
# Build the host and package together so their protocol stays in sync.
- type: shell
name: build-host
working_directory: ../..
command: go build -o build/atmos .
output: none
- type: shell
name: build-plugin
working_directory: ../..
command: build/atmos plugin build plugins/terragrunt
output: none
- type: workdir
name: fixture
source: fixtures/terragrunt-native
path: ../../.context/cast-fixtures/terragrunt-native
reset: true
# Resolve the development package outside the recording; no machine paths
# belong in the published demo. The blog explains this prerequisite.
- type: shell
name: package
working_directory: ../../.context/cast-fixtures/terragrunt-native
command: atmos config set plugins.packages.terragrunt.path "../../../plugins/terragrunt"
output: none
- type: cast
name: plan
working_directory: ../../.context/cast-fixtures/terragrunt-native
title: Native Terragrunt discovery and planning
mode: steps
defaults:
cast: !include cast-defaults.yaml .cast
simulate: !include cast-defaults.yaml .simulate
show:
labels: false
output:
mode: raw
cast: ../../website/static/casts/demo/fixtures/terragrunt-native/plan.cast
env: !include cast-defaults.yaml .env.recording
steps:
- type: simulate
text: '# The native plugin is built; enable it for the existing live/ tree.'
- type: simulate
text: &enable atmos config set components.terraform.terragrunt.enabled true
- type: shell
command: *enable
- type: simulate
text: &mode atmos config set components.terraform.terragrunt.mode native
- type: shell
command: *mode
- type: simulate
text: &scope atmos config set --type=yaml components.terraform.terragrunt.discovery.included_paths '["live/**"]'
- type: shell
command: *scope
- type: simulate
text: &discover atmos config set components.terraform.terragrunt.discovery.enabled true
- type: shell
command: *discover
- type: simulate
text: &stacks atmos list stacks
- type: shell
command: *stacks
- type: simulate
text: &instances atmos list instances
- type: shell
command: *instances
- type: simulate
text: '# HCL evaluates the greeting; Atmos runs OpenTofu. No cloud credentials needed.'
- type: simulate
text: &plan atmos terraform plan demo -s live
- type: shell
command: *plan
interval: 2s
- type: script
name: validate
interpreter: starlark
script: !include scripts/validate-terragrunt-native.star
- name: casts validate demo fixtures terragrunt-native plan
description: Validate native Terragrunt discovery and plan evidence
steps:
- type: script
name: validate
interpreter: starlark
script: !include scripts/validate-terragrunt-native.star
27 changes: 27 additions & 0 deletions demo/casts/fixtures/terragrunt-native/atmos.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
base_path: .

components:
terraform:
base_path: components/terraform
command: tofu
terragrunt:
enabled: false
mode: native
discovery:
enabled: false
included_paths: [live/**]

logs:
level: Warning

# Keep the local-development warning, but redact the recorder's checkout path wherever the
# checkout lives (a home directory, a CI runner workspace, or a Windows drive).
settings:
metrics:
enabled: false
terminal:
mask:
enabled: true
replacement: '[LOCAL_PLUGIN]'
patterns:
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
- '(/|[A-Za-z]:[\\/])[^[:space:]]*[\\/]plugins[\\/]terragrunt'
19 changes: 19 additions & 0 deletions demo/casts/fixtures/terragrunt-native/live/demo/terragrunt.hcl
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Keep the existing Terragrunt layout and evaluate its inputs natively.
terraform {
source = "../../modules/demo"
}

remote_state {
backend = "local"
config = {
path = "${get_terragrunt_dir()}/terraform.tfstate"
}
generate = {
path = "backend.tf"
if_exists = "overwrite_terragrunt"
}
}

inputs = {
greeting = upper("hello from terragrunt")
}
11 changes: 11 additions & 0 deletions demo/casts/fixtures/terragrunt-native/modules/demo/main.tf
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
variable "greeting" {
type = string
}

resource "terraform_data" "demo" {
input = var.greeting
}

output "greeting" {
value = terraform_data.demo.output
}
31 changes: 31 additions & 0 deletions demo/casts/scripts/validate-terragrunt-native.star
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
"""Check actual CLI output in the native Terragrunt recording."""

load("../cast_checks.star", "load_text", "strip_ansi", "assert_no_error_output", "assert_no_local_paths", "assert_colored")


def validate():
text = load_text("../../website/static/casts/demo/fixtures/terragrunt-native/plan.cast")
plain = strip_ansi(text)
assert_no_error_output(text)
assert_no_local_paths(text)
assert_colored(text, "Plan:")
# Commands alone are not proof: require the inventory and real engine plan.
for needle in [
"components.terraform.terragrunt.discovery.enabled true",
"atmos list stacks",
"atmos list instances",
"Component", "Stack", "Type", "Engine", "opentofu",
"atmos terraform plan demo -s live",
"terraform_data.demo",
"HELLO FROM TERRAGRUNT",
"Plan: 1 to add, 0 to change, 0 to destroy.",
]:
if needle not in plain:
fail("native Terragrunt cast missing {!r}".format(needle))
for marker in ["Error:", "unknown flag", "rpc error", "exit status 1"]:
if marker in plain:
fail("native Terragrunt cast contains {!r}".format(marker))
ui.success("Native Terragrunt discovery and plan cast validated")


validate()
23 changes: 23 additions & 0 deletions docs/prd/plugins/authoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,29 @@ SDK development stays in this repository under the nested `sdk/` module. `atmos

Author testing, local `path` packages, publishing, and signing are also subject to [plugin policies](policy.md). A company policy that denies local development must explicitly permit the author workflow in its trusted development environment.

## Package identity and repository naming

Use `<publisher>/<package>` for `metadata.name`. The publisher maintains the Atmos integration. Use the product name for the package and its default consumer alias. For a standalone source repository, use `atmos-plugin-<package>` to identify its purpose outside the Atmos catalog. The repository prefix is not part of the package ID.

| Purpose | Terragrunt example |
|---|---|
| Package ID (`metadata.name`) | `cloudposse/terragrunt` |
| Default product alias (`plugins.packages.<alias>`) | `terragrunt` |
| Source repository (`metadata.repository`) | `https://github.com/cloudposse/atmos` |
| Source directory | `plugins/terragrunt` |
| Release location | Explicit OCI reference, recorded with its digest in the lockfile |
| Standalone repository, if created | `cloudposse/atmos-plugin-terragrunt` |

The independently versioned package is the identity unit. Several packages can share a source repository. Moving a package to a standalone repository must not require consumers to change its ID or alias. Repository naming is an authoring convention, not a requirement to move existing plugins out of the monorepo.

This follows [Terraform's distinction between provider addresses and local names](https://developer.hashicorp.com/terraform/language/providers/requirements). Terraform's public registry uses a separate [`terraform-provider-<name>` repository convention](https://developer.hashicorp.com/terraform/registry/providers/publishing). [TFLint](https://github.com/terraform-linters/tflint/blob/master/docs/user-guide/plugins.md) also uses a short plugin name, but its installation source directly identifies a repository and its name determines the executable. Atmos uses OCI package releases, so its identity does not require one Git repository per plugin.

Toolchain's `owner/repo` identifies the executable distribution; a plugin's `publisher/package` identifies the Atmos integration. For example, `gruntwork-io/terragrunt` is the toolchain product, while `cloudposse/terragrunt` is Cloud Posse's integration. Both can use `terragrunt` as a short name within their respective configuration sections. Consumers can override the plugin alias with `plugin install --as`; the alias does not rename the package or its exported capabilities.

The installer uses the product name as the default alias for a new declaration and requires an explicit alias on a collision. Plugin management has not appeared in a stable release, so the product alias is the only default and needs no edition journal entry; existing declarations always retain their names.

A registry alias selects a discovery source and is separate from the publisher namespace. The installation selector `<registry-alias>/<package-id>` can therefore contain three segments, such as `team/acme/oidc`. Do not interpret the package ID as a GitHub URL or infer an OCI location from it. The configured source and lockfile identify the release; signature and publisher policy establish trust. Identical package names from different sources must not cause silent source substitution.

## Scaffold a separate plugin repository (broader contract example)

```shell
Expand Down
Loading
Loading