Files
acdl/modules-ir/l1/l1-vpc
Jon Chery 699aa542df docs(P15): plan-as-execute + verify (v1.2.5, PARTIAL — terraform apply blocked by IAM)
---ci---
project: acdl
phase: 15
milestone: v1.2
status: verify
verdict: PARTIAL
requirements:
  covered: [REQ-34]
  partial: [REQ-33]
blocker:
  - id: P0-IAM
    description: terraform apply fails with AccessDenied on ECS/ECR/IAM/EC2 — live spike_runner_policy.json not pushed (root key deactivated per D-034)
    unblock: operator runs create_iam_user.py with root/admin creds to push the expanded policy, then terraform apply succeeds (plan valid, 13 to add)
---/ci---

Phase 15 plan-as-execute + verify. PARTIAL: terraform apply blocked by IAM.
- Consumer microservice content authored (app.py + Dockerfile + README.md).
- Docker image acdl-microservice:latest built.
- Adapter fixed: ref emission (bare), JSON-string jsonencode, ECS service
  network_configuration/load_balancer/desired_count/launch_type/task_definition,
  listener default_action/load_balancer_arn, target group target_type/vpc_id/protocol,
  VPC tags (not name), IGW + route table association, managed_policy_arns list.
- L1 fixes: l1-ecs-service (removed port from service sub-resource),
  l1-vpc (added intra_refs, removed igw_id output).
- Resolver: intra_refs resolution (refs between sub-resources of same L1).
- terraform validate + plan succeed (13 to add).
- terraform apply BLOCKED (AccessDenied — live IAM policy not updated).
- Evidence event TERRAFORM_APPLY_BLOCKED written to DynamoDB outbox.
- v1.1 S3 regression: byte-identical.
Ready to ship v1.2.5 (partial).
2026-07-21 22:21:36 +00:00
..

l1-vpc — VPC primitive (multi-resource L1)

An L1 module for a VPC with subnets and a route table. Substrate-agnostic (the IR types are aws:ec2:vpc, aws:ec2:subnet, aws:ec2:routetable, not Terraform resource types). This is a multi-resource L1: the interface declares the group's inputs/outputs plus a resources array listing the IR types it emits. The IR instance (Phase 14/15) will have multiple resources entries all with module: "l1-vpc@1.0.0".

Interface (the IR-typed contract)

See interface.json: inputs cidr (string, e.g. "10.0.0.0/16"), azs (string, comma-separated, e.g. "us-east-1a,us-east-1b"), name (string, used for tagging), region (string); outputs vpc_id (string), subnet_ids (string, comma-separated), igw_id (string); no NFRs.

The resources array lists the emitted IR types:

  • aws:ec2:vpc — the VPC itself (cidr → cidr_block, name → tag).
  • aws:ec2:subnet — one subnet per availability zone (azs split on comma); inputs include the parent VPC id.
  • aws:ec2:routetable — route table bound to the VPC with an internet gateway + default route (0.0.0.0/0 → igw).

IR → Terraform mapping (performed by the adapter)

The Terraform adapter (adapters/terraform/adapter.py) translates each emitted IR resource to Terraform:

IR Terraform
resource.type = aws:ec2:vpc resource "aws_vpc" "<id>" { ... }
resource.inputs.cidr cidr_block = <value> arg
resource.inputs.name tags = { Name = <value> } (emit as-is)
resource.outputs.vpc_id output "vpc_id" { value = aws_vpc.<id>.id }
resource.type = aws:ec2:subnet resource "aws_subnet" "<id>" { ... }
resource.inputs.cidr cidr_block = <value> arg
resource.inputs.az availability_zone = <value> arg
resource.outputs.subnet_id output "subnet_id" { value = aws_subnet.<id>.id }
resource.type = aws:ec2:routetable resource "aws_route_table" "<id>" { ... }
resource.inputs.vpc_id vpc_id = <value> arg

The internet gateway + default route are emitted as part of the route table resource's IR (the igw_id output is wired via the route table's inputs). The adapter is a thin layer (ARCHITECTURE.md §12.2); it does not own L1 content — it only translates.

Versioning (W3.D)

1.0.0 — interface MAJOR, behavior MINOR, lifecycle PATCH. MAJOR bumps require a new registry entry (immutable publication); old entries enter a 12-month deprecation window.