feat(P21): environments concept + onboarding scaffold (REQ-61)

---ci---
project: acdl
phase: 21
milestone: v1.6
status: execute
---/ci---

Introduce platform-managed environments: a consumer does not provide an
AWS account, VPC, subnet, S3 state bucket, or runner key. A named
environment is a platform-owned bundle of account + network + state
backend + IAM role (surfaced via ABAC), selected by name in the contract.

Scaffold:
- core/environments/dev.json (sample dev env definition)
- core/environments/README.md (how envs are used + how to add one)
- core/environment_check.py (reads a contract's environment field,
  looks up core/environments/<name>.json, prints a friendly onboarding
  prompt when none exists, exits non-zero)
- scripts/run_platform.sh: Step 0 calls environment_check.py before
  contract validation; a missing env halts the pipeline with the
  onboarding prompt
- tests/test_environment_check.py: 12 tests (dev bound, missing env ->
  onboarding prompt, onboarding message lists provisions, contract
  paths, wire-in, check-only still passes)

Tests: 166 pass (154 + 12 new).
This commit is contained in:
Jon Chery
2026-07-22 18:24:02 +00:00
parent d830357230
commit 4e495e5648
5 changed files with 257 additions and 0 deletions
+27
View File
@@ -0,0 +1,27 @@
# 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).
## 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.
+17
View File
@@ -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
}