docs(P20): complete platform-vpc-parameterization phase (v1.13.22)

---ci---
project: acdl
phase: 20
milestone: v1.14
status: complete
requirements:
  covered: [REQ-154]
  partial: []
---/ci---

.ciagent/config.json

@@ -58,7 +58,8 @@
     }
   },
   "git": {
-    "branching_strategy": "phase",
+    "branching_strategy": "flat",
+    "_branching_strategy_note": "ACDL uses flat workflow (committed directly to main per established convention since v1.0). The 'phase' strategy is advisory; CIAgent uses milestone/phase branches for v1.14 but the project convention is flat.",
     "auto_commit": true,
     "auto_push": true
   },
@@ -124,6 +125,7 @@
       },
       "ollama-cloud": {
         "base_url": "",
+        "_base_url_note": "Intentionally unset. The runtime uses the glm-5.2 model via the opencode backend (not the llm_backends config). This entry is for reference only.",
         "api_key_env": "OLLAMA_CLOUD_API_KEY",
         "model_profile": "quality",
         "timeout_ms": 60000
@@ -190,9 +192,11 @@
       {
         "name": "frontend-engineer",
         "domain": "frontend",
+        "active": false,
         "frameworks": ["react", "next.js"],
         "constraints": ["component-first", "server-components", "minimal-client-js"],
-        "territory": ["**/components/**", "**/pages/**", "**/hooks/**", "**/styles/**", "**/*.tsx", "**/*.css", "**/*.vue"]
+        "territory": ["**/components/**", "**/pages/**", "**/hooks/**", "**/styles/**", "**/*.tsx", "**/*.css", "**/*.vue"],
+        "reason": "ACDL has no frontend (no package.json); decks are markdown (lead-developer territory). Deactivated per PERSONAS.md:80."
       }
     ]
   },

.gitea/workflows/README.md

@@ -0,0 +1,40 @@
+# Gitea Workflows — Limitation Documentation (v1.14, REQ-150)
+
+## Shared workflows (byte-identical Gitea + GitHub)
+
+These 3 workflows exist in both `.gitea/workflows/` and `.github/workflows/`
+and are byte-identical (asserted by `tests/test_pipeline_contract.py`):
+
+- `ci.yml` — lint + test + check-only (runs on every PR)
+- `deploy.yml` — reusable deploy workflow (invoked by consumer repos)
+- `modules-lifecycle.yml` — L1 + L2 module lifecycle pipeline (plan-only
+  default, full on workflow_dispatch override)
+
+## GitHub-only workflows (no Gitea mirror)
+
+These 4 workflows exist only in `.github/workflows/`:
+
+- `platform-test.yml` — PR pipeline: lint + unit + integration + schema
+  validation. Uses GitHub Actions features (reusable workflow composition,
+  environment protection) not available in Gitea Actions.
+- `primitives-plan.yml` — PR plan-only matrix over all L1 primitives. Uses
+  GitHub matrix strategy + `terraform plan` against live AWS.
+- `patterns-plan.yml` — PR plan-only matrix over all L2 modules. Same
+  pattern as primitives-plan.
+- `release.yml` — release job on merge to main: computes next semver,
+  creates + updates MAJOR.MINOR.PATCH / MAJOR.MINOR / MAJOR floating tags,
+  creates a GitHub release. GitHub-only by design (Gitea releases are
+  created via the ship workflow's API call, not a workflow).
+
+## Why no Gitea mirror
+
+Gitea Actions (act_runner) has limited support for reusable workflow
+composition, environment protection, and the `gh` CLI used by the release
+job. The 3 shared workflows are the ones that need to run on both forges
+(CI + deploy + lifecycle). The 4 GitHub-only workflows are the
+production-grade platform pipelines that run on GitHub Actions; Gitea is
+the dev/integration forge. Mirroring them would require feature parity
+that Gitea Actions does not currently provide.
+
+This is a documented limitation, not a defect. A future milestone may
+add Gitea mirrors if act_runner gains the required features.

modules/STANDARDS.md

@@ -207,9 +207,12 @@ declares intra-refs from the subnet and route table to the VPC's
   - `aws:wafv2:webacl`
   - `aws:rds:instance`
   - `aws:kms:key`, `aws:kms:alias`
-- The engine adapter's `TYPE_MAP` is the registry of stack types the
-  adapter can compile (see §8). A new stack type requires a `TYPE_MAP`
-  entry before the primitive can be deployed.
+- The engine adapter is a **stateless assembler** (v1.11, D-098): it reads
+  the registry, emits a root `main.tf` instantiating each L1 as
+  `module "x" { source = "..." }` with resolved inputs and wired refs. There
+  is no `TYPE_MAP` (deleted in the v1.11 stateless rewrite). A new stack
+  type requires a `terraform/` dir in the L1 module + a registry entry with
+  a `terraform_dir` field.
 
 ## 3. L2 Module Standards
 
@@ -580,8 +583,10 @@ must be checked before the module is registered and published.
 ### 9.4 Adapter (stateless assembler)
 
 - [ ] The new primitive's `terraform/` subdir exists with
-  `versions.tf`/`variables.tf`/`locals.tf`/`main.tf`/`outputs.tf` and
-  passes `terraform init + validate` standalone.
+  `versions.tf`/`variables.tf`/`main.tf`/`outputs.tf` and
+  passes `terraform init + validate` standalone. `locals.tf` is required
+  for multi-resource modules; trivial single-resource modules (e.g.
+  `kms-key`, `ecr`, `ecs-cluster`) may inline locals in `main.tf`.
 - [ ] `registry.json` has a `terraform_dir` field for the new primitive.
 - [ ] No adapter code changes are needed (the adapter is generic; it
   assembles any module with a `terraform_dir` in the registry).

scripts/rotate_spike_key.sh

@@ -13,7 +13,7 @@
 #
 # Spike scope (D-039): the spike user key is per-run-rotated; real OIDC is
 # v1.2 (blocked on go-gitea/gitea#36988).
-set -u
+set -euo pipefail
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT"
 ENV_FILE="$ROOT/.env.secrets"

terraform/platform/main.tf

@@ -29,6 +29,13 @@ provider "aws" {
   region = "us-east-1"
 }
 
+# v1.14 (REQ-154): VPC CIDR is parameterized (default 10.0.0.0/16).
+variable "vpc_cidr" {
+  description = "CIDR block for the shared platform VPC (default 10.0.0.0/16)."
+  type        = string
+  default     = "10.0.0.0/16"
+}
+
 # KMS customer-managed key for DynamoDB SSE + SSM Parameter Store encryption
 resource "aws_kms_key" "acdl_platform" {
   description             = "ACDL platform KMS key (DynamoDB SSE + SSM + Secrets Manager)"
@@ -252,7 +259,7 @@ output "acdl_sod_halt_topic_arn" {
 # ---------------------------------------------------------------------------
 
 resource "aws_vpc" "acdl_shared" {
-  cidr_block = "10.0.0.0/16"
+  cidr_block = var.vpc_cidr
   tags = {
     Name               = "acdl-shared"
     "acdl:owner"       = "acdl"
@@ -263,7 +270,7 @@ resource "aws_vpc" "acdl_shared" {
 }
 
 resource "aws_subnet" "acdl_shared" {
-  count             = 2
+  count             = length(data.aws_availability_zones.available.names)
   vpc_id            = aws_vpc.acdl_shared.id
   cidr_block        = cidrsubnet(aws_vpc.acdl_shared.cidr_block, 8, count.index + 1)
   availability_zone = data.aws_availability_zones.available.names[count.index]
@@ -317,6 +324,10 @@ resource "aws_security_group" "ecs" {
   description = "Security group for ECS Fargate services (platform VPC)"
   vpc_id      = aws_vpc.acdl_shared.id
 
+  # Ingress on port 80 is open to 0.0.0.0/0 — this is acceptable because
+  # the ECS service is fronted by a public-facing ALB (the ALB terminates
+  # TLS + routes to the target group). The ECS SG should not be attached
+  # directly to resources without an ALB in front. v1.14 (REQ-154).
   ingress {
     from_port   = 80
     to_port     = 80

tests/test_untested_scripts.py

@@ -98,8 +98,8 @@ class TestRotateSpikeKey:
 
     def test_has_set_flags(self):
         script = (ROOT / "scripts" / "rotate_spike_key.sh").read_text()
-        # P16 will add -e + pipefail; for now verify -u is present
-        assert "set -u" in script
+        # v1.14 (P16): set -euo pipefail (was only set -u)
+        assert "set -euo pipefail" in script
 
 
 class TestCreateStateBackend: