platformforge 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (659) hide show
  1. platformforge/__init__.py +7 -0
  2. platformforge/__main__.py +5 -0
  3. platformforge/_forge_portal.py +913 -0
  4. platformforge/_graphstudio.py +376 -0
  5. platformforge/_graphview.py +181 -0
  6. platformforge/_installkit.py +1706 -0
  7. platformforge/agents/__init__.py +156 -0
  8. platformforge/agents/bench.py +61 -0
  9. platformforge/agents/contextpack.py +137 -0
  10. platformforge/agents/contracts.py +394 -0
  11. platformforge/agents/coordinators.py +98 -0
  12. platformforge/agents/critic.py +113 -0
  13. platformforge/agents/debate.py +161 -0
  14. platformforge/agents/executors.py +160 -0
  15. platformforge/agents/guardian.py +48 -0
  16. platformforge/agents/mirrors.py +240 -0
  17. platformforge/agents/orchestrator.py +295 -0
  18. platformforge/agents/planner.py +116 -0
  19. platformforge/agents/playbook.py +51 -0
  20. platformforge/agents/referee.py +132 -0
  21. platformforge/agents/reviewers.py +113 -0
  22. platformforge/agents/roster.py +893 -0
  23. platformforge/agents/runledger.py +85 -0
  24. platformforge/agents/runstore.py +74 -0
  25. platformforge/agents/specialists.py +73 -0
  26. platformforge/agents/taskspec.py +94 -0
  27. platformforge/agents/uniqueness.py +115 -0
  28. platformforge/agents/verifier.py +106 -0
  29. platformforge/aiplat/__init__.py +4 -0
  30. platformforge/aiplat/models.py +175 -0
  31. platformforge/analytics/__init__.py +6 -0
  32. platformforge/analytics/capacity.py +109 -0
  33. platformforge/analytics/debt.py +92 -0
  34. platformforge/analytics/dx.py +69 -0
  35. platformforge/analytics/finops_v4.py +171 -0
  36. platformforge/analytics/goldenpath.py +131 -0
  37. platformforge/analytics/history.py +233 -0
  38. platformforge/analytics/measurement.py +149 -0
  39. platformforge/analytics/models.py +127 -0
  40. platformforge/analytics/opsanalytics.py +119 -0
  41. platformforge/analytics/policyintel.py +139 -0
  42. platformforge/analytics/reliability.py +106 -0
  43. platformforge/analytics/soak.py +135 -0
  44. platformforge/analytics/store.py +254 -0
  45. platformforge/bench.py +174 -0
  46. platformforge/cases/__init__.py +13 -0
  47. platformforge/cases/casefile.py +106 -0
  48. platformforge/cases/context_audit.py +134 -0
  49. platformforge/cases/ledgers.py +174 -0
  50. platformforge/cases/replay.py +142 -0
  51. platformforge/cases/routing_audit.py +162 -0
  52. platformforge/caveman/__init__.py +11 -0
  53. platformforge/caveman/compress.py +156 -0
  54. platformforge/cicd/__init__.py +16 -0
  55. platformforge/cicd/backstage.py +51 -0
  56. platformforge/cicd/dockerfile.py +64 -0
  57. platformforge/cicd/github_actions.py +122 -0
  58. platformforge/cicd/gitlab_ci.py +56 -0
  59. platformforge/cicd/gitops.py +130 -0
  60. platformforge/cli/__init__.py +0 -0
  61. platformforge/cli/fleetcmd.py +457 -0
  62. platformforge/cli/main.py +3832 -0
  63. platformforge/cloud/__init__.py +8 -0
  64. platformforge/cloud/aws.py +254 -0
  65. platformforge/cloud/common.py +69 -0
  66. platformforge/cloud/multicloud.py +143 -0
  67. platformforge/collect/__init__.py +11 -0
  68. platformforge/collect/detect.py +254 -0
  69. platformforge/context/__init__.py +10 -0
  70. platformforge/context/capsule.py +60 -0
  71. platformforge/context/gateway.py +227 -0
  72. platformforge/context/refs.py +49 -0
  73. platformforge/context/sufficiency.py +50 -0
  74. platformforge/core/__init__.py +1 -0
  75. platformforge/core/hashing.py +39 -0
  76. platformforge/core/ownership.py +220 -0
  77. platformforge/core/receipts.py +74 -0
  78. platformforge/core/redaction.py +97 -0
  79. platformforge/core/store.py +119 -0
  80. platformforge/core/workspace.py +89 -0
  81. platformforge/data/contracts/agent-handoff.schema.json +26 -0
  82. platformforge/data/contracts/agent-run.schema.json +27 -0
  83. platformforge/data/contracts/agent-spec.schema.json +43 -0
  84. platformforge/data/contracts/capability.schema.json +23 -0
  85. platformforge/data/contracts/change-event.schema.json +22 -0
  86. platformforge/data/contracts/change-intent.schema.json +62 -0
  87. platformforge/data/contracts/change-plan.schema.json +43 -0
  88. platformforge/data/contracts/collector-receipt.schema.json +36 -0
  89. platformforge/data/contracts/context-pack.schema.json +29 -0
  90. platformforge/data/contracts/debate.schema.json +31 -0
  91. platformforge/data/contracts/distribution-manifest-v1.schema.json +81 -0
  92. platformforge/data/contracts/drift-event.schema.json +21 -0
  93. platformforge/data/contracts/fact.schema.json +35 -0
  94. platformforge/data/contracts/finding.schema.json +20 -0
  95. platformforge/data/contracts/graph-v2.schema.json +67 -0
  96. platformforge/data/contracts/graph.schema.json +40 -0
  97. platformforge/data/contracts/install-receipt-v1.schema.json +49 -0
  98. platformforge/data/contracts/observation.schema.json +93 -0
  99. platformforge/data/contracts/receipt.schema.json +21 -0
  100. platformforge/data/contracts/recommendation.schema.json +32 -0
  101. platformforge/data/contracts/refusal.schema.json +16 -0
  102. platformforge/data/contracts/slo-contract.schema.json +25 -0
  103. platformforge/data/contracts/task-spec.schema.json +37 -0
  104. platformforge/data/contracts/workspace-manifest-v1.schema.json +62 -0
  105. platformforge/data/evals/cases/agent-budget-exhaustion/case.yaml +6 -0
  106. platformforge/data/evals/cases/agent-conflicting-specialists/case.yaml +11 -0
  107. platformforge/data/evals/cases/agent-fleet-optimization/case.yaml +13 -0
  108. platformforge/data/evals/cases/agent-host-no-subagents/case.yaml +6 -0
  109. platformforge/data/evals/cases/agent-incident-multi/case.yaml +13 -0
  110. platformforge/data/evals/cases/agent-missing-evidence/case.yaml +6 -0
  111. platformforge/data/evals/cases/agent-multi-domain-audit/case.yaml +14 -0
  112. platformforge/data/evals/cases/agent-production-change/case.yaml +15 -0
  113. platformforge/data/evals/cases/agent-security-mandatory/case.yaml +12 -0
  114. platformforge/data/evals/cases/agent-simple-iac/case.yaml +14 -0
  115. platformforge/data/evals/cases/approval-integrity-seal/case.yaml +6 -0
  116. platformforge/data/evals/cases/capacity-hot/case.yaml +7 -0
  117. platformforge/data/evals/cases/capacity-hot/fixture/capacity.json +5 -0
  118. platformforge/data/evals/cases/catalog-noowner/case.yaml +7 -0
  119. platformforge/data/evals/cases/catalog-noowner/fixture/catalog-info.yaml +6 -0
  120. platformforge/data/evals/cases/contract-fact/case.yaml +5 -0
  121. platformforge/data/evals/cases/contract-fact/fixture/doc.json +2 -0
  122. platformforge/data/evals/cases/cosign-unverified/case.yaml +8 -0
  123. platformforge/data/evals/cases/cosign-unverified/fixture/sig.json +33 -0
  124. platformforge/data/evals/cases/expected-delta-refusal/case.yaml +6 -0
  125. platformforge/data/evals/cases/finops-noattr/case.yaml +9 -0
  126. platformforge/data/evals/cases/finops-noattr/fixture/costs.json +7 -0
  127. platformforge/data/evals/cases/fleet-inv-absent-allocation-unknown/case.yaml +7 -0
  128. platformforge/data/evals/cases/fleet-inv-centrality-not-criticality/case.yaml +7 -0
  129. platformforge/data/evals/cases/fleet-inv-correlation-not-causality/case.yaml +7 -0
  130. platformforge/data/evals/cases/fleet-inv-dx-no-person-metrics/case.yaml +7 -0
  131. platformforge/data/evals/cases/fleet-inv-federation-restricted-denied/case.yaml +7 -0
  132. platformforge/data/evals/cases/fleet-inv-federation-secret-denied/case.yaml +7 -0
  133. platformforge/data/evals/cases/fleet-inv-history-window-deterministic/case.yaml +7 -0
  134. platformforge/data/evals/cases/fleet-inv-low-util-not-deletable/case.yaml +7 -0
  135. platformforge/data/evals/cases/fleet-inv-member-key-deterministic/case.yaml +7 -0
  136. platformforge/data/evals/cases/fleet-inv-missing-denominator/case.yaml +7 -0
  137. platformforge/data/evals/cases/fleet-inv-partial-coverage-visible/case.yaml +7 -0
  138. platformforge/data/evals/cases/fleet-inv-plan-changeintent-only/case.yaml +7 -0
  139. platformforge/data/evals/cases/fleet-inv-report-all-cited/case.yaml +7 -0
  140. platformforge/data/evals/cases/fleet-inv-small-sample-confidence/case.yaml +7 -0
  141. platformforge/data/evals/cases/fleet-inv-uncertain-optimization-suppressed/case.yaml +7 -0
  142. platformforge/data/evals/cases/gha-dangerous/case.yaml +12 -0
  143. platformforge/data/evals/cases/gha-dangerous/fixture/.github/workflows/ci.yaml +11 -0
  144. platformforge/data/evals/cases/gitops-v2/case.yaml +11 -0
  145. platformforge/data/evals/cases/gitops-v2/fixture/argo.yaml +41 -0
  146. platformforge/data/evals/cases/graph-k8s-blast/case.yaml +7 -0
  147. platformforge/data/evals/cases/graph-k8s-blast/fixture/deploy.yaml +15 -0
  148. platformforge/data/evals/cases/iac-module-nopin/case.yaml +8 -0
  149. platformforge/data/evals/cases/iac-module-nopin/fixture/main.tf +3 -0
  150. platformforge/data/evals/cases/iac-plan-replace/case.yaml +8 -0
  151. platformforge/data/evals/cases/iac-plan-replace/fixture/plan.json +12 -0
  152. platformforge/data/evals/cases/iac-sg-open/case.yaml +8 -0
  153. platformforge/data/evals/cases/iac-sg-open/fixture/main.tf +9 -0
  154. platformforge/data/evals/cases/iam-oidc/case.yaml +8 -0
  155. platformforge/data/evals/cases/iam-oidc/fixture/policy.json +11 -0
  156. platformforge/data/evals/cases/iam-wildcard-positive/case.yaml +8 -0
  157. platformforge/data/evals/cases/iam-wildcard-positive/fixture/policy.json +3 -0
  158. platformforge/data/evals/cases/k8s-bad-actor/case.yaml +19 -0
  159. platformforge/data/evals/cases/k8s-bad-actor/fixture/app.yaml +97 -0
  160. platformforge/data/evals/cases/k8s-beta-api/case.yaml +8 -0
  161. platformforge/data/evals/cases/k8s-beta-api/fixture/cr.yaml +7 -0
  162. platformforge/data/evals/cases/k8s-dep-api-boundary/case.yaml +15 -0
  163. platformforge/data/evals/cases/k8s-dep-api-boundary/fixture/app.yaml +25 -0
  164. platformforge/data/evals/cases/k8s-dep-api-clean/case.yaml +12 -0
  165. platformforge/data/evals/cases/k8s-dep-api-clean/fixture/app.yaml +29 -0
  166. platformforge/data/evals/cases/k8s-dep-api-unknown/case.yaml +11 -0
  167. platformforge/data/evals/cases/k8s-dep-api-unknown/fixture/app.yaml +25 -0
  168. platformforge/data/evals/cases/k8s-dep-api-v120/case.yaml +12 -0
  169. platformforge/data/evals/cases/k8s-dep-api-v120/fixture/app.yaml +25 -0
  170. platformforge/data/evals/cases/k8s-dep-api-v129/case.yaml +9 -0
  171. platformforge/data/evals/cases/k8s-dep-api-v129/fixture/app.yaml +25 -0
  172. platformforge/data/evals/cases/k8s-hpa-noreq/case.yaml +8 -0
  173. platformforge/data/evals/cases/k8s-hpa-noreq/fixture/app.yaml +28 -0
  174. platformforge/data/evals/cases/k8s-limits-boundary/case.yaml +10 -0
  175. platformforge/data/evals/cases/k8s-limits-boundary/fixture/app.yaml +15 -0
  176. platformforge/data/evals/cases/k8s-limits-negative/case.yaml +8 -0
  177. platformforge/data/evals/cases/k8s-limits-negative/fixture/deploy.yaml +15 -0
  178. platformforge/data/evals/cases/k8s-limits-positive/case.yaml +8 -0
  179. platformforge/data/evals/cases/k8s-limits-positive/fixture/deploy.yaml +14 -0
  180. platformforge/data/evals/cases/k8s-nopdb/case.yaml +7 -0
  181. platformforge/data/evals/cases/k8s-nopdb/fixture/app.yaml +34 -0
  182. platformforge/data/evals/cases/knowledge-registry/case.yaml +10 -0
  183. platformforge/data/evals/cases/kyverno-dep/case.yaml +10 -0
  184. platformforge/data/evals/cases/kyverno-dep/fixture/pol.yaml +18 -0
  185. platformforge/data/evals/cases/kyverno-legacy/case.yaml +8 -0
  186. platformforge/data/evals/cases/kyverno-legacy/fixture/pol.yaml +7 -0
  187. platformforge/data/evals/cases/live-aws-collect/case.yaml +11 -0
  188. platformforge/data/evals/cases/live-aws-collect/fixture/aws/ec2_describe-vpcs.json +15 -0
  189. platformforge/data/evals/cases/live-aws-collect/fixture/aws/iam_list-users.denied.txt +1 -0
  190. platformforge/data/evals/cases/live-aws-collect/fixture/aws/sts_get-caller-identity.json +5 -0
  191. platformforge/data/evals/cases/live-drift/case.yaml +8 -0
  192. platformforge/data/evals/cases/live-drift/fixture/after.json +22 -0
  193. platformforge/data/evals/cases/live-drift/fixture/before.json +22 -0
  194. platformforge/data/evals/cases/live-incident/case.yaml +7 -0
  195. platformforge/data/evals/cases/live-incident/fixture/changes.json +8 -0
  196. platformforge/data/evals/cases/live-incident/fixture/incident.json +7 -0
  197. platformforge/data/evals/cases/live-k8s-collect/case.yaml +10 -0
  198. platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_configmaps.denied.txt +1 -0
  199. platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_deployments.apps.json +25 -0
  200. platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_pods.json +17 -0
  201. platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_secrets.json +13 -0
  202. platformforge/data/evals/cases/live-multicluster/case.yaml +7 -0
  203. platformforge/data/evals/cases/live-multicluster/fixture/clusters.json +6 -0
  204. platformforge/data/evals/cases/live-plan/case.yaml +7 -0
  205. platformforge/data/evals/cases/live-plan/fixture/drift.json +8 -0
  206. platformforge/data/evals/cases/live-reconcile/case.yaml +7 -0
  207. platformforge/data/evals/cases/live-reconcile/fixture/desired.json +7 -0
  208. platformforge/data/evals/cases/live-reconcile/fixture/observed.json +18 -0
  209. platformforge/data/evals/cases/live-secrets-boundary/case.yaml +8 -0
  210. platformforge/data/evals/cases/live-secrets-boundary/fixture/envelope.json +16 -0
  211. platformforge/data/evals/cases/live-temporal-graph/case.yaml +10 -0
  212. platformforge/data/evals/cases/live-temporal-graph/fixture/graph.json +22 -0
  213. platformforge/data/evals/cases/ops-approval/case.yaml +6 -0
  214. platformforge/data/evals/cases/ops-convergence/case.yaml +6 -0
  215. platformforge/data/evals/cases/ops-execution-safety/case.yaml +6 -0
  216. platformforge/data/evals/cases/ops-intent/case.yaml +6 -0
  217. platformforge/data/evals/cases/ops-planning/case.yaml +6 -0
  218. platformforge/data/evals/cases/ops-policy/case.yaml +6 -0
  219. platformforge/data/evals/cases/ops-rollback/case.yaml +6 -0
  220. platformforge/data/evals/cases/ops-verification/case.yaml +6 -0
  221. platformforge/data/evals/cases/rollback-argocd-revision/case.yaml +6 -0
  222. platformforge/data/evals/cases/rollback-blind-inverse/case.yaml +6 -0
  223. platformforge/data/evals/cases/rollback-git-commit/case.yaml +6 -0
  224. platformforge/data/evals/cases/rollback-impossible/case.yaml +6 -0
  225. platformforge/data/evals/cases/rollback-k8s-annotation-restore/case.yaml +6 -0
  226. platformforge/data/evals/cases/rollback-k8s-scale/case.yaml +6 -0
  227. platformforge/data/evals/cases/rollback-material-tamper/case.yaml +6 -0
  228. platformforge/data/evals/cases/rollback-terraform-replan/case.yaml +6 -0
  229. platformforge/data/evals/cases/rollback-unknown/case.yaml +6 -0
  230. platformforge/data/evals/cases/routing-specialist/case.yaml +9 -0
  231. platformforge/data/evals/cases/rtk-roundtrip/case.yaml +5 -0
  232. platformforge/data/evals/cases/rtk-roundtrip/fixture/verbose.txt +300 -0
  233. platformforge/data/evals/cases/sbom-vuln/case.yaml +9 -0
  234. platformforge/data/evals/cases/sbom-vuln/fixture/sbom.json +9 -0
  235. platformforge/data/evals/cases/secret-prose-mixed/fixture/app.env +1 -0
  236. platformforge/data/evals/cases/secret-prose-mixed/fixture/policy-notes.md +7 -0
  237. platformforge/data/evals/cases/secrets-noleak/case.yaml +5 -0
  238. platformforge/data/evals/cases/secrets-noleak/fixture/app.env +2 -0
  239. platformforge/data/evals/cases/slo-fastburn/case.yaml +8 -0
  240. platformforge/data/evals/cases/slo-fastburn/fixture/events.yaml +2 -0
  241. platformforge/data/evals/cases/slo-fastburn/fixture/slo.yaml +4 -0
  242. platformforge/data/evals/cases/slo-noinput/case.yaml +8 -0
  243. platformforge/data/evals/cases/slo-noinput/fixture/events.yaml +1 -0
  244. platformforge/data/evals/cases/slo-noinput/fixture/slo.yaml +4 -0
  245. platformforge/data/evals/cases/sot-conflict/case.yaml +6 -0
  246. platformforge/data/evals/cases/token-budget/case.yaml +6 -0
  247. platformforge/data/evals/cases/token-budget/fixture/big.py +50 -0
  248. platformforge/data/evals/cases/xr-delete/case.yaml +8 -0
  249. platformforge/data/evals/cases/xr-delete/fixture/xr.yaml +10 -0
  250. platformforge/data/evals/cases/xr-graph-chain/case.yaml +8 -0
  251. platformforge/data/evals/cases/xr-graph-chain/fixture/xrd.yaml +90 -0
  252. platformforge/data/evals/cases/xr-negative-crd/case.yaml +8 -0
  253. platformforge/data/evals/cases/xr-negative-crd/fixture/widget.yaml +19 -0
  254. platformforge/data/evals/cases/xr-upbound-mr/case.yaml +8 -0
  255. platformforge/data/evals/cases/xr-upbound-mr/fixture/bucket.yaml +12 -0
  256. platformforge/data/evals/qpt-bench/change-review/case.yaml +5 -0
  257. platformforge/data/evals/qpt-bench/change-review/fixture/plan.json +9 -0
  258. platformforge/data/evals/qpt-bench/gha-security/case.yaml +5 -0
  259. platformforge/data/evals/qpt-bench/gha-security/fixture/ci.yml +10 -0
  260. platformforge/data/evals/qpt-bench/iam-investigate/case.yaml +5 -0
  261. platformforge/data/evals/qpt-bench/iam-investigate/fixture/policy.json +6 -0
  262. platformforge/data/evals/qpt-bench/incident-analysis/case.yaml +5 -0
  263. platformforge/data/evals/qpt-bench/incident-analysis/fixture/query.json +5 -0
  264. platformforge/data/evals/qpt-bench/incident-analysis/fixture/rules.yaml +6 -0
  265. platformforge/data/evals/qpt-bench/k8s-review/case.yaml +6 -0
  266. platformforge/data/evals/qpt-bench/k8s-review/fixture/deploy.yaml +15 -0
  267. platformforge/data/evals/qpt-bench/tf-security/case.yaml +5 -0
  268. platformforge/data/evals/qpt-bench/tf-security/fixture/main.tf +17 -0
  269. platformforge/data/knowledge/aws/eks.yaml +20 -0
  270. platformforge/data/knowledge/aws/iam.yaml +28 -0
  271. platformforge/data/knowledge/aws/network-exposure.yaml +19 -0
  272. platformforge/data/knowledge/aws/organizations.yaml +19 -0
  273. platformforge/data/knowledge/crossplane/composition-providers.yaml +20 -0
  274. platformforge/data/knowledge/crossplane/managed-resources.yaml +26 -0
  275. platformforge/data/knowledge/crossplane/v1-v2.yaml +25 -0
  276. platformforge/data/knowledge/kubernetes/api-deprecations.yaml +33 -0
  277. platformforge/data/knowledge/kubernetes/autoscaling-rbac.yaml +27 -0
  278. platformforge/data/knowledge/kubernetes/gateway-api.yaml +20 -0
  279. platformforge/data/knowledge/kubernetes/pod-security.yaml +26 -0
  280. platformforge/data/knowledge/sources.yaml +516 -0
  281. platformforge/data/knowledge/terraform/lifecycle.yaml +18 -0
  282. platformforge/data/knowledge/terraform/plan-semantics.yaml +26 -0
  283. platformforge/data/lab/chaos-pod-kill/chaos.yaml +3 -0
  284. platformforge/data/lab/chaos-pod-kill/facts.json +13 -0
  285. platformforge/data/lab/fleets/acme/capacity.yaml +35 -0
  286. platformforge/data/lab/fleets/acme/costs.yaml +25 -0
  287. platformforge/data/lab/fleets/acme/events.yaml +41 -0
  288. platformforge/data/lab/fleets/acme/fleet.yaml +51 -0
  289. platformforge/data/lab/fleets/acme/graph.yaml +45 -0
  290. platformforge/data/lab/fleets/acme/policies.yaml +28 -0
  291. platformforge/data/lab/fleets/acme/requests.yaml +24 -0
  292. platformforge/data/lab/scenarios/argo-bad-rollout/expected.yaml +6 -0
  293. platformforge/data/lab/scenarios/argo-bad-rollout/fixture/app.yaml +9 -0
  294. platformforge/data/lab/scenarios/aws-dump/expected.yaml +19 -0
  295. platformforge/data/lab/scenarios/aws-dump/fixture/compute.json +4 -0
  296. platformforge/data/lab/scenarios/aws-dump/fixture/iam.json +7 -0
  297. platformforge/data/lab/scenarios/aws-dump/fixture/network.json +6 -0
  298. platformforge/data/lab/scenarios/aws-dump/fixture/org.json +4 -0
  299. platformforge/data/lab/scenarios/aws-dump/fixture/storage.json +4 -0
  300. platformforge/data/lab/scenarios/container-unsigned/expected.yaml +5 -0
  301. platformforge/data/lab/scenarios/container-unsigned/fixture/supply.json +11 -0
  302. platformforge/data/lab/scenarios/cost-idle-workload/expected.yaml +5 -0
  303. platformforge/data/lab/scenarios/cost-idle-workload/fixture/costs.json +12 -0
  304. platformforge/data/lab/scenarios/crossplane-platform/expected.yaml +16 -0
  305. platformforge/data/lab/scenarios/crossplane-platform/fixture/negative.yaml +18 -0
  306. platformforge/data/lab/scenarios/crossplane-platform/fixture/xrd.yaml +90 -0
  307. platformforge/data/lab/scenarios/demo-platform/expected.yaml +16 -0
  308. platformforge/data/lab/scenarios/demo-platform/fixture/.github/workflows/ci.yml +10 -0
  309. platformforge/data/lab/scenarios/demo-platform/fixture/deploy.yaml +16 -0
  310. platformforge/data/lab/scenarios/demo-platform/fixture/infra.tf +5 -0
  311. platformforge/data/lab/scenarios/fleet-ai/expected.yaml +12 -0
  312. platformforge/data/lab/scenarios/fleet-capacity/expected.yaml +12 -0
  313. platformforge/data/lab/scenarios/fleet-cost/expected.yaml +18 -0
  314. platformforge/data/lab/scenarios/fleet-federation/expected.yaml +11 -0
  315. platformforge/data/lab/scenarios/fleet-golden-path/expected.yaml +18 -0
  316. platformforge/data/lab/scenarios/fleet-op-hotspot/expected.yaml +11 -0
  317. platformforge/data/lab/scenarios/fleet-ownership/expected.yaml +17 -0
  318. platformforge/data/lab/scenarios/fleet-partial/expected.yaml +10 -0
  319. platformforge/data/lab/scenarios/fleet-policy-friction/expected.yaml +10 -0
  320. platformforge/data/lab/scenarios/fleet-recurring-incident/expected.yaml +12 -0
  321. platformforge/data/lab/scenarios/fleet-report/expected.yaml +13 -0
  322. platformforge/data/lab/scenarios/fleet-risk/expected.yaml +18 -0
  323. platformforge/data/lab/scenarios/gitops-drift/expected.yaml +6 -0
  324. platformforge/data/lab/scenarios/gitops-drift/fixture/app.yaml +12 -0
  325. platformforge/data/lab/scenarios/k8s-bad-readiness/expected.yaml +6 -0
  326. platformforge/data/lab/scenarios/k8s-bad-readiness/fixture/deploy.yaml +23 -0
  327. platformforge/data/lab/scenarios/k8s-bad-readiness/fixture/netpol.yaml +9 -0
  328. platformforge/data/lab/scenarios/k8s-missing-limits/expected.yaml +6 -0
  329. platformforge/data/lab/scenarios/k8s-missing-limits/fixture/deploy.yaml +26 -0
  330. platformforge/data/lab/scenarios/k8s-missing-limits/fixture/netpol.yaml +9 -0
  331. platformforge/data/lab/scenarios/k8s-single-replica/expected.yaml +5 -0
  332. platformforge/data/lab/scenarios/k8s-single-replica/fixture/deploy.yaml +26 -0
  333. platformforge/data/lab/scenarios/k8s-single-replica/fixture/netpol.yaml +4 -0
  334. platformforge/data/lab/scenarios/live-aws-collect/expected.yaml +4 -0
  335. platformforge/data/lab/scenarios/live-aws-collect/fixture/aws/ec2_describe-vpcs.json +15 -0
  336. platformforge/data/lab/scenarios/live-aws-collect/fixture/aws/iam_list-users.denied.txt +1 -0
  337. platformforge/data/lab/scenarios/live-aws-collect/fixture/aws/sts_get-caller-identity.json +5 -0
  338. platformforge/data/lab/scenarios/live-k8s-collect/expected.yaml +4 -0
  339. platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_configmaps.denied.txt +1 -0
  340. platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_deployments.apps.json +25 -0
  341. platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_pods.json +17 -0
  342. platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_secrets.json +13 -0
  343. platformforge/data/lab/scenarios/live-kind/expected.yaml +14 -0
  344. platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_configmaps.denied.txt +1 -0
  345. platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_deployments.apps.json +25 -0
  346. platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_pods.json +17 -0
  347. platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_secrets.json +13 -0
  348. platformforge/data/lab/scenarios/network-policy-missing/expected.yaml +6 -0
  349. platformforge/data/lab/scenarios/network-policy-missing/fixture/deploy.yaml +26 -0
  350. platformforge/data/lab/scenarios/ops-bad-rollout/expected.yaml +3 -0
  351. platformforge/data/lab/scenarios/ops-bad-rollout/fixture/ops.yaml +33 -0
  352. platformforge/data/lab/scenarios/ops-break-glass/expected.yaml +3 -0
  353. platformforge/data/lab/scenarios/ops-break-glass/fixture/ops.yaml +21 -0
  354. platformforge/data/lab/scenarios/ops-broken-selector/expected.yaml +3 -0
  355. platformforge/data/lab/scenarios/ops-broken-selector/fixture/ops.yaml +21 -0
  356. platformforge/data/lab/scenarios/ops-changed-plan-hash/expected.yaml +3 -0
  357. platformforge/data/lab/scenarios/ops-changed-plan-hash/fixture/ops.yaml +20 -0
  358. platformforge/data/lab/scenarios/ops-conflicting-operation/expected.yaml +3 -0
  359. platformforge/data/lab/scenarios/ops-conflicting-operation/fixture/ops.yaml +21 -0
  360. platformforge/data/lab/scenarios/ops-expired-approval/expected.yaml +3 -0
  361. platformforge/data/lab/scenarios/ops-expired-approval/fixture/ops.yaml +20 -0
  362. platformforge/data/lab/scenarios/ops-partial-failure/expected.yaml +3 -0
  363. platformforge/data/lab/scenarios/ops-partial-failure/fixture/ops.yaml +24 -0
  364. platformforge/data/lab/scenarios/ops-policy-denial/expected.yaml +3 -0
  365. platformforge/data/lab/scenarios/ops-policy-denial/fixture/ops.yaml +17 -0
  366. platformforge/data/lab/scenarios/ops-replica-drift/expected.yaml +3 -0
  367. platformforge/data/lab/scenarios/ops-replica-drift/fixture/ops.yaml +28 -0
  368. platformforge/data/lab/scenarios/ops-rollback-annotate/expected.yaml +3 -0
  369. platformforge/data/lab/scenarios/ops-rollback-annotate/fixture/ops.yaml +41 -0
  370. platformforge/data/lab/scenarios/ops-rollback-gitops/expected.yaml +3 -0
  371. platformforge/data/lab/scenarios/ops-rollback-gitops/fixture/ops.yaml +38 -0
  372. platformforge/data/lab/scenarios/ops-rollback-impossible/expected.yaml +3 -0
  373. platformforge/data/lab/scenarios/ops-rollback-impossible/fixture/ops.yaml +34 -0
  374. platformforge/data/lab/scenarios/ops-rollback-scale/expected.yaml +3 -0
  375. platformforge/data/lab/scenarios/ops-rollback-scale/fixture/ops.yaml +40 -0
  376. platformforge/data/lab/scenarios/ops-rollback-terraform/expected.yaml +3 -0
  377. platformforge/data/lab/scenarios/ops-rollback-terraform/fixture/ops.yaml +38 -0
  378. platformforge/data/lab/scenarios/ops-rollback-terraform/fixture/tf/tfplan.bin +1 -0
  379. platformforge/data/lab/scenarios/ops-stale-observation/expected.yaml +3 -0
  380. platformforge/data/lab/scenarios/ops-stale-observation/fixture/ops.yaml +20 -0
  381. platformforge/data/lab/scenarios/secret-exposure/expected.yaml +5 -0
  382. platformforge/data/lab/scenarios/secret-exposure/fixture/app.env +2 -0
  383. platformforge/data/lab/scenarios/slo-burn/expected.yaml +5 -0
  384. platformforge/data/lab/scenarios/slo-burn/fixture/events.yaml +2 -0
  385. platformforge/data/lab/scenarios/slo-burn/fixture/slo.yaml +4 -0
  386. platformforge/data/lab/scenarios/terraform-iam-wildcard/expected.yaml +5 -0
  387. platformforge/data/lab/scenarios/terraform-iam-wildcard/fixture/policy.json +14 -0
  388. platformforge/data/lab/scenarios/terraform-public-bucket/expected.yaml +6 -0
  389. platformforge/data/lab/scenarios/terraform-public-bucket/fixture/main.tf +5 -0
  390. platformforge/data/portable_skills/platformforge-agents/SKILL.md +47 -0
  391. platformforge/data/portable_skills/platformforge-change/SKILL.md +41 -0
  392. platformforge/data/portable_skills/platformforge-core/SKILL.md +62 -0
  393. platformforge/data/portable_skills/platformforge-economy/SKILL.md +42 -0
  394. platformforge/data/portable_skills/platformforge-finops/SKILL.md +34 -0
  395. platformforge/data/portable_skills/platformforge-fleet/SKILL.md +39 -0
  396. platformforge/data/portable_skills/platformforge-governance/SKILL.md +76 -0
  397. platformforge/data/portable_skills/platformforge-graph/SKILL.md +46 -0
  398. platformforge/data/portable_skills/platformforge-lab/SKILL.md +39 -0
  399. platformforge/data/portable_skills/platformforge-sdd/SKILL.md +39 -0
  400. platformforge/data/portable_skills/platformforge-security/SKILL.md +38 -0
  401. platformforge/data/portable_skills/platformforge-sre/SKILL.md +41 -0
  402. platformforge/data/rules/catalog/finops.yaml +26 -0
  403. platformforge/data/rules/catalog/gitops.yaml +161 -0
  404. platformforge/data/rules/catalog/iac.yaml +84 -0
  405. platformforge/data/rules/catalog/k8s.yaml +322 -0
  406. platformforge/data/rules/catalog/orchestration.yaml +99 -0
  407. platformforge/data/rules/catalog/product.yaml +42 -0
  408. platformforge/data/rules/catalog/routing.yaml +122 -0
  409. platformforge/data/rules/catalog/security.yaml +159 -0
  410. platformforge/data/rules/catalog/sre.yaml +67 -0
  411. platformforge/diagnose/__init__.py +75 -0
  412. platformforge/distribution/__init__.py +18 -0
  413. platformforge/distribution/bundle.py +127 -0
  414. platformforge/distribution/hostflow.py +247 -0
  415. platformforge/distribution/models.py +80 -0
  416. platformforge/distribution/service.py +225 -0
  417. platformforge/economy/__init__.py +27 -0
  418. platformforge/economy/bench.py +66 -0
  419. platformforge/economy/budget.py +198 -0
  420. platformforge/economy/cache.py +287 -0
  421. platformforge/economy/checkpoint.py +112 -0
  422. platformforge/economy/collection.py +142 -0
  423. platformforge/economy/doctor.py +207 -0
  424. platformforge/economy/engine.py +158 -0
  425. platformforge/economy/envelope.py +61 -0
  426. platformforge/economy/fleetpack.py +86 -0
  427. platformforge/economy/ledger.py +232 -0
  428. platformforge/economy/plan.py +131 -0
  429. platformforge/economy/pricing.py +101 -0
  430. platformforge/economy/qpt.py +286 -0
  431. platformforge/economy/reconcile.py +86 -0
  432. platformforge/economy/verifyplan.py +107 -0
  433. platformforge/economy/waste.py +123 -0
  434. platformforge/evals/__init__.py +16 -0
  435. platformforge/evals/coverage.py +140 -0
  436. platformforge/evals/fleet_invariants.py +260 -0
  437. platformforge/evals/ops_invariants.py +158 -0
  438. platformforge/evals/runner.py +541 -0
  439. platformforge/federation/__init__.py +4 -0
  440. platformforge/federation/node.py +135 -0
  441. platformforge/finops/__init__.py +14 -0
  442. platformforge/finops/alloc.py +31 -0
  443. platformforge/finops/costs.py +79 -0
  444. platformforge/finops/focus.py +100 -0
  445. platformforge/finops/graph_cost.py +51 -0
  446. platformforge/finops/ingest.py +144 -0
  447. platformforge/finops/insights.py +193 -0
  448. platformforge/finops/unit.py +36 -0
  449. platformforge/fleet/__init__.py +5 -0
  450. platformforge/fleet/loader.py +73 -0
  451. platformforge/fleet/models.py +155 -0
  452. platformforge/fleet/orggraph.py +172 -0
  453. platformforge/fleet/query.py +154 -0
  454. platformforge/forge/__init__.py +9 -0
  455. platformforge/forge/collect.py +88 -0
  456. platformforge/forge/delegate.py +77 -0
  457. platformforge/forge/manifest.py +106 -0
  458. platformforge/freeze/__init__.py +22 -0
  459. platformforge/freeze/exceptions.py +56 -0
  460. platformforge/freeze/manifest.py +167 -0
  461. platformforge/freeze/snapshots.py +108 -0
  462. platformforge/graph/__init__.py +39 -0
  463. platformforge/graph/backend.py +174 -0
  464. platformforge/graph/bench.py +245 -0
  465. platformforge/graph/build.py +130 -0
  466. platformforge/graph/delivery.py +183 -0
  467. platformforge/graph/diff.py +292 -0
  468. platformforge/graph/events.py +116 -0
  469. platformforge/graph/migrate.py +44 -0
  470. platformforge/graph/model.py +264 -0
  471. platformforge/graph/persist.py +97 -0
  472. platformforge/graph/query.py +290 -0
  473. platformforge/graph/temporal.py +78 -0
  474. platformforge/graph/vocab.py +63 -0
  475. platformforge/graphview.py +94 -0
  476. platformforge/iac/__init__.py +7 -0
  477. platformforge/iac/drift.py +53 -0
  478. platformforge/iac/plan.py +84 -0
  479. platformforge/iac/terraform.py +123 -0
  480. platformforge/install/__init__.py +1 -0
  481. platformforge/install/service.py +421 -0
  482. platformforge/k8s/__init__.py +8 -0
  483. platformforge/k8s/helm.py +152 -0
  484. platformforge/k8s/hubble.py +87 -0
  485. platformforge/k8s/manifests.py +513 -0
  486. platformforge/knowledge/__init__.py +1 -0
  487. platformforge/knowledge/packs.py +157 -0
  488. platformforge/knowledge/registry.py +249 -0
  489. platformforge/knowledge/select.py +127 -0
  490. platformforge/lab/__init__.py +5 -0
  491. platformforge/lab/chaos.py +71 -0
  492. platformforge/lab/fleetlab.py +351 -0
  493. platformforge/lab/opslab.py +271 -0
  494. platformforge/lab/runner.py +219 -0
  495. platformforge/live/__init__.py +36 -0
  496. platformforge/live/budget.py +92 -0
  497. platformforge/live/capability.py +80 -0
  498. platformforge/live/collectors/__init__.py +6 -0
  499. platformforge/live/collectors/aws.py +370 -0
  500. platformforge/live/collectors/aws_transport.py +98 -0
  501. platformforge/live/collectors/k8s.py +389 -0
  502. platformforge/live/collectors/k8s_transport.py +85 -0
  503. platformforge/live/cursors.py +48 -0
  504. platformforge/live/drift.py +130 -0
  505. platformforge/live/envelope.py +85 -0
  506. platformforge/live/federation.py +113 -0
  507. platformforge/live/fixtures.py +168 -0
  508. platformforge/live/identity.py +258 -0
  509. platformforge/live/incident.py +200 -0
  510. platformforge/live/models.py +435 -0
  511. platformforge/live/reconcile.py +382 -0
  512. platformforge/live/remediate.py +169 -0
  513. platformforge/live/store.py +256 -0
  514. platformforge/live/topology.py +249 -0
  515. platformforge/mcp/__init__.py +7 -0
  516. platformforge/mcp/parity.py +69 -0
  517. platformforge/mcp/registry.py +427 -0
  518. platformforge/mcp/server.py +84 -0
  519. platformforge/mcp/tools.py +732 -0
  520. platformforge/models/__init__.py +21 -0
  521. platformforge/models/base.py +214 -0
  522. platformforge/observe/__init__.py +26 -0
  523. platformforge/observe/capacity.py +39 -0
  524. platformforge/observe/dr.py +67 -0
  525. platformforge/observe/grafana.py +76 -0
  526. platformforge/observe/incident.py +58 -0
  527. platformforge/observe/otel.py +135 -0
  528. platformforge/observe/postmortem.py +72 -0
  529. platformforge/observe/prometheus.py +88 -0
  530. platformforge/observe/slo.py +125 -0
  531. platformforge/ops/__init__.py +8 -0
  532. platformforge/ops/actions.py +215 -0
  533. platformforge/ops/analytics.py +83 -0
  534. platformforge/ops/approval.py +275 -0
  535. platformforge/ops/autorem.py +101 -0
  536. platformforge/ops/config.py +175 -0
  537. platformforge/ops/engine.py +758 -0
  538. platformforge/ops/envelope.py +135 -0
  539. platformforge/ops/executors/__init__.py +1 -0
  540. platformforge/ops/executors/base.py +211 -0
  541. platformforge/ops/executors/git.py +77 -0
  542. platformforge/ops/executors/gitops.py +134 -0
  543. platformforge/ops/executors/terraform.py +84 -0
  544. platformforge/ops/gates.py +135 -0
  545. platformforge/ops/goldenpath.py +180 -0
  546. platformforge/ops/material.py +181 -0
  547. platformforge/ops/models.py +421 -0
  548. platformforge/ops/operation.py +335 -0
  549. platformforge/ops/opgraph.py +233 -0
  550. platformforge/ops/policy.py +275 -0
  551. platformforge/ops/preconditions.py +109 -0
  552. platformforge/ops/registry.py +101 -0
  553. platformforge/ops/risk.py +216 -0
  554. platformforge/ops/rollback.py +287 -0
  555. platformforge/ops/rollback_builders.py +163 -0
  556. platformforge/ops/runbook.py +269 -0
  557. platformforge/ops/simulate.py +125 -0
  558. platformforge/ops/source_of_truth.py +198 -0
  559. platformforge/ops/store.py +157 -0
  560. platformforge/ops/verify.py +190 -0
  561. platformforge/optimize/__init__.py +4 -0
  562. platformforge/optimize/engine.py +109 -0
  563. platformforge/optimize/models.py +68 -0
  564. platformforge/optimize/scan.py +196 -0
  565. platformforge/plan/__init__.py +107 -0
  566. platformforge/portable_cli.py +199 -0
  567. platformforge/portal_adapter.py +740 -0
  568. platformforge/portal_assets/chunk-7_l-b4Tr.js +1 -0
  569. platformforge/portal_assets/chunk-B0Iad6pD.js +1 -0
  570. platformforge/portal_assets/chunk-B605XnCF.js +1 -0
  571. platformforge/portal_assets/chunk-B7N3TXcn.js +1 -0
  572. platformforge/portal_assets/chunk-BAj6yGem.js +1 -0
  573. platformforge/portal_assets/chunk-BGUitn2r.js +1 -0
  574. platformforge/portal_assets/chunk-BVKnCv85.js +1 -0
  575. platformforge/portal_assets/chunk-BYyM9V_w.js +1 -0
  576. platformforge/portal_assets/chunk-BaQMhq-G.js +1 -0
  577. platformforge/portal_assets/chunk-BavOrxVm.js +1 -0
  578. platformforge/portal_assets/chunk-Bb0C24YV.js +1 -0
  579. platformforge/portal_assets/chunk-BfCFGPzs.js +1 -0
  580. platformforge/portal_assets/chunk-C2t4OUVu.js +1 -0
  581. platformforge/portal_assets/chunk-C3pI4QjU.js +1 -0
  582. platformforge/portal_assets/chunk-C4gpbtbP.js +1 -0
  583. platformforge/portal_assets/chunk-CGWeHhKY.js +1 -0
  584. platformforge/portal_assets/chunk-CJCT86Dr.js +1 -0
  585. platformforge/portal_assets/chunk-CXcsLDPJ.js +1 -0
  586. platformforge/portal_assets/chunk-CcjxoLxw.js +1 -0
  587. platformforge/portal_assets/chunk-D-gBPXHa.js +1 -0
  588. platformforge/portal_assets/chunk-D3eZogIe.js +1 -0
  589. platformforge/portal_assets/chunk-DQU0VyoQ.js +1 -0
  590. platformforge/portal_assets/chunk-DqWNkF1O.js +1 -0
  591. platformforge/portal_assets/chunk-DuPPkSIE.js +3 -0
  592. platformforge/portal_assets/chunk-DyIHOW_a.js +1 -0
  593. platformforge/portal_assets/chunk-Fx4zSGL5.js +1 -0
  594. platformforge/portal_assets/chunk-UBKt05Rg.js +1 -0
  595. platformforge/portal_assets/chunk-htnJDQEY.js +1 -0
  596. platformforge/portal_assets/chunk-kXRFMGqe.js +1 -0
  597. platformforge/portal_assets/chunk-qe3u763a.js +1 -0
  598. platformforge/portal_assets/favicon.ico +0 -0
  599. platformforge/portal_assets/index.html +13 -0
  600. platformforge/portal_assets/main-QDFVZK3T.js +5 -0
  601. platformforge/portal_assets/styles-MQEBDFDX.css +1 -0
  602. platformforge/product/__init__.py +10 -0
  603. platformforge/product/backstage.py +49 -0
  604. platformforge/product/catalog.py +74 -0
  605. platformforge/product/crossplane.py +341 -0
  606. platformforge/product/golden_paths/__init__.py +5 -0
  607. platformforge/product/golden_paths/engine.py +97 -0
  608. platformforge/product/golden_paths/library.yaml +198 -0
  609. platformforge/product/golden_paths/model.py +84 -0
  610. platformforge/product/maturity.py +107 -0
  611. platformforge/product/scorecards.py +84 -0
  612. platformforge/resources.py +36 -0
  613. platformforge/risk/__init__.py +5 -0
  614. platformforge/risk/engine.py +95 -0
  615. platformforge/risk/signals.py +49 -0
  616. platformforge/routing/__init__.py +13 -0
  617. platformforge/routing/decision.py +191 -0
  618. platformforge/routing/router.py +328 -0
  619. platformforge/rtk/__init__.py +9 -0
  620. platformforge/rtk/compact.py +127 -0
  621. platformforge/rtk/parsers.py +199 -0
  622. platformforge/rules/__init__.py +5 -0
  623. platformforge/rules/engine.py +345 -0
  624. platformforge/sandbox/__init__.py +7 -0
  625. platformforge/sandbox/env.py +151 -0
  626. platformforge/sandbox/review.py +92 -0
  627. platformforge/sdd/__init__.py +8 -0
  628. platformforge/sdd/lifecycle.py +239 -0
  629. platformforge/security/__init__.py +19 -0
  630. platformforge/security/cosign.py +67 -0
  631. platformforge/security/iam.py +112 -0
  632. platformforge/security/identity.py +84 -0
  633. platformforge/security/kyverno.py +106 -0
  634. platformforge/security/sbom.py +59 -0
  635. platformforge/security/scan.py +63 -0
  636. platformforge/security/slsa.py +86 -0
  637. platformforge/security/supply.py +62 -0
  638. platformforge/tokensave/__init__.py +20 -0
  639. platformforge/tokensave/budget.py +62 -0
  640. platformforge/tokensave/estimate.py +21 -0
  641. platformforge/tokensave/index.py +172 -0
  642. platformforge/tokensave/ledger.py +121 -0
  643. platformforge/tokensave/packs.py +285 -0
  644. platformforge/ui/__init__.py +28 -0
  645. platformforge/ui/app.py +465 -0
  646. platformforge/ui/home.py +113 -0
  647. platformforge/ui/i18n.py +143 -0
  648. platformforge/ui/kit.py +689 -0
  649. platformforge/ui/screen.py +628 -0
  650. platformforge/ui/tui.py +94 -0
  651. platformforge/ui/wizard.py +309 -0
  652. platformforge/workspace/__init__.py +13 -0
  653. platformforge/workspace/models.py +35 -0
  654. platformforge/workspace/service.py +69 -0
  655. platformforge-0.1.0.dist-info/METADATA +212 -0
  656. platformforge-0.1.0.dist-info/RECORD +659 -0
  657. platformforge-0.1.0.dist-info/WHEEL +4 -0
  658. platformforge-0.1.0.dist-info/entry_points.txt +3 -0
  659. platformforge-0.1.0.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,135 @@
1
+ """Cycle 4 — ExecutionEnvelope (§65–67, ADR-0021/0025).
2
+
3
+ The envelope is the *exact* set of authorized actions: executor, typed
4
+ actions, scope, preconditions, policy decisions, approvals, risk,
5
+ expected delta, verification + rollback strategies, idempotency key,
6
+ TTL. It is hash-pinned — after `freeze()` (approval binding) any content
7
+ change produces a different hash and downstream validation refuses.
8
+ Envelopes are minted only when policy allows; they never mint themselves.
9
+ """
10
+
11
+ from __future__ import annotations
12
+
13
+ from dataclasses import dataclass, field
14
+ from typing import Any
15
+
16
+ from platformforge.live.models import canonical_hash, now_iso, parse_ts
17
+ from platformforge.ops.actions import validate_action
18
+
19
+ ENVELOPE_SCHEMA = "platformforge/execution/v1"
20
+
21
+
22
+ @dataclass
23
+ class ExecutionEnvelope:
24
+ execution_id: str = ""
25
+ intent_id: str = ""
26
+ change_plan_hash: str = ""
27
+ executor: str = ""
28
+ actions: list[dict[str, Any]] = field(default_factory=list) # {action, params, step_id}
29
+ scope: list[str] = field(default_factory=list)
30
+ preconditions: dict[str, Any] = field(default_factory=dict)
31
+ policy_decisions: list[dict[str, Any]] = field(default_factory=list)
32
+ approvals: list[str] = field(default_factory=list) # approval ids
33
+ risk: dict[str, Any] = field(default_factory=dict)
34
+ expected_delta: dict[str, Any] = field(default_factory=dict)
35
+ verification: dict[str, Any] = field(default_factory=dict)
36
+ rollback: dict[str, Any] = field(default_factory=dict)
37
+ idempotency_key: str = ""
38
+ created_at: str = ""
39
+ expires_at: str = ""
40
+ _frozen_hash: str = field(default="", repr=False, compare=False)
41
+
42
+ def __post_init__(self):
43
+ if not self.created_at:
44
+ self.created_at = now_iso()
45
+ if not self.idempotency_key:
46
+ self.idempotency_key = "idem-" + canonical_hash(
47
+ {"intent": self.intent_id, "plan": self.change_plan_hash,
48
+ "actions": self.actions})[:24]
49
+
50
+ def validate(self) -> list[dict[str, Any]]:
51
+ v: list[dict[str, Any]] = []
52
+ if not self.execution_id:
53
+ v.append({"refusal": "PF-OPS-BAD-EXECUTION-ID",
54
+ "unlock": "set execution_id"})
55
+ if not self.change_plan_hash:
56
+ v.append({"refusal": "PF-OPS-ENVELOPE-NO-PLAN",
57
+ "unlock": "envelope must bind to a change_plan_hash"})
58
+ if not self.approvals and not self.policy_decisions:
59
+ v.append({"refusal": "PF-OPS-ENVELOPE-UNGOVERNED",
60
+ "unlock": "envelope requires policy decisions and/or "
61
+ "approvals — execution is never self-minted"})
62
+ for a in self.actions:
63
+ r = validate_action(a.get("action", ""), a.get("params", {}))
64
+ if r:
65
+ v.append(r)
66
+ if self.expires_at and parse_ts(self.expires_at) is None:
67
+ v.append({"refusal": "PF-OPS-BAD-EXPIRY",
68
+ "unlock": "expires_at must be ISO-8601"})
69
+ return v
70
+
71
+ def hash(self) -> str:
72
+ return "sha256:" + canonical_hash(self.to_dict())
73
+
74
+ @property
75
+ def frozen(self) -> bool:
76
+ return bool(self._frozen_hash)
77
+
78
+ def freeze(self) -> str:
79
+ """Bind the envelope to its current hash — post-approval the
80
+ object is treated as immutable (§67)."""
81
+ self._frozen_hash = self.hash()
82
+ return self._frozen_hash
83
+
84
+ def is_intact(self) -> bool:
85
+ return not self._frozen_hash or self.hash() == self._frozen_hash
86
+
87
+ def is_expired(self, at: str | None = None) -> bool:
88
+ exp = parse_ts(self.expires_at)
89
+ ref = parse_ts(at) if at else parse_ts(now_iso())
90
+ return bool(exp and ref and ref > exp)
91
+
92
+ def mutating_actions(self) -> list[dict[str, Any]]:
93
+ from platformforge.ops.actions import spec_for
94
+ return [a for a in self.actions
95
+ if (s := spec_for(a.get("action", ""))) and s.mutating]
96
+
97
+ def to_dict(self) -> dict[str, Any]:
98
+ from platformforge.core.redaction import redact_obj
99
+ return {"schema": ENVELOPE_SCHEMA,
100
+ "execution_id": self.execution_id,
101
+ "intent_id": self.intent_id,
102
+ "change_plan_hash": self.change_plan_hash,
103
+ "executor": self.executor,
104
+ # action params are redacted at the serialization
105
+ # boundary — an envelope never emits raw secrets
106
+ "actions": redact_obj(self.actions),
107
+ "scope": self.scope, "preconditions": self.preconditions,
108
+ "policy_decisions": self.policy_decisions,
109
+ "approvals": self.approvals, "risk": self.risk,
110
+ "expected_delta": self.expected_delta,
111
+ "verification": self.verification,
112
+ "rollback": self.rollback,
113
+ "idempotency_key": self.idempotency_key,
114
+ "created_at": self.created_at,
115
+ "expires_at": self.expires_at}
116
+
117
+ @classmethod
118
+ def from_dict(cls, d: dict[str, Any]) -> ExecutionEnvelope:
119
+ return cls(
120
+ execution_id=d.get("execution_id", ""),
121
+ intent_id=d.get("intent_id", ""),
122
+ change_plan_hash=d.get("change_plan_hash", ""),
123
+ executor=d.get("executor", ""),
124
+ actions=list(d.get("actions", [])),
125
+ scope=list(d.get("scope", [])),
126
+ preconditions=dict(d.get("preconditions", {})),
127
+ policy_decisions=list(d.get("policy_decisions", [])),
128
+ approvals=list(d.get("approvals", [])),
129
+ risk=dict(d.get("risk", {})),
130
+ expected_delta=dict(d.get("expected_delta", {})),
131
+ verification=dict(d.get("verification", {})),
132
+ rollback=dict(d.get("rollback", {})),
133
+ idempotency_key=d.get("idempotency_key", ""),
134
+ created_at=d.get("created_at", ""),
135
+ expires_at=d.get("expires_at", ""))
@@ -0,0 +1 @@
1
+ """Executors package init."""
@@ -0,0 +1,211 @@
1
+ """Cycle 4 — executor boundary (§70–71, ADR-0027).
2
+
3
+ Executors are deterministic host-side adapters. The core builds typed
4
+ steps; transports run them; results come back as ExecutionReceipts.
5
+ An executor NEVER sees LLM context and NEVER receives a raw shell
6
+ string — only `action` + validated `params`.
7
+
8
+ Transport contract (same shape as collectors):
9
+ run(argv: list[str], cwd: str|None, timeout_s: int)
10
+ -> (rc: int, stdout: str, stderr: str)
11
+ Injected per call — tests and fixtures replay deterministic transports.
12
+ """
13
+
14
+ from __future__ import annotations
15
+
16
+ import time
17
+ from collections.abc import Callable
18
+ from dataclasses import dataclass, field
19
+ from typing import Any
20
+
21
+ from platformforge.live.models import canonical_hash, now_iso
22
+ from platformforge.ops.actions import spec_for, validate_action
23
+
24
+ Transport = Callable[..., tuple[int, str, str]]
25
+
26
+ RECEIPT_SCHEMA = "platformforge/execution-receipt/v1"
27
+
28
+
29
+ @dataclass
30
+ class ExecutionReceipt:
31
+ """§94–96 — what happened, hashed, reproducible."""
32
+
33
+ step_id: str
34
+ action: str
35
+ executor: str
36
+ ok: bool
37
+ dry_run: bool = False
38
+ rc: int = 0
39
+ started_at: str = ""
40
+ finished_at: str = ""
41
+ duration_ms: int = 0
42
+ outputs: dict[str, Any] = field(default_factory=dict)
43
+ refusal: dict[str, Any] | None = None
44
+ error: str = ""
45
+ argv_hash: str = "" # hash of the argv (argv may contain paths)
46
+ side_effects: str = ""
47
+ receipt_hash: str = ""
48
+
49
+ def finalize(self) -> ExecutionReceipt:
50
+ body = {
51
+ "step_id": self.step_id,
52
+ "action": self.action,
53
+ "executor": self.executor,
54
+ "ok": self.ok,
55
+ "dry_run": self.dry_run,
56
+ "rc": self.rc,
57
+ "finished_at": self.finished_at,
58
+ "outputs": self.outputs,
59
+ "error": self.error,
60
+ "argv_hash": self.argv_hash,
61
+ "refusal": self.refusal,
62
+ }
63
+ self.receipt_hash = "sha256:" + canonical_hash(body)
64
+ return self
65
+
66
+ def to_dict(self) -> dict[str, Any]:
67
+ return {
68
+ "schema": RECEIPT_SCHEMA,
69
+ "step_id": self.step_id,
70
+ "action": self.action,
71
+ "executor": self.executor,
72
+ "ok": self.ok,
73
+ "dry_run": self.dry_run,
74
+ "rc": self.rc,
75
+ "started_at": self.started_at,
76
+ "finished_at": self.finished_at,
77
+ "duration_ms": self.duration_ms,
78
+ "outputs": self.outputs,
79
+ "argv_hash": self.argv_hash,
80
+ "side_effects": self.side_effects,
81
+ "refusal": self.refusal,
82
+ "error": self.error,
83
+ "receipt_hash": self.receipt_hash,
84
+ }
85
+
86
+
87
+ class Executor:
88
+ """Base: dispatch typed actions to argv builders; wrap in receipts."""
89
+
90
+ name = "abstract"
91
+
92
+ def supports(self, action: str) -> bool:
93
+ s = spec_for(action)
94
+ return bool(s and s.executor == self.name)
95
+
96
+ def argv_for(self, action: str, params: dict[str, Any], dry_run: bool) -> list[str] | dict[str, Any]:
97
+ """Return argv or a refusal dict."""
98
+ return {"refusal": "PF-OPS-NO-EXECUTOR", "unlock": f"{self.name} has no argv builder for {action}"}
99
+
100
+ def run_step(
101
+ self,
102
+ step_id: str,
103
+ action: str,
104
+ params: dict[str, Any],
105
+ *,
106
+ transport: Transport | None = None,
107
+ dry_run: bool = False,
108
+ cwd: str | None = None,
109
+ timeout_s: int | None = None,
110
+ ) -> ExecutionReceipt:
111
+ spec = spec_for(action)
112
+ started = now_iso()
113
+ t0 = time.monotonic()
114
+ r = ExecutionReceipt(
115
+ step_id=step_id, action=action, executor=self.name, ok=False, dry_run=dry_run, started_at=started
116
+ )
117
+
118
+ def finish(ok: bool, **kw) -> ExecutionReceipt:
119
+ r.ok = ok
120
+ r.finished_at = now_iso()
121
+ r.duration_ms = int((time.monotonic() - t0) * 1000)
122
+ for k, v in kw.items():
123
+ setattr(r, k, v)
124
+ return r.finalize()
125
+
126
+ if spec is None:
127
+ return finish(
128
+ False,
129
+ refusal={"refusal": "PF-OPS-UNKNOWN-ACTION", "unlock": f"action {action} not in vocabulary"},
130
+ )
131
+ if spec.executor != self.name:
132
+ return finish(
133
+ False,
134
+ refusal={
135
+ "refusal": "PF-OPS-WRONG-EXECUTOR",
136
+ "unlock": f"{action} is owned by {spec.executor}, not {self.name}",
137
+ },
138
+ )
139
+ err = validate_action(action, params)
140
+ if err:
141
+ return finish(False, refusal=err)
142
+ if dry_run and not spec.dry_run:
143
+ return finish(
144
+ False, refusal={"refusal": "PF-OPS-NO-DRYRUN", "unlock": f"{action} does not support dry-run"}
145
+ )
146
+ if spec.mutating and transport is None:
147
+ return finish(
148
+ False,
149
+ refusal={
150
+ "refusal": "PF-OPS-NO-TRANSPORT",
151
+ "unlock": "mutating actions require an injected host "
152
+ "transport — the core never executes alone",
153
+ },
154
+ )
155
+ argv = self.argv_for(action, params, dry_run)
156
+ if isinstance(argv, dict): # refusal from builder
157
+ return finish(False, refusal=argv)
158
+ r.argv_hash = "sha256:" + canonical_hash(argv)
159
+ r.side_effects = spec.side_effects
160
+ if transport is None: # non-mutating, no transport
161
+ return finish(True, outputs={"skipped": "no transport"})
162
+ try:
163
+ rc, out, err_s = transport(argv, cwd, timeout_s or spec.timeout_s)
164
+ except Exception as exc: # noqa: BLE001 — adapter failure is evidence
165
+ return finish(False, error=f"transport-error:{exc}")
166
+ r.rc = rc
167
+ outputs = self.parse_outputs(action, rc, out, err_s)
168
+ if rc != 0:
169
+ return finish(False, outputs=outputs, error=err_s[:2000])
170
+ return finish(True, outputs=outputs)
171
+
172
+ def parse_outputs(self, action: str, rc: int, out: str, err: str) -> dict[str, Any]:
173
+ return {"stdout_tail": out[-2000:], "stderr_tail": err[-2000:]}
174
+
175
+
176
+ class ObserveExecutor(Executor):
177
+ """Read-only observation steps — dispatch to the live collectors'
178
+ contract (typed observe actions, never free-form queries)."""
179
+
180
+ name = "observe"
181
+
182
+ def argv_for(self, action, params, dry_run):
183
+ import json
184
+
185
+ return ["observe", action, json.dumps(params, sort_keys=True)]
186
+
187
+
188
+ def host_transport() -> Transport:
189
+ """Host boundary: argv-only subprocess runner. Executors build the
190
+ argv; this never sees a shell string (no shell=True)."""
191
+ import subprocess
192
+
193
+ def run(argv: list[str], cwd=None, timeout_s=None):
194
+ if not argv or not isinstance(argv, list):
195
+ return 2, "", "bad argv"
196
+ try:
197
+ p = subprocess.run(
198
+ [str(a) for a in argv],
199
+ cwd=cwd,
200
+ capture_output=True,
201
+ text=True,
202
+ timeout=timeout_s or 300,
203
+ check=False,
204
+ )
205
+ return p.returncode, p.stdout, p.stderr
206
+ except FileNotFoundError:
207
+ return 127, "", f"binary not found: {argv[0]}"
208
+ except subprocess.TimeoutExpired:
209
+ return 124, "", f"timeout {timeout_s}s"
210
+
211
+ return run
@@ -0,0 +1,77 @@
1
+ """Git executor (§72–74): branch, bounded patch, commit, push, PR.
2
+
3
+ `git.open_pr` does not shell out to GitHub in the core — it emits the
4
+ PR *spec* (title/body/head/base + plan-hash trailer). The transport may
5
+ be `gh pr create` host-side; the body carries reason, evidence, deltas,
6
+ risk, validation, rollback per §74. Force-push is never generated;
7
+ `--force-with-lease` only on pf/* branches and only when requested.
8
+ """
9
+
10
+ from __future__ import annotations
11
+
12
+ from typing import Any
13
+
14
+ from platformforge.ops.executors.base import Executor
15
+
16
+
17
+ class GitExecutor(Executor):
18
+ name = "git"
19
+
20
+ def argv_for(self, action: str, params: dict[str, Any],
21
+ dry_run: bool) -> list[str] | dict[str, Any]:
22
+ repo = params.get("repo", ".")
23
+ if action == "git.create_branch":
24
+ base = params.get("base", "HEAD")
25
+ return ["git", "-C", repo, "checkout", "-b", params["branch"], base]
26
+ if action == "git.apply_patch":
27
+ if params.get("check_only") or dry_run:
28
+ return ["git", "-C", repo, "apply", "--check", "--index",
29
+ "-"] # patch content via stdin host-side
30
+ return ["git", "-C", repo, "apply", "--index",
31
+ "--whitespace=error-all", "-"]
32
+ if action == "git.commit":
33
+ argv = ["git", "-C", repo, "commit", "-m", params["message"]]
34
+ if params.get("signoff"):
35
+ argv.append("--signoff")
36
+ return argv
37
+ if action == "git.push":
38
+ remote = params.get("remote", "origin")
39
+ return ["git", "-C", repo, "push", "-u", remote,
40
+ params["branch"]]
41
+ if action == "git.open_pr":
42
+ # PR is a host integration — emit spec; transport runs gh/api
43
+ return ["pr-spec", params["repo"], params["head"],
44
+ params["base"], params["title"]]
45
+ if action == "git.delete_branch":
46
+ return ["git", "-C", repo, "branch", "-D", params["branch"]]
47
+ if action == "git.revert_commit":
48
+ return ["git", "-C", repo, "revert", "--no-edit",
49
+ params["commit_sha"]]
50
+ if action == "git.close_pr":
51
+ return ["pr-close", params["repo"], str(params["pr"])]
52
+ return super().argv_for(action, params, dry_run)
53
+
54
+
55
+ def pr_body(*, reason: str, evidence: list[str], plan_hash: str,
56
+ expected_delta: dict[str, Any], risk: dict[str, Any],
57
+ validation: list[str], rollback: dict[str, Any]) -> str:
58
+ """§74 — generated PRs carry the full evidence chain."""
59
+ lines = [f"## Reason\n{reason}", "",
60
+ "## Evidence",
61
+ *[f"- {e}" for e in evidence], "",
62
+ f"Plan hash: `{plan_hash}`", "",
63
+ "## Expected delta",
64
+ "```json",
65
+ _j(expected_delta), "```", "",
66
+ "## Risk", "```json", _j(risk), "```", "",
67
+ "## Validation", *[f"- {v}" for v in validation], "",
68
+ "## Rollback", "```json", _j(rollback), "```", "",
69
+ "---",
70
+ "Generated by Platform Forge (governed operations).",
71
+ f"Plan-Hash: {plan_hash}"]
72
+ return "\n".join(lines)
73
+
74
+
75
+ def _j(obj: Any) -> str:
76
+ import json
77
+ return json.dumps(obj, indent=2, sort_keys=True)[:4000]
@@ -0,0 +1,134 @@
1
+ """GitOps executor (§79–81): ArgoCD sync/diff/wait/rollback.
2
+
3
+ GitOps-first: the default remediation path is a Git change the
4
+ controller reconciles. `argocd.sync` exists for governed cases only —
5
+ it requires application scope, pinned revision, diff evidence, health
6
+ precondition, policy allow and approval. `--prune`, `--replace`,
7
+ `--force` are never generated by the executor: they are distinct,
8
+ higher-risk capabilities requiring their own envelopes.
9
+ """
10
+
11
+ from __future__ import annotations
12
+
13
+ from typing import Any
14
+
15
+ from platformforge.ops.executors.base import Executor
16
+
17
+
18
+ class ArgoCDExecutor(Executor):
19
+ name = "argocd"
20
+
21
+ def argv_for(self, action: str, params: dict[str, Any],
22
+ dry_run: bool) -> list[str] | dict[str, Any]:
23
+ a = action.split(".", 1)[1]
24
+ app = params.get("app", "")
25
+ if a == "diff":
26
+ argv = ["argocd", "app", "diff", app]
27
+ if params.get("revision"):
28
+ argv += ["--revision", params["revision"]]
29
+ argv += ["--hard-refresh"]
30
+ return argv
31
+ if a == "sync":
32
+ argv = ["argocd", "app", "sync", app]
33
+ if params.get("revision"):
34
+ argv += ["--revision", params["revision"]]
35
+ for r in params.get("resource", []) or []:
36
+ argv += ["--resource", r]
37
+ if dry_run or params.get("dry_run"):
38
+ argv += ["--dry-run"]
39
+ # §81 guards — prune/replace/force are never emitted here
40
+ return argv
41
+ if a == "wait":
42
+ argv = ["argocd", "app", "wait", app, "--health", "--sync"]
43
+ argv += ["--timeout", str(params.get("timeout_s", 300))]
44
+ return argv
45
+ if a == "rollback":
46
+ argv = ["argocd", "app", "rollback", app]
47
+ if params.get("history_id"):
48
+ argv += [str(params["history_id"])]
49
+ return argv
50
+ return super().argv_for(action, params, dry_run)
51
+
52
+
53
+ class KubernetesExecutor(Executor):
54
+ """§82–83 — narrow actions only: scale, rollout restart/undo,
55
+ controlled annotate, rollout status. Every write binds
56
+ resourceVersion/uid preconditions when supplied; arbitrary object
57
+ patch does not exist."""
58
+
59
+ name = "kubernetes"
60
+
61
+ def argv_for(self, action: str, params: dict[str, Any],
62
+ dry_run: bool) -> list[str] | dict[str, Any]:
63
+ a = action.split(".", 1)[1]
64
+ kind, name = params.get("kind", ""), params.get("name", "")
65
+ target = f"{kind}/{name}"
66
+ ns = []
67
+ if params.get("namespace"):
68
+ ns = ["-n", params["namespace"]]
69
+ if params.get("context"):
70
+ ns += ["--context", params["context"]]
71
+ dr = ["--dry-run=server"] if dry_run else []
72
+
73
+ if a == "scale":
74
+ argv = ["kubectl", "scale", target,
75
+ "--replicas", str(params["replicas"])] + ns
76
+ if params.get("current_replicas") is not None:
77
+ argv += ["--current-replicas",
78
+ str(params["current_replicas"])]
79
+ if params.get("resource_version"):
80
+ argv += ["--resource-version",
81
+ str(params["resource_version"])]
82
+ return argv + dr
83
+ if a == "rollout_restart":
84
+ return ["kubectl", "rollout", "restart", target] + ns + dr
85
+ if a == "rollout_undo":
86
+ argv = ["kubectl", "rollout", "undo", target] + ns
87
+ if params.get("to_revision"):
88
+ argv += ["--to-revision", str(params["to_revision"])]
89
+ return argv + dr
90
+ if a == "rollout_status":
91
+ argv = ["kubectl", "rollout", "status", target] + ns
92
+ argv += ["--timeout", f"{params.get('timeout_s', 300)}s"]
93
+ argv += ["--watch=false"]
94
+ return argv
95
+ if a == "annotate":
96
+ anns = params.get("annotations", {})
97
+ rems = params.get("remove_annotations", []) or []
98
+ if not isinstance(anns, dict) or (not anns and not rems):
99
+ return {"refusal": "PF-OPS-ANNOTATE-EMPTY",
100
+ "unlock": "annotations or remove_annotations "
101
+ "must be non-empty"}
102
+ safe = {k: str(v) for k, v in anns.items()
103
+ if _annotation_allowed(k)}
104
+ safe_rems = [k for k in rems if _annotation_allowed(k)]
105
+ if len(safe) != len(anns) or len(safe_rems) != len(rems):
106
+ return {"refusal": "PF-OPS-ANNOTATE-UNSAFE",
107
+ "unlock": "only platformforge.io/*, "
108
+ "ops.platformforge.io/* annotations "
109
+ "or whitelisted keys are writable"}
110
+ argv = ["kubectl", "annotate", target] + ns
111
+ argv += [f"{k}={v}" for k, v in safe.items()]
112
+ argv += [f"{k}-" for k in safe_rems] + ["--overwrite"]
113
+ if params.get("resource_version"):
114
+ # optimistic concurrency via JSON patch precondition
115
+ argv = ["kubectl", "patch", target, "--type=json",
116
+ "-p", '[{"op":"test","path":"/metadata/'
117
+ 'resourceVersion","value":"'
118
+ + str(params["resource_version"]) + '"}]'] + ns
119
+ return argv + dr
120
+ return argv + dr
121
+ return super().argv_for(action, params, dry_run)
122
+
123
+
124
+ _ANNOTATION_PREFIXES = ("platformforge.io/", "ops.platformforge.io/",
125
+ "pf.io/")
126
+
127
+
128
+ def _annotation_allowed(key: str) -> bool:
129
+ return key.startswith(_ANNOTATION_PREFIXES)
130
+
131
+
132
+ EXECUTORS = {"git": "GitExecutor", "terraform": "TerraformExecutor",
133
+ "tofu": "TofuExecutor", "argocd": "ArgoCDExecutor",
134
+ "kubernetes": "KubernetesExecutor"}
@@ -0,0 +1,84 @@
1
+ """Terraform / OpenTofu executor (§75–78).
2
+
3
+ Contract from upstream semantics: `plan -out=<f>` → `apply <f>` where
4
+ the saved plan file IS the approval target (no replanning flags at
5
+ apply). Before apply the executor re-runs a freshness check
6
+ (`plan -refresh-only -detailed-exitcode`; 2 = drift) and verifies the
7
+ plan file hash — stale plans refuse (§77). `terraform` and `tofu` share
8
+ the contract; divergent flags stay per-binary.
9
+ """
10
+
11
+ from __future__ import annotations
12
+
13
+ import hashlib
14
+ from pathlib import Path
15
+ from typing import Any
16
+
17
+ from platformforge.ops.executors.base import Executor
18
+
19
+
20
+ class TerraformExecutor(Executor):
21
+ name = "terraform"
22
+ binary = "terraform"
23
+
24
+ def argv_for(self, action: str, params: dict[str, Any],
25
+ dry_run: bool) -> list[str] | dict[str, Any]:
26
+ b = self.binary
27
+ wd = params.get("workdir", ".")
28
+ a = action.split(".", 1)[1] # terraform.<verb>
29
+ if a == "validate":
30
+ return [b, "-chdir=" + wd, "validate", "-json"]
31
+ if a == "plan":
32
+ argv = [b, "-chdir=" + wd, "plan", "-input=false",
33
+ "-detailed-exitcode"]
34
+ if params.get("refresh_only"):
35
+ argv.append("-refresh-only")
36
+ if params.get("out"):
37
+ argv.append("-out=" + params["out"])
38
+ for t in params.get("target", []) or []:
39
+ argv.append("-target=" + t)
40
+ return argv
41
+ if a == "show":
42
+ return [b, "-chdir=" + wd, "show", "-json",
43
+ params["plan_file"]]
44
+ if a == "apply_saved_plan":
45
+ pf = params["plan_file"]
46
+ want = params.get("plan_hash", "")
47
+ if want:
48
+ try:
49
+ got = "sha256:" + hashlib.sha256(
50
+ Path(wd, pf).read_bytes()).hexdigest()
51
+ except OSError as e:
52
+ return {"refusal": "PF-OPS-PLAN-UNREADABLE",
53
+ "unlock": f"plan file unreadable: {e}"}
54
+ if got != want:
55
+ return {"refusal": "PF-OPS-PLAN-HASH-MISMATCH",
56
+ "unlock": "saved plan hash differs from "
57
+ "approval — re-plan and re-approve"}
58
+ return [b, "-chdir=" + wd, "apply", "-input=false",
59
+ pf] # the plan file IS the bound artifact
60
+ return super().argv_for(action, params, dry_run)
61
+
62
+
63
+ class TofuExecutor(TerraformExecutor):
64
+ name = "tofu"
65
+ binary = "tofu"
66
+
67
+
68
+ def summarize_plan(show_json: dict[str, Any]) -> dict[str, Any]:
69
+ """Compact plan summary for deltas/receipts (extends iac/plan.py
70
+ semantics with action_reason/applyable)."""
71
+ changes: dict[str, int] = {}
72
+ destructive = []
73
+ for rc in show_json.get("resource_changes", []) or []:
74
+ acts = tuple(rc.get("change", {}).get("actions", []))
75
+ for a in acts:
76
+ changes[a] = changes.get(a, 0) + 1
77
+ if "delete" in acts:
78
+ destructive.append(rc.get("address", "?"))
79
+ return {"applyable": bool(show_json.get("applyable")),
80
+ "errored": bool(show_json.get("errored")),
81
+ "actions": changes,
82
+ "destructive_addresses": destructive,
83
+ "drift": [d.get("address") for d in
84
+ show_json.get("resource_drift", []) or []]}