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,85 @@
1
+ """Envelope validation + serialization — schema contract boundary.
2
+
3
+ Every envelope crossing into the platform is validated against
4
+ contracts/observation.schema.json and redacted before persistence
5
+ (cycle §207). Redaction receipts are attached under `hashes.redaction`.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ import json
11
+ from pathlib import Path
12
+ from typing import Any
13
+
14
+ import jsonschema
15
+
16
+ from platformforge.core.redaction import redact_obj, redact_text_report
17
+ from platformforge.live.models import SCHEMA, CollectorReceipt, ObservationEnvelope
18
+
19
+ _CONTRACT_DIR = Path(__file__).resolve().parents[2] / "contracts"
20
+
21
+
22
+ def _schema(name: str) -> dict[str, Any]:
23
+ p = _CONTRACT_DIR / name
24
+ if not p.exists():
25
+ return {}
26
+ return json.loads(p.read_text())
27
+
28
+
29
+ def validate_envelope(doc: dict[str, Any]) -> list[str]:
30
+ """Schema + semantic validation. Returns error list (empty = ok)."""
31
+ errors: list[str] = []
32
+ schema = _schema("observation.schema.json")
33
+ if schema:
34
+ for e in jsonschema.Draft202012Validator(schema).iter_errors(doc):
35
+ errors.append(f"schema: {e.json_path or '/'} {e.message}")
36
+ if doc.get("schema") != SCHEMA:
37
+ errors.append(f"schema must be {SCHEMA}")
38
+ cov = (doc.get("coverage") or {}).get("status", "unknown")
39
+ from platformforge.live.models import COVERAGE_STATUSES
40
+ if cov not in COVERAGE_STATUSES:
41
+ errors.append(f"invalid coverage.status: {cov}")
42
+ for i, o in enumerate(doc.get("objects", [])):
43
+ if not isinstance(o, dict) or not o.get("resource_id"):
44
+ errors.append(f"objects[{i}] missing resource_id")
45
+ return errors
46
+
47
+
48
+ def redact_envelope(env: ObservationEnvelope) -> tuple[ObservationEnvelope, dict[str, int]]:
49
+ """§207 — boundary redaction before anything is persisted/emitted.
50
+
51
+ Returns (redacted_envelope, redaction_counts). Objects' attributes and
52
+ receipt text are deep-redacted; counts become the redaction receipt.
53
+ """
54
+ counts: dict[str, int] = {}
55
+ redacted_objects = []
56
+ for o in env.objects:
57
+ ro = dict(o)
58
+ txt = json.dumps(ro.get("attributes", {}), default=str)
59
+ _r, c = redact_text_report(txt)
60
+ for k, v in c.items():
61
+ counts[k] = counts.get(k, 0) + v
62
+ ro["attributes"] = redact_obj(ro.get("attributes", {}))
63
+ redacted_objects.append(ro)
64
+ env.objects = redacted_objects
65
+ if env.receipt:
66
+ env.receipt = redact_obj(env.receipt)
67
+ if env.errors:
68
+ env.errors = [redact_obj(e) for e in env.errors]
69
+ return env, counts
70
+
71
+
72
+ def envelope_hash(env: ObservationEnvelope) -> str:
73
+ return env.signature()
74
+
75
+
76
+ def loads(text: str) -> ObservationEnvelope:
77
+ return ObservationEnvelope.from_dict(json.loads(text))
78
+
79
+
80
+ def dumps(env: ObservationEnvelope) -> str:
81
+ return json.dumps(env.to_dict(), indent=2, sort_keys=True, default=str)
82
+
83
+
84
+ def receipt_dict(r: CollectorReceipt) -> dict[str, Any]:
85
+ return r.to_dict()
@@ -0,0 +1,113 @@
1
+ """Multi-cluster federation (cycle §126–§131).
2
+
3
+ - ClusterRegistry: declared fleet inventory under
4
+ `.platformforge/clusters/registry.json` — cluster_id, provider,
5
+ account, region, context, environment. Registry entries are declared
6
+ intent; coverage is earned by observations.
7
+ - federate(): merges per-cluster graphs into one federated graph.
8
+ Same node_id → merged (evidence unions); cluster origin is stamped
9
+ on every node/edge attr so provenance survives the merge.
10
+ - coverage report: which registered clusters actually contributed —
11
+ a registered cluster with no observation is a declared gap, not an
12
+ implicit failure.
13
+ """
14
+
15
+ from __future__ import annotations
16
+
17
+ import json
18
+ from dataclasses import asdict, dataclass, field
19
+ from pathlib import Path
20
+ from typing import Any
21
+
22
+ from platformforge.graph.model import Edge, Graph, Node
23
+ from platformforge.live.models import now_iso
24
+
25
+ REGISTRY = ".platformforge/clusters/registry.json"
26
+
27
+
28
+ @dataclass
29
+ class Cluster:
30
+ cluster_id: str
31
+ provider: str = "" # eks|gke|kind|…
32
+ account: str = ""
33
+ region: str = ""
34
+ context: str = "" # kube context
35
+ environment: str = ""
36
+ labels: dict[str, str] = field(default_factory=dict)
37
+ registered_at: str = ""
38
+
39
+ def to_dict(self) -> dict[str, Any]:
40
+ return {k: v for k, v in asdict(self).items() if v not in ("", {})}
41
+
42
+
43
+ class ClusterRegistry:
44
+ def __init__(self, root: str | Path):
45
+ self.path = Path(root) / REGISTRY
46
+
47
+ def _load(self) -> dict[str, Any]:
48
+ if not self.path.exists():
49
+ return {"clusters": {}}
50
+ return json.loads(self.path.read_text())
51
+
52
+ def _save(self, doc: dict[str, Any]) -> None:
53
+ self.path.parent.mkdir(parents=True, exist_ok=True)
54
+ self.path.write_text(json.dumps(doc, indent=2, sort_keys=True)
55
+ + "\n")
56
+
57
+ def register(self, cluster: Cluster) -> dict[str, Any]:
58
+ doc = self._load()
59
+ c = cluster.to_dict()
60
+ c.setdefault("registered_at", now_iso())
61
+ doc["clusters"][cluster.cluster_id] = c
62
+ self._save(doc)
63
+ return c
64
+
65
+ def get(self, cluster_id: str) -> dict[str, Any] | None:
66
+ return self._load()["clusters"].get(cluster_id)
67
+
68
+ def list(self) -> list[dict[str, Any]]:
69
+ return [self._load()["clusters"][k]
70
+ for k in sorted(self._load()["clusters"])]
71
+
72
+ def unregister(self, cluster_id: str) -> bool:
73
+ doc = self._load()
74
+ if doc["clusters"].pop(cluster_id, None) is not None:
75
+ self._save(doc)
76
+ return True
77
+ return False
78
+
79
+
80
+ def federate(graphs: dict[str, Graph]) -> Graph:
81
+ """Merge {cluster_id: Graph} → federated graph. Deterministic:
82
+ sorted iteration, evidence unions, cluster stamped on attrs."""
83
+ out = Graph()
84
+ for cluster_id in sorted(graphs):
85
+ g = graphs[cluster_id]
86
+ for nid in sorted(g.nodes):
87
+ n = g.nodes[nid]
88
+ attrs = dict(n.attrs)
89
+ attrs["cluster"] = attrs.get("cluster") or cluster_id
90
+ out.add_node(Node(nid, n.kind, n.label, attrs,
91
+ n.source_fact_ids))
92
+ for eid in sorted(g.edges):
93
+ e = g.edges[eid]
94
+ attrs = dict(e.attrs)
95
+ attrs["cluster"] = attrs.get("cluster") or cluster_id
96
+ out.add_edge(Edge(e.src, e.dst, e.kind, e.provenance,
97
+ e.confidence, e.source_fact_ids, attrs,
98
+ e.evidence, dict(e.temporal)))
99
+ return out
100
+
101
+
102
+ def federation_coverage(registry: ClusterRegistry,
103
+ contributing: list[str]) -> dict[str, Any]:
104
+ """Registered vs contributing clusters — explicit partial coverage."""
105
+ reg = {c["cluster_id"] for c in registry.list()}
106
+ seen = set(contributing)
107
+ missing = sorted(reg - seen)
108
+ unknown = sorted(seen - reg)
109
+ status = ("complete" if not missing else
110
+ "partial" if seen else "unknown")
111
+ return {"status": status, "registered": sorted(reg),
112
+ "contributing": sorted(seen), "missing": missing,
113
+ "unregistered": unknown}
@@ -0,0 +1,168 @@
1
+ """Fixture transports — deterministic offline replay for collectors
2
+ (cycle §258 "collector fixtures").
3
+
4
+ A fixture dir mirrors the transport contract so collectors run their
5
+ real code path end-to-end with zero network:
6
+
7
+ fixture/kubectl/
8
+ get_deployments.json # `kubectl get deployments …`
9
+ get_deployments.cont.json # continuation page (--continue)
10
+ get_secrets.denied.txt # rc=1 Forbidden stderr
11
+ auth_can-i_get.txt # "yes"/"no"
12
+ config_current-context.txt # "kind-lab"
13
+ fixture/aws/
14
+ sts_get-caller-identity.json
15
+ ec2_describe-vpcs.json # any region
16
+ ec2_describe-vpcs__us-east-1.json # region-scoped wins
17
+ iam_list-users.denied.txt # rc=1 AccessDenied
18
+
19
+ Missing fixture → rc=2 "no fixture" (never silently empty).
20
+ """
21
+
22
+ from __future__ import annotations
23
+
24
+ import json
25
+ from pathlib import Path
26
+ from typing import Any
27
+
28
+
29
+ def k8s_fixture_transport(fixture_dir: str | Path):
30
+ """Replay kubectl responses from fixture_dir/kubectl/."""
31
+ root = Path(fixture_dir) / "kubectl"
32
+ calls: list[str] = []
33
+ pages: dict[str, int] = {}
34
+
35
+ _VALUE_FLAGS = {"-o", "--output", "-n", "--namespace",
36
+ "--context", "--chunk-size", "-l", "--selector",
37
+ "--continue", "--sort-by", "--field-selector"}
38
+
39
+ def _slug(args: list[str]) -> str:
40
+ words: list[str] = []
41
+ skip_next = False
42
+ for a in args:
43
+ if skip_next:
44
+ skip_next = False
45
+ continue
46
+ if a in _VALUE_FLAGS:
47
+ skip_next = True
48
+ continue
49
+ if a.startswith("-"):
50
+ continue
51
+ words.append(a)
52
+ if "auth" in words and "can-i" in words:
53
+ verb = words[words.index("can-i") + 1] \
54
+ if len(words) > words.index("can-i") + 1 else ""
55
+ return f"auth_can-i_{verb}"
56
+ if "config" in words:
57
+ sub = words[words.index("config") + 1] \
58
+ if len(words) > words.index("config") + 1 else ""
59
+ return f"config_{sub}"
60
+ if words and words[0] == "version":
61
+ return "version"
62
+ if words and words[0] == "get" and len(words) > 1:
63
+ return f"get_{words[1]}"
64
+ return "_".join(words) or "empty"
65
+
66
+ def transport(args: list[str]) -> tuple[int, str, str]:
67
+ slug = _slug(args)
68
+ calls.append(slug)
69
+ n = pages.get(slug, 0)
70
+ pages[slug] = n + 1
71
+ base = root / f"{slug}.cont{n}.json" if n else root / slug
72
+ denied = root / f"{slug}.denied.txt"
73
+ if denied.exists():
74
+ return 1, "", denied.read_text().strip()
75
+ cand = [base.with_suffix(".json")] if base.suffix != ".json" \
76
+ else [base]
77
+ cand += [root / f"{slug}.cont{n}.json",
78
+ root / f"{slug}.json",
79
+ root / f"{slug}.txt"]
80
+ for f in cand:
81
+ if f.exists():
82
+ return 0, f.read_text(), ""
83
+ return 2, "", f"no fixture for kubectl {slug}"
84
+
85
+ transport.calls = calls # type: ignore[attr-defined]
86
+ return transport
87
+
88
+
89
+ def aws_fixture_transport(fixture_dir: str | Path):
90
+ """Replay aws CLI responses from fixture_dir/aws/."""
91
+ root = Path(fixture_dir) / "aws"
92
+ calls: list[str] = []
93
+
94
+ def transport(service: str, operation: str,
95
+ params: dict | None = None) -> tuple[int, Any]:
96
+ region = (params or {}).get("region", "")
97
+ calls.append(f"{service}.{operation}@{region}")
98
+ for slug in ([f"{service}_{operation}__{region}"] if region
99
+ else []) + [f"{service}_{operation}"]:
100
+ denied = root / f"{slug}.denied.txt"
101
+ if denied.exists():
102
+ return 1, denied.read_text().strip()
103
+ f = root / f"{slug}.json"
104
+ if f.exists():
105
+ return 0, json.loads(f.read_text())
106
+ return 2, {"error": f"no fixture for {service} {operation}"}
107
+
108
+ transport.calls = calls # type: ignore[attr-defined]
109
+ return transport
110
+
111
+
112
+ def collect_fixture(provider: str, fixture_dir: str | Path,
113
+ **collector_kw) -> Any:
114
+ """Run the real collector over a fixture dir → ObservationEnvelope."""
115
+ from platformforge.live.models import ObservationScope
116
+ scope = collector_kw.pop("scope", None) or ObservationScope(
117
+ provider=provider)
118
+ if provider == "kubernetes":
119
+ from platformforge.live.collectors.k8s import K8sCollector
120
+ return K8sCollector(
121
+ transport=k8s_fixture_transport(fixture_dir),
122
+ **collector_kw).collect(scope)
123
+ if provider == "aws":
124
+ from platformforge.live.collectors.aws import AwsCollector
125
+ c = AwsCollector(transport=aws_fixture_transport(fixture_dir),
126
+ **collector_kw)
127
+ c.preflight()
128
+ return c.collect(scope)
129
+ raise ValueError(f"unknown fixture provider {provider}")
130
+
131
+
132
+ def fixture_facts(provider: str, fixture_dir: str | Path) -> dict[str, Any]:
133
+ """Lab-analyzer shape: run the collector over fixtures → facts.
134
+
135
+ Emits one `live.observation` fact per envelope plus one
136
+ `live.object` fact per observed resource — rule-evaluable and
137
+ honest about coverage (envelope attrs carry the coverage dict)."""
138
+ from platformforge.models.base import stable_id
139
+ env = collect_fixture(provider, fixture_dir)
140
+ facts = [{
141
+ "fact_id": stable_id("PF-LIVE", env.observation_id),
142
+ "kind": "live.observation", "source": f"fixture:{provider}",
143
+ "location": str(fixture_dir), "tier": 0,
144
+ "attrs": {"observation_id": env.observation_id,
145
+ "provider": env.provider,
146
+ "coverage": env.coverage,
147
+ "objects": len(env.objects),
148
+ "errors": env.errors}}]
149
+ for o in env.objects:
150
+ facts.append({
151
+ "fact_id": stable_id("PF-LIVE", env.observation_id,
152
+ o.get("resource_id", "?")),
153
+ "kind": "live.object", "source": f"fixture:{provider}",
154
+ "location": o.get("resource_id", ""),
155
+ "tier": 0,
156
+ "attrs": {k: o.get(k) for k in
157
+ ("resource_id", "resource_type", "lifecycle",
158
+ "namespace", "cluster", "account", "region")
159
+ if o.get(k)}})
160
+ return {"facts": facts, "envelope": env.to_dict()}
161
+
162
+
163
+ def collect_fixture_k8s(fixture_dir: str | Path) -> dict[str, Any]:
164
+ return fixture_facts("kubernetes", fixture_dir)
165
+
166
+
167
+ def collect_fixture_aws(fixture_dir: str | Path) -> dict[str, Any]:
168
+ return fixture_facts("aws", fixture_dir)
@@ -0,0 +1,258 @@
1
+ """Identity resolution (cycle §42–§49).
2
+
3
+ A ResourceIdentity is a UNION over strong identifiers — ARN, k8s UID,
4
+ immutable provider id. Weak names (name+kind+namespace) never merge
5
+ identities on their own; they produce `weak_candidates` for review.
6
+
7
+ Every link carries {confidence, provenance, fact_ids, reason}.
8
+ Contradictions are surfaced as IdentityConflict — never silently
9
+ resolved (e.g. SA annotation → role A while EKS Pod Identity → role B).
10
+ """
11
+
12
+ from __future__ import annotations
13
+
14
+ from dataclasses import dataclass, field
15
+ from typing import Any
16
+
17
+ STRONG_ID_KINDS = ("arn", "uid", "canonical_id", "provider_id",
18
+ "tf_address", "config_id")
19
+ LINK_CONFIDENCE = {"exact-arn": 1.0, "exact-uid": 1.0,
20
+ "tf-address": 0.95, "pod-identity": 0.95,
21
+ "irsa-annotation": 0.9, "config-record": 0.9,
22
+ "name-only": 0.4}
23
+
24
+ IRSA_ANNOTATION = "eks.amazonaws.com/role-arn"
25
+
26
+
27
+ @dataclass
28
+ class IdentityLink:
29
+ a: str
30
+ b: str
31
+ reason: str # e.g. exact-arn, pod-identity
32
+ confidence: float
33
+ provenance: str = "observed"
34
+ fact_ids: list[str] = field(default_factory=list)
35
+
36
+ def to_dict(self) -> dict[str, Any]:
37
+ return {"a": self.a, "b": self.b, "reason": self.reason,
38
+ "confidence": self.confidence,
39
+ "provenance": self.provenance,
40
+ "fact_ids": sorted(self.fact_ids)}
41
+
42
+
43
+ @dataclass
44
+ class IdentityConflict:
45
+ kind: str # e.g. sa-role-conflict
46
+ resource: str
47
+ claim_a: dict[str, Any]
48
+ claim_b: dict[str, Any]
49
+ detail: str = ""
50
+
51
+ def to_dict(self) -> dict[str, Any]:
52
+ return {"kind": self.kind, "resource": self.resource,
53
+ "claim_a": self.claim_a, "claim_b": self.claim_b,
54
+ "detail": self.detail}
55
+
56
+
57
+ @dataclass
58
+ class ResourceIdentity:
59
+ canonical_id: str
60
+ provider_ids: dict[str, str] = field(default_factory=dict)
61
+ graph_nodes: list[str] = field(default_factory=list)
62
+ aliases: list[str] = field(default_factory=list)
63
+ evidence: list[dict[str, Any]] = field(default_factory=list)
64
+
65
+ def to_dict(self) -> dict[str, Any]:
66
+ return {"canonical_id": self.canonical_id,
67
+ "provider_ids": dict(sorted(self.provider_ids.items())),
68
+ "graph_nodes": sorted(self.graph_nodes),
69
+ "aliases": sorted(self.aliases),
70
+ "evidence": self.evidence}
71
+
72
+
73
+ class _UnionFind:
74
+ def __init__(self):
75
+ self.p: dict[str, str] = {}
76
+
77
+ def find(self, x: str) -> str:
78
+ self.p.setdefault(x, x)
79
+ while self.p[x] != x:
80
+ self.p[x] = self.p[self.p[x]]
81
+ x = self.p[x]
82
+ return x
83
+
84
+ def union(self, a: str, b: str) -> None:
85
+ ra, rb = self.find(a), self.find(b)
86
+ if ra != rb:
87
+ self.p[rb] = ra
88
+
89
+
90
+ def strong_ids_of(obj: dict[str, Any]) -> dict[str, str]:
91
+ """Extract strong identifiers from an observed object or fact."""
92
+ ids: dict[str, str] = {}
93
+ attrs = obj.get("attributes") or obj.get("attrs") or {}
94
+ if attrs.get("arn"):
95
+ ids["arn"] = attrs["arn"]
96
+ rid = obj.get("resource_id", "")
97
+ if rid.startswith("arn:"):
98
+ ids["arn"] = rid
99
+ if obj.get("uid"):
100
+ ids["uid"] = obj["uid"]
101
+ if rid.startswith(("k8s://", "aws://")) and "#" in rid:
102
+ ids["uid"] = rid.rsplit("#", 1)[-1]
103
+ if rid:
104
+ ids["canonical_id"] = rid
105
+ if attrs.get("terraform_address") or obj.get("terraform_address"):
106
+ ids["tf_address"] = attrs.get("terraform_address") or \
107
+ obj.get("terraform_address")
108
+ return ids
109
+
110
+
111
+ def sa_role_claims(objects: list[dict[str, Any]]) -> list[IdentityConflict]:
112
+ """§47 — ServiceAccount role resolution conflict detector.
113
+
114
+ IRSA annotation (k8s object) vs EKS Pod Identity association (aws
115
+ object): different role → explicit conflict.
116
+ """
117
+ sa_annotated: dict[tuple[str, str], dict[str, Any]] = {}
118
+ pod_id: dict[tuple[str, str], dict[str, Any]] = {}
119
+ for o in objects:
120
+ a = o.get("attributes", {})
121
+ rt = o.get("resource_type", "")
122
+ if rt == "k8s:ServiceAccount":
123
+ role = (a.get("annotations") or {}).get(IRSA_ANNOTATION)
124
+ if role:
125
+ sa_annotated[(o.get("cluster", ""), o.get("namespace", ""),
126
+ o.get("name", ""))] = \
127
+ {"role_arn": role, "source": "irsa-annotation",
128
+ "object": o.get("resource_id", "")}
129
+ elif rt == "aws:eks/pod_identity_association":
130
+ pod_id[(o.get("cluster", ""), a.get("namespace", ""),
131
+ a.get("service_account", ""))] = \
132
+ {"role_arn": a.get("role_arn", ""),
133
+ "source": "pod-identity",
134
+ "object": o.get("resource_id", "")}
135
+ conflicts = []
136
+ for key, sa in sorted(sa_annotated.items()):
137
+ pi = pod_id.get(key)
138
+ if pi and pi["role_arn"] != sa["role_arn"]:
139
+ conflicts.append(IdentityConflict(
140
+ kind="sa-role-conflict", resource=key[2],
141
+ claim_a=sa, claim_b=pi,
142
+ detail=f"namespace={key[1]} cluster={key[0]}: IRSA "
143
+ f"annotation={sa['role_arn']} vs "
144
+ f"PodIdentity={pi['role_arn']}"))
145
+ return conflicts
146
+
147
+
148
+ class IdentityResolver:
149
+ """Ingests objects/facts, unions strong ids, emits identities +
150
+ links + conflicts + unresolved weak candidates."""
151
+
152
+ def __init__(self):
153
+ self._uf = _UnionFind()
154
+ self._records: dict[str, dict[str, Any]] = {}
155
+ self._links: list[IdentityLink] = []
156
+ self._weak: dict[str, dict[str, Any]] = {}
157
+ self._conflicts: list[IdentityConflict] = []
158
+ self._objects: list[dict[str, Any]] = []
159
+
160
+ def ingest_object(self, obj: dict[str, Any]) -> None:
161
+ self._objects.append(obj)
162
+ ids = strong_ids_of(obj)
163
+ rid = obj.get("resource_id", "")
164
+ anchors = [f"{k}:{v}" for k, v in ids.items() if v]
165
+ if not anchors:
166
+ # weak-only shape: record for review, never auto-merge
167
+ key = (f"weak:{obj.get('resource_type')}:"
168
+ f"{obj.get('namespace')}:{obj.get('name')}")
169
+ self._weak.setdefault(key, obj)
170
+ return
171
+ if not rid:
172
+ return
173
+ self._records[rid] = obj
174
+ for anchor in anchors[1:]:
175
+ self._uf.union(anchors[0], anchor)
176
+ self._uf.union(f"rid:{rid}", anchors[0])
177
+ for kind, val in ids.items():
178
+ self._records.setdefault(f"{kind}:{val}", {})
179
+
180
+ def ingest_fact(self, fact: dict[str, Any]) -> None:
181
+ attrs = fact.get("attrs", {}) or {}
182
+ pseudo = {"resource_id": attrs.get("arn") or fact.get("location", ""),
183
+ "resource_type": fact.get("kind", ""),
184
+ "attributes": attrs}
185
+ ids = strong_ids_of(pseudo)
186
+ if ids:
187
+ self.ingest_object({**pseudo, "resource_id":
188
+ pseudo["resource_id"] or
189
+ f"fact:{fact.get('fact_id','?')}",
190
+ "_fact": fact.get("fact_id", "")})
191
+
192
+ def ingest_terraform(self, tf_address: str, arn_or_id: str,
193
+ fact_id: str = "") -> None:
194
+ """§45 — terraform address ↔ provider id link (T3 declared ↔
195
+ T1 observed)."""
196
+ if not arn_or_id:
197
+ return
198
+ self._uf.union(f"tf_address:{tf_address}",
199
+ (f"arn:{arn_or_id}" if arn_or_id.startswith("arn:")
200
+ else f"canonical_id:{arn_or_id}"))
201
+ self._links.append(IdentityLink(
202
+ a=tf_address, b=arn_or_id, reason="tf-address",
203
+ confidence=LINK_CONFIDENCE["tf-address"],
204
+ provenance="declared",
205
+ fact_ids=[fact_id] if fact_id else []))
206
+
207
+ def ingest_pod_identity(self, *, cluster: str, namespace: str,
208
+ service_account: str, role_arn: str,
209
+ sa_uid: str = "",
210
+ fact_id: str = "") -> None:
211
+ """§46 — EKS Pod Identity / IRSA: SA ↔ IAM role link."""
212
+ sa_key = f"k8s-sa:{cluster}/{namespace}/{service_account}"
213
+ self._uf.union(sa_key, f"arn:{role_arn}")
214
+ self._links.append(IdentityLink(
215
+ a=f"{namespace}/{service_account}", b=role_arn,
216
+ reason="pod-identity",
217
+ confidence=LINK_CONFIDENCE["pod-identity"],
218
+ fact_ids=[fact_id] if fact_id else []))
219
+ if sa_uid:
220
+ self._uf.union(sa_key, f"uid:{sa_uid}")
221
+
222
+ def resolve(self) -> dict[str, Any]:
223
+ self._conflicts = sa_role_claims(self._objects)
224
+ groups: dict[str, dict[str, Any]] = {}
225
+ for key in self._uf.p:
226
+ root = self._uf.find(key)
227
+ g = groups.setdefault(root, {"ids": {}, "rids": set(),
228
+ "facts": set()})
229
+ kind, _, val = key.partition(":")
230
+ if kind == "rid":
231
+ g["rids"].add(val)
232
+ elif kind == "k8s-sa":
233
+ g["ids"]["service_account"] = val
234
+ else:
235
+ g["ids"][kind] = val
236
+ identities: list[ResourceIdentity] = []
237
+ for g in groups.values():
238
+ ids = g["ids"]
239
+ canonical = (ids.get("arn") or ids.get("uid")
240
+ or (min(g["rids"]) if g["rids"]
241
+ else next(iter(ids.values()), "")))
242
+ ident = ResourceIdentity(
243
+ canonical_id=canonical,
244
+ provider_ids={k: v for k, v in ids.items()
245
+ if k in STRONG_ID_KINDS or k == "service_account"},
246
+ graph_nodes=sorted(g["rids"]),
247
+ aliases=sorted(set(ids.values()) - {canonical}))
248
+ identities.append(ident)
249
+ return {
250
+ "identities": [i.to_dict() for i in sorted(
251
+ identities, key=lambda i: i.canonical_id)],
252
+ "links": [l.to_dict() for l in self._links],
253
+ "conflicts": [c.to_dict() for c in self._conflicts],
254
+ "weak_candidates": sorted(self._weak),
255
+ "counts": {"identities": len(identities),
256
+ "links": len(self._links),
257
+ "conflicts": len(self._conflicts),
258
+ "weak": len(self._weak)}}