docs(P47): presentation slide updates + HIPAA removal from all docs

Presentation changes (both Marp decks + source markdown):
1. Title slide: deck title as H1 (slightly bigger), 'Agentic Cloud Delivery
   Platform' as H3 subtitle — cleaner title hierarchy
2. DX deck: removed Local Reproducibility slide (not beneficial for DX)
3. DX deck: Safe Promotion Path slide redesigned with side-by-side layout
   for Approaches A and B (HTML table, two columns)
4. DX deck: 'an agent' → 'an AI agent' (slide 2 + Citizen Developer slide)
5. DX deck: What a Developer Does — diagram floated to the right side
6. Header simplified to just the deck name (subtitle now on title slide)

HIPAA removal (25 files):
- Completely removed all HIPAA references from all markdown documentation,
  presentation source files, module READMEs, and rendered HTML
- Removed HIPAA from compliance milestone lists (GDPR, SOX, SOC2, DORA remain)
- Removed HIPAA section references (§164.xxx) from compliance annotations
- Cleaned up empty parentheses and broken commas left by removal
- Re-rendered both HTML decks from updated Marp source

---ci---
phase: 47
milestone: v1.9
status: complete
requirements:
  covered: []
  partial: []
---/ci---

.ciagent/ARCHITECTURE.md

@@ -248,7 +248,7 @@ The spike (Phases 08–10) materializes the **minimum** that proves the IR
 commitments hold (no polyglot mess):
 
 - One L1: `l1-s3` (IR-typed interface; the only AWS resource in the spike).
-- One L2 thin-composition: `l2-static-asset` (references `l1-s3` only).
+- One L2 thin-composition: `l2-static-assets` (references `l1-s3` only).
 - Terraform adapter: IR → `terraform plan` against AWS via OIDC.
 - One contract submission → contract→IR → `terraform plan` → Checkov
   `PolicyCheckResult` → confidence signal → evidence event to the DynamoDB
@@ -297,5 +297,217 @@ ACDL has no `package.json`. The verification gate substitutes:
 2. Phase 07 — finalize architecture v1.0; author schemas + designs.
 3. Phase 08 — AWS OIDC bootstrap (use temp key once, rotate).
 4. Phase 09 — IR + `l1-s3` + Terraform adapter → `terraform plan`.
-5. Phase 10 — `l2-static-asset` + contract→IR → end-to-end spike.
-6. COMPLETE gate — review → ship `v1.2.0` → audit.
+5. Phase 10 — `l2-static-assets` + contract→IR → end-to-end spike.
+6. COMPLETE gate — review → ship `v1.2.0` → audit. **DONE.**
+
+## v1.2 build-out scope
+
+v1.2 takes the v1.1 spike (dev-only, `plan`-only, single S3 L1) to a real,
+simpler, better-documented platform that delivers a microservice to AWS ECS
+Fargate end-to-end. The locked architecture (§1–§12) is unchanged — v1.2
+extends the *implementation*, not the design.
+
+### In scope (five axes, user-directed 2026-07-21)
+
+1. **Re-evaluate the current state.** go-gitea/gitea#36988 (OIDC for Gitea
+   Actions) re-checked 2026-07-21: still **open** (last updated 2026-05-27,
+   not merged). Real OIDC remains deferred to v1.3+; v1.2 extends the D-039
+   per-run-rotated-key waiver as **D-047**. The waiver continues to satisfy
+   §12.5's *intent* (no *persistently* long-lived key): the spike key is
+   rotated after each run by `scripts/rotate_spike_key.sh`, and Phase 12
+   tightens the IAM scoping + rotation hygiene.
+2. **NFR improvements on the existing spike.** Least-privilege IAM audit of
+   `spike_runner_policy.json`; idempotent `create_state_backend.py` /
+   `create_iam_user.py`; proper exit codes / error handling; P1-1 redaction
+   (two AWS access key IDs in `.ciagent/VERIFY.md` Phase 09 narrative).
+3. **Streamline / simplify the current setup.** Consolidate
+   `run_spike_plan.sh` + `run_spike_e2e.sh` into one
+   `scripts/run_platform.sh`; remove dead code and stale `platform/` paths.
+4. **README.md fully up to date on how the platform works.** Reflect v1.1
+   complete; document the actual spike flow, `scripts/run_platform.sh`, the
+   real repo layout, and the v1.2 objective.
+5. **Bootstrap a consumer repo with a basic microservice deployed to ECS
+   end-to-end.** New Gitea repo `acdl-consumer-microservice` (org
+   `continuous-intelligence`); new IR-typed L1s (`l1-vpc`, `l1-ecs-cluster`,
+   `l1-ecs-service`, `l1-iam-role`, `l1-alb`, `l1-ecr`); new
+   `l2-microservice` thin-composition; one contract submission →
+   `terraform apply` (dev, autonomous per §10, confidence ≥ 0.50) → a live
+   ECS Fargate service serving HTTP 200 → evidence event to the DynamoDB
+   outbox → acdl-evidence timeline.
+
+### Substrate extension (ECS Fargate)
+
+The Terraform adapter (§12) remains the only substrate-specific code. v1.2
+expands the adapter `TYPE_MAP` to cover the six new ECS-shaped IR resource
+types. The L1 interface shape (IR-typed inputs/outputs/NFRs, registered in
+`modules-ir/registry.json`) is unchanged — only the set of registered L1s
+grows. The IR commitments (REQ-28) continue to hold: `modules-ir/`,
+`schemas/`, `contracts/`, `core/confidence_signal.py`,
+`core/contract_resolver.py`, `core/outbox_writer.py`
+remain substrate-agnostic.
+
+### `terraform apply` (dev only)
+
+v1.2 lifts the substrate execution from `plan` to `apply` for the `dev`
+environment only. Dev is autonomous per §10 (confidence ≥ 0.50, no HITL).
+`apply` for qa/prod/dr remains HITL-gated and out of scope for v1.2. The
+apply result (resources created, plan diff) is captured in the evidence
+stream as a `terraform.apply` event.
+
+### Out of scope for v1.2 (deferred to v1.3+)
+
+| Feature | Reason |
+|---------|--------|
+| Real OIDC federation | go-gitea/gitea#36988 still open. v1.2 extends D-039 waiver (D-047); real OIDC is v1.3+. |
+| Full HITL matrix wiring (qa/prod/dr) | v1.2 is dev-only autonomous `apply`; HITL wiring is v1.3. |
+| Kyverno + OPA policy engines | v1.2 keeps Checkov only; Kyverno/OPA are v1.3. |
+| MCP skill catalog + real L3B agent | v1.2 keeps the L3B stub; the 5-skill catalog is v1.3. |
+| Audit ledger build-out (S3 Object Lock + JWS + async worker + DLQ + daily checkpoints) | v1.2 keeps the v1.1 outbox; the regulatory ledger is v1.3. |
+| Multi-region state / outbox | Single-region in v1 (§9, §12.3); multi-region is v1.3+. |
+| Prod/dr environments | v1.2 is dev-only; prod/dr are v1.3. |
+| GitOps reconciler (ArgoCD/Flux) | v1.3+. |
+
+## Build order (v1.2)
+
+1. Phase 11 — re-eval #36988 + NFR audit + simplification findings + README rewrite.
+2. Phase 12 — NFR harden + simplify (idempotent bootstrap, one `run_platform.sh`, IAM audit, redactions).
+3. Phase 13 — six ECS L1s + adapter `TYPE_MAP` expansion.
+4. Phase 14 — `l2-microservice` + contract schema extension.
+5. Phase 15 — consumer repo + `terraform apply` (dev) → live ECS service.
+6. Phase 16 — capstone e2e: consumer commit → live HTTP 200 → evidence → timeline.
+7. COMPLETE gate — review → ship `v1.3.0` → audit.
+
+## v1.8 Architecture Addendum
+
+> Milestone v1.8 (complete, tag `v1.8.0`). Adds encryption-by-default,
+> deletion-protection-by-default, uptime monitoring, decommission alias,
+> engineering standards, and path documentation.
+
+### New Primitives
+
+- **`kms-key`** (`aws:kms:key`) — Per-stack customer-managed KMS key with
+  `enable_key_rotation = true`. One key per L2 deployment (no shared keys).
+  Wired into both L2 compositions as a child, with its `kms_key_arn` output
+  connected to all children's `kms_key_arn` input. Adapter emits
+  `aws_kms_key` + `enable_key_rotation`.
+- **`uptime`** (`aws:ecs:uptime-service`) — Uptime-kuma on ECS Fargate with
+  a feature flag (`feature_flag_enabled`), monitored endpoints (HTTP/DNS/TCP),
+  alert channels (Teams/email/SMS/GitHub issues). Deployed by default after
+  any L2 module with a separate terraform state. When the feature flag is
+  false, the adapter emits no resources.
+
+### Encryption by Default
+
+All 12 L1 primitives have `encryption_enabled` NFR (default true). Primitives
+with at-rest data (s3, rds, ecr, ecs-service, ecs-cluster) have an optional
+`kms_key_arn` input. The adapter emits encryption blocks (SSE-KMS for S3,
+storage_encrypted for RDS, encryption_configuration for ECR) referencing the
+per-stack CMK when provided. Managed KMS fallback with stderr warning for
+standalone L1 deployments.
+
+### Deletion Protection by Default
+
+All 12 L1 primitives have `deletion_protection` NFR (default true). The
+adapter emits `lifecycle { prevent_destroy = true }` when true. L2 modules
+expose a `features.deletion_protection` flag (default true) propagated to
+all children via the resolver. Setting `inputs.deletion_protection: false`
+in the contract disables it for the whole stack.
+
+### Decommission Alias
+
+A `mode: decommission` on the deploy pipeline implements a 2-step destroy:
+1. Disable deletion protection (resolve with `deletion_protection: false`,
+   terraform plan/apply, HITL SRE gate via GitHub environment).
+2. Zero counts + destroy (`decommission_transform` zeroes all scalable counts,
+   terraform plan/apply, second HITL SRE gate).
+
+CMDB validation via DynamoDB `acdl-change-requests` table. The Lambda
+`validate_change_request` action queries the table and asserts
+`status == "approved"` + `consumerRepo` match.
+
+### Adapter Expansion
+
+TYPE_MAP grew from 16 to 19 entries (+ `aws:kms:key`, `aws:kms:alias`,
+`aws:ecs:uptime-service`). Specialized emission branches added for KMS key
+rotation, S3 SSE-KMS configuration, uptime ECS Fargate task, and
+`prevent_destroy` lifecycle on all resources.
+
+### Pipeline Stages
+
+The deploy pipeline grew from 8 to 9 stages (+ `deploy-uptime` after
+`publish-outputs`). The `deploy-uptime` stage constructs a synthetic uptime
+contract from the L2 stack outputs, resolves + adapts it to a separate
+terraform state directory, and publishes the uptime URL via PR comment.
+
+### Forge-Agnostic API URLs
+
+The platform Lambda (`contract_ingestor.py`) reads `GITHUB_API_BASE` env
+for forge-agnostic API URLs. GitHub uses `/search/issues`; Gitea uses
+`/repos/{owner}/{repo}/issues`. Detection via `/api/v1` in the base URL.
+
+## v1.9 Addendum (2026-07-23)
+
+### New Components
+
+- **`core/contract_resolver.py` interpolation** (D-081): the resolver
+  now expands `${env.<field>}` + `${contract.<field>}` tokens
+  post-schema-validation, pre-IR-resolution. The env context is the
+  loaded environment onboarding JSON (`core/environments/<name>.json`,
+  schema `schemas/environment.schema.json`). The resolver's
+  `child_input_map` routes L2 wires to the sub-resource that declares the
+  input (P1-1 — `desired_count` → `aws:ecs:service`, `family` →
+  `aws:ecs:task_definition`).
+- **`core/environment_check.py` `load()`** (REQ-104): loads + returns the
+  parsed environment JSON; emits a stderr warning for placeholder
+  `account_id` when env != dev.
+- **`core/hitl_gates.py`** (REQ-108, D-084): the HITL pre-execution
+  attestation gate. Records the approver identity to the DynamoDB outbox
+  (`approver_qa`/`approver_prod`/`approver_dr`), runs the separation-of-
+  duties check on prod, invokes the attestation matrix, returns
+  `(ok, reason)`. Dev skips (autonomous). `run_platform.sh` calls
+  `attest` before apply for qa/prod/dr.
+- **`core/attestation_matrix.py`** (REQ-109, D-084): the 8-concern
+  attestation matrix from `hitl_matrix_design.md` §10.4. Offline-testable
+  concerns (contract NFRs, schema validity, policy pass) run for real;
+  operator-supplied concerns accept signed evidence artifacts validated
+  for freshness + schema. Signature verification skips when
+  `ACDL_ATTESTATION_SIGNING_KEY_ID` is unset (D-089).
+- **`core/separation_of_duties.py` `route_halt_artifact`** (REQ-107):
+  real SNS publish (`acdl-sod-halt` topic, ARN from
+  `ACDL_SOD_HALT_TOPIC_ARN`) + outbox fallback
+  (`SEPARATION_OF_DUTIES_VIOLATION` event). The SNS topic is defined in
+  `terraform/platform/main.tf`.
+- **`adapters/wiz/wiz_adapter.py` `WizClient`** (REQ-110): real GraphQL
+  API client (`<WIZ_API_URL>/graphql`, Bearer auth, pagination via
+  `pageInfo.hasNextPage`). `fetch_and_adapt` translates issues →
+  `PolicyCheckResult`. Graceful degrade when unconfigured.
+- **`adapters/kyverno/kyverno_adapter.py`** (REQ-111): fleshed-out
+  `PolicyReport` → `PolicyCheckResult` mapping (pass/fail/skip/warn +
+  severity + skip-with-reason + resource construction). Inactive-for-TF
+  guard preserved.
+
+### Per-Environment Promotion (D-082)
+
+The deploy workflow (`.github/workflows/deploy.yml` +
+`.gitea/workflows/deploy.yml`, byte-identical) declares an `environment`
+`workflow_call` input. When non-empty, `run_platform.sh --environment
+<name>` overrides the contract's `environment` field before schema
+validation (D-088). One CI job per environment; promotion = running the
+matching job, no `environment:` field editing. Per-env contract files
+(`contracts/<module>.<env>.yaml`) use interpolation for env-specific
+values.
+
+### Adapter Parameterization (P1-1, D-085)
+
+The adapter (`adapters/terraform/adapter.py`) reads ECS/ALB/VPC defaults
+from L1 `interface.json` inputs (`desired_count`, `launch_type`,
+`family`, `target_type`, `load_balancer_type`, `name`). The adapter is a
+thin translator; the `child_input_map` routes wires to the declaring
+sub-resource.
+
+### Deferred (D-083)
+
+S3 Object Lock + JWS detached signatures + async worker + DLQ + daily
+checkpoints (audit ledger build-out) — deferred to a future milestone.
+The hash-chain + DynamoDB-outbox path remains the v1.9 production audit
+record.

.ciagent/AUDIT.md

@@ -0,0 +1,63 @@
+# ACDL v1.9 — Audit Report
+
+> Audit date: 2026-07-23. Auditor: ci-debugger. Milestone: v1.9. Result: PASS.
+
+## Step 1: Reconstruction Test
+
+- 16 v1.9 commits with `---ci---` blocks (specify → clarify → research →
+  plan → execute ×4 phases → verify/complete → review-fix).
+- Reconstructed state: milestone v1.9, phase 43, status complete.
+- Pipeline stages traversed: specify → clarify → research → plan → execute → verify → complete.
+- Decisions D-080..D-089 all present in git log + `.ciagent/` files.
+- config.json (v1.9 complete), PROJECT.md (v1.9 complete), REQUIREMENTS.md
+  (v1.9 complete, 12 reqs), ROADMAP.md (v1.9 complete, phases 39–43),
+  REVIEW.md (READY TO SHIP), PERSONAS.md (v1.9), VERIFY.md, AUDIT.md.
+**PASS.**
+
+## Step 2: File Discipline
+
+- `.ciagent/config.json`: valid JSON; mode, projects[] present. **PASS.**
+- `.ciagent/PROJECT.md`: Vision/Core Value (≡ "What This Is"), Key
+  Decisions (v1.9 D-080..D-086), Requirements, Constraints, per-milestone
+  Objective sections (≡ "Milestones") present. Section names follow the
+  v1.0 established conventions (not the generic audit template). **PASS.**
+- `.ciagent/ROADMAP.md`: phases 39–43 present; all marked complete.
+  **PASS.**
+- `.ciagent/REQUIREMENTS.md`: v1.9 traceability table complete (12/12
+  REQ-100..111 marked `complete (v1.9.0)`). **PASS.**
+- `.ciagent/ARCHITECTURE.md`: **fixed during audit** — v1.9 addendum
+  added covering all new components (contract_resolver interpolation,
+  environment_check.load, hitl_gates, attestation_matrix,
+  separation_of_duties.route_halt_artifact, WizClient, kyverno_adapter,
+  per-environment promotion, adapter parameterization, deferred D-083).
+  All 9 v1.9 code components now referenced. **PASS (after fix).**
+
+## Step 3: Branch Hygiene
+
+- Local: `main` only. Remote: `origin/main` only.
+- No phase or milestone branches remain (all 5 v1.9 phase branches merged
+  + pruned during the run/ship workflow).
+- No orphan branches.
+**PASS.**
+
+## Step 4: Commit Discipline
+
+- 16/16 v1.9 commits have `---ci---` blocks with project/phase/milestone/
+  status fields.
+- No stale implementation decisions (D-081..D-085, D-087..D-089 all have
+  code refs; D-080 + D-086 are process/meta decisions correctly living in
+  `.ciagent/` files).
+- No unresolved v1.9 escalations (the 3 `audit(...)` commits in history
+  are from prior milestones v1.0/v1.6/v1.7).
+**PASS.**
+
+## Issues fixed during audit
+
+1. **ARCHITECTURE.md missing v1.9 addendum** — the architecture doc had
+   no coverage of the v1.9 new components (hitl_gates, attestation_matrix,
+   interpolation, per-env promotion, adapter parameterization, Wiz/Kyverno
+   flesh-outs). Fixed: added a v1.9 addendum section covering all 9 new
+   code components + the per-env promotion model + the deferred D-083
+   items. Verified all 9 components now referenced.
+
+## Audit result: PASS

.ciagent/PERSONAS.md

@@ -1,10 +1,10 @@
 ---
 project: acdl
-milestone: v1.1
-generated_at: 2026-07-21
+milestone: v1.9
+generated_at: 2026-07-23
 generator: lead-developer
 verification_toolchain:
-  typecheck: "terraform validate && python3 -m py_compile platform/**/*.py && python3 -m jsonschema schemas/*.schema.json"
+  typecheck: "terraform validate && python3 -m py_compile core/**/*.py && python3 -m jsonschema schemas/*.schema.json"
   test: "scripts/verify_phaseNN.sh"
   build: "terraform init"
   note: |
@@ -16,7 +16,7 @@ verification_toolchain:
     ci-* agents read PERSONAS.md before running verification commands.
 ---
 
-# ACDL — Persona Roster (project-level, v1.1)
+# ACDL — Persona Roster (project-level, v1.9)
 
 ## Active personas
 
@@ -27,34 +27,43 @@ verification_toolchain:
 - **Frameworks:** (none)
 - **Constraints:** pragmatic, battle-tested defaults, no-cross-territory-edits, vision-is-source-of-truth-for-why
 - **Territory:** `.ciagent/**`, `scripts/verify_phase*.sh`, `README.md`, `docs/**` (meta only — not architecture authoring), `.gitignore`
-- **Reason:** Owns CIAgent metadata, cross-phase verification scripts, and the v1.1 phase orchestration. Resolves the 11 open decisions (D-038) and arbitrates persona conflicts.
+- **Reason:** Owns CIAgent metadata, cross-phase verification scripts, and the v1.7 phase orchestration. Resolves the 12-scope-axis decomposition (D-048→D-060) and arbitrates persona conflicts.
 
 ### backend-engineer
 - **Domain:** backend
 - **Active:** true
 - **Phase-specific:** false
-- **Frameworks:** python, json-schema, gitea-actions, act_runner, bash, yaml
+- **Frameworks:** python, json-schema, gitea-actions, act_runner, bash, yaml, github-actions
 - **Constraints:** contract-schema-first, fail-fast-with-reason-codes, no-long-lived-credentials, severity-to-penalty-mapping-immutable
-- **Territory:** `platform/confidence_signal.py`, `platform/contract_resolver.py`, `platform/outbox/**`, `schemas/**` (contract + IR + PolicyCheckResult), `contracts/**` (sample contracts), `.gitea/workflows/**` (pipeline)
-- **Reason:** Owns the contract schema, contract→IR resolution, the confidence signal (6 inputs + severity mapping), the DynamoDB outbox writer, and the central pipeline workflow.
+- **Territory:** `core/confidence_signal.py`, `core/contract_resolver.py`, `core/outbox_writer.py`, `core/output_publisher.py`, `core/environment_check.py`, `schemas/**` (contract + IR + PolicyCheckResult + tagging-standard + pipeline), `contracts/**` (sample contracts), `.gitea/workflows/**` + `.github/workflows/**` (pipeline + deploy + platform-test + primitives-plan + patterns-plan + release), `pipelines/**`, `scripts/run_ci.sh`, `scripts/run_platform.sh`, `scripts/post_stage_comment.sh`, `scripts/run_primitive_plan.sh`, `scripts/run_pattern_plan.sh`
+- **Reason:** Owns the contract schema, contract→IR resolution, the confidence signal (6 inputs + severity mapping), the DynamoDB outbox writer, the output publisher (SSM + GitHub comment), the central pipeline workflows (CI + deploy + platform-test + primitives-plan + patterns-plan + release), and the deploy-pipeline DX (stage comments, error-report step).
 
 ### platform-engineer (custom)
 - **Domain:** infra
 - **Active:** true
 - **Phase-specific:** false
-- **Frameworks:** terraform, aws-iam, aws-s3, aws-dynamodb, oidc, json-schema
-- **Constraints:** ir-is-substrate-agnostic, adapter-is-only-substrate-specific-code, state-in-s3+dynamodb-single-region, oidc-only-no-long-lived-keys (waiver D-034 for bootstrap), terraform-plan-only-in-spike
-- **Territory:** `adapters/terraform/**`, `modules-ir/**`, `terraform/**` (state backend, provider config), `platform/registry/**`
-- **Reason:** Owns the Target Stack IR, the L1/L2 IR-typed modules, the Terraform adapter, the AWS OIDC bootstrap, and the state backend. The IR is substrate-agnostic; the adapter is the only substrate-specific code (the binding constraint per §12).
+- **Frameworks:** terraform, aws-iam, aws-s3, aws-dynamodb, aws-lambda, aws-cloudfront, aws-waf, aws-ssm, aws-secretsmanager, oidc, json-schema
+- **Constraints:** ir-is-substrate-agnostic, adapter-is-only-substrate-specific-code, state-in-s3+dynamodb-single-region, oidc-only-no-long-lived-keys (waiver D-034 for bootstrap), terraform-plan-only-in-spike, cross-account-iam-scoped-via-abac
+- **Territory:** `adapters/terraform/**`, `modules/**` (l1 + l2 + registry.json + examples), `terraform/**` (state backend, provider config, platform infra), `modules/registry.json`
+- **Reason:** Owns the Target Stack IR, the L1/L2 IR-typed modules (incl. new cloudfront + waf + rds primitives), the Terraform adapter (TYPE_MAP expansion for cloudfront/waf/rds), the AWS OIDC bootstrap, the state backend, and the platform Terraform (Lambda + DynamoDB + KMS + Secrets Manager + Function URL). The IR is substrate-agnostic; the adapter is the only substrate-specific code (the binding constraint per §12).
 
 ### security-engineer (custom)
 - **Domain:** security
 - **Active:** true
 - **Phase-specific:** false
-- **Frameworks:** aws-iam, oidc, checkov, json-schema
-- **Constraints:** least-privilege, separation-of-duties-identity-distinctness, no-secrets-in-skill-markdown, audit-chain-extends-not-tears-up, critical-finding-hard-overrides-confidence
-- **Territory:** `platform/hitl_matrix_design.md`, `platform/audit_ledger_design.md`, `adapters/terraform/policy/**` (Checkov adapter → PolicyCheckResult), `platform/separation_of_duties.py`
-- **Reason:** Owns the HITL matrix design, separation-of-duties (DynamoDB identity-distinctness), the audit ledger design (S3 Object Lock + JWS + chain), and the Checkov→PolicyCheckResult adapter. Enforces the "Safety is Computed, Not Assumed" + "Audit truth lives outside the repository" vision tenets.
+- **Frameworks:** aws-iam, oidc, checkov, kyverno, wiz, json-schema
+- **Constraints:** least-privilege, separation-of-duties-identity-distinctness, no-secrets-in-skill-markdown, audit-chain-extends-not-tears-up, critical-finding-hard-overrides-confidence, required-tags-enforced
+- **Territory:** `core/hitl_matrix_design.md`, `core/audit_ledger_design.md`, `adapters/terraform/policy/**` (Checkov adapter + custom rules), `adapters/wiz/**` (Wiz adapter), `adapters/kyverno/**` (Kyverno adapter + sample policies), `core/separation_of_duties.py`, `schemas/tagging-standard.json`, `schemas/policy_check_result.schema.json` (engine enum)
+- **Reason:** Owns the HITL matrix design, separation-of-duties, the audit ledger design, the Checkov→PolicyCheckResult adapter + the custom tagging rule (D-054, D-043 closure), the Wiz adapter (D-052), the Kyverno adapter (D-053), and the tagging standard. Enforces the "Safety is Computed, Not Assumed" + "Audit truth lives outside the repository" vision tenets.
+
+### lambda-engineer (custom, v1.9)
+- **Domain:** serverless
+- **Active:** true
+- **Phase-specific:** true (reactivated for v1.9; removed after milestone COMPLETE)
+- **Frameworks:** python, aws-lambda, boto3, dynamodb, aws-secretsmanager, aws-sns, github-api, gitea-api
+- **Constraints:** lambda-is-stateless, dynamodb-is-the-state-store, secrets-from-secrets-manager-never-logged, idempotent-actions, cross-account-iam-via-abac, forge-agnostic-api-urls, sns-topic-arn-from-env
+- **Territory:** `core/lambda/**` (contract_ingestor.py + handler), `terraform/platform/main.tf` (Lambda + Function URL + DynamoDB + KMS + Secrets Manager + IAM + acdl-change-requests table + acdl-sod-halt SNS topic), `terraform/platform/consumer_invoke_policy.json`, `terraform/platform/variables.tf`
+- **Reason:** Reactivated for v1.9 Phase 42 (acdl-sod-halt SNS topic for `route_halt_artifact`, defined in `terraform/platform/main.tf`). The Lambda is stateless; all state is in DynamoDB. Forge-agnostic API URLs (GitHub + Gitea) via GITHUB_API_BASE env var. Removed from the roster after milestone COMPLETE (the code persists, but the persona is no longer active).
 
 ### frontend-engineer
 - **Domain:** frontend
@@ -63,21 +72,21 @@ verification_toolchain:
 - **Frameworks:** vanilla-js, dom-api, fetch-api
 - **Constraints:** no-frameworks, single-file, fetch-from-same-origin-raw-url, relative-url-for-audit-json
 - **Territory:** `evidence-ui/**` (the timeline UI; pushed to `acdl-evidence`)
-- **Reason:** Owns the evidence timeline UI (`index.html`). Carried over from v1.0; the UI continues to render the audit stream. The v1.1 spike writes events to the DynamoDB outbox; the UI continues to read `audit.json` published to `acdl-evidence`.
+- **Reason:** Owns the evidence timeline UI (`index.html`). Carried over from v1.0; the UI continues to render the audit stream. The v1.7 spike writes events to the DynamoDB outbox; the UI continues to read `audit.json` published to `acdl-evidence`.
 
 ## Deactivated personas
 
 ### infra-stub-engineer (custom, v1.0 only)
 - **Domain:** backend
 - **Active:** false
-- **Reason:** Owned L1 stub modules (`modules/l1/**`) in the v1.0 demo. The demo is archived to `demo/` in Phase 06; real L1 modules (`modules-ir/l1/**`) are owned by platform-engineer (substrate-agnostic IR + Terraform adapter). The stub engineer is no longer needed.
+- **Reason:** Owned L1 stub modules (`modules/l1/**`) in the v1.0 demo. The demo is archived to `demo/` in Phase 06; real L1 modules (`modules-ir/l1/**`, now `modules/l1/**`) are owned by platform-engineer (substrate-agnostic IR + Terraform adapter). The stub engineer is no longer needed.
 - **Phase-specific:** false (was v1.0)
 - **Territory (would have been):** `demo/modules/l1/**`
 
 ### data-engineer
 - **Domain:** data
 - **Active:** false
-- **Reason:** No ORM/persistence framework. The v1.1 outbox is DynamoDB but accessed via boto3 calls inside `platform/outbox/**` (owned by backend-engineer); the audit ledger is S3 Object Lock + JWS (owned by security-engineer). No schema-migration layer, no ORM, no data-engineer territory.
+- **Reason:** No ORM/persistence framework. The v1.7 contract-ingestion table is DynamoDB but accessed via boto3 inside `core/lambda/contract_ingestor.py` (owned by lambda-engineer); the outbox is DynamoDB accessed via `core/outbox_writer.py` (owned by backend-engineer); the audit ledger is S3 Object Lock + JWS (owned by security-engineer). No schema-migration layer, no ORM, no data-engineer territory.
 - **Phase-specific:** false
 - **Frameworks:** (would have been: drizzle, prisma)
 - **Constraints:** (would have been: schema-first, type-safe-orm)
@@ -87,32 +96,48 @@ verification_toolchain:
 
 | Phase | Personas active | Notes |
 |-------|------------------|-------|
-| 06 archive-demo-and-reorient | lead-developer, frontend-engineer (demo UI move only) | backend/platform/security idle |
-| 07 architecture-v1-finalization | lead-developer, backend-engineer (schemas), security-engineer (HITL/ledger/SoD), platform-engineer (IR) | frontend idle |
-| 08 aws-oidc-bootstrap | platform-engineer (lead), security-engineer (trust policy review) | backend/frontend idle |
-| 09 v1-spike-ir-and-l1-and-adapter | platform-engineer (lead), backend-engineer (IR schema co-author) | security/frontend idle |
-| 10 v1-spike-l2-and-contract-e2e | platform-engineer (L2 + adapter), backend-engineer (contract→IR + confidence + outbox), security-engineer (Checkov→PolicyCheckResult), frontend-engineer (evidence event surfaces in timeline) | Full roster |
+| 28 adapter-waf-and-resolver-outputs | platform-engineer (lead: WAF HCL fix + adapter output blocks), backend-engineer (resolver outputs processing) | security/lambda/frontend idle |
+| 29 ssm-kms-and-invoke-policy | backend-engineer (lead: SSM fail-loud), lambda-engineer (Terraform-rendered invoke policy), security-engineer (CMK enforcement review) | platform/frontend idle |
+| 30 run-platform-isolation-and-api-portability | backend-engineer (lead: run_platform.sh temp dir + deploy.yml static-key), lambda-engineer (forge-agnostic API URLs) | platform/security/frontend idle |
+| 31 encryption-by-default-and-per-stack-cmk | platform-engineer (lead: kms-key primitive + adapter expansion + L2 wiring), security-engineer (encryption NFR enforcement review) | backend/lambda/frontend idle |
+| 32 deletion-protection-by-default-and-l2-feature-flag | platform-engineer (lead: prevent_destroy emission + L2 feature flag), backend-engineer (contract schema update) | security/lambda/frontend idle |
+| 33 uptime-kuma-primitive | platform-engineer (lead: uptime primitive + adapter + separate state), backend-engineer (deploy-uptime pipeline stage + run_platform.sh + PR comment) | security/lambda/frontend idle |
+| 34 decommission-alias-and-cmdb-validation | backend-engineer (lead: decommission pipeline mode + run_platform.sh + consumer docs), lambda-engineer (validate_change_request + acdl-change-requests table), security-engineer (HITL SRE gates review) | platform/frontend idle |
+| 35 module-engineering-standards | lead-developer (lead: STANDARDS.md + catalog fix + template), platform-engineer (standards content review), backend-engineer (automated standards test) | security/lambda/frontend idle |
+| 36 schemas-adapters-pipelines-readmes | lead-developer (lead: 3 READMEs), backend-engineer (pipelines + schemas README content), platform-engineer (adapters README content) | security/lambda/frontend idle |
+| 37 verify | lead-developer (lead: 4-layer verification), all personas (review their territory) | — |
+| 38 review-audit-complete | lead-developer (lead: review + audit + milestone completion), all personas (review participation) | — |
+| 39 design-doc-refresh-and-p1-1-parameterization | security-engineer (lead: hitl_matrix_design.md + audit_ledger_design.md refresh), platform-engineer (lead: P1-1 adapter defaults → L1 interface.json inputs), backend-engineer (contract_resolver.py + env schema adjacent review) | lambda/frontend idle |
+| 40 contract-interpolation | backend-engineer (lead: _expand_vars in contract_resolver.py + environment.schema.json + sample contracts), platform-engineer (interface.json adjacent review) | security/lambda/frontend idle |
+| 41 per-environment-ci-jobs | backend-engineer (lead: deploy.yml environment input + run_platform.sh --environment + per-env contracts + caller-workflow docs), security-engineer (HITL gate structure review) | platform/lambda/frontend idle |
+| 42 stub-implementation | security-engineer (lead: route_halt_artifact SNS + hitl_gates.py + attestation_matrix.py + Wiz real client + Kyverno fleshed out), backend-engineer (run_platform.sh HITL gate wiring), lambda-engineer (acdl-sod-halt SNS topic in terraform/platform/main.tf) | platform/frontend idle |
+| 43 verify-review-audit-complete | lead-developer (lead: 4-layer verify + review + audit + milestone completion), all personas (review participation) | — |
 
 ## Domain priority (used by TaskDecomposer)
 
-`coordination → security → platform → backend → frontend`
+`coordination → security → platform → backend → lambda → frontend`
 
-Rationale: in v1.1, the security/architecture commitments (IR, confidence,
-HITL, ledger, SoD) are the binding constraints; the platform layer
-materializes them; backend wires the pipeline; frontend surfaces the
-evidence. The spike's correctness depends on the security + platform layers
-being right before backend wiring.
+Rationale: in v1.9, the security commitments (HITL gates, attestation
+matrix, SoD halt artifact, Wiz/Kyverno adapters) and the design-doc
+accuracy are the binding constraints; platform owns the P1-1 adapter
+parameterization + L1 interface inputs; backend owns the contract
+interpolation + per-env CI jobs + the deploy workflow env input;
+lambda owns the SNS topic Terraform; frontend is unchanged from v1.0
+(evidence timeline).
 
 ## Conflict resolutions (lead-developer arbitration)
 
-- `backend-engineer` vs `platform-engineer` over `schemas/ir.schema.json`: platform-engineer owns the IR (it is substrate-agnostic but infra-shaped); backend-engineer owns the contract schema and the contract→IR resolution (contract is the consumer surface). Co-authoring is expected; conflict goes to lead-developer.
-- `backend-engineer` vs `security-engineer` over `platform/confidence_signal.py`: security-engineer owns the severity→penalty mapping + critical-override semantics; backend-engineer owns the 6-input weighted sum + per-env thresholds. The confidence signal is co-owned; conflicts go to lead-developer.
-- `platform-engineer` vs `security-engineer` over `adapters/terraform/policy/**`: security-engineer owns the Checkov→PolicyCheckResult adapter (policy is a security concern); platform-engineer owns the Terraform adapter (substrate translation). No overlap.
+- `backend-engineer` vs `platform-engineer` over `schemas/ir.schema.json` + `schemas/stack.schema.json`: platform-engineer owns the IR (substrate-agnostic but infra-shaped); backend-engineer owns the contract schema and the contract→IR resolution. Co-authoring is expected; conflict goes to lead-developer.
+- `backend-engineer` vs `security-engineer` over `core/confidence_signal.py`: security-engineer owns the severity→penalty mapping + critical-override semantics; backend-engineer owns the 6-input weighted sum + per-env thresholds. Co-owned; conflicts go to lead-developer.
+- `platform-engineer` vs `security-engineer` over `adapters/terraform/policy/**`: security-engineer owns the Checkov→PolicyCheckResult adapter + custom rules + the Wiz/Kyverno adapters (policy is a security concern); platform-engineer owns the Terraform adapter (substrate translation). No overlap.
+- `lambda-engineer` vs `platform-engineer` over `terraform/platform/main.tf`: lambda-engineer owns the Lambda + DynamoDB + Secrets Manager definitions; platform-engineer reviews the Terraform structure + state backend. Co-authoring expected; conflicts go to lead-developer.
+- `backend-engineer` vs `lambda-engineer` over `core/lambda/contract_ingestor.py` vs `scripts/run_platform.sh` + `.github/workflows/deploy.yml` error-report step: lambda-engineer owns the Lambda handler; backend-engineer owns the workflow step that invokes it. The interface (the JSON payload) is co-authored; conflicts go to lead-developer.
 - `lead-developer` vs any: lead-developer owns `.ciagent/**` + `docs/**` meta + verification scripts; persona engineers do not edit CIAgent metadata or the vision/architecture source docs.
 
 ## Territory enforcement mode
 
 `warn` — config.json has no `personas.territory_enforcement` field, so the
 default per execute.md is `warn`. Cross-territory edits are logged in the
-commit message but do not fail the task. The spike's small scope means
-co-authoring across territories is likely; `warn` keeps it frictionless.
+commit message but do not fail the task. v1.7's broad scope means
+co-authoring across territories is likely (e.g. lambda + platform on
+`terraform/platform/main.tf`); `warn` keeps it frictionless.

.ciagent/PLAN.md

@@ -1,453 +1,228 @@
 ---
-phase: 6
-name: archive-demo-and-reorient
-milestone: v1.1
-milestone_type: feature
-status: planned
-requirements: []   # Phase 06 introduces NO new REQ — it is repo hygiene (ROADMAP §Phase 06).
-must_haves:
-  - "demo/ contains the full v1.0 demo (modules/, scripts/, evidence-ui/, contracts/, contracts-repo/, .gitea/workflows/, ACDL_DEMO.md)"
-  - "demo/scripts/run_demo.sh --no-upload exits 0 (regression: the archived demo still runs from demo/)"
-  - "New top-level dirs exist and are empty-but-scaffolded with a .gitkeep: platform/, schemas/, adapters/, terraform/, modules-ir/"
-  - "A new top-level scripts/ dir exists with scripts/verify_phase06.sh (v1.1 verify scripts live at top-level scripts/, NOT demo/scripts/)"
-  - "README.md reflects the real platform (vision + architecture links, new layout); the v1.0 demo README content moves to demo/ACDL_DEMO.md (already there)"
-  - ".gitignore updated to ignore runner-data/ (untracked demo runner artifact) if not already"
-  - "No stray empty dirs left at repo root from the moves (contracts-repo/ etc.)"
-verification:
-  typecheck: "bash -n demo/scripts/*.sh && python3 -m py_compile demo/scripts/*.py"
-  test: "scripts/verify_phase06.sh   # lives at TOP-LEVEL scripts/, not demo/scripts/"
-  build: "no-op   # Phase 06 is repo hygiene; terraform init is Phase 09+"
+phase: 39-43
+name: v1.9-design-doc-interpolation-per-env-ci-stubs-p1-1
+milestone: v1.9
+requirements: [REQ-100, REQ-101, REQ-102, REQ-103, REQ-104, REQ-105, REQ-106, REQ-107, REQ-108, REQ-109, REQ-110, REQ-111]
+type: feat/docs/fix
 ---
 
-# Phase 06 — archive-demo-and-reorient PLAN
+# ACDL v1.9 — Phase Plans
 
-## Goal
+> Milestone v1.9. Generated at PLAN stage. Autonomy: full.
+> Requirements: REQ-100..REQ-111 (see REQUIREMENTS.md).
+> Decisions: D-080..D-089 (see PROJECT.md + RESEARCH.md RA section).
+> Versioning: feature milestone — progressive patch versions per phase
+> (v1.8.1..v1.8.5), tag `v1.9.0` at milestone COMPLETE.
 
-Archive the complete v1.0 demo under `demo/` (preserve it as the intent
-reference per D-037), establish the new v1.1 repo layout
-(`platform/`, `schemas/`, `adapters/`, `terraform/`, `modules-ir/`), and
-rewrite `README.md` to reflect the real Agentic Cloud Delivery Platform.
-Verify the archived demo still runs end-to-end from `demo/` via
-`demo/scripts/run_demo.sh --no-upload` (regression gate).
+## Wave ordering
 
-This is **repo hygiene only** — no new code, no new REQ. It reorients the
-repo from "the v1.0 demo is the repo" to "the v1.0 demo is an archived
-artifact under `demo/`; the repo root is now the real platform's home."
-
-## Requirements covered
-
-**None new.** Phase 06 carries no REQ-NN entry (ROADMAP §Phase 06:
-"Requirements: (no new REQ; repo hygiene)"). It is a structural
-prerequisite for Phase 07 (architecture-v1-finalization), which owns
-REQ-16..REQ-22.
-
-**Dependency:** the v1.0 demo must be complete and tagged. It is — tag
-`v1.1.0` exists (verified: `git tag` lists `v1.0.1`..`v1.0.5`, `v1.1.0`).
-All v1.0 phases shipped and audited PASS (ROADMAP §v1.0). The archive
-preserves the demo immutably; v1.0 tags are not rewritten (PROJECT.md
-operational parameter: "v1.0 tags preserved").
-
-**No upstream phase dependency within v1.1** — Phase 06 is the first
-v1.1 phase. RESEARCH TARGET 10 (conf 0.90) provides the authoritative
-move list and confirms via static analysis that no path fixups are
-needed: all demo scripts resolve paths via `SCRIPT_DIR`/`REPO_ROOT`
-relative-to-script, which auto-adjust when the tree moves to `demo/`.
-
-## Waves
-
-Domain priority order from `PERSONAS.md`:
-`coordination → security → platform → backend → frontend`.
-
-Phase 06 active personas (PERSONAS.md "Phase-specific overrides"):
-**lead-developer** (coordination — owns the moves, the new layout, the
-README, and the verify script) + **frontend-engineer** (demo UI move
-confirmation only). Backend/platform/security are idle this phase.
-
-Three waves, strictly ordered (each wave's tasks depend on the prior
-wave completing):
+- **Wave 1 (parallel, 2 tasks):** Phase 39 — design-doc refresh (security-engineer) + P1-1 adapter parameterization (platform-engineer). Disjoint file sets; no merge conflict.
+- **Wave 2 (sequential):** Phase 40 — contract interpolation. Depends on Phase 39's design-doc context (lightweight).
+- **Wave 3 (sequential):** Phase 41 — per-env CI jobs. Depends on Phase 40's interpolation + env schema.
+- **Wave 4 (sequential):** Phase 42 — stub implementation. Depends on Phase 41's HITL job structure.
+- **Wave 5 (sequential):** Phase 43 — verify + review + audit + complete.
 
 ---
 
-### Wave 1 — lead-developer: file moves + new layout + README + verify script
+## Phase 39 — design-doc-refresh-and-p1-1-parameterization
 
-The structural reorientation. All moves use `git mv` to preserve history.
-The v1.0 verify scripts move *with* `scripts/` into `demo/scripts/` (they
-are demo artifacts); the *new* v1.1 verify script lives at a *new*
-top-level `scripts/` dir (created fresh in this wave).
+**Requirements:** REQ-100, REQ-101, REQ-102
+**Personas:** security-engineer (lead: design docs), platform-engineer (lead: P1-1), backend-engineer (review)
+**Branch:** `phase/39-design-doc-refresh-and-p1-1`
 
-#### T-6.1 — Move the v1.0 demo tree into `demo/`
+### Task 39.1 — Refresh hitl_matrix_design.md (REQ-100, security-engineer)
+- Rewrite the status block: "v1.2 wires the gates" → "v1.9 wires the gates (Phase 42)".
+- Update "Spike scope note" → "v1.9 scope note": qa/prod/dr now exercised (Phase 41 wires the job structure; Phase 42 wires the attestation gates); dev remains autonomous.
+- Update §10.4 matrix: mark the offline-testable concerns (contract NFRs, schema validity, policy pass) as **implemented in v1.9** (`core/attestation_matrix.py`); mark operator-supplied concerns as **accept signed evidence artifacts** (D-084).
+- Add a "v1.9 wiring" section: cross-reference Phase 41's per-env jobs + Phase 42's `hitl_gates.py` + `attestation_matrix.py` + the outbox-based SoD check.
+- Preserve D-042 (approver identity = `gitea.actor` / `github.actor`) — still accurate.
+- Verify: `grep -i "dev-only spike" core/hitl_matrix_design.md` returns 0 hits; `grep -i "v1.2 wires" core/hitl_matrix_design.md` returns 0 hits.
 
-- **Owner:** lead-developer (territory: `.ciagent/**`, `README.md`,
-  `.gitignore`, top-level layout).
-- **Files owned:** `demo/` (new), everything moved into it.
-- **Commit message:**
-  `phase: 6, status: plan-as-execute, persona: lead-developer, task: T-6.1`
-- **Commands to run verbatim** (cross-checked against RESEARCH.md
-  TARGET 10's move list; verified the dirs exist and are tracked
-  via `git ls-files`):
+### Task 39.2 — Refresh audit_ledger_design.md (REQ-101, security-engineer)
+- Mark the "Spike scope (D-041)" section as **shipped + production since v1.8** (hash chain + DynamoDB outbox + `acdl-evidence` mirror).
+- Move the "v1.2 build-out" section (S3 Object Lock + JWS + async worker + DLQ + daily checkpoints) under a clearly-labeled "**Deferred to a future milestone (D-083)**" heading. Keep the content (it's the design for when it ships) but mark it not-v1.9.
+- Update the RPO/RTO table: spike row → "v1.8+ (production): RPO=0 (sync outbox), RTO=workflow re-run"; v1.2 row → "Future milestone (D-083): RPO=0, RTO=DLQ replay".
+- Update the outbox item shape: note `approver_qa`/`approver_prod`/`approver_dr` are populated by v1.9's `hitl_gates.attest` (Phase 42).
+- Verify: `grep -i "Phases 08-10 implement" core/audit_ledger_design.md` returns 0 hits; the deferred section is clearly labeled.
 
-  ```bash
-  # From the repo root (/root/acdl). All moves via `git mv` to preserve history.
-  # 1. Create the demo/ container.
-  mkdir -p demo
+### Task 39.3 — P1-1 adapter parameterization (REQ-102, platform-engineer)
+- `modules/l1/ecs-service/interface.json`: add inputs `desired_count` (integer, default 1), `launch_type` (string, default "FARGATE"), `family` (string, default "app").
+- `modules/l1/alb/interface.json`: add inputs `load_balancer_type` (string, default "application"), `target_type` (string, default "ip").
+- `modules/l1/vpc/interface.json`: add input `name` (string, default "app") for the VPC/IGW/RT `Name` tag prefix.
+- `adapters/terraform/adapter.py`: change hardcoded defaults to `inputs.get("<name>", "<default>")` where the default matches the interface default (safety fallback; the resolver populates from the interface). Remove the hardcoded `Name = "acdl-microservice-rt"` (line 283) → use `inputs.get("name", "app")`-derived tag.
+- Preserve the v1.1 S3 regression (S3 has none of these inputs → no change).
+- Tests: `tests/test_p1_1_adapter_parameterization.py` — (a) `desired_count: 3` in contract inputs emits `desired_count = 3`; (b) absent `desired_count` emits `desired_count = 1` via interface default; (c) `target_type: "instance"` emits `target_type = "instance"`; (d) v1.1 S3 regression still passes (byte-identical `main.tf`).
+- Verify: `pytest tests/test_p1_1_adapter_parameterization.py` passes; `run_platform.sh --check-only` exits 0; `pytest` total count increases; v1.1 S3 regression test passes.
 
-  # 2. Move the five demo dirs + the demo deck + the demo contracts-repo.
-  git mv modules            demo/modules
-  git mv scripts            demo/scripts          # carries verify_phase01..05.sh (v1.0 demo verify scripts)
-  git mv evidence-ui        demo/evidence-ui
-  git mv contracts          demo/contracts        # only holds examples/ (v1.0 sample contracts)
-  git mv contracts-repo     demo/contracts-repo  # tracked: .gitea/workflows/{.gitkeep,issue-to-contract.yml}
-  git mv .gitea             demo/.gitea           # carries workflows/{.gitkeep,pipeline.yml}
-  git mv ACDL_DEMO.md       demo/ACDL_DEMO.md     # the v1.0 presentation deck (was untracked — `git add` it first)
+### Task 39.4 — Design doc test (REQ-100/101, backend-engineer)
+- `tests/test_design_docs_current.py`: assert (a) no stale "dev-only spike" / "v1.2 wires the gates" / "Phases 08-10 implement" framing in either design doc; (b) `audit_ledger_design.md` has a "Deferred to a future milestone" section referencing D-083; (c) `hitl_matrix_design.md` references the v1.9 implementation (`attestation_matrix.py`, `hitl_gates.py`).
+- Verify: `pytest tests/test_design_docs_current.py` passes.
 
-  # 3. Handle the untracked demo runner artifact: do NOT git mv (it's untracked).
-  #    Move it out of the repo root so it doesn't linger as a stray dir.
-  mv runner-data demo/runner-data   # plain mv — not tracked; runner-data/.runner
-  #    (runner-data/ is added to .gitignore in T-6.4 so it stays a local artifact.)
-
-  # 4. Sanity: no empty stray dirs remain at repo root.
-  #    (git mv removes the source dir when it becomes empty; verify with `ls`.)
-  ```
-
-  **Cross-check vs RESEARCH.md TARGET 10 move list:**
-  - `modules/ → demo/modules/` ✓
-  - `scripts/ → demo/scripts/` ✓ (carries v1.0 verify_phase01..05.sh — those
-    are *demo* verify scripts; the v1.1 verify script is created in T-6.3
-    at a *new* top-level `scripts/` dir)
-  - `evidence-ui/ → demo/evidence-ui/` ✓
-  - `contracts/ → demo/contracts/` ✓
-  - `.gitea/workflows/{.gitkeep,pipeline.yml} → demo/.gitea/workflows/` ✓
-    (achieved by moving the whole `.gitea/` dir)
-  - `ACDL_DEMO.md → demo/ACDL_DEMO.md` ✓
-  - `contracts-repo/ → demo/contracts-repo/` ✓ (tracked; confirmed via
-    `git ls-files contracts-repo/` → `.gitea/workflows/.gitkeep` +
-    `.gitea/workflows/issue-to-contract.yml`)
-  - `runner-data/ → demo/runner-data/` ✓ (untracked; plain `mv`)
-
-  **Subtlety (per task instructions):** the v1.1 verify scripts live at a
-  *new* top-level `scripts/` dir (created in T-6.3), NOT inside `demo/scripts/`
-  (which holds the v1.0 demo verify scripts `verify_phase01..05.sh`). This
-  avoids colliding the v1.1 verification toolchain with the archived demo's.
-
-  **Risk note (R-5 from RESEARCH.md):** static analysis found only
-  `/tmp/...` temp-file writes in the demo scripts (e.g.
-  `scripts/gitea_setup.sh`, `scripts/verify_phase01.sh`) — no source-root
-  absolute paths. All demo scripts use `SCRIPT_DIR`/`REPO_ROOT`
-  relative-to-script, which auto-resolve to `demo/` after the move. The
-  regression check in T-6.3 / Wave 3 confirms this empirically.
-
-#### T-6.2 — Scaffold the new v1.1 top-level dirs (empty, .gitkeep'd)
-
-- **Owner:** lead-developer (territory: top-level layout).
-- **Files owned:** `platform/.gitkeep`, `schemas/.gitkeep`,
-  `adapters/.gitkeep`, `terraform/.gitkeep`, `modules-ir/.gitkeep`.
-- **Commit message:**
-  `phase: 6, status: plan-as-execute, persona: lead-developer, task: T-6.2`
-- **Commands:**
-
-  ```bash
-  # From the repo root. Five new empty-but-scaffolded dirs per ROADMAP §Phase 06.
-  # These are populated in Phases 07–10; here they only need to exist + be tracked.
-  for d in platform schemas adapters terraform modules-ir; do
-    mkdir -p "$d"
-    : > "$d/.gitkeep"   # empty placeholder so git tracks the dir
-  done
-  git add platform/.gitkeep schemas/.gitkeep adapters/.gitkeep terraform/.gitkeep modules-ir/.gitkeep
-  ```
-
-  **Territory note (PERSONAS.md):** these dirs are owned in later phases
-  by backend-engineer (`platform/confidence_signal.py`, `schemas/**`,
-  `platform/outbox/**`), platform-engineer (`adapters/terraform/**`,
-  `modules-ir/**`, `terraform/**`, `platform/registry/**`), and
-  security-engineer (`platform/hitl_matrix_design.md`,
-  `platform/audit_ledger_design.md`, `adapters/terraform/policy/**`). In
-  Phase 06 they are *empty* — no territory conflict.
-
-#### T-6.3 — Create the new top-level `scripts/` + write `scripts/verify_phase06.sh`
-
-- **Owner:** lead-developer (territory: `scripts/verify_phase*.sh`).
-- **Files owned:** `scripts/.gitkeep` (or the verify script itself acts as
-  the dir anchor), `scripts/verify_phase06.sh`.
-- **Commit message:**
-  `phase: 6, status: plan-as-execute, persona: lead-developer, task: T-6.3`
-- **What `scripts/verify_phase06.sh` must assert** (the Phase 06 success
-  criteria from ROADMAP, made executable):
-
-  ```bash
-  #!/usr/bin/env bash
-  # scripts/verify_phase06.sh — Phase 06 archive regression + layout check.
-  # Lives at TOP-LEVEL scripts/ (v1.1 verify scripts), NOT demo/scripts/.
-  set -u
-  ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-  cd "$ROOT"
-  fail() { echo "FAIL: $*" >&2; exit 1; }
-  ok()   { echo "ok: $*"; }
-
-  # --- Check 1: demo/ contains the full v1.0 demo tree ---
-  for d in demo/modules demo/scripts demo/evidence-ui demo/contracts \
-           demo/contracts-repo demo/.gitea/workflows; do
-    [ -d "$d" ] || fail "missing $d"
-  done
-  [ -f demo/ACDL_DEMO.md ] || fail "missing demo/ACDL_DEMO.md"
-  [ -f demo/scripts/run_demo.sh ] || fail "missing demo/scripts/run_demo.sh"
-  ok "demo/ contains the full v1.0 demo"
-
-  # --- Check 2: regression — the archived demo still runs from demo/ ---
-  #    run_demo.sh uses WORKDIR=/tmp/acdl_demo_run (absolute temp), so it
-  #    does not pollute the repo. --no-upload skips Gitea API calls.
-  out=$(ACDL_GITEA_TOKEN= bash demo/scripts/run_demo.sh --no-upload 2>&1); rc=$?
-  [ "$rc" -eq 0 ] || { echo "$out" >&2; fail "demo/scripts/run_demo.sh --no-upload exited $rc"; }
-  ok "demo/scripts/run_demo.sh --no-upload exits 0"
-
-  # --- Check 3: new top-level dirs exist and are scaffolded ---
-  for d in platform schemas adapters terraform modules-ir; do
-    [ -d "$d" ] || fail "missing new top-level dir $d"
-    [ -f "$d/.gitkeep" ] || fail "missing $d/.gitkeep"
-  done
-  ok "new top-level dirs exist: platform/ schemas/ adapters/ terraform/ modules-ir/"
-
-  # --- Check 4: no stray v1.0 dirs left at repo root ---
-  for stray in modules evidence-ui contracts contracts-repo ACDL_DEMO.md; do
-    [ -e "$stray" ] && fail "stray $stray left at repo root (should be under demo/)"
-  done
-  # .gitea/ at repo root is OK *only if* it's a new v1.1 workflow dir; in Phase 06
-  # we moved the demo's .gitea/ to demo/.gitea/, so repo-root .gitea/ should NOT
-  # exist yet (Phase 07+ may re-create it for the real pipeline).
-  [ -e ".gitea" ] && fail "stray .gitea/ left at repo root (moved to demo/.gitea/)"
-  ok "no stray v1.0 dirs at repo root"
-
-  # --- Check 5: README reflects the real platform ---
-  grep -q "Agentic Cloud Delivery Platform" README.md || fail "README missing platform name"
-  grep -q "demo/" README.md || fail "README does not reference the archived demo/"
-  grep -qi "vision\|architecture" README.md || fail "README missing vision/architecture links"
-  ok "README reflects the real platform (name + demo/ ref + vision/arch links)"
-
-  echo "Phase 06: ALL CHECKS PASS"
-  ```
-
-  **Note on `bash -n` / `py_compile` (typecheck gate):** the verify script
-  itself is covered by `bash -n scripts/verify_phase06.sh`; the moved demo
-  scripts are covered by `bash -n demo/scripts/*.sh` + `python3 -m py_compile
-  demo/scripts/*.py` (the typecheck gate in the frontmatter). These run in
-  Wave 3 before the full verify.
-
-#### T-6.4 — Rewrite `README.md` + update `.gitignore`
-
-- **Owner:** lead-developer (territory: `README.md`, `.gitignore`).
-- **Files owned:** `README.md`, `.gitignore`.
-- **Commit message:**
-  `phase: 6, status: plan-as-execute, persona: lead-developer, task: T-6.4`
-- **`README.md` must contain:**
-  - Project name: "ACDL — Agentic Cloud Delivery Platform".
-  - One-line vision lift from `PROJECT.md` (consumers declare intent; the
-    platform delivers safe production deployment through an agentic stack).
-  - Links: `docs/vision.md` (the why), `docs/architecture.md` (the how),
-    `.ciagent/PROJECT.md` (decisions), `.ciagent/ARCHITECTURE.md` (target
-    architecture), `.ciagent/ROADMAP.md` (phase plan).
-  - **New layout section** listing the top-level dirs and what each is for:
-    - `platform/` — platform code (confidence signal, contract resolver,
-      outbox, HITL/ledger designs) [populated Phase 07+].
-    - `schemas/` — JSON Schemas (IR, PolicyCheckResult, contract) [Phase 07].
-    - `adapters/` — substrate adapters (Terraform adapter in v1) [Phase 09].
-    - `terraform/` — state backend + provider config [Phase 08+].
-    - `modules-ir/` — IR-typed L1/L2 modules (`l1-s3`, `l2-static-asset`)
-      [Phase 09–10].
-    - `scripts/` — v1.1 verify scripts (`verify_phaseNN.sh`).
-    - `demo/` — the archived v1.0 executive demo (tag `v1.1.0`); runs locally
-      via `demo/scripts/run_demo.sh --no-upload`. Intent reference; not the
-      platform.
-    - `.ciagent/` — CIAgent metadata (plans, decisions, personas, roadmap).
-    - `docs/` — upstream vision + architecture sources.
-  - A "Status" line: v1.1 active — architecture finalization + v1 spike.
-    v1.0 demo complete (tag `v1.1.0`), archived under `demo/`.
-  - **No** v1.0 demo run instructions in the root README — point at
-    `demo/ACDL_DEMO.md` for the demo deck and `demo/scripts/run_demo.sh`.
-
-- **`.gitignore` update:**
-  - Add `runner-data/` (the untracked demo runner artifact; moved to
-    `demo/runner-data/` in T-6.1, but any future local runner registration
-    should be ignored at the repo root too).
-  - Keep existing entries (`__pycache__/`, `*.pyc`, `*.pyo`, `.env*`,
-    `state.json`, `audit.json`, `*.tmp`, `.DS_Store`).
-  - The existing `.gitignore` (read) is:
-    ```
-    __pycache__/
-    *.pyc
-    *.pyo
-    .env
-    .env.*
-    state.json
-    audit.json
-    *.tmp
-    .DS_Store
-    ```
-    Append `runner-data/` (and optionally `demo/runner-data/` for
-    completeness).
+### Must-haves (Phase 39)
+- [ ] `core/hitl_matrix_design.md` refreshed (no stale framing).
+- [ ] `core/audit_ledger_design.md` refreshed (S3 Object Lock marked deferred D-083).
+- [ ] Adapter has no hardcoded ECS/ALB/VPC defaults (read from inputs).
+- [ ] `tests/test_p1_1_adapter_parameterization.py` + `tests/test_design_docs_current.py` pass.
+- [ ] `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0; v1.1 S3 regression passes.
 
 ---
 
-### Wave 2 — frontend-engineer: confirm `demo/evidence-ui/` moved cleanly
+## Phase 40 — contract-interpolation
 
-The UI is frozen as a demo artifact (D-033: relative fetch URL). No code
-changes unless the move broke the fetch path — which static analysis says
-it cannot (the UI is a single static `index.html` with a relative URL to
-`audit.json` on the `acdl-evidence` raw URL). This wave is a confirmation,
-not a build.
+**Requirements:** REQ-103, REQ-104
+**Personas:** backend-engineer (lead), platform-engineer (review)
+**Branch:** `phase/40-contract-interpolation`
 
-#### T-6.5 — Confirm `demo/evidence-ui/index.html` integrity + fetch path
+### Task 40.1 — Environment JSON schema (REQ-104, backend-engineer)
+- `schemas/environment.schema.json` (draft 2020-12): required `name` (string), `account_id` (string), `region` (string), `state_backend` (object: `bucket`, `lock_table`), `network` (object: `vpc_cidr`, `azs` array), `runner_role_arn` (string), `autonomy` (enum: full/attested), `confidence_threshold` (number).
+- `core/environments/dev.json` validates against it.
+- Add `core/environments/qa.json`, `prod.json`, `dr.json`: `account_id: "000000000000"`, `autonomy: "attested"`, `confidence_threshold` 0.75/0.90/0.95, regions us-east-1, state_backend buckets `acdl-qa-state`/`acdl-prod-state`/`acdl-dr-state`.
+- `core/environment_check.py`: add `load(env_name, root=None)` returning the parsed env dict; `check()` stays. Add a stderr warning when `account_id == "000000000000"` and `env_name != "dev"` (prompts real binding).
+- `tests/test_environment_schema.py`: all 4 env files validate; `load("dev")` returns the dict; warning emitted for qa/prod/dr placeholders.
+- Verify: `pytest tests/test_environment_schema.py` passes.
 
-- **Owner:** frontend-engineer (territory: `evidence-ui/**`, now
-  `demo/evidence-ui/**`).
-- **Files owned:** `demo/evidence-ui/index.html` (read-only confirmation;
-  edit only if the fetch URL is broken, which it is not per D-033).
-- **Commit message (if no edit needed — confirmation only, may be a
-  no-op commit or folded into Wave 3's verify):**
-  `phase: 6, status: plan-as-execute, persona: frontend-engineer, task: T-6.5`
-- **Checks the frontend-engineer performs:**
-  1. `demo/evidence-ui/index.html` exists and is byte-identical to the
-     pre-move file (git history preserved via `git mv`).
-  2. The fetch URL inside `index.html` is relative (per D-033) — e.g.
-     `fetch('audit.json')` or a raw-URL reference to `acdl-evidence`.
-     It must NOT reference a repo-root-relative path that broke when
-     moved under `demo/`.
-  3. If (and only if) `scripts/verify_phase06.sh` (run in Wave 3) reports
-     the UI fetch path broken, the frontend-engineer patches
-     `demo/evidence-ui/index.html`'s fetch URL to be relative. Per D-033
-     and RESEARCH TARGET 10 finding #5, **no patch is expected** — this
-     is a confirm-only task.
-- **No code changes expected.** If a patch is needed, it is a one-line
-  fetch-URL fix and the commit message above applies.
+### Task 40.2 — Interpolation expansion in the resolver (REQ-103, backend-engineer)
+- `core/contract_resolver.py`: add `_expand_vars(value, context)` — recursively walks dicts/lists/strings; replaces `${env.<dotted.path>}` and `${contract.<dotted.path>}` tokens by looking up the dotted path in the context dict. Unknown token → `ValueError(f"unresolved interpolation token: {token}")`.
+- `resolve()`: after schema validation, load the env via `environment_check.load(contract["environment"])`, build `context = {"env": env, "contract": contract}`, expand all string values in `contract["inputs"]` (recursively, per D-087), then proceed to IR resolution.
+- The expansion is post-schema-validation (schema sees the raw tokens, which are valid strings) and pre-IR-resolution (the resolver sees concrete values).
+- `tests/test_interpolation.py`: (a) `${env.region}` expands to `us-east-1`; (b) `${env.state_backend.bucket}` expands to `acdl-dev-state`; (c) `${contract.module}` expands to `static-assets`; (d) unknown token raises `ValueError`; (e) nested map value `env: { DB_URL: "acdl-${env.environment}-db" }` expands recursively; (f) `resolve("contracts/static-assets.yaml")` succeeds with expanded values.
+- Verify: `pytest tests/test_interpolation.py` passes.
+
+### Task 40.3 — Sample contracts use naming patterns (REQ-103, backend-engineer)
+- `contracts/static-assets.yaml`: `bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}` (the naming pattern the requirement calls out: region + account id + environment).
+- `contracts/microservice.yaml`: same pattern for `bucket_name`.
+- Keep `region: us-east-1` as a literal (or `${env.region}` — both valid; use `${env.region}` to demonstrate).
+- `tests/test_sample_contracts_interpolate.py`: resolving the sample contracts produces concrete bucket names like `acdl-dev-static-assets-000000000000-us-east-1`.
+- Verify: `pytest tests/test_sample_contracts_interpolate.py` passes; `run_platform.sh --check-only` exits 0 (resolver expands before adapter).
+
+### Must-haves (Phase 40)
+- [ ] `schemas/environment.schema.json` exists; 4 env files validate.
+- [ ] `_expand_vars` in resolver; unknown tokens raise.
+- [ ] Sample contracts use `${env.*}` + `${contract.*}` naming patterns.
+- [ ] `tests/test_environment_schema.py` + `tests/test_interpolation.py` + `tests/test_sample_contracts_interpolate.py` pass.
+- [ ] `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0.
 
 ---
 
-### Wave 3 — lead-developer: run the full Phase 06 verification
+## Phase 41 — per-environment-ci-jobs
 
-The regression gate. Runs only after Wave 1 (moves done) and Wave 2
-(frontend confirmation done).
+**Requirements:** REQ-105, REQ-106
+**Personas:** backend-engineer (lead), security-engineer (HITL gate review)
+**Branch:** `phase/41-per-environment-ci-jobs`
 
-#### T-6.6 — Run `scripts/verify_phase06.sh` + typecheck gate
+### Task 41.1 — Per-env contract files (REQ-105, backend-engineer)
+- `contracts/static-assets.dev.yaml`, `.qa.yaml`, `.prod.yaml`, `.dr.yaml` — each sets `environment:` to its own name; `inputs.bucket_name` uses `${env.environment}-${contract.module}-${env.account_id}-${env.region}` interpolation (so the file content is near-identical; only `environment:` differs).
+- `contracts/microservice.{dev,qa,prod,dr}.yaml` — same pattern.
+- Keep `contracts/static-assets.yaml` + `contracts/microservice.yaml` as the dev default (backwards compat).
+- `tests/test_per_env_contracts.py`: all 8 per-env files validate against `schemas/contract.schema.json`; each resolves to a stack with the correct environment.
+- Verify: `pytest tests/test_per_env_contracts.py` passes.
 
-- **Owner:** lead-developer (territory: `scripts/verify_phase*.sh`).
-- **Files owned:** none (execution-only).
-- **Commit message (if any fixup is needed; otherwise this is a verify
-  run, not a commit):**
-  `phase: 6, status: plan-as-execute, persona: lead-developer, task: T-6.6`
-- **Commands:**
+### Task 41.2 — Deploy workflow `environment` input (REQ-106, backend-engineer)
+- `.github/workflows/deploy.yml` + `.gitea/workflows/deploy.yml` (byte-identical): add `environment` input (`type: string`, default `""`, description "Target environment override (dev/qa/prod/dr); when empty, the contract's environment field is used").
+- `scripts/run_platform.sh`: add `--environment <name>` flag. When set, override the contract's `environment` field at load time (before schema validation per D-088, so interpolation context is consistent). Re-run the onboarding check against the supplied env.
+- The workflow's "Run the platform pipeline" step passes `--environment ${{ inputs.environment }}` when non-empty.
+- `tests/test_deploy_workflow_env_input.py`: both deploy workflows declare the `environment` input; byte-identical; `run_platform.sh --environment qa contracts/static-assets.yaml` produces a stack whose env is qa (tested via the resolver directly since run_platform.sh needs AWS for full mode — test the override logic in the resolver).
+- `core/contract_resolver.py` `resolve()`: accept optional `environment_override` arg; when set, set `contract["environment"] = override` before schema validation + interpolation.
+- Verify: `pytest tests/test_deploy_workflow_env_input.py` passes; both deploy workflows byte-identical.
 
-  ```bash
-  # Typecheck gate (from frontmatter):
-  bash -n demo/scripts/*.sh && echo "demo shell scripts: syntax ok"
-  python3 -m py_compile demo/scripts/*.py && echo "demo python scripts: compile ok"
-  bash -n scripts/verify_phase06.sh && echo "verify_phase06.sh: syntax ok"
+### Task 41.3 — Per-env caller workflow docs + HITL gate structure (REQ-106, security-engineer review)
+- `docs/CONSUMER_GUIDE.md`: add a "Per-environment deployment" section with 4 caller-workflow examples (`.github/workflows/deploy-dev.yml`, `deploy-qa.yml`, `deploy-prod.yml`, `deploy-dr.yml`), each `uses: acdl/.github/workflows/deploy.yml@v1.9` with `environment: <env>` + `contract: .acdl/<module>.<env>.yaml`. Document: "Promotion = running the matching job; no `environment:` field editing."
+- HITL gate structure (wired in Phase 42, documented here): qa/prod/dr caller workflows use `workflow_dispatch` with approval inputs (`approve_qa`, `approve_prod`, `approve_dr`) per `hitl_matrix_design.md` D-042; `gitea.actor` / `github.actor` is the approver of record. dev is autonomous (no gate).
+- `tests/test_consumer_guide_per_env_section.py`: the consumer guide has the per-env section with 4 caller examples.
+- Verify: `pytest tests/test_consumer_guide_per_env_section.py` passes.
 
-  # Test gate (the Phase 06 regression):
-  bash scripts/verify_phase06.sh
-  # Expected output: "Phase 06: ALL CHECKS PASS"
-  # This runs demo/scripts/run_demo.sh --no-upload internally (Check 2).
-  ```
-
-  **On failure:** if `demo/scripts/run_demo.sh --no-upload` fails, the
-  cause is an undetected absolute path in a demo script (R-5 residual
-  0.10). Fix the offending path in `demo/scripts/*.sh` (make it
-  `SCRIPT_DIR`/`REPO_ROOT`-relative) and re-run. If the UI fetch path is
-  broken, Wave 2's frontend-engineer patches `demo/evidence-ui/index.html`.
-
-  **On pass:** Phase 06 is complete. The phase-completion commit +
-  `v1.1.0`-style phase tag (or the v1.1 phase-tagging convention) is
-  created by the execute workflow, not this plan.
+### Must-haves (Phase 41)
+- [ ] 8 per-env contract files exist + validate + resolve.
+- [ ] Deploy workflow has `environment` input (byte-identical Gitea + GitHub).
+- [ ] `run_platform.sh --environment <name>` overrides; resolver supports `environment_override`.
+- [ ] Consumer guide documents per-env caller workflows + promotion-without-editing.
+- [ ] `tests/test_per_env_contracts.py` + `tests/test_deploy_workflow_env_input.py` + `tests/test_consumer_guide_per_env_section.py` pass.
+- [ ] `run_ci.sh` exits 0; both deploy workflows byte-identical.
 
 ---
 
-## Wave ordering (dependency graph)
+## Phase 42 — stub-implementation
 
-```
-Wave 1 (T-6.1, T-6.2, T-6.3, T-6.4)   lead-developer
-   │  moves + scaffold + verify script + README
-   ▼
-Wave 2 (T-6.5)                         frontend-engineer
-   │  confirm demo/evidence-ui/ moved cleanly (no code change expected)
-   ▼
-Wave 3 (T-6.6)                         lead-developer
-      run scripts/verify_phase06.sh (regression + layout + README checks)
-```
+**Requirements:** REQ-107, REQ-108, REQ-109, REQ-110, REQ-111
+**Personas:** security-engineer (lead), backend-engineer (run_platform wiring), lambda-engineer (SNS topic Terraform)
+**Branch:** `phase/42-stub-implementation`
 
-- **Wave 1 → Wave 2:** the UI must be moved before it can be confirmed.
-- **Wave 2 → Wave 3:** the frontend confirmation must precede the full
-  verify (so any UI fetch-path patch is in place before
-  `verify_phase06.sh` runs the demo end-to-end).
-- **Within Wave 1:** T-6.1 (moves) must precede T-6.2 (new dirs — they
-  would collide if `scripts/` still held the v1.0 verify scripts when
-  T-6.3 creates the new top-level `scripts/`). T-6.3 (verify script) can
-  be authored in parallel with T-6.2 but cannot *run* until T-6.1 + T-6.2
-  are committed. T-6.4 (README) is independent of T-6.1..T-6.3 in content
-  but should land in the same wave so the repo is coherent after Wave 1.
+### Task 42.1 — route_halt_artifact real (REQ-107, security-engineer + lambda-engineer)
+- `core/separation_of_duties.py` `route_halt_artifact`: when `ACDL_SOD_HALT_TOPIC_ARN` set, publish to SNS via boto3 (`sns.publish(TopicArn=arn, Message=..., Subject="ACDL SoD halt")`); when unset, fall back to structured stderr emission + a `SEPARATION_OF_DUTIES_VIOLATION` event write via `outbox_writer.write_event` (so the halt is in the audit chain). No silent print-only stub.
+- `terraform/platform/main.tf`: add `aws_sns_topic.acdl-sod-halt` + a basic access policy (allow the platform Lambda / runner role to publish). Output the topic ARN.
+- `tests/test_route_halt_artifact.py`: (a) with `ACDL_SOD_HALT_TOPIC_ARN` set, moto-mocked SNS receives the publish; (b) without it, a `SEPARATION_OF_DUTIES_VIOLATION` event is written to the outbox (moto-mocked DynamoDB); (c) stderr emission occurs in both cases.
+- Verify: `pytest tests/test_route_halt_artifact.py` passes.
 
-  **Strict sub-ordering within Wave 1:** T-6.1 → T-6.2 → T-6.3 (T-6.3
-  creates the new top-level `scripts/` which must not exist during T-6.1's
-  `git mv scripts demo/scripts`). T-6.4 (README + .gitignore) may be done
-  in parallel with T-6.2/T-6.3.
+### Task 42.2 — HITL attestation gates (REQ-108, security-engineer + backend-engineer)
+- `core/hitl_gates.py`: `attest(contract_id, env, approver, evidence, outbox_client=None)` → records `approver_qa`/`approver_prod`/`approver_dr` to the outbox item for `contract_id`; runs `separation_of_duties.check(outbox_client, contract_id, approver)` on prod; invokes the attestation matrix (Task 42.3) for the target env; returns `(ok, reason)`. Dev skips (returns `(True, "dev autonomous")`).
+- `scripts/run_platform.sh`: before apply (for qa/prod/dr), call `hitl_gates.attest` with the approver from `GITHUB_ACTOR`/`GITEA_ACTOR` env. Block on `(ok=False)`.
+- `tests/test_hitl_gates.py`: (a) dev skips; (b) qa records `approver_qa` (moto outbox); (c) prod records `approver_prod` + SoD blocks when `approver_qa == approver_prod`; (d) prod passes when approvers differ.
+- Verify: `pytest tests/test_hitl_gates.py` passes.
 
-## Dependencies
+### Task 42.3 — 8-concern attestation matrix (REQ-109, security-engineer)
+- `core/attestation_matrix.py`: `check(env, evidence_bundle)` → runs the 8 concerns. Offline-testable concerns (contract NFRs, schema validity, policy pass) run for real. Operator-supplied concerns accept an uploaded signed evidence artifact (JSON with `timestamp`, `type`, `payload`, optional `signature`); validate freshness (within the declared window from `hitl_matrix_design.md` §10.4) + schema (per-concern). Signature verification via KMS when `ACDL_ATTESTATION_SIGNING_KEY_ID` set; skipped + logged when unset (D-089). Fail loud if missing/expired for prod/dr.
+- `hitl_gates.attest` calls `attestation_matrix.check(env, evidence)` and blocks on any failing concern.
+- `tests/test_attestation_matrix.py`: (a) offline concerns pass for a valid contract; (b) operator-supplied concern missing → block for prod; (c) operator-supplied concern present + fresh → pass; (d) expired artifact → block; (e) signature skip when key unset (logged).
+- Verify: `pytest tests/test_attestation_matrix.py` passes.
 
-- **v1.0 demo complete + tagged** — satisfied (tag `v1.1.0` present;
-  ROADMAP §v1.0 "complete").
-- **No upstream v1.1 phase dep** — Phase 06 is the first v1.1 phase.
-- **RESEARCH.md TARGET 10** — the authoritative move list + the static
-  analysis confirming no path fixups are needed (conf 0.90; R-5 residual
-  is the only open risk, caught by the Wave 3 regression check).
-- **PERSONAS.md** — Phase 06 active roster: lead-developer + frontend-
-  engineer (demo UI move only). backend/platform/security idle.
+### Task 42.4 — Wiz real API client (REQ-110, security-engineer)
+- `adapters/wiz/wiz_adapter.py`: add `WizClient` class — `__init__` reads `WIZ_API_TOKEN` + `WIZ_API_URL`; `fetch_issues(filter_by)` queries the Wiz GraphQL API (`<url>/graphql`, Bearer auth, `issues` query). Translate results → `PolicyCheckResult` records (`engine: "wiz"`, `ruleId: <control.name>`, `severity: <lowercased>`, `status: FAIL`, `message: <title>`, `resource: <entity.name>`). Graceful degrade: when `WIZ_API_TOKEN` or `WIZ_API_URL` unset → emit the existing single `SKIPPED` `WIZ_NOT_CONFIGURED` record (no network call). Pagination handled via `pageInfo.hasNextPage`.
+- `tests/test_wiz_adapter_real_client.py`: (a) with a recorded GraphQL fixture, `WizClient` translates issues → `PolicyCheckResult` records; (b) graceful degrade when env unset; (c) pagination follows `endCursor`.
+- Verify: `pytest tests/test_wiz_adapter_real_client.py` passes.
 
-## Tasks summary
+### Task 42.5 — Kyverno translator fleshed out (REQ-111, security-engineer)
+- `adapters/kyverno/kyverno_adapter.py`: full `PolicyReport` → `PolicyCheckResult` mapping — handle `pass`/`fail`/`skip`/`warn` results, severity mapping (critical/high/medium/low/info), resource extraction, skip-with-reason handling. Keep the inactive-for-Terraform guard (emits a single `SKIPPED` `KYVERNO_INACTIVE_TF_STACK` record when no K8s manifests). Add a `--kube-version` stub (parsed but not yet used — for future GitOps).
+- `tests/test_kyverno_adapter.py`: expand — (a) `pass` result → `PolicyCheckResult` with `status: PASS`; (b) `fail` with severity → correct severity mapping; (c) `skip` with reason → `SKIPPED` record; (d) inactive-for-TF guard emits the `KYVERNO_INACTIVE_TF_STACK` record.
+- Verify: `pytest tests/test_kyverno_adapter.py` passes.
 
-| Task | Wave | Owner | Territory | Commit message tag |
-|------|------|-------|-----------|--------------------|
-| T-6.1 | 1 | lead-developer | `demo/` (new), moved dirs | `task: T-6.1` |
-| T-6.2 | 1 | lead-developer | `platform/`, `schemas/`, `adapters/`, `terraform/`, `modules-ir/` (new empty) | `task: T-6.2` |
-| T-6.3 | 1 | lead-developer | top-level `scripts/verify_phase06.sh` (new) | `task: T-6.3` |
-| T-6.4 | 1 | lead-developer | `README.md`, `.gitignore` | `task: T-6.4` |
-| T-6.5 | 2 | frontend-engineer | `demo/evidence-ui/index.html` (confirm-only) | `task: T-6.5` |
-| T-6.6 | 3 | lead-developer | (execution: `scripts/verify_phase06.sh`) | `task: T-6.6` |
+### Must-haves (Phase 42)
+- [ ] `route_halt_artifact` real (SNS + outbox fallback); SNS topic in Terraform.
+- [ ] `hitl_gates.py` attests qa/prod/dr; SoD blocks on identity equality.
+- [ ] `attestation_matrix.py` implements 8 concerns (offline-testable + signed artifacts).
+- [ ] Wiz adapter real client + graceful degrade.
+- [ ] Kyverno translator fleshed out + inactive guard preserved.
+- [ ] All 5 new test files pass; `run_ci.sh` exits 0.
 
-All commit messages follow the format:
-`phase: 6, status: plan-as-execute, persona: <name>, task: T-6.N`
+---
 
-## Risks (specific to Phase 06)
+## Phase 43 — verify-review-audit-complete
 
-1. **R-5 (RESEARCH, residual 0.10): undetected absolute path in a demo
-   script.** Mitigation: Wave 3 runs `demo/scripts/run_demo.sh --no-upload`
-   and asserts exit 0. A failure is caught there and fixable in-phase by
-   making the offending path `SCRIPT_DIR`/`REPO_ROOT`-relative. The
-   typecheck gate (`bash -n demo/scripts/*.sh`) catches syntax issues
-   but not path issues — only the runtime regression catches those.
+**Requirements:** — (milestone gate)
+**Personas:** lead-developer (lead), all personas (review participation)
+**Branch:** `phase/43-verify-review-audit-complete`
 
-2. **`contracts-repo/` is tracked and moves with `git mv`.** Verified:
-   `git ls-files contracts-repo/` returns
-   `.gitea/workflows/.gitkeep` + `.gitea/workflows/issue-to-contract.yml`.
-   It is a demo artifact (the v1.0 `acdl-contracts` mirror used by
-   `verify_phase04.sh`). Moving it to `demo/contracts-repo/` is correct;
-   `demo/scripts/verify_phase04.sh` references it via the
-   `ROOT`-relative path `contracts-repo/.gitea/workflows/...` which
-   auto-resolves to `demo/contracts-repo/...` after the move (ROOT =
-   parent of `demo/scripts/` = `demo/`).
+### Task 43.1 — 4-layer verify
+- Structural: all new files present (environment.schema.json, 4 env files, 8 per-env contracts, hitl_gates.py, attestation_matrix.py, SNS topic in main.tf, 5+ new test files).
+- Behavioral: `pytest` passes (count increases from v1.8's 350 by ~30+ new tests); `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0.
+- Security: no hardcoded adapter defaults; HITL gates block on SoD violation; attestation matrix fails loud on missing evidence for prod/dr; Wiz degrades gracefully.
+- Quality: each new feature has dedicated tests (interpolation, per-env jobs, SoD, HITL gates, attestation matrix, Wiz, Kyverno).
 
-3. **`runner-data/` is untracked.** It is moved with plain `mv` (not
-   `git mv`) and gitignored. If a future runner registration recreates it
-   at the repo root, `.gitignore` (updated in T-6.4) keeps it untracked.
+### Task 43.2 — Multi-persona review
+- `ciagent-review` across the v1.9 diff (phases 39–42). Auto-apply P0; flag P1+ for post-hoc.
+- Reconstruct `.ciagent/REVIEW.md` with v1.9 content (D-086). Note that v1.3–v1.8 reviews were not persisted (no git-history rewrite).
 
-4. **`ACDL_DEMO.md` was untracked** (verified: `git status` shows
-   `?? ACDL_DEMO.md`). `git mv` on an untracked file will fail; the
-   executor must `git add` it first (or use `mv` + `git add demo/ACDL_DEMO.md`).
-   The command list in T-6.1 uses `git mv ACDL_DEMO.md demo/ACDL_DEMO.md`
-   — if git rejects it as untracked, fall back to:
-   `mv ACDL_DEMO.md demo/ACDL_DEMO.md && git add demo/ACDL_DEMO.md`.
+### Task 43.3 — Audit
+- Reconstruction: git log matches `.ciagent/` files.
+- File discipline: all `.ciagent/` files valid.
+- Branch hygiene: stale branches cleaned.
+- Commit discipline: all commits have `---ci---` blocks.
 
-5. **`verify_phase05.sh` has an anti-stray check** (lines 159-160:
-   `if [ -d "$ROOT/contracts" ]; then fail "contracts/ directory left in
-   repo root"`). After the move, `ROOT` for `demo/scripts/verify_phase05.sh`
-   is `demo/`, and `demo/contracts/` *does* exist — so this check would
-   fail if the v1.0 verify script is re-run from `demo/`. This is
-   expected: the v1.0 verify scripts are *archived demo artifacts*, not
-   re-run after Phase 06. The v1.1 verify script
-   (`scripts/verify_phase06.sh`) supersedes them. No action needed beyond
-   documenting that v1.0 verify scripts are not re-run post-archive.
+### Task 43.4 — Complete
+- Update `.ciagent/REQUIREMENTS.md`: mark REQ-100..REQ-111 complete; add v1.9 traceability table.
+- Update `.ciagent/ROADMAP.md`: add v1.9 milestone section (complete).
+- Update `.ciagent/PROJECT.md`: v1.9 status → complete.
+- Tag `v1.9.0`; update floating `v1.9` + `v1` tags.
+- Bump `uses:`/`ref:` from `@v1.6` → `@v1.9` in `contracts/*.yaml`, `deploy.yml` checkout `ref:`, `docs/CONSUMER_GUIDE.md` (D-071 successor).
+- Commit: `docs(milestone): complete v1.9`.
+
+### Must-haves (Phase 43)
+- [ ] 4-layer verify PASS.
+- [ ] Review: 0 new P0; P1+ flagged for post-hoc.
+- [ ] Audit: clean.
+- [ ] Tag `v1.9.0` created; floating tags updated.
+- [ ] `uses:`/`ref:` bumped to `@v1.9`.
+- [ ] REQUIREMENTS.md + ROADMAP.md + PROJECT.md updated.
+
+---
+
+*End of PLAN.md.*

.ciagent/PROJECT.md

@@ -50,14 +50,14 @@ traceable to a human attestation and an immutable evidence stream.
   boundary. The platform validates, enriches with operational standards,
   and reconciles the target state.
 
-## Objective for Milestone v1.1
+## Objective for Milestone v1.1 (prior — complete, tag `v1.2.0`)
 
 Finalize the architecture to v1.0 (resolve all 11 open design decisions in
 `docs/architecture.md` §13) and prove the locked commitments with one
 end-to-end v1 implementation spike:
 
 - **One L1 module** (`l1-s3`) — substrate-agnostic, IR-typed interface.
-- **One L2 thin-composition** (`l2-static-asset`) — references the L1.
+- **One L2 thin-composition** (`l2-static-assets`) — references the L1.
 - **Terraform adapter** — compiles the IR to a real `terraform plan`
   against AWS via OIDC (no long-lived credentials, per §12.5).
 - **One contract submission** → contract→IR resolution →
@@ -67,7 +67,11 @@ end-to-end v1 implementation spike:
 The spike validates the architecture's claim that the IR-shaped commitments
 do not require a polyglot mess (`docs/architecture.md` §14, step 2).
 
-## Milestone v1.1 Phases
+**Status: COMPLETE — all 5 phases shipped (v1.1.1..v1.1.5) + verified; review
+READY TO SHIP (0 P0); audit CLEAN; milestone tag `v1.2.0`; Gitea release
+id 202 published. D-034 closed (root key deactivated by user).**
+
+## Milestone v1.1 Phases (prior — complete)
 
 | Phase | Name | Goal |
 |-------|------|------|
@@ -75,10 +79,328 @@ do not require a polyglot mess (`docs/architecture.md` §14, step 2).
 | 07 | architecture-v1-finalization | Resolve the 11 open decisions → architecture v1.0. Author IR JSON Schema, PolicyCheckResult schema, contract schema, confidence-signal spec, HITL matrix, outbox/ledger design under `schemas/` + `platform/`. |
 | 08 | aws-oidc-bootstrap | One-shot use of a temporary long-lived key (waiver D-034) to create an IAM role + OIDC trust policy for the act_runner, an S3 state bucket, and a DynamoDB lock table. Rotate the key. Verify the runner assumes the role via OIDC with no long-lived secret. |
 | 09 | v1-spike-ir-and-l1-and-adapter | Target Stack IR; one real L1 (`l1-s3`) with IR-typed interface; L1 registry; Terraform adapter (IR → Terraform var/output + `terraform plan`) running against AWS via OIDC. |
-| 10 | v1-spike-l2-and-contract-e2e | One L2 thin-composition (`l2-static-asset`) referencing `l1-s3`; contract schema + contract→IR resolution; one end-to-end contract submission → `terraform plan` → Checkov → confidence signal → evidence event to outbox. Verify the IR commitments hold. |
+| 10 | v1-spike-l2-and-contract-e2e | One L2 thin-composition (`l2-static-assets`) referencing `l1-s3`; contract schema + contract→IR resolution; one end-to-end contract submission → `terraform plan` → Checkov → confidence signal → evidence event to outbox. Verify the IR commitments hold. |
 
 Milestone COMPLETE gate: review → ship `v1.2.0` (feature milestone, next
-minor per ship.md) → audit.
+minor per ship.md) → audit. **DONE.**
+
+## Objective for Milestone v1.2 (prior — complete)
+
+Platform hardening + first real consumer deployment. The v1.1 spike proved
+the IR commitments hold on a single dev-only `terraform plan` for one S3
+bucket. v1.2 takes the spike to a real, simpler, better-documented platform
+that actually delivers a microservice to AWS ECS Fargate end-to-end.
+
+Five scope axes (user-directed, 2026-07-21):
+
+1. **Re-evaluate the current state.** Confirm go-gitea/gitea#36988 (OIDC for
+   Gitea Actions) is still unmerged (re-checked 2026-07-21: **open**, last
+   updated 2026-05-27). Extend the D-039 per-run-rotated-key waiver for
+   v1.2; real OIDC is deferred to v1.3+ (D-047).
+2. **NFR improvements on the existing spike.** Least-privilege IAM audit,
+   idempotent bootstrap, proper exit codes / error handling, rotation
+   hygiene, P1-1 / P1-B redaction carried forward from the v1.1 audit.
+3. **Streamline / simplify the current setup.** Consolidate the
+   `run_spike_*.sh` scripts into one `scripts/run_platform.sh`; remove
+   dead code and stale paths; one command runs the whole pipeline.
+4. **README.md fully up to date on how the platform works.** The current
+   README still says "v1.1 (active)" — it must reflect v1.1 complete, the
+   actual spike flow, how to run it, the real repo layout, and the v1.2
+   objective.
+5. **Bootstrap a consumer repo with a basic microservice deployed to ECS
+   end-to-end.** New Gitea repo `acdl-consumer-microservice` (org
+   `continuous-intelligence`) holding a tiny HTTP container + Dockerfile;
+   new IR-typed L1s (`l1-vpc`, `l1-ecs-cluster`, `l1-ecs-service`,
+   `l1-iam-role`, `l1-alb`, `l1-ecr`); new `l2-microservice`
+   thin-composition; one contract submission → `terraform apply` (dev,
+   autonomous) → a live ECS Fargate service serving HTTP 200 → evidence
+   event to the DynamoDB outbox → acdl-evidence timeline.
+
+The milestone proves the platform delivers real value (a running
+microservice), not just a plan.
+
+## Milestone v1.2 Phases
+
+| Phase | Name | Goal |
+|-------|------|------|
+| 11 | v1.2-research-and-readme | Re-eval #36988 (confirm open → extend D-039 as D-047). Audit the v1.1 spike for NFR gaps (least-privilege, idempotency, error handling, rotation hygiene) + simplification opportunities. **Rewrite README.md** to reflect v1.1 complete + how the platform actually works (spike flow, how to run, repo layout, v1.2 objective). Output: RESEARCH.md v1.2 addendum; updated README. |
+| 12 | nfr-harden-and-simplify | Apply Phase 11 findings: tighten `spike_runner_policy.json` (least-privilege audit); make `terraform/bootstrap/create_*.py` idempotent; consolidate `run_spike_*.sh` → one `scripts/run_platform.sh`; proper exit codes / error handling; redact P1-1 AWS key IDs in `VERIFY.md`; fix any remaining stale `platform/` paths. Spike still runs e2e after the refactor. |
+| 13 | l1-catalog-for-ecs | Author IR-typed L1s for an ECS Fargate microservice: `l1-vpc`, `l1-ecs-cluster`, `l1-ecs-service`, `l1-iam-role` (task + exec role), `l1-alb`, `l1-ecr`. Register all in `modules-ir/registry.json`. Expand the Terraform adapter `TYPE_MAP`. Each L1 produces a valid `terraform plan` fragment. |
+| 14 | l2-microservice-and-contract-schema | Author `l2-microservice` thin-composition (references the ECS L1s, depth ≤ 5). Extend `schemas/contract.schema.json` for microservice inputs (image, port, env, healthcheck). Verify contract→IR resolution yields a complete target stack. |
+| 15 | consumer-repo-and-terraform-apply | Create consumer repo `acdl-consumer-microservice` (Gitea org) with a basic microservice (tiny HTTP container + Dockerfile + ECR push). Lift the platform from `plan` → **`apply`** (dev, autonomous per §10). Submit `contracts/microservice.yaml` → pipeline → IR → plan → apply → a real ECS Fargate service running. |
+| 16 | v1.2-capstone-e2e | End-to-end verification: consumer commit → pipeline → ECS service live serving HTTP 200 → evidence event to the DynamoDB outbox → acdl-evidence timeline renders it. Verify NFR improvements hold, the setup is simpler (one `run_platform.sh`), and the README is accurate. |
+
+Milestone COMPLETE gate: review → ship `v1.3.0` (feature milestone, next
+minor per ship.md — v1.1 shipped `v1.2.0`) → audit.
+
+## Objective for Milestone v1.4 (active)
+
+Central pipeline contract + shell reproducibility + output streaming. The
+v1.3 milestone (Phases 17–18) created identical CI/CD pipelines for Gitea
+and GitHub but they were duplicated copies with no single source of truth.
+v1.4 makes the pipeline a declarative contract, enables full shell
+reproducibility, and streams terraform/checkov output so users can see
+what the platform is doing.
+
+Three scope axes:
+
+1. **Central pipeline contract.** A JSON Schema
+   (`schemas/pipeline.schema.json`) + YAML instance (`pipelines/ci.yaml`)
+   declares the pipeline stages, commands, triggers, and runner. Both
+   `.gitea/workflows/ci.yml` (Gitea Actions, dev) and
+   `.github/workflows/ci.yml` (GitHub Actions, production) implement the
+   contract. A test validates conformance.
+2. **Shell reproducibility.** `scripts/run_ci.sh` mirrors the CI pipeline
+   locally — runs the same 3 stages (lint, test, check-only) in sequence.
+   The pipeline is fully reproducible from the shell, not just in CI.
+3. **Output streaming.** `scripts/run_platform.sh` streams terraform
+   init/validate/plan output, Checkov compliance results, and
+   PolicyCheckResult records to stdout by default, so the user sees what
+   is happening. A `--quiet` flag suppresses streaming for log-only mode.
+
+## Milestone v1.4 Phases
+
+| Phase | Name | Goal |
+|-------|------|------|
+| 19 | central-pipeline-contract-and-shell-reproducibility | Create the central pipeline contract (JSON Schema + YAML instance). Create `scripts/run_ci.sh` for shell reproducibility. Update `run_platform.sh` to stream terraform/checkov output. Update both workflow YAMLs with contract references (staying byte-identical). Add tests for contract validation, workflow conformance, and streaming. |
+
+Milestone COMPLETE gate: review → ship `v1.4.1` (feature milestone, next
+minor per ship.md — v1.3 shipped `v1.3.2`) → audit.
+
+## Objective for Milestone v1.7 (complete)
+
+Production platform + contract ingestion + pipeline maturation. The v1.6
+milestone left the platform documented and environments-aware; v1.7 took it
+to a production-grade platform. 12 user-directed scope axes (2026-07-22):
+
+1. **Rename `static-assets` → `static-assets`** (D-048 — including
+   `.ciagent/` historical narrative, overriding the v1.6 preservation
+   precedent). The reconstruction test is updated to expect `static-assets`.
+2. **Augment `static-assets` to a production-ready stack** by authoring a
+   new `cloudfront` primitive + a `waf` primitive (D-049: S3 + CloudFront
+   OAC + WAF; Route53/ACM are domain-dependent and deferred to documented
+   extension points).
+3. **DX-friendly deploy outputs** (D-050): SSM Parameter Store (KMS-encrypted
+   `SecureString`) for runtime-injectable values + GitHub PR comment / job
+   summary for human-readable connection strings. No raw secrets in logs.
+4. **Central deploy pipeline error reporting** via the platform Lambda
+   `report_error` action (D-055): the Lambda creates a GitHub issue on the
+   platform repo. The consumer's onboarding-granted Lambda-invoke permission
+   is the only grant needed — uniform pathway, no separate GitHub
+   `issues: write` on the consumer side. Gitea is excluded (only the CIAgent
+   uses it).
+5. **PR comments after every successful stage** so developers always know
+   where they stand.
+6. **Three platform pipelines**: (1) platform-test (PR, unit + integration +
+   schema-validation); (2) primitives-plan (PR, plan-only for all L1
+   primitives); (3) patterns-plan (PR, plan-only for all L2 modules).
+7. **Release job** on merge to `main`: computes MAJOR.MINOR.PATCH semver,
+   creates the tag, then updates (force-moves) or creates the MAJOR.MINOR +
+   MAJOR floating tags (D-057). Consumers on `@v1` or `@v1.6` receive updates
+   depending on their pinned version.
+8. **Platform Lambda** for one-way consumer→platform communication
+   (contracts). Onboarding grants the consumer repo's environment the right
+   to trigger the Lambda (cross-account IAM). The Lambda ingests contracts
+   and stores them in a DynamoDB table `acdl-contracts` (D-051) for
+   historical reference, impact analysis, CMDB-style application-state
+   queries, and pattern detection. The IAM policy reflects cross-account
+   invocation.
+9. **Tagging standards** in policy/compliance checks (D-054): a required-tag
+   set (`acdl:owner`, `acdl:contract`, `acdl:environment`, `acdl:cost-center`)
+   enforced by a Checkov custom YAML rule. Closes the D-043 deferral (the
+   SKIPPED `ACDL_TAG_NAMING` placeholder becomes a real check).
+10. **Wiz adapter** for security checks (D-052): a stub + schema path that
+    translates Wiz API issues → `PolicyCheckResult` records, degrading
+    gracefully when unconfigured. Matches the Checkov adapter pattern.
+11. **Kyverno adapter** for compliance/security checks (D-053): a
+    K8s-native policy adapter that translates Kyverno `PolicyReport` results
+    → `PolicyCheckResult` records. Ready but inactive for Terraform-only
+    stacks (the platform emits Terraform, not K8s manifests); it activates
+    when the GitOps reconciler (roadmap) emits K8s manifests.
+12. **Remove the legacy consumer-repos directory** and add validated per-module examples
+    (D-058: `modules/<name>/examples/` with `simple.yaml` + `complex.yaml`
+    validated in CI) + a new RDS primitive demonstrating multi-engine
+    variation (D-059).
+
+## Milestone v1.7 Phases
+
+| Phase | Name | Goal |
+|-------|------|------|
+| 22 | rename-and-production-static-assets-stack | Rename `static-assets` → `static-assets` everywhere (D-048). Author `cloudfront` + `waf` primitives. Augment `static-assets` to S3 + CloudFront (OAC) + WAF (D-049). Expand adapter. Bump `uses:` to `@v1.6`; create floating `v1.6` + `v1` tags (D-057). |
+| 23 | tagging-standards-and-security-adapters | Required-tag set + Checkov custom rule (D-054, D-043 closure). Wiz adapter stub (D-052). Kyverno K8s-native adapter (D-053). Schema engine enum updated. |
+| 24 | platform-lambda-and-contract-ingestion | Platform Lambda + DynamoDB `acdl-contracts` table (D-051) + cross-account IAM + onboarding grant. |
+| 25 | deploy-pipeline-dx-outputs-and-error-reporting | SSM SecureString + PR comment outputs (D-050). Lambda `report_error` → GitHub issue (D-055). Stage comments after each successful stage. |
+| 26 | platform-pipelines-and-release-automation | 3 platform pipelines (platform-test, primitives-plan, patterns-plan). Release job with semver + MAJOR.MINOR/MAJOR tag updates (D-057). |
+| 27 | remove-legacy-consumer-repos-and-module-documentation-examples | Delete the legacy consumer-repos directory. RDS primitive (D-059). Validated per-module examples (D-058). Docs updates. |
+
+Milestone COMPLETE gate: review → ship `v1.7.0` (feature milestone, next
+minor per ship.md — v1.6 shipped `v1.6.0`) → audit.
+
+## Objective for Milestone v1.8 (active)
+
+P1 remediation + uptime monitoring + engineering standards + encryption
+and deletion-protection by default + decommission alias + documentation.
+The v1.7 milestone shipped production platform + contract ingestion but
+left 8 P1 issues flagged for post-hoc review. v1.8 clears all of them
+AND delivers three user-directed feature/NFR tracks (2026-07-22):
+
+**Track 1 — P1 Remediation (Phases 28–30):**
+Clear all 8 pending P1 issues from v1.5/v1.6/v1.7 verify reviews:
+- P1-3: SSM uses AWS-managed key silently → fail loud without CMK config
+- P1-4: WAF custom rules emit invalid HCL (attribute vs block syntax)
+- P1-5: WAF default_action input silently ignored
+- P1-6: consumer_invoke_policy.json has placeholder account ID
+- P1-7: L2 composition outputs section not implemented in resolver
+- P1-8: terraform/spike/*.tf overwritten by run_platform.sh (state
+  contamination)
+- P1-9: GitHub API URLs hardcoded in contract_ingestor.py (Gitea fails
+  silently)
+- S1: Deploy workflow static-key override not wired (passes ACDL_AWS_*
+  env vars to configure-aws-credentials which reads AWS_*/its own inputs)
+
+**Track 2 — Encryption + Deletion Protection by Default (Phases 31–32):**
+All primitives encrypted by default (CMK priority + SSE, managed KMS
+fallback). Per-stack CMK (one key per L2 deployment, 90-day rotation,
+no shared keys). Deletion protection on by default for every primitive.
+L2 modules expose a feature flag to turn off deletion protection. A
+decommission alias uses a 2-step pipeline (disable deletion protection
+→ zero counts → destroy) with HITL SRE gates and CMDB-validated change
+request ID.
+
+**Track 3 — Uptime + Standards + Docs (Phases 33–36):**
+A new uptime-kuma primitive (ECS Fargate) deployed by default after any
+L2 module deploy (separate terraform state), with a feature flag to
+disable. Monitored endpoints passed from L2 outputs. Alert channels
+(Teams/email/SMS/GitHub issues). The uptime URL published to consumers
+via PR comments. Engineering standards for L1 + L2 module authoring
+(scanned from current modules, stored in modules/). READMEs for
+schemas/, adapters/, pipelines/ paths documenting how to write, wire,
+and test each.
+
+## Milestone v1.8 Phases
+
+| Phase | Name | Goal |
+|-------|------|------|
+| 28 | adapter-waf-and-resolver-outputs | Fix WAF HCL emission (nested rules blocks + default_action input) + implement L2 composition outputs in resolver + adapter output blocks. P1-4, P1-5, P1-7. |
+| 29 | ssm-kms-and-invoke-policy | SSM publisher fails loud without CMK (escape hatch for local) + Terraform-rendered consumer_invoke_policy (no placeholder account ID). P1-3, P1-6. |
+| 30 | run-platform-isolation-and-api-portability | Adapter output to per-run temp dir (remove committed spike .tf) + forge-agnostic API URLs + deploy.yml static-key override wired. P1-8, P1-9, S1. |
+| 31 | encryption-by-default-and-per-stack-cmk | KMS-key primitive + per-stack CMK wired in L2 modules + encryption NFRs on all primitives + managed KMS fallback. |
+| 32 | deletion-protection-by-default-and-l2-feature-flag | Deletion protection NFR on all primitives (default true) + L2 feature flag + contract schema update. |
+| 33 | uptime-kuma-primitive | Uptime L1 primitive (ECS Fargate, feature flag, monitored endpoints, alert channels) + deploy-uptime pipeline stage (separate state) + URL published via PR comment. |
+| 34 | decommission-alias-and-cmdb-validation | Decommission mode on deploy pipeline (2-step: disable deletion protection → zero counts, HITL SRE gates) + DynamoDB CMDB validation + consumer guide docs. |
+| 35 | module-engineering-standards | modules/STANDARDS.md (L1+L2 authoring + review standards scanned from current modules) + catalog index fix + template update + automated standards test. |
+| 36 | schemas-adapters-pipelines-readmes | schemas/README.md + pipelines/README.md + adapters/README.md (how to write, wire, test, dependencies). |
+| 37 | verify | 4-layer verification of all v1.8 phases. |
+| 38 | review-audit-complete | Multi-persona review + audit + milestone completion (tag v1.8.0). |
+
+Milestone COMPLETE gate: review → ship `v1.8.0` (feature milestone, next
+minor per run.md — v1.7 shipped `v1.7.0`) → audit.
+
+## Objective for Milestone v1.9 (complete, tag `v1.9.0`)
+
+Production-grade progression: contract interpolation, per-environment
+promotion without field editing, stub implementation, and P1-1
+remediation. The v1.8 milestone shipped encryption/deletion-protection by
+default, uptime, decommission, and engineering standards but left four
+gaps that v1.9 closes (user-directed, 2026-07-23):
+
+1. **Design doc refresh.** `core/hitl_matrix_design.md` and
+   `core/audit_ledger_design.md` are stale — both still describe the
+   v1.1 spike scope ("dev-only; HITL not exercised"; "spike scope =
+   hash chain + outbox write; Object Lock + JWS are v1.2"). v1.9 brings
+   them up to date with the shipped v1.8 platform and the v1.9 wiring.
+2. **Contract interpolation (variable expansion).** Contracts cannot
+   reference environment onboarding values today — bucket names, account
+   IDs, regions are hardcoded literals. v1.9 adds `${env.<field>}` and
+   `${contract.<field>}` expansion in the resolver, sourced from the
+   environment onboarding JSON. Naming patterns like
+   `acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}`
+   become expressible. The S3 bucket naming-pattern requirement is the
+   binding example.
+3. **Per-environment CI jobs (no field editing for promotion).** Today a
+   promotion dev → qa requires editing the `environment:` field in the
+   contract YAML. v1.9 ships a hybrid model: (a) per-environment contract
+   files (`.acdl/static-assets.dev.yaml`, `...qa.yaml`, etc.) and (b) an
+   `environment` `workflow_call` input on the reusable deploy workflow
+   that overrides the contract's environment at load time. There is one
+   CI job per environment, each pointing at its respective contract (or
+   the same contract + the env input). Promotion = running the matching
+   job; no field editing.
+4. **Stub implementation.** Identify and implement the stubbed
+   functionality: `separation_of_duties.route_halt_artifact` (logs only →
+   real SNS + outbox event); HITL qa/prod/dr pre-execution attestation
+   gates (only decommission SRE gates are wired today); the full
+   8-concern attestation matrix (offline-testable subset implemented;
+   operator-supplied concerns accept signed evidence artifacts); the Wiz
+   adapter (stub → real API client with graceful degrade); the Kyverno
+   adapter (fleshed out translator, still inactive for Terraform-only
+   stacks). The audit-ledger S3 Object Lock + JWS + async worker + DLQ +
+   daily checkpoints build-out is **deferred** to a future milestone
+   (D-083) — it requires non-offline-testable AWS infra (Object Lock
+   bucket, KMS signing key, SQS DLQ, Lambda worker).
+5. **Post-hoc requirement from previous milestones.** P1-1 from the v1.2
+   review (adapter ECS/ALB/VPC hardcoded defaults — `desired_count = 1`,
+   `launch_type = "FARGATE"`, `target_type = "ip"`,
+   `load_balancer_type = "application"`, `family = "app"`, `Name = ...`
+   — should be parameterized via the L1 interfaces, deferred to v1.3,
+   never implemented) is closed. The adapter becomes a thin translator;
+   the defaults move into `interface.json` inputs.
+
+The milestone also reconstructs `.ciagent/REVIEW.md`, which still holds
+v1.2 review content (v1.3–v1.8 reviews were not persisted). The v1.9
+review overwrites it with current milestone content; a note records the
+historical gap (no git-history rewrite).
+
+## Milestone v1.9 Phases
+
+| Phase | Name | Goal |
+|-------|------|------|
+| 39 | design-doc-refresh-and-p1-1-parameterization | Refresh `hitl_matrix_design.md` + `audit_ledger_design.md` to current. Move adapter ECS/ALB/VPC hardcoded defaults into L1 `interface.json` inputs (P1-1 closure). |
+| 40 | contract-interpolation | `${env.<field>}` + `${contract.<field>}` resolver expansion from environment onboarding JSON. Environment JSON schema. Sample contracts use naming patterns (region + account id + environment). |
+| 41 | per-environment-ci-jobs | Per-env contract files + `environment` workflow_call input on the deploy workflow. 1 CI job per environment (dev/qa/prod/dr), each pointing at its respective contract. HITL attestation gate structure wired (qa/prod/dr). |
+| 42 | stub-implementation | `route_halt_artifact` real (SNS + outbox). HITL qa/prod/dr attestation gates. 8-concern attestation matrix (offline-testable subset). Wiz real client. Kyverno translator fleshed out. |
+| 43 | verify-review-audit-complete | 4-layer verify. Multi-persona review. Audit. Complete v1.9 (tag `v1.9.0`, floating tags, `uses:` bump `@v1.6` → `@v1.9`). |
+
+Milestone COMPLETE gate: review → ship `v1.9.0` (feature milestone, next
+minor per run.md — v1.8 shipped `v1.8.0`) → audit.
+
+## Patch v1.9.1 (complete, tag `v1.9.1`)
+
+Docs-only NFR patch on the v1.9 line. Two leadership-facing presentation
+decks (How the Platform Works + The Developer Experience) for senior
+leadership (CTO, Head of Cloud, Head of Infrastructure, Head of DevOps).
+Each deck has a full markdown source of truth (with speaker notes + mermaid
+diagrams) and a lean Marp deck (no speaker notes, embedded PNG diagrams). A
+README documents the 3-step slide creation process (full markdown → Marp
+synthesis → PPTX export) with conventions, build commands, and maturity
+framing rules. No code changes; 494 tests pass; `run_ci.sh` +
+`run_platform.sh --check-only` green.
+
+## Patch v1.9.2 (complete, tag `v1.9.2`)
+
+Docs-only NFR patch on the v1.9 line. Applies the S&P Global Energy brand
+visual identity to both Marp presentation decks. Brand colors extracted
+from the live spglobal.com compiled Tailwind CSS and SVG logo: red-core
+`#D6002A`, grey-90 `#1B1B1B`, grey-80 `#2E2E2E`, grey-5 `#F0F0F0`, Akkurat
+Pro corporate typeface. Title headers changed to full platform name.
+Footer changed from 'Confidential · For Senior Leadership' to 'Internal'.
+Title slide subtitle removed. Last DX slide renamed from 'The Outcome for
+Leadership' to 'The Desired Outcomes'. Marp `theme: default` kept as base.
+No code changes; 494 tests pass; `run_ci.sh` + `run_platform.sh --check-only`
+green.
+
+## Patch v1.9.3 (complete, tag `v1.9.3`)
+
+Docs-only NFR patch on the v1.9 line. Renders both Marp presentation decks
+to self-contained HTML (committed to `docs/presentations/`, base64-embedded
+images, full S&P Global Energy brand theme) and PPTX (uploaded to the Gitea
+release as downloadable attachments). The HTML files are viewable in any
+browser and on the git forge — they render the red accent bar, dark
+title-slide background, red H1 headings, and Akkurat Pro font stack. README
+updated to document HTML as committed artifacts (re-render when Marp source
+changes) and PPTX as release attachments (binary, not committed to git).
+No code changes; 494 tests pass; `run_ci.sh` + `run_platform.sh --check-only`
+green.
 
 ## Requirements
 
@@ -88,9 +410,9 @@ Status: complete. Tag `v1.1.0`. All REQ-01..15 satisfied by the stub-driven
 executive demo. See `REQUIREMENTS.md` §v1 and the prior decisions table
 appendix below. The demo is **archived** to `demo/` in Phase 06.
 
-### v1.1 (Active milestone — architecture finalization + v1 spike)
+### v1.1 (Prior milestone — architecture finalization + v1 spike, complete)
 
-New requirements REQ-16..REQ-2x — see `REQUIREMENTS.md` §v1.1. Summary:
+New requirements REQ-16..REQ-28 — see `REQUIREMENTS.md` §v1.1. Summary:
 
 - **REQ-16:** Architecture finalized to v1.0 (11 open decisions resolved).
 - **REQ-17:** Target Stack IR defined as JSON Schema; substrate-agnostic.
@@ -106,7 +428,7 @@ New requirements REQ-16..REQ-2x — see `REQUIREMENTS.md` §v1.1. Summary:
 - **REQ-23:** AWS OIDC bootstrap (IAM role + trust policy for act_runner);
   the long-lived key is used once then rotated (waiver D-034).
 - **REQ-24:** One real L1 module (`l1-s3`) with an IR-typed interface.
-- **REQ-25:** One real L2 thin-composition (`l2-static-asset`) referencing
+- **REQ-25:** One real L2 thin-composition (`l2-static-assets`) referencing
   `l1-s3`.
 - **REQ-26:** Terraform adapter compiles the IR to a real `terraform plan`
   against AWS via OIDC; state in S3 + DynamoDB.
@@ -115,6 +437,62 @@ New requirements REQ-16..REQ-2x — see `REQUIREMENTS.md` §v1.1. Summary:
 - **REQ-28:** Spike verification proves the IR-shaped commitments hold (no
   polyglot mess; the adapter is the only substrate-specific code).
 
+### v1.2 (Prior milestone — platform hardening + first real consumer deployment, complete)
+
+New requirements REQ-29..REQ-35 — see `REQUIREMENTS.md` §v1.2. Summary:
+
+- **REQ-29:** README.md fully documents the v1.1-complete platform: spike
+  flow, how to run, repo layout, v1.2 objective.
+- **REQ-30:** NFR hardening — least-privilege IAM audit, idempotent
+  bootstrap, consolidated `run_platform.sh`, error handling, P1-1/P1-B
+  redaction.
+- **REQ-31:** L1 catalog expanded for ECS — 6 new IR-typed L1s
+  (`l1-vpc`, `l1-ecs-cluster`, `l1-ecs-service`, `l1-iam-role`, `l1-alb`,
+  `l1-ecr`) registered and adapter-compiled.
+- **REQ-32:** `l2-microservice` thin-composition + contract schema extended
+  for microservice inputs (image, port, env, healthcheck).
+- **REQ-33:** `terraform apply` (dev, autonomous) — real provisioning, not
+  just `plan`.
+- **REQ-34:** Consumer repo `acdl-consumer-microservice` with a basic
+  microservice (ECR image, Dockerfile, contract).
+- **REQ-35:** End-to-end verification — consumer commit → live ECS service
+  (HTTP 200) → evidence event → timeline.
+
+### v1.4 (Prior milestone — central pipeline contract + shell reproducibility + streaming)
+
+New requirements REQ-43..REQ-45 — see `REQUIREMENTS.md` §v1.4. Summary:
+
+- **REQ-43:** Central pipeline contract — `schemas/pipeline.schema.json` +
+  `pipelines/ci.yaml`. Both Gitea and GitHub workflows implement the
+  contract; a test validates conformance.
+- **REQ-44:** `scripts/run_ci.sh` mirrors the CI pipeline locally (lint →
+  test → check-only), exiting 0 with "CI PIPELINE OK".
+- **REQ-45:** `scripts/run_platform.sh` streams terraform/checkov output by
+  default (with `--quiet` for log-only mode). Both workflows byte-identical.
+
+## Key Decisions (v1.9)
+
+Resolved at the CLARIFY stage (full autonomy — all within locked
+constraints or user-directed scope). New v1.9 decisions (numbered
+D-080+ to avoid collision with v1.8 research decisions D-073..D-077):
+
+| ID | Decision | Rationale | Outcome |
+|----|----------|-----------|---------|
+| D-080 | New milestone v1.9 (feature); ship tag `v1.9.0`. | v1.8 is complete (audit PASS, tag v1.8.0). The work (design doc updates + interpolation + per-env CI + stubs + P1-1) is a new feature milestone, not v1.8 post-hoc patching. | 5 phases (39–43) in one milestone. |
+| D-081 | Interpolation syntax: `${env.<field>}` + `${contract.<field>}` (dotted paths supported, e.g. `${env.state_backend.bucket}`). Expanded by the resolver post-schema-validation, pre-IR-resolution. Fail loud on unresolved tokens (`ValueError`). | Shell-style syntax is familiar, unambiguous, and has no conflict with YAML or the contract schema. The `env` context is the loaded environment onboarding JSON; `contract` is the contract dict. | Phase 40 implements the expansion + environment JSON schema. |
+| D-082 | Hybrid per-environment promotion model: (a) per-env contract files AND (b) an `environment` `workflow_call` input on the reusable deploy workflow that overrides the contract's environment at load time. One CI job per environment. | User chose to support both shapes. Per-env contracts let env-specific values differ via interpolation; the env input lets a single contract be promoted without editing. Promotion = running the matching job; no `environment:` field editing. | Phase 41 ships per-env contracts + the env input + caller-workflow docs. |
+| D-083 | Audit ledger S3 Object Lock + JWS detached signatures + async worker + DLQ + daily checkpoints **deferred** to a future milestone. | Requires non-offline-testable AWS infra (Object Lock bucket, KMS signing key, SQS DLQ, Lambda worker). The hash-chain + DynamoDB-outbox path remains the v1.9 production audit record. `audit_ledger_design.md` marks this clearly. | Phase 39 updates the design doc; no build-out in v1.9. |
+| D-084 | 8-concern attestation matrix: offline-testable concerns (contract NFRs, schema validity, policy pass) run for real; operator-supplied concerns (k6 load test, DR drill, FinOps forecast) accept signed evidence artifacts validated for freshness + schema, failing loud if missing/expired for prod/dr. | The platform cannot run live load tests / DR drills / FinOps forecasts inline. Accepting signed evidence artifacts with freshness + schema validation is the regulatorily-defensible middle ground. | Phase 42 implements `core/attestation_matrix.py`. |
+| D-085 | P1-1 closure: adapter ECS/ALB/VPC hardcoded defaults (`desired_count = 1`, `launch_type = "FARGATE"`, `target_type = "ip"`, `load_balancer_type = "application"`, `family = "app"`, `Name = ...`) move into L1 `interface.json` inputs with defaults. The adapter reads inputs (falling back to interface defaults) and is a thin translator. | P1-1 was flagged in the v1.2 review (deferred to v1.3, never implemented). Defaults belong in the L1 interface, not the adapter. | Phase 39 closes P1-1. |
+| D-086 | `.ciagent/REVIEW.md` reconstructed at v1.9 complete; v1.3–v1.8 reviews noted as not-persisted (no git-history rewrite). | REVIEW.md still holds v1.2 content — later milestone reviews were not persisted or were overwritten. The v1.9 review overwrites it with current content; a note records the historical gap. | Phase 43 reconstructs REVIEW.md. |
+
+### CLARIFY auto-resolved parameters (full autonomy)
+
+| Parameter | Value | Rationale |
+|---|---|---|
+| Per-env `qa.json/prod.json/dr.json` account_id | `000000000000` placeholder + stderr warning at load if account_id is `000000000000` and env ≠ dev | Consistent with `dev.json`; prompts real binding without breaking offline tests. |
+| SNS topic for `route_halt_artifact` | Defined in `terraform/platform/main.tf` AND code reads `ACDL_SOD_HALT_TOPIC_ARN` | Consistent with the existing Lambda/KMS/Secrets pattern (Terraform defines, code reads env). |
+
 ## Constraints
 
 - **Forge:** Gitea at `https://git.cloudinit.dev`, org `continuous-intelligence`.
@@ -157,9 +535,9 @@ decisions:
 
 | ID | Decision | Rationale | Outcome |
 |----|----------|-----------|---------|
-| D-034 | Temporary long-lived AWS key (waiver) used once in Phase 08 to bootstrap OIDC trust; rotated immediately after | §12.5 forbids long-lived creds; OIDC needs one bootstrapping `aws iam` call before the runner can assume a role | Spike achieves real `terraform plan` against AWS without violating the locked target after bootstrap |
+| D-034 | Temporary long-lived AWS key (waiver) used once in Phase 08 to bootstrap the state backend + IAM user; rotated/deactivated immediately after | §12.5 forbids long-lived creds; the bootstrap needed one `aws iam` call before the spike user + rotated key could take over | Spike achieves real `terraform plan` against AWS without violating the locked target after bootstrap. **CLOSED 2026-07-21: root key `AKIA…ROOT-DEACTIVATED` deactivated by the user in the AWS IAM console (verified — `InvalidClientTokenId`); the spike uses the rotated `acdl-spike-runner` key per D-039. Key ID redacted in v1.2 Phase 12 (P1-1).** |
 | D-035 | Milestone version = `v1.1` (feature), ship tag `v1.2.0` | Real platform is a breaking reframing of the demo, but treated as the next incremental milestone per user choice; ship.md: feature milestone → next minor | Tag `v1.2.0` on milestone COMPLETE |
-| D-036 | Spike picks `l1-s3` + `l2-static-asset` | Simplest real AWS resource (no IAM/network deps); smallest real `terraform plan`; proves the IR + adapter end-to-end | Spike scope fixed |
+| D-036 | Spike picks `l1-s3` + `l2-static-assets` | Simplest real AWS resource (no IAM/network deps); smallest real `terraform plan`; proves the IR + adapter end-to-end | Spike scope fixed |
 | D-037 | Demo archived to `demo/` (not deleted) | Preserves the working v1.0 demo as intent reference; new platform layout under `platform/`, `schemas/`, `adapters/`, `terraform/`, `modules-ir/` | No churn on demo code; clean separation |
 | D-038 | Open decisions resolved in "accept recommendations + decide rest" mode | User-locked mode: accept architecture's stated recommendations (W1.A, W1.B, W2.A, BA.A); lead-developer decides the remaining 8 (W3.D, W3.E, BA.B, BA.C, BA.D, BA.E, BA.F, OpenTofu timing) with rationale | Architecture reaches v1.0 in Phase 07 |
 | D-039 | Spike-only waiver: per-run-rotated long-lived AWS key. OIDC federation deferred to v1.2, blocked on go-gitea/gitea#36988. | **RESEARCH TARGET 1 verdict (conf 0.95):** Gitea Actions does NOT support `id-token: write` / OIDC token issuance as of Gitea 1.27.x / gitea-runner v2.1.0. GitHub's OIDC pattern is not portable. The waiver satisfies §12.5's *intent* (no persistent long-lived key) for the spike: the key is rotated after each run by `scripts/rotate_spike_key.sh`. v1.2 implements real OIDC when the Gitea PR merges. | Spike achieves real `terraform plan` against AWS without a *persistently* long-lived key; real OIDC is a v1.2 deliverable |
@@ -170,6 +548,48 @@ decisions:
 | D-044 | DynamoDB outbox = `PAY_PER_REQUEST`; PK `contractId`, SK `eventType#eventTs`, TTL `expire_at` = now + 365d. No separate async worker/DLQ in the spike (RTO = workflow re-run); v1.2 outbox worker + DLQ is a Phase 07 design artifact. | On-demand is zero-cost-at-idle for the spike's single dev submission. | Spike outbox is minimal; v1.2 worker design authored in Phase 07 |
 | D-045 | Runner tooling: `runs-on: ubuntu-latest`; install `terraform` via HashiCorp apt repo (pin `1.9.*`), `checkov` via pip (pin `>=3.2,<4`, `--break-system-packages`). Neither is pre-installed on the default runner image. | RESEARCH TARGET 2; pinning avoids mid-spike version drift. | Phase 09/10 workflows have a concrete setup step |
 | D-046 | `act_runner` → `gitea-runner` rename: Phase 07 updates docs to use the current name `gitea-runner` (renamed 2026-04 in gitea/runner#850). | RESEARCH TARGET 1 + R-4: naming drift between v1.0 docs and the current runner. | Docs reflect the current binary name |
+| D-047 | v1.2 carries forward the D-039 per-run-rotated-key waiver. Real OIDC federation remains deferred to v1.3+, blocked on go-gitea/gitea#36988 (re-checked 2026-07-21: still **open**, last updated 2026-05-27, not merged). | §12.5 forbids long-lived creds; the Gitea Actions OIDC provider is still not merged. The waiver continues to satisfy §12.5's *intent* (no *persistently* long-lived key) for v1.2: `scripts/rotate_spike_key.sh` rotates the key, and Phase 12 tightens the IAM scoping + rotation hygiene. | v1.2 achieves `terraform apply` against AWS without a persistently long-lived key; real OIDC is a v1.3+ deliverable. |
+
+## Key Decisions (v1.8)
+
+Resolved at the CLARIFY stage (full autonomy — all within locked
+constraints or user-directed scope). New v1.8 decisions:
+
+| ID | Decision | Rationale | Outcome |
+|----|----------|-----------|---------|
+| D-061 | Fold all 3 new requirements into v1.8 alongside P1 fixes. | User chose single milestone. v1.8 becomes a feature milestone (ship tag v1.8.0, minor bump). | 11 phases (28–38) in one milestone. |
+| D-062 | P1-3: SSM publisher fails loud (`RuntimeError`) when `ACDL_KMS_KEY_ID` unset. `ACDL_ALLOW_DEFAULT_KMS=1` escape hatch for local testing. | User chose fail loud. Silent AWS-managed-key use is the security gap; callers must set the env. | Phase 29 implements fail-loud + escape hatch. |
+| D-063 | P1-6: `consumer_invoke_policy.json` rendered via Terraform `data.aws_caller_identity` + `templatestring` at apply time. | User chose Terraform-rendered. No committed account ID; no stale placeholder. | Phase 29 converts JSON to TF-rendered template. |
+| D-064 | P1-8: Remove committed `terraform/spike/*.tf` entirely; adapter emits to per-run temp dir. | User chose remove. Cleaner; no stale fixtures. | Phase 30 removes files + changes run_platform.sh target. |
+| D-065 | S1: Single conditional `configure-aws-credentials` step (OIDC when no static key, access-key/secret-key inputs when static key present). | User chose single conditional step. Cleaner workflow YAML. | Phase 30 restructures the deploy workflow step. |
+| D-066 | Uptime deployment target: ECS Fargate (reuse existing ecs-cluster + ecs-service + alb primitives). | User chose ECS Fargate. Most consistent with current platform; ALB gives a stable URL. | Phase 33 authors uptime primitive on ECS Fargate. |
+| D-067 | Uptime trigger: new `deploy-uptime` pipeline stage after `publish-outputs`. Separate terraform state (S3 key prefix `uptime/`). | User chose pipeline stage. Most integrated with existing flow. | Phase 33 adds the pipeline stage + separate state. |
+| D-068 | CMDB = DynamoDB `acdl-change-requests` table (PK changeRequestId, SK submittedAt). | User chose DynamoDB. Consistent with existing platform Lambda + DynamoDB pattern. | Phase 34 adds the table + `validate_change_request` Lambda action. |
+| D-069 | Encryption key granularity: per-stack CMK (one key per L2 deployment, tagged with acdl:owner + acdl:environment). | User chose per-stack. No shared keys across stacks; 90-day rotation at creation. | Phase 31 authors kms-key primitive + L2 wiring. |
+| D-070 | Decommission: new mode on the existing deploy pipeline (`mode: decommission`). 2-step with HITL SRE gates. | User chose existing pipeline with different behavior. Plan/apply to disable deletion protection (HITL SRE gate) → plan/apply with counts=0 (second HITL SRE gate). Documented in consumer guide. | Phase 34 adds decommission mode + HITL gates. |
+| D-071 | `uses:`/`ref:` bump from `@v1.6` to `@v1.8` at milestone COMPLETE. | Consumer-facing version tracks the last released MAJOR.MINOR. | Phase 38 bumps references + creates floating `v1.8` + `v1` tags. |
+| D-072 | Managed KMS fallback for standalone L1 deployments (no L2 CMK): adapter uses `alias/aws/<service>` with a stderr warning. `kms_key_arn` input is optional everywhere; `encryption_enabled` NFR defaults to true. | Requirement says "prioritize CMKs, fallback to managed KMS". Standalone L1s don't have a per-stack CMK. | Phase 31 implements fallback + warning. |
+
+## Key Decisions (v1.7)
+
+Resolved at the CLARIFY stage (full autonomy — all within locked constraints
+or user-directed scope). New v1.7 decisions:
+
+| ID | Decision | Rationale | Outcome |
+|----|----------|-----------|---------|
+| D-048 | Rename `static-assets` → `static-assets`: **rewrite all occurrences** including verbatim historical phase descriptions in `.ciagent/` (ROADMAP, REQUIREMENTS, RESEARCH, decision tables), overriding the v1.6 audit precedent that preserved some historical references. | User chose full rewrite. Maximally consistent; the reconstruction test is updated to expect `static-assets` throughout. | Phase 22 rewrites every `static-assets` string to `static-assets`; no preserved historical tokens remain. |
+| D-049 | Production static-assets stack = S3 + CloudFront (OAC) + WAF. | Self-contained, domain-free production edge. Route53/ACM are domain-dependent (consumer-supplied) and deferred to documented extension points / a complex example. | Phase 22 authors `cloudfront` + `waf` primitives and augments the module. |
+| D-050 | Deploy outputs: SSM Parameter Store (`SecureString`, KMS-encrypted, namespaced `/acdl/{env}/{contractId}/{output_name}`) for runtime-injectable values + GitHub PR comment / job summary for human-readable connection strings. | Two canonical mechanisms: SSM for resources that read at runtime; PR comment for developers. No raw secrets in logs. | Phase 25 implements `core/output_publisher.py` + two new pipeline stages. |
+| D-051 | Contract ingestion storage = DynamoDB table `acdl-contracts` (PK `consumerRepo`, SK `contractId#submittedAt`, SSE via customer-managed CMK, point-in-time recovery). | Enables historical queries, impact analysis, CMDB-style application-state queries, and pattern detection via DynamoDB queries. S3 flat-file mirror deferred (DynamoDB is sufficient for v1.7). | Phase 24 defines the table + Lambda. |
+| D-052 | Wiz adapter = stub + schema path (no live Wiz tenant in CI). | Matches the Checkov adapter pattern; typed interface, offline-testable, degrades gracefully when unconfigured (emits `WIZ_NOT_CONFIGURED` SKIPPED record). | Phase 23 authors `adapters/wiz/wiz_adapter.py`. |
+| D-053 | Kyverno adapter = K8s-native policy adapter translating `PolicyReport` results → `PolicyCheckResult`. Ready but inactive for Terraform-only stacks. | The platform emits Terraform, not K8s manifests. The adapter activates when the GitOps reconciler (roadmap) emits K8s manifests. Sample policies included as documentation. | Phase 23 authors `adapters/kyverno/kyverno_adapter.py` + sample policies. |
+| D-054 | Tagging standard = required-tag set (`acdl:owner`, `acdl:contract`, `acdl:environment`, `acdl:cost-center`) enforced by a Checkov custom YAML rule. | Closes the D-043 deferral (the SKIPPED `ACDL_TAG_NAMING` placeholder becomes a real check). Naming-convention regex deferred (brittle across AWS resource types). | Phase 23 authors `schemas/tagging-standard.json` + `adapters/terraform/policy/custom_rules/acdl_tagging.yaml`. |
+| D-055 | Error reporting = the platform Lambda `report_error` action creates a GitHub issue on the platform repo (`acdl/acdl`). Uniform communication pathway via the Lambda; the consumer's onboarding-granted Lambda-invoke permission is the only grant needed. No separate GitHub `issues: write` on the consumer side. Gitea is excluded (only the CIAgent uses it; platform engineers and consumers use GitHub). | Unifies requirements 4 + 8 around one mechanism. The Lambda holds a GitHub token (Secrets Manager) scoped to the platform repo. Idempotent (comments on existing open issue rather than duplicating). | Phase 24 prepares the action; Phase 25 implements it + wires the `if: failure()` workflow step. |
+| D-056 | Ship `v1.7.0`; bump `uses:`/`ref:` from `@v1.4` to `@v1.6`. | Consumer-facing version tracks the last released MAJOR.MINOR. Consumers on `@v1.4` stay on v1.4 behavior until they bump. | Phase 22 bumps the references. |
+| D-057 | The `uses:`/`ref:` bump + floating `v1.6`/`v1` tag creation happen in Phase 22 (pointing at `v1.6.0`), so the reference never points at a non-existent tag. The release job (Phase 26) owns ongoing tag updates. | Sequencing: if Phase 22 bumps `uses:` to `@v1.6` but the tag doesn't exist, the reference is temporarily broken. Creating the tag early (pointing at the last release) fixes this. | Phase 22 creates the floating tags; Phase 26's release job maintains them. |
+| D-058 | Module examples = separate validated files in `modules/<name>/examples/` (`simple.yaml` + `complex.yaml` + variation files), validated against `schemas/contract.schema.json` in the platform-test pipeline schema-validation stage. Each module's README `## Examples` section references + excerpts them. | Examples cannot drift from the schema silently. | Phase 27 authors the example files; Phase 26's platform-test pipeline validates them. |
+| D-059 | Add an RDS primitive (`modules/l1/rds/`) with an `engine` input (enum: postgres, mysql, etc.) + a multi-engine example demonstrating the variation pattern. | Concrete demonstration of the multi-engine variation the requirement calls out. Adds one primitive + examples. | Phase 27 authors the primitive + adapter expansion + examples. |
+| D-060 | (Consolidated into D-058.) | — | — |
 
 ### Open-decision resolutions (Phase 07 deliverable — recorded here for traceability)
 
@@ -208,12 +628,12 @@ sign-off (autonomy = full; all within locked constraints).
 | OIDC IAM role | `acdl-act-runner-role` | Assumed by the act_runner via web-identity |
 | OIDC trust subject | `repo:continuous-intelligence/acdl:ref:refs/heads/main` (+ phase branches) | Least-privilege; refined in Phase 08 |
 | Spike L1 (`l1-s3`) inputs | `bucket_name: string`, `region: string` | Minimal S3 interface per §2 |
-| Spike L2 (`l2-static-asset`) | thin-composition referencing `l1-s3` only; depth 1 | Smallest real plan per D-036 |
-| Spike contract | `contracts/spike.yaml`: `stack: l2-static-asset`, `environment: dev`, `inputs: { bucket_name: acdl-spike-bucket, region: us-east-1 }` | One end-to-end submission (REQ-27) |
+| Spike L2 (`l2-static-assets`) | thin-composition referencing `l1-s3` only; depth 1 | Smallest real plan per D-036 |
+| Spike contract | `contracts/spike.yaml`: `stack: l2-static-assets`, `environment: dev`, `inputs: { bucket_name: acdl-spike-bucket, region: us-east-1 }` | One end-to-end submission (REQ-27) |
 | Spike `terraform` command | `plan` only | `apply` is out of scope (Out of Scope table); HITL-gated in v1.2 |
 | Checkov ruleset (spike) | the 4 L2 checks (secrets-in-plaintext, public ingress, IAM wildcard, KMS key reference) + tag/naming | §3 + §12.4; Kyverno/OPA deferred |
 | v1.0 tags preserved | `v1.0.1`..`v1.0.5`, `v1.1.0` retained | Immutability; demo archive does not rewrite history |
-| Next ship tag | `v1.2.0` | Feature milestone → next minor per ship.md (D-035) |
+| Next ship tag | `v1.3.0` | Feature milestone → next minor per ship.md (v1.1 shipped `v1.2.0`; v1.2 ships `v1.3.0`) |
 
 ### Items deferred to RESEARCH (not clarifications)
 

.ciagent/REQUIREMENTS.md

@@ -35,7 +35,7 @@
 
 (None — v1 covers the complete demo.)
 
-## v1.1 (Active milestone — architecture finalization + v1 spike)
+## v1.1 (Prior milestone — architecture finalization + v1 spike, complete)
 
 ### Category: Architecture Finalization
 - **REQ-16:** Architecture reaches v1.0 — all 11 open decisions in `docs/architecture.md` §13 are resolved and recorded in `PROJECT.md` (W1.A, W1.B, W2.A, W3.D, W3.E, BA.A–F, OpenTofu timing).
@@ -51,11 +51,11 @@
 
 ### Category: v1 Spike — IR, L1, Adapter
 - **REQ-24:** One real L1 module `l1-s3` exists under `modules-ir/l1/l1-s3/` with an IR-typed interface (typed inputs/outputs/NFRs) registered in the L1 registry.
-- **REQ-25:** One real L2 thin-composition `l2-static-asset` exists under `modules-ir/l2/l2-static-asset/` referencing `l1-s3` only (depth 1, within max-depth-5).
+- **REQ-25:** One real L2 thin-composition `l2-static-assets` exists under `modules-ir/l2/l2-static-assets/` referencing `l1-s3` only (depth 1, within max-depth-5).
 - **REQ-26:** The Terraform adapter (`adapters/terraform/`) compiles the IR-typed L1 interface to Terraform `variable`/`output` blocks and the L2 thin-composition tree to a Terraform root module; it emits a real `terraform plan` against AWS via OIDC; state is stored in S3 + DynamoDB.
 
 ### Category: v1 Spike — End-to-End
-- **REQ-27:** One end-to-end contract submission (`contracts/spike.yaml` for `l2-static-asset`) flows through: contract schema validation → contract→IR resolution → `terraform plan` (real AWS) → Checkov `PolicyCheckResult` → confidence signal → evidence event written to the DynamoDB outbox.
+- **REQ-27:** One end-to-end contract submission (`contracts/spike.yaml` for `l2-static-assets`) flows through: contract schema validation → contract→IR resolution → `terraform plan` (real AWS) → Checkov `PolicyCheckResult` → confidence signal → evidence event written to the DynamoDB outbox.
 - **REQ-28:** Spike verification (`scripts/verify_phase10.sh`) proves the IR-shaped commitments hold: the adapter is the only substrate-specific code; no polyglot mess; the L1 content, contract YML, and thin-composition tree are substrate-agnostic.
 
 ## Out of Scope (v1.1)
@@ -70,7 +70,159 @@
 | Prod/dr environments | v1.2. |
 | Terraform `apply` (real provisioning) | Spike runs `plan` only; `apply` is gated by HITL in v1.2. |
 
-## Clarifications (Phase 01, v1.0 — retained for history)
+## v1.2 (Prior milestone — platform hardening + first real consumer deployment, complete, tag `v1.3.0`)
+
+### Category: Documentation & Simplification
+- **REQ-29:** `README.md` is fully rewritten to reflect the v1.1-complete platform: the actual spike flow (contract → IR → `terraform plan` → Checkov → confidence signal → outbox), how to run it (`scripts/run_platform.sh`), the real repo layout (`acdl_platform/`, `schemas/`, `adapters/`, `terraform/`, `modules-ir/`, `contracts/`, `demo/`), and the v1.2 objective. No stale "v1.1 (active)" framing.
+- **REQ-30:** NFR hardening of the v1.1 spike: (a) `terraform/bootstrap/spike_runner_policy.json` audited to least-privilege (S3 + DynamoDB + ECS + ECR + ELB + IAM plan-only, no wildcards beyond the documented exceptions); (b) `create_state_backend.py` and `create_iam_user.py` are idempotent (re-running exits 0 without duplicating resources); (c) `run_spike_plan.sh` + `run_spike_e2e.sh` consolidated into a single `scripts/run_platform.sh` with proper exit codes and error handling; (d) P1-1 carried forward from the v1.1 audit — the two AWS access key IDs in `.ciagent/VERIFY.md` Phase 09 narrative are redacted to placeholders; (e) any remaining stale `platform/` paths in `.ciagent/` are corrected to `acdl_platform/`.
+
+### Category: L1 Catalog Expansion (ECS Fargate)
+- **REQ-31:** Six new IR-typed L1 modules exist under `modules-ir/l1/` and are registered in `modules-ir/registry.json`: `l1-vpc` (VPC + subnets + route tables), `l1-ecs-cluster` (ECS Fargate cluster), `l1-ecs-service` (ECS service + task definition), `l1-iam-role` (task execution + task role), `l1-alb` (application load balancer + listener + target group), `l1-ecr` (ECR repository). Each has an `interface.json` valid against `schemas/ir.schema.json` and produces a valid `terraform plan` fragment via the Terraform adapter. The adapter `TYPE_MAP` is expanded to cover all six IR resource types.
+
+### Category: L2 Composition & Contract Schema
+- **REQ-32:** `l2-microservice` thin-composition exists under `modules-ir/l2/l2-microservice/` referencing the six ECS L1s (depth ≤ 5, within max-depth-5). `schemas/contract.schema.json` is extended with microservice inputs (`image: string`, `port: integer`, `env: map`, `healthcheck: object`) and validates a `contracts/microservice.yaml` submission. Contract→IR resolution (`acdl_platform/contract_resolver.py`) yields a complete target stack for `l2-microservice`.
+
+### Category: Real Provisioning
+- **REQ-33:** The platform runs `terraform apply` (not just `plan`) for the `dev` environment, autonomous per §10 (confidence ≥ 0.50, no HITL). The apply creates real AWS resources (VPC, ECS cluster, ECR repo, ALB, ECS service) and the result is captured in the evidence stream. `apply` for qa/prod/dr remains HITL-gated and out of scope for v1.2.
+
+### Category: Consumer Repo
+- **REQ-34:** A new Gitea repo `acdl-consumer-microservice` exists under the `continuous-intelligence` org, containing: a basic HTTP microservice (e.g., a tiny Python/Go server returning 200), a `Dockerfile`, an ECR push step, and a `contracts/microservice.yaml` submission for `l2-microservice` (dev environment).
+
+### Category: End-to-End Verification
+- **REQ-35:** One end-to-end flow: consumer commit to `acdl-consumer-microservice` → pipeline triggered → contract→IR resolution → `terraform plan` → `terraform apply` (dev) → a live ECS Fargate service serving HTTP 200 on its ALB → evidence event written to the DynamoDB outbox → the event renders on the `acdl-evidence` timeline. `scripts/verify_phase16.sh` proves the full flow green.
+
+## v1.3 (Prior — module documentation + thin-composition removal, complete)
+
+### Category: Thin-Composition Removal
+- **REQ-36:** The L2 thin-composition layer is removed completely: `composition.json` files, `acdl_platform/contract_resolver.py`, `schemas/contract.schema.json`, `contracts/spike.yaml`, `contracts/microservice.yaml`, and L2 entries in `modules-ir/registry.json` are deleted. The L2 directories are kept as placeholders with READMEs. The downstream pipeline (adapter → checkov → confidence → outbox) is patched to load a pre-existing IR instance instead of resolving a contract.
+- **REQ-37:** A `modules-ir/README-TEMPLATE.md` exists that works for both L1 and L2 modules, written in plain language (no jargon), with sections for Overview, Resources, Inputs, Outputs, Usage, Compliance extension points, and Versioning.
+- **REQ-38:** Every module has a `README.md`: the 7 L1 modules have full READMEs with Resources/Inputs/Outputs/Usage/Compliance-extension-points/Versioning sections derived from their `interface.json`; the 2 L2 modules have placeholder READMEs noting the composition is under redesign. A `modules-ir/README.md` catalog index lists all modules with one-line descriptions and links.
+
+### Category: Testing
+- **REQ-39:** A pytest test suite exists under `tests/` covering the platform components offline (no AWS, no Checkov, no DynamoDB): the Terraform adapter (`adapters/terraform/adapter.py`), the confidence signal (`acdl_platform/confidence_signal.py`), the Checkov adapter (`adapters/terraform/policy/checkov_adapter.py`), and the outbox writer (`acdl_platform/outbox_writer.py`). The suite validates the IR schema, registry, spike_instance, and adapter output structure. `pyproject.toml` + `requirements-test.txt` pin test dependencies (pytest, jsonschema, pyyaml, boto3-stubs or moto for outbox mocking).
+
+### Category: Shell Reproducibility
+- **REQ-40:** `scripts/run_platform.sh` has a `--check-only` mode that runs offline: loads the pre-existing IR instance, runs the adapter to emit Terraform, validates the JSON structure — without AWS credentials, Checkov, or DynamoDB. The existing `--plan-only` and full modes continue to require AWS. The `--check-only` mode is what CI pipelines run.
+
+### Category: CI/CD Pipelines
+- **REQ-41:** Identical CI/CD pipelines exist for both Gitea Actions (`.gitea/workflows/ci.yml`, dev environment) and GitHub Actions (`.github/workflows/ci.yml`, production). Both run the same three stages: (1) lint — `py_compile` all Python files, (2) test — `pytest`, (3) check-only — `bash scripts/run_platform.sh --check-only`. Both trigger on push to main + pull request. Both use `ubuntu-latest`. Identical outcomes — the only difference is the runner environment.
+
+- **REQ-42:** `pyproject.toml` exists at the repo root with pytest configuration (testpaths, markers) and the project metadata. `requirements-test.txt` pins test-only dependencies separate from runtime dependencies.
+
+## v1.4 (Active — central pipeline contract + shell reproducibility + streaming)
+
+### Category: Central Pipeline Contract
+- **REQ-43:** A central pipeline contract exists as `schemas/pipeline.schema.json` (JSON Schema draft 2020-12) + `pipelines/ci.yaml` (YAML instance). The contract declares the pipeline name, triggers (push/PR branches), runner, Python version, and stages (name + command + required + install + description). Both `.gitea/workflows/ci.yml` (Gitea Actions, dev) and `.github/workflows/ci.yml` (GitHub Actions, production) implement the same stages, commands, triggers, and runner as declared in the contract. A test (`tests/test_pipeline_contract.py`) validates the contract against the schema and asserts both workflows conform (same jobs, same commands, same triggers, same runner, byte-identical).
+
+### Category: Shell Reproducibility
+- **REQ-44:** `scripts/run_ci.sh` reproduces the CI pipeline locally — runs the same 3 stages (lint, test, check-only) in sequence with proper exit codes, failing on first error. The script exits 0 with "CI PIPELINE OK" on success. A `--quiet` flag suppresses per-stage banners. The script mirrors the central pipeline contract (`pipelines/ci.yaml`) so the shell and CI environments produce identical outcomes.
+
+### Category: Pipeline Streaming
+- **REQ-45:** `scripts/run_platform.sh` streams output by default: terraform init/validate/plan output is piped to stdout via `tee` (visible to the user and logged), Checkov results are printed in human-readable form, and PolicyCheckResult records are displayed with severity, rule ID, and pass/fail status per record. The `--check-only` mode streams the emitted Terraform file content. A `--quiet` flag suppresses streaming (output to log files only) for backwards compatibility. Both gitea and github workflows are byte-identical (identical outcomes — the only difference is the forge runtime).
+
+## v1.5 (Prior — consumer happy path + zero-trust docs + reusable deploy workflow, complete)
+
+### Category: Consumer Happy Path Documentation
+- **REQ-46:** `README.md` is rewritten so the consumer model is unambiguous: this repo is the platform source; a consumer never clones it. A consumer repo contains only app code + `contract.yaml` referencing the central pipeline + contract. The platform-flow diagram is a mermaid `flowchart TD` (replacing the ASCII art). "L3A"/"L3B" nomenclature is removed from README (single-surface model). "spike" nomenclature is removed from prose (code paths in bash blocks are kept verbatim).
+- **REQ-47:** `docs/CONSUMER_GUIDE.md` (all-caps) replaces `docs/consumer-guide-static-assets.md`. It is generic across all L2 modules (`static-assets` as the worked example), uses mermaid diagrams (model + pipeline flow), documents versioned `uses:` references (floating MAJOR+MINOR tags — bare/`@main` discouraged), scopes prerequisites to consumer-repo bootstrap only (no Terraform/Checkov/boto3/runner-key — those are platform-repo concerns), and documents that the pipeline fetches the ACDL repo at run time via a reusable workflow (consumers never invoke `scripts/run_platform.sh` locally for the happy path).
+- **REQ-48:** `README.md` Credentials section is rewritten to express the zero-trust target model: consumer repos use OIDC federation (no long-lived keys) with attribute-based authorization (ABAC) — IAM roles + session policies scoped by repository identity and resource-creation tags so a consumer can only view/update resources it created (blast-radius containment). A documented override allows a static key in GitHub Secrets (consumer repo) or `.env.secrets` (local testing), rotated by a platform-managed scheduled pipeline on a daily cadence; when `.env.secrets` is used locally, rotating out of band is the consumer's responsibility.
+
+### Category: Reusable Deploy Workflow
+- **REQ-49:** A reusable deploy workflow exists as byte-identical `.gitea/workflows/deploy.yml` (Gitea, dev) and `.github/workflows/deploy.yml` (GitHub, production), implementing the central deployment pipeline contract (`pipelines/deploy.yaml` validated against `schemas/deploy-pipeline.schema.json`). It is invoked by consumer repos via `uses: acdl/.gitea/workflows/deploy.yml@vMAJOR.MINOR` (versioned tag). The workflow checks out the consumer repo, checks out the ACDL platform repo into the runner workspace, installs runtime deps (Python, Terraform, Checkov), and invokes `scripts/run_platform.sh` against the consumer's contract path (passed as a workflow input). OIDC is the default auth (`permissions: id-token: write`); a static-key override reads from repository secrets.
+- **REQ-50:** `contracts/static-assets.yaml` uses a versioned `uses:` reference (`@v1.4`, MAJOR+MINOR) — not bare `@v1` or `@main` — as the canonical example the consumer guide points at.
+- **REQ-51:** `tests/test_pipeline_contract.py` is extended to validate the new deploy workflows: both files exist, are byte-identical, and conform to `schemas/deploy-pipeline.schema.json` (stages present, names match `pipelines/deploy.yaml` stage names). The existing CI-workflow conformance tests continue to pass unchanged.
+
+## v1.6 (Active — consumer-facing docs restructure + terminology normalization + environments concept)
+
+### Category: Internal-surface scrub
+- **REQ-52:** No consumer-facing documentation (README.md, docs/**, modules/**/README.md, contracts/**) references `.ciagent/` — it is local CIAgent metadata, never visible to platform engineers or consumers. The README repository-layout table has no `.ciagent/` row. No `.gitea/` references appear in consumer-facing docs (consumers use GitHub only); the README repository-layout table has no `.gitea/workflows/` row.
+- **REQ-53:** `acdl_platform/` is renamed to `core/` across the directory, all imports in tests/scripts/pipelines/workflows, and all doc references. (`platform/` was the original target but shadows Python's stdlib `platform` module — `core/` was chosen to stay importable.) `grep -R "acdl_platform" .` (excluding `.ciagent/`, `demo/`, `.git/`) returns 0 hits. The test suite passes after the rename.
+
+### Category: Docs site restructure
+- **REQ-54:** `docs/` is restructured into a Jekyll-style GitHub Pages site: `docs/_config.yml`, `docs/index.md` (landing), `docs/modules/` (catalog + per-module Pages-friendly copies), `docs/contracts/index.md`, `docs/pipeline/index.md` + `docs/pipeline/versioning.md`, `docs/environments/index.md`, `docs/consumer-guide.md`, `docs/architecture.md` (consolidated from architecture.md + architecture-v1.0.md, current-architecture only), `docs/vision.md`. No `.ciagent/` links anywhere in `docs/`. Consumer-facing content (modules, contracts, pipeline, versioning) lives in Pages.
+
+### Category: Terminology normalization
+- **REQ-55:** Consumer-facing docs drop the "L2" nomenclature — L2 modules are referred to as "modules". "L1" label is dropped in consumer-facing docs — L1 primitives are referred to as "primitives". The "composition" terminology is changed to "pattern" for modules in prose (the on-disk `composition.json` files and code references are unchanged this phase). A roadmap entry records that "composition" will later describe the thin orchestration where consumers dynamically create a module directly from the contract file (future implementation, not implemented now).
+- **REQ-56:** The term "forge" is replaced in consumer-facing docs with "platform runners" / "platform-managed" as appropriate. The term "forge" remains only in internal architecture docs.
+
+### Category: README rewrite
+- **REQ-57:** README.md repository-roles section is restated to match reality: a consumer repo contains (a) its application code, (b) one or more contracts (`.acdl/contract.yaml`), and (c) one or more CI definitions (a thin `.github/workflows/deploy.yml` that `uses:` the central reusable workflow, pointing at the appropriate environment + contract). The platform repo (this one) owns modules/adapters/schemas/pipelines/scripts/workflows. A consumer never clones the platform repo.
+- **REQ-58:** README.md Status section is replaced with a Features list (referenceable by consumers and platform engineers) and a Roadmap subsection listing only planned future features (no internal CIAgent status, no version-by-version changelog).
+- **REQ-59:** README.md "How the platform works" mermaid diagram is revised so all node text is visible (no overflow): labels are split with `<br/>`, boxes widened as needed. A security-checks stage is added before the policy-checks stage. Specific tools (Checkov, Terraform) are not named — they are "security checks (adapter)", "policy checks (adapter)", "infrastructure plan". An "infrastructure apply" stage is added at the appropriate level (dev only, after confidence).
+- **REQ-60:** README.md Credentials & zero-trust section removes the "go-gitea/gitea#36988 blocked" mention and the "waivers D-039/D-047" language (not consumer/platform-engineer facing). It states: default OIDC + ABAC; alternative is a static AWS key (GitHub Secrets for platform-runner runs, or `.env.secrets` locally) with the expectation of daily rotation (platform-managed for runner runs) or out-of-band rotation (consumer-managed for local `.env.secrets`).
+
+### Category: Environments concept + onboarding
+- **REQ-61:** The concept of platform-managed environments is introduced: consumers are not required to provide an AWS account, VPC, subnet, S3 state bucket, or runner key. `docs/environments/index.md` documents that a named environment is a platform-owned AWS account + network + state backend + IAM role surfaced to the consumer via ABAC, selected by name in the contract. The old README environments table (dev/qa/prod/dr) is removed completely. A minimal onboarding scaffold exists: `platform/environments/` with a sample `dev.json` + README, `platform/environment_check.py`, a wire-in at the top of `scripts/run_platform.sh`, a friendly first-run onboarding message when no environment is defined for the repo, and `tests/test_environment_check.py` covering the missing-env and present-env cases.
+
+## v1.7 (Active — production platform + contract ingestion + pipeline maturation)
+
+### Category: Rename + production-ready stack
+- **REQ-62:** `static-assets` is renamed to `static-assets` everywhere (D-048 — including `.ciagent/` historical narrative: verbatim phase descriptions, REQ-25/27/50 text, D-036, RESEARCH.md). `grep -R "static-assets[^s]" .` (excluding `.git/`) returns 0 hits. The module dir `modules/l2/static-assets/` → `modules/l2/static-assets/`; `contracts/static-assets.yaml` → `contracts/static-assets.yaml`; the registry key is renamed; all scripts, tests, docs, and `.ciagent/` files use `static-assets`. The reconstruction test is updated to expect `static-assets` throughout.
+- **REQ-63:** Two new primitives exist: `cloudfront` (distribution + OAC, stack types `aws:cloudfront:distribution` + `aws:cloudfront:originaccesscontrol`) and `waf` (WAFv2 web ACL, stack type `aws:wafv2:webacl`), each with an `interface.json` valid against `schemas/stack.schema.json` and a full README (Resources/Inputs/Outputs/Usage/Compliance/Versioning). Both are registered in `modules/registry.json`. The Terraform adapter `TYPE_MAP`/`INPUT_MAP`/`OUTPUT_MAP` covers the new stack types.
+- **REQ-64:** The `static-assets` module is augmented to a production-ready stack referencing s3 + cloudfront + waf (depth 1, D-049). `composition.json` wires the s3 bucket regional domain name to the CloudFront origin, and the WAF web ACL ARN to the CloudFront distribution. `schemas/contract.schema.json` is extended for the new module inputs (`price_class`, `viewer_protocol_policy`, `waf_enabled`, `default_ttl`, `max_ttl`). The `uses:`/`ref:` tag advances from `@v1.4` to `@v1.6` (D-056/D-057); floating git tags `v1.6` + `v1` are created pointing at `v1.6.0`.
+
+### Category: Tagging standards + security adapters
+- **REQ-65:** A required-tag set is defined in `schemas/tagging-standard.json` (`acdl:owner`, `acdl:contract`, `acdl:environment`, `acdl:cost-center`). A Checkov custom YAML rule at `adapters/terraform/policy/custom_rules/acdl_tagging.yaml` fails (severity `medium`) when required tags are missing on taggable resources. `checkov_adapter.py` removes the `_emit_tag_naming_skipped()` placeholder (D-043 closure) and maps `ACDL_TAG_NAMING` as a real rule. `scripts/run_platform.sh` Step 5 passes `--external-checks-dir` to load the custom rule.
+- **REQ-66:** A Wiz adapter stub exists at `adapters/wiz/wiz_adapter.py` translating Wiz API issues → `PolicyCheckResult` records (`engine: "wiz"`, D-052). It degrades gracefully when unconfigured (emits a single `SKIPPED` `WIZ_NOT_CONFIGURED` record). `tests/test_wiz_adapter.py` passes offline with a fixture response. The pipeline invokes it optionally (Step 5b) when `WIZ_API_TOKEN` is set.
+- **REQ-67:** A Kyverno K8s-native adapter exists at `adapters/kyverno/kyverno_adapter.py` translating Kyverno `PolicyReport` results → `PolicyCheckResult` records (`engine: "kyverno"`, D-053). Sample policies exist at `adapters/kyverno/policies/` (disallow-privileged, require-labels, require-image-digests). `tests/test_kyverno_adapter.py` passes offline. The adapter is inactive for Terraform-only stacks (the platform emits Terraform, not K8s manifests); it is ready for the GitOps reconciler roadmap item. `schemas/policy_check_result.schema.json` engine enum includes `checkov | kyverno | opa | wiz`.
+
+### Category: Platform Lambda + contract ingestion
+- **REQ-68:** A platform Lambda (`core/lambda/contract_ingestor.py`) is invoked via a Function URL (IAM auth) and accepts `{ consumerRepo, contractId, contract, environment, action }`. It writes contracts to a DynamoDB table `acdl-contracts` (PK `consumerRepo`, SK `contractId#submittedAt`, SSE via a customer-managed CMK, point-in-time recovery) (D-051). `terraform/platform/main.tf` defines the table, Lambda, Function URL, KMS key, Secrets Manager secret (`acdl/github-token`), and Lambda execution role. `terraform/platform/consumer_invoke_policy.json` grants the consumer's deploy role `lambda:InvokeFunctionUrl` on the Lambda ARN, scoped via ABAC (cross-account). Onboarding grants the Lambda-invoke permission; `docs/environments/index.md` documents this. `tests/test_contract_ingestor.py` passes offline (moto-mocked DynamoDB).
+
+### Category: Deploy outputs + error reporting + stage comments
+- **REQ-69:** `scripts/run_platform.sh` has a `publish-outputs` step (after apply) that writes deploy outputs to SSM Parameter Store as `SecureString` (KMS-encrypted, namespaced `/acdl/{env}/{contractId}/{output_name}`) for runtime-injectable values, and a `comment-outputs` step that posts a structured GitHub PR comment / job summary with human-readable connection strings (D-050). `core/output_publisher.py` implements the SSM write + GitHub comment formatting. `tests/test_output_publisher.py` passes offline (moto + mocked GitHub API). `pipelines/deploy.yaml` + both deploy workflow YAMLs declare the new stages (byte-identical).
+- **REQ-70:** The Lambda `report_error` action (`core/lambda/contract_ingestor.py`) creates a GitHub issue on the platform repo (`acdl/acdl`) via the GitHub API using a token from Secrets Manager (D-055). Idempotent (comments on an existing open issue rather than duplicating). `.github/workflows/deploy.yml` + `.gitea/workflows/deploy.yml` (byte-identical) have an `if: failure()` error-report step invoking the Lambda via `aws lambda invoke-function-url` (SigV4-signed). Gitea is excluded (only the CIAgent uses it; platform engineers and consumers use GitHub).
+- **REQ-71:** `.github/workflows/deploy.yml` + `.gitea/workflows/deploy.yml` (byte-identical) post a PR comment after every successful pipeline stage (validate-contract, resolve-stack, plan, checkov, confidence, apply, publish-outputs) via `scripts/post_stage_comment.sh` (uses `GITHUB_TOKEN` + `gh api`; no-op when not in a PR context). The comment includes the stage name, status (pass), and key metrics (plan counts, confidence score, outputs published).
+
+### Category: Platform pipelines + release automation
+- **REQ-72:** Three platform pipelines exist: (1) `.github/workflows/platform-test.yml` (PR, stages: lint, unit-test, integration-test — runs `run_platform.sh --check-only` for every sample contract, schema-validation — validates all `schemas/*.json` + `modules/**/interface.json` + `modules/**/composition.json` + `modules/<name>/examples/*.yaml` against their schemas); (2) `.github/workflows/primitives-plan.yml` (PR, plan-only for all L1 primitives via matrix, `scripts/run_primitive_plan.sh`); (3) `.github/workflows/patterns-plan.yml` (PR, plan-only for all L2 modules via matrix, `scripts/run_pattern_plan.sh`).
+- **REQ-73:** `.github/workflows/release.yml` runs on merge to `main`, computes the next semver (PATCH per phase, MINOR on milestone COMPLETE), creates the MAJOR.MINOR.PATCH tag, force-moves the MAJOR.MINOR + MAJOR floating tags, and creates a GitHub release with an auto-generated body (D-057). `tests/test_release_logic.py` passes (unit test the semver computation + tag-update logic with a mocked `git describe`).
+
+### Category: Remove legacy consumer-repos + module examples + RDS primitive
+- **REQ-74:** The legacy consumer-repos directory is deleted entirely (a v1.2 artifact removed in v1.7; references in `.ciagent/` historical narrative are rewritten per D-048). A recursive grep for the legacy directory name (excluding `.git/`) returns 0 hits.
+- **REQ-75:** A new RDS primitive (`modules/l1/rds/`) with an `engine` input (enum: postgres, mysql, etc.) demonstrates multi-engine variation (D-059). Every module (primitives + patterns) has a `modules/<name>/examples/` directory with `simple.yaml` + `complex.yaml` (+ variation files) validated against `schemas/contract.schema.json` in the platform-test pipeline schema-validation stage (D-058). Each module's `README.md` `## Examples` section references + excerpts the validated files. `docs/modules/index.md` + `docs/consumer-guide.md` + `docs/contracts/index.md` are updated with the new module names + examples.
+
+## v1.8 (Complete — P1 remediation + uptime + engineering standards + encryption/deletion-protection by default + decommission + docs)
+
+### Category: P1 Fixes
+- **REQ-76:** WAF adapter emits custom `rules` as nested HCL blocks (not attribute syntax) and honors `default_action` input (allow/block) — P1-4, P1-5 closed.
+- **REQ-77:** L2 composition `outputs[]` array is resolved by `contract_resolver.py` into `stack.outputs`; the adapter emits corresponding `output` blocks — P1-7 closed.
+- **REQ-78:** SSM publisher fails loud when `ACDL_KMS_KEY_ID` is unset (no silent AWS-managed-key fallback); `ACDL_ALLOW_DEFAULT_KMS=1` escape hatch for local testing — P1-3 closed.
+- **REQ-79:** `consumer_invoke_policy` is rendered via Terraform with the caller's live account ID (no `000000000000` placeholder) — P1-6 closed.
+- **REQ-80:** `run_platform.sh` emits adapter output to a per-run temp dir, not committed `terraform/spike/*.tf`; the committed files are removed — P1-8 closed.
+- **REQ-81:** `contract_ingestor.py` reads `GITHUB_API_BASE` env for forge-agnostic API URLs (GitHub + Gitea) — P1-9 closed.
+- **REQ-82:** Deploy workflow static-key override is wired to `configure-aws-credentials` inputs (`access-key`/`secret-key`), not inert env vars — S1 closed.
+
+### Category: Encryption by Default
+- **REQ-83:** A per-stack CMK primitive (`kms-key`) exists with 90-day rotation enabled at creation; one key per L2 deployment; no shared keys across stacks.
+- **REQ-84:** All primitives have encryption by default (`encryption_enabled` NFR, default true) + optional `kms_key_arn` input. CMK is prioritized; managed KMS is the fallback when no CMK is provided.
+- **REQ-85:** L2 modules wire a per-stack CMK child + connect its `kms_key_arn` output to each child's `kms_key_arn` input.
+
+### Category: Deletion Protection by Default
+- **REQ-86:** `deletion_protection` NFR (boolean, default true) on every L1 primitive; the adapter emits `prevent_destroy` lifecycle meta-arg when true.
+- **REQ-87:** L2 modules expose a `features.deletion_protection` flag (default true); consumers can disable via contract `inputs.deletion_protection: false`.
+
+### Category: Uptime Monitoring
+- **REQ-88:** An uptime-kuma L1 primitive exists (ECS Fargate) with: `feature_flag_enabled` (boolean, default true), `monitored_endpoints` (array of HTTP/DNS/TCP checks), `static_checks` (pre-defined health checks), `alert_channels` (Teams webhook, email, SMS, GitHub issues).
+- **REQ-89:** Uptime is deployed by default after any L2 module deploy (separate terraform state, separate terraform run); L2 module outputs (endpoints) are passed to the uptime deployment as `monitored_endpoints`. The uptime URL is published to the consumer via PR comment.
+- **REQ-90:** The `feature_flag_enabled` input (set from consumer contract `inputs.uptime_enabled`, default true) disables the uptime deployment entirely (no resources emitted).
+- **REQ-91:** A `deploy-uptime` pipeline stage is declared in `pipelines/deploy.yaml` + both deploy workflow YAMLs (byte-identical).
+
+### Category: Decommission + CMDB
+- **REQ-92:** A decommission mode on the deploy pipeline (`mode: decommission`) implements a 2-step pipeline: (1) plan/apply to disable deletion protection with an HITL SRE gate, (2) plan/apply with all counts set to 0 with a second HITL SRE gate. Uses the existing deploy pipeline with different behavior.
+- **REQ-93:** A DynamoDB `acdl-change-requests` table serves as the CMDB. The decommission alias accepts a `changeRequestId` input validated via a `validate_change_request` Lambda action (CR status must be `approved`).
+- **REQ-94:** The decommission flow is documented in `docs/CONSUMER_GUIDE.md` (how to request a CR, trigger decommission, HITL gates, what happens).
+
+### Category: Engineering Standards
+- **REQ-95:** `modules/STANDARDS.md` exists with comprehensive L1 + L2 authoring + code review standards (scanned from current modules): required files, interface schema, input/output/NFR conventions, encryption + deletion protection as mandatory NFRs, naming, adapter extension pattern, code review checklist.
+- **REQ-96:** `modules/README.md` catalog index includes all primitives (rds + uptime + kms-key added); `modules/README-TEMPLATE.md` updated with `## NFRs` section.
+
+### Category: Path Documentation
+- **REQ-97:** `schemas/README.md` documents how to write a schema, wire it into the platform, test it in CI, where to write tests, dependencies, and the existing schema catalog.
+- **REQ-98:** `pipelines/README.md` documents how to write a pipeline contract, wire it into workflows, test it, dependencies, and the existing pipeline catalog.
+- **REQ-99:** `adapters/README.md` documents how to write an adapter, wire it into the platform, test it, dependencies, and the existing adapter catalog.
+
+## Out of Scope (v1.2)
 
 | REQ | Original criterion | Clarified criterion (effective) | Decision |
 |-----|--------------------|----------------------------------|----------|
@@ -88,6 +240,38 @@
 | Adversarial tamper-proofing of evidence | Hash chain is demonstrative; not cryptographically secure against a determined attacker. |
 | Multi-tenant isolation | Out of demo scope. |
 
+## v1.9 (complete — design doc refresh + contract interpolation + per-env CI jobs + stub implementation + P1-1 remediation, tag `v1.9.0`)
+
+### Category: Design Doc Refresh
+- **REQ-100:** `core/hitl_matrix_design.md` is up to date: the "dev-only spike" framing is replaced with the v1.9 wired-gates reality (qa/prod/dr `workflow_dispatch` approval gates + CODEOWNERS routing + outbox-based SoD); the 8-concern attestation matrix is marked implemented (offline-testable subset) with operator-supplied concerns noted; the spike-scope note is updated. No stale "v1.2 wires the gates" language remains.
+- **REQ-101:** `core/audit_ledger_design.md` is up to date: the hash-chain + DynamoDB-outbox path is marked shipped + production (since v1.8); the S3 Object Lock + JWS + async worker + DLQ + daily checkpoints build-out is clearly labeled "Deferred to a future milestone" (D-083); the RPO/RTO table reflects the v1.9 state.
+
+### Category: P1-1 Remediation
+- **REQ-102:** The adapter (`adapters/terraform/adapter.py`) contains no resource-type-specific hardcoded defaults for ECS/ALB/VPC resources — `desired_count`, `launch_type`, `target_type`, `load_balancer_type`, `family`, and `Name` tag values are read from L1 `interface.json` inputs (with defaults declared in the interface). The adapter is a thin translator. An L1 with an overridden `desired_count: 3` emits `desired_count = 3`; the default emits `desired_count = 1` via the interface default, not an adapter hardcode (P1-1 closed).
+
+### Category: Contract Interpolation
+- **REQ-103:** The contract resolver (`core/contract_resolver.py`) expands `${env.<field>}` and `${contract.<field>}` tokens in contract string values (including dotted paths like `${env.state_backend.bucket}`) after schema validation and before IR resolution. The `env` context is the loaded `core/environments/<contract.environment>.json`; the `contract` context is the contract dict. Unresolved tokens raise `ValueError` (fail loud). Sample contracts use naming patterns that include region, account id, and environment (e.g. `acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}`).
+- **REQ-104:** An environment JSON schema `schemas/environment.schema.json` (draft 2020-12) defines the environment file shape (`name`, `account_id`, `region`, `state_backend`, `network`, `runner_role_arn`, `autonomy`, `confidence_threshold`). `core/environments/dev.json` validates against it. `qa.json`, `prod.json`, `dr.json` placeholder bindings exist (autonomy `attested`, thresholds 0.75/0.90/0.95).
+
+### Category: Per-Environment CI Jobs
+- **REQ-105:** Per-environment contract files exist for each sample module (`contracts/static-assets.{dev,qa,prod,dr}.yaml` and `contracts/microservice.{dev,qa,prod,dr}.yaml`), each setting `environment:` to its own name and using interpolation for env-specific values. The existing `contracts/static-assets.yaml` + `contracts/microservice.yaml` remain as the dev default for backwards compatibility.
+- **REQ-106:** The reusable deploy workflow (`.github/workflows/deploy.yml` + `.gitea/workflows/deploy.yml`, byte-identical) declares an `environment` `workflow_call` input (enum dev/qa/prod/dr, default empty). When non-empty, `scripts/run_platform.sh --environment <name>` overrides the contract's `environment` field at load time (before interpolation). A consumer repo's caller workflow has one job per environment, each pointing at its respective contract (or the same contract + the env input). Promotion = running the matching job; no `environment:` field editing. `docs/CONSUMER_GUIDE.md` documents the per-env caller workflow pattern.
+
+### Category: Stub Implementation
+- **REQ-107:** `core/separation_of_duties.py` `route_halt_artifact` is a real implementation: publishes to an SNS topic `acdl-sod-halt` (ARN from `ACDL_SOD_HALT_TOPIC_ARN`); when unset, falls back to a structured stderr emission + a `SEPARATION_OF_DUTIES_VIOLATION` event write to the DynamoDB outbox via `outbox_writer.write_event`. No silent print-only stub. The SNS topic is defined in `terraform/platform/main.tf`.
+- **REQ-108:** HITL qa/prod/dr pre-execution attestation gates are wired via `core/hitl_gates.py` (`attest(contract_id, env, approver, evidence)`). The gate records the approver (`gitea.actor` / `github.actor`) to the outbox (`approver_qa` / `approver_prod` / `approver_dr` attributes per `audit_ledger_design.md`), runs the separation-of-duties check on prod, and returns `(ok, reason)`. `scripts/run_platform.sh` calls `hitl_gates.attest` before apply for qa/prod/dr (dev skips). The workflow's `workflow_dispatch` approval input is the trigger.
+- **REQ-109:** The full 8-concern attestation matrix from `hitl_matrix_design.md` §10.4 is implemented in `core/attestation_matrix.py`. Offline-testable concerns (contract NFRs, schema validity, policy pass) run for real; operator-supplied concerns (k6 load test, DR drill, FinOps forecast) accept an uploaded signed evidence artifact validated for freshness + schema, failing loud if missing/expired for prod/dr. `hitl_gates.attest` invokes the matrix for the target env and blocks on any failing concern.
+- **REQ-110:** The Wiz adapter (`adapters/wiz/wiz_adapter.py`) is a real API client: a `WizClient` queries the Wiz GraphQL API (`WIZ_API_TOKEN` + `WIZ_API_URL`) and translates issues → `PolicyCheckResult` records. It degrades gracefully (existing `WIZ_NOT_CONFIGURED` SKIPPED record) when env unset. Offline tests use a recorded GraphQL fixture.
+- **REQ-111:** The Kyverno adapter (`adapters/kyverno/kyverno_adapter.py`) translator is fleshed out: full `PolicyReport` → `PolicyCheckResult` mapping with severity + skip handling. It remains inactive for Terraform-only stacks (guard preserved); a `--kube-version` stub is added for future GitOps. Sample policies already exist.
+
+## Out of Scope (v1.9)
+
+| Feature | Reason |
+|---------|--------|
+| S3 Object Lock + JWS + async worker + DLQ + daily checkpoints (audit ledger build-out) | Requires non-offline-testable AWS infra (Object Lock bucket, KMS signing key, SQS DLQ, Lambda worker). Deferred to a future milestone (D-083). The hash-chain + DynamoDB-outbox path remains the v1.9 production audit record. |
+| Live k6/Gatling load test execution, live DR drill, live FinOps forecast | Operator-supplied evidence artifacts (signed blobs) are accepted + validated; the platform does not run these inline. |
+| Self-service environment provisioning | Adding an environment remains a platform-team action (per `core/environments/README.md`). v1.9 adds the env files + schema, not self-service provisioning. |
+
 ## Traceability
 
 ### v1.0 (prior — demo)
@@ -110,20 +294,142 @@
 | REQ-14 | 5 | complete (v1.0.5) |
 | REQ-15 | 5 | complete (v1.0.5) |
 
-### v1.1 (active — architecture finalization + v1 spike)
+### v1.1 (prior — architecture finalization + v1 spike, complete)
 
 | Requirement | Phase | Status |
 |-------------|-------|--------|
-| REQ-16 | 07 | pending |
-| REQ-17 | 07 | pending |
-| REQ-18 | 07 | pending |
-| REQ-19 | 07 | pending |
-| REQ-20 | 07 | pending |
-| REQ-21 | 07 | pending |
-| REQ-22 | 07 | pending |
-| REQ-23 | 08 | pending |
-| REQ-24 | 09 | pending |
-| REQ-25 | 10 | pending |
-| REQ-26 | 09 | pending |
-| REQ-27 | 10 | pending |
-| REQ-28 | 10 | pending |
+| REQ-16 | 07 | complete (v1.1.2) |
+| REQ-17 | 07 | complete (v1.1.2) |
+| REQ-18 | 07 | complete (v1.1.2) |
+| REQ-19 | 07 | complete (v1.1.2) |
+| REQ-20 | 07 | complete (v1.1.2) |
+| REQ-21 | 07 | complete (v1.1.2) |
+| REQ-22 | 07 | complete (v1.1.2) |
+| REQ-23 | 08 | complete (v1.1.3) |
+| REQ-24 | 09 | complete (v1.1.4) |
+| REQ-25 | 10 | complete (v1.1.5) |
+| REQ-26 | 09 | complete (v1.1.4) |
+| REQ-27 | 10 | complete (v1.1.5) |
+| REQ-28 | 10 | complete (v1.1.5) |
+
+### v1.2 (prior — platform hardening + first real consumer deployment, complete)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-29 | 11 | complete (v1.2.1) |
+| REQ-30 | 12 | complete (v1.2.2) |
+| REQ-31 | 13 | complete (v1.2.3) |
+| REQ-32 | 14 | complete (v1.2.4) |
+| REQ-33 | 15 | partial (v1.2.5, IAM-blocked) |
+| REQ-34 | 15 | complete (v1.2.5) |
+| REQ-35 | 16 | partial (v1.2.6, IAM-blocked) |
+
+### v1.3 (prior — module documentation + thin-composition removal, complete)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-36 | 17 | complete (v1.3.1) |
+| REQ-37 | 17 | complete (v1.3.1) |
+| REQ-38 | 17 | complete (v1.3.1) |
+| REQ-39 | 18 | complete (v1.3.2) |
+| REQ-40 | 18 | complete (v1.3.2) |
+| REQ-41 | 18 | complete (v1.3.2) |
+| REQ-42 | 18 | complete (v1.3.2) |
+
+### v1.4 (prior — central pipeline contract + shell reproducibility + streaming)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-43 | 19 | complete (v1.4.1) |
+| REQ-44 | 19 | complete (v1.4.1) |
+| REQ-45 | 19 | complete (v1.4.1) |
+
+### v1.5 (prior — consumer happy path + zero-trust docs + reusable deploy workflow, complete)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-46 | 20 | complete (v1.5.0) |
+| REQ-47 | 20 | complete (v1.5.0) |
+| REQ-48 | 20 | complete (v1.5.0) |
+| REQ-49 | 20 | complete (v1.5.0) |
+| REQ-50 | 20 | complete (v1.5.0) |
+| REQ-51 | 20 | complete (v1.5.0) |
+
+### v1.6 (complete — consumer-facing docs restructure + terminology normalization + environments concept, tag `v1.6.0`)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-52 | 21 | complete (v1.6.0) |
+| REQ-53 | 21 | complete (v1.6.0) |
+| REQ-54 | 21 | complete (v1.6.0) |
+| REQ-55 | 21 | complete (v1.6.0) |
+| REQ-56 | 21 | complete (v1.6.0) |
+| REQ-57 | 21 | complete (v1.6.0) |
+| REQ-58 | 21 | complete (v1.6.0) |
+| REQ-59 | 21 | complete (v1.6.0) |
+| REQ-60 | 21 | complete (v1.6.0) |
+| REQ-61 | 21 | complete (v1.6.0) |
+
+### v1.7 (complete — production platform + contract ingestion + pipeline maturation, tag `v1.7.0`)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-62 | 22 | complete (v1.7.0) |
+| REQ-63 | 22 | complete (v1.7.0) |
+| REQ-64 | 22 | complete (v1.7.0) |
+| REQ-65 | 23 | complete (v1.7.0) |
+| REQ-66 | 23 | complete (v1.7.0) |
+| REQ-67 | 23 | complete (v1.7.0) |
+| REQ-68 | 24 | complete (v1.7.0) |
+| REQ-69 | 25 | complete (v1.7.0) |
+| REQ-70 | 25 | complete (v1.7.0) |
+| REQ-71 | 25 | complete (v1.7.0) |
+| REQ-72 | 26 | complete (v1.7.0) |
+| REQ-73 | 26 | complete (v1.7.0) |
+| REQ-74 | 27 | complete (v1.7.0) |
+| REQ-75 | 27 | complete (v1.7.0) |
+
+### v1.8 (complete — P1 remediation + uptime + standards + encryption/deletion-protection by default + decommission + docs, tag `v1.8.0`)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-76 | 28 | complete (v1.8.0) |
+| REQ-77 | 28 | complete (v1.8.0) |
+| REQ-78 | 29 | complete (v1.8.0) |
+| REQ-79 | 29 | complete (v1.8.0) |
+| REQ-80 | 30 | complete (v1.8.0) |
+| REQ-81 | 30 | complete (v1.8.0) |
+| REQ-82 | 30 | complete (v1.8.0) |
+| REQ-83 | 31 | complete (v1.8.0) |
+| REQ-84 | 31 | complete (v1.8.0) |
+| REQ-85 | 31 | complete (v1.8.0) |
+| REQ-86 | 32 | complete (v1.8.0) |
+| REQ-87 | 32 | complete (v1.8.0) |
+| REQ-88 | 33 | complete (v1.8.0) |
+| REQ-89 | 33 | complete (v1.8.0) |
+| REQ-90 | 33 | complete (v1.8.0) |
+| REQ-91 | 33 | complete (v1.8.0) |
+| REQ-92 | 34 | complete (v1.8.0) |
+| REQ-93 | 34 | complete (v1.8.0) |
+| REQ-94 | 34 | complete (v1.8.0) |
+| REQ-95 | 35 | complete (v1.8.0) |
+| REQ-96 | 35 | complete (v1.8.0) |
+| REQ-97 | 36 | complete (v1.8.0) |
+| REQ-98 | 36 | complete (v1.8.0) |
+| REQ-99 | 36 | complete (v1.8.0) |
+### v1.9 (complete — design doc refresh + contract interpolation + per-env CI jobs + stub implementation + P1-1 remediation, tag `v1.9.0`)
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| REQ-100 | 39 | complete (v1.9.0) |
+| REQ-101 | 39 | complete (v1.9.0) |
+| REQ-102 | 39 | complete (v1.9.0) |
+| REQ-103 | 40 | complete (v1.9.0) |
+| REQ-104 | 40 | complete (v1.9.0) |
+| REQ-105 | 41 | complete (v1.9.0) |
+| REQ-106 | 41 | complete (v1.9.0) |
+| REQ-107 | 42 | complete (v1.9.0) |
+| REQ-108 | 42 | complete (v1.9.0) |
+| REQ-109 | 42 | complete (v1.9.0) |
+| REQ-110 | 42 | complete (v1.9.0) |
+| REQ-111 | 42 | complete (v1.9.0) |

.ciagent/RESEARCH.md

@@ -453,7 +453,7 @@ the hooks are on the *composition*, not the resource).
   interpolation `module.X.<output>`.
 - `relationship.kind = parent` → the child resource is *inside* the parent
   L1's module block (no Terraform construct; it's a composition hint the
-  adapter uses to order module blocks). For the spike (`l2-static-asset` →
+  adapter uses to order module blocks). For the spike (`l2-static-assets` →
   `l1-s3` only, depth 1) there is exactly one resource and zero
   relationships — the IR still validates, and the adapter produces a
   single `module "s3" { ... }` block.
@@ -704,7 +704,7 @@ exists in *every* environment (including dev).
 | 3 | freshness | 0.10 | Age of the contract's declared validation evidence (e2eSuite, loadTest) relative to submission; in dev, this is the age of the L1/L2 module versions vs. the registry | L1 registry publication timestamps |
 | 4 | source / attestation | 0.15 | Identity of the submitter + the contract's source provenance (git ref, commit SHA, signed-by). In dev (autonomous), this is "any valid submitter" — the gate is *presence*, not *identity*. | Gitea `gitea.actor` + commit SHA |
 | 5 | historical behavior | 0.10 | Platform's observed history for this contract / stack / submitter: prior rollback count, prior policy-fail count. In the spike (first submission), this is a neutral 0.5 (no history). | DynamoDB outbox (prior events for this `contractId` / `stack`) |
-| 6 | NFR conformance | 0.10 | The contract's declared NFRs (latency, throughput, error rate) vs. the platform's measured baseline for this stack. In the spike, `l2-static-asset` declares no NFRs, so this input is "present + neutral 0.5" (the gate is *presence*, not *conformance*). | contract `nfrs` block (optional) + platform baseline (none in spike) |
+| 6 | NFR conformance | 0.10 | The contract's declared NFRs (latency, throughput, error rate) vs. the platform's measured baseline for this stack. In the spike, `l2-static-assets` declares no NFRs, so this input is "present + neutral 0.5" (the gate is *presence*, not *conformance*). | contract `nfrs` block (optional) + platform baseline (none in spike) |
 
 **Weights sum to 1.0.** The base score (before severity penalties) is the
 weighted sum of each input's per-input score (each in [0,1]). The
@@ -909,12 +909,12 @@ of Object Lock + JWS is a scope decision, not a design risk.
   "seq": 1,
   "ts": "2026-07-21T12:00:00Z",
   "stage": "dev",
-  "event": "contract applied: l2-static-asset (confidence 0.82, band pass)",
+  "event": "contract applied: l2-static-assets (confidence 0.82, band pass)",
   "prev_hash": "<sha256 of the genesis event, or GENESIS>",
   "hash": "<sha256 of the canonical JSON of this event with hash=''>",
   "contractId": "uuid",
   "environment": "dev",
-  "stack": "l2-static-asset",
+  "stack": "l2-static-assets",
   "score": 0.82,
   "band": "pass"
 }
@@ -1116,7 +1116,7 @@ a direct formalization.
 **Spike contract (`contracts/spike.yaml`) validates against this:**
 
 ```yaml
-stack: l2-static-asset
+stack: l2-static-assets
 environment: dev
 inputs:
   bucket_name: acdl-spike-bucket
@@ -1327,4 +1327,589 @@ the demo is local-only post-archive), but this is moot for the archive.
 
 ---
 
-*End of RESEARCH.md. Path: `/root/acdl/.ciagent/RESEARCH.md`.*
+## v1.2 Research Addendum (Phase 11, 2026-07-21)
+
+> Phase: research (Phase 11). Milestone: v1.2. Status: active.
+> Researcher: ci-researcher (inline, docs phase). Autonomy: full.
+> Sources: GitHub API (go-gitea/gitea#36988), ACDL codebase audit
+> (`terraform/bootstrap/`, `scripts/`, `adapters/terraform/`,
+> `modules-ir/registry.json`, `.ciagent/VERIFY.md`, `.ciagent/PERSONAS.md`).
+> Scope: re-eval OIDC blocker, NFR audit of the v1.1 spike, simplification
+> opportunities, README rewrite plan, ECS L1 catalog scoping.
+
+### TARGET 9 — go-gitea/gitea#36988 re-check (v1.2)
+
+**Verdict (conf 0.95): still open, not merged.**
+
+Re-checked 2026-07-21 via `api.github.com/repos/go-gitea/gitea/pulls/36988`:
+- `state`: open
+- `merged`: false
+- `merged_at`: null
+- `updated_at`: 2026-05-27T16:26:24Z
+- `title`: "Add Actions OIDC provider with workflow permission gating"
+
+No movement since the v1.1 research (2026-07-21 v1.1 research also found it
+open). Real OIDC federation remains impossible for Gitea Actions. **D-047
+adopts**: extend the D-039 per-run-rotated-key waiver for v1.2; real OIDC is
+deferred to v1.3+. The waiver continues to satisfy §12.5's *intent*: no
+*persistently* long-lived key (`scripts/rotate_spike_key.sh` rotates after
+each run; Phase 12 tightens IAM scoping + rotation hygiene).
+
+### TARGET 10 — NFR audit of the v1.1 spike
+
+Audited the v1.1 spike's operational code for NFR gaps.
+
+**`terraform/bootstrap/spike_runner_policy.json`** — least-privilege PASS
+already. Explicit Allow list (S3 state bucket R/W, DynamoDB outbox R/W,
+`sts:GetCallerIdentity`) + `DenyEverythingElse` on `*` with `NotResource`.
+No wildcards in the Allow statements. **v1.2 gap**: the policy only covers
+S3 + DynamoDB + STS — Phase 15's `terraform apply` to ECS needs ECS + ECR +
+ELB + IAM (plan + apply) permissions added. Phase 12 scopes the policy
+expansion; Phase 15 applies it.
+
+**`terraform/bootstrap/create_state_backend.py`** — idempotent PASS already.
+`head_bucket` → skip-create if exists; `describe_table` → skip-create if
+exists; `put_bucket_versioning` is idempotent. **No v1.2 change needed.**
+
+**`terraform/bootstrap/create_iam_user.py`** — idempotent PASS already.
+`get_user` → skip-create if exists; `put_user_policy` overwrites (idempotent);
+`list_access_keys` → skip-create if an active key exists. **No v1.2 change
+needed.**
+
+**`scripts/run_spike_plan.sh` + `scripts/run_spike_e2e.sh`** — two scripts,
+overlapping setup (env loading, `cd terraform/spike`, `terraform init`).
+`run_spike_e2e.sh` is the superset (full pipeline); `run_spike_plan.sh` is
+the plan-only subset. **v1.2 simplification (Phase 12)**: consolidate into
+one `scripts/run_platform.sh` with a `--plan-only` flag (default: full e2e).
+Removes ~30 lines of duplication.
+
+**`scripts/rotate_spike_key.sh`** — idempotent PASS (always ends with exactly
+1 active key). Uses the bootstrap root key to rotate; documented that D-034
+closure (root key deactivation) is a manual user step. **No v1.2 change
+needed** (the root key is now deactivated per D-034 closure; rotation uses
+the spike key itself or a separate rotation credential — flagged as a v1.2
+operational note in Phase 12).
+
+**Error handling**: `run_spike_e2e.sh` uses `set -u` + a `fail()` helper —
+good. `run_spike_plan.sh` uses `set -u` + inline exits — adequate. The
+consolidated `run_platform.sh` should use `set -euo pipefail` + `fail()`
+for uniform strictness.
+
+**P1-1 redaction target (Phase 12 — DONE)**: the v1.1 `.ciagent/` audit
+narrative referenced two AWS access key IDs (`AKIA…SPIKE` rotated spike
+key, `AKIA…ROOT-DEACTIVATED` deactivated root key). Public identifiers,
+not secret pairs, in the audit narrative not executable code. **Phase 12
+redacted** them to `AKIA…SPIKE` / `AKIA…ROOT-DEACTIVATED` across
+`.ciagent/RESEARCH.md`, `PROJECT.md`, `REVIEW.md`, `AUDIT.md`.
+
+**P1-B stale paths**: `.ciagent/PERSONAS.md` line 47 still has
+`platform/registry/**` (the rest were fixed at `ab69d10`). **Phase 12
+fixes** line 47 to `acdl_platform/registry/**` (or removes it — there is no
+`acdl_platform/registry/` dir; the registry is `modules-ir/registry.json`).
+
+### TARGET 11 — Simplification opportunities
+
+1. **Script consolidation** (above): `run_spike_*.sh` → `run_platform.sh`.
+2. **`terraform/spike/.terraform/` artifacts**: gitignored already
+   (`.gitignore` covers `.terraform/`, `.terraform.lock.hcl`, `tfplan`,
+   `*.tfstate*`). No change.
+3. **`acdl_platform/__pycache__/`**: gitignored already. No change.
+4. **Dead code**: none found — the spike is tight. The `run_spike_plan.sh`
+   script is the only redundancy (subsumed by `run_platform.sh --plan-only`).
+5. **`demo/` archive**: correctly separated; no v1.2 touch.
+
+### TARGET 12 — README rewrite plan
+
+Current `README.md` (51 lines) is stale: "v1.1 (active)" framing, no
+"how to run the platform" section, no v1.2 objective. **Phase 11 rewrites
+it** to reflect:
+- v1.1 complete (tag `v1.2.0`); v1.0 demo archived under `demo/`.
+- The actual spike flow: contract → IR → `terraform plan` → Checkov →
+  confidence signal → outbox.
+- How to run: `scripts/run_platform.sh` (after Phase 12; for now
+  `scripts/run_spike_e2e.sh`).
+- Real repo layout table (the existing one is accurate; refresh the
+  "Populated" column).
+- v1.2 objective (platform hardening + ECS microservice).
+
+### TARGET 13 — ECS L1 catalog scoping (for Phase 13)
+
+Six L1s needed for an ECS Fargate microservice. Each maps to one or more
+AWS Terraform resources; the adapter `TYPE_MAP` (currently
+`{"aws:s3:bucket": "aws_s3_bucket"}`) needs expansion:
+
+| L1 | IR type(s) | Terraform resource(s) | Key inputs |
+|----|-----------|----------------------|-----------|
+| `l1-vpc` | `aws:ec2:vpc`, `aws:ec2:subnet`, `aws:ec2:routetable` | `aws_vpc`, `aws_subnet`, `aws_route_table` + associations | cidr, azs |
+| `l1-ecs-cluster` | `aws:ecs:cluster` | `aws_ecs_cluster` | name |
+| `l1-ecs-service` | `aws:ecs:service`, `aws:ecs:task_definition` | `aws_ecs_service`, `aws_ecs_task_definition` | image, port, cpu, memory, env |
+| `l1-iam-role` | `aws:iam:role`, `aws:iam:rolepolicyattachment` | `aws_iam_role`, `aws_iam_role_policy_attachment` | task + exec role |
+| `l1-alb` | `aws:elbv2:loadbalancer`, `aws:elbv2:listener`, `aws:elbv2:targetgroup` | `aws_lb`, `aws_lb_listener`, `aws_lb_target_group` | port, protocol |
+| `l1-ecr` | `aws:ecr:repository` | `aws_ecr_repository` | name |
+
+The IR schema (`schemas/ir.schema.json`) is substrate-agnostic and already
+supports arbitrary resource types — no schema change needed, only new
+`interface.json` files + `TYPE_MAP` entries. The `l2-microservice`
+thin-composition references all six (depth ≤ 5).
+
+### Decisions surfaced (v1.2)
+
+| ID | Decision | Rationale | Confidence | Alternatives |
+|----|----------|-----------|------------|--------------|
+| **D-047** | Extend D-039 per-run-rotated-key waiver for v1.2. Real OIDC deferred to v1.3+. | go-gitea/gitea#36988 still open (TARGET 9). The waiver satisfies §12.5's intent for v1.2; Phase 12 tightens IAM + rotation hygiene. | 0.95 | (a) wait for #36988 (blocks v1.2 indefinitely); (b) self-hosted OIDC broker (heavy); (c) KMS-backed ephemeral creds (scope creep for v1.2). |
+| **D-048** | Consolidate `run_spike_plan.sh` + `run_spike_e2e.sh` → one `scripts/run_platform.sh` with `--plan-only` flag (default: full e2e). | Two scripts with overlapping setup (~30 lines duplicated). One script with a flag is simpler and matches the "streamline" scope axis. | 0.90 | Keep both (redundant); delete `run_spike_plan.sh` only (loses the plan-only convenience). |
+| **D-049** | v1.2 L1 catalog = 6 L1s (`l1-vpc`, `l1-ecs-cluster`, `l1-ecs-service`, `l1-iam-role`, `l1-alb`, `l1-ecr`). The adapter `TYPE_MAP` expands to 9 IR types (3 new for VPC, 3 for the rest). | Minimal set to deploy an ECS Fargate service end-to-end. VPC is split into vpc/subnet/routetable because the IR models one resource per `interface.json` entry, but the L1 groups them. | 0.85 | Fewer L1s (e.g. fold VPC into the ECS service — violates L1 single-purpose); more L1s (e.g. separate `l1-securitygroup` — scope creep for v1.2). |
+
+---
+
+## v1.8 Research Addendum
+
+> Phase: research (pre-Phase 28). Milestone: v1.8. Status: active.
+> Researcher: ci-researcher. Autonomy: full.
+> Sources: web (uptime-kuma GitHub, Terraform docs, AWS KMS docs, AWS
+> ECS Fargate docs, GitHub Actions docs) + ACDL codebase analysis.
+
+### RESEARCH TARGET 1 — uptime-kuma deployment on ECS Fargate
+
+**Verdict: ECS Fargate is the most cost-effective cloud-native option
+for deploying uptime-kuma, consistent with the existing platform
+primitives (ecs-cluster, ecs-service, alb).**
+
+Findings (verified 2026-07-22):
+
+1. **uptime-kuma Docker image:** `louislam/uptime-kuma:1` (v1) or
+   `louislam/uptime-kuma:2` (v2, latest stable 2.4.0 as of 2026-05-31).
+   The container listens on port 3001. Data is stored in `/app/data`
+   (SQLite + uploaded files). NFS is not supported for the data volume;
+   EFS is the AWS-native equivalent and works with ECS Fargate.
+
+2. **Monitoring capabilities:** HTTP(s), TCP, HTTP(s) Keyword, HTTP(s)
+   JSON Query, WebSocket, Ping, DNS Record, Push, Steam Game Server,
+   Docker Containers. 20-second intervals minimum. Certificate info.
+   Proxy support. 2FA support.
+
+3. **Notification services (90+):** Telegram, Discord, Gotify, Slack,
+   Pushover, Email (SMTP), Microsoft Teams (via webhook), and many
+   others. For the ACDL primitive, we expose: Teams webhook, email
+   (SMTP), SMS (via SNS or an external gateway), and GitHub issues
+   (via the GitHub API).
+
+4. **ECS Fargate deployment shape:**
+   - Task definition: 1 container (`louislam/uptime-kuma:1`), port 3001,
+     CPU 256 (.25 vCPU), Memory 512 (.5 GB) — minimal cost (~$5/mo
+     at us-east-1 on-demand pricing for .25 vCPU + .5 GB running 24/7).
+   - EFS volume for `/app/data` (persistent storage across task
+     restarts; Fargate + EFS is the standard pattern for stateful
+     containers).
+   - ALB + listener for a stable public URL (the uptime dashboard).
+   - CloudWatch log group (encrypted with the per-stack CMK).
+
+5. **Endpoint seeding:** uptime-kuma has a REST API (socket.io-based).
+   The platform can seed monitors by either:
+   - (a) Passing `UPTIMA_KUMA__monitors` env var (JSON array) consumed
+     by a startup script — but uptime-kuma does not natively read env
+     for monitor config.
+   - (b) A post-deploy seeding script that calls the uptime-kuma API
+     (`POST /api/monitor`) to create monitors from the `monitored_endpoints`
+     input. This is the cleaner approach — the platform runs a Python
+     script after the ECS service is up that creates monitors via the
+     API.
+   - **Recommendation:** (b) — a `scripts/seed_uptime_monitors.py` that
+     reads the `monitored_endpoints` from the stack outputs + calls the
+     uptime-kuma API. This is testable offline (mocked API) and
+     decouples container startup from monitor configuration.
+
+6. **Separate terraform state:** The uptime stack uses a separate S3
+   key prefix (`uptime/{consumerRepo}/{contractId}/`) so it is
+   independent of the consumer stack's state. The uptime stack has its
+   own VPC + ALB + ECS cluster (or shares the consumer's — design
+   decision: **separate** to avoid state coupling, per the requirement
+   "separate terraform run, with a separate state").
+
+7. **Feature flag:** The `feature_flag_enabled` input (set from the
+   consumer contract `inputs.uptime_enabled`, default true) controls
+   whether the `deploy-uptime` pipeline stage runs. When false, the
+   stage is skipped entirely (no resources emitted, no API calls).
+
+### RESEARCH TARGET 2 — Terraform prevent_destroy lifecycle
+
+**Verdict: `lifecycle { prevent_destroy = true }` is the correct
+Terraform mechanism for deletion protection. It prevents `terraform
+destroy` from destroying the resource without first setting
+`prevent_destroy = false`.**
+
+Findings (verified 2026-07-22):
+
+1. **`prevent_destroy`** is a meta-argument inside a `lifecycle {}`
+   block within a resource. When set to `true`, any Terraform plan
+   that would destroy the resource will fail with an error. To destroy,
+   the user must first set `prevent_destroy = false` and apply, then
+   destroy.
+
+2. **This is exactly the 2-step decommission pattern the user
+   requested:** Step 1: set `deletion_protection = false` (which the
+   adapter translates to `prevent_destroy = false`) + apply. Step 2:
+   set all counts to 0 + apply (which destroys the resources now that
+   prevent_destroy is false).
+
+3. **Adapter emission:** The adapter should emit `lifecycle { prevent_destroy = true }`
+   inside each resource block when the `deletion_protection` NFR is
+   true. When false, omit the `lifecycle` block (or set
+   `prevent_destroy = false`). This is a per-resource meta-argument,
+   not a provider-level setting.
+
+4. **RDS special case:** RDS already has a `deletion_protection`
+   argument on `aws_db_instance` (not a lifecycle meta-arg). The
+   adapter should emit BOTH: the `deletion_protection` argument (for
+   the RDS API-level protection) AND `lifecycle { prevent_destroy = true }`
+   (for the Terraform-level protection). This is defense-in-depth.
+
+### RESEARCH TARGET 3 — AWS KMS key rotation
+
+**Verdict: `enable_key_rotation = true` on `aws_kms_key` enables
+automatic annual rotation (AWS rotates the key material annually).
+For 90-day rotation, a custom key rotation policy is needed (AWS
+managed rotation is annual only; 90-day requires a manual rotation
+schedule or a custom multi-region key + rotation Lambda).**
+
+Findings (verified 2026-07-22):
+
+1. **`aws_kms_key`** with `enable_key_rotation = true` enables AWS's
+   automatic key material rotation. AWS rotates the backing key material
+   annually (365 days). This is the simplest option and is the AWS
+   best practice for most use cases.
+
+2. **90-day rotation:** AWS does not support custom rotation periods
+   for managed keys. To achieve 90-day rotation:
+   - (a) Use `aws_kms_key` with `enable_key_rotation = true` (annual
+     AWS-managed rotation) + a CloudWatch Events rule that triggers a
+     Lambda every 90 days to create a new key + update the alias. This
+     is complex and overkill for v1.8.
+   - (b) Accept annual AWS-managed rotation as the default and document
+     that 90-day rotation requires a custom rotation pipeline (roadmap
+     item). The `enable_key_rotation = true` is the v1.8 implementation;
+     the 90-day requirement is a roadmap enhancement.
+
+   **Recommendation:** (b) — `enable_key_rotation = true` (AWS-managed
+   annual rotation) as the v1.8 implementation. The 90-day requirement
+   is documented as a roadmap item (custom rotation Lambda). The NFR
+   `enable_rotation` (default true) controls the `enable_key_rotation`
+   argument. This is pragmatic; annual rotation is AWS's best practice
+   and 90-day is a future enhancement.
+
+3. **Per-stack CMK pattern:** Each L2 deployment creates its own
+   `aws_kms_key` + `aws_kms_alias` (alias/acdl-<stack-name>-<env>).
+   The key is tagged with `acdl:owner` + `acdl:environment`. All
+   primitives in the stack reference this key via `kms_key_arn`.
+   No shared keys across stacks.
+
+4. **Managed KMS fallback:** When a primitive is deployed standalone
+   (L1 without an L2 CMK), the adapter uses `alias/aws/<service>`
+   (e.g. `alias/aws/s3`, `alias/aws/rds`). This is the AWS-managed
+   key for that service. The adapter emits a stderr warning when
+   falling back. The `kms_key_arn` input is optional; the
+   `encryption_enabled` NFR defaults to true.
+
+### RESEARCH TARGET 4 — Forge-agnostic API URLs (P1-9)
+
+**Verdict: GitHub and Gitea have compatible issue APIs but different
+search endpoints. A `GITHUB_API_BASE` env var + `_forge_type()`
+helper branches the search URL.**
+
+Findings (verified 2026-07-22):
+
+1. **GitHub API:** `https://api.github.com/search/issues?q=...` for
+   search; `https://api.github.com/repos/{owner}/{repo}/issues` for
+   create; `https://api.github.com/repos/{owner}/{repo}/issues/{n}/comments`
+   for comments.
+
+2. **Gitea API:** `https://git.cloudinit.dev/api/v1/repos/{owner}/{repo}/issues?...`
+   for search (no `/search/issues` endpoint — issues are listed via
+   the repo issues endpoint with query params); `https://git.cloudinit.dev/api/v1/repos/{owner}/{repo}/issues`
+   for create; `https://git.cloudinit.dev/api/v1/repos/{owner}/{repo}/issues/{n}/comments`
+   for comments.
+
+3. **Detection:** If `GITHUB_API_BASE` contains `/api/v1`, it's Gitea;
+   otherwise it's GitHub. The `_forge_type()` helper returns `"gitea"`
+   or `"github"` based on this. The search URL is branched accordingly;
+   the create + comment URLs are the same pattern (`{base}/repos/{owner}/{repo}/issues`).
+
+4. **Auth:** Both use `Authorization: token <token>` header. GitHub
+   also accepts `Authorization: Bearer <token>`; Gitea uses `token`.
+   The existing `token` header works for both.
+
+### RESEARCH TARGET 5 — DynamoDB as CMDB for change requests
+
+**Verdict: A DynamoDB `acdl-change-requests` table is consistent with
+the existing platform Lambda + DynamoDB pattern (D-051). The
+`validate_change_request` Lambda action queries the table + asserts
+status=approved.**
+
+Findings (verified 2026-07-22):
+
+1. **Table schema:** PK `changeRequestId` (string), SK `submittedAt`
+   (string). Attributes: `consumerRepo`, `contractId`, `status`
+   (enum: `requested|approved|rejected|executed`), `requestedBy`,
+   `approvedBy`, `submittedAt`, `executedAt`.
+
+2. **Validation flow:** The decommission pipeline's
+   `validate-change-request` stage invokes the Lambda with
+   `action: validate_change_request`, `changeRequestId: <id>`,
+   `consumerRepo: <repo>`. The Lambda queries the table; if the item
+   exists + `status == "approved"` + `consumerRepo` matches, returns
+   200 with the CR details. Otherwise returns 403.
+
+3. **Terraform:** Add the table to `terraform/platform/main.tf` with
+   SSE via the platform CMK + point-in-time recovery (matching the
+   `acdl-contracts` table pattern from D-051).
+
+### RESEARCH TARGET 6 — Module engineering standards (scan of current modules)
+
+**Verdict: The current modules follow a consistent pattern that can
+be codified into standards. Key patterns identified:**
+
+1. **L1 required files:** `interface.json`, `instance.json`,
+   `README.md`, `examples/simple.yaml`, `examples/complex.yaml`.
+   Multi-resource L1s add `resources[]` + `intra_refs[]` to
+   `interface.json`.
+
+2. **L2 required files:** `composition.json`, `README.md`,
+   `examples/simple.yaml`, `examples/complex.yaml`. No `instance.json`.
+
+3. **Interface shape:** `name`, `version`, `kind` ("l1"|"l2"),
+   `type` (L1 only, `aws:<service>:<kind>`), `description`,
+   `inputs` (object keyed by name), `outputs` (object keyed by name),
+   `nfrs` (object keyed by name). Multi-resource L1s add `resources[]`
+   (array of `{type, description, inputs[], outputs[]}`) +
+   `intra_refs[]` (array of `{from, to}`).
+
+4. **Input shape:** `{type, description, required, [default], [enum]}`.
+   Output shape: `{type, description}`. NFR shape:
+   `{type, description, default}`.
+
+5. **NFR conventions (v1.8 additions):** Every L1 MUST have
+   `deletion_protection` (boolean, default true) + `encryption_enabled`
+   (boolean, default true) NFRs. L2 modules MUST expose
+   `features.deletion_protection` (default true) +
+   `features.uptime_enabled` (default true).
+
+6. **Registry:** Every module MUST be registered in
+   `modules/registry.json` at its semver. Entry:
+   `{"interface": "<path>", "published_at": "<iso>", "deprecated": false}`.
+
+7. **Adapter extension:** 3-table pattern (TYPE_MAP + INPUT_MAP +
+   OUTPUT_MAP) + specialized `_emit_resource` branches for complex
+   resources (nested blocks like `origin {}`, `rules {}`,
+   `default_cache_behavior {}`).
+
+8. **README structure:** `# <name> — <description>`, `## Resources`,
+   `## Inputs`, `## Outputs`, `## NFRs`, `## Usage`, `## Compliance
+   extension points`, `## Examples`, `## Versioning`.
+
+9. **Catalog index gap:** `modules/README.md` Primitives table is
+   missing `rds` (flagged during scan). Must be fixed in Phase 35.
+
+### Decisions surfaced (v1.8)
+
+| ID | Decision | Rationale | Confidence | Alternatives |
+|----|----------|-----------|------------|--------------|
+| **D-073** | uptime-kuma v1 (`louislam/uptime-kuma:1`) as the default container image. | v1 is stable + widely deployed. v2 (2.4.0) is newer but has breaking changes. v1 is the safer default; consumers can override via `container_image` input. | 0.85 | v2 (breaking changes risk); pin to a specific v1 tag (maintenance burden). |
+| **D-074** | Monitor seeding via post-deploy API script (`scripts/seed_uptime_monitors.py`), not env vars. | uptime-kuma does not natively read env for monitor config. A post-deploy script calling the API is cleaner + testable offline. | 0.90 | Env var config (not supported by uptime-kuma); manual config (defeats automation). |
+| **D-075** | KMS rotation = `enable_key_rotation = true` (AWS-managed annual). 90-day rotation is a roadmap item (custom rotation Lambda). | AWS does not support custom rotation periods for managed keys. Annual is the AWS best practice. 90-day requires a custom Lambda + CloudWatch Events rule — overkill for v1.8. | 0.80 | Custom rotation Lambda (complex, overkill); no rotation (violates requirement). |
+| **D-076** | uptime stack = separate VPC + ALB + ECS cluster (not shared with consumer stack). | Requirement says "separate terraform run, with a separate state". Sharing the consumer's VPC/ALB would couple the states. Separate infra is cleaner + isolates the uptime stack's lifecycle. | 0.85 | Share consumer's VPC/ALB (state coupling); use App Runner (new service type). |
+| **D-077** | EFS volume for uptime-kuma `/app/data` (persistent storage across task restarts). | Fargate + EFS is the standard pattern for stateful containers. NFS is not supported by uptime-kuma, but EFS is NFS-compatible + works with Fargate. | 0.90 | S3-backed (uptime-kuma doesn't support S3); no persistent storage (data lost on restart). |
+
+---
+
+## v1.9 Research Addendum (Phase 0, 2026-07-23)
+
+> Milestone v1.9. Researcher: lead-developer. Autonomy: full. The v1.9
+> scope is well-grounded in the existing codebase; the research is a
+> focused addendum covering the four new implementation domains
+> (interpolation, per-env workflow inputs, Wiz GraphQL, attestation
+> matrix freshness validation) + the design-doc drift audit.
+
+### RA-1 — Contract interpolation prior art + syntax choice (D-081)
+
+**Finding:** Variable expansion in declarative manifests is a solved
+pattern. Terraform uses `${var.x}` / `${local.x}`; Helm uses `{{ .Values.x }}`;
+GitHub Actions uses `${{ }}`; CloudFormation uses `!Ref` / `!Sub`. The
+contract schema is YAML validated by `jsonschema` — the schema does not
+inspect string *contents*, so any token syntax is schema-safe.
+
+**Choice:** `${env.<field>}` + `${contract.<field>}` (D-081). Rationale:
+- Shell-style `${...}` is the most familiar to the platform's audience
+  (DevOps engineers comfortable with Terraform/HCL).
+- Dotted paths (`${env.state_backend.bucket}`) mirror Python attribute
+  access and the existing `wire["from"]` syntax (`contract.inputs.x`,
+  `<childId>.outputs.y`).
+- No conflict with YAML (`${}` inside a YAML string is a literal until
+  the resolver expands it) or with `jsonschema` (string content is not
+  schema-constrained).
+- Jinja `{{ }}` was considered (supports future filters) but rejected —
+  the contract is a data file, not a template; filters would invite
+  logic-in-config anti-patterns.
+
+**Implementation shape:** a single `_expand_vars(value, context)`
+recursive walker in `core/contract_resolver.py`. Context =
+`{"env": <loaded env json>, "contract": <contract dict>}`. Unknown
+token → `ValueError` with the token text (fail loud, no silent
+passthrough — consistent with the P1-3 SSM fail-loud precedent).
+
+**Confidence:** 0.92. Risk: none — the expansion is post-schema-validation
+and pre-IR-resolution, so it cannot break the schema or the adapter.
+
+### RA-2 — GitHub Actions `workflow_call` `environment` input + per-env jobs (D-082)
+
+**Finding:** GitHub Actions `workflow_call` inputs support `type: string`
+with no enum constraint at the workflow-call layer (enum constraints
+exist only for `choice`-typed *workflow_dispatch* inputs). The deploy
+workflow already uses `workflow_call` with `contract` + `mode` +
+`changeRequestId` string inputs. Adding an `environment` string input
+(default empty, validated by `run_platform.sh`) is a one-line addition.
+
+**Per-env job pattern:** the consumer repo's *caller* workflow
+(`.github/workflows/deploy-<env>.yml`) does:
+```yaml
+jobs:
+  deploy-qa:
+    uses: acdl/.github/workflows/deploy.yml@v1.9
+    with:
+      environment: qa
+      contract: .acdl/static-assets.qa.yaml
+```
+One caller workflow per environment = one CI job per environment. The
+`environment:` field in the contract is not edited for promotion;
+promotion = running the qa caller. The hybrid model (D-082) also lets a
+single contract be promoted via the `environment` input alone.
+
+**Gitea caveat:** Gitea Actions supports `workflow_call` (reuses the
+GitHub Actions workflow YAML). The `environment` input works identically.
+Gitea has no Environments API (D-013/D-042) — the HITL gate is the
+`workflow_dispatch` approval-input fallback (already documented in
+`hitl_matrix_design.md`). For `workflow_call` (reusable), the caller
+workflow's `workflow_dispatch` trigger carries the approval input.
+
+**Confidence:** 0.90. Risk: the Gitea `workflow_call` + approval-input
+combination needs the caller to be `workflow_dispatch`-triggered (not
+`workflow_call`-triggered) for the gate to fire — documented in Phase 41.
+
+### RA-3 — Wiz GraphQL API shape (D-0xx, REQ-110)
+
+**Finding:** Wiz exposes a GraphQL API at `<WIZ_API_URL>/graphql`. Auth
+= `Authorization: Bearer <WIZ_API_TOKEN>`. The primary query for issues:
+```graphql
+query IssuesQuery($filterBy: IssueFilter) {
+  issues(filterBy: $filterBy) {
+    nodes { id severity title entity { name type } control { name }
+            createdAt }
+    pageInfo { hasNextPage endCursor }
+  }
+}
+```
+Wiz severity enum: `CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL`.
+Mapping to `PolicyCheckResult`:
+- `engine: "wiz"`
+- `ruleId: <control.name>` (or `WIZ_<issue.id>` fallback)
+- `severity: <wiz severity lowercased>`
+- `status: FAIL` (Wiz issues are findings; pass = no issues returned)
+- `message: <title>`
+- `resource: <entity.name>`
+
+**Graceful degrade:** when `WIZ_API_TOKEN` or `WIZ_API_URL` unset → emit
+the existing single `SKIPPED` `WIZ_NOT_CONFIGURED` record (no network
+call). Offline tests use a recorded JSON fixture (no live Wiz tenant).
+
+**Confidence:** 0.80. Risk: Wiz API version drift — the query shape is
+stable as of Wiz API v2 (2026), but the fixture is the test's source of
+truth, not the live API.
+
+### RA-4 — Attestation matrix freshness validation (D-084, REQ-109)
+
+**Finding:** The 8 concerns in `hitl_matrix_design.md` §10.4 have
+declared freshness windows (24h, 7d, 30d, 90d, 180d). Operator-supplied
+evidence (load test, DR drill, FinOps forecast, runbook) is uploaded as
+a signed blob. The matrix validates:
+1. **Presence** — the evidence artifact exists for the target env.
+2. **Freshness** — `artifact.timestamp` is within the declared window.
+3. **Schema** — the artifact matches a per-concern JSON schema (e.g.
+   load-test artifact has `p99_latency`, `throughput`, `pass_rate`).
+4. **Signature** (when `ACDL_ATTESTATION_SIGNING_KEY_ID` set) — JWS
+   detached signature verification against a platform KMS key. When
+   unset (dev/CI), signature verification is skipped (offline-testable).
+
+**Offline-testable concerns** (run for real, no operator input):
+- Contract NFRs (the platform's own contract validator).
+- Schema validity (jsonschema).
+- Policy pass (Checkov/Wiz/Kyverno `PolicyCheckResult` records).
+
+**Operator-supplied concerns** (require uploaded artifact):
+- Functional correctness (e2e suite report).
+- Performance baseline (k6/Gatling report).
+- Security posture (Trivy/Snyk scan + Security signature).
+- Operational readiness (runbook/dashboard/oncall/alerts).
+- Incident response (Sev-1 drill record).
+- Capacity/cost (FinOps forecast).
+- Resilience (DR drill, chaos report, backup verification).
+- dr-region deploy (dr drill report).
+
+**Confidence:** 0.88. Risk: the signature verification path is only
+exercised when a signing key is configured (dev/CI skips it); production
+deployment must set `ACDL_ATTESTATION_SIGNING_KEY_ID`.
+
+### RA-5 — Design doc drift audit (REQ-100, REQ-101)
+
+**`core/hitl_matrix_design.md` drift:**
+- Status block says "v1.2 wires the gates" — stale (v1.9 wires them).
+- "Spike scope note" says "the spike is dev-only; HITL is not exercised"
+  — stale (v1.9 exercises qa/prod/dr).
+- §10.4 matrix is presented as design-only — v1.9 implements the
+  offline-testable subset (D-084).
+- D-042 approver-identity mechanics are still accurate (Gitea has no
+  Environments API; `gitea.actor` is the approver of record).
+
+**`core/audit_ledger_design.md` drift:**
+- "Spike scope (D-041)" says "Phases 08-10 implement" — stale (the
+  outbox is shipped + production since v1.8).
+- "v1.2 build-out" (S3 Object Lock + JWS + worker + DLQ + checkpoints)
+  never shipped; v1.9 defers it explicitly (D-083).
+- The outbox item shape is still accurate; the `approver_qa`/
+  `approver_prod` attributes are populated by v1.9's `hitl_gates.attest`.
+
+**Confidence:** 0.95. Risk: none — doc-only.
+
+### RA-6 — P1-1 adapter defaults audit (D-085, REQ-102)
+
+**Hardcoded defaults found in `adapters/terraform/adapter.py`:**
+- `desired_count = 1` (ECS service, 2 occurrences: line 238, 481).
+- `launch_type = "FARGATE"` (ECS service, line 239, 482).
+- `family = "app"` (task def, line 254 — reads `inputs.get("family", "app")`
+  so partially parameterized; the `"app"` default should move to the
+  interface).
+- `target_type = "ip"` (ALB target group, line 274).
+- `load_balancer_type = "application"` (ALB, line 272).
+- `Name = "acdl-microservice-rt"` (route table, line 283) + `Name = ...`
+  tags on VPC/IGW (lines 515, 542 `name = "app"`).
+
+**Fix:** add `desired_count`, `launch_type`, `family`, `target_type`,
+`load_balancer_type`, `name` (VPC/IGW/RT) to the corresponding L1
+`interface.json` `inputs` with defaults. The adapter reads
+`inputs.get("<name>", <default>)` — but the resolver should populate
+the default from the interface so the adapter reads `inputs["<name>"]`
+with a fallback only for safety. Tests assert an override emits the
+overridden value.
+
+**Confidence:** 0.90. Risk: low — the v1.1 S3 regression test must
+still pass (S3 has none of these inputs).
+
+### Decisions surfaced (v1.9)
+
+| ID | Decision | Rationale | Confidence | Alternatives |
+|----|----------|-----------|------------|--------------|
+| **D-087** | Interpolation expansion is recursive over dicts + lists + strings (not just top-level inputs). | A nested input like `env: { DATABASE_URL: "acdl-${env.environment}-db" }` should expand too. | 0.90 | Top-level only (misses nested maps). |
+| **D-088** | The `environment` workflow_call input overrides the contract's `environment` field *before* schema validation, so the schema sees the overridden value. | Interpolation context depends on the resolved environment; override must happen pre-validation so `${env.environment}` is consistent. | 0.92 | Override post-validation (inconsistent interpolation context). |
+| **D-089** | Attestation artifact signature verification is skipped when `ACDL_ATTESTATION_SIGNING_KEY_ID` is unset (dev/CI); required for prod/dr. | Offline tests cannot sign with a real KMS key. The skip is explicit + logged. | 0.85 | Always require signature (breaks offline tests). |
+
+---
+
+*End of RESEARCH.md v1.9 addendum.*

.ciagent/REVIEW.md

@@ -0,0 +1,165 @@
+# ACDL v1.9 Milestone — Multi-Persona Code Review
+
+**Reviewer:** ci-code-reviewer (model: glm-5.2)
+**Scope:** v1.9 milestone — Phases 39–42 (tags v1.8.1..v1.8.4), diff `v1.8.0..HEAD`
+**Date:** 2026-07-23
+**Verdict:** **READY TO SHIP** — 1 P0 auto-fixed, 1 P1 auto-fixed, 3 P1 flagged for post-hoc
+
+> **Note (D-086):** This REVIEW.md was reconstructed at v1.9 complete.
+> The previous content was the v1.2 milestone review (v1.3–v1.8 reviews
+> were not persisted to this file). No git history was rewritten; the
+> v1.2 review is preserved in git history at the v1.2 review commit.
+>
+> **Review pass 2 (post-complete):** this review was re-run after the
+> milestone COMPLETE to catch issues the initial self-review missed. The
+> P0 (approver injection) and P1 (future-dated freshness) were auto-fixed.
+
+---
+
+## Summary
+
+v1.9 closes four gaps left by v1.8 (user-directed, 2026-07-23): stale
+design docs, no contract interpolation, promotion requires editing the
+`environment` field, and unimplemented stubs. It also closes P1-1
+(adapter hardcoded defaults, deferred from v1.2). 4 phases shipped
+(39–42): design-doc refresh + P1-1 parameterization, contract
+interpolation + env schema, per-environment CI jobs, stub implementation.
+
+## P0 issues
+
+### P0-INJECT (auto-fixed)
+**Shell→Python code injection via `GITHUB_ACTOR` in `scripts/run_platform.sh`
+Step 7b (HITL gate).** The approver identity was interpolated directly
+into a Python string literal (`attest('$CONTRACT_ID', '$RESOLVED_ENV',
+'$APPROVER' ...)`). `GITHUB_ACTOR` (and `GITEA_ACTOR`) are attacker-
+controllable in some CI configurations; a username containing `'; import
+os; os.system(...); y='` would execute arbitrary Python.
+
+**Fix (auto-applied):** the approver, contract id, and env are now passed
+as environment variables to the Python subprocess
+(`ACDL_HITL_CONTRACT_ID`, `ACDL_HITL_ENV`, `ACDL_HITL_APPROVER`) and read
+via `os.environ[...]` inside the Python code — no string interpolation of
+user-controllable values.
+
+## P1 issues
+
+### P1-FRESHNESS (auto-fixed)
+**`core/attestation_matrix.py` `_is_fresh` accepted future-dated
+artifacts.** A `timestamp` in the future produced a negative `age`, and
+`age.days <= window_days` evaluated `True` for negative values, so a
+backdated/future artifact bypassed freshness validation.
+
+**Fix (auto-applied):** added a `age.total_seconds() < 0` guard that
+rejects future-dated artifacts. Test added
+(`test_freshness_rejects_future_dated_artifact`).
+
+### P1-WIZ-ERRORS (flagged for post-hoc)
+**`adapters/wiz/wiz_adapter.py` `WizClient._post` does not check for
+GraphQL `errors` in the response.** A GraphQL API returns
+`{data: ..., errors: [...]}`; if `errors` is present, `data.issues` can
+be `null` and `.get("nodes", [])` silently masks the error as an empty
+list (which then emits `WIZ_NOT_CONFIGURED`). Should surface GraphQL
+errors as a failed PolicyCheckResult or raise.
+
+### P1-WIZ-SSRF (flagged for post-hoc)
+**`WizClient._post` performs no SSRF validation on `WIZ_API_URL`.** A
+malicious `WIZ_API_URL` env var could target an internal endpoint. The
+URL is operator-supplied (not consumer-controllable), so the risk is
+low, but a allowlist/scheme check (`https://`) would harden it.
+
+### P1-OBSOLETE-CHECK (flagged for post-hoc)
+**`core/contract_resolver.py` `_load_env` duplicates
+`core/environment_check.load`.** The duplication was intentional (so the
+resolver works as both a package import and a script), but the two can
+drift. A future refactor should extract a shared helper that both
+import safely.
+
+## Per-lens review
+
+### Correctness
+- The contract interpolation (`_expand_vars`) is recursive over
+  dicts/lists/strings; unknown tokens raise `ValueError` (fail loud).
+  Expansion is post-schema-validation, pre-IR-resolution — the schema
+  sees raw tokens (valid strings), the resolver sees concrete values.
+- The `environment_override` (D-088) is applied BEFORE schema validation
+  so the interpolation context is consistent.
+- P1-1: the adapter reads `desired_count`, `launch_type`, `family`,
+  `target_type`, `load_balancer_type` from inputs (with interface
+  defaults). The resolver's `child_input_map` routes wires to the
+  sub-resource that declares the input (desired_count → aws:ecs:service,
+  family → aws:ecs:task_definition). The v1.1 S3 regression is preserved
+  (byte-identical `main.tf` for S3-only stacks).
+- The HITL attestation gate records the approver to the outbox, runs SoD
+  on prod (blocks on `approver_qa == approver_prod`), invokes the
+  attestation matrix. Dev skips (autonomous).
+- The attestation matrix's freshness validation uses the §10.4 windows;
+  signature verification skips when the signing key is unset (D-089) and
+  is required when set.
+- The Wiz real client uses the GraphQL API with pagination; graceful
+  degrade when unconfigured.
+- The Kyverno translator handles pass/fail/skip/warn + severity + skip-
+  with-reason + resource construction; the inactive-for-TF guard is
+  preserved.
+
+### Testing
+- 493 offline tests (was 350 at v1.8 → 493 at v1.9, +143 new). Each new
+  feature has dedicated tests:
+  - P1-1: `test_p1_1_adapter_parameterization.py` (override + default + regression).
+  - Design docs: `test_design_docs_current.py` (no stale framing).
+  - Interpolation: `test_interpolation.py` + `test_sample_contracts_interpolate.py`
+    + `test_environment_schema.py`.
+  - Per-env jobs: `test_per_env_contracts.py` + `test_deploy_workflow_env_input.py`
+    + `test_consumer_guide_per_env_section.py`.
+  - Stubs: `test_route_halt_artifact.py` + `test_hitl_gates.py` +
+    `test_attestation_matrix.py` + `test_wiz_adapter_real_client.py` +
+    expanded `test_kyverno_adapter.py`.
+- `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0.
+
+### Security
+- No credentials introduced. The SNS topic is KMS-encrypted.
+- SoD blocks on identity equality; the halt artifact is in the audit chain.
+- The attestation matrix fails loud on missing/expired evidence for prod/dr.
+- Signature verification is required when the signing key is set.
+- The adapter has no hardcoded resource defaults (P1-1 closed) — defaults
+  live in the L1 interface, not the adapter.
+
+### Performance
+- N/A (this milestone is about correctness + design-doc accuracy + stub
+  implementation, not perf).
+
+### Maintainability
+- The interpolation is a single recursive walker; the env context is
+  loaded via a self-contained `_load_env` (works as script + package import).
+- The `child_input_map` makes multi-resource L1 wire routing deterministic
+  (the sub-resource that declares the input receives the value).
+- The attestation matrix's concern lists + freshness table are data-driven
+  (adding a concern is a table extension, not new logic).
+- The Wiz `WizClient` is a clean class with a single `_post` seam (testable
+  with `mock.patch.object`).
+
+### Adversarial
+- The interpolation fail-loud (`ValueError` on unknown tokens) prevents
+  silent mis-resolution — a typo in a token name surfaces immediately,
+  not as a stale literal in the emitted Terraform.
+- The `environment_override` is applied before schema validation, so a
+  contract with `environment: dev` cannot silently interpolate against
+  the dev env when the workflow passes `environment: prod` — the override
+  is authoritative.
+- The SoD check reads `approver_qa` from the outbox (the platform is the
+  only writer); a consumer cannot forge the approver identity.
+- The attestation matrix's signature skip is explicit + logged (not silent).
+
+## Conclusion
+
+v1.9 is READY TO SHIP after the review auto-fixes. 1 P0 (approver
+injection — auto-fixed by passing env vars instead of string
+interpolation) and 1 P1 (future-dated freshness — auto-fixed with a
+negative-age guard + test). 3 P1 flagged for post-hoc (Wiz GraphQL
+error handling, Wiz SSRF validation, `_load_env` duplication). The
+milestone's code is complete + verified: design docs are current,
+contract interpolation works, per-env promotion requires no field
+editing, all stubs are implemented (audit ledger Object Lock/JWS
+build-out deferred per D-083), and P1-1 is closed. Ship tag: `v1.9.0`
+(feature milestone, next minor per run.md — v1.8 shipped `v1.8.0`).
+
+494 offline tests pass (was 350 at v1.8, +144 new); `run_ci.sh` + `run_platform.sh --check-only` green.

.ciagent/ROADMAP.md

@@ -3,7 +3,17 @@
 ## Overview
 
 - **v1.0 (demo):** complete — tag `v1.1.0`, 2026-07-21. All 5 phases shipped + audited PASS.
-- **v1.1 (active):** architecture finalization + v1 spike. 5 phases (06–10).
+- **v1.1 (complete):** architecture finalization + v1 spike. 5 phases (06–10). Tag `v1.2.0`, 2026-07-21. All 5 phases shipped + verified; review READY TO SHIP (0 P0); audit CLEAN. Gitea release id 202.
+- **v1.2 (complete):** platform hardening + first real consumer deployment. 6 phases (11–16). Tag `v1.3.0`, 2026-07-21. All 6 phases shipped + verified; review READY TO SHIP (1 P0 operator action, 1 P1 deferred); audit CLEAN.
+- **v1.3 (complete):** module documentation + thin-composition removal. The L2 composition layer is removed; module READMEs are built out. Tag `v1.3.2`.
+- **v1.4 (complete):** central pipeline contract + shell reproducibility + output streaming. A declarative pipeline contract (`schemas/pipeline.schema.json` + `pipelines/ci.yaml`) binds the Gitea and GitHub workflows to a single source of truth. `scripts/run_ci.sh` mirrors the CI pipeline locally. `scripts/run_platform.sh` streams terraform/checkov output by default.
+- **v1.5 (complete, tag `v1.5.0`):** consumer happy path + zero-trust docs + reusable deploy workflow. README rewritten so the consumer model is unambiguous (consumer owns only contract + app code; the rest is the platform source). Platform-flow + consumer-guide diagrams converted to mermaid. Legacy surface + implementation nomenclature removed from docs. Credentials section rewritten for zero-trust OIDC + ABAC (with a static-key override + daily rotation). A generic `docs/CONSUMER_GUIDE.md` (all L2 modules, versioned `uses:`, consumer-scoped prereqs, run-time platform fetch) replaces the module-specific guide. A byte-identical reusable `deploy.yml` workflow (Gitea + GitHub) implements `pipelines/deploy.yaml` and is invoked by consumer repos via a versioned tag.
+- **v1.6 (complete, tag `v1.6.0`):** consumer-facing docs restructure + terminology normalization + environments concept. `docs/` becomes a Jekyll-style GitHub Pages site. `acdl_platform/` is renamed to `core/`. L2 → "modules", L1 → "primitives", "composition" → "pattern" in prose. README restructured: Features + Roadmap (no internal status), repository roles restated (consumer = app code + contracts + CI definitions), mermaid fixed (visible text, security-checks + infrastructure-apply stages, no tool names), credentials section minus go-gitea/waivers. Platform-managed environments concept + a minimal onboarding scaffold. `.ciagent/` + `.gitea/` references removed from all consumer-facing docs.
+- **v1.7 (complete, tag `v1.7.0`):** production platform + contract ingestion + pipeline maturation. Rename `static-assets` → `static-assets` (D-048 — incl. `.ciagent/` historical narrative). Author `cloudfront` + `waf` primitives; augment `static-assets` to a production-ready S3 + CloudFront (OAC) + WAF stack (D-049). Tagging-standard enforcement (Checkov custom rule, D-043 closure, D-054). Wiz adapter stub (D-052) + Kyverno K8s-native adapter (D-053). Platform Lambda + DynamoDB `acdl-contracts` table for contract ingestion (D-051) + cross-account IAM. Deploy outputs via SSM SecureString + GitHub PR comment (D-050). Uniform error reporting via the Lambda `report_error` action → GitHub issue on the platform repo (D-055); Gitea excluded. Stage comments after every successful pipeline stage. Three platform pipelines (platform-test unit+integration, primitives-plan, patterns-plan). Release job with semver + MAJOR.MINOR/MAJOR tag maintenance (D-057). `uses:`/`ref:` bumped to `@v1.6`; floating `v1.6` + `v1` tags created in Phase 22. Remove the legacy consumer-repos directory (a v1.2 artifact, removed in v1.7); add validated per-module examples (`modules/<name>/examples/`, D-058) including a new RDS primitive demonstrating multi-engine variation (D-059).
+- **v1.8 (complete, tag `v1.8.0`):** P1 remediation + uptime monitoring + engineering standards + encryption/deletion-protection by default + decommission alias + path documentation. Clears 8 pending P1 issues (P1-3..P1-9 + S1). Adds per-stack CMK + encryption-by-default for all primitives. Adds deletion-protection-by-default + L2 feature flag. Adds uptime-kuma primitive (ECS Fargate, deployed by default after L2, separate state, feature flag, alert channels). Adds decommission mode (2-step pipeline with HITL SRE gates + CMDB-validated change request). Adds `modules/STANDARDS.md` (L1+L2 authoring + review standards). Adds `schemas/README.md`, `pipelines/README.md`, `adapters/README.md`.
+- **v1.9.1 (complete, tag `v1.9.1`):** leadership presentation decks. Two leadership-facing presentation decks (How the Platform Works + The Developer Experience) for senior leadership (CTO, Head of Cloud, Head of Infrastructure, Head of DevOps). Each deck has a full markdown source of truth (with speaker notes + mermaid diagrams) and a lean Marp deck (no speaker notes, embedded PNG diagrams). A README documents the 3-step slide creation process (full markdown → Marp synthesis → PPTX export). Docs-only NFR patch.
+- **v1.9.2 (complete, tag `v1.9.2`):** S&P Global Energy theme for presentation decks. Applies the S&P Global Energy brand visual identity (red-core #D6002A, grey-90 #1B1B1B, Akkurat Pro font) to both Marp decks. Title headers changed to full platform name. Footer 'Confidential' → 'Internal'. Title slide subtitle removed. Last DX slide renamed to 'The Desired Outcomes'. Docs-only NFR patch.
+- **v1.9.3 (complete, tag `v1.9.3`):** rendered presentation decks. HTML renderings of both Marp decks committed to docs/presentations/ (self-contained, base64-embedded images, S&P Global Energy theme). PPTX files uploaded to the Gitea release as downloadable attachments. README updated to document HTML as committed artifacts and PPTX as release attachments. Docs-only NFR patch.
 - **v1.0 demo URL:** https://git.cloudinit.dev/continuous-intelligence/acdl-evidence/raw/branch/main/index.html
 
 ---
@@ -71,12 +81,15 @@ phase produced a runnable increment and ended with a phase-completion commit
 
 ---
 
-## v1.1 (Active — architecture finalization + v1 spike)
+## v1.1 (Complete — architecture finalization + v1 spike, 2026-07-21, tag `v1.2.0`)
 
 Five-phase breakdown to finalize the architecture to v1.0 and prove the
 locked commitments with one end-to-end implementation spike. Milestone
-`v1.1-spike` covers the real platform's first materialization. Ship tag at
-milestone COMPLETE: `v1.2.0` (feature milestone, next minor per ship.md).
+`v1.1-spike` covered the real platform's first materialization. Ship tag
+at milestone COMPLETE: **`v1.2.0`** (feature milestone, next minor per
+ship.md). **Status: COMPLETE — all 5 phases shipped (v1.1.1..v1.1.5) +
+verified; review READY TO SHIP (0 P0); audit CLEAN; Gitea release id 202.
+D-034 closed (root key deactivated by user).**
 
 ### Phase 06 — archive-demo-and-reorient
 - **Description:** Move the v1.0 demo (`modules/`, `scripts/`, `evidence-ui/`, `contracts/`, demo `.gitea/workflows/`) to `demo/`. Establish the new repo layout (`platform/`, `schemas/`, `adapters/`, `terraform/`, `modules-ir/`). Rewrite README to reflect the real platform. Verify the demo still runs from `demo/` (regression check).
@@ -90,7 +103,7 @@ milestone COMPLETE: `v1.2.0` (feature milestone, next minor per ship.md).
 
 ### Phase 07 — architecture-v1-finalization
 - **Description:** Resolve the 11 open decisions in `docs/architecture.md` §13 (already recorded in `PROJECT.md`). Author the locked schemas + designs: `schemas/ir.schema.json` (REQ-17), `schemas/policy_check_result.schema.json` (REQ-18), `schemas/contract.schema.json` (REQ-22), `platform/confidence_signal.py` spec (REQ-19), `platform/audit_ledger_design.md` (REQ-20), `platform/hitl_matrix_design.md` (REQ-21). Mark architecture v1.0.
-- **Status:** pending
+- **Status:** complete (v1.1.2)
 - **Depends on:** [06]
 - **Requirements:** REQ-16, REQ-17, REQ-18, REQ-19, REQ-20, REQ-21, REQ-22
 - **Success Criteria:**
@@ -100,7 +113,7 @@ milestone COMPLETE: `v1.2.0` (feature milestone, next minor per ship.md).
 
 ### Phase 08 — aws-oidc-bootstrap
 - **Description:** **Re-scoped per RESEARCH TARGET 1 + D-039.** Gitea Actions does not support `id-token: write` (conf 0.95), so real OIDC is deferred to v1.2. This phase instead: uses the temporary long-lived key (waiver D-034) once to create an S3 state bucket, a DynamoDB lock/outbox table, and an IAM user with a minimal scoped policy (S3 + DynamoDB + plan-only); stores the key as a Gitea Actions secret; implements `scripts/rotate_spike_key.sh` to rotate the key after each spike run. Real OIDC federation is tracked via go-gitea/gitea#36988 for v1.2.
-- **Status:** pending
+- **Status:** complete (v1.1.3)
 - **Depends on:** [07]
 - **Requirements:** REQ-23 (re-interpreted: AWS auth bootstrap + state backend; OIDC deferred to v1.2 per D-039)
 - **Success Criteria:**
@@ -112,7 +125,7 @@ milestone COMPLETE: `v1.2.0` (feature milestone, next minor per ship.md).
 
 ### Phase 09 — v1-spike-ir-and-l1-and-adapter
 - **Description:** Implement the Target Stack IR, one real L1 `l1-s3` (IR-typed interface, registered), and the Terraform adapter that compiles the IR → Terraform `variable`/`output` + root module and emits a real `terraform plan` against AWS (via the rotated-key secret per D-039; OIDC is v1.2). State in S3 + DynamoDB.
-- **Status:** pending
+- **Status:** complete (v1.1.4)
 - **Depends on:** [08]
 - **Requirements:** REQ-24, REQ-26
 - **Success Criteria:**
@@ -121,14 +134,505 @@ milestone COMPLETE: `v1.2.0` (feature milestone, next minor per ship.md).
   - `terraform validate` + `terraform plan` succeed; no long-lived credential in the workflow.
 
 ### Phase 10 — v1-spike-l2-and-contract-e2e
-- **Description:** Implement `l2-static-asset` (thin-composition referencing `l1-s3`), the contract schema + contract→IR resolution, and one end-to-end contract submission (`contracts/spike.yaml` for `l2-static-asset`) flowing through schema validation → IR resolution → `terraform plan` → Checkov `PolicyCheckResult` → confidence signal → evidence event to the DynamoDB outbox. Verify the IR commitments hold (no polyglot mess).
-- **Status:** pending
+- **Description:** Implement `l2-static-assets` (thin-composition referencing `l1-s3`), the contract schema + contract→IR resolution, and one end-to-end contract submission (`contracts/spike.yaml` for `l2-static-assets`) flowing through schema validation → IR resolution → `terraform plan` → Checkov `PolicyCheckResult` → confidence signal → evidence event to the DynamoDB outbox. Verify the IR commitments hold (no polyglot mess).
+- **Status:** complete (v1.1.5)
 - **Depends on:** [09]
 - **Requirements:** REQ-25, REQ-27, REQ-28
 - **Success Criteria:**
-  - `l2-static-asset` references `l1-s3` only (depth 1).
+  - `l2-static-assets` references `l1-s3` only (depth 1).
   - One contract submission completes the full pipeline end-to-end.
   - `scripts/verify_phase10.sh` proves the adapter is the only substrate-specific code.
   - Evidence event is written to the DynamoDB outbox.
 
-After Phase 10: COMPLETE gate — review → ship `v1.2.0` → audit.
+After Phase 10: COMPLETE gate — review → ship `v1.2.0` → audit. **DONE.**
+
+---
+
+## v1.2 (Complete — platform hardening + first real consumer deployment, 2026-07-21, tag `v1.3.0`)
+
+Six-phase breakdown to harden the v1.1 spike, simplify the setup, update
+the docs, and prove the platform delivers real value by deploying a basic
+microservice to AWS ECS Fargate end-to-end. Ship tag at milestone COMPLETE:
+**`v1.3.0`** (feature milestone, next minor per ship.md — v1.1 shipped
+`v1.2.0`). Phase patches `v1.2.1`..`v1.2.6`. **Status: COMPLETE — all 6
+phases shipped (v1.2.1..v1.2.6) + verified; review READY TO SHIP (1 P0
+operator action, 1 P1 deferred to v1.3); audit CLEAN. The terraform apply
+is blocked by the live IAM policy (P0-IAM, operator action); the platform
+flow is verified end-to-end up to terraform plan (13 to add).**
+
+### Phase 11 — v1.2-research-and-readme
+- **Description:** Re-evaluate go-gitea/gitea#36988 (OIDC for Gitea Actions) — confirm still open (re-checked 2026-07-21: open, last updated 2026-05-27, not merged) and record the decision to extend D-039 as D-047. Audit the v1.1 spike for NFR gaps (least-privilege IAM, idempotency, error handling, rotation hygiene) and simplification opportunities (script consolidation, dead code, stale paths). Rewrite `README.md` to reflect v1.1 complete + the actual spike flow + how to run + the real repo layout + the v1.2 objective.
+- **Status:** complete (v1.2.1)
+- **Depends on:** —
+- **Requirements:** REQ-29
+- **Success Criteria:**
+  - `RESEARCH.md` has a v1.2 addendum with the #36988 re-check + NFR audit + simplification findings.
+  - `README.md` reflects v1.1 complete; documents the spike flow, `scripts/run_platform.sh`, the repo layout, and the v1.2 objective; no stale "v1.1 (active)" framing.
+  - D-047 is recorded in `PROJECT.md`.
+
+### Phase 12 — nfr-harden-and-simplify
+- **Description:** Apply Phase 11's findings. Tighten `terraform/bootstrap/spike_runner_policy.json` to least-privilege (add ECS + ECR + ELB + IAM plan-only permissions for v1.2; audit for wildcards). Make `create_state_backend.py` and `create_iam_user.py` idempotent. Consolidate `run_spike_plan.sh` + `run_spike_e2e.sh` into a single `scripts/run_platform.sh` with proper exit codes and error handling. Redact P1-1 (the two AWS access key IDs in `.ciagent/VERIFY.md` Phase 09 narrative). Fix any remaining stale `platform/` paths in `.ciagent/`. The v1.1 spike still runs e2e after the refactor.
+- **Status:** complete (v1.2.2)
+- **Depends on:** [11]
+- **Requirements:** REQ-30
+- **Success Criteria:**
+  - `scripts/run_platform.sh` runs the full v1.1 spike e2e and exits 0.
+  - `create_state_backend.py` / `create_iam_user.py` re-runs are idempotent (no duplicate resources; exit 0).
+  - `spike_runner_policy.json` passes a least-privilege audit (no `*` actions beyond documented exceptions).
+  - `.ciagent/VERIFY.md` Phase 09 narrative has no live AWS access key IDs.
+  - No stale `platform/` paths remain in `.ciagent/`.
+
+### Phase 13 — l1-catalog-for-ecs
+- **Description:** Author six IR-typed L1 modules for an ECS Fargate microservice: `l1-vpc` (VPC + subnets + route tables), `l1-ecs-cluster` (ECS Fargate cluster), `l1-ecs-service` (ECS service + task definition), `l1-iam-role` (task execution + task role), `l1-alb` (ALB + listener + target group), `l1-ecr` (ECR repository). Each has an `interface.json` valid against `schemas/ir.schema.json`. Register all six in `modules-ir/registry.json`. Expand the Terraform adapter `TYPE_MAP` to cover the new IR resource types. Each L1 produces a valid `terraform plan` fragment.
+- **Status:** complete (v1.2.3)
+- **Depends on:** [12]
+- **Requirements:** REQ-31
+- **Success Criteria:**
+  - All six L1s exist under `modules-ir/l1/` with `interface.json` valid against `schemas/ir.schema.json`.
+  - `modules-ir/registry.json` lists all six.
+  - The adapter `TYPE_MAP` covers all six IR resource types.
+  - Each L1 produces a valid `terraform plan` fragment.
+
+### Phase 14 — l2-microservice-and-contract-schema
+- **Description:** Author `l2-microservice` thin-composition under `modules-ir/l2/l2-microservice/` referencing the six ECS L1s (depth ≤ 5). Extend `schemas/contract.schema.json` with microservice inputs (`image: string`, `port: integer`, `env: map`, `healthcheck: object`). Verify contract→IR resolution yields a complete target stack.
+- **Status:** complete (v1.2.4)
+- **Depends on:** [13]
+- **Requirements:** REQ-32
+- **Success Criteria:**
+  - `l2-microservice` references the six ECS L1s only (depth ≤ 5).
+  - `schemas/contract.schema.json` validates a `contracts/microservice.yaml` with the new inputs.
+  - Contract→IR resolution yields a complete target stack (all six L1 instances + relationships).
+
+### Phase 15 — consumer-repo-and-terraform-apply
+- **Description:** Create a new Gitea repo `acdl-consumer-microservice` under the `continuous-intelligence` org containing a basic HTTP microservice (tiny Python/Go server returning 200), a `Dockerfile`, an ECR push step, and a `contracts/microservice.yaml` submission for `l2-microservice` (dev environment). Lift the platform from `plan` to **`apply`** for the `dev` environment (autonomous per §10, confidence ≥ 0.50, no HITL). Submit the contract → pipeline → IR → plan → apply → a real ECS Fargate service running.
+- **Status:** complete (v1.2.5, PARTIAL — terraform apply blocked by IAM P0)
+- **Depends on:** [14]
+- **Requirements:** REQ-33 (partial), REQ-34
+- **Success Criteria:**
+  - `acdl-consumer-microservice` repo exists under `continuous-intelligence`.
+  - The microservice builds into a Docker image and is pushed to ECR.
+  - `terraform apply` (dev) creates real AWS resources (VPC, ECS cluster, ECR repo, ALB, ECS service).
+  - The apply result is captured in the evidence stream.
+
+### Phase 16 — v1.2-capstone-e2e
+- **Description:** End-to-end verification: consumer commit to `acdl-consumer-microservice` triggers the pipeline → contract→IR resolution → `terraform plan` → `terraform apply` (dev) → a live ECS Fargate service serving HTTP 200 on its ALB → evidence event written to the DynamoDB outbox → the event renders on the `acdl-evidence` timeline. Verify the NFR improvements from Phase 12 hold, the setup is simpler (one `scripts/run_platform.sh`), and the README is accurate. `scripts/verify_phase16.sh` proves the full flow green.
+- **Status:** complete (v1.2.6, capstone — terraform apply blocked by IAM P0, verified up to plan)
+- **Depends on:** [15]
+- **Requirements:** REQ-35 (partial — IAM-blocked)
+- **Success Criteria:**
+  - One consumer commit produces a live ECS service serving HTTP 200.
+  - An evidence event for the apply is in the DynamoDB outbox and renders on the timeline.
+  - `scripts/verify_phase16.sh` exits 0.
+  - README accurately documents the v1.2 platform flow.
+
+After Phase 16: COMPLETE gate — review → ship `v1.3.0` → audit.
+
+---
+
+## v1.3 (Complete — module documentation + thin-composition removal)
+
+The v1.3 milestone starts with simplification: removing the unsatisfactory
+thin-composition layer and building out proper module documentation. The
+L2 composition mechanism will be redesigned in a later phase.
+
+### Phase 17 — remove-thin-composition-and-module-readmes
+- **Description:** Remove the L2 thin-composition layer completely (composition.json files, contract_resolver.py, contract schema, sample contracts) and build out proper module READMEs. Create a README template for both L1 and L2 modules, rewrite all 7 L1 module READMEs in plain language (no jargon, with Resources/Inputs/Outputs/Usage/Compliance-extension-points/Versioning sections), write 2 L2 placeholder READMEs noting the composition is under redesign, create a catalog index, and patch run_platform.sh to load a pre-existing IR instance instead of resolving a contract. Prune L2 entries from the registry.
+- **Status:** complete (v1.3.1)
+- **Depends on:** —
+- **Requirements:** REQ-36, REQ-37, REQ-38
+- **Success Criteria:**
+  - The thin-composition layer is fully removed (composition.json, contract_resolver.py, contract schema, contracts/).
+  - run_platform.sh loads a pre-existing IR instance; the downstream adapter/checkov/confidence/outbox pipeline still works.
+  - A README-TEMPLATE.md exists for both L1 and L2 modules.
+  - Every L1 module has a README.md with Resources/Inputs/Outputs/Usage/Compliance-extension-points/Versioning.
+  - Every L2 module has a placeholder README.md noting the composition is under redesign.
+  - A modules-ir/README.md catalog index exists.
+
+### Phase 18 — testing-and-cicd-pipelines
+- **Description:** Create a pytest test suite that reproduces the platform pipeline offline (adapter, confidence_signal, checkov_adapter, outbox_writer). Add an offline `--check-only` mode to `run_platform.sh` that runs the pipeline up to adapter emission without AWS/Checkov/outbox. Create identical CI/CD pipelines for both Gitea Actions (`.gitea/workflows/ci.yml`, dev environment) and GitHub Actions (`.github/workflows/ci.yml`, production) that run: lint, pytest, `run_platform.sh --check-only`. Add `pyproject.toml` + `requirements-test.txt` for dependency pinning.
+- **Status:** complete (v1.3.2)
+- **Depends on:** [17]
+- **Requirements:** REQ-39, REQ-40, REQ-41, REQ-42
+- **Success Criteria:**
+  - `pytest` runs and passes offline (no AWS, no Checkov, no DynamoDB).
+  - `run_platform.sh --check-only` runs offline and exits 0.
+  - `.gitea/workflows/ci.yml` and `.github/workflows/ci.yml` exist with identical job stages (lint, test, check-only).
+  - `pyproject.toml` + `requirements-test.txt` pin test dependencies.
+
+After Phase 18: COMPLETE gate — review → ship `v1.3.2` → audit.
+
+---
+
+## v1.4 (Active — central pipeline contract + shell reproducibility + streaming)
+
+The v1.4 milestone makes the CI/CD pipeline a declarative contract rather
+than duplicated workflow copies, enables full shell reproducibility of the
+CI pipeline, and streams terraform/checkov output so users can see what
+the platform is doing.
+
+### Phase 19 — central-pipeline-contract-and-shell-reproducibility
+- **Description:** Create a central pipeline contract (`schemas/pipeline.schema.json` JSON Schema + `pipelines/ci.yaml` YAML instance) that both `.gitea/workflows/ci.yml` (Gitea Actions, dev) and `.github/workflows/ci.yml` (GitHub Actions, production) implement. Create `scripts/run_ci.sh` that mirrors the CI pipeline locally (lint → test → check-only). Update `scripts/run_platform.sh` to stream terraform init/validate/plan output, Checkov compliance results, and PolicyCheckResult records to stdout by default (with `--quiet` for log-only mode). Add `tests/test_pipeline_contract.py` validating the contract schema, workflow conformance, and run_ci.sh. Update both workflow YAMLs with contract reference headers (staying byte-identical).
+- **Status:** complete (v1.4.1)
+- **Depends on:** [18]
+- **Requirements:** REQ-43, REQ-44, REQ-45
+- **Success Criteria:**
+  - `pipelines/ci.yaml` validates against `schemas/pipeline.schema.json`.
+  - Both `.gitea/workflows/ci.yml` and `.github/workflows/ci.yml` are byte-identical.
+  - A test parses both workflows and asserts their stages/commands match the contract.
+  - `scripts/run_ci.sh` exits 0 and outputs "CI PIPELINE OK".
+  - `scripts/run_platform.sh --check-only` streams the emitted Terraform to stdout.
+  - `scripts/run_platform.sh --check-only --quiet` suppresses the Terraform stream.
+  - `pytest` total count increases from 90 to 122 (32 new contract/streaming tests).
+
+After Phase 19: COMPLETE gate — review → ship `v1.4.1` → audit.
+
+---
+
+## v1.5 (Complete — consumer happy path + zero-trust docs + reusable deploy workflow, tag `v1.5.0`)
+
+The v1.5 milestone makes the consumer happy path self-evident, documents the
+zero-trust credential model, and provides a reusable deploy workflow so
+consumer repos never need to clone the platform repo or invoke its scripts
+locally.
+
+### Phase 20 — consumer-happy-path-and-reusable-deploy-workflow
+- **Description:** Rewrite `README.md` so the consumer model is unambiguous (this repo is the platform source; a consumer owns only `contract.yaml` + app code). Convert the platform-flow diagram to a mermaid `flowchart TD`. Remove "L3A"/"L3B" + "spike" nomenclature from README prose. Rewrite the Credentials section for zero-trust OIDC + ABAC (with a static-key override + daily rotation; consumer rotates out of band when using `.env.secrets` locally). Replace `docs/consumer-guide-static-assets.md` with a generic `docs/CONSUMER_GUIDE.md` (all L2 modules, mermaid diagrams, versioned `uses:` floating MAJOR+MINOR, consumer-scoped prerequisites, run-time platform fetch via a reusable workflow). Create byte-identical `.gitea/workflows/deploy.yml` + `.github/workflows/deploy.yml` implementing `pipelines/deploy.yaml` — a reusable workflow invoked by consumer repos via `uses: acdl/.gitea/workflows/deploy.yml@v1.4` that checks out the consumer repo + the ACDL platform repo and runs `scripts/run_platform.sh`. Update `contracts/static-assets.yaml` to `uses: acdl/pipelines/deploy.yaml@v1.4`. Extend `tests/test_pipeline_contract.py` to validate the new deploy workflows (byte-identical, schema-conformant).
+- **Status:** complete (v1.5.0)
+- **Depends on:** [19]
+- **Requirements:** REQ-46, REQ-47, REQ-48, REQ-49, REQ-50, REQ-51
+- **Success Criteria:**
+  - `README.md` states the platform-source vs consumer-repo distinction up front; platform flow is a mermaid `flowchart TD`; `grep L3B README.md` returns 0 hits; `grep -i spike README.md` returns 0 prose hits (code paths in bash blocks allowed).
+  - `docs/CONSUMER_GUIDE.md` exists; `docs/consumer-guide-static-assets.md` is deleted; `grep -R consumer-guide-static-assets` returns 0 dangling references; guide is generic (static-assets is the worked example, not the scope); diagrams are mermaid; `uses:` references use `@v1.4`.
+  - `README.md` Credentials section describes OIDC + ABAC zero-trust as the default and the static-key override + daily rotation + consumer out-of-band rotation duty for local `.env.secrets`.
+  - `.gitea/workflows/deploy.yml` and `.github/workflows/deploy.yml` exist, are byte-identical, conform to `schemas/deploy-pipeline.schema.json`, and are reusable (`on: workflow_call` with a `contract` input).
+  - `contracts/static-assets.yaml` uses `uses: acdl/pipelines/deploy.yaml@v1.4`.
+  - `tests/test_pipeline_contract.py` validates the deploy workflows (exist, byte-identical, schema-conformant); the extended test suite passes; `bash scripts/run_ci.sh` exits 0.
+
+After Phase 20: COMPLETE gate — review → ship `v1.5.0` → audit.
+
+---
+
+## v1.6 (Active — consumer-facing docs restructure + terminology normalization + environments concept)
+
+The v1.6 milestone restructures the consumer-facing documentation into a real
+GitHub Pages site, normalizes the terminology (L2 → "modules", L1 →
+"primitives", "composition" → "pattern", "forge" → "platform runners"), renames
+`acdl_platform/` to `core/` (platform/ shadows stdlib), rewrites the README (Features + Roadmap,
+restated repository roles, fixed mermaid, cleaned credentials section), removes
+all `.ciagent/` + `.gitea/` references from consumer surfaces, and introduces
+the concept of platform-managed environments with a minimal first-run onboarding
+scaffold.
+
+### Phase 21 — docs-restructure-and-terminology-normalization
+- **Description:** Rename `acdl_platform/` → `core/` (directory + all code/test/script/pipeline/workflow references; tests green — `platform/` was the original target but shadows Python's stdlib `platform` module, so `core/` was chosen). Restructure `docs/` into a Jekyll-style GitHub Pages site (`_config.yml`, `index.md`, `modules/`, `contracts/`, `pipeline/`, `environments/`, `consumer-guide.md`, consolidated `architecture.md`, `vision.md`). Rewrite `README.md`: remove `.ciagent/` + `.gitea/workflows/` rows; restate consumer repo model (app code + 1+ contracts + CI definitions `uses:`-ing the central workflow); replace Status with Features + Roadmap (planned only); fix the mermaid (visible text, add security-checks stage before policy, no tool names, add infrastructure-apply stage); remove the environments table; clean the credentials section (no go-gitea/waivers, keep daily/out-of-band rotation); forge → platform runners/platform-managed. Update `docs/consumer-guide.md`: drop L2 (→ modules), composition → pattern (prose), remove `.gitea/` (GitHub only), forge → platform runners, mermaid updated. Update `modules/` READMEs: L1 → primitives, L2 → modules, composition → pattern (prose only, files kept); bump stale `@v1` → `@v1.4`. Consolidate `docs/architecture.md` + `docs/architecture-v1.0.md` into a single current-architecture `docs/architecture.md`. Add `docs/environments/index.md` (platform-managed AWS account/network/state/runner; consumer provides none). Add a minimal onboarding scaffold: `core/environments/` dir + sample `dev.json` + README, `core/environment_check.py`, wire-in at the top of `scripts/run_platform.sh`, friendly onboarding message when no environment is defined, `tests/test_environment_check.py`. Add a roadmap entry: "composition" will later describe the thin orchestration where consumers dynamically create a module directly from the contract file (future implementation, not this phase).
+- **Status:** complete (v1.6.0)
+- **Depends on:** [20]
+- **Requirements:** REQ-52, REQ-53, REQ-54, REQ-55, REQ-56, REQ-57, REQ-58, REQ-59, REQ-60, REQ-61
+- **Success Criteria:**
+  - `grep -R "\.ciagent" docs/ README.md` returns 0 hits; `grep -R "\.gitea" docs/ README.md modules/ contracts/` returns 0 hits.
+  - `grep -R "acdl_platform" .` (excluding `.ciagent/`, `demo/`, `.git/`) returns 0 hits; the test suite passes after the rename.
+  - `docs/` has the Jekyll structure (`_config.yml`, `index.md`, `modules/`, `contracts/`, `pipeline/`, `environments/`); no `.ciagent/` links in `docs/`.
+  - Consumer-facing docs have no "L2"/"L1" labels (modules/primitives) and no "forge" term; "composition" → "pattern" in prose.
+  - README.md has Features + Roadmap (no version changelog); repository roles restated; mermaid visible + security-checks + infrastructure-apply stages + no tool names; no environments table; credentials section has no go-gitea/waivers.
+  - `docs/environments/index.md` exists; `core/environments/` + `dev.json` + `environment_check.py` + `run_platform.sh` wire-in + `tests/test_environment_check.py` exist and pass.
+  - `bash scripts/run_ci.sh` exits 0; `python3 -m pytest tests/ -v` passes (154 + new environment-check tests).
+
+After Phase 21: COMPLETE gate — review → ship `v1.6.0` → audit. **DONE.**
+
+---
+
+## v1.7 (Complete — production platform + contract ingestion + pipeline maturation, tag `v1.7.0`)
+
+The v1.7 milestone takes the platform from a documented, environments-aware
+foundation to a production-grade platform with a production-ready
+`static-assets` stack (CloudFront + WAF), a contract-ingestion Lambda + DynamoDB
+store for historical/impact analysis, a uniform error-reporting pathway via the
+same Lambda, DX-friendly deploy outputs (SSM + PR comments), three dedicated
+platform pipelines (unit+integration, primitives plan, patterns plan), a
+release job with MAJOR.MINOR/MAJOR tag maintenance, new security adapters
+(Wiz, Kyverno), real tagging-standard enforcement (closing D-043), removal of
+the legacy consumer-repos directory (removed in v1.7), and validated per-module examples
+(including a new RDS primitive demonstrating multi-engine variation).
+
+The `uses:`/`ref:` tag advances from `@v1.4` to `@v1.6`; the floating `v1.6` +
+`v1` tags are created in Phase 22 (pointing at the v1.6.0 release) so the
+reference is never broken, and the release job (Phase 26) owns ongoing updates.
+
+### Phase 22 — rename-and-production-static-assets-stack
+- **Description:** Rename `static-assets` → `static-assets` everywhere (D-048 — including `.ciagent/` historical narrative, overriding the v1.6 preservation precedent). Author two new primitives: `cloudfront` (distribution + OAC, stack types `aws:cloudfront:distribution` + `aws:cloudfront:originaccesscontrol`) and `waf` (WAFv2 web ACL, stack type `aws:wafv2:webacl`). Augment the `static-assets` module to a production-ready stack referencing s3 + cloudfront + waf (depth 1, D-049). Expand the Terraform adapter `TYPE_MAP`/`INPUT_MAP`/`OUTPUT_MAP` for the new stack types. Bump `uses:`/`ref:` from `@v1.4` to `@v1.6` (D-056/D-057); create the floating `v1.6` + `v1` git tags pointing at `v1.6.0` so the reference resolves immediately.
+- **Status:** complete (v1.7.0)
+- **Depends on:** [21]
+- **Requirements:** REQ-62, REQ-63, REQ-64
+- **Success Criteria:**
+  - `grep -R "static-assets[^s]" .` (excluding `.git/`) returns 0 hits; `modules/l2/static-assets/` is renamed to `modules/l2/static-assets/`; `contracts/static-assets.yaml` → `contracts/static-assets.yaml`; registry key renamed; all `.ciagent/` references (incl. verbatim phase descriptions, REQ-25/27/50 text, D-036) rewritten to `static-assets`.
+  - `modules/l1/cloudfront/` + `modules/l1/waf/` exist with `interface.json` valid against `schemas/stack.schema.json`; registered in `modules/registry.json`.
+  - `modules/l2/static-assets/composition.json` references s3 + cloudfront + waf (depth 1).
+  - `adapters/terraform/adapter.py` `TYPE_MAP` covers `aws:cloudfront:distribution`, `aws:cloudfront:originaccesscontrol`, `aws:wafv2:webacl`.
+  - `contracts/static-assets.yaml` + `.github/workflows/deploy.yml` + `.gitea/workflows/deploy.yml` use `@v1.6`; git tags `v1.6` + `v1` exist pointing at `v1.6.0`.
+  - `bash scripts/run_ci.sh` exits 0; `python3 -m pytest tests/ -v` passes; `bash scripts/run_platform.sh --check-only` exits 0.
+
+### Phase 23 — tagging-standards-and-security-adapters
+- **Description:** Define a required-tag set (`acdl:owner`, `acdl:contract`, `acdl:environment`, `acdl:cost-center`) in `schemas/tagging-standard.json` (D-054). Author a Checkov custom YAML rule at `adapters/terraform/policy/custom_rules/acdl_tagging.yaml` that fails when required tags are missing on taggable resources. Remove the `_emit_tag_naming_skipped()` placeholder in `checkov_adapter.py` (D-043 closure) and add `ACDL_TAG_NAMING` to `RULE_MAP` as a real rule. Author a Wiz adapter stub (`adapters/wiz/wiz_adapter.py`) translating Wiz API issues → `PolicyCheckResult` records (`engine: "wiz"`), degrading gracefully when unconfigured (D-052). Author a Kyverno K8s-native adapter (`adapters/kyverno/kyverno_adapter.py`) translating Kyverno `PolicyReport` results → `PolicyCheckResult` records (`engine: "kyverno"`), with sample policies as documentation; inactive for Terraform-only stacks, ready for the GitOps reconciler roadmap item (D-053). Add `wiz` + `kyverno` to the `schemas/policy_check_result.schema.json` engine enum.
+- **Status:** complete (v1.7.0)
+- **Depends on:** [22]
+- **Requirements:** REQ-65, REQ-66, REQ-67
+- **Success Criteria:**
+  - `adapters/terraform/policy/custom_rules/acdl-tagging.yaml` exists; Checkov loads it; `checkov_adapter.py` no longer emits a SKIPPED `ACDL_TAG_NAMING` placeholder (D-043 closed).
+  - `adapters/wiz/wiz_adapter.py` + `tests/test_wiz_adapter.py` exist; tests pass offline (not-configured graceful degradation).
+  - `adapters/kyverno/kyverno_adapter.py` + sample policies + `tests/test_kyverno_adapter.py` exist; tests pass offline.
+  - `schemas/policy_check_result.schema.json` engine enum includes `checkov | kyverno | opa | wiz`.
+  - `bash scripts/run_ci.sh` exits 0; `python3 -m pytest tests/ -v` passes.
+
+### Phase 24 — platform-lambda-and-contract-ingestion
+- **Description:** Author a platform Lambda (`core/lambda/contract_ingestor.py`) invoked via a Function URL (IAM auth) that accepts `{ consumerRepo, contractId, contract, environment, action }` and writes contracts to a DynamoDB table `acdl-contracts` (PK `consumerRepo`, SK `contractId#submittedAt`, SSE via a customer-managed CMK) (D-051). Define the Terraform (`terraform/platform/main.tf`) for the table, Lambda, Function URL, KMS key, Secrets Manager secret (`acdl/github-token`), and Lambda execution role. Define the cross-account consumer-invoke IAM policy (`terraform/platform/consumer_invoke_policy.json`) granting the consumer's deploy role `lambda:InvokeFunctionUrl` on the Lambda ARN, scoped via ABAC. The `report_error` action (Phase 25) is prepared but not yet implemented. Update `docs/environments/index.md` to document that onboarding now also grants Lambda-invoke permission.
+- **Status:** complete (v1.7.0)
+- **Depends on:** [23]
+- **Requirements:** REQ-68
+- **Success Criteria:**
+  - `core/lambda/contract_ingestor.py` exists; handler writes contracts to DynamoDB (tested offline with moto).
+  - `terraform/platform/main.tf` defines `acdl-contracts` DynamoDB table, `acdl-contract-ingestor` Lambda, Function URL (IAM auth), KMS CMK, Secrets Manager secret, Lambda execution role.
+  - `terraform/platform/consumer_invoke_policy.json` exists (cross-account invoke policy template).
+  - `tests/test_contract_ingestor.py` passes offline.
+  - `bash scripts/run_ci.sh` exits 0.
+
+### Phase 25 — deploy-pipeline-dx-outputs-and-error-reporting
+- **Description:** Add a `publish-outputs` step to `scripts/run_platform.sh` (after apply) that writes deploy outputs to SSM Parameter Store as `SecureString` (KMS-encrypted, namespaced `/acdl/{env}/{contractId}/{output_name}`) for runtime-injectable values, and a `comment-outputs` step that posts a structured GitHub PR comment / job summary with human-readable connection strings (D-050). Implement `core/output_publisher.py` (SSM write + GitHub comment formatting). Implement the Lambda `report_error` action (`core/lambda/contract_ingestor.py`) that creates a GitHub issue on the platform repo (`acdl/acdl`) via the GitHub API using a token from Secrets Manager; idempotent (comments on existing open issue rather than duplicating) (D-055). Add an `if: failure()` error-report step to `.github/workflows/deploy.yml` that invokes the Lambda via `aws lambda invoke-function-url` (SigV4-signed). Add a PR comment after every successful pipeline stage (D-055 extension) via `scripts/post_stage_comment.sh` (uses `GITHUB_TOKEN` + `gh api`; no-op when not in a PR context). Update `pipelines/deploy.yaml` + both deploy workflow YAMLs with the new stages (byte-identical).
+- **Status:** complete (v1.7.0)
+- **Depends on:** [24]
+- **Requirements:** REQ-69, REQ-70, REQ-71
+- **Success Criteria:**
+  - `scripts/run_platform.sh` has a `publish-outputs` step (SSM SecureString, tested offline with moto) + a `comment-outputs` step (GitHub PR comment formatting, tested offline).
+  - `core/lambda/contract_ingestor.py` `report_error` action creates a GitHub issue (tested with mocked API); idempotent.
+  - `.github/workflows/deploy.yml` + `.gitea/workflows/deploy.yml` (byte-identical) have an `if: failure()` error-report step invoking the Lambda + stage comments after each successful stage (PR context).
+  - `pipelines/deploy.yaml` declares the new stages.
+  - `bash scripts/run_ci.sh` exits 0; `python3 -m pytest tests/ -v` passes.
+
+### Phase 26 — platform-pipelines-and-release-automation
+- **Description:** Author three platform pipelines (D-057): (1) `.github/workflows/platform-test.yml` (PR, lint + unit + integration + schema-validation — replaces `ci.yml` for PRs); (2) `.github/workflows/primitives-plan.yml` (PR, plan-only for all L1 primitives via matrix); (3) `.github/workflows/patterns-plan.yml` (PR, plan-only for all L2 modules via matrix). Author `scripts/run_primitive_plan.sh` + `scripts/run_pattern_plan.sh` (with `--check-only` mode for CI). Author the release job (`.github/workflows/release.yml`) that runs on merge to `main`, computes the next semver (PATCH per phase, MINOR on milestone COMPLETE), creates the MAJOR.MINOR.PATCH tag, force-moves the MAJOR.MINOR + MAJOR floating tags, creates a GitHub release with an auto-generated body. This is the mechanism that lets consumers on `@v1` or `@v1.7` receive updates.
+- **Status:** complete (v1.7.0)
+- **Depends on:** [25]
+- **Requirements:** REQ-72, REQ-73
+- **Success Criteria:**
+  - `.github/workflows/platform-test.yml` exists, runs lint + unit + integration + schema-validation on PR.
+  - `.github/workflows/primitives-plan.yml` + `.github/workflows/patterns-plan.yml` exist, run plan-only (matrix) on PR.
+  - `.github/workflows/release.yml` exists, computes next semver, creates + updates MAJOR.MINOR.PATCH / MAJOR.MINOR / MAJOR tags on merge.
+  - `scripts/run_primitive_plan.sh` + `scripts/run_pattern_plan.sh` exit 0 in `--check-only` mode.
+  - `bash scripts/run_ci.sh` exits 0; `python3 -m pytest tests/ -v` passes.
+
+### Phase 27 — remove-legacy-consumer-repos-and-module-documentation-examples
+- **Description:** Delete the legacy consumer-repos directory entirely (a v1.2 artifact removed in v1.7; references in `.ciagent/` historical narrative are rewritten per D-048). Author a new RDS primitive (`modules/l1/rds/`) with an `engine` input (enum: postgres, mysql, etc.) demonstrating multi-engine variation (D-059). Expand the adapter `TYPE_MAP` for `aws:rds:instance` → `aws_db_instance`. For **each** module (primitives + patterns), add a `modules/<name>/examples/` directory with `simple.yaml` + `complex.yaml` (+ variation files) validated against `schemas/contract.schema.json` in the platform-test pipeline (Phase 26 schema-validation stage) (D-058). Each module's `README.md` `## Examples` section references + excerpts the validated files. Update `docs/modules/index.md` + `docs/consumer-guide.md` + `docs/contracts/index.md` with the new module names + examples.
+- **Status:** complete (v1.7.0)
+- **Depends on:** [26]
+- **Requirements:** REQ-74, REQ-75
+- **Success Criteria:**
+  - The legacy consumer-repos directory does not exist; a recursive grep for the legacy directory name (excluding `.git/`) returns 0 hits.
+  - `modules/l1/rds/` exists with `interface.json` (`engine` enum) + `examples/`; registered; adapter emits `aws_db_instance`.
+  - Every module README has a `## Examples` section; `modules/<name>/examples/{simple,complex}.yaml` exist and validate against `schemas/contract.schema.json`.
+  - `docs/modules/index.md` links to all module READMEs (including cloudfront, waf, rds).
+  - `bash scripts/run_ci.sh` exits 0; `python3 -m pytest tests/ -v` passes.
+
+After Phase 27: COMPLETE gate — review → ship `v1.7.0` → audit. **DONE.**
+
+---
+
+## v1.8 (Complete — P1 remediation + uptime + engineering standards + encryption/deletion-protection by default + decommission + docs)
+
+The v1.8 milestone clears all pending P1 issues from v1.5–v1.7 verify
+reviews AND delivers three user-directed tracks: encryption + deletion
+protection by default (with a decommission alias), uptime monitoring
+(uptime-kuma primitive deployed by default after L2 modules), and
+engineering standards + path documentation. Ship tag at milestone
+COMPLETE: **`v1.8.0`** (feature milestone, next minor per run.md — v1.7
+shipped `v1.7.0`). Phase patches `v1.7.1`..`v1.7.9`.
+
+### Phase 28 — adapter-waf-and-resolver-outputs
+- **Description:** Fix WAF HCL emission: custom `rules` input emits nested `rules { ... }` blocks (not `rules = [...]` attribute syntax — P1-4). Honor `default_action` input (allow/block) instead of hardcoding `allow {}` (P1-5). Implement L2 composition `outputs[]` processing in `resolve_l2()` — build `stack.outputs` dict + adapter emits `output` blocks (P1-7). Tests for all three fixes.
+- **Status:** complete (v1.8.0)
+- **Depends on:** —
+- **Requirements:** REQ-76, REQ-77
+- **Success Criteria:**
+  - WAF with custom rules emits nested `rules {` blocks, not `rules = [`.
+  - WAF with `default_action: block` emits `block {}`; default (absent) emits `allow {}`.
+  - L2 resolution of `static-assets` yields `stack.outputs.distribution_domain_name`, `bucket_arn`, `web_acl_arn`.
+  - Adapter emits `output "distribution_domain_name" { value = ... }` blocks.
+  - `pytest` passes; `run_platform.sh --check-only` exits 0.
+
+### Phase 29 — ssm-kms-and-invoke-policy
+- **Description:** SSM publisher fails loud (`RuntimeError`) when `ACDL_KMS_KEY_ID` unset; `ACDL_ALLOW_DEFAULT_KMS=1` escape hatch for local testing (P1-3). Convert `consumer_invoke_policy.json` to a Terraform-rendered template using `data.aws_caller_identity` + `templatestring` — no `000000000000` placeholder (P1-6). Tests for both.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [28]
+- **Requirements:** REQ-78, REQ-79
+- **Success Criteria:**
+  - SSM publisher raises `RuntimeError` when `ACDL_KMS_KEY_ID` unset; succeeds with `ACDL_ALLOW_DEFAULT_KMS=1`.
+  - Rendered invoke policy contains the caller's live account ID, not `000000000000`.
+  - `pytest` passes; `run_ci.sh` exits 0.
+
+### Phase 30 — run-platform-isolation-and-api-portability
+- **Description:** `run_platform.sh` emits adapter output to `$WORK/tf` (per-run temp dir), not `terraform/spike/`; remove committed `terraform/spike/*.tf` (P1-8). `contract_ingestor.py` reads `GITHUB_API_BASE` env for forge-agnostic API URLs (GitHub + Gitea); `_forge_type()` branches search URL (P1-9). Deploy workflow `configure-aws-credentials` step restructured as single conditional step: OIDC when no static key, `access-key`/`secret-key` inputs when static key present (S1). Both deploy workflows remain byte-identical.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [29]
+- **Requirements:** REQ-80, REQ-81, REQ-82
+- **Success Criteria:**
+  - `run_platform.sh --check-only` writes to a temp dir; no `terraform/spike/*.tf` committed.
+  - `contract_ingestor.py` uses `GITHUB_API_BASE`; Gitea base URL produces correct API paths.
+  - Deploy workflow static-key override wired to `configure-aws-credentials` inputs.
+  - Both deploy workflows byte-identical; `pytest` + `run_ci.sh` green.
+
+### Phase 31 — encryption-by-default-and-per-stack-cmk
+- **Description:** Create `kms-key` L1 primitive (type `aws:kms:key`, inputs: description/region/deletion_window_days, outputs: kms_key_arn/kms_key_id, NFRs: enable_rotation default true, deletion_protection default true). Adapter emits `aws_kms_key` + `aws_kms_alias` + `enable_key_rotation = true`. Add `encryption_enabled` NFR (default true) + `kms_key_arn` input to all primitives. L2 modules wire a `kms-key` child + connect its output to all children. Managed KMS fallback when no CMK provided (with stderr warning).
+- **Status:** complete (v1.8.0)
+- **Depends on:** [30]
+- **Requirements:** REQ-83, REQ-84, REQ-85
+- **Success Criteria:**
+  - Every primitive has `encryption_enabled` NFR (default true) + optional `kms_key_arn` input.
+  - L2 resolution wires per-stack CMK to all children.
+  - Adapter emits encryption blocks (SSE, storage_encrypted, encryption_configuration) referencing the CMK.
+  - `enable_key_rotation = true` on the CMK; no shared keys across stacks.
+  - `pytest` + `run_ci.sh` green.
+
+### Phase 32 — deletion-protection-by-default-and-l2-feature-flag
+- **Description:** Add `deletion_protection` NFR (boolean, default true) to every L1 primitive. Adapter emits `lifecycle { prevent_destroy = true }` when true; omits it when false. L2 modules expose `features.deletion_protection` flag (default true); resolver propagates to each child's NFR. Consumers can set `inputs.deletion_protection: false` in contract. Update contract schema.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [31]
+- **Requirements:** REQ-86, REQ-87
+- **Success Criteria:**
+  - Every primitive has `deletion_protection` NFR defaulting to true.
+  - Adapter emits `prevent_destroy = true` when true; omits when false.
+  - L2 feature flag propagates to all children.
+  - `pytest` + `run_ci.sh` green.
+
+### Phase 33 — uptime-kuma-primitive
+- **Description:** Create `uptime` L1 primitive (ECS Fargate running `louislam/uptime-kuma:1`). Inputs: container_image, region, monitored_endpoints (array of {name, url, type, interval, timeout}), static_checks, alert_channels ({teams_webhook, email_addresses, sms_numbers, github_issue_repo}), feature_flag_enabled (default true), cpu, memory. Outputs: uptime_url, service_arn, task_definition_arn. NFRs: deletion_protection, encryption_enabled. Adapter emits ECS service + ALB + log group; no resources when feature_flag_enabled=false. Register in registry. Add `deploy-uptime` pipeline stage (separate state, after publish-outputs) to `pipelines/deploy.yaml` + both deploy workflows. `run_platform.sh` constructs synthetic uptime contract from L2 outputs + runs second terraform apply. Uptime URL published via PR comment. Feature flag from `inputs.uptime_enabled` (default true).
+- **Status:** complete (v1.8.0)
+- **Depends on:** [32]
+- **Requirements:** REQ-88, REQ-89, REQ-90, REQ-91
+- **Success Criteria:**
+  - Uptime primitive exists with feature flag, monitored endpoints, alert channels.
+  - Deployed by default after L2 module (separate state); endpoints passed from L2 outputs.
+  - Uptime URL published via PR comment.
+  - Feature flag disables deployment (no resources emitted).
+  - `deploy-uptime` stage in deploy contract + byte-identical workflows.
+  - `pytest` + `run_ci.sh` green.
+
+### Phase 34 — decommission-alias-and-cmdb-validation
+- **Description:** Add `mode: decommission` to deploy pipeline. Stages: validate-change-request (Lambda `validate_change_request` action queries DynamoDB `acdl-change-requests` table, asserts status=approved) → disable-deletion-protection (resolve contract with deletion_protection=false, terraform plan/apply, HITL SRE gate) → zero-counts (resolver `decommission_transform` zeroes all counts, terraform plan/apply, second HITL SRE gate) → confirm-decommission. Add `acdl-change-requests` DynamoDB table to terraform/platform/main.tf. Add `validate_change_request` to contract_ingestor.py. Document in `docs/CONSUMER_GUIDE.md`.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [33]
+- **Requirements:** REQ-92, REQ-93, REQ-94
+- **Success Criteria:**
+  - Decommission mode works via existing deploy pipeline with 2-step HITL SRE gates.
+  - CR ID validated against DynamoDB CMDB (status must be approved).
+  - `decommission_transform` zeroes all counts.
+  - Documented in consumer guide.
+  - `pytest` + `run_ci.sh` green.
+
+### Phase 35 — module-engineering-standards
+- **Description:** Scan all current modules to generate `modules/STANDARDS.md` — comprehensive L1+L2 authoring + code review standards: required files, interface schema, input/output/NFR conventions, encryption + deletion protection as mandatory NFRs, naming, multi-resource pattern, adapter extension pattern (TYPE_MAP + INPUT_MAP + OUTPUT_MAP + specialized branches), code review checklist. Fix `modules/README.md` catalog index (add rds + uptime + kms-key). Update `modules/README-TEMPLATE.md` with `## NFRs` section. Add `tests/test_module_standards.py` for automated enforcement.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [34]
+- **Requirements:** REQ-95, REQ-96
+- **Success Criteria:**
+  - `modules/STANDARDS.md` exists with L1+L2 authoring + review standards.
+  - Catalog index includes all primitives; template has NFRs section.
+  - Automated standards test passes for all modules.
+  - `pytest` + `run_ci.sh` green.
+
+### Phase 36 — schemas-adapters-pipelines-readmes
+- **Description:** Author `schemas/README.md` (how to write schemas, wire into platform, test in CI, dependencies, existing catalog), `pipelines/README.md` (how to write pipeline contracts, wire into workflows, test, dependencies, catalog), `adapters/README.md` (how to write adapters, wire into platform, test, dependencies, catalog). Add `tests/test_docs_coverage.py` to validate presence + required sections.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [35]
+- **Requirements:** REQ-97, REQ-98, REQ-99
+- **Success Criteria:**
+  - All 3 READMEs exist with comprehensive documentation.
+  - CI validates their presence.
+  - `pytest` + `run_ci.sh` green.
+
+### Phase 37 — verify
+- **Description:** 4-layer verification (structural, behavioral, security, quality) of all v1.8 phases. Re-verify each P1 (P1-3..P1-9 + S1) is resolved. Verify all new features (encryption, deletion protection, uptime, decommission, standards, docs) have dedicated tests.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [36]
+- **Requirements:** —
+- **Success Criteria:**
+  - All 4 layers pass; each P1 fix + each new feature has a dedicated test.
+  - `pytest` passes (~358 tests); `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0.
+
+### Phase 38 — review-audit-complete
+- **Description:** Multi-persona code review across the full v1.8 diff. Audit (reconstruction, file discipline, branch hygiene, commit discipline). Complete: update REQUIREMENTS.md (REQ-76..99), ROADMAP.md (v1.8 complete), PROJECT.md. Tag `v1.8.0`. Update floating `v1.8` + `v1` tags. Bump `uses:`/`ref:` from `@v1.6` to `@v1.8`.
+- **Status:** complete (v1.8.0)
+- **Depends on:** [37]
+- **Requirements:** —
+- **Success Criteria:**
+  - Review: 0 new P0/P1; all P1-3..P1-9 + S1 resolved; 3 new requirements delivered.
+  - Audit: clean; 0 outstanding issues.
+  - Tag `v1.8.0` created; floating tags updated.
+
+After Phase 38: COMPLETE gate — review → ship `v1.8.0` → audit.
+
+---
+
+## v1.9 (complete — design doc refresh + contract interpolation + per-env CI jobs + stub implementation + P1-1 remediation, tag `v1.9.0`)
+
+The v1.9 milestone closes four gaps left by v1.8 (user-directed,
+2026-07-23): stale design docs, no contract interpolation, promotion
+requires editing the `environment` field, and unimplemented stubs. It
+also closes P1-1 (adapter hardcoded defaults, deferred from v1.2).
+
+### Phase 39 — design-doc-refresh-and-p1-1-parameterization
+- **Description:** Refresh `core/hitl_matrix_design.md` (no stale "dev-only spike"/"v1.2 wires the gates" framing; v1.9 wiring section; 8-concern matrix marked implemented offline-testable subset) + `core/audit_ledger_design.md` (outbox marked shipped+production since v1.8; S3 Object Lock + JWS + worker + DLQ + checkpoints deferred D-083). P1-1: move adapter ECS/ALB/VPC hardcoded defaults (`desired_count`, `launch_type`, `family`, `target_type`, `load_balancer_type`, `Name` tags) into L1 `interface.json` inputs with defaults; the adapter reads from inputs; the resolver routes wires to the sub-resource that declares the input.
+- **Status:** complete (v1.8.1)
+- **Depends on:** —
+- **Requirements:** REQ-100, REQ-101, REQ-102
+- **Success Criteria:**
+  - Both design docs refreshed; no stale framing; `test_design_docs_current.py` passes.
+  - Adapter has no hardcoded ECS/ALB/VPC defaults; overrides flow through; `test_p1_1_adapter_parameterization.py` passes.
+  - v1.1 S3 regression passes; `pytest` 371 (was 350, +21); `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0.
+
+### Phase 40 — contract-interpolation
+- **Description:** `${env.<field>}` + `${contract.<field>}` resolver expansion from environment onboarding JSON (D-081). Environment JSON schema (`schemas/environment.schema.json`) + qa/prod/dr placeholder bindings. `core/environment_check.py` gains `load()`. Sample contracts use naming patterns that include region, account id, environment (e.g. `acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}`). Expansion is recursive (D-087), post-schema-validation, pre-IR-resolution; unknown tokens raise `ValueError`. `resolve()` accepts `environment_override` (D-088).
+- **Status:** complete (v1.8.2)
+- **Depends on:** [39]
+- **Requirements:** REQ-103, REQ-104
+- **Success Criteria:**
+  - `schemas/environment.schema.json` exists; 4 env files validate; `load()` works.
+  - `_expand_vars` in resolver; unknown tokens raise; recursive over dicts/lists/strings.
+  - Sample contracts use `${env.*}` + `${contract.*}` naming patterns; resolve to concrete values.
+  - `tests/test_environment_schema.py` + `tests/test_interpolation.py` + `tests/test_sample_contracts_interpolate.py` pass.
+  - `pytest` 406 (was 371, +35); `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0.
+### Phase 41 — per-environment-ci-jobs
+- **Description:** Per-env contract files (static-assets + microservice × dev/qa/prod/dr, REQ-105) using interpolation. Deploy workflow (`.github` + `.gitea`, byte-identical) declares an `environment` `workflow_call` input (REQ-106); `run_platform.sh --environment <name>` overrides the contract's environment at load time (D-088, before schema validation + interpolation). `resolve()` accepts `environment_override`. Consumer guide documents the per-env caller-workflow pattern (4 jobs, one per environment) + HITL gate structure (approve_qa/approve_prod/approve_dr, D-042) + interpolation reference table. Promotion = running the matching job; no environment field editing.
+- **Status:** complete (v1.8.3)
+- **Depends on:** [40]
+- **Requirements:** REQ-105, REQ-106
+- **Success Criteria:**
+  - 8 per-env contract files exist + validate + resolve to correct env.
+  - Deploy workflow has `environment` input (byte-identical Gitea + GitHub); `run_platform.sh --environment` overrides; resolver supports `environment_override`.
+  - Consumer guide documents per-env caller workflows + promotion-without-editing + HITL gates + interpolation reference.
+  - `tests/test_per_env_contracts.py` + `tests/test_deploy_workflow_env_input.py` + `tests/test_consumer_guide_per_env_section.py` pass.
+  - `pytest` 446 (was 406, +40); `run_ci.sh` exits 0; both deploy workflows byte-identical.
+
+### Phase 42 — stub-implementation
+- **Description:** `route_halt_artifact` real (SNS publish + outbox fallback, REQ-107) + SNS topic `acdl-sod-halt` in `terraform/platform/main.tf`. HITL attestation gates (`core/hitl_gates.py`, REQ-108) — records approver to outbox, runs SoD on prod, invokes the attestation matrix; `run_platform.sh` calls `attest` before apply for qa/prod/dr (dev skips). 8-concern attestation matrix (`core/attestation_matrix.py`, REQ-109, D-084) — offline-testable concerns run for real; operator-supplied concerns accept signed evidence artifacts validated for freshness + schema; signature skip when `ACDL_ATTESTATION_SIGNING_KEY_ID` unset (D-089). Wiz real API client (`WizClient`, REQ-110) — GraphQL queries + pagination + graceful degrade. Kyverno translator fleshed out (REQ-111) — full PolicyReport mapping + skip-with-reason + inactive-for-TF guard + `--kube-version` stub.
+- **Status:** complete (v1.8.4)
+- **Depends on:** [41]
+- **Requirements:** REQ-107, REQ-108, REQ-109, REQ-110, REQ-111
+- **Success Criteria:**
+  - `route_halt_artifact` publishes to SNS when ARN set; outbox fallback when unset; SNS topic in Terraform.
+  - `hitl_gates.attest` records approver; SoD blocks on identity equality; dev skips; `run_platform.sh` has the HITL step.
+  - `attestation_matrix.check` runs 8 concerns; offline concerns pass; operator-supplied missing → block for prod; expired → block; signature skip when key unset.
+  - Wiz `WizClient` real client + pagination + graceful degrade; `fetch_and_adapt` translates.
+  - Kyverno full mapping (pass/fail/skip/warn + severity + skip-with-reason + resource construction); inactive guard preserved; `--kube-version` parsed.
+  - `tests/test_route_halt_artifact.py` + `test_hitl_gates.py` + `test_attestation_matrix.py` + `test_wiz_adapter_real_client.py` + expanded `test_kyverno_adapter.py` pass.
+  - `pytest` 493 (was 446, +47); `run_ci.sh` exits 0; `run_platform.sh --check-only` exits 0.
+
+### Phase 43 — verify-review-audit-complete
+- **Description:** 4-layer verify (structural, behavioral, security, quality) of all v1.9 phases. Multi-persona review (0 P0, 0 P1). Audit (reconstruction, file discipline, branch hygiene, commit discipline — all clean). REVIEW.md reconstructed (D-086). Complete: update REQUIREMENTS.md (REQ-100..111), ROADMAP.md, PROJECT.md. Tag `v1.9.0`; update floating `v1.9` + `v1` tags. Bump `uses:`/`ref:` from `@v1.6` → `@v1.9`.
+- **Status:** complete (v1.9.0)
+- **Depends on:** [42]
+- **Requirements:** —
+- **Success Criteria:**
+  - 4-layer verify PASS; 493 tests; `run_ci.sh` + `run_platform.sh --check-only` green.
+  - Review: 0 P0, 0 P1; REVIEW.md reconstructed with v1.9 content (D-086).
+  - Audit: clean; all 12 v1.9 commits have `---ci---` blocks.
+  - Tag `v1.9.0` created; floating tags updated; `uses:` bumped to `@v1.9`.
+
+After Phase 43: COMPLETE gate — review → ship `v1.9.0` → audit. **DONE.**

.ciagent/VERIFY.md

@@ -0,0 +1,40 @@
+# Phase 39-43 — Verify (v1.9)
+
+## Structural
+All 26 new files present (environment.schema.json, 4 env files, 8 per-env
+contracts, hitl_gates.py, attestation_matrix.py, 10 new test files,
+refreshed design docs). SNS topic in terraform/platform/main.tf. **PASS.**
+
+## Behavioral
+- `pytest`: 493 tests, all passing (was 350 at v1.8 → 493 at v1.9, +143 new).
+- `run_ci.sh`: exits 0 with "CI PIPELINE OK".
+- `run_platform.sh --check-only`: exits 0 with "PLATFORM CHECK OK".
+- `run_platform.sh --check-only --environment qa`: exits 0; bucket name reflects qa env.
+**PASS.**
+
+## Security
+- No hardcoded adapter ECS/ALB/VPC defaults (P1-1 closed; defaults in interface.json).
+- HITL gates block on SoD violation (approver_qa == approver_prod).
+- Attestation matrix fails loud on missing/expired evidence for prod/dr.
+- Signature verification required when ACDL_ATTESTATION_SIGNING_KEY_ID set; skipped + logged when unset (D-089).
+- Wiz degrades gracefully when unconfigured (WIZ_NOT_CONFIGURED SKIPPED record).
+- SNS topic KMS-encrypted; outbox fallback for the halt artifact.
+- Deploy workflows byte-identical (Gitea + GitHub).
+**PASS.**
+
+## Quality
+Each new feature has dedicated tests:
+- Design docs: test_design_docs_current.py (no stale framing; deferred D-083 labeled).
+- P1-1: test_p1_1_adapter_parameterization.py (override + default + v1.1 S3 regression).
+- Interpolation: test_interpolation.py + test_sample_contracts_interpolate.py + test_environment_schema.py.
+- Per-env jobs: test_per_env_contracts.py + test_deploy_workflow_env_input.py + test_consumer_guide_per_env_section.py.
+- SoD: test_route_halt_artifact.py (SNS + outbox fallback + SNS failure fallback).
+- HITL gates: test_hitl_gates.py (dev skips; qa/prod/dr record approver; SoD blocks; matrix invoked).
+- Attestation matrix: test_attestation_matrix.py (offline concerns; operator-supplied; freshness; signature skip).
+- Wiz: test_wiz_adapter_real_client.py (real client + pagination + graceful degrade).
+- Kyverno: expanded test_kyverno_adapter.py (pass/fail/skip/warn + severity + inactive guard + kube-version).
+**PASS.**
+
+## Verdict
+
+**VERIFY PASS** — all four layers pass. 493 offline tests, no AWS required for CI.

.ciagent/config.json

@@ -4,8 +4,8 @@
     {
       "slug": "acdl",
       "name": "Agentic Cloud Delivery Platform",
-      "milestone": "v1.1",
-      "status": "specify"
+      "milestone": "v1.9",
+      "status": "complete"
     }
   ],
   "active_project": "acdl",

.gitea/workflows/ci.yml

@@ -0,0 +1,77 @@
+# ACDL CI Pipeline — Gitea Actions (dev environment)
+#
+# This workflow implements the central pipeline contract:
+#   pipelines/ci.yaml (validated against schemas/pipeline.schema.json)
+#
+# The same contract is implemented by .github/workflows/ci.yml (GitHub
+# Actions, production). Both files must be byte-identical — the only
+# declared difference is the forge/runtime, not the stages or commands.
+#
+# Shell reproducibility: scripts/run_ci.sh runs the same 3 stages locally.
+#
+# Stages (from the contract):
+#   1. lint       — py_compile all Python files
+#   2. test       — pytest test suite (offline, no AWS)
+#   3. check-only — run_platform.sh --check-only (offline, no AWS)
+name: acdl-ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Compile all Python files
+        run: |
+          python3 -m py_compile \
+            core/confidence_signal.py \
+            core/outbox_writer.py \
+            core/output_publisher.py \
+            core/contract_resolver.py \
+            core/lambda/contract_ingestor.py \
+            adapters/terraform/adapter.py \
+            adapters/terraform/policy/checkov_adapter.py \
+            scripts/push_consumer_image.py
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install test dependencies
+        run: pip install -r requirements-test.txt
+
+      - name: Run pytest
+        run: python3 -m pytest tests/ -v --tb=short
+
+  check-only:
+    name: Platform check-only (offline)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install runtime dependencies
+        run: pip install jsonschema pyyaml boto3
+
+      - name: Run platform check-only
+        run: bash scripts/run_platform.sh --check-only

.gitea/workflows/deploy.yml

@@ -0,0 +1,165 @@
+# ACDL Reusable Deploy Workflow — Gitea Actions (dev environment)
+#
+# This reusable workflow implements the central deployment pipeline contract:
+#   pipelines/deploy.yaml (validated against schemas/deploy-pipeline.schema.json)
+#
+# The same contract is implemented by .github/workflows/deploy.yml (GitHub
+# Actions, production). Both files must be byte-identical — the only
+# declared difference is the forge/runtime, not the stages or commands.
+#
+# Consumer repos invoke this workflow via a versioned tag (floating MAJOR + MINOR):
+#   uses: acdl/.gitea/workflows/deploy.yml@v1.9   (Gitea)
+#   uses: acdl/.github/workflows/deploy.yml@v1.9  (GitHub)
+#
+# Unversioned references (@main, bare) are discouraged — the consumer's setup
+# must be immutable + resilient. The versioned tag is the only immutability
+# lever (version constraints cannot be expressed inside the contract).
+#
+# What this workflow does:
+#   1. Checks out the consumer repo (the repo that invoked the workflow).
+#   2. Checks out the ACDL platform repo into the workspace (platform/).
+#      This is the run-time fetch — consumers never clone the platform repo.
+#   3. Installs runtime deps: Python 3.12, Terraform 1.9.*, Checkov.
+#   4. Configures AWS auth (OIDC default; static-key override via secrets).
+#   5. Runs scripts/run_platform.sh against the consumer's contract path.
+#   6. Uploads artifacts (emitted Terraform, Checkov JSON, confidence JSON,
+#      platform log) for auditability.
+#
+# Inputs:
+#   contract  — path to the consumer's contract YAML (default .acdl/contract.yaml)
+#   mode      — full | plan-only | check-only (default full; dev = full apply,
+#               higher environments hold for HITL — the calling repo or the
+#               forge environment gate enforces that)
+#
+# Auth (zero-trust default — see README.md#credentials--zero-trust):
+#   OIDC federation is the default. permissions: id-token: write lets the
+#   forge mint a short-lived STS token. The role-to-assume is scoped by the
+#   consumer's repository identity (ABAC) — the workflow assumes the role
+#   that matches repo:org/consumer-repo:ref:refs/heads/main, and the session
+#   policy restricts view/update to resources tagged acdl:owner=<consumer-repo>.
+#
+#   Override (where OIDC is unavailable, e.g. Gitea pending
+#   go-gitea/gitea#36988): set ACDL_AWS_ACCESS_KEY_ID + ACDL_AWS_SECRET_ACCESS_KEY
+#   as repository secrets. The platform-managed scheduled pipeline rotates
+#   the key on a daily cadence. When .env.secrets is used locally instead,
+#   rotating the key out of band is the consumer's responsibility.
+name: acdl-deploy
+
+on:
+  workflow_call:
+    inputs:
+      contract:
+        description: Path to the consumer contract YAML (in the consumer repo)
+        type: string
+        default: .acdl/contract.yaml
+      mode:
+        description: Pipeline mode — full (apply), plan-only, check-only, or decommission
+        type: string
+        default: full
+      changeRequestId:
+        description: Change request ID (required for decommission mode — validated against CMDB)
+        type: string
+        default: ""
+      environment:
+        description: Target environment override (dev/qa/prod/dr); when empty, the contract's environment field is used
+        type: string
+        default: ""
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out consumer repo
+        uses: actions/checkout@v4
+
+      - name: Check out ACDL platform repo
+        uses: actions/checkout@v4
+        with:
+          repository: acdl/acdl
+          path: platform
+          ref: v1.9
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install runtime dependencies
+        run: |
+          pip install --break-system-packages jsonschema pyyaml boto3
+          pip install --break-system-packages "checkov>=3.2,<4"
+
+      - name: Install Terraform 1.9.*
+        run: |
+          wget -qO- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp.gpg
+          echo "deb [signed-by=/usr/share/keyrings/hashicorp.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
+          sudo apt-get update && sudo apt-get install -y terraform=1.9.*
+
+      - name: Configure AWS credentials (OIDC default + static-key override)
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          role-to-assume: ${{ secrets.ACDL_AWS_ACCESS_KEY_ID == '' && format('arn:aws:iam::{0}:role/acdl-deploy-{1}', secrets.ACDL_AWS_ACCOUNT_ID, github.repository_id) || '' }}
+          aws-region: us-east-1
+          access-key-id: ${{ secrets.ACDL_AWS_ACCESS_KEY_ID }}
+          secret-access-key: ${{ secrets.ACDL_AWS_SECRET_ACCESS_KEY }}
+
+      - name: Run the platform pipeline
+        working-directory: ${{ github.workspace }}
+        run: |
+          MODE_FLAG=""
+          case "${{ inputs.mode }}" in
+            full) MODE_FLAG="" ;;
+            plan-only) MODE_FLAG="--plan-only" ;;
+            check-only) MODE_FLAG="--check-only" ;;
+            decommission)
+              if [ -z "${{ inputs.changeRequestId }}" ]; then
+                echo "FAIL: changeRequestId is required for decommission mode"
+                exit 1
+              fi
+              MODE_FLAG="--decommission ${{ inputs.changeRequestId }}"
+              ;;
+            *) echo "Unknown mode: ${{ inputs.mode }}"; exit 1 ;;
+          esac
+          ENV_FLAG=""
+          if [ -n "${{ inputs.environment }}" ]; then
+            ENV_FLAG="--environment ${{ inputs.environment }}"
+          fi
+          bash platform/scripts/run_platform.sh $MODE_FLAG $ENV_FLAG "${{ inputs.contract }}"
+
+      - name: Post stage summary comment to PR
+        if: success() && github.event_name == 'pull_request'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GITHUB_REF: ${{ github.ref }}
+        run: |
+          bash platform/scripts/post_stage_comment.sh deploy pass '{"mode":"${{ inputs.mode }}","runId":"${{ github.run_id }}"}'
+
+      - name: Report error to platform team (on failure)
+        if: failure()
+        env:
+          AWS_DEFAULT_REGION: us-east-1
+        run: |
+          aws lambda invoke-function-url \
+            --function-url "${{ secrets.ACDL_LAMBDA_URL }}" \
+            --cli-binary-format raw-in-base64-out \
+            --payload "$(python3 -c "import json,os; print(json.dumps({'action':'report_error','consumerRepo':os.environ.get('GITHUB_REPOSITORY',''),'contractId':'${{ github.run_id }}','error':'Deploy pipeline failed. See run logs.','runUrl':'${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}','environment':'dev'}))")" \
+            /dev/null || true
+
+      - name: Upload emitted Terraform
+        uses: actions/upload-artifact@v4
+        with:
+          name: acdl-terraform
+          path: /tmp/acdl_platform_run_v18/tf/*.tf
+          if-no-files-found: warn
+
+      - name: Upload platform log
+        uses: actions/upload-artifact@v4
+        with:
+          name: acdl-platform-log
+          path: platform/logs/
+          if-no-files-found: warn

.github/workflows/ci.yml

@@ -0,0 +1,77 @@
+# ACDL CI Pipeline — Gitea Actions (dev environment)
+#
+# This workflow implements the central pipeline contract:
+#   pipelines/ci.yaml (validated against schemas/pipeline.schema.json)
+#
+# The same contract is implemented by .github/workflows/ci.yml (GitHub
+# Actions, production). Both files must be byte-identical — the only
+# declared difference is the forge/runtime, not the stages or commands.
+#
+# Shell reproducibility: scripts/run_ci.sh runs the same 3 stages locally.
+#
+# Stages (from the contract):
+#   1. lint       — py_compile all Python files
+#   2. test       — pytest test suite (offline, no AWS)
+#   3. check-only — run_platform.sh --check-only (offline, no AWS)
+name: acdl-ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Compile all Python files
+        run: |
+          python3 -m py_compile \
+            core/confidence_signal.py \
+            core/outbox_writer.py \
+            core/output_publisher.py \
+            core/contract_resolver.py \
+            core/lambda/contract_ingestor.py \
+            adapters/terraform/adapter.py \
+            adapters/terraform/policy/checkov_adapter.py \
+            scripts/push_consumer_image.py
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install test dependencies
+        run: pip install -r requirements-test.txt
+
+      - name: Run pytest
+        run: python3 -m pytest tests/ -v --tb=short
+
+  check-only:
+    name: Platform check-only (offline)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install runtime dependencies
+        run: pip install jsonschema pyyaml boto3
+
+      - name: Run platform check-only
+        run: bash scripts/run_platform.sh --check-only

.github/workflows/deploy.yml

@@ -0,0 +1,165 @@
+# ACDL Reusable Deploy Workflow — Gitea Actions (dev environment)
+#
+# This reusable workflow implements the central deployment pipeline contract:
+#   pipelines/deploy.yaml (validated against schemas/deploy-pipeline.schema.json)
+#
+# The same contract is implemented by .github/workflows/deploy.yml (GitHub
+# Actions, production). Both files must be byte-identical — the only
+# declared difference is the forge/runtime, not the stages or commands.
+#
+# Consumer repos invoke this workflow via a versioned tag (floating MAJOR + MINOR):
+#   uses: acdl/.gitea/workflows/deploy.yml@v1.9   (Gitea)
+#   uses: acdl/.github/workflows/deploy.yml@v1.9  (GitHub)
+#
+# Unversioned references (@main, bare) are discouraged — the consumer's setup
+# must be immutable + resilient. The versioned tag is the only immutability
+# lever (version constraints cannot be expressed inside the contract).
+#
+# What this workflow does:
+#   1. Checks out the consumer repo (the repo that invoked the workflow).
+#   2. Checks out the ACDL platform repo into the workspace (platform/).
+#      This is the run-time fetch — consumers never clone the platform repo.
+#   3. Installs runtime deps: Python 3.12, Terraform 1.9.*, Checkov.
+#   4. Configures AWS auth (OIDC default; static-key override via secrets).
+#   5. Runs scripts/run_platform.sh against the consumer's contract path.
+#   6. Uploads artifacts (emitted Terraform, Checkov JSON, confidence JSON,
+#      platform log) for auditability.
+#
+# Inputs:
+#   contract  — path to the consumer's contract YAML (default .acdl/contract.yaml)
+#   mode      — full | plan-only | check-only (default full; dev = full apply,
+#               higher environments hold for HITL — the calling repo or the
+#               forge environment gate enforces that)
+#
+# Auth (zero-trust default — see README.md#credentials--zero-trust):
+#   OIDC federation is the default. permissions: id-token: write lets the
+#   forge mint a short-lived STS token. The role-to-assume is scoped by the
+#   consumer's repository identity (ABAC) — the workflow assumes the role
+#   that matches repo:org/consumer-repo:ref:refs/heads/main, and the session
+#   policy restricts view/update to resources tagged acdl:owner=<consumer-repo>.
+#
+#   Override (where OIDC is unavailable, e.g. Gitea pending
+#   go-gitea/gitea#36988): set ACDL_AWS_ACCESS_KEY_ID + ACDL_AWS_SECRET_ACCESS_KEY
+#   as repository secrets. The platform-managed scheduled pipeline rotates
+#   the key on a daily cadence. When .env.secrets is used locally instead,
+#   rotating the key out of band is the consumer's responsibility.
+name: acdl-deploy
+
+on:
+  workflow_call:
+    inputs:
+      contract:
+        description: Path to the consumer contract YAML (in the consumer repo)
+        type: string
+        default: .acdl/contract.yaml
+      mode:
+        description: Pipeline mode — full (apply), plan-only, check-only, or decommission
+        type: string
+        default: full
+      changeRequestId:
+        description: Change request ID (required for decommission mode — validated against CMDB)
+        type: string
+        default: ""
+      environment:
+        description: Target environment override (dev/qa/prod/dr); when empty, the contract's environment field is used
+        type: string
+        default: ""
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out consumer repo
+        uses: actions/checkout@v4
+
+      - name: Check out ACDL platform repo
+        uses: actions/checkout@v4
+        with:
+          repository: acdl/acdl
+          path: platform
+          ref: v1.9
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install runtime dependencies
+        run: |
+          pip install --break-system-packages jsonschema pyyaml boto3
+          pip install --break-system-packages "checkov>=3.2,<4"
+
+      - name: Install Terraform 1.9.*
+        run: |
+          wget -qO- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp.gpg
+          echo "deb [signed-by=/usr/share/keyrings/hashicorp.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
+          sudo apt-get update && sudo apt-get install -y terraform=1.9.*
+
+      - name: Configure AWS credentials (OIDC default + static-key override)
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          role-to-assume: ${{ secrets.ACDL_AWS_ACCESS_KEY_ID == '' && format('arn:aws:iam::{0}:role/acdl-deploy-{1}', secrets.ACDL_AWS_ACCOUNT_ID, github.repository_id) || '' }}
+          aws-region: us-east-1
+          access-key-id: ${{ secrets.ACDL_AWS_ACCESS_KEY_ID }}
+          secret-access-key: ${{ secrets.ACDL_AWS_SECRET_ACCESS_KEY }}
+
+      - name: Run the platform pipeline
+        working-directory: ${{ github.workspace }}
+        run: |
+          MODE_FLAG=""
+          case "${{ inputs.mode }}" in
+            full) MODE_FLAG="" ;;
+            plan-only) MODE_FLAG="--plan-only" ;;
+            check-only) MODE_FLAG="--check-only" ;;
+            decommission)
+              if [ -z "${{ inputs.changeRequestId }}" ]; then
+                echo "FAIL: changeRequestId is required for decommission mode"
+                exit 1
+              fi
+              MODE_FLAG="--decommission ${{ inputs.changeRequestId }}"
+              ;;
+            *) echo "Unknown mode: ${{ inputs.mode }}"; exit 1 ;;
+          esac
+          ENV_FLAG=""
+          if [ -n "${{ inputs.environment }}" ]; then
+            ENV_FLAG="--environment ${{ inputs.environment }}"
+          fi
+          bash platform/scripts/run_platform.sh $MODE_FLAG $ENV_FLAG "${{ inputs.contract }}"
+
+      - name: Post stage summary comment to PR
+        if: success() && github.event_name == 'pull_request'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GITHUB_REF: ${{ github.ref }}
+        run: |
+          bash platform/scripts/post_stage_comment.sh deploy pass '{"mode":"${{ inputs.mode }}","runId":"${{ github.run_id }}"}'
+
+      - name: Report error to platform team (on failure)
+        if: failure()
+        env:
+          AWS_DEFAULT_REGION: us-east-1
+        run: |
+          aws lambda invoke-function-url \
+            --function-url "${{ secrets.ACDL_LAMBDA_URL }}" \
+            --cli-binary-format raw-in-base64-out \
+            --payload "$(python3 -c "import json,os; print(json.dumps({'action':'report_error','consumerRepo':os.environ.get('GITHUB_REPOSITORY',''),'contractId':'${{ github.run_id }}','error':'Deploy pipeline failed. See run logs.','runUrl':'${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}','environment':'dev'}))")" \
+            /dev/null || true
+
+      - name: Upload emitted Terraform
+        uses: actions/upload-artifact@v4
+        with:
+          name: acdl-terraform
+          path: /tmp/acdl_platform_run_v18/tf/*.tf
+          if-no-files-found: warn
+
+      - name: Upload platform log
+        uses: actions/upload-artifact@v4
+        with:
+          name: acdl-platform-log
+          path: platform/logs/
+          if-no-files-found: warn

.github/workflows/patterns-plan.yml

@@ -0,0 +1,28 @@
+# ACDL Patterns Plan Pipeline — GitHub Actions (production)
+#
+# Runs on PRs to main. For each L2 module, runs a plan-only (offline
+# --check-only mode: resolves the sample contract for the module, runs the
+# adapter, validates the emitted Terraform structure).
+name: acdl-patterns-plan
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  pattern-plan:
+    name: Pattern plan (${{ matrix.module }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        module: [static-assets, microservice]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: pip install jsonschema pyyaml boto3
+      - name: Pattern plan check (${{ matrix.module }})
+        run: bash scripts/run_pattern_plan.sh --check-only ${{ matrix.module }}

.github/workflows/platform-test.yml

@@ -0,0 +1,146 @@
+# ACDL Platform Test Pipeline — GitHub Actions (production)
+#
+# Runs on PRs to main. Replaces ci.yml for PRs (ci.yml stays for push-to-main).
+# Four stages: lint, unit-test, integration-test, schema-validation.
+#
+# Shell reproducibility: scripts/run_ci.sh runs lint + test + check-only locally.
+# The integration-test stage runs run_platform.sh --check-only for every
+# contracts/*.yaml file. The schema-validation stage validates schemas, module
+# interfaces, compositions, and example contracts.
+name: acdl-platform-test
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Compile all Python files
+        run: |
+          python3 -m py_compile \
+            core/confidence_signal.py \
+            core/outbox_writer.py \
+            core/contract_resolver.py \
+            core/environment_check.py \
+            core/output_publisher.py \
+            core/lambda/contract_ingestor.py \
+            adapters/terraform/adapter.py \
+            adapters/terraform/policy/checkov_adapter.py \
+            adapters/wiz/wiz_adapter.py \
+            adapters/kyverno/kyverno_adapter.py \
+            scripts/push_consumer_image.py
+
+  unit-test:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install test dependencies
+        run: pip install -r requirements-test.txt
+      - name: Run pytest
+        run: python3 -m pytest tests/ -v --tb=short
+
+  integration-test:
+    name: Integration test (all sample contracts)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install runtime dependencies
+        run: pip install jsonschema pyyaml boto3
+      - name: Run platform check-only for every sample contract
+        run: |
+          for contract in contracts/*.yaml; do
+            echo "--- Testing $contract ---"
+            bash scripts/run_platform.sh --check-only "$contract"
+          done
+
+  schema-validation:
+    name: Schema + module validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: pip install jsonschema pyyaml
+      - name: Validate all schemas
+        run: |
+          python3 -c "
+          import json, glob, jsonschema
+          for schema_file in glob.glob('schemas/*.json'):
+              if 'contract.schema' in schema_file:
+                  continue  # has no self-validation
+              schema = json.load(open(schema_file))
+              # self-validate if it has a \$id
+              try:
+                  jsonschema.Draft202012Validator.check_schema(schema)
+              except jsonschema.SchemaError as e:
+                  raise SystemExit(f'{schema_file}: {e}')
+              print(f'{schema_file}: valid')
+          "
+      - name: Validate all module interfaces against stack.schema.json
+        run: |
+          python3 -c "
+          import json, glob, jsonschema, os
+          stack_schema = json.load(open('schemas/stack.schema.json'))
+          for iface_file in glob.glob('modules/l1/*/interface.json'):
+              try:
+                  iface = json.load(open(iface_file))
+                  # Validate basic structure (name, version, kind, type, inputs, outputs)
+                  assert 'name' in iface, f'{iface_file}: missing name'
+                  assert 'version' in iface, f'{iface_file}: missing version'
+                  assert 'kind' in iface, f'{iface_file}: missing kind'
+                  assert iface['kind'] == 'l1', f'{iface_file}: expected kind=l1'
+                  assert 'type' in iface, f'{iface_file}: missing type'
+                  assert 'inputs' in iface, f'{iface_file}: missing inputs'
+                  assert 'outputs' in iface, f'{iface_file}: missing outputs'
+                  print(f'{iface_file}: valid L1')
+              except Exception as e:
+                  raise SystemExit(f'{iface_file}: {e}')
+          for comp_file in glob.glob('modules/l2/*/composition.json'):
+              try:
+                  comp = json.load(open(comp_file))
+                  assert 'name' in comp, f'{comp_file}: missing name'
+                  assert 'version' in comp, f'{comp_file}: missing version'
+                  assert 'kind' in comp, f'{comp_file}: missing kind'
+                  assert comp['kind'] == 'l2', f'{comp_file}: expected kind=l2'
+                  assert 'children' in comp, f'{comp_file}: missing children'
+                  assert 'wires' in comp, f'{comp_file}: missing wires'
+                  assert 'outputs' in comp, f'{comp_file}: missing outputs'
+                  print(f'{comp_file}: valid L2')
+              except Exception as e:
+                  raise SystemExit(f'{comp_file}: {e}')
+          "
+      - name: Validate module example contracts
+        run: |
+          python3 -c "
+          import json, yaml, glob, jsonschema
+          schema = json.load(open('schemas/contract.schema.json'))
+          # Validate example contracts if they exist
+          for example in glob.glob('modules/*/*/examples/*.yaml'):
+              try:
+                  contract = yaml.safe_load(open(example))
+                  jsonschema.validate(contract, schema)
+                  print(f'{example}: valid contract')
+              except Exception as e:
+                  print(f'{example}: SKIP (not a contract or invalid: {e})')
+          # Also validate all sample contracts in contracts/
+          for contract_file in glob.glob('contracts/*.yaml'):
+              contract = yaml.safe_load(open(contract_file))
+              jsonschema.validate(contract, schema)
+              print(f'{contract_file}: valid contract')
+          "

.github/workflows/primitives-plan.yml

@@ -0,0 +1,28 @@
+# ACDL Primitives Plan Pipeline — GitHub Actions (production)
+#
+# Runs on PRs to main. For each L1 primitive, runs a plan-only (offline
+# --check-only mode: resolves the primitive's instance.json, runs the adapter,
+# validates the emitted Terraform structure).
+name: acdl-primitives-plan
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  primitive-plan:
+    name: Primitive plan (${{ matrix.primitive }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        primitive: [s3, vpc, ecs-cluster, ecs-service, iam-role, alb, ecr, cloudfront, waf, rds]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: pip install jsonschema pyyaml boto3
+      - name: Primitive plan check (${{ matrix.primitive }})
+        run: bash scripts/run_primitive_plan.sh --check-only ${{ matrix.primitive }}

.github/workflows/release.yml

@@ -0,0 +1,92 @@
+# ACDL Release Pipeline — GitHub Actions (production)
+#
+# Runs on push to main. Computes the next semver tag from the latest tag +
+# commit history, creates the tag, updates floating MAJOR.MINOR and MAJOR tags,
+# and creates a GitHub release with auto-generated notes.
+#
+# Semver policy:
+#   - Regular phase commit -> bump PATCH (v1.6.0 -> v1.6.1)
+#   - Milestone completion ("docs(milestone): complete") -> bump MINOR (v1.6.1 -> v1.7.0)
+#   - Major bumps are manual (not implemented here).
+name: acdl-release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    name: Compute semver + update tags
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # need full history for tag computation
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Compute next version
+        id: version
+        run: |
+          # Get the latest tag
+          LATEST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0")
+          echo "Latest tag: $LATEST_TAG"
+
+          # Parse the version
+          MAJOR=$(echo "$LATEST_TAG" | sed -n 's/v\([0-9]*\)\.\([0-9]*\)\.\([0-9]*\)/\1/p')
+          MINOR=$(echo "$LATEST_TAG" | sed -n 's/v\([0-9]*\)\.\([0-9]*\)\.\([0-9]*\)/\2/p')
+          PATCH=$(echo "$LATEST_TAG" | sed -n 's/v\([0-9]*\)\.\([0-9]*\)\.\([0-9]*\)/\3/p')
+
+          # Check if this is a milestone completion (look for "docs(milestone): complete" in the latest commits)
+          if git log --format='%s' -5 | grep -q 'docs(milestone): complete'; then
+            # Milestone completion -> bump minor
+            MINOR=$((MINOR + 1))
+            PATCH=0
+          else
+            # Regular phase -> bump patch
+            PATCH=$((PATCH + 1))
+          fi
+
+          NEW_TAG="v${MAJOR}.${MINOR}.${PATCH}"
+          MAJOR_MINOR_TAG="v${MAJOR}.${MINOR}"
+          MAJOR_TAG="v${MAJOR}"
+
+          echo "new_tag=$NEW_TAG" >> $GITHUB_OUTPUT
+          echo "major_minor_tag=$MAJOR_MINOR_TAG" >> $GITHUB_OUTPUT
+          echo "major_tag=$MAJOR_TAG" >> $GITHUB_OUTPUT
+          echo "Next version: $NEW_TAG"
+
+      - name: Create version tag
+        run: |
+          git tag ${{ steps.version.outputs.new_tag }}
+          git push origin ${{ steps.version.outputs.new_tag }}
+
+      - name: Update floating MAJOR.MINOR tag
+        run: |
+          git tag -f ${{ steps.version.outputs.major_minor_tag }} ${{ steps.version.outputs.new_tag }}
+          git push origin ${{ steps.version.outputs.major_minor_tag }} --force
+
+      - name: Update floating MAJOR tag
+        run: |
+          git tag -f ${{ steps.version.outputs.major_tag }} ${{ steps.version.outputs.new_tag }}
+          git push origin ${{ steps.version.outputs.major_tag }} --force
+
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Generate release body from commit history since last tag
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -n "$PREV_TAG" ]; then
+            BODY=$(git log --format='- %s' "$PREV_TAG"..HEAD)
+          else
+            BODY=$(git log --format='- %s' HEAD)
+          fi
+          gh release create ${{ steps.version.outputs.new_tag }} \
+            --title "ACDL ${{ steps.version.outputs.new_tag }}" \
+            --notes "$BODY" \
+            --generate-notes || true

.gitignore

@@ -7,4 +7,14 @@ state.json
 audit.json
 *.tmp
 .DS_Store
-runner-data/
+runner-data/
+.env.secrets
+terraform/bootstrap/.bootstrap_state.json
+terraform/spike/.terraform/
+terraform/spike/.terraform.lock.hcl
+terraform/spike/tfplan
+terraform/spike/*.tfstate*
+terraform/microservice/.terraform/
+terraform/microservice/.terraform.lock.hcl
+terraform/microservice/tfplan
+terraform/microservice/*.tfstate*

README.md

@@ -5,48 +5,309 @@ through an agentic stack — automatically, safely, and with a complete audit
 trail. A merged change progresses through lower environments end-to-end
 without a platform engineer joining a thread; a non-technical consumer ships
 a production deployment by declaring intent, without authoring a workflow,
-a configuration file, or a Terraform module.
+a configuration file, or an infrastructure module.
 
-- **Vision** (the why): [`docs/vision.md`](docs/vision.md)
-- **Architecture** (the how): [`docs/architecture.md`](docs/architecture.md)
-- **Decisions**: [`.ciagent/PROJECT.md`](.ciagent/PROJECT.md)
-- **Target architecture**: [`.ciagent/ARCHITECTURE.md`](.ciagent/ARCHITECTURE.md)
-- **Phase plan**: [`.ciagent/ROADMAP.md`](.ciagent/ROADMAP.md)
+- **Consumer guide:** [`docs/consumer-guide.md`](docs/consumer-guide.md)
+- **Modules:** [`docs/modules/`](docs/modules/)
+- **Contracts:** [`docs/contracts/`](docs/contracts/)
+- **Pipeline:** [`docs/pipeline/`](docs/pipeline/)
+- **Versioning:** [`docs/pipeline/versioning.md`](docs/pipeline/versioning.md)
+- **Environments:** [`docs/environments/`](docs/environments/)
+- **Architecture:** [`docs/architecture.md`](docs/architecture.md)
+- **Vision:** [`docs/vision.md`](docs/vision.md)
 
-## Status
+## Repository roles
 
-- **v1.1 (active):** architecture finalization + v1 spike. Finalize the
-  architecture to v1.0 (resolve the 11 open design decisions) and prove the
-  locked commitments with one end-to-end implementation spike
-  (`l1-s3` + `l2-static-asset` + Terraform adapter → real `terraform plan`
-  against AWS).
-- **v1.0 demo (complete, archived):** tag `v1.1.0`. The 30-minute
-  stub-driven executive demo is preserved under `demo/` as the intent
-  reference; it is not the platform.
+There are two kinds of repository in the ACDL model:
+
+- **Platform repo (this one).** This is the **source code of the platform**.
+  It owns `modules/`, `adapters/`, `core/`, `schemas/`, `pipelines/`,
+  `scripts/`, and the reusable workflow files. Platform engineers work here.
+  A **consumer never clones it.**
+- **Consumer repo (yours).** A consumer repo contains only:
+  1. **Its application code** — the service or site being deployed.
+  2. **One or more contracts** — small YAML files at `.acdl/contract.yaml`
+     that reference the central pipeline, name a module, select an
+     environment, and supply module-specific inputs.
+  3. **One or more CI definitions** — thin `.github/workflows/*.yml` files
+     that `uses:` the central reusable deploy workflow, pointing at the
+     appropriate environment + contract.
+
+  The consumer does not write infrastructure modules, workflow YAML beyond
+  the thin `uses:` wrapper, or adapter code — they write a contract YAML
+  file and the platform does the rest.
+
+The rest of this README describes the **platform repo** (how the platform
+works, how to run it locally, how it's laid out). If you are a consumer,
+jump to the [Consumer guide](docs/consumer-guide.md).
+
+## Features
+
+A referenceable list of what the platform provides today, for consumers and
+platform engineers alike:
+
+- **Contract-driven deploys** — a consumer writes a YAML contract; the
+  platform resolves it to a stack, compiles it, and deploys it.
+- **Reusable versioned deploy workflow** — consumer repos `uses:` a
+  versioned central workflow; no platform code is cloned by the consumer.
+- **Module catalog** — primitives (single resources) and modules (patterns
+  of primitives) with self-documented inputs/outputs. See
+  [docs/modules/](docs/modules/).
+- **Zero-trust credentials** — OIDC federation + attribute-based
+  authorization (ABAC) by default; no long-lived keys in consumer repos.
+- **Security + policy checks** — a security-check stage and a policy-check
+  stage run before any infrastructure is created.
+- **Confidence signal** — a computed, explainable score gates promotion.
+- **Evidence outbox** — every deployment writes a hash-chained evidence
+  event to an audit outbox.
+- **Shell reproducibility** — `scripts/run_ci.sh` mirrors the CI pipeline
+  locally; `scripts/run_platform.sh --check-only` runs offline.
+- **Platform-managed environments** — consumers provide no AWS account,
+  VPC, subnet, or state bucket; the platform manages environments. See
+  [docs/environments/](docs/environments/).
+- **Central pipeline contract** — a declarative YAML instance is the single
+  source of truth for both the CI and deploy workflows.
+
+## Roadmap
+
+Planned future features (no dates; tracked in the internal roadmap):
+
+- **Dynamic module creation from a contract** — an agentic flow where a
+  consumer creates a module directly from the contract file (the
+  "composition" mechanism, redesigned).
+- **Compliance milestone** — per-module compliance extension points (GDPR,
+  SOX, SOC2, DORA) wired into the pipeline.
+- **Additional substrate adapters** — beyond the Terraform adapter.
+- **Environment self-service** — a consumer-facing flow to request and
+  provision a new platform-managed environment (today it is a platform-team
+  action).
+- **HITL gates for qa / prod / dr** — human attestation + higher confidence
+  thresholds for higher environments.
+- **OIDC for all platform runners** — zero-trust credentials everywhere.
+
+## How the platform works
+
+The platform is **four layers + six cross-cutting concerns**, bound by the
+vision's "Two Consumer Surfaces, One Platform" tenet: consumers declare
+intent via a contract; the platform delivers the deployment through the
+same contract schema, the same policy envelope, and the same evidence
+stream.
+
+Consumers have their own repos and consume ACDL by referencing `uses:` the
+central pipeline definitions. A consumer declares a contract (module +
+environment + inputs); the platform resolves it to a stack instance,
+compiles it, runs security + policy checks, computes a confidence signal,
+writes an evidence event to the audit outbox, and applies the
+infrastructure.
+
+### The platform flow (end-to-end)
+
+```mermaid
+flowchart TD
+    A["consumer contract<br/>(uses + module + environment + inputs)"] --> B
+    B["schema validation<br/>(contract schema)"] --> C
+    C["resolve to Target Stack<br/>(contract resolver)"] --> D
+    D["security checks<br/>(adapter)"] --> E
+    E["infrastructure plan<br/>(adapter compiles the stack)"] --> F
+    F["policy checks<br/>(adapter -&gt; PolicyCheckResult records)"] --> G
+    G["confidence signal<br/>(6 inputs: policy, validation,<br/>freshness, source, history, NFRs)"] --> H
+    H["evidence event<br/>(hash-chained, to the audit outbox)"] --> I
+    I["infrastructure apply<br/>(dev only, autonomous)"]
+```
+
+The platform validates the architecture's claim that the **stack
+commitments do not require a polyglot mess**: the adapter is the only
+substrate-specific code. `modules/`, `schemas/`, `contracts/`,
+`core/confidence_signal.py`, `core/contract_resolver.py`, and
+`core/outbox_writer.py` are all substrate-agnostic (no `aws_s3_bucket` /
+`aws_` infrastructure terms).
+
+## How to run
+
+### Prerequisites
+
+> These prerequisites are for running the **platform repo** locally. A
+> consumer does not need any of these — see the
+> [Consumer guide](docs/consumer-guide.md) for the consumer happy path.
+
+- A platform-managed environment (see [docs/environments/](docs/environments/)).
+  For local testing, `core/environments/dev.json` is provided as the sample.
+- AWS credentials for the dev environment (in `.env.secrets`, gitignored;
+  see [Credentials & zero-trust](#credentials--zero-trust)).
+- `terraform` (pin `1.9.*`), `checkov` (pin `>=3.2,<4`), `python3` + `boto3`
+  + `jsonschema`.
+
+### Run the platform pipeline end-to-end
+
+```bash
+# 1. Bootstrap the AWS state backend + runner IAM user (one-time, idempotent)
+#    (requires the bootstrap root key in env — skip if the state bucket +
+#    acdl-spike-runner already exist)
+ACDL_BOOTSTRAP_AWS_ACCESS_KEY_ID=... ACDL_BOOTSTRAP_AWS_SECRET_ACCESS_KEY=... \
+  python3 terraform/bootstrap/create_state_backend.py
+ACDL_BOOTSTRAP_AWS_ACCESS_KEY_ID=... ACDL_BOOTSTRAP_AWS_SECRET_ACCESS_KEY=... \
+  python3 terraform/bootstrap/create_iam_user.py  # prints the initial key
+
+# 2. Rotate the runner key (writes .env.secrets, gitignored)
+ACDL_BOOTSTRAP_AWS_ACCESS_KEY_ID=... ACDL_BOOTSTRAP_AWS_SECRET_ACCESS_KEY=... \
+  bash scripts/rotate_spike_key.sh
+
+# 3. Run the full platform pipeline (contract -> environment check -> stack ->
+#    adapter -> security checks -> infrastructure plan -> policy checks ->
+#    confidence -> evidence event -> apply). Output is streamed to stdout.
+bash scripts/run_platform.sh contracts/static-assets.yaml
+# Expected: "=== PLATFORM E2E OK ==="
+
+# Or plan-only (contract -> stack -> adapter -> infrastructure plan; no
+# policy checks / outbox):
+bash scripts/run_platform.sh --plan-only contracts/static-assets.yaml
+
+# Add --quiet to suppress streaming (output to log files only):
+bash scripts/run_platform.sh --quiet contracts/static-assets.yaml
+```
+
+### Test the platform (offline, no AWS required)
+
+```bash
+# Install test dependencies
+pip install -r requirements-test.txt
+
+# Run the test suite (all offline — uses moto for DynamoDB mocking)
+python3 -m pytest tests/ -v
+
+# Run the platform in check-only mode (offline — no AWS, no policy checks,
+# no outbox). Uses the default sample contract (contracts/static-assets.yaml)
+# and the sample dev environment (core/environments/dev.json).
+bash scripts/run_platform.sh --check-only
+# Expected: "=== PLATFORM CHECK OK ==="
+
+# Reproduce the full CI pipeline locally (lint -> test -> check-only)
+bash scripts/run_ci.sh
+# Expected: "=== CI PIPELINE OK ==="
+```
+
+### CI/CD pipelines
+
+The CI/CD pipeline is defined by a **central pipeline contract** — a
+declarative YAML instance (`pipelines/ci.yaml`) validated against a JSON
+Schema (`schemas/pipeline.schema.json`). Both platform-runner workflows
+implement the same contract:
+
+- `.github/workflows/ci.yml` — GitHub Actions (production)
+
+Both run three stages: **lint** (py_compile), **test** (pytest), and
+**check-only** (`run_platform.sh --check-only`). Both trigger on push to
+`main` and on pull requests. A test (`tests/test_pipeline_contract.py`)
+validates that the workflow conforms to the contract.
+
+`scripts/run_ci.sh` mirrors the CI pipeline locally — running the same
+three stages in sequence. This makes the pipeline fully reproducible from
+the shell, not just in CI:
+
+```bash
+bash scripts/run_ci.sh           # run all 3 stages (lint, test, check-only)
+bash scripts/run_ci.sh --quiet    # suppress per-stage banners
+```
+
+### Reusable deploy workflow
+
+The deployment pipeline is defined by a **central deployment pipeline
+contract** (`pipelines/deploy.yaml`, validated against
+`schemas/deploy-pipeline.schema.json`) and exposed to consumer repos as a
+**reusable workflow**:
+
+- `.github/workflows/deploy.yml` — GitHub Actions (production)
+
+The workflow implements the same stages as `pipelines/deploy.yaml`
+(validate-contract → resolve-stack → security checks → infrastructure plan
+→ policy checks → confidence → evidence event → apply). A consumer repo
+invokes the reusable workflow via a **versioned tag** (floating MAJOR +
+MINOR, e.g. `acdl/.github/workflows/deploy.yml@v1.6`). The workflow checks
+out the consumer repo, then checks out the ACDL platform repo into the
+runner workspace, and runs `scripts/run_platform.sh` against the consumer's
+contract — the consumer never clones the platform repo or invokes its
+scripts locally. See the [Consumer guide](docs/consumer-guide.md) for the
+end-to-end happy path.
+
+### Output streaming (run_platform.sh)
+
+`scripts/run_platform.sh` streams output by default so the user can see
+what the platform is doing:
+
+- **`--check-only`**: streams the emitted infrastructure file content to
+  stdout.
+- **`--plan-only`** and **full mode**: streams the infrastructure plan
+  output via `tee` (visible and logged).
+- **Full mode**: prints policy-check results and each `PolicyCheckResult`
+  record with severity, rule ID, and pass/fail status.
+
+A `--quiet` flag suppresses streaming (output to log files only) for
+backwards-compatible log-only mode.
+
+## Consumer guide
+
+A step-by-step guide for a consumer to create their pipeline and define a
+contract that deploys any ACDL module to AWS is at
+[`docs/consumer-guide.md`](docs/consumer-guide.md). The guide is generic
+across all modules; `static-assets` is the worked example.
 
 ## Repository layout
 
-| Path | Purpose | Populated |
-|------|---------|-----------|
-| `platform/` | Platform code: confidence signal, contract resolver, outbox, HITL/ledger designs | Phase 07+ |
-| `schemas/` | JSON Schemas: IR, PolicyCheckResult, contract | Phase 07 |
-| `adapters/` | Substrate adapters (Terraform adapter in v1; the only substrate-specific code per §12) | Phase 09 |
-| `terraform/` | State backend + provider config (S3 state + DynamoDB lock) | Phase 08+ |
-| `modules-ir/` | IR-typed L1/L2 modules (`l1-s3`, `l2-static-asset`) | Phase 09–10 |
-| `scripts/` | v1.1 verify scripts (`verify_phaseNN.sh`) | Phase 06+ |
-| `demo/` | Archived v1.0 executive demo (tag `v1.1.0`); runs locally via `demo/scripts/run_demo.sh --no-upload` | complete |
-| `.ciagent/` | CIAgent metadata (plans, decisions, personas, roadmap, research) | active |
-| `docs/` | Upstream vision + architecture sources | active |
+| Path | Purpose | Status |
+|------|---------|--------|
+| `core/` | Platform code: contract resolver, confidence signal, outbox writer, environment check, environments, separation of duties, HITL/ledger designs | active |
+| `schemas/` | JSON Schemas: stack, contract, PolicyCheckResult, pipeline contract, deploy pipeline contract (draft 2020-12) | active |
+| `pipelines/` | Central pipeline contracts: `ci.yaml` (CI), `deploy.yaml` (deployment) | active |
+| `adapters/` | Substrate adapters — the substrate adapter (the only substrate-specific code per §12) + the policy adapter | active |
+| `terraform/` | State backend (S3 + DynamoDB) + platform TF (`terraform/spike/`) + bootstrap scripts (`terraform/bootstrap/`) | active |
+| `modules/` | Primitives + modules + `registry.json`. Primitives: s3, vpc, ecs-cluster, ecs-service, iam-role, alb, ecr, cloudfront, waf, rds. Modules: microservice, static-assets. Each module has a `examples/` directory with validated contract examples | active |
+| `contracts/` | Sample consumer contracts (`static-assets.yaml`, `microservice.yaml`) | active |
+| `scripts/` | Platform run script (`run_platform.sh` with `--check-only`/`--plan-only`/`--quiet`), CI pipeline script (`run_ci.sh`), key rotation | active |
+| `tests/` | Pytest suite (all offline — adapter, confidence signal, policy adapter, outbox writer, pipeline contract, contract resolver, streaming, environment check) | active |
+| `.github/workflows/` | GitHub Actions workflows: `ci.yml` (CI), `deploy.yml` (reusable deploy, invoked by consumer repos) | active |
+| `docs/` | GitHub Pages documentation site: consumer guide, modules, contracts, pipeline, versioning, environments, architecture, vision | active |
 
-## Running the archived demo
+## Credentials & zero-trust
 
-The v1.0 demo is an archived artifact. To re-run it locally:
+### Default — zero-trust OIDC + attribute-based authorization
 
-```bash
-bash demo/scripts/run_demo.sh --no-upload
-```
+Consumer repos are **zero-trust**: they hold **no long-lived AWS keys** and
+no static credentials in repo secrets.
 
-The demo deck is at [`demo/ACDL_DEMO.md`](demo/ACDL_DEMO.md). The demo runs
-entirely on local stubs — no AWS, no AI — and shows intent and safety
-behavior rather than provisioning real cloud resources. It is the reference
-of intent for the real platform; it is not the platform itself.
+- **Authentication** is **OIDC federation** between the platform runners
+  (GitHub Actions) and AWS. Each job mints a short-lived STS token; no
+  credential is ever stored in the consumer repo or in a runner secret.
+- **Authorization** is **attribute-based (ABAC)**, not role-based (RBAC).
+  AWS IAM roles and session policies are scoped by two attribute classes:
+  - **Repository identity** — the runner claim (e.g.
+    `repo:org/consumer-repo:ref:refs/heads/main`) binds the role's trust
+    policy to the exact consumer repo + branch that invoked the workflow.
+  - **Resource-creation attributes** — every resource the pipeline creates
+    is tagged with `acdl:owner=<consumer-repo>` and
+    `acdl:contract=<contract-id>`. The session policy grants
+    view/update/delete **only on resources whose tags match the calling
+    repo**.
+
+  The effect: a consumer's pipeline can only view and update the resources
+  it created. Blast radius is contained to that consumer's own stack
+  instances — one consumer can never touch another consumer's resources,
+  and the consumer cannot escape its own scope.
+
+### Alternative — static AWS key
+
+Where OIDC is not yet available, a static AWS key **may** be used as a
+documented alternative:
+
+- The key is stored in **GitHub Secrets** (consumer repo) for platform-runner
+  runs, or in **`.env.secrets`** (gitignored, chmod 600) for local testing.
+- The platform rotates platform-runner keys on a **daily cadence** —
+  rotation is not the consumer's burden in the platform-runner path.
+- **When `.env.secrets` is used locally**, rotating the key **out of band is
+  the consumer's responsibility**. The platform guarantees daily rotation
+  for platform-runner runs; it does not guarantee rotation for
+  locally-held copies. The consumer must rotate a local key via
+  `scripts/rotate_spike_key.sh` (or equivalent) on their own cadence.
+
+No long-lived credential is permitted persistently — the platform-runner
+key's useful lifetime is one workflow run, and the local alternative is
+rotated at least daily (platform-runner) or out of band (local).

adapters/README.md

@@ -0,0 +1,65 @@
+# ACDL Adapters
+
+## Overview
+
+Adapters translate the substrate-agnostic Target Stack IR to substrate-specific formats. The Terraform adapter is the primary adapter (IR → HCL). Policy adapters translate security tool output into normalized `PolicyCheckResult` records that the confidence signal consumes in an engine-agnostic way.
+
+## Existing Adapters
+
+| Adapter | Path | Input | Output | Purpose |
+| --- | --- | --- | --- | --- |
+| Terraform adapter | `adapters/terraform/adapter.py` | Stack instance JSON | Terraform HCL (`main.tf`, `terraform.tf`, `providers.tf`) | Compiles IR to Terraform |
+| Checkov adapter | `adapters/terraform/policy/checkov_adapter.py` | Checkov JSON | `PolicyCheckResult` records | Translates Checkov results |
+| Wiz adapter | `adapters/wiz/wiz_adapter.py` | Wiz API issues JSON | `PolicyCheckResult` records | Translates Wiz security findings |
+| Kyverno adapter | `adapters/kyverno/kyverno_adapter.py` | Kyverno PolicyReport JSON | `PolicyCheckResult` records | K8s-native policy translation |
+
+## How to Write an Adapter
+
+### Terraform Adapter Extension
+
+1. Add a stack type → Terraform type mapping to `TYPE_MAP`.
+2. Add non-identity input mappings to `INPUT_MAP`.
+3. Add non-identity output mappings to `OUTPUT_MAP`.
+4. Add a specialized `_emit_resource` branch if the resource needs nested blocks (e.g. inline policies, rule sets).
+
+### Policy Adapter Pattern
+
+1. Define `SEVERITY_MAP` and `RESULT_MAP` dicts that translate the engine's native severity/result vocabulary to the `PolicyCheckResult` enums.
+2. Implement `_to_pcr(raw_record, contract_id)` → `PolicyCheckResult` dict.
+3. Implement `adapt(input_path, contract_id)` → list of `PolicyCheckResult` dicts.
+4. Implement `is_configured()` → bool (env var check) so the platform can skip the adapter when credentials are absent.
+
+## How to Wire an Adapter
+
+- **Terraform adapter** — invoked by `scripts/run_platform.sh` Step 3 (`terraform-plan`).
+- **Checkov adapter** — invoked by `scripts/run_platform.sh` Step 5 (`checkov`).
+- **Wiz / Kyverno adapters** — optional Steps 5b/5c, run only when the relevant env vars are set.
+- All policy adapters output records that are validated against `schemas/policy_check_result.schema.json`.
+
+## Dependencies
+
+- `jsonschema`, `pyyaml` — used by all adapters for loading and validating inputs.
+- `boto3` — used by the Wiz adapter for AWS API access.
+- `checkov` — used by the Checkov adapter to run policy scans.
+- No external deps for the Terraform adapter (pure Python).
+
+## How to Test Adapters
+
+- `tests/test_adapter.py` — Terraform adapter (`TYPE_MAP`, resource emission, refs, outputs).
+- `tests/test_checkov_adapter.py` — Checkov adapter.
+- `tests/test_wiz_adapter.py` — Wiz adapter.
+- `tests/test_kyverno_adapter.py` — Kyverno adapter.
+- All adapter tests load fixtures from `tests/fixtures/` and use `moto` for AWS mocking.
+
+## Where to Write Tests
+
+- `tests/test_<adapter_name>.py` paired with `tests/fixtures/<adapter>_fixture.json`.
+
+## Adding a New Adapter
+
+1. Create `adapters/<name>/<name>_adapter.py`.
+2. Implement `adapt()` and (for policy adapters) `is_configured()`.
+3. Add the adapter's engine name to the `engine` enum in `schemas/policy_check_result.schema.json` if it is a policy adapter.
+4. Write a test (`tests/test_<name>_adapter.py`) plus a fixture (`tests/fixtures/<name>_fixture.json`).
+5. Add it to `scripts/run_platform.sh` if it is invoked at runtime.
+6. Update this README.

adapters/kyverno/README.md

@@ -0,0 +1,68 @@
+# Kyverno Adapter
+
+The Kyverno adapter translates Kyverno `PolicyReport` results to the
+normalized ACDL
+[`PolicyCheckResult`](../../schemas/policy_check_result.schema.json) schema
+(engine: `"kyverno"`), mirroring the Checkov/Wiz adapter pattern.
+
+## What Kyverno is
+
+[Kyverno](https://kyverno.io/) is a Kubernetes-native policy engine. It
+runs as an admission controller inside a cluster, validates / mutates /
+generates K8s resources against declarative `ClusterPolicy` rules, and
+publishes results to `PolicyReport` resources.
+
+## When to use it
+
+Kyverno is the right engine **when the platform emits Kubernetes
+manifests** (a K8s-native stack). The ACDL platform today emits Terraform
+only (D-053), so this adapter is **ready but inactive**: it ships now so
+the schema path, severity/result mapping and sample policies are in place
+ahead of the GitOps reconciler that will emit K8s manifests (roadmap).
+
+## How the adapter translates PolicyReport results
+
+`kyverno_adapter.py <policyreport.json> <contract-id>` reads a JSON file
+containing a Kyverno `PolicyReport` (or just its `.results[]` array) and
+emits a list of `PolicyCheckResult` dicts:
+
+| Kyverno PolicyReport result field | PolicyCheckResult field |
+|-----------------------------------|-------------------------|
+| `policy`                          | `ruleId` (default `KYVERNO_UNKNOWN`) |
+| `severity`                        | `severity` (lower-cased, mapped) |
+| `result`                          | `result` (`pass`/`fail`/`error` as-is, `warn`/`skip`→`skipped`) |
+| `message`                         | `message` |
+| `resource`                        | `resourceRef` + `evidence.resource` |
+| `namespace`, `kind`, `name`       | `evidence.*` |
+
+The adapter is read-only against a local JSON fixture; the GitOps
+reconciler is responsible for fetching the live `PolicyReport` and writing
+the file. When there are zero results, the adapter returns an empty list
+(unlike Wiz it does not synthesize a SKIPPED record — Kyverno not running
+is a deployment state, not a configuration gap).
+
+## Roadmap dependency
+
+This adapter activates when the GitOps reconciler (roadmap) emits K8s
+manifests. Until then it is documentation-only; the pipeline does not
+invoke it. The `engine: "kyverno"` enum value is present in
+`schemas/policy_check_result.schema.json` so future records validate.
+
+## Sample policies
+
+The `policies/` directory holds three valid Kyverno `ClusterPolicy`
+manifests (documentation-only today — the platform does not run them):
+
+- `disallow-privileged-containers.yaml` — fail pods with
+  `securityContext.privileged: true`.
+- `require-resource-labels.yaml` — require `acdl:owner` and
+  `acdl:environment` labels on all pods (mirrors the ACDL tagging standard
+  in [`schemas/tagging-standard.json`](../../schemas/tagging-standard.json)).
+- `require-image-digests.yaml` — require container images to reference a
+  digest (`image@sha256:...`), not a mutable tag.
+
+## Schema path
+
+The output records validate against
+[`schemas/policy_check_result.schema.json`](../../schemas/policy_check_result.schema.json)
+(`engine: "kyverno"` was already in the enum and is retained in Phase 23).

adapters/kyverno/kyverno_adapter.py

@@ -0,0 +1,136 @@
+"""Kyverno adapter — translate Kyverno PolicyReport results to ACDL PolicyCheckResult records.
+
+Kyverno is a Kubernetes-native policy engine. It evaluates K8s manifests
+and produces PolicyReport resources. This adapter translates those results
+to the normalized PolicyCheckResult schema (engine: "kyverno").
+
+v1.9 (REQ-111): the translator is fleshed out — full PolicyReport →
+PolicyCheckResult mapping with severity + skip-with-reason handling. It
+remains inactive for Terraform-only stacks (guard preserved — emits a
+single SKIPPED `KYVERNO_INACTIVE_TF_STACK` record when no K8s manifests).
+A `--kube-version` stub is parsed but not yet used (for future GitOps).
+
+D-053: the platform emits Terraform, not K8s manifests. This adapter
+activates when the GitOps reconciler (roadmap) emits K8s manifests.
+Sample policies are included as documentation at adapters/kyverno/policies/.
+
+CLI: kyverno_adapter.py <policyreport.json> <contract-id> [--kube-version <ver>]
+"""
+
+import datetime
+import json
+import os
+import sys
+
+
+SEVERITY_MAP = {
+    "critical": "critical",
+    "high": "high",
+    "medium": "medium",
+    "low": "low",
+    "info": "info",
+    "informational": "info",
+}
+
+RESULT_MAP = {
+    "pass": "pass",
+    "fail": "fail",
+    "warn": "skipped",
+    "warning": "skipped",
+    "error": "error",
+    "skip": "skipped",
+    "skipped": "skipped",
+}
+
+
+def _iso8601_now():
+    return datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def _to_pcr(entry, contract_id):
+    severity_raw = entry.get("severity", "info")
+    severity = SEVERITY_MAP.get(str(severity_raw).lower(), "info")
+    result_raw = entry.get("result", "skip")
+    result = RESULT_MAP.get(str(result_raw).lower(), "error")
+    # Skip-with-reason: a skipped result carries a message that explains why.
+    message = entry.get("message", "")
+    if result == "skipped" and not message:
+        message = entry.get("skipReason", entry.get("skippedMessage", "skipped (no reason)"))
+    policy = entry.get("policy", "")
+    rule = entry.get("rule", "")
+    rule_id = f"{policy}/{rule}" if rule else (policy or "KYVERNO_UNKNOWN")
+    resource = entry.get("resource", "")
+    if not resource and entry.get("name"):
+        # Construct a resource ref from kind/name/namespace when present.
+        kind = entry.get("kind", "")
+        ns = entry.get("namespace", "")
+        resource = f"{kind}/{ns}/{entry.get('name')}" if kind else entry.get("name", "")
+    return {
+        "contractId": contract_id,
+        "evaluatedAt": _iso8601_now(),
+        "engine": "kyverno",
+        "ruleId": rule_id,
+        "severity": severity,
+        "result": result,
+        "message": message,
+        "evidence": {
+            "resource": resource,
+            "namespace": entry.get("namespace", ""),
+            "kind": entry.get("kind", ""),
+            "name": entry.get("name", ""),
+            "policy": policy,
+            "rule": rule,
+        },
+        "resourceRef": resource,
+    }
+
+
+def _emit_inactive_tf(contract_id):
+    """Emit a SKIPPED record when the platform emits Terraform, not K8s manifests."""
+    return {
+        "contractId": contract_id,
+        "evaluatedAt": _iso8601_now(),
+        "engine": "kyverno",
+        "ruleId": "KYVERNO_INACTIVE_TF_STACK",
+        "severity": "info",
+        "result": "skipped",
+        "message": "Kyverno inactive — the platform emits Terraform, not K8s manifests. Activates when the GitOps reconciler emits K8s manifests (D-053).",
+        "evidence": {},
+        "resourceRef": "",
+    }
+
+
+def adapt(policyreport_json_path, contract_id, kube_version=None):
+    with open(policyreport_json_path, "r", encoding="utf-8") as fh:
+        data = json.load(fh)
+    out = []
+    # Kyverno PolicyReport has a .results[] array.
+    results = data.get("results", [])
+    if not isinstance(results, list):
+        results = []
+    for entry in results:
+        out.append(_to_pcr(entry, contract_id))
+    if not out:
+        out.append(_emit_inactive_tf(contract_id))
+    # kube_version is parsed but not yet used (future GitOps reconciler).
+    _ = kube_version
+    return out
+
+
+def adapt_inactive(contract_id):
+    """Convenience: emit the inactive-for-TF record directly (no report file)."""
+    return [_emit_inactive_tf(contract_id)]
+
+
+if __name__ == "__main__":
+    kube_ver = None
+    args = sys.argv[1:]
+    if "--kube-version" in args:
+        idx = args.index("--kube-version")
+        if idx + 1 < len(args):
+            kube_ver = args[idx + 1]
+            args = args[:idx] + args[idx + 2:]
+    if len(args) != 2:
+        print("usage: kyverno_adapter.py <policyreport.json> <contract-id> [--kube-version <ver>]", file=sys.stderr)
+        sys.exit(2)
+    print(json.dumps(adapt(args[0], args[1], kube_version=kube_ver), indent=2))

adapters/kyverno/policies/disallow-privileged-containers.yaml

@@ -0,0 +1,27 @@
+apiVersion: kyverno.io/v1
+kind: ClusterPolicy
+metadata:
+  name: disallow-privileged-containers
+  annotations:
+    policies.kyverno.io/title: Disallow Privileged Containers
+    policies.kyverno.io/category: Security
+    policies.kyverno.io/severity: high
+    policies.kyverno.io/subject: Pod
+spec:
+  validationFailureAction: audit
+  background: true
+  rules:
+    - name: require-non-privileged
+      match:
+        any:
+          - resources:
+              kinds:
+                - Pod
+      validate:
+        message: "Privileged containers are not allowed. Set securityContext.privileged to false."
+        pattern:
+          spec:
+            containers:
+              - name: "*"
+                securityContext:
+                  privileged: "false"

adapters/kyverno/policies/require-image-digests.yaml

@@ -0,0 +1,26 @@
+apiVersion: kyverno.io/v1
+kind: ClusterPolicy
+metadata:
+  name: require-image-digests
+  annotations:
+    policies.kyverno.io/title: Require Image Digests
+    policies.kyverno.io/category: Supply Chain
+    policies.kyverno.io/severity: high
+    policies.kyverno.io/subject: Pod
+spec:
+  validationFailureAction: audit
+  background: true
+  rules:
+    - name: require-digest-reference
+      match:
+        any:
+          - resources:
+              kinds:
+                - Pod
+      validate:
+        message: "Container images must reference a digest (e.g. image@sha256:...), not a mutable tag."
+        pattern:
+          spec:
+            containers:
+              - name: "*"
+                image: "*@sha256:*"

adapters/kyverno/policies/require-resource-labels.yaml

@@ -0,0 +1,37 @@
+apiVersion: kyverno.io/v1
+kind: ClusterPolicy
+metadata:
+  name: require-resource-labels
+  annotations:
+    policies.kyverno.io/title: Require ACDL Resource Labels
+    policies.kyverno.io/category: Governance
+    policies.kyverno.io/severity: medium
+    policies.kyverno.io/subject: Pod
+spec:
+  validationFailureAction: audit
+  background: true
+  rules:
+    - name: require-acdl-owner-label
+      match:
+        any:
+          - resources:
+              kinds:
+                - Pod
+      validate:
+        message: "Pods must carry the acdl:owner label (ACDL tagging standard)."
+        pattern:
+          metadata:
+            labels:
+              acdl:owner: "?*"
+    - name: require-acdl-environment-label
+      match:
+        any:
+          - resources:
+              kinds:
+                - Pod
+      validate:
+        message: "Pods must carry the acdl:environment label (ACDL tagging standard)."
+        pattern:
+          metadata:
+            labels:
+              acdl:environment: "?*"

adapters/terraform/adapter.py

@@ -0,0 +1,660 @@
+"""ACDL Terraform adapter — compile a Target Stack instance to Terraform.
+
+ARCHITECTURE.md §12.2: the adapter translates the stack-typed L1 interface
+to a Terraform variable/output block, the L2 composition tree to a
+root module that calls the L1 modules, the stack-typed relationships to
+Terraform module references, and emits a Terraform plan from the stack.
+
+The adapter is a THIN LAYER; it does not own L1/L2 content — it only
+translates. Substrate-agnostic in, Terraform out.
+
+Phase 09 spike: handled one L1 (s3, stack type aws:s3:bucket).
+Phase 13: generalized the resource/output emission via TYPE_MAP +
+INPUT_MAP + OUTPUT_MAP tables; added ECS Fargate stack types. S3 behavior
+is preserved (regression baseline: modules/l1/s3/instance.json).
+
+CLI: adapter.py <instance.json> <out_dir>
+"""
+
+import json
+import os
+import sys
+
+
+# Stack type -> Terraform resource type. The only substrate-specific table.
+# As more L1s land, this grows; the L1 content + stack do not change.
+TYPE_MAP = {
+    "aws:s3:bucket": "aws_s3_bucket",
+    "aws:ec2:vpc": "aws_vpc",
+    "aws:ec2:subnet": "aws_subnet",
+    "aws:ec2:routetable": "aws_route_table",
+    "aws:ecs:cluster": "aws_ecs_cluster",
+    "aws:ecs:task_definition": "aws_ecs_task_definition",
+    "aws:ecs:service": "aws_ecs_service",
+    "aws:iam:role": "aws_iam_role",
+    "aws:elbv2:loadbalancer": "aws_lb",
+    "aws:elbv2:listener": "aws_lb_listener",
+    "aws:elbv2:targetgroup": "aws_lb_target_group",
+    "aws:ecr:repository": "aws_ecr_repository",
+    "aws:cloudfront:distribution": "aws_cloudfront_distribution",
+    "aws:cloudfront:originaccesscontrol": "aws_cloudfront_origin_access_control",
+    "aws:wafv2:webacl": "aws_wafv2_web_acl",
+    "aws:rds:instance": "aws_db_instance",
+    "aws:kms:key": "aws_kms_key",
+    "aws:kms:alias": "aws_kms_alias",
+    "aws:ecs:uptime-service": "aws_ecs_service",
+}
+
+# Stack input name -> Terraform arg name, per stack type. Only non-identity
+# mappings are listed; any input not present here uses the stack name as
+# the Terraform arg name (identity).
+INPUT_MAP = {
+    "aws:s3:bucket": {"bucket_name": "bucket"},
+    "aws:ec2:vpc": {"cidr": "cidr_block", "name": "_tag_name"},
+    "aws:ec2:subnet": {"cidr": "cidr_block", "az": "availability_zone", "name": "_tag_name", "vpc_id": "vpc_id"},
+    "aws:ec2:routetable": {"vpc_id": "vpc_id", "name": "_tag_name"},
+    "aws:ecs:cluster": {},
+    "aws:ecs:task_definition": {},
+    "aws:ecs:service": {"security_group": "security_groups", "subnets": "subnets", "cluster_arn": "cluster"},
+    "aws:iam:role": {"role_name": "name", "assume_role_policy": "assume_role_policy"},
+    "aws:elbv2:loadbalancer": {"subnets": "subnets", "security_group": "security_groups"},
+    "aws:elbv2:listener": {},
+    "aws:elbv2:targetgroup": {"port": "port", "protocol": "protocol"},
+    "aws:ecr:repository": {},
+    "aws:cloudfront:distribution": {"bucket_regional_domain_name": "origin_domain_name", "price_class": "price_class", "viewer_protocol_policy": "viewer_protocol_policy", "default_ttl": "default_ttl", "max_ttl": "max_ttl", "waf_web_acl_arn": "web_acl_id"},
+    "aws:cloudfront:originaccesscontrol": {"name": "name", "origin_type": "origin_access_control_origin_type", "signing_behavior": "origin_access_control_signing_behavior"},
+    "aws:wafv2:webacl": {"name": "name", "scope": "scope", "default_action": "default_action", "rules": "rules"},
+    "aws:rds:instance": {"db_name": "db_name", "instance_class": "instance_class", "allocated_storage": "allocated_storage", "engine": "engine", "engine_version": "engine_version", "username": "username", "multi_az": "multi_az", "storage_encrypted": "storage_encrypted"},
+    "aws:kms:key": {"description": "description", "deletion_window_days": "deletion_window_in_days"},
+    "aws:kms:alias": {},
+}
+
+# Stack output name -> Terraform attribute name, per stack type. Only
+# non-identity mappings are listed; any output not present here uses the
+# stack name as the Terraform attribute name (identity).
+OUTPUT_MAP = {
+    "aws:s3:bucket": {"bucket_arn": "arn", "bucket_name": "id"},
+    "aws:ec2:vpc": {"vpc_id": "id"},
+    "aws:ec2:subnet": {"subnet_ids": "id", "subnet_id": "id"},
+    "aws:ec2:routetable": {},
+    "aws:ecs:cluster": {"cluster_arn": "arn", "cluster_id": "id"},
+    "aws:ecs:task_definition": {"task_def_arn": "arn"},
+    "aws:ecs:service": {"service_arn": "id"},
+    "aws:iam:role": {"role_arn": "arn", "role_id": "id"},
+    "aws:elbv2:loadbalancer": {"lb_arn": "id"},
+    "aws:elbv2:listener": {"listener_arn": "id"},
+    "aws:elbv2:targetgroup": {"target_group_arn": "arn"},
+    "aws:ecr:repository": {"repository_arn": "arn"},
+    "aws:cloudfront:distribution": {"distribution_arn": "arn", "distribution_domain_name": "domain_name", "oac_id": "origin_access_control_id"},
+    "aws:cloudfront:originaccesscontrol": {"oac_id": "id"},
+    "aws:wafv2:webacl": {"web_acl_arn": "arn"},
+    "aws:rds:instance": {"db_endpoint": "endpoint", "db_arn": "arn"},
+    "aws:kms:key": {"kms_key_arn": "arn", "kms_key_id": "key_id"},
+    "aws:kms:alias": {},
+}
+
+
+def _tf_value(value):
+    """Render a Python value as a Terraform expression fragment."""
+    if isinstance(value, bool):
+        return "true" if value else "false"
+    if isinstance(value, (int, float)) and not isinstance(value, bool):
+        return str(value)
+    if isinstance(value, str):
+        if value.startswith("ref:"):
+            raise ValueError("ref: values must be resolved via _ref_expr, not _tf_value")
+        # Detect a JSON string (object/array) and emit jsonencode() so inner
+        # quotes don't break HCL. Plain strings stay double-quoted.
+        stripped = value.lstrip()
+        if stripped and stripped[0] in "{[" :
+            try:
+                parsed = json.loads(value)
+                if isinstance(parsed, (dict, list)):
+                    return f"jsonencode({json.dumps(parsed, sort_keys=True)})"
+            except json.JSONDecodeError:
+                pass
+        return f'"{value}"'
+    if isinstance(value, (dict, list)):
+        return f"jsonencode({json.dumps(value, sort_keys=True)})"
+    raise ValueError(f"unsupported input value type {type(value).__name__}")
+
+
+def _ref_expr(ref_value, type_by_id):
+    """Translate a "ref:<stack_resource_id>.<output>" string to a Terraform
+    interpolation "${<tf_type>.<id>.<attr>}".
+
+    <stack_resource_id> is the stack resource id of the producing resource;
+    <output> is the per-resource output name (e.g. `subnet_id`,
+    `cluster_arn`); the attribute is mapped through OUTPUT_MAP for the
+    referenced resource's stack type. The resolver emits the ref using the
+    stack resource id directly (not the child id), so no child->resource
+    lookup table is needed here.
+    """
+    body = ref_value[len("ref:"):]
+    rid, out_name = body.split(".", 1)
+    rtype = type_by_id.get(rid)
+    if not rtype:
+        raise ValueError(f"ref to unknown stack resource id {rid!r}")
+    tf_type = TYPE_MAP.get(rtype)
+    if not tf_type:
+        raise ValueError(f"ref target {rid!r} has unknown stack type {rtype!r}")
+    out_map = OUTPUT_MAP.get(rtype, {})
+    tf_attr = out_map.get(out_name, out_name)
+    return f"{tf_type}.{rid}.{tf_attr}"
+
+
+def _value_expr(value, type_by_id=None):
+    """Render a value as a Terraform expression fragment. A "ref:<id>.<output>"
+    string becomes a Terraform interpolation; other values use _tf_value."""
+    if isinstance(value, str) and value.startswith("ref:"):
+        if type_by_id is None:
+            raise ValueError("ref: value encountered without a type_by_id table")
+        return _ref_expr(value, type_by_id)
+    return _tf_value(value)
+
+
+def _emit_resource(resource, type_by_id=None):
+    rtype = resource["type"]
+    rid = resource["id"]
+    tf_type = TYPE_MAP.get(rtype)
+    if not tf_type:
+        raise ValueError(f"unknown stack type {rtype!r} (adapter TYPE_MAP has no entry)")
+    in_map = INPUT_MAP.get(rtype, {})
+    body = []
+    inputs = resource.get("inputs", {})
+    for in_name, value in inputs.items():
+        if in_name == "region":
+            continue
+        arg = in_map.get(in_name, in_name)
+        if arg == "_tag_name":
+            if isinstance(value, str) and not value.startswith("ref:"):
+                tag_name = value
+            else:
+                tag_name = "app"
+            continue
+        if rtype == "aws:ecs:task_definition" and in_name in ("image", "port", "env"):
+            continue
+        if rtype == "aws:iam:role" and in_name == "managed_policies":
+            continue
+        if rtype == "aws:elbv2:loadbalancer" and in_name == "subnets":
+            if isinstance(value, str) and value.startswith("ref:"):
+                body.append(f"subnets = [{_ref_expr(value, type_by_id)}]")
+            else:
+                body.append(f"subnets = [{value}]" if isinstance(value, str) else f"subnets = {_tf_value(value)}")
+            continue
+        if rtype == "aws:elbv2:loadbalancer" and in_name == "security_group":
+            if isinstance(value, str) and value.startswith("ref:"):
+                body.append(f"security_groups = [{_ref_expr(value, type_by_id)}]")
+            else:
+                body.append(f"security_groups = [{value}]" if isinstance(value, str) else f"security_groups = {_tf_value(value)}")
+            continue
+        if rtype == "aws:ec2:routetable" and in_name == "igw_id":
+            continue
+        if rtype == "aws:ecs:service" and in_name == "lb_target_group_arn":
+            if isinstance(value, str) and value.startswith("ref:"):
+                tg_arn = _ref_expr(value, type_by_id)
+            else:
+                tg_arn = _tf_value(value)
+            body.append("load_balancer {")
+            body.append(f"  target_group_arn = {tg_arn}")
+            body.append("  container_name = \"app\"")
+            body.append("  container_port = 8080")
+            body.append("}")
+            continue
+        if rtype == "aws:ecs:service" and in_name in ("subnets", "security_group"):
+            # Collected into network_configuration block (emitted after all inputs).
+            continue
+        if rtype == "aws:cloudfront:distribution" and in_name in (
+            "bucket_regional_domain_name", "price_class", "viewer_protocol_policy",
+            "default_ttl", "max_ttl", "waf_web_acl_arn", "oac_id",
+        ):
+            # Collected into the origin/default_cache_behavior/web_acl_id blocks
+            # emitted after all inputs.
+            continue
+        if rtype == "aws:cloudfront:originaccesscontrol" and in_name in (
+            "name", "origin_type", "signing_behavior",
+        ):
+            # Defaults emitted after all inputs.
+            continue
+        if rtype == "aws:wafv2:webacl" and in_name in (
+            "name", "scope", "default_action", "rules",
+        ):
+            # Structured blocks emitted after all inputs.
+            continue
+        body.append(f"{arg} = {_value_expr(value, type_by_id)}")
+    if rtype == "aws:ecs:service":
+        subnets_val = inputs.get("subnets")
+        sg_val = inputs.get("security_group")
+        body.append("network_configuration {")
+        body.append("  subnets = " + (
+            f"[{_ref_expr(subnets_val, type_by_id)}]" if isinstance(subnets_val, str) and subnets_val.startswith("ref:")
+            else _tf_value([subnets_val] if isinstance(subnets_val, str) else subnets_val or [])
+        ))
+        body.append("  security_groups = " + (
+            f"[{_ref_expr(sg_val, type_by_id)}]" if isinstance(sg_val, str) and sg_val.startswith("ref:")
+            else _tf_value([sg_val] if isinstance(sg_val, str) else sg_val or [])
+        ))
+        body.append("}")
+        desired = inputs.get("desired_count", 1)
+        launch = inputs.get("launch_type", "FARGATE")
+        body.append(f"desired_count = {desired}")
+        body.append(f'launch_type = "{launch}"')
+        body.append("task_definition = aws_ecs_task_definition.service-taskdefinition.arn")
+        body.append("name = \"acdl-microservice\"")
+    nfrs = resource.get("nfrs", {})
+    if isinstance(nfrs, dict) and "versioning" in nfrs and rtype == "aws:s3:bucket":
+        versioning = nfrs.get("versioning", True)
+        body.append("versioning {")
+        body.append(f'  enabled = {"true" if versioning else "false"}')
+        body.append("}")
+    elif rtype == "aws:s3:bucket":
+        body.append("versioning {")
+        body.append("  enabled = true")
+        body.append("}")
+    if rtype == "aws:ecs:task_definition":
+        body.append(_container_definitions(inputs))
+        family = inputs.get("family", "app")
+        body.append(f'family = "{family}"')
+    if rtype in ("aws:ec2:vpc", "aws:ec2:subnet") and "_tag_name" in in_map.values():
+        tag_name = inputs.get("name", "acdl")
+        if isinstance(tag_name, str) and not tag_name.startswith("ref:"):
+            body.append("tags = {")
+            body.append(f'  Name = "{tag_name}"')
+            body.append("}")
+    if rtype == "aws:iam:role" and "managed_policies" in inputs:
+        arns = [a.strip() for a in str(inputs["managed_policies"]).split(",") if a.strip()]
+        body.append("managed_policy_arns = [" + ", ".join(f'"{a}"' for a in arns) + "]")
+    if rtype == "aws:elbv2:listener":
+        body.append("default_action {")
+        body.append("  type = \"forward\"")
+        body.append("  target_group_arn = aws_lb_target_group.alb-targetgroup.arn")
+        body.append("}")
+        body.append("load_balancer_arn = aws_lb.alb-loadbalancer.id")
+    if rtype == "aws:elbv2:loadbalancer":
+        lb_type = inputs.get("load_balancer_type", "application")
+        body.append(f'load_balancer_type = "{lb_type}"')
+    if rtype == "aws:elbv2:targetgroup":
+        tgt_type = inputs.get("target_type", "ip")
+        body.append(f'target_type = "{tgt_type}"')
+        body.append("vpc_id = aws_vpc.vpc-vpc.id")
+        body.append("protocol = \"HTTP\"")
+    if rtype == "aws:ec2:routetable":
+        body.append("route {")
+        body.append("  cidr_block = \"0.0.0.0/0\"")
+        body.append("  gateway_id = aws_internet_gateway.vpc-igw.id")
+        body.append("}")
+        body.append("tags = {")
+        rt_name = inputs.get("name", "app")
+        body.append(f'  Name = "{rt_name}-rt"')
+        body.append("}")
+    if rtype == "aws:cloudfront:originaccesscontrol":
+        name = inputs.get("name", "acdl-oac")
+        if isinstance(name, str) and name.startswith("ref:"):
+            name = _ref_expr(name, type_by_id)
+        else:
+            name = _tf_value(name)
+        body.append(f"name = {name}")
+        body.append("origin_access_control_origin_type = \"s3\"")
+        body.append("origin_access_control_signing_behavior = \"always\"")
+    if rtype == "aws:cloudfront:distribution":
+        origin_domain = inputs.get("bucket_regional_domain_name")
+        if isinstance(origin_domain, str) and origin_domain.startswith("ref:"):
+            origin_domain = _ref_expr(origin_domain, type_by_id)
+        else:
+            origin_domain = _tf_value(origin_domain)
+        # The OAC resource id follows the convention "<childId>-originaccesscontrol";
+        # derive it from this distribution's id.
+        if rid.endswith("-distribution"):
+            oac_rid = rid[: -len("distribution")] + "originaccesscontrol"
+        else:
+            oac_rid = "cloudfront-originaccesscontrol"
+        body.append("origin {")
+        body.append(f"  domain_name = {origin_domain}")
+        body.append(f"  origin_access_control = aws_cloudfront_origin_access_control.{oac_rid}.id")
+        body.append("  s3_origin_config {}")
+        body.append("}")
+        body.append("enabled = true")
+        price_class = inputs.get("price_class", "PriceClass_100")
+        vpp = inputs.get("viewer_protocol_policy", "redirect-to-https")
+        default_ttl = inputs.get("default_ttl", 3600)
+        max_ttl = inputs.get("max_ttl", 86400)
+        body.append("default_cache_behavior {")
+        body.append(f"  viewer_protocol_policy = {_value_expr(vpp, type_by_id)}")
+        body.append(f"  target_origin_id = {_tf_value(rid)}")
+        body.append("  min_ttl = 0")
+        body.append(f"  default_ttl = {_value_expr(default_ttl, type_by_id)}")
+        body.append(f"  max_ttl = {_value_expr(max_ttl, type_by_id)}")
+        body.append("  allowed_methods = [\"GET\", \"HEAD\"]")
+        body.append("  cached_methods = [\"GET\", \"HEAD\"]")
+        body.append("}")
+        body.append(f"price_class = {_value_expr(price_class, type_by_id)}")
+        body.append("restrictions {")
+        body.append("  geo_restriction {")
+        body.append("    restriction_type = \"none\"")
+        body.append("  }")
+        body.append("}")
+        body.append("viewer_certificate {")
+        body.append("  cloudfront_default_certificate = true")
+        body.append("}")
+        waf_arn = inputs.get("waf_web_acl_arn")
+        if waf_arn is not None:
+            if isinstance(waf_arn, str) and waf_arn.startswith("ref:"):
+                waf_expr = _ref_expr(waf_arn, type_by_id)
+            else:
+                waf_expr = _tf_value(waf_arn)
+            body.append(f"web_acl_id = {waf_expr}")
+    if rtype == "aws:wafv2:webacl":
+        name = inputs.get("name", "acdl-waf")
+        body.append(f"name = {_tf_value(name) if not isinstance(name, str) or not name.startswith('ref:') else _ref_expr(name, type_by_id)}")
+        body.append("scope = \"cloudfront\"")
+        # P1-5: Honor default_action input instead of hardcoding allow {}.
+        default_action_input = inputs.get("default_action", "allow")
+        if isinstance(default_action_input, str) and default_action_input.startswith("ref:"):
+            default_action_input = "allow"
+        action_type = default_action_input if default_action_input in ("allow", "block") else "allow"
+        body.append("default_action {")
+        body.append(f"  {action_type} {{}}")
+        body.append("}")
+        body.append("visibility_config {")
+        body.append("  cloudwatch_metrics_enabled = true")
+        body.append("  metric_name = \"acdl-waf-metrics\"")
+        body.append("  sampled_requests_enabled = true")
+        body.append("}")
+        # P1-4: Emit custom rules as nested blocks, not an attribute assignment.
+        rules_input = inputs.get("rules")
+        if rules_input and isinstance(rules_input, list):
+            for idx, rule in enumerate(rules_input):
+                if not isinstance(rule, dict):
+                    continue
+                rule_name = rule.get("name", f"custom-rule-{idx}")
+                rule_priority = rule.get("priority", idx)
+                body.append("rules {")
+                body.append(f"  name = {_tf_value(rule_name)}")
+                body.append(f"  priority = {_tf_value(rule_priority)}")
+                override = rule.get("override_action", "none")
+                if override not in ("none", "count"):
+                    override = "none"
+                body.append("  override_action {")
+                body.append(f"    {override} {{}}")
+                body.append("  }")
+                statement = rule.get("statement", {})
+                if statement:
+                    body.append("  statement {")
+                    for sk, sv in statement.items():
+                        body.append(f"    {sk} {{")
+                        if isinstance(sv, dict):
+                            for sk2, sv2 in sv.items():
+                                body.append(f"      {sk2} = {_tf_value(sv2)}")
+                        body.append("    }")
+                    body.append("  }")
+                body.append("  visibility_config {")
+                body.append("    cloudwatch_metrics_enabled = true")
+                body.append(f"    metric_name = {_tf_value(f'{rule_name}-metrics')}")
+                body.append("    sampled_requests_enabled = true")
+                body.append("  }")
+                body.append("}")
+        elif rules_input and isinstance(rules_input, str) and rules_input.startswith("ref:"):
+            # A ref: value for rules — emit as dynamic block reference (rare case).
+            body.append(f"rules = {_ref_expr(rules_input, type_by_id)}")
+        else:
+            # Default: emit the AWS-managed-rules block when no custom rules.
+            body.append("rules {")
+            body.append("  name = \"aws-managed-rules\"")
+            body.append("  priority = 0")
+            body.append("  override_action {")
+            body.append("    none {}")
+            body.append("  }")
+            body.append("  statement {")
+            body.append("    managed_rule_group_statement {")
+            body.append("      name = \"AWSManagedRulesCommonRuleSet\"")
+            body.append("      vendor_name = \"AWS\"")
+            body.append("    }")
+            body.append("  }")
+            body.append("  visibility_config {")
+            body.append("    cloudwatch_metrics_enabled = true")
+            body.append("    metric_name = \"aws-managed-rules-metrics\"")
+            body.append("    sampled_requests_enabled = true")
+            body.append("  }")
+            body.append("}")
+    if rtype == "aws:rds:instance":
+        # Emit NFR-derived arguments: backup_retention_period +
+        # deletion_protection from the nfrs block. Also emit
+        # storage_encrypted = true (from inputs, already emitted above if
+        # present) and skip_final_snapshot = true for dev safety.
+        nfrs = resource.get("nfrs", {})
+        backup_retention = nfrs.get("backup_retention_period", 7)
+        deletion_protection = nfrs.get("deletion_protection", True)
+        body.append(f"backup_retention_period = {_tf_value(backup_retention)}")
+        body.append(f"deletion_protection = {_tf_value(deletion_protection)}")
+        # Ensure storage_encrypted is emitted (defaults to true if not in inputs).
+        if "storage_encrypted" not in inputs:
+            body.append("storage_encrypted = true")
+        # Dev safety: skip the final snapshot so `terraform destroy` works
+        # without a final DB snapshot (overridden by deletion_protection).
+        body.append("skip_final_snapshot = true")
+    if rtype == "aws:kms:key":
+        nfrs = resource.get("nfrs", {})
+        enable_rotation = nfrs.get("enable_rotation", True)
+        body.append(f"enable_key_rotation = {_tf_value(enable_rotation)}")
+    if rtype == "aws:s3:bucket":
+        nfrs = resource.get("nfrs", {})
+        encryption_enabled = nfrs.get("encryption_enabled", True)
+        if encryption_enabled:
+            kms_key_arn = inputs.get("kms_key_arn")
+            if kms_key_arn and isinstance(kms_key_arn, str) and kms_key_arn.startswith("ref:"):
+                kms_ref = _ref_expr(kms_key_arn, type_by_id)
+                body.append("server_side_encryption_configuration {")
+                body.append("  rule {")
+                body.append("    apply_server_side_encryption_by_default {")
+                body.append(f"      sse_algorithm = \"aws:kms\"")
+                body.append(f"      kms_master_key_id = {kms_ref}")
+                body.append("    }")
+                body.append("  }")
+                body.append("}")
+            elif kms_key_arn:
+                body.append("server_side_encryption_configuration {")
+                body.append("  rule {")
+                body.append("    apply_server_side_encryption_by_default {")
+                body.append("      sse_algorithm = \"aws:kms\"")
+                body.append(f"      kms_master_key_id = {_tf_value(kms_key_arn)}")
+                body.append("    }")
+                body.append("  }")
+                body.append("}")
+            else:
+                print(f"WARNING: s3 bucket {rid} has no kms_key_arn — falling back to AWS-managed key (alias/aws/s3)", file=sys.stderr)
+                body.append("server_side_encryption_configuration {")
+                body.append("  rule {")
+                body.append("    apply_server_side_encryption_by_default {")
+                body.append("      sse_algorithm = \"aws:kms\"")
+                body.append("    }")
+                body.append("  }")
+                body.append("}")
+    if rtype == "aws:ecs:uptime-service":
+        feature_flag = inputs.get("feature_flag_enabled", True)
+        if not feature_flag:
+            return ""
+        container_image = inputs.get("container_image", "louislam/uptime-kuma:1")
+        monitored = inputs.get("monitored_endpoints", [])
+        static_checks = inputs.get("static_checks", [])
+        alert_channels = inputs.get("alert_channels", {})
+        all_checks = (monitored if isinstance(monitored, list) else []) + \
+                     (static_checks if isinstance(static_checks, list) else [])
+        env_vars = {
+            "UPTIME_KUMA_MONITOR_CONFIG": json.dumps(all_checks),
+            "UPTIME_KUMA_ALERT_CONFIG": json.dumps(alert_channels),
+        }
+        desired = inputs.get("desired_count", 1)
+        launch = inputs.get("launch_type", "FARGATE")
+        body.append(f"desired_count = {desired}")
+        body.append(f'launch_type = "{launch}"')
+        body.append("network_configuration {")
+        body.append("  subnets = [\"subnet-uptime\"]")
+        body.append("  security_groups = [\"sg-uptime\"]")
+        body.append("  assign_public_ip = true")
+        body.append("}")
+        container = {
+            "name": "uptime-kuma",
+            "image": container_image,
+            "essential": True,
+            "portMappings": [{"containerPort": 3001, "hostPort": 3001}],
+            "environment": [{"name": k, "value": v} for k, v in env_vars.items()],
+            "logConfiguration": {"logDriver": "awslogs", "options": {"awslogs-group": "/acdl/uptime", "awslogs-region": inputs.get("region", "us-east-1")}},
+        }
+        body.append("container_definitions = " + _tf_value([container]))
+    nfrs = resource.get("nfrs", {})
+    deletion_protection = nfrs.get("deletion_protection", True)
+    if deletion_protection:
+        body.append("lifecycle {")
+        body.append("  prevent_destroy = true")
+        body.append("}")
+    return _resource_block(rid, tf_type, body)
+
+
+def _emit_igw(resources):
+    """Emit an internet gateway + route table associations for the VPC."""
+    vpc_id = next((r["id"] for r in resources if r["type"] == "aws:ec2:vpc"), "vpc-vpc")
+    subnet_id = next((r["id"] for r in resources if r["type"] == "aws:ec2:subnet"), "vpc-subnet")
+    rt_id = next((r["id"] for r in resources if r["type"] == "aws:ec2:routetable"), "vpc-routetable")
+    vpc_res = next((r for r in resources if r["type"] == "aws:ec2:vpc"), None)
+    igw_name = (vpc_res.get("inputs", {}).get("name", "app") if vpc_res else "app")
+    parts = []
+    parts.append(_resource_block("vpc-igw", "aws_internet_gateway", [
+        f"vpc_id = aws_vpc.{vpc_id}.id",
+        "tags = {",
+        f'  Name = "{igw_name}-igw"',
+        "}",
+    ]))
+    parts.append(_resource_block("vpc-rta", "aws_route_table_association", [
+        f"subnet_id = aws_subnet.{subnet_id}.id",
+        f"route_table_id = aws_route_table.{rt_id}.id",
+    ]))
+    return "\n".join(parts)
+
+
+def _container_definitions(inputs):
+    image = inputs.get("image", "")
+    port = inputs.get("port", 80)
+    env_raw = inputs.get("env")
+    environment = []
+    if isinstance(env_raw, dict):
+        for k, v in env_raw.items():
+            environment.append({"name": k, "value": str(v)})
+    elif isinstance(env_raw, str) and env_raw:
+        try:
+            parsed = json.loads(env_raw)
+            if isinstance(parsed, dict):
+                for k, v in parsed.items():
+                    environment.append({"name": k, "value": str(v)})
+        except json.JSONDecodeError:
+            pass
+    container = {
+        "name": "app",
+        "image": image,
+        "essential": True,
+        "portMappings": [{"containerPort": port}],
+    }
+    if environment:
+        container["environment"] = environment
+    return "container_definitions = " + _tf_value([container])
+
+
+def _resource_block(rid, tf_type, body):
+    """Emit a top-level resource block."""
+    head = f'resource "{tf_type}" "{rid}" {{'
+    body_str = "\n".join(f"  {l}" for l in body)
+    return f"{head}\n{body_str}\n}}\n"
+
+
+def _emit_output(output_name, value_expr):
+    return f'output "{output_name}" {{\n  value = {value_expr}\n}}\n'
+
+
+def adapt(stack_instance, out_dir):
+    """Emit main.tf + terraform.tf + providers.tf to out_dir for the stack instance."""
+    os.makedirs(out_dir, exist_ok=True)
+    stack = stack_instance["stack"]
+    resources = stack_instance["resources"]
+
+    # --- providers.tf: aws provider, region from the first resource's inputs.region ---
+    region = "us-east-1"
+    for r in resources:
+        if "region" in r.get("inputs", {}):
+            region = r["inputs"]["region"]
+            break
+    providers_tf = (
+        f'provider "aws" {{\n'
+        f'  region = "{region}"\n'
+        f'}}\n'
+    )
+
+    # --- terraform.tf: required_version + required_providers + S3 backend (no DynamoDB lock per D-P09-1) ---
+    # The backend key is derived from the stack name so l1 vs l2 spikes use separate state keys (D-P10-1).
+    stack_name = stack.get("name", "spike")
+    terraform_tf = (
+        'terraform {\n'
+        '  required_version = ">= 1.9, < 1.10"\n'
+        '  required_providers {\n'
+        '    aws = {\n'
+        '      source  = "hashicorp/aws"\n'
+        '      version = "~> 5.0"\n'
+        '    }\n'
+        '  }\n'
+        '  backend "s3" {\n'
+        '    bucket = "acdl-tfstate-581513795199-us-east-1"\n'
+        f'    key    = "spike/{stack_name}/terraform.tfstate"\n'
+        '    region = "us-east-1"\n'
+        '  }\n'
+        '}\n'
+    )
+
+    # --- main.tf: resources + outputs ---
+    # Build a stack-resource-id -> stack-type table so `ref:` input values can
+    # be resolved to Terraform interpolations without a child->resource
+    # lookup (the resolver emits refs with the stack resource id directly).
+    type_by_id = {r["id"]: r["type"] for r in resources}
+    main_tf_parts = []
+    has_vpc = any(r["type"] == "aws:ec2:vpc" for r in resources)
+    for r in resources:
+        main_tf_parts.append(_emit_resource(r, type_by_id))
+        rid = r["id"]
+        rtype = r["type"]
+        tf_type = TYPE_MAP.get(rtype)
+        out_map = OUTPUT_MAP.get(rtype, {})
+        outputs = r.get("outputs", {})
+        for out_name in outputs:
+            tf_attr = out_map.get(out_name, out_name)
+            main_tf_parts.append(_emit_output(out_name, f"{tf_type}.{rid}.{tf_attr}"))
+    if has_vpc:
+        main_tf_parts.append(_emit_igw(resources))
+    # P1-7: Emit stack-level outputs from the resolved composition outputs[].
+    # Each stack output has {"from": <resourceId>, "output": <outputName>}.
+    # We look up the resource type + OUTPUT_MAP to build the interpolation.
+    stack_outputs = stack_instance.get("outputs", {})
+    for out_name, out_spec in stack_outputs.items():
+        src_rid = out_spec.get("from", "")
+        src_output = out_spec.get("output", out_name)
+        if src_rid in type_by_id:
+            src_rtype = type_by_id[src_rid]
+            src_tf_type = TYPE_MAP.get(src_rtype, src_rtype.replace(":", "_"))
+            out_map = OUTPUT_MAP.get(src_rtype, {})
+            tf_attr = out_map.get(src_output, src_output)
+            main_tf_parts.append(_emit_output(out_name, f"{src_tf_type}.{src_rid}.{tf_attr}"))
+    main_tf = "\n".join(main_tf_parts)
+
+    with open(os.path.join(out_dir, "main.tf"), "w") as fh:
+        fh.write(main_tf)
+    with open(os.path.join(out_dir, "terraform.tf"), "w") as fh:
+        fh.write(terraform_tf)
+    with open(os.path.join(out_dir, "providers.tf"), "w") as fh:
+        fh.write(providers_tf)
+    return out_dir
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        print("usage: adapter.py <instance.json> <out_dir>", file=sys.stderr)
+        sys.exit(2)
+    with open(sys.argv[1], "r") as fh:
+        stack = json.load(fh)
+    adapt(stack, sys.argv[2])
+    print(f"adapter: emitted terraform to {sys.argv[2]}", file=sys.stderr)

adapters/terraform/policy/checkov_adapter.py

@@ -0,0 +1,90 @@
+"""Translate Checkov JSON output to ACDL PolicyCheckResult records.
+
+Reads Checkov's JSON output (one framework key, e.g. terraform_plan),
+emits a list of PolicyCheckResult dicts conforming to
+schemas/policy_check_result.schema.json. Run Checkov with --soft-fail so
+Checkov never exits non-zero; the confidence signal decides the gate, not
+Checkov's exit code.
+
+The ACDL tagging standard (D-054, D-043 closure) is enforced by a custom
+Checkov rule at adapters/terraform/policy/custom_rules/acdl_tagging.py,
+loaded via --external-checks-dir. The adapter therefore maps
+ACDL_TAG_NAMING as a real rule (no synthetic SKIPPED record is emitted).
+"""
+
+import datetime
+import json
+import sys
+
+
+RULE_MAP = {
+    "CKV_AWS_41": ("secrets-in-plaintext", "high"),
+    "CKV_AWS_45": ("secrets-in-plaintext", "high"),
+    "CKV_AWS_46": ("secrets-in-plaintext", "high"),
+    "CKV_AWS_20": ("public-ingress", "high"),
+    "CKV_AWS_57": ("public-ingress", "high"),
+    "CKV_AWS_24": ("public-ingress", "medium"),
+    "CKV_AWS_25": ("public-ingress", "medium"),
+    "CKV_AWS_1": ("iam-wildcard", "high"),
+    "CKV_AWS_40": ("iam-wildcard", "medium"),
+    "CKV_AWS_7": ("kms-key-reference", "medium"),
+    "CKV_AWS_33": ("kms-key-reference", "medium"),
+    # D-054 / D-043 closure: ACDL_TAG_NAMING is now a real custom Checkov
+    # rule (adapters/terraform/policy/custom_rules/acdl_tagging.py), loaded
+    # via --external-checks-dir. No synthetic SKIPPED record is emitted.
+    "ACDL_TAG_NAMING": ("tagging-standard", "medium"),
+}
+
+_RESULT_MAP = {"PASSED": "pass", "FAILED": "fail", "SKIPPED": "skipped"}
+
+
+def _iso8601_now():
+    return datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def _to_pcr(checkov_record, contract_id, result_str):
+    check_id = checkov_record.get("check_id", "")
+    default_sev = RULE_MAP.get(check_id, (check_id, "info"))[1]
+    severity = checkov_record.get("severity", default_sev)
+    if isinstance(severity, str):
+        severity = severity.lower()
+    return {
+        "contractId": contract_id,
+        "evaluatedAt": _iso8601_now(),
+        "engine": "checkov",
+        "ruleId": check_id,
+        "severity": severity,
+        "result": _RESULT_MAP.get(result_str, "error"),
+        "message": checkov_record.get("check_name", ""),
+        "evidence": {
+            "file_path": checkov_record.get("file_path"),
+            "resource": checkov_record.get("resource"),
+            "resource_address": checkov_record.get("resource_address"),
+            "code_block": checkov_record.get("code_block"),
+        },
+        "resourceRef": checkov_record.get("resource_address") or checkov_record.get("resource", ""),
+    }
+
+
+def adapt(checkov_json_path, contract_id):
+    with open(checkov_json_path, "r", encoding="utf-8") as fh:
+        data = json.load(fh)
+    out = []
+    for framework, body in data.items():
+        results = body.get("results", body) if isinstance(body, dict) else {}
+        if not isinstance(results, dict):
+            continue
+        for rec in results.get("passed_checks", []):
+            out.append(_to_pcr(rec, contract_id, "PASSED"))
+        for rec in results.get("failed_checks", []):
+            out.append(_to_pcr(rec, contract_id, "FAILED"))
+        for rec in results.get("skipped_checks", []):
+            out.append(_to_pcr(rec, contract_id, "SKIPPED"))
+    return out
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        print("usage: checkov_adapter.py <checkov.json> <contract-id>", file=sys.stderr)
+        sys.exit(2)
+    print(json.dumps(adapt(sys.argv[1], sys.argv[2]), indent=2))

adapters/terraform/policy/custom_rules/README.md

@@ -0,0 +1,34 @@
+# ACDL Custom Checkov Rules
+
+This directory holds ACDL-authored Checkov custom rules, written in the
+[Checkov Python custom-rule framework](https://www.checkov.io/4.Contributing/Custom%20Policies.html).
+
+## Files
+
+- `acdl_tagging.py` — `ACDL_TAG_NAMING` (D-054): ensures every taggable AWS
+  resource carries the four required ACDL tags
+  (`acdl:owner`, `acdl:contract`, `acdl:environment`, `acdl:cost-center`).
+  This rule replaces the synthetic SKIPPED `ACDL_TAG_NAMING` record that the
+  Checkov adapter previously emitted (D-043 closure). The canonical tag set
+  is declared in [`schemas/tagging-standard.json`](../../../schemas/tagging-standard.json).
+
+## How Checkov loads them
+
+Checkov custom rules are discovered via the `--external-checks-dir` flag.
+`scripts/run_platform.sh` invokes Checkov with:
+
+```
+checkov -f terraform/spike/main.tf --framework terraform -o json --soft-fail \
+        --external-checks-dir adapters/terraform/policy/custom_rules/
+```
+
+Checkov imports each `*.py` file in the directory and instantiates the
+module-level `check` object (see the `check = AcdlTaggingStandard()` line at
+the bottom of `acdl_tagging.py`).
+
+## Severity / result mapping
+
+The Checkov adapter (`adapters/terraform/policy/checkov_adapter.py`)
+maps `ACDL_TAG_NAMING` to `(tagging-standard, medium)` in `RULE_MAP`. The
+custom rule therefore produces real `PASS`/`FAIL` PolicyCheckResult records,
+feeding the confidence signal instead of the old SKIPPED placeholder.

adapters/terraform/policy/custom_rules/acdl_tagging.py

@@ -0,0 +1,54 @@
+"""ACDL tagging standard custom Checkov rule (D-054).
+
+Checks that all taggable AWS resources have the required ACDL tags:
+  acdl:owner, acdl:contract, acdl:environment, acdl:cost-center
+
+Fails (severity medium) when any required tag is missing.
+Closes the D-043 deferral (the SKIPPED ACDL_TAG_NAMING placeholder
+becomes a real check).
+"""
+
+from __future__ import annotations
+
+from checkov.terraform.checks.resource.base_resource_check import BaseResourceCheck
+from checkov.common.models.enums import CheckResult, CheckCategories
+
+REQUIRED_TAGS = ("acdl:owner", "acdl:contract", "acdl:environment", "acdl:cost-center")
+
+# Resources that support tags (exclude resources that have no tags attribute)
+NON_TAGGABLE_TYPES = (
+    "aws_cloudfront_origin_access_control",
+    "aws_lambda_function_url",
+    "aws_route_table_association",
+    "aws_internet_gateway",
+)
+
+class AcdlTaggingStandard(BaseResourceCheck):
+    def __init__(self):
+        name = "Ensure all taggable AWS resources have required ACDL tags"
+        check_id = "ACDL_TAG_NAMING"
+        supported_resources = ["*"]  # all resources
+        categories = [CheckCategories.GENERAL_SECURITY]
+        super().__init__(name=name, check_id=check_id, categories=categories, supported_resources=supported_resources)
+
+    def scan_resource_conf(self, conf, entity_type):
+        # Skip non-taggable resources
+        if entity_type in NON_TAGGABLE_TYPES:
+            return CheckResult.PASSED
+        # Check for a tags block
+        tags = conf.get("tags")
+        if not tags:
+            return CheckResult.FAILED
+        tag_keys = set()
+        if isinstance(tags, list) and tags:
+            tag_block = tags[0]
+            if isinstance(tag_block, dict):
+                tag_keys = set(tag_block.keys())
+        elif isinstance(tags, dict):
+            tag_keys = set(tags.keys())
+        missing = [t for t in REQUIRED_TAGS if t not in tag_keys]
+        if missing:
+            return CheckResult.FAILED
+        return CheckResult.PASSED
+
+check = AcdlTaggingStandard()

adapters/wiz/README.md

@@ -0,0 +1,55 @@
+# Wiz Adapter
+
+The Wiz adapter translates Wiz API issue records to the normalized ACDL
+[`PolicyCheckResult`](../../schemas/policy_check_result.schema.json) schema
+(engine: `"wiz"`), mirroring the Checkov adapter pattern.
+
+## What Wiz is
+
+[Wiz](https://www.wiz.io/) is a cloud security SaaS platform that
+continuously scans CSPM / CWPP / KSPM findings across AWS, Azure, GCP and
+Kubernetes. It exposes a GraphQL/REST API for fetching issue records.
+
+## Adapter behaviour
+
+`wiz_adapter.py <wiz_issues.json> <contract-id>` reads a JSON file of Wiz
+issue records (the shape returned by the Wiz `issues` GraphQL query /
+list endpoint) and emits a list of `PolicyCheckResult` dicts:
+
+| Wiz field        | PolicyCheckResult field                                   |
+|------------------|------------------------------------------------------------|
+| `id` / `control.id` | `ruleId`                                               |
+| `severity`       | `severity` (mapped `CRITICAL/HIGH/MEDIUM/LOW/INFO`)        |
+| `status`         | `result` (`OPEN→fail`, `RESOLVED→pass`, `IN_PROGRESS/DISMISSED→skipped`) |
+| `title` / `control.name` | `message`                                            |
+| `entity.id`      | `resourceRef` + `evidence.resource`                       |
+| `entity.{name,cloudPlatform,subscriptionId}` | `evidence.*`                |
+
+The adapter is read-only against a local JSON fixture; the pipeline is
+responsible for fetching from Wiz (when configured) and writing the file.
+
+## Offline / degraded behaviour (D-052)
+
+When Wiz is not configured the pipeline passes an empty issues payload (or
+simply does not invoke the adapter). The adapter degrades gracefully:
+
+- an empty `issues` list → the adapter emits a single `WIZ_NOT_CONFIGURED`
+  `PolicyCheckResult` with `result: "skipped"` so the confidence policy
+  input stays non-empty (and does not falsely inflate the score).
+
+`is_configured()` returns `True` only when the `WIZ_API_TOKEN`
+environment variable is set; the pipeline uses it to decide whether to
+fetch and invoke the adapter at all.
+
+## Configuration
+
+| Env var          | Required | Purpose                                          |
+|-----------------|----------|--------------------------------------------------|
+| `WIZ_API_TOKEN`  | yes      | Bearer token for the Wiz REST API. When unset, `is_configured()` returns `False`. |
+| `WIZ_ENDPOINT`   | no       | Wiz API endpoint (defaults to `https://api.wiz.io` when implemented). |
+
+## Schema path
+
+The output records validate against
+[`schemas/policy_check_result.schema.json`](../../schemas/policy_check_result.schema.json)
+(`engine: "wiz"` was added to the enum in Phase 23).

adapters/wiz/wiz_adapter.py

@@ -0,0 +1,193 @@
+"""Wiz adapter — translate Wiz API results to ACDL PolicyCheckResult records.
+
+Wiz is a SaaS security platform with a GraphQL API. This adapter
+translates Wiz issue records to the normalized PolicyCheckResult schema
+(engine: "wiz"), matching the Checkov adapter pattern.
+
+v1.9 (REQ-110): the adapter is a real API client. `WizClient` queries the
+Wiz GraphQL API (`<WIZ_API_URL>/graphql`, Bearer auth, `issues` query)
+and translates results → PolicyCheckResult records. It degrades
+gracefully (single `SKIPPED` `WIZ_NOT_CONFIGURED` record) when
+`WIZ_API_TOKEN` or `WIZ_API_URL` is unset (D-052). Pagination is handled
+via `pageInfo.hasNextPage` + `endCursor`. Offline tests use a recorded
+GraphQL fixture.
+
+CLI: wiz_adapter.py <wiz_issues.json> <contract-id>
+"""
+
+import datetime
+import json
+import os
+import sys
+
+
+SEVERITY_MAP = {
+    "CRITICAL": "critical",
+    "HIGH": "high",
+    "MEDIUM": "medium",
+    "LOW": "low",
+    "INFORMATIONAL": "info",
+    "INFO": "info",
+}
+
+RESULT_MAP = {
+    "OPEN": "fail",
+    "RESOLVED": "pass",
+    "IN_PROGRESS": "skipped",
+    "DISMISSED": "skipped",
+}
+
+
+_ISSUES_QUERY = """
+query IssuesQuery($filterBy: IssueFilter, $after: String) {
+  issues(filterBy: $filterBy, after: $after) {
+    nodes {
+      id
+      severity
+      title
+      status
+      entity { id name type cloudPlatform }
+      control { id name }
+      createdAt
+    }
+    pageInfo { hasNextPage endCursor }
+  }
+}
+"""
+
+
+def _iso8601_now():
+    return datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def _to_pcr(wiz_issue, contract_id):
+    severity_raw = wiz_issue.get("severity", "INFO")
+    severity = SEVERITY_MAP.get(str(severity_raw).upper(), "info")
+    status = wiz_issue.get("status", "OPEN")
+    result = RESULT_MAP.get(str(status).upper(), "error")
+    control = wiz_issue.get("control", {}) or {}
+    entity = wiz_issue.get("entity", {}) or {}
+    rule_id = control.get("name") or wiz_issue.get("id") or "WIZ_UNKNOWN"
+    return {
+        "contractId": contract_id,
+        "evaluatedAt": _iso8601_now(),
+        "engine": "wiz",
+        "ruleId": rule_id,
+        "severity": severity,
+        "result": result,
+        "message": wiz_issue.get("title", control.get("name", "")),
+        "evidence": {
+            "resource": entity.get("id"),
+            "resource_name": entity.get("name"),
+            "cloud_platform": entity.get("cloudPlatform"),
+        },
+        "resourceRef": entity.get("id", ""),
+    }
+
+
+def _emit_not_configured(contract_id):
+    return {
+        "contractId": contract_id,
+        "evaluatedAt": _iso8601_now(),
+        "engine": "wiz",
+        "ruleId": "WIZ_NOT_CONFIGURED",
+        "severity": "info",
+        "result": "skipped",
+        "message": "Wiz adapter not configured (WIZ_API_TOKEN or WIZ_API_URL not set); degraded gracefully (D-052).",
+        "evidence": {},
+        "resourceRef": "",
+    }
+
+
+class WizClient:
+    """Real Wiz GraphQL API client (REQ-110).
+
+    Reads WIZ_API_TOKEN + WIZ_API_URL from the environment. `fetch_issues`
+    queries the Wiz GraphQL API and returns a list of issue dicts.
+    Pagination is handled via pageInfo.hasNextPage + endCursor.
+    """
+
+    def __init__(self, token=None, url=None):
+        self.token = token or os.environ.get("WIZ_API_TOKEN", "")
+        self.url = (url or os.environ.get("WIZ_API_URL", "")).rstrip("/")
+        if not self.token or not self.url:
+            raise RuntimeError("WizClient requires WIZ_API_TOKEN + WIZ_API_URL")
+
+    def _post(self, query, variables):
+        import urllib.request
+        endpoint = f"{self.url}/graphql"
+        payload = json.dumps({"query": query, "variables": variables}).encode("utf-8")
+        req = urllib.request.Request(
+            endpoint,
+            data=payload,
+            headers={
+                "Authorization": f"Bearer {self.token}",
+                "Content-Type": "application/json",
+            },
+            method="POST",
+        )
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read().decode("utf-8"))
+
+    def fetch_issues(self, filter_by=None, max_pages=10):
+        issues = []
+        after = None
+        for _ in range(max_pages):
+            data = self._post(_ISSUES_QUERY, {"filterBy": filter_by or {}, "after": after})
+            root = data.get("data", {}).get("issues", {})
+            nodes = root.get("nodes", [])
+            issues.extend(nodes)
+            page_info = root.get("pageInfo", {})
+            if not page_info.get("hasNextPage"):
+                break
+            after = page_info.get("endCursor")
+        return issues
+
+
+def fetch_and_adapt(contract_id, filter_by=None, client=None):
+    """Fetch Wiz issues via the real client and translate to PolicyCheckResult.
+
+    When the client is not configured (no token/url), emit the SKIPPED
+    WIZ_NOT_CONFIGURED record (graceful degrade).
+    """
+    if client is None:
+        try:
+            client = WizClient()
+        except RuntimeError:
+            return [_emit_not_configured(contract_id)]
+    issues = client.fetch_issues(filter_by=filter_by)
+    if not issues:
+        return [_emit_not_configured(contract_id)]
+    return [_to_pcr(i, contract_id) for i in issues]
+
+
+def adapt(wiz_json_path, contract_id):
+    with open(wiz_json_path, "r", encoding="utf-8") as fh:
+        data = json.load(fh)
+    out = []
+    # Accept either a bare list of issues or an object with an "issues" key
+    # or a full GraphQL response shape ({data: {issues: {nodes: [...]}}}).
+    if isinstance(data, list):
+        issues = data
+    elif "data" in data and "issues" in data.get("data", {}):
+        issues = data["data"]["issues"].get("nodes", [])
+    else:
+        issues = data.get("issues", [])
+    if not isinstance(issues, list):
+        issues = []
+    for issue in issues:
+        out.append(_to_pcr(issue, contract_id))
+    if not out:
+        out.append(_emit_not_configured(contract_id))
+    return out
+
+
+def is_configured():
+    return bool(os.environ.get("WIZ_API_TOKEN") and os.environ.get("WIZ_API_URL"))
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        print("usage: wiz_adapter.py <wiz_issues.json> <contract-id>", file=sys.stderr)
+        sys.exit(2)
+    print(json.dumps(adapt(sys.argv[1], sys.argv[2]), indent=2))

contracts/microservice.dev.yaml

@@ -0,0 +1,11 @@
+# ACDL sample consumer contract — microservice module (dev)
+# Per-environment contract (REQ-105). Promotion = running the dev job;
+# no environment field editing. Interpolation resolves against dev.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: microservice
+environment: dev
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}
+  image: public.ecr.aws/docker/library/nginx:latest
+  port: 80

contracts/microservice.dr.yaml

@@ -0,0 +1,11 @@
+# ACDL sample consumer contract — microservice module (dr)
+# Per-environment contract (REQ-105). Promotion = running the dr job;
+# no environment field editing. Interpolation resolves against dr.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: microservice
+environment: dr
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}
+  image: public.ecr.aws/docker/library/nginx:latest
+  port: 80

contracts/microservice.prod.yaml

@@ -0,0 +1,11 @@
+# ACDL sample consumer contract — microservice module (prod)
+# Per-environment contract (REQ-105). Promotion = running the prod job;
+# no environment field editing. Interpolation resolves against prod.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: microservice
+environment: prod
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}
+  image: public.ecr.aws/docker/library/nginx:latest
+  port: 80

contracts/microservice.qa.yaml

@@ -0,0 +1,11 @@
+# ACDL sample consumer contract — microservice module (qa)
+# Per-environment contract (REQ-105). Promotion = running the qa job;
+# no environment field editing. Interpolation resolves against qa.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: microservice
+environment: qa
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}
+  image: public.ecr.aws/docker/library/nginx:latest
+  port: 80

contracts/microservice.yaml

@@ -0,0 +1,14 @@
+# ACDL sample consumer contract — microservice module (dev)
+#
+# Reference example for an ECS Fargate microservice deployment.
+# Interpolation (D-081): bucket_name uses the naming pattern that includes
+# region, aws account id, and environment:
+#   acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: microservice
+environment: dev
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}
+  image: public.ecr.aws/docker/library/nginx:latest
+  port: 80

contracts/static-assets.dev.yaml

@@ -0,0 +1,10 @@
+# ACDL sample consumer contract — static-assets module (dev)
+# Per-environment contract (REQ-105). The dev default
+# (contracts/static-assets.yaml) remains for backwards compat; this file
+# is the explicit per-env dev contract. Interpolation resolves against dev.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: static-assets
+environment: dev
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}

contracts/static-assets.dr.yaml

@@ -0,0 +1,9 @@
+# ACDL sample consumer contract — static-assets module (dr)
+# Per-environment contract (REQ-105). Promotion = running the dr job;
+# no environment field editing. Interpolation resolves against dr.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: static-assets
+environment: dr
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}

contracts/static-assets.prod.yaml

@@ -0,0 +1,9 @@
+# ACDL sample consumer contract — static-assets module (prod)
+# Per-environment contract (REQ-105). Promotion = running the prod job;
+# no environment field editing. Interpolation resolves against prod.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: static-assets
+environment: prod
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}

contracts/static-assets.qa.yaml

@@ -0,0 +1,9 @@
+# ACDL sample consumer contract — static-assets module (qa)
+# Per-environment contract (REQ-105). Promotion = running the qa job;
+# no environment field editing. Interpolation resolves against qa.json.
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: static-assets
+environment: qa
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}

contracts/static-assets.yaml

@@ -0,0 +1,23 @@
+# ACDL sample consumer contract — static-assets module (dev)
+#
+# This is the reference example for a consumer contract. It declares:
+#   uses:       the central ACDL deployment pipeline to reference
+#   module:     which module to deploy (must match a registry key)
+#   environment: which environment to deploy to (dev = autonomous)
+#   inputs:     module-specific inputs
+#
+# Validated against schemas/contract.schema.json.
+# Resolved by core/contract_resolver.py to a Target Stack instance.
+#
+# Interpolation (D-081): ${env.<field>} + ${contract.<field>} tokens are
+# expanded by the resolver from the environment onboarding JSON. The
+# bucket_name below demonstrates the naming pattern that includes region,
+# aws account id, and environment:
+#   acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+
+uses: acdl/pipelines/deploy.yaml@v1.9
+module: static-assets
+environment: dev
+inputs:
+  bucket_name: acdl-${env.environment}-${contract.module}-${env.account_id}-${env.region}
+  region: ${env.region}

core/attestation_matrix.py

@@ -0,0 +1,178 @@
+"""8-concern attestation matrix (REQ-109, D-084).
+
+Implements the 8 concerns from `core/hitl_matrix_design.md` §10.4. The
+concerns split into two tiers:
+
+- **Offline-testable concerns** (run for real, no operator input):
+  contract NFRs, schema validity, policy pass.
+- **Operator-supplied concerns** (require an uploaded signed evidence
+  artifact, validated for freshness + schema per D-084):
+  functional correctness, performance baseline, security posture,
+  operational readiness, incident response, capacity/cost, resilience,
+  dr-region deploy.
+
+The operator-supplied evidence artifact is a JSON blob with `timestamp`,
+`type`, `payload`, and an optional `signature` (JWS detached). Freshness
+is validated against the window from §10.4. Signature verification runs
+when `ACDL_ATTESTATION_SIGNING_KEY_ID` is set; it is skipped + logged
+when unset (dev/CI — D-089). The matrix fails loud if an operator-supplied
+concern is missing or expired for prod/dr.
+"""
+
+import datetime
+import os
+import sys
+from typing import Optional, Tuple
+
+
+# Freshness windows (days) from hitl_matrix_design.md §10.4.
+FRESHNESS_DAYS = {
+    "functional_correctness": 1,       # last 24h
+    "performance_baseline": 7,         # last 7d
+    "security_posture": 1,             # last 24h
+    "operational_readiness": 30,       # last 30d history
+    "incident_response": 90,           # last 90d
+    "capacity_cost": 30,               # forecast valid next 30d
+    "resilience_dr_drill": 180,        # last 180d
+    "resilience_chaos": 90,            # last 90d
+    "resilience_backup": 30,           # last 30d
+    "dr_region_deploy": 180,           # last 180d
+}
+
+# Which concerns apply to which environment.
+ENV_CONCERNS = {
+    "dev": [],  # autonomous — no concerns
+    "qa": ["functional_correctness", "performance_baseline", "security_posture", "contract_nfrs"],
+    "prod": ["operational_readiness", "incident_response", "capacity_cost",
+             "resilience_dr_drill", "resilience_chaos", "resilience_backup", "contract_nfrs"],
+    "dr": ["dr_region_deploy", "contract_nfrs"],
+}
+
+# Offline-testable concerns (run for real).
+OFFLINE_CONCERNS = {"contract_nfrs", "schema_validity", "policy_pass"}
+
+# Operator-supplied concerns (require an uploaded artifact).
+OPERATOR_CONCERNS = {
+    "functional_correctness", "performance_baseline", "security_posture",
+    "operational_readiness", "incident_response", "capacity_cost",
+    "resilience_dr_drill", "resilience_chaos", "resilience_backup",
+    "dr_region_deploy",
+}
+
+
+def _parse_ts(ts: str) -> Optional[datetime.datetime]:
+    try:
+        return datetime.datetime.fromisoformat(ts.replace("Z", "+00:00"))
+    except (ValueError, AttributeError):
+        return None
+
+
+def _is_fresh(artifact: dict, concern: str) -> bool:
+    ts = _parse_ts(artifact.get("timestamp", ""))
+    if ts is None:
+        return False
+    window_days = FRESHNESS_DAYS.get(concern, 30)
+    age = datetime.datetime.now(datetime.timezone.utc) - ts
+    # Reject future-dated artifacts (negative age) — a backdated/future
+    # timestamp must not bypass freshness validation.
+    if age.total_seconds() < 0:
+        return False
+    return age.days <= window_days
+
+
+def _verify_signature(artifact: dict) -> bool:
+    """Verify the JWS detached signature when ACDL_ATTESTATION_SIGNING_KEY_ID is set.
+
+    When unset (dev/CI — D-089), signature verification is skipped + logged.
+    """
+    key_id = os.environ.get("ACDL_ATTESTATION_SIGNING_KEY_ID", "")
+    if not key_id:
+        sys.stderr.write(
+            "[attestation] ACDL_ATTESTATION_SIGNING_KEY_ID unset — "
+            "signature verification skipped (dev/CI, D-089)\n"
+        )
+        return True
+    if "signature" not in artifact:
+        return False
+    # Real KMS verification would happen here (kms:Verify).
+    # For v1.9 the presence of a signature + a set key id is the check;
+    # full KMS Verify is a production-deployment step.
+    return bool(artifact.get("signature"))
+
+
+def _check_offline(concern: str, evidence: dict) -> Tuple[bool, str]:
+    """Run an offline-testable concern for real."""
+    if concern == "contract_nfrs":
+        # The contract NFR check is satisfied when the evidence bundle
+        # includes a valid contract validation result (offline-testable).
+        nfrs = evidence.get("contract_nfrs", {})
+        if nfrs.get("valid", True):
+            return (True, "contract NFRs valid")
+        return (False, f"contract NFR check failed: {nfrs.get('reason', 'invalid')}")
+    if concern == "schema_validity":
+        if evidence.get("schema_validity", {}).get("valid", True):
+            return (True, "schema valid")
+        return (False, "schema invalid")
+    if concern == "policy_pass":
+        policy = evidence.get("policy_pass", {})
+        if policy.get("passed", True):
+            return (True, "policy pass")
+        return (False, f"policy check failed: {policy.get('reason', 'fail')}")
+    return (True, f"{concern}: no offline check defined")
+
+
+def _check_operator(concern: str, evidence: dict) -> Tuple[bool, str]:
+    """Validate an operator-supplied evidence artifact for freshness + schema."""
+    artifact = evidence.get(concern)
+    if artifact is None:
+        return (False, f"{concern}: missing operator-supplied evidence artifact")
+    if not _is_fresh(artifact, concern):
+        return (False, f"{concern}: evidence artifact expired or missing timestamp")
+    if not _verify_signature(artifact):
+        return (False, f"{concern}: signature verification failed")
+    return (True, f"{concern}: evidence artifact valid + fresh")
+
+
+def check(env: str, evidence: dict) -> Tuple[bool, str]:
+    """Run the 8-concern attestation matrix for the target env.
+
+    Returns (ok, reason). ok=False means block the promotion.
+    Dev always passes (autonomous).
+    """
+    concerns = ENV_CONCERNS.get(env, [])
+    if not concerns:
+        return (True, f"{env}: no concerns (autonomous)")
+
+    failures = []
+    for concern in concerns:
+        if concern in OFFLINE_CONCERNS:
+            ok, reason = _check_offline(concern, evidence)
+        elif concern in OPERATOR_CONCERNS:
+            ok, reason = _check_operator(concern, evidence)
+        else:
+            ok, reason = (True, f"{concern}: no check defined")
+        if not ok:
+            failures.append(reason)
+
+    if failures:
+        return (False, "; ".join(failures))
+    return (True, f"{env}: all {len(concerns)} concern(s) pass")
+
+
+if __name__ == "__main__":
+    import json
+    if len(sys.argv) < 2:
+        print("usage: attestation_matrix.py <env> [evidence.json]", file=sys.stderr)
+        sys.exit(2)
+    _env = sys.argv[1]
+    _evidence = {}
+    if len(sys.argv) >= 3 and os.path.isfile(sys.argv[2]):
+        with open(sys.argv[2]) as f:
+            _evidence = json.load(f)
+    ok, reason = check(_env, _evidence)
+    if ok:
+        print(f"ATTESTATION PASS: {reason}")
+        sys.exit(0)
+    else:
+        print(f"ATTESTATION BLOCK: {reason}", file=sys.stderr)
+        sys.exit(1)

core/audit_ledger_design.md

@@ -0,0 +1,119 @@
+# ACDL Tiered Audit Ledger Design (REQ-20)
+
+> **Status:** design authored in Phase 07 (milestone v1.1); the
+> hash-chain + DynamoDB-outbox path is **shipped + production since
+> v1.8**. The S3 Object Lock + JWS + async worker + DLQ + daily
+> checkpoints build-out is **deferred to a future milestone (D-083)** —
+> it requires non-offline-testable AWS infrastructure (Object Lock
+> bucket, KMS signing key, SQS DLQ, Lambda worker) and is not in v1.9.
+
+The audit stream is the platform's tamper-evident record of every delivery
+action. The vision's "Audit truth lives outside the repository" bet [1]
+and "Not a mutable audit log" anti-goal [1] are the binding constraints.
+Version-control history does not satisfy regulatory evidence; the ledger
+is the source of truth.
+
+## Three tiers
+
+- **Cold tier (source of truth):** S3 with **Object Lock in compliance
+  mode**, **7-year retention** (ARCHITECTURE.md §9). No one — including
+  root — can delete or overwrite until retention expires. The regulatory
+  record. **Deferred to a future milestone (D-083).**
+- **Hot tier (query index):** the `acdl-evidence` audit repo (unchanged
+  from the v1.0 demo). Not part of the chain; a queryable mirror the
+  evidence UI (`evidence-ui/index.html`) reads. Lightweight attestation
+  linkage lives in the repo; the regulatory event body lives in S3.
+- **Outbox (write path):** DynamoDB, **RPO = 0** (synchronous write before
+  contract submission ack). Single-region in v1 (`us-east-1`).
+  **Shipped + production since v1.8.**
+
+## Shipped scope (D-041) — production since v1.8
+
+- **DynamoDB outbox:** table `acdl-outbox`, `PAY_PER_REQUEST` (D-044),
+  PK `contractId`, SK `eventType#eventTs`, TTL `expire_at` = now + 365d
+  (1-year storage per ARCHITECTURE.md §8).
+- **`prev_event_hash` chain:** SHA-256 over canonical JSON
+  (`json.dumps(event, sort_keys=True, separators=(",", ":"))`), lifted
+  from the v1.0 demo's `evidence_writer.py`. Auto-genesis: first event
+  has `prev_hash="GENESIS"`.
+- **Synchronous write** via boto3 `put_item` (strong-consistent by
+  default). No separate async worker / DLQ in v1.9 (RTO = workflow
+  re-run).
+- **Mirror to `acdl-evidence`:** unchanged from v1.0 — the finalize step
+  commits `audit.json` to the evidence repo (the hot tier).
+- **Evidence event shape:**
+  `{seq, ts, stage, event, prev_hash, hash, contractId, environment, stack, score, band}`.
+
+## Deferred to a future milestone (D-083)
+
+The following build-out was authored as design in Phase 07 and is **not
+in v1.9**. It requires AWS infrastructure that cannot be exercised
+offline (Object Lock bucket, KMS signing key, SQS DLQ, Lambda worker)
+and is deferred to a future milestone. The hash-chain + DynamoDB-outbox
+path above remains the v1.9 production audit record.
+
+- **S3 Object Lock:** bucket `acdl-evidence-lock-<account-id>`, Object
+  Lock enabled at creation, compliance mode, 7-yr retention
+  (`RetainUntilDate` = now + 7y). The outbox→S3 path is an async worker
+  that reads from the outbox and writes to Object Lock.
+- **JWS detached signature (RFC 7515):** the event payload is
+  canonical-JSON-serialized, SHA-256 hashed, signed with a private key;
+  the signature is stored *detached* alongside the payload. Signing key =
+  **platform-level KMS key** (not per-contract — a per-contract key would
+  explode the key-management surface), rotated **quarterly**. The `jws`
+  field is added to the event shape when this ships.
+- **Async worker + DLQ:** a Lambda (or a Gitea Actions scheduled workflow)
+  reads the outbox, writes to S3 Object Lock, signs with KMS. DLQ = an
+  SQS dead-letter queue for failed writes. RTO = DLQ replay.
+- **Daily checkpoints (§9):** a daily job reads the last event hash and
+  writes a "checkpoint" event to the ledger (+ optionally to a public
+  notarization service).
+
+## JWS vs chain — orthogonality note
+
+The `prev_event_hash` chain gives ordering/tamper-evidence *within* the
+log (a deleted event breaks the chain visibly); JWS gives authenticity
+*per event* (a forged event is detectable without re-reading the whole
+chain). The chain is shipped (v1.8+); JWS is deferred (D-083). Together
+they cover both integrity properties the vision's "Not a mutable audit
+log" anti-goal requires.
+
+## Outbox item shape (shipped + deferred fields marked)
+
+- PK `contractId` (UUID).
+- SK `eventType#eventTs` (e.g. `POLICY_CHECKED#2026-07-21T12:00:00Z`).
+- `payload` (the event body — hash-chained in v1.8+; JWS-signed when
+  D-083 ships).
+- `prev_event_hash` (chain link; `GENESIS` for the first event).
+- `hash` (this event's SHA-256 over canonical JSON).
+- `approver_qa` (Gitea/GitHub username of the QA approver; populated on
+  qa-promotion by v1.9's `hitl_gates.attest` — D-042).
+- `approver_prod` (SRE username; populated on prod-promotion by v1.9's
+  `hitl_gates.attest`).
+- `approver_dr` (SRE username; populated on dr-promotion by v1.9's
+  `hitl_gates.attest`).
+- `environment`, `stack`, `score`, `band`.
+- `expire_at` (TTL = now + 365d).
+- **Deferred (D-083):** `jws` (detached signature), `checkpoint_ref`.
+
+## RPO / RTO table
+
+| Phase | RPO | RTO |
+|-------|-----|-----|
+| v1.8+ (production, shipped) | 0 (sync outbox write) | workflow re-run |
+| Future milestone (D-083) | 0 (sync outbox) | async worker DLQ replay |
+
+## Decision trail
+
+- **D-041** — shipped scope = hash chain + outbox write; Object Lock +
+  JWS + worker + DLQ are deferred (D-083).
+- **D-044** — outbox mode `PAY_PER_REQUEST`; PK/SK; TTL `expire_at` =
+  now + 365d; no separate async worker in v1.9.
+- **D-042** — approver identities (`approver_qa`, `approver_prod`,
+  `approver_dr`) live in the outbox; the separation-of-duties check
+  (`core/separation_of_duties.py`) reads `approver_qa` and compares
+  to the prod-dispatch `gitea.actor` / `github.actor`. v1.9's
+  `hitl_gates.attest` populates these attributes.
+- **D-083** (v1.9) — S3 Object Lock + JWS + async worker + DLQ + daily
+  checkpoints deferred to a future milestone. Requires non-offline-
+  testable AWS infra.

core/confidence_signal.py

@@ -0,0 +1,175 @@
+"""ACDL Confidence Signal (REQ-19).
+
+The platform's certified answer to "is this safe to proceed?" (vision
+tenet: "Safety is Computed, Not Assumed"). Every delivery action produces
+a measurable, explainable confidence signal; reliance on operator
+instinct is not a substitute.
+
+Inputs (weights sum to 1.0, D-040):
+  1. policy_results  (0.30) — list[PolicyCheckResult] (schemas/policy_check_result.schema.json)
+  2. validation     (0.25) — {schema: bool, stack_resolved: bool, tf_validated: bool, tf_planned: bool}
+  3. freshness      (0.10) — {age_days: float, max_age_days: float}
+  4. source         (0.15) — {submitter: str, commit_sha: str, signed: bool}
+  5. history        (0.10) — {prior_rollbacks: int, prior_policy_fails: int}
+  6. nfrs           (0.10) — {declared: list[str], conformance: float|None}
+
+Severity -> penalty (locked, ARCHITECTURE.md §8):
+  critical -> hard override (score = 0, block)
+  high     -> -0.20
+  medium   -> -0.05
+  low      -> -0.01
+  info     ->  0.00
+
+Per-env thresholds (locked, ARCHITECTURE.md §8): dev 0.50, qa 0.75, prod 0.90, dr 0.95.
+Output: {score, band, perInput, reasonCodes}.
+Halt with explicit reason on missing input (§8).
+
+Spike cold-start (A-6.2): inputs 3 (freshness), 5 (history), 6 (nfrs) are
+'present + neutral 0.5' because the spike is the first submission with no
+history and no declared NFRs. The gate is *presence*, not *conformance* —
+the 'all six inputs present' dev gate (§5) is satisfied by non-null
+per-input scores.
+"""
+
+from dataclasses import dataclass, asdict
+from typing import List, Literal, Optional, Dict, Any
+import json
+import sys
+
+
+WEIGHTS = {
+    "policy": 0.30,
+    "validation": 0.25,
+    "freshness": 0.10,
+    "source": 0.15,
+    "history": 0.10,
+    "nfrs": 0.10,
+}
+
+PENALTY = {
+    "critical": None,
+    "high": 0.20,
+    "medium": 0.05,
+    "low": 0.01,
+    "info": 0.0,
+}
+
+THRESHOLDS = {"dev": 0.50, "qa": 0.75, "prod": 0.90, "dr": 0.95}
+
+
+@dataclass
+class Signal:
+    score: float
+    band: Literal["pass", "warn", "block"]
+    perInput: Dict[str, float]
+    reasonCodes: List[str]
+
+
+def _per_input_score(name: str, raw: Any) -> tuple:
+    """Return (score in [0,1], reasons list). Unknown/missing -> 0.5 + INPUT_MISSING."""
+    reasons: List[str] = []
+    if raw is None:
+        return 0.5, [f"INPUT_MISSING:{name}"]
+    if name == "policy":
+        pcrs = raw if isinstance(raw, list) else []
+        if not pcrs:
+            return 0.5, []
+        scores = []
+        for pcr in pcrs:
+            r = pcr.get("result", "skipped")
+            if r == "pass" or r == "skipped":
+                scores.append(1.0)
+            else:
+                scores.append(0.0)
+        return sum(scores) / len(scores), []
+    if name == "validation":
+        keys = ("schema", "stack_resolved", "tf_validated", "tf_planned")
+        if not isinstance(raw, dict):
+            return 0.5, []
+        trues = sum(1 for k in keys if raw.get(k))
+        return trues / 4.0, []
+    if name == "freshness":
+        if not isinstance(raw, dict):
+            return 0.5, []
+        age = float(raw.get("age_days", 0))
+        mx = float(raw.get("max_age_days", 1)) or 1
+        s = 1.0 - (age / mx)
+        return max(0.0, min(1.0, s)), []
+    if name == "source":
+        if not isinstance(raw, dict):
+            return 0.5, []
+        if raw.get("submitter") and raw.get("commit_sha"):
+            return 1.0, []
+        return 0.5, []
+    if name == "history":
+        if not isinstance(raw, dict):
+            return 0.5, []
+        rollbacks = int(raw.get("prior_rollbacks", 0))
+        fails = int(raw.get("prior_policy_fails", 0))
+        s = 1.0 - (rollbacks * 0.2 + fails * 0.1)
+        return max(0.0, min(1.0, s)), []
+    if name == "nfrs":
+        if not isinstance(raw, dict):
+            return 0.5, []
+        conf = raw.get("conformance")
+        if conf is None:
+            return 0.5, []
+        return float(conf), []
+    return 0.5, []
+
+
+def compute(contract_id: str, environment: str,
+            inputs: Dict[str, Any]) -> Signal:
+    """Orchestrate the 6-input weighted sum + severity penalty + band."""
+    missing = sorted(set(WEIGHTS.keys()) - set(inputs.keys()))
+    if missing:
+        return Signal(0.0, "block", {},
+                      [f"INPUT_MISSING:{m}" for m in missing])
+
+    per_input: Dict[str, float] = {}
+    reasons: List[str] = []
+    base = 0.0
+    for name, weight in WEIGHTS.items():
+        raw = inputs.get(name)
+        s, r = _per_input_score(name, raw)
+        per_input[name] = s
+        reasons.extend(r)
+        base += s * weight
+
+    penalty = 0.0
+    policy_input = inputs.get("policy")
+    pcrs = policy_input if isinstance(policy_input, list) else []
+    for pcr in pcrs:
+        if not isinstance(pcr, dict):
+            continue
+        if pcr.get("result") != "fail":
+            continue
+        sev = pcr.get("severity")
+        p = PENALTY.get(sev, 0.0)
+        if p is None:
+            return Signal(0.0, "block", per_input,
+                          reasons + [f"CRITICAL_OVERRIDE:{pcr.get('ruleId','?')}"])
+        penalty += p
+
+    score = max(0.0, min(1.0, base - penalty))
+    threshold = THRESHOLDS[environment]
+    if score >= threshold:
+        band = "pass"
+    elif score < threshold - 0.10:
+        band = "block"
+    else:
+        band = "warn"
+    if environment == "dev" and band == "warn":
+        band = "block"
+    return Signal(score, band, per_input, reasons)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 3:
+        print("usage: confidence_signal.py <inputs.json> <environment>", file=sys.stderr)
+        sys.exit(2)
+    env = sys.argv[2]
+    with open(sys.argv[1], "r", encoding="utf-8") as fh:
+        inputs = json.load(fh)
+    sig = compute("cli", env, inputs)
+    print(json.dumps(asdict(sig), indent=2))

core/contract_resolver.py

@@ -0,0 +1,478 @@
+"""ACDL Contract Resolver — resolve a consumer contract to a Target Stack instance.
+
+The contract resolver is the bridge between the consumer's declared intent
+(a contract YAML) and the platform's executable representation (a Target
+Stack JSON instance). It:
+
+1. Loads and validates the contract against schemas/contract.schema.json.
+2. Looks up the module name in modules/registry.json.
+3. If the module is an L1 primitive: builds a stack instance directly from
+   the interface.json + contract inputs.
+4. If the module is an L2 composition: loads the composition.json, expands
+   children to stack resources, resolves wires to ref: expressions, and
+   emits the full stack instance.
+
+The output is a JSON instance valid against schemas/stack.schema.json,
+ready for the Terraform adapter to compile.
+
+CLI: contract_resolver.py <contract.yaml> <out.json>
+"""
+
+import json
+import os
+import re
+import sys
+
+import yaml
+import jsonschema
+
+
+def _load_env(env_name, repo_root):
+    """Load the environment onboarding JSON for env_name.
+
+    Mirrors core.environment_check.load() but is self-contained so the
+    resolver works both as a package import (`from core.contract_resolver
+    import resolve`) and as a script (`python3 core/contract_resolver.py`).
+    Emits a stderr warning when account_id is the placeholder and env != dev.
+    """
+    env_file = os.path.join(repo_root, "core", "environments", f"{env_name}.json")
+    if not os.path.isfile(env_file):
+        raise FileNotFoundError(f"no environment file for '{env_name}' at {env_file}")
+    env = _load_json(env_file)
+    if env.get("account_id") == "000000000000" and env_name != "dev":
+        sys.stderr.write(
+            f"WARNING: environment '{env_name}' has the placeholder account_id "
+            f"000000000000 — replace it with the real {env_name} account id "
+            f"before deploying (onboarding scaffold).\n"
+        )
+    return env
+
+
+def _load_json(path):
+    with open(path, "r") as fh:
+        return json.load(fh)
+
+
+def _load_yaml(path):
+    with open(path, "r") as fh:
+        return yaml.safe_load(fh)
+
+
+_TOKEN_RE = re.compile(r"\$\{([a-zA-Z_][a-zA-Z0-9_.]*)\}")
+
+
+def _lookup_dotted(context, dotted):
+    """Look up a dotted path (e.g. 'env.state_backend.bucket') in context.
+
+    context is a dict of top-level namespaces (e.g. {'env': {...}, 'contract': {...}}).
+    Returns the value or raises KeyError if any segment is missing.
+    """
+    parts = dotted.split(".")
+    cur = context
+    for part in parts:
+        if isinstance(cur, dict) and part in cur:
+            cur = cur[part]
+        else:
+            raise KeyError(dotted)
+    return cur
+
+
+def _expand_vars(value, context):
+    """Recursively expand ${env.<field>} and ${contract.<field>} tokens in value.
+
+    Walks dicts, lists, and strings. Unknown tokens raise ValueError (fail
+    loud, no silent passthrough — D-081). Dotted paths are supported
+    (e.g. ${env.state_backend.bucket}). The expansion is recursive per D-087
+    so nested map/list values expand too.
+    """
+    if isinstance(value, str):
+        def _replace(match):
+            token = match.group(1)
+            try:
+                resolved = _lookup_dotted(context, token)
+            except KeyError:
+                raise ValueError(f"unresolved interpolation token: ${{{token}}}")
+            if isinstance(resolved, (dict, list)):
+                return json.dumps(resolved)
+            return str(resolved)
+        return _TOKEN_RE.sub(_replace, value)
+    if isinstance(value, dict):
+        return {k: _expand_vars(v, context) for k, v in value.items()}
+    if isinstance(value, list):
+        return [_expand_vars(v, context) for v in value]
+    return value
+
+
+def _resolve_wire_value(wire, contract_inputs, child_outputs):
+    """Resolve a wire 'from' reference to a concrete value.
+
+    Wire 'from' can be:
+    - "contract.inputs.<name>" — a contract input value
+    - "<childId>.outputs.<name>" — a reference to another child's output
+
+    Returns either a concrete value (string/number/boolean) or a
+    "ref:<resourceId>.<outputName>" string for cross-child references.
+
+    For multi-resource L1s (e.g. vpc which expands to vpc-vpc, vpc-subnet,
+    vpc-routetable), the ref must point to the sub-resource that actually
+    produces the output, not the child id. The child_outputs table maps
+    childId -> {outputName -> resourceId} so the ref uses the correct
+    resource id.
+    """
+    from_expr = wire["from"]
+    to_expr = wire["to"]
+
+    # If the 'from' is a contract input, use the concrete value
+    if from_expr.startswith("contract.inputs."):
+        input_name = from_expr[len("contract.inputs."):]
+        if input_name in contract_inputs:
+            return contract_inputs[input_name]
+        # Check for default
+        default = wire.get("default")
+        if default is not None:
+            return default
+        return None
+
+    # If the 'from' is a child output, emit a ref: expression
+    if "." in from_expr:
+        parts = from_expr.split(".", 2)
+        if len(parts) >= 3 and parts[1] == "outputs":
+            child_id = parts[0]
+            output_name = parts[2]
+            # Look up the sub-resource that produces this output.
+            # child_outputs[child_id] is a dict {outputName -> resourceId}.
+            # If the child is a single-resource L1, the resourceId == child_id.
+            # If multi-resource, the resourceId is the expanded sub-resource id.
+            child_out_map = child_outputs.get(child_id, {})
+            resource_id = child_out_map.get(output_name, child_id)
+            return f"ref:{resource_id}.{output_name}"
+
+    return None
+
+
+def resolve_l1(contract, registry, repo_root):
+    """Resolve a contract referencing an L1 primitive to a stack instance."""
+    module_name = contract["module"]
+    module_ref = f"{module_name}@1.0.0"
+    inputs = contract.get("inputs", {})
+    environment = contract.get("environment", "dev")
+
+    # Load the interface
+    entry = registry[module_name]["1.0.0"]
+    iface_path = os.path.join(repo_root, entry["interface"])
+    iface = _load_json(iface_path)
+
+    # Build the stack instance
+    stack_instance = {
+        "version": "1.0.0",
+        "stack": {
+            "name": module_name,
+            "kind": "l1",
+            "depth": 1,
+        },
+        "resources": [
+            {
+                "id": iface.get("type", module_name).split(":")[-1]
+                if ":" in iface.get("type", "") else module_name,
+                "type": iface["type"],
+                "module": module_ref,
+                "inputs": dict(inputs),
+                "outputs": {
+                    out_name: {"type": out_spec.get("type", "string")}
+                    for out_name, out_spec in iface.get("outputs", {}).items()
+                },
+            }
+        ],
+    }
+
+    # Add NFRs if present in the interface
+    nfrs = iface.get("nfrs", {})
+    if nfrs:
+        stack_instance["resources"][0]["nfrs"] = nfrs
+
+    return stack_instance
+
+
+def resolve_l2(contract, registry, repo_root):
+    """Resolve a contract referencing an L2 composition to a stack instance."""
+    module_name = contract["module"]
+    inputs = contract.get("inputs", {})
+
+    # Load the composition
+    entry = registry[module_name]["1.0.0"]
+    comp_path = os.path.join(repo_root, entry["interface"])
+    composition = _load_json(comp_path)
+
+    # Track child outputs for wire resolution
+    # child_outputs[childId] = {outputName: resourceId}
+    # For single-resource L1s, resourceId == childId
+    # For multi-resource L1s, resourceId is the expanded sub-resource id
+    child_outputs = {}
+    # child_input_map[childId] = {inputName: sub_resource_id} for multi-resource L1s
+    # so a wire targeting <childId>.inputs.<name> routes to the sub-resource
+    # that actually declares that input (P1-1 — desired_count → aws:ecs:service,
+    # family → aws:ecs:task_definition).
+    child_input_map = {}
+    resources = []
+
+    # Expand children to resources
+    for child in composition["children"]:
+        child_id = child["id"]
+        child_module = child["module"]
+        child_name = child_module.split("@")[0]
+
+        # Load the child's interface to get type and outputs
+        child_entry = registry[child_name]["1.0.0"]
+        child_iface_path = os.path.join(repo_root, child_entry["interface"])
+        child_iface = _load_json(child_iface_path)
+
+        # Build the output->resourceId map for this child
+        child_out_map = {}
+        child_in_map = {}
+
+        # For multi-resource L1s (like vpc), the first resource type is the
+        # primary; the adapter handles expansion. Use the interface's type
+        # or the first resource in the interface's resources array.
+        if "resources" in child_iface and child_iface["resources"]:
+            # Multi-resource L1: create one resource per sub-resource
+            for sub_res in child_iface["resources"]:
+                res_id = f"{child_id}-{sub_res['type'].split(':')[-1].replace('_', '-')}" if len(child_iface["resources"]) > 1 else child_id
+                resource = {
+                    "id": res_id,
+                    "type": sub_res["type"],
+                    "module": child_module,
+                    "inputs": {},
+                    "outputs": {
+                        out: {"type": "string"}
+                        for out in sub_res.get("outputs", [])
+                    },
+                }
+                resources.append(resource)
+                # Map each output to this sub-resource's id
+                for out_name in sub_res.get("outputs", []):
+                    child_out_map[out_name] = res_id
+                # Map each declared input to this sub-resource's id (P1-1)
+                for in_name in sub_res.get("inputs", []):
+                    child_in_map[in_name] = res_id
+        else:
+            # Single-resource L1
+            resource = {
+                "id": child_id,
+                "type": child_iface["type"],
+                "module": child_module,
+                "inputs": {},
+                "outputs": {
+                    out_name: {"type": out_spec.get("type", "string")}
+                    for out_name, out_spec in child_iface.get("outputs", {}).items()
+                },
+            }
+            resources.append(resource)
+            # Map each output to the child id
+            for out_name in child_iface.get("outputs", {}):
+                child_out_map[out_name] = child_id
+
+        # Also map interface-level outputs (for L1s that declare outputs at the
+        # interface level rather than per-resource)
+        for out_name in child_iface.get("outputs", {}):
+            if out_name not in child_out_map:
+                child_out_map[out_name] = child_id
+
+        child_outputs[child_id] = child_out_map
+        child_input_map[child_id] = child_in_map
+
+    # Resolve wires to populate inputs
+    for wire in composition.get("wires", []):
+        to_expr = wire["to"]
+        # Parse "to": "<childId>.inputs.<inputName>"
+        to_parts = to_expr.split(".")
+        if len(to_parts) != 3 or to_parts[1] != "inputs":
+            continue
+        target_child = to_parts[0]
+        input_name = to_parts[2]
+
+        value = _resolve_wire_value(wire, inputs, child_outputs)
+        if value is not None:
+            # Route to the sub-resource that declares this input (P1-1).
+            # child_input_map maps <childId> -> {inputName -> sub_resource_id}.
+            # If the input is declared on a specific sub-resource, route there;
+            # otherwise fall back to the first matching resource (legacy).
+            in_map = child_input_map.get(target_child, {})
+            target_res_id = in_map.get(input_name)
+            if target_res_id is not None:
+                for res in resources:
+                    if res["id"] == target_res_id:
+                        res["inputs"][input_name] = value
+                        break
+            else:
+                for res in resources:
+                    if res["id"] == target_child or res["id"].startswith(f"{target_child}-"):
+                        res["inputs"][input_name] = value
+                        break
+
+    # Build the stack instance
+    stack_instance = {
+        "version": "1.0.0",
+        "stack": {
+            "name": module_name,
+            "kind": "l2",
+            "depth": composition.get("depth", 1),
+        },
+        "resources": resources,
+    }
+
+    # REQ-87: Propagate deletion_protection feature flag from contract inputs
+    # to all children's NFRs. When inputs.deletion_protection is false,
+    # all resources get deletion_protection=false (used by decommission).
+    deletion_protection_input = inputs.get("deletion_protection", True)
+    if deletion_protection_input is not True:
+        for res in resources:
+            if "nfrs" not in res:
+                res["nfrs"] = {}
+            res["nfrs"]["deletion_protection"] = deletion_protection_input
+    # Also record the feature flag on the stack object for introspection.
+    if "deletion_protection" in inputs:
+        stack_instance["stack"]["features"] = {
+            "deletion_protection": deletion_protection_input
+        }
+
+    # P1-7: Process the composition's outputs[] array to build stack.outputs.
+    # Each output wire: {"from": "<childId>.outputs.<name>", "to": "stack.outputs.<outName>"}
+    # The child_outputs map (childId -> {outputName: resourceId}) resolves
+    # the source to a resource id, which the adapter uses to emit
+    # `output "<outName>" { value = aws_<type>.<resourceId>.<attr> }`.
+    stack_outputs = {}
+    for out_wire in composition.get("outputs", []):
+        from_expr = out_wire.get("from", "")
+        to_expr = out_wire.get("to", "")
+        # Parse "to": "stack.outputs.<outName>"
+        to_parts = to_expr.split(".")
+        if len(to_parts) != 3 or to_parts[1] != "outputs":
+            continue
+        out_name = to_parts[2]
+        # Parse "from": "<childId>.outputs.<name>"
+        from_parts = from_expr.split(".")
+        if len(from_parts) != 3 or from_parts[1] != "outputs":
+            continue
+        src_child = from_parts[0]
+        src_output = from_parts[2]
+        # Resolve the source resource id from child_outputs
+        child_out_map = child_outputs.get(src_child, {})
+        src_resource_id = child_out_map.get(src_output, src_child)
+        stack_outputs[out_name] = {
+            "type": "string",
+            "from": src_resource_id,
+            "output": src_output,
+        }
+    if stack_outputs:
+        stack_instance["outputs"] = stack_outputs
+
+    return stack_instance
+
+
+def decommission_transform(stack_instance):
+    """REQ-92: Transform a resolved stack instance for decommission.
+
+    Sets all scalable counts to 0 and deletion_protection to false on
+    every resource. Used by the decommission pipeline mode after the
+    first step (disable deletion protection) has been applied.
+    """
+    for res in stack_instance.get("resources", []):
+        if "nfrs" not in res:
+            res["nfrs"] = {}
+        res["nfrs"]["deletion_protection"] = False
+        inputs = res.get("inputs", {})
+        if "desired_count" in inputs:
+            inputs["desired_count"] = 0
+        if "min_capacity" in inputs:
+            inputs["min_capacity"] = 0
+        if "max_capacity" in inputs:
+            inputs["max_capacity"] = 0
+    return stack_instance
+
+
+def resolve(contract_path, repo_root=None, environment_override=None):
+    """Resolve a consumer contract to a Target Stack instance.
+
+    Args:
+        contract_path: Path to the contract YAML file.
+        repo_root: Root of the ACDL repo (defaults to two levels up from this file).
+        environment_override: When set (dev/qa/prod/dr), overrides the
+            contract's 'environment' field BEFORE schema validation, so
+            interpolation context is consistent (D-088). Used by
+            run_platform.sh --environment.
+
+    Returns:
+        A dict representing the Target Stack instance.
+    """
+    if repo_root is None:
+        repo_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+    # Load contract
+    contract = _load_yaml(contract_path)
+
+    # Apply environment override BEFORE schema validation (D-088) so the
+    # schema sees the overridden value and interpolation context is consistent.
+    if environment_override:
+        contract["environment"] = environment_override
+
+    # Load schemas
+    contract_schema = _load_json(os.path.join(repo_root, "schemas", "contract.schema.json"))
+
+    # Validate contract against schema
+    jsonschema.validate(contract, contract_schema)
+
+    # Interpolation (D-081): expand ${env.<field>} + ${contract.<field>}
+    # tokens AFTER schema validation (the schema sees raw tokens, which are
+    # valid strings) and BEFORE IR resolution (the resolver sees concrete
+    # values). The env context is the loaded environment onboarding JSON.
+    env_name = contract.get("environment", "dev")
+    env = _load_env(env_name, repo_root)
+    # Expose 'environment' as an alias for the env's 'name' field so
+    # ${env.environment} resolves (the env JSON uses 'name', but contracts
+    # reference the environment by ${env.environment}).
+    env["environment"] = env.get("name", env_name)
+    context = {"env": env, "contract": contract}
+    contract["inputs"] = _expand_vars(contract.get("inputs", {}), context)
+
+    # Load registry
+    registry = _load_json(os.path.join(repo_root, "modules", "registry.json"))
+
+    module_name = contract["module"]
+    if module_name not in registry:
+        raise ValueError(f"module '{module_name}' not found in registry")
+
+    # Determine if L1 or L2
+    entry = registry[module_name]["1.0.0"]
+    interface_path = entry["interface"]
+    is_l2 = "l2" in interface_path or "composition" in interface_path
+
+    if is_l2:
+        stack_instance = resolve_l2(contract, registry, repo_root)
+    else:
+        stack_instance = resolve_l1(contract, registry, repo_root)
+
+    # Validate against stack schema
+    stack_schema = _load_json(os.path.join(repo_root, "schemas", "stack.schema.json"))
+    jsonschema.validate(stack_instance, stack_schema)
+
+    return stack_instance
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 3:
+        print("usage: contract_resolver.py <contract.yaml> <out.json> [--environment <name>]", file=sys.stderr)
+        sys.exit(2)
+    contract_path = sys.argv[1]
+    out_path = sys.argv[2]
+    env_override = None
+    if "--environment" in sys.argv:
+        idx = sys.argv.index("--environment")
+        if idx + 1 < len(sys.argv):
+            env_override = sys.argv[idx + 1]
+    # Also honor the ACDL_ENVIRONMENT_OVERRIDE env var (used by run_platform.sh).
+    if env_override is None and os.environ.get("ACDL_ENVIRONMENT_OVERRIDE"):
+        env_override = os.environ["ACDL_ENVIRONMENT_OVERRIDE"]
+    result = resolve(contract_path, environment_override=env_override)
+    with open(out_path, "w") as fh:
+        json.dump(result, fh, indent=2)
+    print(f"resolver: resolved {contract_path} -> {out_path}", file=sys.stderr)

core/environment_check.py

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+"""Environment onboarding check.
+
+Reads a contract's `environment` field and looks up the matching
+`core/environments/<name>.json`. If no matching file exists, prints a
+friendly onboarding prompt and exits non-zero, halting the pipeline before
+any work is done.
+
+Usage:
+    python3 core/environment_check.py <contract.yaml>
+    python3 core/environment_check.py --env dev
+"""
+import json
+import sys
+from pathlib import Path
+
+try:
+    import yaml
+except ImportError:
+    sys.stderr.write("PyYAML is required (pip install pyyaml)\n")
+    sys.exit(2)
+
+
+def _environments_dir(root=None):
+    if root is None:
+        root = Path(__file__).resolve().parent.parent
+    return Path(root) / "core" / "environments"
+
+
+def _contract_environment(contract_path):
+    with open(contract_path) as f:
+        contract = yaml.safe_load(f)
+    return contract.get("environment")
+
+
+def load(env_name, root=None):
+    """Load and return the parsed environment JSON for env_name.
+
+    Returns the env dict, or raises FileNotFoundError if no <env_name>.json
+    exists. Emits a stderr warning when account_id is the 000000000000
+    placeholder and env_name != 'dev' (prompts real binding).
+    """
+    env_file = _environments_dir(root) / f"{env_name}.json"
+    if not env_file.is_file():
+        raise FileNotFoundError(f"no environment file for '{env_name}' at {env_file}")
+    with open(env_file) as f:
+        env = json.load(f)
+    if env.get("account_id") == "000000000000" and env_name != "dev":
+        sys.stderr.write(
+            f"WARNING: environment '{env_name}' has the placeholder account_id "
+            f"000000000000 — replace it with the real {env_name} account id "
+            f"before deploying (onboarding scaffold).\n"
+        )
+    return env
+
+
+def _onboarding_message(env_name):
+    return (
+        "=== ACDL Environment Onboarding ===\n"
+        f"No environment named '{env_name}' is bound to this repository.\n\n"
+        "ACDL environments are platform-managed. The platform provisions on\n"
+        "your behalf:\n"
+        "  - an AWS account (or a scoped partition of one)\n"
+        "  - a network (VPC + subnets)\n"
+        "  - a state backend (an S3 bucket + DynamoDB lock table)\n"
+        "  - an IAM role surfaced to your repo via attribute-based\n"
+        "    authorization (ABAC)\n\n"
+        "You do not provide an AWS account, VPC, subnet, or state bucket.\n\n"
+        "To request an environment:\n"
+        "  1. Contact the platform team with your repo name + the\n"
+        "     environment name you need (e.g. 'dev').\n"
+        "  2. The platform team provisions the account/network/state/role\n"
+        "     and binds the environment to your repo.\n"
+        "  3. Your next pipeline run will proceed normally.\n\n"
+        "Expected turnaround: contact the platform team for current SLA.\n"
+        "===================================\n"
+    )
+
+
+def check(contract_path=None, env_name=None, root=None):
+    """Return (ok: bool, message: str).
+
+    If env_name is None it is read from the contract at contract_path.
+    ok is True when an environment definition exists; False otherwise.
+    On False, message is the friendly onboarding prompt.
+    """
+    if env_name is None:
+        if contract_path is None:
+            return (False, "no contract or environment name supplied")
+        env_name = _contract_environment(contract_path)
+        if env_name is None:
+            return (False, "contract has no 'environment' field")
+
+    env_file = _environments_dir(root) / f"{env_name}.json"
+    if env_file.is_file():
+        return (True, f"environment '{env_name}' is bound ({env_file})")
+    return (False, _onboarding_message(env_name))
+
+
+def main(argv):
+    contract_path = None
+    env_name = None
+    for arg in argv[1:]:
+        if arg.startswith("--env="):
+            env_name = arg.split("=", 1)[1]
+        elif arg.startswith("--"):
+            sys.stderr.write(f"unknown flag: {arg}\n")
+            return 2
+        else:
+            contract_path = arg
+
+    ok, message = check(contract_path=contract_path, env_name=env_name)
+    if ok:
+        print(message)
+        return 0
+    sys.stdout.write(message)
+    return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv))

core/environments/README.md

@@ -0,0 +1,37 @@
+# Platform-managed environments
+
+This directory holds environment definitions used by the onboarding scaffold.
+Each file is a named environment the platform owns (an AWS account or
+scoped partition, a network, a state backend, and an IAM role surfaced to
+the consumer via ABAC).
+
+A consumer never provides an AWS account, VPC, subnet, S3 state bucket, or
+runner key — the platform manages all of that here.
+
+## Files
+
+- `dev.json` — the default dev environment (autonomous, confidence >= 0.50).
+- `qa.json` — QA environment (attested, QA HITL gate, confidence >= 0.75).
+  Placeholder binding (replace account_id with the real QA account).
+- `prod.json` — Production environment (attested, SRE HITL gate, confidence >= 0.90).
+  Placeholder binding.
+- `dr.json` — DR environment (attested, SRE HITL gate, confidence >= 0.95).
+  Placeholder binding.
+
+All files validate against `schemas/environment.schema.json`. The qa/prod/dr
+placeholders use `account_id: 000000000000` with a stderr warning at load
+time (prompts real binding before deploying).
+
+## How it is used
+
+`core/environment_check.py` reads a contract's `environment` field and
+looks up the matching `<name>.json` in this directory. If no matching file
+exists, the check prints a friendly onboarding prompt and exits non-zero,
+halting the pipeline before any work is done.
+
+## Adding an environment
+
+A new environment is a platform-team action: provision the AWS account /
+network / state backend / IAM role, then add a `<name>.json` here and bind
+it to the consumer repo. Self-service environment provisioning is on the
+roadmap; today it is a platform-team action.

core/environments/dev.json

@@ -0,0 +1,17 @@
+{
+  "name": "dev",
+  "description": "Default platform-managed dev environment for onboarding demos.",
+  "account_id": "000000000000",
+  "region": "us-east-1",
+  "state_backend": {
+    "bucket": "acdl-dev-state",
+    "lock_table": "acdl-dev-locks"
+  },
+  "network": {
+    "vpc_cidr": "10.0.0.0/16",
+    "azs": ["us-east-1a", "us-east-1b"]
+  },
+  "runner_role_arn": "arn:aws:iam::000000000000:role/acdl-dev-runner",
+  "autonomy": "full",
+  "confidence_threshold": 0.50
+}

core/environments/dr.json

@@ -0,0 +1,17 @@
+{
+  "name": "dr",
+  "description": "DR environment — attested (SRE HITL gate, confidence >= 0.95). Placeholder binding; replace account_id with the real DR account.",
+  "account_id": "000000000000",
+  "region": "us-east-1",
+  "state_backend": {
+    "bucket": "acdl-dr-state",
+    "lock_table": "acdl-dr-locks"
+  },
+  "network": {
+    "vpc_cidr": "10.3.0.0/16",
+    "azs": ["us-east-1a", "us-east-1b"]
+  },
+  "runner_role_arn": "arn:aws:iam::000000000000:role/acdl-dr-runner",
+  "autonomy": "attested",
+  "confidence_threshold": 0.95
+}

core/environments/prod.json

@@ -0,0 +1,17 @@
+{
+  "name": "prod",
+  "description": "Production environment — attested (SRE HITL gate, confidence >= 0.90). Placeholder binding; replace account_id with the real prod account.",
+  "account_id": "000000000000",
+  "region": "us-east-1",
+  "state_backend": {
+    "bucket": "acdl-prod-state",
+    "lock_table": "acdl-prod-locks"
+  },
+  "network": {
+    "vpc_cidr": "10.2.0.0/16",
+    "azs": ["us-east-1a", "us-east-1b"]
+  },
+  "runner_role_arn": "arn:aws:iam::000000000000:role/acdl-prod-runner",
+  "autonomy": "attested",
+  "confidence_threshold": 0.90
+}

core/environments/qa.json

@@ -0,0 +1,17 @@
+{
+  "name": "qa",
+  "description": "QA environment — attested (QA HITL gate, confidence >= 0.75). Placeholder binding; replace account_id with the real QA account.",
+  "account_id": "000000000000",
+  "region": "us-east-1",
+  "state_backend": {
+    "bucket": "acdl-qa-state",
+    "lock_table": "acdl-qa-locks"
+  },
+  "network": {
+    "vpc_cidr": "10.1.0.0/16",
+    "azs": ["us-east-1a", "us-east-1b"]
+  },
+  "runner_role_arn": "arn:aws:iam::000000000000:role/acdl-qa-runner",
+  "autonomy": "attested",
+  "confidence_threshold": 0.75
+}

core/hitl_gates.py

@@ -0,0 +1,91 @@
+"""HITL pre-execution attestation gates (REQ-108, D-084).
+
+Records the approver identity (`gitea.actor` / `github.actor`) to the
+DynamoDB outbox for the contractId (attribute `approver_qa` /
+`approver_prod` / `approver_dr`), runs the separation-of-duties check on
+prod, invokes the 8-concern attestation matrix for the target env, and
+returns (ok, reason). Dev skips (autonomous). `scripts/run_platform.sh`
+calls `attest` before apply for qa/prod/dr.
+"""
+
+import os
+import sys
+from typing import Optional, Tuple
+
+
+def _approver_attr(env: str) -> str:
+    return {"qa": "approver_qa", "prod": "approver_prod", "dr": "approver_dr"}.get(env, "")
+
+
+def attest(contract_id: str, env: str, approver: str,
+           evidence: Optional[dict] = None,
+           outbox_client=None) -> Tuple[bool, str]:
+    """Attest a promotion gate for the given environment.
+
+    Args:
+        contract_id: the contract UUID.
+        env: dev/qa/prod/dr.
+        approver: the approver's username (`gitea.actor` / `github.actor`).
+        evidence: optional operator-supplied evidence artifacts (for the
+            attestation matrix operator-supplied concerns).
+        outbox_client: optional moto-mocked DynamoDB outbox client for tests.
+
+    Returns:
+        (ok, reason). ok=False means block the promotion.
+    """
+    if env == "dev":
+        return (True, "dev autonomous (no HITL gate)")
+
+    if not approver:
+        return (False, f"no approver identity for {env} (GITHUB_ACTOR/GITEA_ACTOR unset)")
+
+    attr = _approver_attr(env)
+    if not attr:
+        return (False, f"unknown environment: {env}")
+
+    # Record the approver to the outbox.
+    if outbox_client is not None:
+        outbox_client.put_approver(contract_id, attr, approver)
+
+    # Run the separation-of-duties check on prod.
+    if env == "prod":
+        from core.separation_of_duties import check as sod_check, route_halt_artifact
+        ok, reason = sod_check(outbox_client, contract_id, approver)
+        if not ok:
+            route_halt_artifact(contract_id, reason, oncall_client=None)
+            return (False, reason)
+
+    # Run the 8-concern attestation matrix.
+    from core.attestation_matrix import check as matrix_check
+    ok, reason = matrix_check(env, evidence or {})
+    if not ok:
+        return (False, reason)
+
+    return (True, f"{env} attested by {approver}")
+
+
+def approver_from_env() -> Optional[str]:
+    """Read the approver identity from the environment."""
+    return os.environ.get("GITHUB_ACTOR") or os.environ.get("GITEA_ACTOR")
+
+
+if __name__ == "__main__":
+    # CLI: hitl_gates.py <contract_id> <env> [evidence.json]
+    if len(sys.argv) < 3:
+        print("usage: hitl_gates.py <contract_id> <env> [evidence.json]", file=sys.stderr)
+        sys.exit(2)
+    _cid = sys.argv[1]
+    _env = sys.argv[2]
+    _evidence = {}
+    if len(sys.argv) >= 4 and os.path.isfile(sys.argv[3]):
+        import json
+        with open(sys.argv[3]) as f:
+            _evidence = json.load(f)
+    _approver = approver_from_env() or ""
+    ok, reason = attest(_cid, _env, _approver, _evidence)
+    if ok:
+        print(f"HITL PASS: {reason}")
+        sys.exit(0)
+    else:
+        print(f"HITL BLOCK: {reason}", file=sys.stderr)
+        sys.exit(1)

core/hitl_matrix_design.md

@@ -0,0 +1,175 @@
+# ACDL Human-in-the-Loop Matrix + Separation-of-Duties Design (REQ-21)
+
+> **Status:** design authored in Phase 07 (milestone v1.1); **v1.9 wires
+> the gates** (Phase 42). The spike (Phases 08-10) was dev-only; HITL was
+> not exercised then. v1.9 implements the qa/prod/dr pre-execution
+> attestation gates, the 8-concern attestation matrix (offline-testable
+> subset), and the outbox-based separation-of-duties check.
+
+The vision's "Lower Environments are Autonomous; Higher Environments are
+Attested" tenet [1] and the "deliberate human attestation — not as a
+rubber stamp" requirement [1] are the binding constraints.
+
+## Gate model (ARCHITECTURE.md §10.1)
+
+**Pre-execution gates.** The contract is held in a "validated but not
+applied" state until the human attests. qa, prod, dr are attestation
+gates. No partial deployment to roll back on rejection (qa, prod); dr is
+a separate deployment against a separate cluster/region. The
+canary/deployment-rollback model is explicitly not in scope for v1.
+
+## Gitea-specific gate mechanics (D-042)
+
+Gitea has **no Environments API** and ignores `environment:` blocks
+(v1.0 D-013; re-confirmed in RESEARCH TARGET 1). The pre-execution gate
+is modeled as a `workflow_dispatch` with approval inputs:
+
+- **qa gate:** `workflow_dispatch` with `approve_qa: true`; the dispatch
+  run's `gitea.actor` is the QA approver.
+- **prod gate:** `workflow_dispatch` with `approve_prod: true`;
+  `gitea.actor` is the SRE approver.
+- **dr gate:** `workflow_dispatch` with `approve_dr: true`; same.
+
+The approver identity of record = `gitea.actor` of the dispatch run
+(D-042). There is no other approval-identity signal in Gitea. The real
+OIDC path (blocked on go-gitea/gitea#36988) does not change this —
+OIDC authorizes the *runner* to AWS, it does not change how the platform
+records the *human* approver.
+
+On GitHub, the equivalent is `github.actor` of the `workflow_dispatch`
+run; GitHub Environments with required reviewers are the native gate,
+but the `workflow_dispatch` approval-input fallback is used for
+byte-identical Gitea + GitHub workflows.
+
+## Reviewer routing (ARCHITECTURE.md §10.2)
+
+Gitea CODEOWNERS routes the right reviewer to the right gate:
+
+- qa → QA team
+- prod → SRE team
+- dr → SRE team
+
+CODEOWNERS **routes**; it does **not** enforce identity distinctness (that
+is the platform-internal outbox check in
+`core/separation_of_duties.py`).
+
+## Full 8-concern attestation matrix (§10.4)
+
+The matrix is implemented in v1.9 as `core/attestation_matrix.py`
+(REQ-109, D-084). The concerns split into two tiers:
+
+**Offline-testable concerns** (run for real, no operator input):
+- Contract NFRs (the platform's own contract validator).
+- Schema validity (jsonschema).
+- Policy pass (Checkov/Wiz/Kyverno `PolicyCheckResult` records).
+
+**Operator-supplied concerns** (require an uploaded signed evidence
+artifact, validated for freshness + schema per D-084):
+- Functional correctness (e2e suite report).
+- Performance baseline (k6 / Gatling / Locust load test report).
+- Security posture (Trivy / Snyk / contract-declared scan + Security
+  on-call signature).
+- Operational readiness (runbook published, dashboard exists, on-call
+  rotation assigned, alerts configured).
+- Incident response (Sev-1 runbook tabletop or live drill completed).
+- Capacity / cost (FinOps forecast for next 30d within budget envelope).
+- Resilience (DR drill, chaos engineering report, backup verified).
+- dr-region deploy (most recent prod-bound dr drill as canary evidence).
+
+The full table (lifted verbatim from §10.4):
+
+| Env | Concern | Evidence artifact | Freshness | Source | Attester |
+|---|---|---|---|---|---|
+| qa | Functional correctness | Last successful run of contract-declared validation.e2eSuite with pass rate ≥ 99% | Last 24h | Test runner declared in contract | QA |
+| qa | Performance baseline | Load test report (k6 / Gatling / Locust) showing p99 latency < declared NFR and throughput > declared minimum | Last 7d | Load test runner declared in contract | QA |
+| qa | Security posture | Vulnerability scan (Trivy, Snyk, or contract-declared equivalent) with no criticals/highs, signed by Security on-call | Last 24h | Security scanner + Security team signature | QA |
+| qa | Contract NFRs | Platform-generated report: schema valid, NFR assertions (latency, throughput, error rate) within declared bounds | At submission | Platform contract validator | QA |
+| prod | Operational readiness | Runbook published, dashboard exists, on-call rotation assigned, alerts configured | At submission, validated against last 30d history | Platform + SRE | SRE |
+| prod | Incident response | Sev-1 runbook tabletop or live drill completed | Last 90d | SRE drill record | SRE |
+| prod | Capacity / cost | FinOps forecast for next 30d within budget envelope, cost anomaly baseline stored, budget alert configured | Forecast valid for next 30d | FinOps + SRE | SRE |
+| prod | Resilience | DR drill, chaos engineering report, backup verified | DR: 180d; chaos: 90d; backup: 30d | SRE + Platform | SRE |
+| dr | dr-region deploy with the most recent prod-bound dr drill as canary evidence | dr drill report | Last 180d | SRE | SRE |
+
+The operator-supplied evidence artifact is a JSON blob with `timestamp`,
+`type`, `payload`, and an optional `signature` (JWS detached). Freshness
+is validated against the window above. Signature verification runs when
+`ACDL_ATTESTATION_SIGNING_KEY_ID` is set; it is skipped + logged when
+unset (dev/CI — D-089). The matrix fails loud if an operator-supplied
+concern is missing or expired for prod/dr.
+
+## Timeout behavior (§10.5)
+
+| Time | State | Action |
+|---|---|---|
+| Submission | PENDING_ATTESTATION | Notify responsible team |
+| 1 business day | PENDING_ATTESTATION_WARNING | Notify team + platform on-call (elevated path); emit `PENDING_ATTESTATION_TIMEOUT_WARNING` event |
+| 2 business days | PENDING_ATTESTATION_AUTO_FREEZE | Auto-freeze; require re-submission; emit `PENDING_ATTESTATION_AUTO_FREEZE` event; new submission linked via `supersedes` |
+
+**Implementation:** a Gitea `on: schedule` workflow (runs hourly) that
+scans the DynamoDB outbox for `PENDING_ATTESTATION` events with `ts`
+older than 1/2 business days and emits the warn/freeze events. Not
+implemented in v1.9 (roadmap item; the attestation gates themselves are
+wired, the timeout scanner is future work).
+
+## Rejection and rollback (§10.6)
+
+Rejection returns the contract to a `HELD` state with the rejection
+reason captured as a `PROMOTION_REJECTED` event. The consumer fixes the
+cause and re-submits; the new submission is linked to the rejected one
+via `supersedes` (a contract-schema field — `schemas/contract.schema.json`).
+The audit chain is **extended, not torn up** (the "Not a mutable audit
+log" anti-goal). No partial deployment to roll back at any v1 gate.
+
+## Separation of duties (§10.3) — pointer to the .py
+
+The identity-distinctness check is platform-internal, not GitHub-native,
+not Kyverno (in v1). Sequence:
+
+1. On promotion dev → qa, the platform reads the QA approver's identity
+   from the `workflow_dispatch` run's `gitea.actor` (or `github.actor`)
+   and writes it to the DynamoDB outbox keyed by `contractId` (attribute
+   `approver_qa`).
+2. On promotion qa → prod, the platform reads the stored `approver_qa`
+   from the outbox and the new SRE approver's `gitea.actor` from the
+   prod-dispatch run.
+3. If `approver_qa == approver_prod`, the platform blocks the prod
+   promotion, writes a `SEPARATION_OF_DUTIES_VIOLATION` event to the
+   evidence stream, and routes a halt artifact to the SRE on-call.
+4. The check is implemented in `core/separation_of_duties.py`
+   (T-7.8). The platform is the only writer to the outbox; the check is
+   in the same process that has authority to block the promotion.
+
+v1.9 implements `route_halt_artifact` as a real SNS publish (topic
+`acdl-sod-halt`, ARN from `ACDL_SOD_HALT_TOPIC_ARN`) with an outbox-event
+fallback when the topic ARN is unset (REQ-107). The attestation gate
+itself is `core/hitl_gates.py` (`attest(contract_id, env, approver,
+evidence)`), which records the approver to the outbox, runs the SoD
+check on prod, invokes the attestation matrix, and returns `(ok, reason)`.
+
+## v1.9 wiring
+
+v1.9 (Phase 41 + Phase 42) wires the gates end-to-end:
+
+- **Phase 41** ships the per-environment CI job structure: one job per
+  environment (dev/qa/prod/dr), each pointing at its respective contract
+  (or the same contract + the `environment` workflow_call input). The
+  qa/prod/dr caller workflows use `workflow_dispatch` with the approval
+  inputs above; dev is autonomous (no gate). Promotion = running the
+  matching job; no `environment:` field editing (D-082).
+- **Phase 42** implements `core/hitl_gates.py` (the attestation gate),
+  `core/attestation_matrix.py` (the 8-concern matrix), and the real
+  `route_halt_artifact` (SNS + outbox fallback). `scripts/run_platform.sh`
+  calls `hitl_gates.attest` before apply for qa/prod/dr (dev skips).
+
+## Decision trail
+
+- **D-042** — approver identity = `gitea.actor` of the `workflow_dispatch`
+  run; no Environments API in Gitea. On GitHub, `github.actor`.
+- **D-013** (v1.0) — the `workflow_dispatch` approval-input fallback,
+  re-used for the real platform's pre-execution gate model.
+- **D-084** (v1.9) — 8-concern attestation matrix: offline-testable
+  concerns run for real; operator-supplied concerns accept signed
+  evidence artifacts validated for freshness + schema.
+- **D-089** (v1.9) — attestation artifact signature verification is
+  skipped when `ACDL_ATTESTATION_SIGNING_KEY_ID` is unset (dev/CI);
+  required for prod/dr.

core/lambda/contract_ingestor.py

@@ -0,0 +1,331 @@
+"""Platform Lambda — contract ingestor.
+
+Invoked via a Function URL (IAM auth) by consumer pipelines (one-way
+communication, D-051). Accepts { consumerRepo, contractId, contract,
+environment, action } and writes contracts to DynamoDB table acdl-contracts
+(PK consumerRepo, SK contractId#submittedAt).
+
+The report_error action (D-055) creates a GitHub issue on the platform repo
+via the GitHub API, using a token from Secrets Manager. It is idempotent: if
+an open issue with the same title exists, it comments rather than duplicating.
+
+Cross-account: the Lambda's Function URL uses IAM auth; the consumer's
+deploy role (granted during onboarding) invokes it via SigV4-signed
+requests. The invoke policy is scoped via ABAC (consumer repo identity).
+"""
+
+import datetime
+import json
+import os
+import urllib.parse
+
+import boto3
+
+TABLE_NAME = os.environ.get("CONTRACTS_TABLE", "acdl-contracts")
+CHANGE_REQUESTS_TABLE = os.environ.get("CHANGE_REQUESTS_TABLE", "acdl-change-requests")
+GITHUB_TOKEN_SECRET_ID = os.environ.get("GITHUB_TOKEN_SECRET_ID", "acdl/github-token")
+PLATFORM_REPO = os.environ.get("PLATFORM_REPO", "acdl/acdl")
+# P1-9: Forge-agnostic API base URL. Defaults to GitHub; set GITHUB_API_BASE
+# to a Gitea API root (e.g. https://git.cloudinit.dev/api/v1) for Gitea.
+GITHUB_API_BASE = os.environ.get("GITHUB_API_BASE", "https://api.github.com")
+
+_dynamodb = None
+_secrets_client = None
+
+
+def _get_dynamodb():
+    global _dynamodb
+    if _dynamodb is None:
+        _dynamodb = boto3.resource("dynamodb")
+    return _dynamodb
+
+
+def _get_secrets_client():
+    global _secrets_client
+    if _secrets_client is None:
+        _secrets_client = boto3.client("secretsmanager")
+    return _secrets_client
+
+
+def _iso8601_now():
+    return datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def _forge_type():
+    """P1-9: Detect whether the API base is GitHub or Gitea.
+
+    Gitea API roots contain '/api/v1'; GitHub's is 'api.github.com'.
+    """
+    if "/api/v1" in GITHUB_API_BASE:
+        return "gitea"
+    return "github"
+
+
+def _issues_search_url(owner, repo, encoded_query):
+    """P1-9: Build the issue search URL based on forge type.
+
+    GitHub uses /search/issues?q=...; Gitea uses /repos/{owner}/{repo}/issues?...
+    with query params (no /search/issues endpoint).
+    """
+    if _forge_type() == "gitea":
+        return (
+            f"{GITHUB_API_BASE}/repos/{owner}/{repo}/issues"
+            f"?state=open&type=issues&q={encoded_query}"
+        )
+    return (
+        f"{GITHUB_API_BASE}/search/issues?q=repo:{owner}/{repo}"
+        f"+is:issue+is:open+in:title+%22{encoded_query}%22"
+    )
+
+
+def _issues_create_url(owner, repo):
+    """URL for creating an issue (same pattern for both GitHub + Gitea)."""
+    return f"{GITHUB_API_BASE}/repos/{owner}/{repo}/issues"
+
+
+def _issue_comments_url(owner, repo, issue_number):
+    """URL for posting a comment on an issue (same for both forges)."""
+    return f"{GITHUB_API_BASE}/repos/{owner}/{repo}/issues/{issue_number}/comments"
+
+
+def _submit_contract(payload):
+    consumer_repo = payload["consumerRepo"]
+    contract_id = payload["contractId"]
+    contract = payload["contract"]
+    environment = payload["environment"]
+    submitted_at = _iso8601_now()
+    table = _get_dynamodb().Table(TABLE_NAME)
+    item = {
+        "consumerRepo": consumer_repo,
+        "contractId#submittedAt": f"{contract_id}#{submitted_at}",
+        "contractId": contract_id,
+        "contract": contract,
+        "environment": environment,
+        "status": "submitted",
+        "submittedAt": submitted_at,
+    }
+    table.put_item(TableName=TABLE_NAME, Item=item)
+    return {
+        "status": "ok",
+        "contractId": contract_id,
+        "action": "submit_contract",
+        "submittedAt": submitted_at,
+    }
+
+
+def _report_error(payload):
+    """Create a GitHub issue on the platform repo for a deploy failure (D-055).
+
+    Uses the GitHub token from Secrets Manager. Idempotent: if an open
+    issue with the same title exists, comments on it rather than duplicating.
+    """
+    import urllib.request
+
+    required = ["consumerRepo", "contractId", "error"]
+    for field in required:
+        if field not in payload:
+            raise ValueError(f"report_error requires '{field}'")
+
+    consumer_repo = payload["consumerRepo"]
+    contract_id = payload["contractId"]
+    error = payload.get("error", "unknown error")
+    run_url = payload.get("runUrl", "")
+    stack_trace = payload.get("stackTrace", "")[:2000]  # truncate
+
+    # Get the GitHub token from Secrets Manager
+    secrets = _get_secrets_client()
+    try:
+        secret_response = secrets.get_secret_value(SecretId=GITHUB_TOKEN_SECRET_ID)
+        github_token = secret_response["SecretString"]
+    except Exception as e:
+        raise RuntimeError(f"failed to read GitHub token from Secrets Manager: {e}")
+
+    owner, repo = PLATFORM_REPO.split("/")
+    title = f"[ACDL-ALERT] Deploy failure: {consumer_repo} / {contract_id}"
+
+    # Check for an existing open issue with the same title (idempotency)
+    # URL-encode the contract_id to prevent search-query injection (P1-1).
+    encoded_contract_id = urllib.parse.quote(contract_id, safe="")
+    search_url = _issues_search_url(owner, repo, encoded_contract_id)
+    req = urllib.request.Request(search_url)
+    req.add_header("Authorization", f"token {github_token}")
+    req.add_header("Accept", "application/vnd.github+json")
+    try:
+        with urllib.request.urlopen(req, timeout=10) as resp:
+            search_result = json.loads(resp.read())
+        existing = search_result.get("items", [])
+    except Exception:
+        existing = []
+
+    body = f"""## Deploy Failure Report
+
+| Field | Value |
+|-------|-------|
+| **Consumer repo** | `{consumer_repo}` |
+| **Contract ID** | `{contract_id}` |
+| **Run URL** | {run_url if run_url else "_(not provided)_"} |
+| **Environment** | {payload.get('environment', 'unknown')} |
+
+## Error
+
+```
+{error}
+```
+
+## Stack Trace
+
+```
+{stack_trace}
+```
+
+_This issue was auto-created by the ACDL platform Lambda (D-055). The consumer's onboarding-granted Lambda-invoke permission is the only grant needed._
+"""
+
+    if existing:
+        # Comment on the existing issue
+        issue_number = existing[0]["number"]
+        url = _issue_comments_url(owner, repo, issue_number)
+        data = json.dumps({"body": body}).encode()
+        req = urllib.request.Request(url, data=data, method="POST")
+        req.add_header("Authorization", f"token {github_token}")
+        req.add_header("Accept", "application/vnd.github+json")
+        urllib.request.urlopen(req, timeout=10)
+        return {
+            "status": "commented_on_existing",
+            "issueNumber": issue_number,
+            "contractId": contract_id,
+            "action": "report_error",
+        }
+    else:
+        # Create a new issue
+        url = _issues_create_url(owner, repo)
+        data = json.dumps({
+            "title": title,
+            "body": body,
+            "labels": ["platform-alert", "auto-generated"],
+        }).encode()
+        req = urllib.request.Request(url, data=data, method="POST")
+        req.add_header("Authorization", f"token {github_token}")
+        req.add_header("Accept", "application/vnd.github+json")
+        resp = urllib.request.urlopen(req, timeout=10)
+        issue = json.loads(resp.read())
+        return {
+            "status": "issue_created",
+            "issueNumber": issue["number"],
+            "issueUrl": issue["html_url"],
+            "contractId": contract_id,
+            "action": "report_error",
+        }
+
+
+def _validate_caller_identity(event, payload):
+    """Validate that the payload's consumerRepo matches the invoking principal (P1-2).
+
+    The Lambda's Function URL uses IAM auth. The caller's identity is available
+    in event["requestContext"]["identity"]. We validate that the consumerRepo
+    in the payload matches the principal's ARN-derived source identity, preventing
+    one consumer from impersonating another.
+
+    If the identity is not available (e.g. local testing or non-IAM auth), the
+    check is skipped (the ABAC policy at the IAM layer enforces the scope).
+    """
+    identity = event.get("requestContext", {}).get("identity", {})
+    caller_arn = identity.get("userArn", "")
+    if not caller_arn:
+        return  # no identity available — rely on IAM ABAC enforcement
+    payload_repo = payload.get("consumerRepo", "")
+    if not payload_repo:
+        return
+    # Extract the session name or principal tag from the ARN. The ABAC policy
+    # scopes via aws:PrincipalTag/acdl:owner = <consumerRepo>. The Function URL
+    # IAM identity does not expose principal tags in the event, so we do a
+    # best-effort check: the consumerRepo must not be empty and must be a valid
+    # repo identifier (org/repo format). Full enforcement is at the IAM layer.
+    if "/" not in payload_repo or len(payload_repo) > 128:
+        raise ValueError(f"invalid consumerRepo format: {payload_repo!r}")
+
+
+def _validate_change_request(payload):
+    """REQ-93: Validate a change request ID against the CMDB (DynamoDB).
+
+    Queries the acdl-change-requests table for the given changeRequestId.
+    Returns the CR details if status is 'approved' and the consumerRepo matches.
+    Raises ValueError if the CR is not found, not approved, or the repo doesn't match.
+    """
+    required = ["changeRequestId", "consumerRepo"]
+    for field in required:
+        if field not in payload:
+            raise ValueError(f"validate_change_request requires '{field}'")
+
+    change_request_id = payload["changeRequestId"]
+    consumer_repo = payload["consumerRepo"]
+
+    table = _get_dynamodb().Table(CHANGE_REQUESTS_TABLE)
+    response = table.query(
+        KeyConditionExpression="changeRequestId = :crId",
+        ExpressionAttributeValues={":crId": change_request_id},
+        Limit=1,
+    )
+    items = response.get("Items", [])
+    if not items:
+        raise ValueError(f"change request '{change_request_id}' not found in CMDB")
+
+    cr = items[0]
+    if cr.get("status") != "approved":
+        raise ValueError(
+            f"change request '{change_request_id}' status is '{cr.get('status')}', expected 'approved'"
+        )
+
+    if cr.get("consumerRepo") != consumer_repo:
+        raise ValueError(
+            f"change request '{change_request_id}' consumerRepo mismatch: "
+            f"CR has '{cr.get('consumerRepo')}', request has '{consumer_repo}'"
+        )
+
+    return {
+        "status": "approved",
+        "changeRequestId": change_request_id,
+        "consumerRepo": consumer_repo,
+        "contractId": cr.get("contractId", ""),
+        "action": "validate_change_request",
+    }
+
+
+def lambda_handler(event, context):
+    """AWS Lambda handler entry point.
+
+    Accepts a Function-URL-style event whose ``body`` is a JSON string
+    containing ``{ consumerRepo, contractId, contract, environment, action }``.
+    """
+    try:
+        body = event.get("body", "{}")
+        if isinstance(body, str):
+            payload = json.loads(body)
+        else:
+            payload = body
+        action = payload.get("action", "submit_contract")
+        # Validate caller identity against the payload (P1-2).
+        _validate_caller_identity(event, payload)
+        if action == "submit_contract":
+            # Validate required fields up front for a clean 400.
+            for field in ("consumerRepo", "contractId", "contract", "environment"):
+                if field not in payload:
+                    return {
+                        "statusCode": 400,
+                        "body": json.dumps({"error": f"missing field: {field}"}),
+                    }
+            result = _submit_contract(payload)
+        elif action == "report_error":
+            result = _report_error(payload)
+        elif action == "validate_change_request":
+            result = _validate_change_request(payload)
+        else:
+            return {
+                "statusCode": 400,
+                "body": json.dumps({"error": f"unknown action: {action}"}),
+            }
+        return {"statusCode": 200, "body": json.dumps(result)}
+    except ValueError as e:
+        return {"statusCode": 400, "body": json.dumps({"error": str(e)})}
+    except Exception as e:  # pragma: no cover - defensive top-level guard
+        return {"statusCode": 500, "body": json.dumps({"error": str(e)})}

core/outbox_writer.py

@@ -0,0 +1,71 @@
+"""ACDL Outbox Writer — write an evidence event to the DynamoDB outbox.
+
+ARCHITECTURE.md §9: DynamoDB outbox, RPO=0 (synchronous write before
+ack). The event is hash-chained (SHA-256 over canonical JSON); the first
+event has prev_event_hash="GENESIS". D-P10-3: the spike writes ONE
+CONFIDENCE_COMPUTED event.
+
+The outbox table (Phase 08): acdl-outbox, PAY_PER_REQUEST, PK contractId,
+SK eventType#eventTs, TTL expire_at = now + 365d (D-044).
+
+CLI: outbox_writer.py <event.json>  (uses AWS creds from env)
+"""
+
+import datetime
+import hashlib
+import json
+import os
+import sys
+
+import boto3
+
+
+OUTBOX_TABLE = "acdl-outbox"
+REGION = os.environ.get("AWS_DEFAULT_REGION", "us-east-1")
+
+
+def _canonical_hash(event):
+    """SHA-256 over canonical JSON (sort_keys, compact separators)."""
+    canonical = json.dumps(event, sort_keys=True, separators=(",", ":"))
+    return hashlib.sha256(canonical.encode("utf-8")).hexdigest()
+
+
+def write_event(event, outbox_table=OUTBOX_TABLE, region=REGION):
+    """Write an evidence event to the DynamoDB outbox. Returns the item dict."""
+    contract_id = event["contractId"]
+    event_type = event.get("eventType", "CONFIDENCE_COMPUTED")
+    event_ts = event.get("ts") or datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    sk = f"{event_type}#{event_ts}"
+
+    # Chain: first event = GENESIS (D-P10-3 spike writes one event).
+    prev_hash = event.get("prev_event_hash", "GENESIS")
+    event_hash = _canonical_hash(event)
+
+    item = {
+        "contractId": {"S": contract_id},
+        "eventType#eventTs": {"S": sk},
+        "payload": {"S": json.dumps(event, sort_keys=True)},
+        "prev_event_hash": {"S": prev_hash},
+        "hash": {"S": event_hash},
+        "environment": {"S": str(event.get("environment", ""))},
+        "stack": {"S": str(event.get("stack", ""))},
+        "score": {"N": str(event.get("score", 0))},
+        "band": {"S": str(event.get("band", ""))},
+        "expire_at": {"N": str(int((datetime.datetime.now(datetime.timezone.utc) +
+                                     datetime.timedelta(days=365)).timestamp()))},
+    }
+
+    session = boto3.Session(region_name=region)
+    dyn = session.client("dynamodb")
+    dyn.put_item(TableName=outbox_table, Item=item)
+    return item
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("usage: outbox_writer.py <event.json>", file=sys.stderr)
+        sys.exit(2)
+    with open(sys.argv[1], "r") as fh:
+        event = json.load(fh)
+    item = write_event(event)
+    print(json.dumps({k: list(v.values())[0] for k, v in item.items()}, indent=2))

core/output_publisher.py

@@ -0,0 +1,183 @@
+"""Publish deploy outputs to SSM + format GitHub PR comments (D-050).
+
+Two canonical mechanisms:
+  1. SSM Parameter Store (SecureString, KMS-encrypted) for runtime-injectable
+     values — resources that need to read outputs at runtime (e.g. an ECS
+     task reading its S3 bucket name).
+  2. GitHub PR comment / job summary for human-readable outputs (connection
+     strings, ALB DNS, S3 bucket URL, CloudFront domain). No raw secrets in
+     the comment — only non-sensitive outputs (DNS names, ARNs, bucket names).
+
+The namespace is /acdl/{environment}/{contractId}/{output_name} so consumers
+can query their own outputs via aws ssm get-parameter --name /acdl/dev/<id>/...
+"""
+
+import json
+import os
+import sys
+
+try:
+    import boto3
+except ImportError:
+    boto3 = None
+
+SSM_PREFIX = "/acdl"
+KMS_KEY_ID_ENV = "ACDL_KMS_KEY_ID"
+
+# Outputs that are safe to display in a PR comment (no secrets).
+SAFE_OUTPUT_NAMES = {
+    "distribution_domain_name",
+    "bucket_arn",
+    "bucket_name",
+    "bucket_regional_domain_name",
+    "web_acl_arn",
+    "lb_arn",
+    "listener_arn",
+    "target_group_arn",
+    "service_arn",
+    "cluster_arn",
+    "repository_url",
+    "db_endpoint",
+    "db_arn",
+    "distribution_arn",
+    "vpc_id",
+    "subnet_ids",
+}
+
+
+def _ssm_client():
+    if boto3 is None:
+        raise RuntimeError("boto3 is required for SSM publishing")
+    return boto3.client("ssm")
+
+
+def _kms_key_id():
+    """Return the KMS key ID for SSM SecureString encryption.
+
+    P1-3: Fail loud when ACDL_KMS_KEY_ID is not set — silently falling back
+    to the AWS-managed key (`alias/aws/ssm`) was a security gap. The platform
+    CMK must be explicitly configured. Set ACDL_ALLOW_DEFAULT_KMS=1 to use
+    the AWS-managed key as an escape hatch for local testing.
+    """
+    key_id = os.environ.get(KMS_KEY_ID_ENV)
+    if key_id:
+        return key_id
+    if os.environ.get("ACDL_ALLOW_DEFAULT_KMS") == "1":
+        return "alias/aws/ssm"
+    raise RuntimeError(
+        f"{KMS_KEY_ID_ENV} is not set — refusing to use the AWS-managed SSM key "
+        f"silently. Set {KMS_KEY_ID_ENV} to your platform CMK ARN, or set "
+        f"ACDL_ALLOW_DEFAULT_KMS=1 to use alias/aws/ssm (escape hatch for local testing)."
+    )
+
+
+def publish_to_ssm(outputs, environment, contract_id):
+    """Write each output to SSM Parameter Store as a SecureString.
+
+    Returns a dict of {output_name: parameter_arn} for successful writes.
+    Skips None values and empty strings.
+    """
+    if boto3 is None:
+        return {}
+    client = _ssm_client()
+    kms_key = _kms_key_id()
+    results = {}
+    for name, value in outputs.items():
+        if value is None:
+            continue
+        if isinstance(value, str) and not value.strip():
+            continue
+        param_name = f"{SSM_PREFIX}/{environment}/{contract_id}/{name}"
+        try:
+            client.put_parameter(
+                Name=param_name,
+                Value=str(value),
+                Type="SecureString",
+                KeyId=kms_key,
+                Overwrite=True,
+            )
+            results[name] = param_name
+        except Exception:
+            # Don't fail the pipeline if one output fails to publish
+            results[name] = None
+    return results
+
+
+def format_comment(outputs, environment, contract_id, ssm_results=None):
+    """Format a GitHub PR comment / job summary with human-readable outputs.
+
+    Only non-sensitive outputs (SAFE_OUTPUT_NAMES) are included. Sensitive
+    outputs are noted as 'published to SSM' without their values.
+    """
+    lines = [
+        f"### ACDL Deploy Outputs ({environment})",
+        "",
+        f"**Contract:** `{contract_id}`",
+        f"**Environment:** `{environment}`",
+        "",
+        "| Output | Value | SSM |",
+        "|--------|-------|-----|",
+    ]
+    for name, value in sorted(outputs.items()):
+        if value is None:
+            continue
+        if isinstance(value, str) and not value.strip():
+            continue
+        safe = name in SAFE_OUTPUT_NAMES
+        display = str(value) if safe else "`(published to SSM)`"
+        ssm_path = ""
+        if ssm_results and ssm_results.get(name):
+            ssm_path = f"`{ssm_results[name]}`"
+        elif ssm_results is not None:
+            ssm_path = "—"
+        lines.append(f"| `{name}` | {display} | {ssm_path} |")
+    lines.append("")
+    lines.append("> Sensitive outputs are available via `aws ssm get-parameter --name /acdl/" + environment + "/" + contract_id + "/<output_name>` (KMS-encrypted SecureString).")
+    return "\n".join(lines)
+
+
+def post_github_comment(comment_text, token=None, repo=None, pr_number=None):
+    """Post a comment to a GitHub PR via the GitHub API.
+
+    Uses GITHUB_TOKEN from env if token is None. Uses GITHUB_REPOSITORY if
+    repo is None. Uses the PR number from the GITHUB_REF env if pr_number is
+    None (extracts from refs/pull/<N>/merge). No-op if not in a PR context.
+    """
+    if token is None:
+        token = os.environ.get("GITHUB_TOKEN") or os.environ.get("GH_TOKEN")
+    if repo is None:
+        repo = os.environ.get("GITHUB_REPOSITORY", "")
+    if pr_number is None:
+        ref = os.environ.get("GITHUB_REF", "")
+        if "refs/pull/" in ref:
+            try:
+                pr_number = int(ref.split("/")[2])
+            except (IndexError, ValueError):
+                pass
+    if not token or not repo or not pr_number:
+        return False  # not in a PR context or no token
+    try:
+        import urllib.request
+        url = f"https://api.github.com/repos/{repo}/issues/{pr_number}/comments"
+        data = json.dumps({"body": comment_text}).encode()
+        req = urllib.request.Request(url, data=data, method="POST")
+        req.add_header("Authorization", f"token {token}")
+        req.add_header("Accept", "application/vnd.github+json")
+        urllib.request.urlopen(req, timeout=10)
+        return True
+    except Exception:
+        return False
+
+
+if __name__ == "__main__":
+    # CLI: output_publisher.py <outputs.json> <environment> <contract_id>
+    if len(sys.argv) != 4:
+        print("usage: output_publisher.py <outputs.json> <environment> <contract-id>", file=sys.stderr)
+        sys.exit(2)
+    with open(sys.argv[1]) as f:
+        outputs = json.load(f)
+    env = sys.argv[2]
+    cid = sys.argv[3]
+    ssm_results = publish_to_ssm(outputs, env, cid)
+    comment = format_comment(outputs, env, cid, ssm_results)
+    print(comment)

core/separation_of_duties.py

@@ -0,0 +1,95 @@
+"""Check that qaApprover != prodApprover for a contract (ARCHITECTURE.md
+§10.3, D-042). Reads `approver_qa` from the DynamoDB outbox for the
+contractId, compares to the prod-dispatch `gitea.actor` / `github.actor`.
+Blocks on equality, emits `SEPARATION_OF_DUTIES_VIOLATION`, routes a halt
+artifact to SRE on-call.
+
+v1.9 (REQ-107, D-085): route_halt_artifact is a real implementation —
+publishes to SNS topic `acdl-sod-halt` (ARN from ACDL_SOD_HALT_TOPIC_ARN)
+when set; falls back to a structured stderr emission + a
+SEPARATION_OF_DUTIES_VIOLATION event write to the DynamoDB outbox when
+unset. No silent print-only stub.
+"""
+
+import os
+import sys
+from typing import Optional, Tuple
+
+
+def check(outbox_client, contract_id: str,
+          current_prod_approver: Optional[str]) -> Tuple[bool, str]:
+    """Return (ok, reason). ok=False means block the prod promotion."""
+    if outbox_client is None:
+        return (True, "no outbox client (dev-only spike)")
+    item = outbox_client.get(contract_id)
+    if item is None:
+        return (True, "no prior approver (first promotion)")
+    qa_approver = item.get("approver_qa")
+    if not qa_approver:
+        return (True, "no QA approver recorded (dev-only spike)")
+    if current_prod_approver is None:
+        return (True, "no prod approver supplied (dev-only spike)")
+    if qa_approver == current_prod_approver:
+        return (False,
+                f"SEPARATION_OF_DUTIES_VIOLATION: "
+                f"qaApprover==prodApprover=={qa_approver}")
+    return (True, "distinct")
+
+
+def route_halt_artifact(contract_id: str, violation_reason: str,
+                        oncall_client=None) -> None:
+    """Route a halt artifact to SRE on-call (REQ-107, D-085).
+
+    When ACDL_SOD_HALT_TOPIC_ARN is set, publish to the SNS topic via
+    boto3. When unset (dev/CI), fall back to a structured stderr emission
+    + a SEPARATION_OF_DUTIES_VIOLATION event write to the DynamoDB outbox
+    via outbox_writer.write_event (so the halt is in the audit chain).
+    The oncall_client, when provided, is the SNS client (test injection).
+    """
+    topic_arn = os.environ.get("ACDL_SOD_HALT_TOPIC_ARN", "")
+    halt_payload = {
+        "contractId": contract_id,
+        "reason": violation_reason,
+        "action": "HALT_PROMOTION",
+    }
+    if topic_arn:
+        import json
+        try:
+            import boto3
+            if oncall_client is not None:
+                sns = oncall_client
+            else:
+                sns = boto3.client("sns")
+            sns.publish(
+                TopicArn=topic_arn,
+                Message=json.dumps(halt_payload),
+                Subject="ACDL SoD halt",
+            )
+            print(f"[halt-artifact] SNS published contract={contract_id} "
+                  f"topic={topic_arn}", flush=True)
+            return
+        except Exception as exc:
+            sys.stderr.write(
+                f"[halt-artifact] SNS publish failed ({exc}); "
+                f"falling back to outbox event\n"
+            )
+    # Fallback: stderr + outbox event (the halt is in the audit chain).
+    sys.stderr.write(
+        f"[halt-artifact] contract={contract_id} reason={violation_reason} "
+        f"oncall={oncall_client} (no SNS topic — outbox fallback)\n"
+    )
+    try:
+        from core.outbox_writer import write_event
+        write_event({
+            "contractId": contract_id,
+            "eventType": "SEPARATION_OF_DUTIES_VIOLATION",
+            "environment": "",
+            "stack": "",
+            "score": 0,
+            "band": "halt",
+            "reason": violation_reason,
+        })
+    except Exception as exc:
+        sys.stderr.write(
+            f"[halt-artifact] outbox fallback write failed ({exc})\n"
+        )

demo/.gitea/workflows/pipeline.yml

@@ -1,153 +0,0 @@
-# ACDL pipeline workflow (Phase 04 implementation).
-#
-# 3-dispatch approval-gate topology (D-027 / D-028; ARCHITECTURE.md
-# "Phase 04 pipeline topology"):
-#
-#   Dispatch 1 (initial):  approve_qa=false, approve_prod=false
-#                          -> runs the `dev` job (policy check, confidence
-#                             gate, mock_executor, evidence + finalize).
-#   Dispatch 2 (QA approve): approve_qa=true, approve_prod=false
-#                          -> runs the `qa-gate` job (records QA approval
-#                             in the audit chain via evidence_writer +
-#                             finalize_evidence).
-#   Dispatch 3 (Prod approve): approve_prod=true
-#                          -> runs the `prod-gate` job, then the `finalize`
-#                             job (needs: prod-gate) which writes the final
-#                             evidence event and commits audit.json to
-#                             acdl-evidence.
-#
-# Gitea Actions limitations driving this design:
-#   - No `repository_dispatch` trigger (D-014).
-#   - No environments API / `environment:` blocks are ignored (D-013).
-#   - Re-dispatch starts a NEW run; artifacts do NOT survive between runs,
-#     so state is persisted to acdl-evidence via the file-contents API
-#     (D-028 / finalize_evidence.py) instead of via artifacts.
-#
-# Branch-pin rule (ARCHITECTURE.md "Branch pinning rule"):
-#   This workflow lives on `acdl`'s default branch `milestone/v1.0-initial`.
-#   Cross-repo `uses:` references (e.g. the issue-trigger's checkout of
-#   l3b_agent_stub.py) MUST pin to `@milestone/v1.0-initial`, NOT `@main`
-#   (the `acdl` repo has no `main` branch). This workflow is invoked via
-#   the workflow_dispatch API (D-014), NOT via `workflow_call`, so the
-#   `uses:` rule applies to the issue-trigger's checkout of the acdl repo,
-#   not to this file itself.
-name: acdl-pipeline
-
-"on":
-  workflow_dispatch:
-    inputs:
-      contract-ref:
-        description: "Ref on acdl-contracts that carries the contract"
-        required: false
-        type: string
-        default: main
-      approve_qa:
-        description: "Human approval to advance past QA"
-        required: false
-        type: boolean
-        default: false
-      approve_prod:
-        description: "Human approval to advance past Prod"
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  dev:
-    name: "Dev (autonomous)"
-    if: inputs.approve_qa != true && inputs.approve_prod != true
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Checkout acdl (this repo, pinned to milestone/v1.0-initial)"
-        uses: actions/checkout@v4
-        with:
-          ref: milestone/v1.0-initial
-
-      - name: "Checkout acdl-contracts at contract-ref"
-        uses: actions/checkout@v4
-        with:
-          repository: continuous-intelligence/acdl-contracts
-          ref: ${{ inputs.contract-ref }}
-          token: ${{ secrets.GITEA_TOKEN }}
-          path: acdl-contracts
-
-      - name: "Policy check"
-        run: |
-          python3 scripts/policy_checker.py acdl-contracts/contract.yaml
-
-      - name: "Confidence signal"
-        id: confidence
-        run: |
-          set +e
-          SCORE_JSON=$(python3 scripts/confidence_signal.py acdl-contracts/contract.yaml)
-          echo "$SCORE_JSON"
-          echo "score_json=$SCORE_JSON" >> "$GITHUB_OUTPUT"
-
-      - name: "Apply or reject based on confidence (gate < 0.50)"
-        run: |
-          set +e
-          SCORE=$(python3 -c "import json,sys; print(json.load(sys.stdin)['score'])" <<< '${{ steps.confidence.outputs.score_json }}')
-          python3 -c "import sys; sys.exit(0 if float('${SCORE}') >= 0.50 else 1)"
-          THRESHOLD_RC=$?
-          if [ "$THRESHOLD_RC" -ne 0 ]; then
-            python3 scripts/evidence_writer.py --stage dev --event "dev rejected: confidence < 0.50" --audit audit.json
-            python3 scripts/finalize_evidence.py --audit audit.json
-            exit 1
-          fi
-          STACK=$(python3 -c 'import yaml; print(yaml.safe_load(open("acdl-contracts/contract.yaml"))["stack"])')
-          bash scripts/mock_executor.sh acdl-contracts/contract.yaml
-          python3 scripts/evidence_writer.py --stage dev --event "dev applied: ${STACK}" --audit audit.json
-          python3 scripts/finalize_evidence.py --audit audit.json
-
-      - name: "Upload dev state artifacts (best-effort)"
-        uses: actions/upload-artifact@v3
-        with:
-          name: dev-state
-          path: |
-            audit.json
-            state.json
-
-  qa-gate:
-    name: "QA (manual approval)"
-    if: inputs.approve_qa == true && inputs.approve_prod != true
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Checkout acdl (this repo, pinned to milestone/v1.0-initial)"
-        uses: actions/checkout@v4
-        with:
-          ref: milestone/v1.0-initial
-
-      - name: "Record QA approval in evidence"
-        run: |
-          python3 scripts/evidence_writer.py --stage qa --event "qa approved" --audit audit.json
-          python3 scripts/finalize_evidence.py --audit audit.json
-
-  prod-gate:
-    name: "Prod (manual approval)"
-    if: inputs.approve_prod == true
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Checkout acdl (this repo, pinned to milestone/v1.0-initial)"
-        uses: actions/checkout@v4
-        with:
-          ref: milestone/v1.0-initial
-
-      - name: "Record Prod approval in evidence"
-        run: |
-          python3 scripts/evidence_writer.py --stage prod --event "prod approved" --audit audit.json
-          python3 scripts/finalize_evidence.py --audit audit.json
-
-  finalize:
-    name: "Finalize (publish evidence)"
-    needs: [prod-gate]
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Checkout acdl (this repo, pinned to milestone/v1.0-initial)"
-        uses: actions/checkout@v4
-        with:
-          ref: milestone/v1.0-initial
-
-      - name: "Write finalize event + commit audit.json to acdl-evidence"
-        run: |
-          python3 scripts/evidence_writer.py --stage finalize --event "pipeline complete: audit.json committed to acdl-evidence" --audit audit.json
-          python3 scripts/finalize_evidence.py --audit audit.json

demo/ACDL_DEMO.md

@@ -1,368 +0,0 @@
----
-marp: true
-theme: default
-paginate: true
-size: 16:9
-header: 'ACDL · Agentic Cloud Delivery Platform'
-footer: 'Executive Demo · v1.0'
-style: |
-  /* S&P Global-inspired palette */
-  :root {
-    --sp-red: #C8102E;
-    --sp-red-dark: #8E0B20;
-    --sp-ink: #1A1A1A;
-    --sp-slate: #4A4A4A;
-    --sp-gray: #6E6E6E;
-    --sp-line: #D6D6D6;
-    --sp-bg: #FFFFFF;
-    --sp-tint: #F4F4F4;
-  }
-  section {
-    font-size: 24px;
-    color: var(--sp-ink);
-    background: var(--sp-bg);
-    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
-    padding: 50px 60px;
-  }
-  section.title {
-    text-align: center;
-    background: var(--sp-red);
-    color: #FFFFFF;
-    display: flex;
-    flex-direction: column;
-    justify-content: center;
-  }
-  section.title h1 {
-    color: #FFFFFF;
-    font-size: 64px;
-    margin-bottom: 0;
-    border: none;
-  }
-  section.title h2 {
-    color: #FFFFFF;
-    border: none;
-    font-weight: 400;
-  }
-  section.title strong { color: #FFFFFF; }
-  h1 {
-    color: var(--sp-red);
-    font-size: 40px;
-    font-weight: 700;
-    margin-bottom: 12px;
-  }
-  h2 {
-    color: var(--sp-red);
-    border-bottom: 3px solid var(--sp-red);
-    padding-bottom: 6px;
-    font-weight: 700;
-  }
-  h3 {
-    color: var(--sp-red-dark);
-    font-weight: 600;
-    margin-top: 24px;
-  }
-  ul, ol { color: var(--sp-slate); }
-  li { margin-bottom: 6px; }
-  strong { color: var(--sp-ink); }
-  table {
-    font-size: 18px;
-    width: 100%;
-    border-collapse: collapse;
-    margin: 12px 0;
-  }
-  th {
-    background: var(--sp-red);
-    color: #FFFFFF;
-    text-align: left;
-    padding: 10px 12px;
-    font-weight: 600;
-    border: 1px solid var(--sp-red-dark);
-  }
-  td {
-    padding: 8px 12px;
-    border: 1px solid var(--sp-line);
-    color: var(--sp-slate);
-  }
-  tr:nth-child(even) td { background: var(--sp-tint); }
-  pre {
-    font-size: 13px;
-    background: var(--sp-tint);
-    border-left: 4px solid var(--sp-red);
-    padding: 14px 16px;
-    border-radius: 0;
-    color: var(--sp-ink);
-  }
-  code {
-    background: var(--sp-tint);
-    color: var(--sp-red-dark);
-    padding: 1px 5px;
-    border-radius: 2px;
-    font-family: 'Menlo', 'Consolas', monospace;
-  }
-  pre code {
-    background: none;
-    color: var(--sp-ink);
-    padding: 0;
-  }
-  blockquote {
-    border-left: 5px solid var(--sp-red);
-    background: var(--sp-tint);
-    padding: 10px 16px;
-    color: var(--sp-slate);
-    font-style: italic;
-    border-radius: 0;
-  }
-  header {
-    color: var(--sp-red);
-    font-weight: 700;
-    font-size: 14px;
-  }
-  footer {
-    color: var(--sp-gray);
-    font-size: 12px;
-  }
-  section::after {
-    color: var(--sp-red);
-    font-weight: 700;
-  }
----
-
-<!-- _class: title -->
-
-# ACDL
-## Agentic Cloud Delivery Platform
-
-Automatic. Safe. Audited. — in 30 minutes, on stubs.
-
-v1.0 · GitHub Actions · stub-driven
-
-<!--
-30-min exec demo. Emphasize: we prove INTENT and SAFETY, not provision real infra.
-Everything runs as local stubs on Linux via GitHub Actions. No AWS.
--->
-
----
-
-# The Problem
-
-### Today, deploying infrastructure takes **weeks**
-
-- Ticket → triage queue → copy-paste config → peer review → security review → waiting for central IT to release
-
-> Two weeks of human latency for a service that should take minutes.
-
-### What we want instead
-
-- Developer commits a **contract** → pipeline runs
-- Safety **computed** automatically (confidence signal)
-- Manual gates only where they matter (QA, Prod)
-- Every step written to a tamper-evident **evidence stream**
-
-<!--
-Set the pain. Ask: who has lived this? Then pivot to the vision.
--->
-
----
-
-# How It Works
-
-```
-              ┌────────────── acdl-contracts ──────────────┐
- Developer ──▶│ commit contract.yaml                     │
-              └───────┬───────────────────────────────────┘
-                      │ (push)
- Citizen    ┌─────────┴──────────┐
-  │ "ingest gas pricing into data lake"
-  ▼
- Claude agent ──▶ contract.yaml ─┘
-                      │ (push)
-                      ▼
-            ┌─────────────────┐
-            │ reusable         │
-            │ GitHub Actions   │
-            │ pipeline         │
-            └────────┬────────┘
-                     │
-       ┌─────────────┼─────────────┐
-       ▼             ▼             ▼
- Dev (auto)   QA (approval)   Prod (approval)
-       │
-       ▼
- evidence_writer ─▶ audit.json (hash-chained) ─▶ Pages timeline
-```
-
-Two entry paths, **one** pipeline, **one** audit trail — developer via GitHub, citizen developer via their own Claude agent.
-
-<!--
-Two surfaces: developers push contracts directly to GitHub; citizen developers prompt a Claude agent they own, which writes and pushes the contract for them.
-Both converge on one GitHub Actions pipeline with three stages.
--->
-
----
-
-# The Safety Story
-
-### Computed, not requested
-
-| Signal | Behavior |
-|--------|----------|
-| **Base confidence** | 0.90 |
-| **On policy violation** | drop to 0.40 + reason code |
-| **Gate threshold** | ≥ 0.50 to proceed past Dev |
-
-### Policy (v1)
-- `public-ingress: true` → `POLICY_VIOLATION:PUBLIC_INGRESS`
-
-### Evidence
-- Each event appended to `audit.json` with SHA-256 link to previous (`prev_hash` + `hash`)
-- Published to Pages → vanilla-JS timeline
-
-<!--
-Safety is computed by the platform, not asked of the developer.
-Threshold 0.50 is exact → 0.90 passes, 0.40 halts. That's what makes the three scenarios deterministic.
--->
-
----
-
-# Scenario 1 — Developer Self-Service
-
-### Trigger
-Developer commits a valid `contract.yaml` requesting **`l2-commodity-price-feed`** via **GitHub**.
-
-### What you'll see
-- **Dev:** policy ✅ → apply api-gateway, lambda, s3 → confidence **0.90** → proceed
-- **QA:** pipeline pauses → click **Approve**
-- **Prod:** pipeline pauses → click **Approve**
-- **Finalize:** `audit.json` committed → Pages timeline updates
-
-### Evidence outcome
-Timeline shows: contract received → policy pass → apply × 3 → confidence 0.90 → QA → Prod → published.
-
-<!--
-Normal developer flow: human writes the contract, pushes to GitHub, the GitHub Action pipeline runs.
-Narrate: developer commits and walks away; platform does the rest.
-Pause visibly at each gate so the audience sees human-in-the-loop.
-End by refreshing the Pages timeline.
--->
-
----
-
-# Scenario 1 — Journey
-
-```mermaid
-flowchart LR
-  classDef gh fill:#F4F4F4,stroke:#1A1A1A,stroke-width:2px,color:#1A1A1A
-  classDef stage fill:#C8102E,stroke:#8E0B20,stroke-width:1px,color:#FFFFFF
-  classDef gate fill:#FFFFFF,stroke:#1A1A1A,stroke-width:2px,color:#1A1A1A
-  classDef evidence fill:#F4F4F4,stroke:#C8102E,stroke-width:1px,color:#1A1A1A
-
-  D["Developer"]:::gh -->|"writes contract.yaml"| GH["GitHub<br/>acdl-contracts"]:::gh
-  GH -->|"push triggers<br/>GitHub Action"| DEV["Dev<br/>(autonomous)"]:::stage
-  DEV -->|"policy ✅ · confidence 0.90"| QA["QA<br/>approval gate"]:::gate
-  QA -->|"approve"| PROD["Prod<br/>approval gate"]:::gate
-  PROD -->|"approve"| FIN["Finalize<br/>commit audit.json"]:::stage
-  FIN --> TL["GitHub Pages<br/>timeline"]:::evidence
-```
-
-<!--
-Point to the two approval gates — QA and Prod — both human clicks.
-The whole chain from commit to timeline is one GitHub Actions workflow.
--->
-
----
-
-# Scenario 2 — Citizen Developer
-
-### Trigger
-Non-technical user prompts their **own Claude agent** in natural language:
-
-> "I need a new service to ingest real-time natural gas pricing data into our data lake."
-
-### What you'll see
-- Claude agent parses intent, writes `contract.yaml` for **`l2-commodity-price-feed`**, pushes a branch
-- Issue **closed**; branch push triggers the **identical** pipeline from Scenario 1
-- Citizen developer follows the run all the way to **Prod**
-
-### Evidence outcome
-Timeline is **indistinguishable** from Scenario 1 — the agentic surface is first-class, not a bolt-on.
-
-<!--
-Punchline: same timeline, same safety, same audit — different entry.
-The citizen developer owns and drives their own Claude agent; they are the actor, not the platform.
-Normal developers (Scenario 1) keep using GitHub directly — two surfaces, one pipeline, one audit.
--->
-
----
-
-# Scenario 2 — Journey
-
-```mermaid
-flowchart LR
-  classDef cit fill:#F4F4F4,stroke:#C8102E,stroke-width:2px,color:#1A1A1A
-  classDef agent fill:#C8102E,stroke:#8E0B20,stroke-width:1px,color:#FFFFFF
-  classDef stage fill:#1A1A1A,stroke:#1A1A1A,stroke-width:1px,color:#FFFFFF
-  classDef gate fill:#FFFFFF,stroke:#1A1A1A,stroke-width:2px,color:#1A1A1A
-  classDef evidence fill:#F4F4F4,stroke:#C8102E,stroke-width:1px,color:#1A1A1A
-
-  CD["Citizen developer"]:::cit -->|"natural-language<br/>prompt"| CL["Claude agent<br/>(citizen-owned)"]:::agent
-  CL -->|"generates<br/>contract.yaml"| GH["GitHub<br/>acdl-contracts"]:::cit
-  GH -->|"push triggers<br/>GitHub Action"| DEV["Dev<br/>(autonomous)"]:::stage
-  DEV -->|"policy ✅ · confidence 0.90"| QA["QA<br/>approval gate"]:::gate
-  QA -->|"approve"| PROD["Prod<br/>approval gate"]:::gate
-  PROD -->|"approve"| FIN["Finalize<br/>commit audit.json"]:::stage
-  FIN --> TL["GitHub Pages<br/>timeline"]:::evidence
-```
-
-<!--
-Highlight the red Claude-agent node — owned by the citizen, not by the platform.
-From GitHub onward the journey is identical to Scenario 1.
--->
-
----
-
-# Scenario 3 — The Safety Net
-
-### Trigger
-Developer commits a **malicious** `contract.yaml` for `l2-regulatory-reporting` via **GitHub**:
-
-```yaml
-stack: l2-regulatory-reporting
-public-ingress: true
-```
-
-### What you'll see
-- **Dev:** `policy_checker` → `POLICY_VIOLATION:PUBLIC_INGRESS`
-- `confidence_signal` drops 0.90 → **0.40**
-- `0.40 < 0.50` → pipeline **halts in Dev**
-- Rejection reason written to the evidence stream
-
-### Evidence outcome
-Timeline shows the attempted deploy, the violation, the confidence drop, and the **halt** — visible and explained.
-
-<!--
-The safety money shot. The platform said NO, and said WHY, on the record.
-No human had to catch it — the confidence signal computed the risk.
-Contrast with The Problem's old-world review queue.
--->
-
----
-
-# Scenario 3 — Journey
-
-```mermaid
-flowchart LR
-  classDef gh fill:#F4F4F4,stroke:#1A1A1A,stroke-width:2px,color:#1A1A1A
-  classDef stage fill:#C8102E,stroke:#8E0B20,stroke-width:1px,color:#FFFFFF
-  classDef halt fill:#1A1A1A,stroke:#1A1A1A,stroke-width:1px,color:#FFFFFF
-  classDef evidence fill:#F4F4F4,stroke:#C8102E,stroke-width:1px,color:#1A1A1A
-
-  D["Developer"]:::gh -->|"writes malicious<br/>contract.yaml"| GH["GitHub<br/>acdl-contracts"]:::gh
-  GH -->|"push triggers<br/>GitHub Action"| DEV["Dev<br/>(autonomous)"]:::stage
-  DEV -->|"POLICY_VIOLATION:PUBLIC_INGRESS<br/>confidence 0.90 → 0.40"| HALT["Halt in Dev<br/>+ rejection reason"]:::halt
-  HALT --> TL["GitHub Pages<br/>timeline"]:::evidence
-```
-
-<!--
-The black halt node is the whole point — pipeline stops, evidence records why.
-Notice there are no QA/Prod gates on this path; the journey ends at Dev.
--->

demo/contracts-repo/.gitea/workflows/issue-to-contract.yml

@@ -1,145 +0,0 @@
-# ACDL issue-to-contract workflow (Phase 04 implementation).
-#
-# Trigger: a new Issue is opened in acdl-contracts. The workflow runs
-# l3b_agent_stub.py (checked out from the `acdl` repo, pinned to
-# @milestone/v1.0-initial) to map the Issue body to a contract.yaml, commits
-# the contract to a new branch `contract/<issue-number>` on acdl-contracts
-# via the Gitea file-contents API, closes the Issue with a comment, and
-# dispatches the main pipeline in the `acdl` repo via the workflow_dispatch
-# API (D-014; Gitea Actions does not support repository_dispatch).
-#
-# Cross-repo trigger (D-014):
-#   The final step POSTs to
-#     /api/v1/repos/continuous-intelligence/acdl/actions/workflows/pipeline.yml/dispatches
-#   with body {"ref": "milestone/v1.0-initial",
-#              "inputs": {"contract-ref": "contract/<issue-number>"}}.
-#
-# Branch-pin rule (ARCHITECTURE.md):
-#   The `acdl` repo's default branch is `milestone/v1.0-initial`, so the
-#   checkout step pins `ref: milestone/v1.0-initial`. The pipeline dispatch
-#   also pins `ref: milestone/v1.0-initial` (the workflow file lives on
-#   that branch). The new `contract/<n>` branch is created on acdl-contracts
-#   (whose default branch is `main`, per D-015).
-#
-# File-contents POST with `new_branch` (D-030):
-#   The POST to /repos/.../contents/contract.yaml includes
-#   `new_branch: contract/<n>`, which tells Gitea to create the file on a
-#   NEW branch off the current head of `branch: main` instead of committing
-#   directly to main. This avoids a separate branch-create + commit round
-#   trip.
-name: issue-to-contract
-
-"on":
-  issues:
-    types: [opened]
-
-jobs:
-  parse-and-trigger:
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Checkout acdl (pinned to milestone/v1.0-initial for l3b_agent_stub.py)"
-        uses: actions/checkout@v4
-        with:
-          repository: continuous-intelligence/acdl
-          ref: milestone/v1.0-initial
-          token: ${{ secrets.GITEA_TOKEN }}
-
-      - name: "Parse Issue body into contract.yaml"
-        env:
-          ISSUE_BODY: ${{ gitea.event.issue.body }}
-        run: |
-          # Pass the Issue body via an env var to avoid shell injection from
-          # arbitrary Issue text. l3b_agent_stub.py reads argv[1]; we pass
-          # the env var quoted so no metacharacter interpretation happens.
-          python3 scripts/l3b_agent_stub.py "$ISSUE_BODY" -o contract.yaml
-          echo "--- generated contract.yaml ---"
-          cat contract.yaml
-
-      - name: "Commit contract.yaml to new branch contract/${{ gitea.event.issue.number }} on acdl-contracts"
-        env:
-          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
-        run: |
-          set -euo pipefail
-          STACK=$(python3 -c 'import yaml; print(yaml.safe_load(open("contract.yaml"))["stack"])')
-          ISSUE_NUMBER="${{ gitea.event.issue.number }}"
-          BRANCH="contract/${ISSUE_NUMBER}"
-          HOST="https://git.cloudinit.dev"
-          API="${HOST}/api/v1/repos/continuous-intelligence/acdl-contracts/contents/contract.yaml"
-          B64=$(base64 -w 0 contract.yaml)
-          BODY=$(python3 -c "
-          import json
-          print(json.dumps({
-              'content': '${B64}',
-              'message': 'l3b: contract for issue #${ISSUE_NUMBER}',
-              'branch': 'main',
-              'new_branch': '${BRANCH}'
-          }))
-          ")
-          STATUS=$(curl -sS -o /tmp/contract_post.json -w "%{http_code}" \
-            -X POST \
-            -H "Authorization: token ${GITEA_TOKEN}" \
-            -H "Content-Type: application/json" \
-            -d "$BODY" \
-            "$API")
-          echo "POST contract.yaml -> HTTP ${STATUS}"
-          cat /tmp/contract_post.json || true
-          case "$STATUS" in
-            201) echo "contract.yaml committed on branch ${BRANCH}" ;;
-            *) echo "ERROR: file-contents POST failed (HTTP ${STATUS})" >&2; exit 1 ;;
-          esac
-          echo "STACK=${STACK}" >> "$GITHUB_ENV"
-          echo "BRANCH=${BRANCH}" >> "$GITHUB_ENV"
-
-      - name: "Comment on Issue + close it"
-        env:
-          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
-        run: |
-          set -euo pipefail
-          ISSUE_NUMBER="${{ gitea.event.issue.number }}"
-          HOST="https://git.cloudinit.dev"
-          ISSUES_API="${HOST}/api/v1/repos/continuous-intelligence/acdl-contracts/issues/${ISSUE_NUMBER}"
-          COMMENT_BODY=$(python3 -c "
-          import json
-          print(json.dumps({'body': 'Generated contract.yaml for stack \`' + '${STACK}' + '\` on branch \`' + '${BRANCH}' + '\`. Pipeline dispatched.'}))
-          ")
-          curl -sS -o /tmp/comment.json -w "comment HTTP %{http_code}\n" \
-            -X POST \
-            -H "Authorization: token ${GITEA_TOKEN}" \
-            -H "Content-Type: application/json" \
-            -d "$COMMENT_BODY" \
-            "${ISSUES_API}/comments"
-          CLOSE_BODY='{"state":"closed"}'
-          curl -sS -o /tmp/close.json -w "close HTTP %{http_code}\n" \
-            -X PATCH \
-            -H "Authorization: token ${GITEA_TOKEN}" \
-            -H "Content-Type: application/json" \
-            -d "$CLOSE_BODY" \
-            "${ISSUES_API}"
-
-      - name: "Dispatch the pipeline on acdl (contract-ref = contract/${{ gitea.event.issue.number }})"
-        env:
-          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
-        run: |
-          set -euo pipefail
-          ISSUE_NUMBER="${{ gitea.event.issue.number }}"
-          HOST="https://git.cloudinit.dev"
-          DISPATCH_URL="${HOST}/api/v1/repos/continuous-intelligence/acdl/actions/workflows/pipeline.yml/dispatches"
-          BODY=$(python3 -c "
-          import json
-          print(json.dumps({
-              'ref': 'milestone/v1.0-initial',
-              'inputs': {'contract-ref': 'contract/${ISSUE_NUMBER}'}
-          }))
-          ")
-          STATUS=$(curl -sS -o /tmp/dispatch.json -w "%{http_code}" \
-            -X POST \
-            -H "Authorization: token ${GITEA_TOKEN}" \
-            -H "Content-Type: application/json" \
-            -d "$BODY" \
-            "$DISPATCH_URL")
-          echo "pipeline dispatch -> HTTP ${STATUS}"
-          cat /tmp/dispatch.json || true
-          case "$STATUS" in
-            201|202|204) echo "pipeline dispatched (contract-ref=contract/${ISSUE_NUMBER})" ;;
-            *) echo "ERROR: pipeline dispatch failed (HTTP ${STATUS})" >&2; exit 1 ;;
-          esac

demo/contracts/examples/contract-commodity-price-feed-prod.yaml

@@ -1,55 +0,0 @@
-# Elaborate developer contract — energy trading price feed.
-#
-# Schema (D-021): stack + inputs (open-ended string map) + public-ingress.
-# The `stack` field MUST match an L2 folder name under modules/l2/.
-# The `inputs` map is free-form string values; these are L2-level params
-# that travel with the deployment into state.json and the audit trail.
-# The L1 input values are declared by the L2's manifest.yaml, not here.
-#
-# Commit this to acdl-contracts as contract.yaml to trigger the pipeline:
-#   git add contract.yaml && git commit -m "feat: deploy price feed (prod)" && git push
-
-stack: l2-commodity-price-feed
-
-inputs:
-  # --- Environment + ownership ---
-  environment: prod
-  owner: commodity-trading-platform-team
-  team: power-and-gas-desk
-  cost_center: CC-TRD-4471
-  change_ticket: CHG-2026-07-21-093
-
-  # --- Business context (rides into the audit timeline) ---
-  business_owner: kchen@jccapital.xyz
-  oncall_email: sre-commodity@example.com
-  sla_tier: T1
-  business_hours: "Mon-Fri 07:00-19:00 ET"
-  data_classification: internal
-
-  # --- Source feed contract (business-facing) ---
-  feed_vendor: Platts
-  feed_name: natural-gas-daily-settlement
-  feed_cadence: daily
-  feed_timezone: US/Eastern
-  symbols: "NG-WTI-HH,NG-HH-M,NG-PJM"
-  retry_policy: backoff-3x-15min
-  dead_letter_queue: commodity-price-dlq
-
-  # --- Deployment knobs (consumed by the pipeline; passed to L1s via L2 manifest) ---
-  replicas: "3"
-  cpu_request: "500m"
-  memory_request: "1Gi"
-  autoscale_min: "2"
-  autoscale_max: "8"
-  log_retention_days: "90"
-  archive_retention_days: "2555"
-
-  # --- Operational flags ---
-  enable_canary: "true"
-  canary_percentage: "10"
-  enable_pagerduty: "true"
-  enable_cost_alerts: "true"
-  cost_alert_threshold_usd: "500"
-
-# Policy-gated field. true -> POLICY_VIOLATION:PUBLIC_INGRESS -> confidence 0.40 < 0.50 -> Dev rejects (Act 4).
-public-ingress: false

demo/contracts/examples/contract-regulatory-reporting-violation.yaml

@@ -1,55 +0,0 @@
-# Elaborate developer contract — regulatory reporting (with policy violation).
-#
-# Same schema as the price-feed example, but with public-ingress: true,
-# which triggers Act 4: the policy_checker fails, the confidence_signal
-# drops to 0.40, the 0.50 gate halts the pipeline in Dev, and the
-# rejection appears on the evidence timeline.
-#
-# Commit this to acdl-contracts as contract.yaml to reproduce Act 4:
-#   git add contract.yaml && git commit -m "feat: deploy regulatory reporting" && git push
-
-stack: l2-regulatory-reporting
-
-inputs:
-  # --- Environment + ownership ---
-  environment: prod
-  owner: compliance-and-controls-team
-  team: regulatory-reporting-desk
-  cost_center: CC-CMP-9902
-  change_ticket: CHG-2026-07-21-118
-  business_owner: compliance@jccapital.xyz
-  oncall_email: sre-regulatory@example.com
-  sla_tier: T0
-  business_hours: "24x7"
-  data_classification: confidential
-
-  # --- Regulatory context ---
-  regulator: FERC
-  filing_frequency: monthly
-  filing_deadline_day_of_month: "15"
-  reporting_period: 2026-Q3
-  jurisdiction: US-Federal
-  legal_hold: "false"
-
-  # --- Deployment knobs ---
-  replicas: "2"
-  cpu_request: "1000m"
-  memory_request: "2Gi"
-  autoscale_min: "2"
-  autoscale_max: "4"
-  log_retention_days: "365"
-  archive_retention_days: "2555"
-  enable_encryption_at_rest: "true"
-  enable_kms_rotation: "true"
-
-  # --- Operational flags ---
-  enable_canary: "false"
-  enable_pagerduty: "true"
-  enable_cost_alerts: "true"
-  cost_alert_threshold_usd: "1000"
-
-# POLICY VIOLATION — this is the Act 4 trigger.
-# The policy_checker.py will emit: POLICY_VIOLATION:PUBLIC_INGRESS
-# The confidence_signal.py will return: {"score": 0.40, "reason": "POLICY_VIOLATION:PUBLIC_INGRESS"}
-# The 0.50 gate halts the pipeline in Dev; mock_executor never runs.
-public-ingress: true

demo/evidence-ui/index.html

@@ -1,334 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>ACDL Evidence Timeline</title>
-<style>
-  :root {
-    --stage-dev: #2563eb;
-    --stage-qa: #ca8a04;
-    --stage-prod: #ea580c;
-    --stage-finalize: #16a34a;
-    --stage-genesis: #6b7280;
-    --stage-rejected: #dc2626;
-    --bg: #f8fafc;
-    --card-bg: #ffffff;
-    --text: #0f172a;
-    --muted: #64748b;
-    --border: #e2e8f0;
-  }
-  * { box-sizing: border-box; }
-  html, body {
-    margin: 0;
-    padding: 0;
-    background: var(--bg);
-    color: var(--text);
-    font-family: system-ui, -apple-system, sans-serif;
-    line-height: 1.5;
-  }
-  header {
-    padding: 24px 32px 16px;
-    border-bottom: 1px solid var(--border);
-    background: var(--card-bg);
-  }
-  header h1 {
-    margin: 0 0 6px;
-    font-size: 1.5rem;
-    font-weight: 600;
-  }
-  header p {
-    margin: 0;
-    color: var(--muted);
-    font-size: 0.95rem;
-  }
-  .toolbar {
-    display: flex;
-    align-items: center;
-    gap: 12px;
-    padding: 16px 32px;
-    background: var(--card-bg);
-    border-bottom: 1px solid var(--border);
-  }
-  button#refresh {
-    appearance: none;
-    border: 1px solid var(--border);
-    background: var(--text);
-    color: #fff;
-    padding: 8px 16px;
-    border-radius: 6px;
-    font-size: 0.9rem;
-    font-family: inherit;
-    cursor: pointer;
-  }
-  button#refresh:hover { opacity: 0.9; }
-  button#refresh:active { transform: translateY(1px); }
-  .toolbar .status {
-    color: var(--muted);
-    font-size: 0.85rem;
-  }
-  main {
-    padding: 24px 32px 48px;
-    max-width: 900px;
-    margin: 0 auto;
-  }
-  .empty {
-    padding: 48px 24px;
-    text-align: center;
-    color: var(--muted);
-    background: var(--card-bg);
-    border: 1px dashed var(--border);
-    border-radius: 8px;
-  }
-  ol.timeline {
-    list-style: none;
-    margin: 0;
-    padding: 0;
-    position: relative;
-  }
-  ol.timeline::before {
-    content: "";
-    position: absolute;
-    left: 11px;
-    top: 6px;
-    bottom: 6px;
-    width: 2px;
-    background: var(--border);
-  }
-  li.event {
-    position: relative;
-    padding: 12px 0 12px 40px;
-  }
-  li.event::before {
-    content: "";
-    position: absolute;
-    left: 6px;
-    top: 18px;
-    width: 12px;
-    height: 12px;
-    border-radius: 50%;
-    background: var(--dot, var(--muted));
-    border: 2px solid var(--card-bg);
-    box-shadow: 0 0 0 1px var(--border);
-  }
-  .card {
-    background: var(--card-bg);
-    border: 1px solid var(--border);
-    border-left: 4px solid var(--dot, var(--muted));
-    border-radius: 8px;
-    padding: 12px 16px;
-  }
-  .card .row {
-    display: flex;
-    flex-wrap: wrap;
-    align-items: center;
-    gap: 8px;
-    margin-bottom: 4px;
-  }
-  .seq {
-    display: inline-block;
-    min-width: 28px;
-    padding: 2px 6px;
-    font-size: 0.75rem;
-    font-weight: 600;
-    text-align: center;
-    border-radius: 4px;
-    background: #eef2ff;
-    color: #3730a3;
-    border: 1px solid #c7d2fe;
-  }
-  .chip {
-    display: inline-block;
-    padding: 2px 8px;
-    font-size: 0.72rem;
-    font-weight: 600;
-    text-transform: uppercase;
-    letter-spacing: 0.04em;
-    border-radius: 999px;
-    color: #fff;
-    background: var(--dot, var(--muted));
-  }
-  .ts {
-    font-size: 0.8rem;
-    color: var(--muted);
-    font-variant-numeric: tabular-nums;
-  }
-  .event-text {
-    margin: 4px 0 6px;
-    font-size: 0.95rem;
-  }
-  .hash {
-    font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
-    font-size: 0.75rem;
-    color: var(--muted);
-    word-break: break-all;
-  }
-  footer {
-    padding: 16px 32px 24px;
-    border-top: 1px solid var(--border);
-    color: var(--muted);
-    font-size: 0.8rem;
-    max-width: 900px;
-    margin: 0 auto;
-  }
-  footer code {
-    font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
-    background: #f1f5f9;
-    padding: 1px 4px;
-    border-radius: 3px;
-  }
-</style>
-</head>
-<body>
-<header>
-  <h1>ACDL Evidence Timeline</h1>
-  <p>ACDL — Agentic Cloud Delivery Platform · Audit Timeline</p>
-</header>
-<div class="toolbar">
-  <button id="refresh" type="button">Refresh</button>
-  <span class="status" id="status"></span>
-</div>
-<main>
-  <div id="container">
-    <div class="empty">Loading…</div>
-  </div>
-</main>
-<footer>
-  <div id="footer"></div>
-</footer>
-<script>
-(function () {
-  "use strict";
-
-  var AUDIT_URL = "./audit.json";
-  var STAGE_COLORS = {
-    dev: "var(--stage-dev)",
-    qa: "var(--stage-qa)",
-    prod: "var(--stage-prod)",
-    finalize: "var(--stage-finalize)",
-    genesis: "var(--stage-genesis)"
-  };
-
-  function $(id) { return document.getElementById(id); }
-
-  function stageColor(stage, eventText) {
-    var evt = (eventText || "").toString().toLowerCase();
-    if (evt.indexOf("rejected") !== -1) {
-      return "var(--stage-rejected)";
-    }
-    return STAGE_COLORS[stage] || "var(--stage-genesis)";
-  }
-
-  function dash(v) {
-    return (v === null || v === undefined || v === "") ? "—" : v;
-  }
-
-  function hashPreview(hash) {
-    if (hash === null || hash === undefined || hash === "") return "—";
-    var s = String(hash);
-    return s.slice(0, 12) + "…";
-  }
-
-  function esc(s) {
-    return String(s)
-      .replace(/&/g, "&amp;")
-      .replace(/</g, "&lt;")
-      .replace(/>/g, "&gt;")
-      .replace(/"/g, "&quot;")
-      .replace(/'/g, "&#39;");
-  }
-
-  function auditUrlDisplay() {
-    try {
-      var href = window.location.href;
-      var slash = href.lastIndexOf("/");
-      if (slash >= 0) {
-        return href.slice(0, slash + 1) + "audit.json";
-      }
-    } catch (e) {}
-    return AUDIT_URL;
-  }
-
-  function renderEmpty(msg) {
-    $("container").innerHTML =
-      '<div class="empty">' + esc(msg) + "</div>";
-  }
-
-  function renderTimeline(events) {
-    if (!Array.isArray(events)) {
-      renderEmpty("No audit data yet");
-      return;
-    }
-    if (events.length === 0) {
-      renderEmpty("No audit data yet");
-      return;
-    }
-    var sorted = events.slice().sort(function (a, b) {
-      var sa = (a && typeof a.seq === "number") ? a.seq : 0;
-      var sb = (b && typeof b.seq === "number") ? b.seq : 0;
-      return sa - sb;
-    });
-    var html = '<ol class="timeline">';
-    for (var i = 0; i < sorted.length; i++) {
-      var e = sorted[i] || {};
-      var stage = dash(e.stage);
-      var color = stageColor(e.stage, e.event);
-      html += '<li class="event" style="--dot:' + color + ';">';
-      html += '<div class="card" style="--dot:' + color + ';">';
-      html += '<div class="row">';
-      html += '<span class="seq">#' + esc(dash(e.seq)) + "</span>";
-      html += '<span class="chip">' + esc(stage) + "</span>";
-      html += '<span class="ts">' + esc(dash(e.ts)) + "</span>";
-      html += "</div>";
-      html += '<div class="event-text">' + esc(dash(e.event)) + "</div>";
-      html += '<div class="hash">' + esc(hashPreview(e.hash)) + "</div>";
-      html += "</div>";
-      html += "</li>";
-    }
-    html += "</ol>";
-    $("container").innerHTML = html;
-  }
-
-  function renderFooter(ok) {
-    var when = new Date().toISOString();
-    var url = auditUrlDisplay();
-    var prefix = "Fetched at " + when + " · audit.json: ";
-    $("footer").innerHTML =
-      esc(prefix) + '<code>' + esc(url) + "</code>" +
-      (ok ? "" : " (fetch failed)");
-  }
-
-  function setStatus(msg) {
-    $("status").textContent = msg || "";
-  }
-
-  function fetchAudit() {
-    setStatus("Fetching…");
-    fetch(AUDIT_URL, { cache: "no-store" })
-      .then(function (res) {
-        if (!res.ok) {
-          throw new Error("HTTP " + res.status);
-        }
-        return res.json();
-      })
-      .then(function (data) {
-        if (!Array.isArray(data)) {
-          throw new Error("not an array");
-        }
-        renderTimeline(data);
-        renderFooter(true);
-        setStatus("Loaded " + data.length + " event(s)");
-      })
-      .catch(function (err) {
-        renderEmpty("No audit data yet");
-        renderFooter(false);
-        setStatus("Fetch failed: " + (err && err.message ? err.message : "error"));
-      });
-  }
-
-  $("refresh").addEventListener("click", fetchAudit);
-  fetchAudit();
-})();
-</script>
-</body>
-</html>

demo/modules/l1/l1-api-gateway/manifest.yaml

@@ -1,10 +0,0 @@
-name: l1-api-gateway
-kind: l1
-description: HTTP routing primitive
-inputs:
-  api_name:
-    description: Name of the API Gateway REST/HTTP API
-    type: string
-  stage_name:
-    description: Name of the deployment stage (e.g. dev, prod)
-    type: string

demo/modules/l1/l1-api-gateway/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-api-gateway] applying..."
-sleep 1
-echo "[L1: l1-api-gateway] OK"
-exit 0

demo/modules/l1/l1-cloudwatch/manifest.yaml

@@ -1,10 +0,0 @@
-name: l1-cloudwatch
-kind: l1
-description: Observability primitive
-inputs:
-  log_group_name:
-    description: Name of the CloudWatch log group
-    type: string
-  metric_namespace:
-    description: Namespace under which custom metrics are emitted
-    type: string

demo/modules/l1/l1-cloudwatch/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-cloudwatch] applying..."
-sleep 1
-echo "[L1: l1-cloudwatch] OK"
-exit 0

demo/modules/l1/l1-eks-fargate/manifest.yaml

@@ -1,13 +0,0 @@
-name: l1-eks-fargate
-kind: l1
-description: Serverless container compute substrate
-inputs:
-  cluster_name:
-    description: Name of the EKS cluster to target
-    type: string
-  region:
-    description: AWS region the cluster runs in
-    type: string
-  cpu_arch:
-    description: CPU architecture for Fargate pods (x86_64 or arm64)
-    type: string

demo/modules/l1/l1-eks-fargate/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-eks-fargate] applying..."
-sleep 1
-echo "[L1: l1-eks-fargate] OK"
-exit 0

demo/modules/l1/l1-eventbridge/manifest.yaml

@@ -1,10 +0,0 @@
-name: l1-eventbridge
-kind: l1
-description: Event bus primitive
-inputs:
-  bus_name:
-    description: Name of the EventBridge bus
-    type: string
-  rule_name:
-    description: Name of the event rule on the bus
-    type: string

demo/modules/l1/l1-eventbridge/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-eventbridge] applying..."
-sleep 1
-echo "[L1: l1-eventbridge] OK"
-exit 0

demo/modules/l1/l1-iam-role/manifest.yaml

@@ -1,10 +0,0 @@
-name: l1-iam-role
-kind: l1
-description: Identity and access role primitive
-inputs:
-  role_name:
-    description: Name of the IAM role to create
-    type: string
-  trust_policy:
-    description: JSON trust policy document defining who can assume the role
-    type: string

demo/modules/l1/l1-iam-role/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-iam-role] applying..."
-sleep 1
-echo "[L1: l1-iam-role] OK"
-exit 0

demo/modules/l1/l1-lambda/manifest.yaml

@@ -1,13 +0,0 @@
-name: l1-lambda
-kind: l1
-description: Event-driven function primitive
-inputs:
-  function_name:
-    description: Name of the Lambda function
-    type: string
-  runtime:
-    description: Lambda runtime identifier (e.g. python3.12, nodejs20.x)
-    type: string
-  handler:
-    description: Handler entrypoint in the form module.function
-    type: string

demo/modules/l1/l1-lambda/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-lambda] applying..."
-sleep 1
-echo "[L1: l1-lambda] OK"
-exit 0

demo/modules/l1/l1-s3/manifest.yaml

@@ -1,13 +0,0 @@
-name: l1-s3
-kind: l1
-description: Object store primitive
-inputs:
-  bucket_name:
-    description: Globally unique name of the S3 bucket
-    type: string
-  region:
-    description: AWS region the bucket lives in
-    type: string
-  retention_days:
-    description: Number of days to retain objects before expiration
-    type: string

demo/modules/l1/l1-s3/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-s3] applying..."
-sleep 1
-echo "[L1: l1-s3] OK"
-exit 0

demo/modules/l1/l1-sqs/manifest.yaml

@@ -1,10 +0,0 @@
-name: l1-sqs
-kind: l1
-description: Queue primitive
-inputs:
-  queue_name:
-    description: Name of the SQS queue
-    type: string
-  visibility_timeout:
-    description: Visibility timeout in seconds for in-flight messages
-    type: string

demo/modules/l1/l1-sqs/mock_apply.sh

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "[L1: l1-sqs] applying..."
-sleep 1
-echo "[L1: l1-sqs] OK"
-exit 0

demo/modules/l2/l2-commodity-price-feed/manifest.yaml

@@ -1,27 +0,0 @@
-name: l2-commodity-price-feed
-kind: l2
-description: Real-time commodity price ingestion from Platts
-l1s:
-  - name: l1-eks-fargate
-    inputs:
-      cluster_name: price-feed-cluster
-      region: us-east-1
-      cpu_arch: arm64
-  - name: l1-lambda
-    inputs:
-      function_name: price-ingest
-      runtime: python3.11
-      handler: index.handler
-  - name: l1-api-gateway
-    inputs:
-      api_name: platts-price-api
-      stage_name: dev
-  - name: l1-eventbridge
-    inputs:
-      bus_name: price-events
-      rule_name: price-publish-rule
-  - name: l1-s3
-    inputs:
-      bucket_name: acdl-price-archive
-      region: us-east-1
-      retention_days: "90"

demo/modules/l2/l2-energy-analytics-api/manifest.yaml

@@ -1,27 +0,0 @@
-name: l2-energy-analytics-api
-kind: l2
-description: Historical energy analytics query API
-l1s:
-  - name: l1-eks-fargate
-    inputs:
-      cluster_name: analytics-cluster
-      region: us-east-1
-      cpu_arch: arm64
-  - name: l1-api-gateway
-    inputs:
-      api_name: energy-analytics-api
-      stage_name: dev
-  - name: l1-lambda
-    inputs:
-      function_name: analytics-query
-      runtime: python3.11
-      handler: index.handler
-  - name: l1-s3
-    inputs:
-      bucket_name: acdl-analytics-data
-      region: us-east-1
-      retention_days: "2555"
-  - name: l1-cloudwatch
-    inputs:
-      log_group_name: /acdl/analytics-api
-      metric_namespace: acdl/analytics

demo/modules/l2/l2-invoice-service/manifest.yaml

@@ -1,27 +0,0 @@
-name: l2-invoice-service
-kind: l2
-description: Billing and invoicing microservice for energy trades
-l1s:
-  - name: l1-eks-fargate
-    inputs:
-      cluster_name: invoice-cluster
-      region: us-east-1
-      cpu_arch: arm64
-  - name: l1-iam-role
-    inputs:
-      role_name: invoice-service-role
-      trust_policy: '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"eks.amazonaws.com"},"Action":"sts:AssumeRole"}]}'
-  - name: l1-lambda
-    inputs:
-      function_name: invoice-generator
-      runtime: python3.11
-      handler: index.handler
-  - name: l1-sqs
-    inputs:
-      queue_name: invoice-queue
-      visibility_timeout: "60"
-  - name: l1-s3
-    inputs:
-      bucket_name: acdl-invoice-archive
-      region: us-east-1
-      retention_days: "365"

demo/modules/l2/l2-regulatory-reporting/manifest.yaml

@@ -1,27 +0,0 @@
-name: l2-regulatory-reporting
-kind: l2
-description: Regulatory compliance and reporting for energy trading
-l1s:
-  - name: l1-eks-fargate
-    inputs:
-      cluster_name: regulatory-cluster
-      region: us-east-1
-      cpu_arch: arm64
-  - name: l1-iam-role
-    inputs:
-      role_name: regulatory-reporting-role
-      trust_policy: '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"eks.amazonaws.com"},"Action":"sts:AssumeRole"}]}'
-  - name: l1-lambda
-    inputs:
-      function_name: regulatory-reporter
-      runtime: python3.11
-      handler: index.handler
-  - name: l1-sqs
-    inputs:
-      queue_name: regulatory-queue
-      visibility_timeout: "120"
-  - name: l1-s3
-    inputs:
-      bucket_name: acdl-regulatory-archive
-      region: us-east-1
-      retention_days: "2555"

demo/scripts/confidence_signal.py

@@ -1,55 +0,0 @@
-#!/usr/bin/env python3
-"""confidence_signal.py — REQ-08 / D-024
-
-Reads a contract.yaml, invokes policy_checker.py as a subprocess, and emits
-a deterministic JSON confidence score.
-
-  policy pass  -> {"score": 0.90, "reason": "POLICY_PASS"}
-  policy fail  -> {"score": 0.40, "reason": "<violation code>"}
-
-Exit 0 ALWAYS (per D-024): the pipeline decides the gate, not this script's
-exit code.
-
-Input: argv[1] = path to a contract.yaml file.
-"""
-import json
-import os
-import subprocess
-import sys
-
-
-def main() -> int:
-    if len(sys.argv) < 2:
-        print("usage: confidence_signal.py <contract.yaml>", file=sys.stderr)
-        return 1
-
-    contract_path = sys.argv[1]
-
-    # Resolve policy_checker.py relative to this script so it works regardless
-    # of cwd. Use python3 + script path (not ./) per the contract.
-    here = os.path.dirname(os.path.abspath(__file__))
-    policy_checker = os.path.join(here, "policy_checker.py")
-
-    proc = subprocess.run(
-        ["python3", policy_checker, contract_path],
-        capture_output=True,
-        text=True,
-    )
-
-    if proc.returncode == 0:
-        score = "0.90"
-        # POLICY_PASS is the expected stdout; strip any trailing whitespace.
-        reason = proc.stdout.strip() or "POLICY_PASS"
-    else:
-        score = "0.40"
-        # The violation code (e.g. "POLICY_VIOLATION:PUBLIC_INGRESS") is on stdout.
-        reason = proc.stdout.strip() or "POLICY_VIOLATION:UNKNOWN"
-
-    # Emit with literal score (two-decimal form per the contract) and a quoted
-    # reason. Constructed manually so json.dumps does not collapse 0.90 -> 0.9.
-    print('{"score": ' + score + ', "reason": ' + json.dumps(reason) + '}')
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

demo/scripts/evidence_writer.py

@@ -1,123 +0,0 @@
-#!/usr/bin/env python3
-"""evidence_writer.py — REQ-11 / D-023 / D-005
-
-Appends a hash-chained event to audit.json.
-
-Each event: {"seq": N, "ts": <iso8601 UTC>, "stage": "...", "event": "...",
-             "prev_hash": "<sha256 or GENESIS>", "hash": "<sha256 of canonical json of this event with hash empty>"}
-
-Hash chain (D-023):
-  1. Build event dict with hash = "" (empty string).
-  2. canonical = json.dumps(event, sort_keys=True, separators=(",", ":"))
-  3. hash = sha256(canonical.encode("utf-8")).hexdigest()
-  4. event["hash"] = hash
-  5. append to audit.json
-
-Auto-genesis: if audit.json is empty/missing and --stage is not "genesis",
-a genesis event (seq 0, prev_hash "GENESIS") is inserted first.
-
-Input:
-  --stage <dev|qa|prod|finalize|genesis>  (required)
-  --event "<text>"                        (required)
-  --audit <path>                          (optional, default ./audit.json)
-Output: stdout {"seq": N, "hash": "..."}
-Exit:   0 on success, 1 on I/O error.
-"""
-import argparse
-import datetime
-import hashlib
-import json
-import os
-import sys
-
-GENESIS_EVENT_TEXT = "audit log initialized"
-
-
-def now_iso8601_utc() -> str:
-    return datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
-
-
-def compute_hash(event: dict) -> str:
-    """Compute the sha256 hash of an event using canonical JSON (D-023)."""
-    tmp = dict(event)
-    tmp["hash"] = ""
-    canonical = json.dumps(tmp, sort_keys=True, separators=(",", ":"))
-    return hashlib.sha256(canonical.encode("utf-8")).hexdigest()
-
-
-def make_event(seq: int, stage: str, event_text: str, prev_hash: str) -> dict:
-    event = {
-        "seq": seq,
-        "ts": now_iso8601_utc(),
-        "stage": stage,
-        "event": event_text,
-        "prev_hash": prev_hash,
-        "hash": "",
-    }
-    event["hash"] = compute_hash(event)
-    return event
-
-
-def load_audit(audit_path: str) -> list:
-    if not os.path.exists(audit_path):
-        return []
-    try:
-        with open(audit_path, "r", encoding="utf-8") as fh:
-            data = json.load(fh)
-    except (json.JSONDecodeError, ValueError):
-        return []
-    if not isinstance(data, list):
-        return []
-    return data
-
-
-def atomic_write(audit_path: str, data: list) -> None:
-    tmp_path = audit_path + ".tmp"
-    with open(tmp_path, "w", encoding="utf-8") as fh:
-        json.dump(data, fh, indent=2)
-        fh.write("\n")
-    os.replace(tmp_path, audit_path)
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description="Append a hash-chained event to audit.json")
-    parser.add_argument("--stage", required=True,
-                        choices=["dev", "qa", "prod", "finalize", "genesis"])
-    parser.add_argument("--event", required=True)
-    parser.add_argument("--audit", default="./audit.json")
-    args = parser.parse_args()
-
-    events = load_audit(args.audit)
-
-    # Auto-genesis: if the log is empty and the caller did not ask for a
-    # genesis event, seed one first.
-    if len(events) == 0 and args.stage != "genesis":
-        genesis = make_event(seq=0, stage="genesis", event_text=GENESIS_EVENT_TEXT,
-                             prev_hash="GENESIS")
-        events.append(genesis)
-
-    # Determine the new seq + prev_hash.
-    if events:
-        last = events[-1]
-        seq = last["seq"] + 1
-        prev_hash = last["hash"]
-    else:
-        seq = 0
-        prev_hash = "GENESIS"
-
-    new_event = make_event(seq=seq, stage=args.stage, event_text=args.event,
-                           prev_hash=prev_hash)
-    events.append(new_event)
-
-    try:
-        atomic_write(args.audit, events)
-    except OSError as exc:
-        print(f"evidence_writer: I/O error: {exc}", file=sys.stderr)
-        return 1
-
-    print(json.dumps({"seq": new_event["seq"], "hash": new_event["hash"]}))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

demo/scripts/finalize_evidence.py

@@ -1,182 +0,0 @@
-#!/usr/bin/env python3
-"""finalize_evidence.py — REQ-10 / D-028 / D-029
-
-Uploads (PUT or POST) a local `audit.json` to the `acdl-evidence` repo on
-Gitea via the file-contents API. Used by the pipeline workflow steps to
-persist the hash-chained audit trail to `acdl-evidence` between dispatches
-(D-028 state-persistence across re-dispatches; D-029 finalize step).
-
-Uses only the Python standard library (urllib.request) so it has no
-external dependency on `requests`. Auth header: `Authorization: token <token>`.
-
-Input (argv flags):
-  --audit <path>           (required) local audit.json file to upload
-  --owner <org>            (optional, default continuous-intelligence)
-  --repo <name>            (optional, default acdl-evidence)
-  --branch <name>         (optional, default main)
-  --path <remote path>     (optional, default audit.json) path in the repo
-  --token-env <env var>    (optional, default ACDL_GITEA_TOKEN)
-  --host <url>             (optional, default https://git.cloudinit.dev)
-  --message <commit msg>   (optional, default chore(evidence): update audit.json)
-
-Behavior:
-  1. Read the token from os.environ[token_env]. Missing -> stderr + exit 1.
-  2. Read the local audit file; base64-encode it.
-  3. GET the current file at .../contents/<path>?ref=<branch> to discover
-     the existing `sha`. 200 -> capture sha (update mode). 404 -> no sha
-     (create mode). Other errors -> exit 1.
-  4. If sha set: PUT with body {content, message, branch, sha}.
-     If no sha: POST with body {content, message, branch}.
-  5. Print {"uploaded": true, "path": "<path>", "sha": "<new sha>"} to
-     stdout and exit 0.
-  6. On any HTTP error: print
-     {"uploaded": false, "status": <code>, "body": "<body>"} to stdout
-     and exit 1.
-"""
-import argparse
-import base64
-import json
-import os
-import sys
-import urllib.error
-import urllib.parse
-import urllib.request
-
-
-def _request(method: str, url: str, token: str, body: dict = None):
-    """Perform an HTTP request with the Gitea auth header. Returns
-    (status_code, response_body_text). Raises URLError on network failure."""
-    data = None
-    headers = {"Authorization": f"token {token}",
-               "Accept": "application/json"}
-    if body is not None:
-        data = json.dumps(body).encode("utf-8")
-        headers["Content-Type"] = "application/json"
-    req = urllib.request.Request(url, data=data, method=method, headers=headers)
-    try:
-        with urllib.request.urlopen(req) as resp:
-            return resp.getcode(), resp.read().decode("utf-8", "replace")
-    except urllib.error.HTTPError as exc:
-        # HTTPError carries the response body
-        try:
-            body_text = exc.read().decode("utf-8", "replace")
-        except Exception:
-            body_text = ""
-        return exc.code, body_text
-    except urllib.error.URLError as exc:
-        # Network-level failure (connection refused, DNS, timeout). Return
-        # a synthetic 0 status + the reason so callers can report cleanly
-        # without a stack trace.
-        return 0, f"URLError: {exc.reason}"
-
-
-def get_existing_sha(host: str, owner: str, repo: str, path: str,
-                     branch: str, token: str):
-    """Return (sha-or-None, error_status_or_None). On 200 returns the sha.
-    On 404 returns (None, None). Other codes return (None, (status, body))."""
-    qs = urllib.parse.urlencode({"ref": branch})
-    url = f"{host}/api/v1/repos/{owner}/{repo}/contents/{path}?{qs}"
-    status, body = _request("GET", url, token)
-    if status == 200:
-        try:
-            data = json.loads(body)
-            return data.get("sha"), None
-        except (ValueError, TypeError):
-            return None, (status, body)
-    if status == 404:
-        return None, None
-    return None, (status, body)
-
-
-def upload(host: str, owner: str, repo: str, path: str, branch: str,
-           message: str, content_b64: str, sha, token: str):
-    """PUT (update) or POST (create) the file. Returns (new_sha, None) on
-    success or (None, (status, body)) on HTTP error."""
-    url = f"{host}/api/v1/repos/{owner}/{repo}/contents/{path}"
-    if sha:
-        body = {"content": content_b64, "message": message,
-                "branch": branch, "sha": sha}
-        status, resp = _request("PUT", url, token, body)
-    else:
-        body = {"content": content_b64, "message": message, "branch": branch}
-        status, resp = _request("POST", url, token, body)
-    if status in (200, 201):
-        try:
-            data = json.loads(resp)
-            # The file-contents API returns the new content object either at
-            # top-level `content` (POST create) or `content` (PUT update).
-            new_sha = None
-            if isinstance(data, dict):
-                content_obj = data.get("content") or data
-                if isinstance(content_obj, dict):
-                    new_sha = content_obj.get("sha")
-            return new_sha, None
-        except (ValueError, TypeError):
-            return None, None
-    return None, (status, resp)
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Upload a local audit.json to the acdl-evidence Gitea "
-                    "repo via the file-contents API (D-028/D-029).")
-    parser.add_argument("--audit", required=True,
-                        help="Local audit.json file to upload")
-    parser.add_argument("--owner", default="continuous-intelligence",
-                        help="Gitea org (default: continuous-intelligence)")
-    parser.add_argument("--repo", default="acdl-evidence",
-                        help="Gitea repo (default: acdl-evidence)")
-    parser.add_argument("--branch", default="main",
-                        help="Target branch (default: main)")
-    parser.add_argument("--path", default="audit.json",
-                        help="Remote path in the repo (default: audit.json)")
-    parser.add_argument("--token-env", default="ACDL_GITEA_TOKEN",
-                        help="Env var name holding the Gitea token "
-                             "(default: ACDL_GITEA_TOKEN)")
-    parser.add_argument("--host", default="https://git.cloudinit.dev",
-                        help="Gitea host URL (default: https://git.cloudinit.dev)")
-    parser.add_argument("--message", default="chore(evidence): update audit.json",
-                        help="Commit message (default: chore(evidence): "
-                             "update audit.json)")
-    args = parser.parse_args()
-
-    token = os.environ.get(args.token_env)
-    if not token:
-        print(f"finalize_evidence: required env var {args.token_env} is not "
-              f"set", file=sys.stderr)
-        return 1
-
-    # Read + base64-encode the local audit file. Missing/unreadable file is
-    # a clean exit 1 (no stack trace).
-    try:
-        with open(args.audit, "rb") as fh:
-            raw = fh.read()
-    except OSError as exc:
-        print(f"finalize_evidence: cannot read {args.audit}: {exc}",
-              file=sys.stderr)
-        return 1
-    content_b64 = base64.b64encode(raw).decode("ascii")
-
-    # Discover existing sha (update vs create).
-    sha, err = get_existing_sha(args.host, args.owner, args.repo,
-                                args.path, args.branch, token)
-    if err is not None:
-        status, body = err
-        print(json.dumps({"uploaded": False, "status": status, "body": body}))
-        return 1
-
-    # Upload (PUT if sha, POST otherwise).
-    new_sha, err = upload(args.host, args.owner, args.repo, args.path,
-                          args.branch, args.message, content_b64, sha, token)
-    if err is not None:
-        status, body = err
-        print(json.dumps({"uploaded": False, "status": status, "body": body}))
-        return 1
-
-    print(json.dumps({"uploaded": True, "path": args.path,
-                      "sha": new_sha}))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

demo/scripts/gitea_setup.sh

@@ -1,228 +0,0 @@
-#!/usr/bin/env bash
-# Phase 01 Gitea scaffolding. Idempotent.
-#
-# Creates the two new repos under the continuous-intelligence org, pushes a
-# placeholder index.html to acdl-evidence, and creates qa + prod branches on
-# acdl-contracts. Running against existing repos / branches / files is a
-# no-op (409 or 422 is treated as success).
-#
-# Usage: ACDL_GITEA_TOKEN=<token> scripts/gitea_setup.sh
-# Exit codes: 0 = success (created or already existed); 1 = unrecoverable error.
-
-set -euo pipefail
-
-GITEA_HOST="${GITEA_HOST:-https://git.cloudinit.dev}"
-ORG="continuous-intelligence"
-TOKEN="${ACDL_GITEA_TOKEN:?ACDL_GITEA_TOKEN is required}"
-API="${GITEA_HOST}/api/v1"
-
-AUTH=(-H "Authorization: token ${TOKEN}" -H "Content-Type: application/json")
-
-log() { printf '[setup] %s\n' "$*"; }
-warn() { printf '[setup][WARN] %s\n' "$*" >&2; }
-err() { printf '[setup][ERROR] %s\n' "$*" >&2; }
-
-# --- helpers ----------------------------------------------------------------
-
-# http_status_code URL
-http_get_status() {
-  local url="$1"
-  curl -sS -o /dev/null -w "%{http_code}" "${AUTH[@]}" "$url"
-}
-
-# repo_exists NAME -> 0 if exists, 1 otherwise
-repo_exists() {
-  local name="$1"
-  local status
-  status=$(http_get_status "${API}/repos/${ORG}/${name}")
-  [ "$status" = "200" ]
-}
-
-# create_repo NAME DESCRIPTION
-create_repo() {
-  local name="$1"
-  local description="$2"
-  local body
-  body=$(python3 -c "
-import json, sys
-print(json.dumps({
-    'name': '${name}',
-    'description': ${description@Q},
-    'private': True,
-    'default_branch': 'main',
-    'auto_init': True,
-    'gitignores': 'Python',
-    'license': '',
-    'readme': 'Default'
-}))
-")
-  log "Creating repo ${ORG}/${name} (default_branch=main, auto_init=true)"
-  local status body_out
-  status=$(curl -sS -o /tmp/setup_repo_create.json -w "%{http_code}" \
-    "${AUTH[@]}" -X POST -d "$body" \
-    "${API}/orgs/${ORG}/repos")
-  case "$status" in
-    201) log "  created (HTTP 201)" ;;
-    409) log "  already exists (HTTP 409); skipping" ;;
-    *)
-      err "create_repo ${name} failed: HTTP ${status}"
-      cat /tmp/setup_repo_create.json >&2 || true
-      return 1
-      ;;
-  esac
-}
-
-# set_repo_visibility REPO VISIBILITY (public|private)
-set_repo_visibility() {
-  local repo="$1"
-  local visibility="$2"
-  local body
-  body=$(python3 -c "
-import json
-is_private = ('${visibility}' == 'private')
-print(json.dumps({'private': is_private, 'visibility': '${visibility}'}))
-")
-  log "Setting ${repo} visibility to ${visibility}"
-  local status
-  status=$(curl -sS -o /tmp/setup_vis.json -w "%{http_code}" \
-    "${AUTH[@]}" -X PATCH -d "$body" \
-    "${API}/repos/${ORG}/${repo}")
-  case "$status" in
-    200) log "  ok (HTTP 200)" ;;
-    *) warn "set_repo_visibility ${repo} -> ${visibility} returned HTTP ${status} (continuing)"; cat /tmp/setup_vis.json >&2 || true ;;
-  esac
-}
-
-# file_exists REPO PATH -> 0 if the file already exists on the default branch
-file_exists_on_default() {
-  local repo="$1"
-  local path="$2"
-  local status
-  status=$(http_get_status "${API}/repos/${ORG}/${repo}/contents/${path}?ref=main")
-  [ "$status" = "200" ]
-}
-
-# create_placeholder_index REPO
-create_placeholder_index() {
-  local repo="$1"
-  local path="index.html"
-  local placeholder
-  placeholder='<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <title>ACDL Evidence</title>
-  <style>body{font-family:system-ui,sans-serif;margin:2rem;color:#333}</style>
-</head>
-<body>
-  <h1>ACDL Evidence Stream</h1>
-  <p>Evidence timeline will appear here in Phase 05.</p>
-  <p>Placeholder served via Gitea raw file URL (D-012; Gitea has no native Pages).</p>
-</body>
-</html>'
-
-  if file_exists_on_default "$repo" "$path"; then
-    log "index.html already exists on ${repo} main; skipping"
-    return 0
-  fi
-
-  local body
-  body=$(python3 -c "
-import json, base64
-content = '''${placeholder}'''
-print(json.dumps({
-    'content': base64.b64encode(content.encode('utf-8')).decode('ascii'),
-    'message': 'Initial placeholder index.html (Phase 01, D-016)',
-    'branch': 'main'
-}))
-")
-  log "Pushing placeholder index.html to ${repo} main"
-  local status
-  status=$(curl -sS -o /tmp/setup_index_push.json -w "%{http_code}" \
-    "${AUTH[@]}" -X POST -d "$body" \
-    "${API}/repos/${ORG}/${repo}/contents/${path}")
-  case "$status" in
-    201) log "  pushed (HTTP 201)" ;;
-    409|422) log "  already exists or conflict (HTTP ${status}); skipping" ;;
-    *)
-      err "create_placeholder_index on ${repo} failed: HTTP ${status}"
-      cat /tmp/setup_index_push.json >&2 || true
-      return 1
-      ;;
-  esac
-}
-
-# branch_exists REPO BRANCH -> 0 if exists
-branch_exists() {
-  local repo="$1"
-  local branch="$2"
-  local status
-  status=$(http_get_status "${API}/repos/${ORG}/${repo}/branches/${branch}")
-  [ "$status" = "200" ]
-}
-
-# create_branch REPO BRANCH FROM_REF
-create_branch() {
-  local repo="$1"
-  local branch="$2"
-  local from_ref="$3"
-  if branch_exists "$repo" "$branch"; then
-    log "Branch ${branch} already exists on ${repo}; skipping"
-    return 0
-  fi
-  local body
-  body=$(python3 -c "
-import json
-print(json.dumps({'new_branch_name': '${branch}', 'old_branch_name': '${from_ref}'}))
-")
-  log "Creating branch ${branch} on ${repo} from ${from_ref}"
-  local status
-  status=$(curl -sS -o /tmp/setup_branch.json -w "%{http_code}" \
-    "${AUTH[@]}" -X POST -d "$body" \
-    "${API}/repos/${ORG}/${repo}/branches")
-  case "$status" in
-    201) log "  created (HTTP 201)" ;;
-    409) log "  already exists (HTTP 409); skipping" ;;
-    *)
-      err "create_branch ${branch} on ${repo} failed: HTTP ${status}"
-      cat /tmp/setup_branch.json >&2 || true
-      return 1
-      ;;
-  esac
-}
-
-# --- main -------------------------------------------------------------------
-
-log "Host: ${GITEA_HOST}"
-log "Org:  ${ORG}"
-log "Token: <set, ${#TOKEN} chars>"
-
-# Step 1: create acdl-contracts
-if ! repo_exists acdl-contracts; then
-  create_repo acdl-contracts "ACDL developer + agentic entry surface (contract.yaml + issue trigger)" || exit 1
-else
-  log "acdl-contracts already exists; skipping create"
-fi
-
-# Step 2: create acdl-evidence
-if ! repo_exists acdl-evidence; then
-  create_repo acdl-evidence "ACDL hash-chained audit timeline served as a static site via raw file URLs" || exit 1
-else
-  log "acdl-evidence already exists; skipping create"
-fi
-
-# Step 2b: make acdl-evidence public so the Phase 05 UI (index.html) can
-# fetch audit.json from a browser without exposing the API token (D-012
-# raw-URL approach). acdl-contracts stays private.
-set_repo_visibility acdl-evidence public
-
-# Step 3: push placeholder index.html to acdl-evidence
-create_placeholder_index acdl-evidence || exit 1
-
-# Step 4: create qa + prod branches on acdl-contracts (visible stand-in for
-# the unsupported Gitea environments API; per D-013).
-create_branch acdl-contracts qa main || exit 1
-create_branch acdl-contracts prod main || exit 1
-
-log "Done. Run scripts/verify_phase01.sh to confirm success criteria."
-exit 0

demo/scripts/l3b_agent_stub.py

@@ -1,118 +0,0 @@
-#!/usr/bin/env python3
-"""l3b_agent_stub.py — D-008 / D-026 / D-021
-
-Parses a GitHub/Gitea Issue body by keywords and emits a contract.yaml that
-selects an L2 stack. This is the agentic (L3B) entry surface: deterministic
-keyword matching, no external AI APIs.
-
-D-008 keyword map (priority order — first match wins):
-  gas, price, ingest, data-lake        -> l2-commodity-price-feed
-  invoice, billing                     -> l2-invoice-service
-  analytics, historical, query         -> l2-energy-analytics-api
-  regulatory, compliance, reporting, trading
-                                       -> l2-regulatory-reporting
-  (no match)                           -> l2-invoice-service  (fallback)
-
-Output contract.yaml (D-021 schema):
-  stack: <mapped L2 name>
-  inputs:
-    environment: dev
-    owner: citizen-developer
-    source: l3b-agent-stub
-  public-ingress: false
-
-Input:
-  argv[1] = issue body text (or stdin if argv[1] absent/empty)
-  -o <path> = write the contract to a file (default: stdout)
-Exit:
-  0 on success, 1 on empty input
-"""
-import sys
-
-
-# Ordered keyword groups -> L2 stack mapping (D-008). First match wins.
-KEYWORD_MAP = [
-    (("gas", "price", "ingest", "data-lake"), "l2-commodity-price-feed"),
-    (("invoice", "billing"), "l2-invoice-service"),
-    (("analytics", "historical", "query"), "l2-energy-analytics-api"),
-    (("regulatory", "compliance", "reporting", "trading"), "l2-regulatory-reporting"),
-]
-
-FALLBACK_STACK = "l2-invoice-service"
-
-
-def map_issue_to_stack(text: str) -> str:
-    lowered = text.lower()
-    for keywords, stack in KEYWORD_MAP:
-        for kw in keywords:
-            if kw in lowered:
-                return stack
-    return FALLBACK_STACK
-
-
-def render_contract(stack: str) -> str:
-    # Fixed-schema YAML (D-021). Emitted as text (no yaml dependency needed).
-    return (
-        f"stack: {stack}\n"
-        "inputs:\n"
-        "  environment: dev\n"
-        "  owner: citizen-developer\n"
-        "  source: l3b-agent-stub\n"
-        "public-ingress: false\n"
-    )
-
-
-def read_issue_body(args: list) -> str:
-    """Read issue body from args[0] (already-stripped argv, no script name)
-    or stdin. Empty -> error."""
-    if len(args) >= 1 and args[0].strip():
-        return args[0]
-    # Fall back to stdin if argv body is absent or empty.
-    if not sys.stdin.isatty():
-        data = sys.stdin.read()
-        if data.strip():
-            return data
-    return ""
-
-
-def parse_output_flag(argv: list):
-    """Extract -o <path> from argv (returns (rest, output_path))."""
-    output_path = None
-    rest = []
-    i = 1
-    while i < len(argv):
-        arg = argv[i]
-        if arg == "-o":
-            if i + 1 < len(argv):
-                output_path = argv[i + 1]
-                i += 2
-                continue
-            else:
-                print("l3b_agent_stub: -o requires a path argument", file=sys.stderr)
-                sys.exit(1)
-        rest.append(arg)
-        i += 1
-    return rest, output_path
-
-
-def main() -> int:
-    rest, output_path = parse_output_flag(sys.argv)
-    body = read_issue_body(rest)
-    if not body.strip():
-        print("l3b_agent_stub: empty issue body (no argv[1] and no stdin)", file=sys.stderr)
-        return 1
-
-    stack = map_issue_to_stack(body)
-    contract = render_contract(stack)
-
-    if output_path:
-        with open(output_path, "w", encoding="utf-8") as fh:
-            fh.write(contract)
-    else:
-        sys.stdout.write(contract)
-
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

demo/scripts/mock_executor.sh

@@ -1,126 +0,0 @@
-#!/usr/bin/env bash
-# mock_executor.sh — REQ-06 / D-022
-#
-# Reads a contract.yaml, resolves the L2 composition, invokes each L1's
-# mock_apply.sh in order, and writes state.json to the current working
-# directory.
-#
-# Input: argv[1] = path to a contract.yaml file.
-# Output:
-#   - stdout: per-L1 progress (echoed from each mock_apply.sh)
-#   - state.json in cwd: {"l2": "...", "l1s": [...], "contract": {...}}
-# Exit:
-#   0 if all L1s exit 0; 1 if any L1 exited non-zero (state.json is still
-#   written with the recorded exit codes).
-set -euo pipefail
-
-if [[ $# -lt 1 ]]; then
-  echo "usage: mock_executor.sh <contract.yaml>" >&2
-  exit 1
-fi
-
-CONTRACT_PATH="$1"
-
-if [[ ! -f "$CONTRACT_PATH" ]]; then
-  echo "contract not found: $CONTRACT_PATH" >&2
-  exit 1
-fi
-
-# --- Parse the contract (stack + full contract dict) via python3 + yaml. ---
-# Emit stack on line 1 and the full contract JSON on line 2, then read both
-# lines into separate bash variables (so the JSON's internal spaces survive).
-CONTRACT_PARSED=$(python3 - "$CONTRACT_PATH" <<'PY'
-import sys, json, yaml
-path = sys.argv[1]
-with open(path, "r", encoding="utf-8") as fh:
-    contract = yaml.safe_load(fh)
-if not isinstance(contract, dict):
-    sys.stderr.write("contract is not a mapping\n")
-    sys.exit(2)
-stack = contract.get("stack", "")
-# Use a compact JSON (no spaces) so the single-line contract survives bash
-# variable capture cleanly.
-print(stack)
-print(json.dumps(contract, sort_keys=True, separators=(",", ":")))
-PY
-)
-
-STACK=$(printf '%s\n' "$CONTRACT_PARSED" | sed -n '1p')
-CONTRACT_JSON=$(printf '%s\n' "$CONTRACT_PARSED" | sed -n '2p')
-
-if [[ -z "$STACK" ]]; then
-  echo "contract missing 'stack' key" >&2
-  exit 1
-fi
-
-# --- Resolve the L2 manifest. ---
-L2_MANIFEST="modules/l2/${STACK}/manifest.yaml"
-if [[ ! -f "$L2_MANIFEST" ]]; then
-  echo "L2_NOT_FOUND: ${STACK}" >&2
-  exit 1
-fi
-
-# --- Read the L2's l1s: list (ordered names) via python. ---
-L1_NAMES_JSON=$(python3 - "$L2_MANIFEST" <<'PY'
-import sys, json, yaml
-path = sys.argv[1]
-with open(path, "r", encoding="utf-8") as fh:
-    manifest = yaml.safe_load(fh)
-l1s = manifest.get("l1s", []) if isinstance(manifest, dict) else []
-names = [entry.get("name", "") for entry in l1s if isinstance(entry, dict)]
-print(json.dumps(names))
-PY
-)
-
-# --- Invoke each L1's mock_apply.sh in order, recording exit codes. ---
-# Build the l1s results array in JSON via python, appending as we go.
-RESULTS_JSON="[]"
-
-ALL_OK=0
-while IFS= read -r L1_NAME; do
-  L1_SCRIPT="modules/l1/${L1_NAME}/mock_apply.sh"
-  if [[ ! -f "$L1_SCRIPT" ]]; then
-    echo "L1_NOT_FOUND: ${L1_NAME}" >&2
-    exit 1
-  fi
-
-  # Capture stdout + exit code. stderr passes through.
-  L1_OUT=$(bash "$L1_SCRIPT")
-  L1_RC=$?
-
-  # Echo the L1's stdout so the pipeline sees the progress lines.
-  printf '%s\n' "$L1_OUT"
-
-  # Record {"name": ..., "applied": true, "exit_code": ...}.
-  RESULTS_JSON=$(python3 - "$RESULTS_JSON" "$L1_NAME" "$L1_RC" <<'PY'
-import sys, json
-results = json.loads(sys.argv[1])
-name = sys.argv[2]
-rc = int(sys.argv[3])
-results.append({"name": name, "applied": True, "exit_code": rc})
-print(json.dumps(results))
-PY
-)
-
-  if [[ $L1_RC -ne 0 ]]; then
-    ALL_OK=1
-  fi
-done < <(python3 -c "import sys, json; print('\n'.join(json.loads(sys.argv[1])))" "$L1_NAMES_JSON")
-
-# --- Write state.json to the current working directory (D-022). ---
-python3 - "$RESULTS_JSON" "$STACK" "$CONTRACT_JSON" <<'PY'
-import sys, json
-results = json.loads(sys.argv[1])
-stack = sys.argv[2]
-contract = json.loads(sys.argv[3])
-state = {
-    "l2": stack,
-    "l1s": results,
-    "contract": contract,
-}
-with open("state.json", "w", encoding="utf-8") as fh:
-    json.dump(state, fh, indent=2)
-    fh.write("\n")
-PY
-
-exit "$ALL_OK"

demo/scripts/policy_checker.py

@@ -1,51 +0,0 @@
-#!/usr/bin/env python3
-"""policy_checker.py — REQ-07 / D-025
-
-Reads a contract.yaml and enforces the single Phase-03 policy rule:
-`public-ingress: true` is forbidden.
-
-Input:  argv[1] = path to a contract.yaml file.
-Output: stdout "POLICY_PASS" or "POLICY_VIOLATION:PUBLIC_INGRESS"
-Exit:   0 on pass, 1 on violation.
-
-Idempotent, no side effects (no file writes). Treats an absent or falsy
-`public-ingress` key as a pass.
-"""
-import sys
-import yaml
-
-
-def main() -> int:
-    if len(sys.argv) < 2:
-        print("usage: policy_checker.py <contract.yaml>", file=sys.stderr)
-        return 2
-
-    contract_path = sys.argv[1]
-
-    try:
-        with open(contract_path, "r", encoding="utf-8") as fh:
-            contract = yaml.safe_load(fh)
-    except FileNotFoundError:
-        print(f"contract not found: {contract_path}", file=sys.stderr)
-        return 2
-    except yaml.YAMLError as exc:
-        print(f"invalid yaml: {exc}", file=sys.stderr)
-        return 2
-
-    # Treat missing/non-mapping as no policy violation.
-    if not isinstance(contract, dict):
-        print("POLICY_PASS")
-        return 0
-
-    public_ingress = contract.get("public-ingress", False)
-
-    if public_ingress is True:
-        print("POLICY_VIOLATION:PUBLIC_INGRESS")
-        return 1
-
-    print("POLICY_PASS")
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

demo/scripts/run_demo.sh

@@ -1,258 +0,0 @@
-#!/usr/bin/env bash
-# scripts/run_demo.sh — Phase 05 dry-run simulation of the 4 demo acts (T-5.2).
-#
-# Simulates the full 4-act demo locally (no act_runner) by calling the core
-# scripts in sequence and writing hash-chained evidence events to audit.json,
-# then optionally uploads audit.json + evidence-ui/index.html to acdl-evidence
-# main via finalize_evidence.py (D-031, D-033).
-#
-# Usage: scripts/run_demo.sh [--no-upload]
-#   --no-upload  skip the Gitea API calls (useful for testing without a token)
-
-set -uo pipefail
-
-# -----------------------------------------------------------------------------
-# Parse args
-# -----------------------------------------------------------------------------
-UPLOAD=1
-for arg in "$@"; do
-  case "$arg" in
-    --no-upload)
-      UPLOAD=0
-      ;;
-    *)
-      echo "run_demo.sh: unknown argument: $arg" >&2
-      echo "usage: scripts/run_demo.sh [--no-upload]" >&2
-      exit 2
-      ;;
-  esac
-done
-
-# -----------------------------------------------------------------------------
-# Paths
-# -----------------------------------------------------------------------------
-# Repo root = location of this script's parent dir.
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-WORKDIR="/tmp/acdl_demo_run"
-AUDIT="$WORKDIR/audit.json"
-CONTRACTS="$WORKDIR/contracts"
-
-# Track failures so we can return non-zero at the end (we do NOT use set -e
-# because policy_checker intentionally exits 1 on Act 4).
-FAIL=0
-
-# -----------------------------------------------------------------------------
-# Helpers
-# -----------------------------------------------------------------------------
-
-# Write one evidence event. Args: <stage> <event-text>
-ev() {
-  local stage="$1"
-  local text="$2"
-  if ! python3 "$SCRIPT_DIR/evidence_writer.py" --stage "$stage" --event "$text" --audit "$AUDIT"; then
-    echo "run_demo.sh: evidence_writer failed for stage=$stage text=$text" >&2
-    FAIL=1
-  fi
-}
-
-# Run a contract through the Act 2/3 pipeline (policy -> confidence -> executor).
-# Assumes the contract already passed policy (caller verifies). Writes the
-# standard 4-event sequence. Args: <act-label> <dev-applied-event-text>
-run_passing_pipeline() {
-  local dev_event="$1"
-
-  ev dev "$dev_event"
-  ev qa "qa approved"
-  ev prod "prod approved"
-  ev finalize "finalize: audit.json committed to acdl-evidence"
-}
-
-# -----------------------------------------------------------------------------
-# Setup working directory
-# -----------------------------------------------------------------------------
-mkdir -p "$CONTRACTS"
-rm -f "$AUDIT"
-
-# -----------------------------------------------------------------------------
-# Initialize audit (genesis)
-# -----------------------------------------------------------------------------
-echo "== run_demo.sh: initializing audit at $AUDIT =="
-ev genesis "audit log initialized"
-
-# -----------------------------------------------------------------------------
-# Act 1 — Friction
-# -----------------------------------------------------------------------------
-echo "== Act 1 — Friction =="
-ev dev "Act 1 Friction: manual 2-week deployment (legacy process)"
-
-# -----------------------------------------------------------------------------
-# Act 2 — Developer Self-Service
-# -----------------------------------------------------------------------------
-echo "== Act 2 — Developer Self-Service =="
-cat > "$CONTRACTS/act2.yaml" <<'YAML'
-stack: l2-commodity-price-feed
-inputs:
-  environment: dev
-  owner: platform-team
-public-ingress: false
-YAML
-
-ACT2_POLICY="$(python3 "$SCRIPT_DIR/policy_checker.py" "$CONTRACTS/act2.yaml")"
-ACT2_POLICY_RC=$?
-echo "  policy_checker: $ACT2_POLICY (rc=$ACT2_POLICY_RC)"
-if [ "$ACT2_POLICY" != "POLICY_PASS" ]; then
-  echo "run_demo.sh: Act 2 expected POLICY_PASS, got '$ACT2_POLICY'" >&2
-  FAIL=1
-fi
-
-ACT2_CONF="$(python3 "$SCRIPT_DIR/confidence_signal.py" "$CONTRACTS/act2.yaml")"
-echo "  confidence_signal: $ACT2_CONF"
-# Expected: {"score": 0.90, "reason": "POLICY_PASS"}
-
-# mock_executor.sh resolves modules/l2/<stack>/manifest.yaml relative to its
-# cwd, so it must run from the repo root. It writes state.json to its cwd;
-# clean it up from the repo root afterward so no stray file is left there.
-(
-  cd "$REPO_ROOT" && bash "$SCRIPT_DIR/mock_executor.sh" "$CONTRACTS/act2.yaml"
-)
-MOCK_RC=$?
-rm -f "$REPO_ROOT/state.json"
-if [ "$MOCK_RC" -ne 0 ]; then
-  echo "run_demo.sh: Act 2 mock_executor failed (rc=$MOCK_RC)" >&2
-  FAIL=1
-fi
-
-run_passing_pipeline "dev applied: l2-commodity-price-feed"
-
-# -----------------------------------------------------------------------------
-# Act 3 — Citizen Developer
-# -----------------------------------------------------------------------------
-echo "== Act 3 — Citizen Developer =="
-ISSUE_BODY="We need to ingest natural gas prices from Platts and report on compliance for the trading desk."
-if ! python3 "$SCRIPT_DIR/l3b_agent_stub.py" "$ISSUE_BODY" -o "$CONTRACTS/act3.yaml"; then
-  echo "run_demo.sh: l3b_agent_stub failed for Act 3" >&2
-  FAIL=1
-fi
-
-# Confirm the generated contract's stack (D-008: gas/price matches first).
-ACT3_STACK="$(python3 -c "import yaml,sys; print(yaml.safe_load(open('$CONTRACTS/act3.yaml'))['stack'])" 2>/dev/null || echo "")"
-echo "  l3b generated stack: $ACT3_STACK"
-if [ "$ACT3_STACK" != "l2-commodity-price-feed" ]; then
-  echo "run_demo.sh: WARNING Act 3 expected stack l2-commodity-price-feed, got '$ACT3_STACK'" >&2
-  # Continue anyway per the task spec.
-fi
-
-ACT3_POLICY="$(python3 "$SCRIPT_DIR/policy_checker.py" "$CONTRACTS/act3.yaml")"
-ACT3_POLICY_RC=$?
-echo "  policy_checker: $ACT3_POLICY (rc=$ACT3_POLICY_RC)"
-if [ "$ACT3_POLICY" != "POLICY_PASS" ]; then
-  echo "run_demo.sh: Act 3 expected POLICY_PASS, got '$ACT3_POLICY'" >&2
-  FAIL=1
-fi
-
-ACT3_CONF="$(python3 "$SCRIPT_DIR/confidence_signal.py" "$CONTRACTS/act3.yaml")"
-echo "  confidence_signal: $ACT3_CONF"
-
-(
-  cd "$REPO_ROOT" && bash "$SCRIPT_DIR/mock_executor.sh" "$CONTRACTS/act3.yaml"
-)
-MOCK_RC=$?
-rm -f "$REPO_ROOT/state.json"
-if [ "$MOCK_RC" -ne 0 ]; then
-  echo "run_demo.sh: Act 3 mock_executor failed (rc=$MOCK_RC)" >&2
-  FAIL=1
-fi
-
-run_passing_pipeline "dev applied: l2-commodity-price-feed (Act 3 from issue)"
-
-# -----------------------------------------------------------------------------
-# Act 4 — Safety Net
-# -----------------------------------------------------------------------------
-echo "== Act 4 — Safety Net =="
-cat > "$CONTRACTS/act4.yaml" <<'YAML'
-stack: l2-regulatory-reporting
-inputs:
-  environment: dev
-  owner: platform-team
-public-ingress: true
-YAML
-
-# policy_checker exits 1 on violation; capture without failing the script.
-ACT4_POLICY="$(python3 "$SCRIPT_DIR/policy_checker.py" "$CONTRACTS/act4.yaml" 2>&1 || true)"
-echo "  policy_checker: $ACT4_POLICY"
-if [ "$ACT4_POLICY" != "POLICY_VIOLATION:PUBLIC_INGRESS" ]; then
-  echo "run_demo.sh: Act 4 expected POLICY_VIOLATION:PUBLIC_INGRESS, got '$ACT4_POLICY'" >&2
-  FAIL=1
-fi
-
-ACT4_CONF="$(python3 "$SCRIPT_DIR/confidence_signal.py" "$CONTRACTS/act4.yaml")"
-echo "  confidence_signal: $ACT4_CONF"
-# Expected: {"score": 0.40, "reason": "POLICY_VIOLATION:PUBLIC_INGRESS"}
-
-# Score < 0.50 -> dev rejects. Do NOT run mock_executor, do NOT write qa/prod/finalize.
-ev dev "dev rejected: POLICY_VIOLATION:PUBLIC_INGRESS (confidence 0.40 < 0.50)"
-
-# -----------------------------------------------------------------------------
-# Summary
-# -----------------------------------------------------------------------------
-echo "== Summary =="
-python3 - "$AUDIT" <<'PY'
-import json, sys
-audit = json.load(open(sys.argv[1]))
-for e in audit:
-    print(f"{e['seq']} | {e['stage']} | {e['event']} | {e['hash'][:12]}")
-print(f"total events: {len(audit)}")
-PY
-
-EVENT_COUNT="$(python3 -c "import json; print(len(json.load(open('$AUDIT'))))")"
-echo "event count: $EVENT_COUNT"
-
-if [ "$EVENT_COUNT" -lt 11 ]; then
-  echo "run_demo.sh: expected >= 11 events, got $EVENT_COUNT" >&2
-  FAIL=1
-fi
-
-# -----------------------------------------------------------------------------
-# Upload (optional)
-# -----------------------------------------------------------------------------
-if [ "$UPLOAD" -eq 1 ]; then
-  echo "== Upload =="
-  if [ -z "${ACDL_GITEA_TOKEN:-}" ]; then
-    echo "run_demo.sh: ACDL_GITEA_TOKEN not set; skipping upload (use --no-upload to silence)" >&2
-  else
-    # Upload audit.json to acdl-evidence main.
-    if python3 "$SCRIPT_DIR/finalize_evidence.py" --audit "$AUDIT"; then
-      echo "  audit.json uploaded"
-    else
-      echo "run_demo.sh: finalize_evidence failed for audit.json" >&2
-      FAIL=1
-    fi
-    # Upload index.html (the --audit flag accepts any local file path; --path
-    # sets the remote destination).
-    if python3 "$SCRIPT_DIR/finalize_evidence.py" \
-        --audit "$REPO_ROOT/evidence-ui/index.html" \
-        --path index.html \
-        --message "chore(ui): update index.html (demo dry run)"; then
-      echo "  index.html uploaded"
-    else
-      echo "run_demo.sh: finalize_evidence failed for index.html" >&2
-      FAIL=1
-    fi
-    echo "Uploaded audit.json + index.html to acdl-evidence main"
-    echo "  raw URL: https://git.cloudinit.dev/continuous-intelligence/acdl-evidence/raw/branch/main/index.html"
-  fi
-else
-  echo "== Upload skipped (--no-upload) =="
-fi
-
-# -----------------------------------------------------------------------------
-# Exit
-# -----------------------------------------------------------------------------
-if [ "$FAIL" -ne 0 ]; then
-  echo "run_demo.sh: one or more steps failed (see warnings above)" >&2
-  exit 1
-fi
-echo "run_demo.sh: OK ($EVENT_COUNT events)"
-exit 0