feat: opt-in published Terraform modules from approved sources (iteration 8)

Infrastructure code is plain resources by default. An Execution may opt in
with terraform_modules; the deployment default is TERRAFORM_MODULES, off.

- A module is accepted only from the registry namespaces the provider bundle
  lists (terraform-google-modules), at one exact version. Any other source is
  refused before Terraform runs; until now nothing stopped generated code
  naming any source for terraform init to download.
- terraform_module looks up a module's inputs, outputs and submodules from
  the registry and says when it cannot be used with the pinned provider.
- skills/google-cloud-iac-modules: when a module fits, and four modules with
  examples a test validates against hashicorp/google 8.6.0.
- Opted in, the IaC author and validator get the Skill and the lookup. Not
  opted in, they get neither and a module block is refused in code.
- A Change request follows its Baseline. execution.json records the choice.
- case-07 runs case 03's request with modules opted into.

Azure (aztfm) and AWS (terraform-aws-modules) sources are recorded in the
plan for when those Cloud providers are added. No case has run with this.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-09 22:09:29 +01:00
parent a8ed21b89d
commit ef37f59bad
35 changed files with 1482 additions and 7 deletions

View File

@@ -30,6 +30,7 @@ from pathlib import Path, PurePosixPath
from typing import Any
from app.adk.runtime import FILES_SCHEMA, ToolResult, ToolSpec, files_from_argument
from app.tools.modules import ModuleLookup, allowed_namespaces, check_module_sources
_MAX_OUTPUT = 8_000
_MAX_OUTLINE = 4_000 # one resource type, when several are looked up together
@@ -98,6 +99,10 @@ class TerraformRunner:
# The providers the schema lookup answers for, as the provider bundle pins them:
# {local name: {"source": ..., "version": ...}}.
providers: Mapping[str, Mapping[str, str]] = field(default_factory=dict)
# Registry namespaces a `module` may come from, as the provider bundle lists
# them. `terraform init` downloads and evaluates whatever a source names, so
# with none listed every module call is refused.
module_namespaces: tuple[str, ...] = ()
# Terraform's plugin cache is not safe for concurrent installs.
_init_lock: asyncio.Lock = field(default_factory=asyncio.Lock, repr=False)
_schema_lock: asyncio.Lock = field(default_factory=asyncio.Lock, repr=False)
@@ -138,7 +143,9 @@ class TerraformRunner:
)
async def validate(self, files: Mapping[str, str]) -> ToolResult:
refusal = _check_files(files)
refusal = _check_files(files) or check_module_sources(
files, allowed_namespaces(self.module_namespaces)
)
if refusal:
return refusal
with tempfile.TemporaryDirectory(prefix="tf-validate-") as tmp:
@@ -153,7 +160,9 @@ class TerraformRunner:
async def plan(
self, files: Mapping[str, str], variables: Mapping[str, str] | None = None
) -> ToolResult:
refusal = _check_files(files)
refusal = _check_files(files) or check_module_sources(
files, allowed_namespaces(self.module_namespaces)
)
if refusal:
return refusal
variables = dict(variables or {})
@@ -582,6 +591,16 @@ LOCAL_TOOLS: dict[str, tuple[str, str]] = {
"cloud_read",
"Preview Terraform against the live cloud environment with a plan. Never applies.",
),
"terraform_module": (
"general",
(
"Look up a published Terraform module: its inputs, outputs and "
"submodules, and whether it works with the pinned provider. Give "
"`source` as <namespace>/<name>/<provider>, with //modules/<name> for "
"a submodule. `version` is optional and defaults to the latest. `find` "
"narrows the inputs to those matching the words given."
),
),
"terraform_schema": (
"general",
(
@@ -651,6 +670,32 @@ def local_tools(
"terraform_plan": lambda: checks(
"terraform_plan", _with_files(runner.plan, working_copy)
),
"terraform_module": lambda: ToolSpec(
"terraform_module",
LOCAL_TOOLS["terraform_module"][1],
{
"type": "object",
"properties": {
"source": {
"type": "string",
"description": (
"For example terraform-google-modules/network/google"
),
},
"version": {"type": "string", "description": "Such as 18.3.1"},
"find": {
"type": "string",
"description": "Words to look for in input names, comma-separated",
},
},
"required": ["source"],
},
ModuleLookup(
namespaces=runner.module_namespaces,
pinned={name: pin["version"] for name, pin in runner.providers.items()},
).describe,
tier="general",
),
"terraform_schema": lambda: ToolSpec(
"terraform_schema",
LOCAL_TOOLS["terraform_schema"][1],