save checkpoint

docs/modules/release-orchestrator/api/environments.md

@@ -6,6 +6,9 @@
 **Source:** [Architecture Advisory Section 6.3.2](../../../product/advisories/09-Jan-2026%20-%20Stella%20Ops%20Orchestrator%20Architecture.md)
 **Related Modules:** [Environment Manager](../modules/environment-manager.md), [Agents](../modules/agents.md)
 
+> Runtime note: environment APIs are documented here; controller implementation
+> sequencing is tracked in `../promotion-runtime-gap-closure-plan.md`.
+
 ## Overview
 
 The Environment Management API provides CRUD operations for environments, target groups, deployment targets, agents, freeze windows, and inventory synchronization. All endpoints require authentication and respect tenant isolation via Row-Level Security.

docs/modules/release-orchestrator/api/promotions.md

@@ -6,10 +6,17 @@
 **Source:** [Architecture Advisory Section 6.3.5](../../../product/advisories/09-Jan-2026%20-%20Stella%20Ops%20Orchestrator%20Architecture.md)
 **Related Modules:** [Promotion Manager Module](../modules/promotion-manager.md), [Workflow Promotion](../workflow/promotion.md)
 
+> Runtime note: promotion libraries and tests exist, while the API host controllers
+> for these endpoints are tracked in `../promotion-runtime-gap-closure-plan.md`.
+
 ## Overview
 
 The Promotion API provides endpoints for requesting release promotions between environments, managing approvals, and evaluating promotion gates. Promotions enforce separation of duties (SoD) and require configured approvals before deployment proceeds.
 
+Gate contract references:
+- `../../policy/promotion-gate-ownership-contract.md`
+- `../../evidence-locker/promotion-evidence-contract.md`
+
 ---
 
 ## Promotion Endpoints