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.
- platformforge/__init__.py +7 -0
- platformforge/__main__.py +5 -0
- platformforge/_forge_portal.py +913 -0
- platformforge/_graphstudio.py +376 -0
- platformforge/_graphview.py +181 -0
- platformforge/_installkit.py +1706 -0
- platformforge/agents/__init__.py +156 -0
- platformforge/agents/bench.py +61 -0
- platformforge/agents/contextpack.py +137 -0
- platformforge/agents/contracts.py +394 -0
- platformforge/agents/coordinators.py +98 -0
- platformforge/agents/critic.py +113 -0
- platformforge/agents/debate.py +161 -0
- platformforge/agents/executors.py +160 -0
- platformforge/agents/guardian.py +48 -0
- platformforge/agents/mirrors.py +240 -0
- platformforge/agents/orchestrator.py +295 -0
- platformforge/agents/planner.py +116 -0
- platformforge/agents/playbook.py +51 -0
- platformforge/agents/referee.py +132 -0
- platformforge/agents/reviewers.py +113 -0
- platformforge/agents/roster.py +893 -0
- platformforge/agents/runledger.py +85 -0
- platformforge/agents/runstore.py +74 -0
- platformforge/agents/specialists.py +73 -0
- platformforge/agents/taskspec.py +94 -0
- platformforge/agents/uniqueness.py +115 -0
- platformforge/agents/verifier.py +106 -0
- platformforge/aiplat/__init__.py +4 -0
- platformforge/aiplat/models.py +175 -0
- platformforge/analytics/__init__.py +6 -0
- platformforge/analytics/capacity.py +109 -0
- platformforge/analytics/debt.py +92 -0
- platformforge/analytics/dx.py +69 -0
- platformforge/analytics/finops_v4.py +171 -0
- platformforge/analytics/goldenpath.py +131 -0
- platformforge/analytics/history.py +233 -0
- platformforge/analytics/measurement.py +149 -0
- platformforge/analytics/models.py +127 -0
- platformforge/analytics/opsanalytics.py +119 -0
- platformforge/analytics/policyintel.py +139 -0
- platformforge/analytics/reliability.py +106 -0
- platformforge/analytics/soak.py +135 -0
- platformforge/analytics/store.py +254 -0
- platformforge/bench.py +174 -0
- platformforge/cases/__init__.py +13 -0
- platformforge/cases/casefile.py +106 -0
- platformforge/cases/context_audit.py +134 -0
- platformforge/cases/ledgers.py +174 -0
- platformforge/cases/replay.py +142 -0
- platformforge/cases/routing_audit.py +162 -0
- platformforge/caveman/__init__.py +11 -0
- platformforge/caveman/compress.py +156 -0
- platformforge/cicd/__init__.py +16 -0
- platformforge/cicd/backstage.py +51 -0
- platformforge/cicd/dockerfile.py +64 -0
- platformforge/cicd/github_actions.py +122 -0
- platformforge/cicd/gitlab_ci.py +56 -0
- platformforge/cicd/gitops.py +130 -0
- platformforge/cli/__init__.py +0 -0
- platformforge/cli/fleetcmd.py +457 -0
- platformforge/cli/main.py +3832 -0
- platformforge/cloud/__init__.py +8 -0
- platformforge/cloud/aws.py +254 -0
- platformforge/cloud/common.py +69 -0
- platformforge/cloud/multicloud.py +143 -0
- platformforge/collect/__init__.py +11 -0
- platformforge/collect/detect.py +254 -0
- platformforge/context/__init__.py +10 -0
- platformforge/context/capsule.py +60 -0
- platformforge/context/gateway.py +227 -0
- platformforge/context/refs.py +49 -0
- platformforge/context/sufficiency.py +50 -0
- platformforge/core/__init__.py +1 -0
- platformforge/core/hashing.py +39 -0
- platformforge/core/ownership.py +220 -0
- platformforge/core/receipts.py +74 -0
- platformforge/core/redaction.py +97 -0
- platformforge/core/store.py +119 -0
- platformforge/core/workspace.py +89 -0
- platformforge/data/contracts/agent-handoff.schema.json +26 -0
- platformforge/data/contracts/agent-run.schema.json +27 -0
- platformforge/data/contracts/agent-spec.schema.json +43 -0
- platformforge/data/contracts/capability.schema.json +23 -0
- platformforge/data/contracts/change-event.schema.json +22 -0
- platformforge/data/contracts/change-intent.schema.json +62 -0
- platformforge/data/contracts/change-plan.schema.json +43 -0
- platformforge/data/contracts/collector-receipt.schema.json +36 -0
- platformforge/data/contracts/context-pack.schema.json +29 -0
- platformforge/data/contracts/debate.schema.json +31 -0
- platformforge/data/contracts/distribution-manifest-v1.schema.json +81 -0
- platformforge/data/contracts/drift-event.schema.json +21 -0
- platformforge/data/contracts/fact.schema.json +35 -0
- platformforge/data/contracts/finding.schema.json +20 -0
- platformforge/data/contracts/graph-v2.schema.json +67 -0
- platformforge/data/contracts/graph.schema.json +40 -0
- platformforge/data/contracts/install-receipt-v1.schema.json +49 -0
- platformforge/data/contracts/observation.schema.json +93 -0
- platformforge/data/contracts/receipt.schema.json +21 -0
- platformforge/data/contracts/recommendation.schema.json +32 -0
- platformforge/data/contracts/refusal.schema.json +16 -0
- platformforge/data/contracts/slo-contract.schema.json +25 -0
- platformforge/data/contracts/task-spec.schema.json +37 -0
- platformforge/data/contracts/workspace-manifest-v1.schema.json +62 -0
- platformforge/data/evals/cases/agent-budget-exhaustion/case.yaml +6 -0
- platformforge/data/evals/cases/agent-conflicting-specialists/case.yaml +11 -0
- platformforge/data/evals/cases/agent-fleet-optimization/case.yaml +13 -0
- platformforge/data/evals/cases/agent-host-no-subagents/case.yaml +6 -0
- platformforge/data/evals/cases/agent-incident-multi/case.yaml +13 -0
- platformforge/data/evals/cases/agent-missing-evidence/case.yaml +6 -0
- platformforge/data/evals/cases/agent-multi-domain-audit/case.yaml +14 -0
- platformforge/data/evals/cases/agent-production-change/case.yaml +15 -0
- platformforge/data/evals/cases/agent-security-mandatory/case.yaml +12 -0
- platformforge/data/evals/cases/agent-simple-iac/case.yaml +14 -0
- platformforge/data/evals/cases/approval-integrity-seal/case.yaml +6 -0
- platformforge/data/evals/cases/capacity-hot/case.yaml +7 -0
- platformforge/data/evals/cases/capacity-hot/fixture/capacity.json +5 -0
- platformforge/data/evals/cases/catalog-noowner/case.yaml +7 -0
- platformforge/data/evals/cases/catalog-noowner/fixture/catalog-info.yaml +6 -0
- platformforge/data/evals/cases/contract-fact/case.yaml +5 -0
- platformforge/data/evals/cases/contract-fact/fixture/doc.json +2 -0
- platformforge/data/evals/cases/cosign-unverified/case.yaml +8 -0
- platformforge/data/evals/cases/cosign-unverified/fixture/sig.json +33 -0
- platformforge/data/evals/cases/expected-delta-refusal/case.yaml +6 -0
- platformforge/data/evals/cases/finops-noattr/case.yaml +9 -0
- platformforge/data/evals/cases/finops-noattr/fixture/costs.json +7 -0
- platformforge/data/evals/cases/fleet-inv-absent-allocation-unknown/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-centrality-not-criticality/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-correlation-not-causality/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-dx-no-person-metrics/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-federation-restricted-denied/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-federation-secret-denied/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-history-window-deterministic/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-low-util-not-deletable/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-member-key-deterministic/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-missing-denominator/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-partial-coverage-visible/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-plan-changeintent-only/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-report-all-cited/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-small-sample-confidence/case.yaml +7 -0
- platformforge/data/evals/cases/fleet-inv-uncertain-optimization-suppressed/case.yaml +7 -0
- platformforge/data/evals/cases/gha-dangerous/case.yaml +12 -0
- platformforge/data/evals/cases/gha-dangerous/fixture/.github/workflows/ci.yaml +11 -0
- platformforge/data/evals/cases/gitops-v2/case.yaml +11 -0
- platformforge/data/evals/cases/gitops-v2/fixture/argo.yaml +41 -0
- platformforge/data/evals/cases/graph-k8s-blast/case.yaml +7 -0
- platformforge/data/evals/cases/graph-k8s-blast/fixture/deploy.yaml +15 -0
- platformforge/data/evals/cases/iac-module-nopin/case.yaml +8 -0
- platformforge/data/evals/cases/iac-module-nopin/fixture/main.tf +3 -0
- platformforge/data/evals/cases/iac-plan-replace/case.yaml +8 -0
- platformforge/data/evals/cases/iac-plan-replace/fixture/plan.json +12 -0
- platformforge/data/evals/cases/iac-sg-open/case.yaml +8 -0
- platformforge/data/evals/cases/iac-sg-open/fixture/main.tf +9 -0
- platformforge/data/evals/cases/iam-oidc/case.yaml +8 -0
- platformforge/data/evals/cases/iam-oidc/fixture/policy.json +11 -0
- platformforge/data/evals/cases/iam-wildcard-positive/case.yaml +8 -0
- platformforge/data/evals/cases/iam-wildcard-positive/fixture/policy.json +3 -0
- platformforge/data/evals/cases/k8s-bad-actor/case.yaml +19 -0
- platformforge/data/evals/cases/k8s-bad-actor/fixture/app.yaml +97 -0
- platformforge/data/evals/cases/k8s-beta-api/case.yaml +8 -0
- platformforge/data/evals/cases/k8s-beta-api/fixture/cr.yaml +7 -0
- platformforge/data/evals/cases/k8s-dep-api-boundary/case.yaml +15 -0
- platformforge/data/evals/cases/k8s-dep-api-boundary/fixture/app.yaml +25 -0
- platformforge/data/evals/cases/k8s-dep-api-clean/case.yaml +12 -0
- platformforge/data/evals/cases/k8s-dep-api-clean/fixture/app.yaml +29 -0
- platformforge/data/evals/cases/k8s-dep-api-unknown/case.yaml +11 -0
- platformforge/data/evals/cases/k8s-dep-api-unknown/fixture/app.yaml +25 -0
- platformforge/data/evals/cases/k8s-dep-api-v120/case.yaml +12 -0
- platformforge/data/evals/cases/k8s-dep-api-v120/fixture/app.yaml +25 -0
- platformforge/data/evals/cases/k8s-dep-api-v129/case.yaml +9 -0
- platformforge/data/evals/cases/k8s-dep-api-v129/fixture/app.yaml +25 -0
- platformforge/data/evals/cases/k8s-hpa-noreq/case.yaml +8 -0
- platformforge/data/evals/cases/k8s-hpa-noreq/fixture/app.yaml +28 -0
- platformforge/data/evals/cases/k8s-limits-boundary/case.yaml +10 -0
- platformforge/data/evals/cases/k8s-limits-boundary/fixture/app.yaml +15 -0
- platformforge/data/evals/cases/k8s-limits-negative/case.yaml +8 -0
- platformforge/data/evals/cases/k8s-limits-negative/fixture/deploy.yaml +15 -0
- platformforge/data/evals/cases/k8s-limits-positive/case.yaml +8 -0
- platformforge/data/evals/cases/k8s-limits-positive/fixture/deploy.yaml +14 -0
- platformforge/data/evals/cases/k8s-nopdb/case.yaml +7 -0
- platformforge/data/evals/cases/k8s-nopdb/fixture/app.yaml +34 -0
- platformforge/data/evals/cases/knowledge-registry/case.yaml +10 -0
- platformforge/data/evals/cases/kyverno-dep/case.yaml +10 -0
- platformforge/data/evals/cases/kyverno-dep/fixture/pol.yaml +18 -0
- platformforge/data/evals/cases/kyverno-legacy/case.yaml +8 -0
- platformforge/data/evals/cases/kyverno-legacy/fixture/pol.yaml +7 -0
- platformforge/data/evals/cases/live-aws-collect/case.yaml +11 -0
- platformforge/data/evals/cases/live-aws-collect/fixture/aws/ec2_describe-vpcs.json +15 -0
- platformforge/data/evals/cases/live-aws-collect/fixture/aws/iam_list-users.denied.txt +1 -0
- platformforge/data/evals/cases/live-aws-collect/fixture/aws/sts_get-caller-identity.json +5 -0
- platformforge/data/evals/cases/live-drift/case.yaml +8 -0
- platformforge/data/evals/cases/live-drift/fixture/after.json +22 -0
- platformforge/data/evals/cases/live-drift/fixture/before.json +22 -0
- platformforge/data/evals/cases/live-incident/case.yaml +7 -0
- platformforge/data/evals/cases/live-incident/fixture/changes.json +8 -0
- platformforge/data/evals/cases/live-incident/fixture/incident.json +7 -0
- platformforge/data/evals/cases/live-k8s-collect/case.yaml +10 -0
- platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_configmaps.denied.txt +1 -0
- platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_deployments.apps.json +25 -0
- platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_pods.json +17 -0
- platformforge/data/evals/cases/live-k8s-collect/fixture/kubectl/get_secrets.json +13 -0
- platformforge/data/evals/cases/live-multicluster/case.yaml +7 -0
- platformforge/data/evals/cases/live-multicluster/fixture/clusters.json +6 -0
- platformforge/data/evals/cases/live-plan/case.yaml +7 -0
- platformforge/data/evals/cases/live-plan/fixture/drift.json +8 -0
- platformforge/data/evals/cases/live-reconcile/case.yaml +7 -0
- platformforge/data/evals/cases/live-reconcile/fixture/desired.json +7 -0
- platformforge/data/evals/cases/live-reconcile/fixture/observed.json +18 -0
- platformforge/data/evals/cases/live-secrets-boundary/case.yaml +8 -0
- platformforge/data/evals/cases/live-secrets-boundary/fixture/envelope.json +16 -0
- platformforge/data/evals/cases/live-temporal-graph/case.yaml +10 -0
- platformforge/data/evals/cases/live-temporal-graph/fixture/graph.json +22 -0
- platformforge/data/evals/cases/ops-approval/case.yaml +6 -0
- platformforge/data/evals/cases/ops-convergence/case.yaml +6 -0
- platformforge/data/evals/cases/ops-execution-safety/case.yaml +6 -0
- platformforge/data/evals/cases/ops-intent/case.yaml +6 -0
- platformforge/data/evals/cases/ops-planning/case.yaml +6 -0
- platformforge/data/evals/cases/ops-policy/case.yaml +6 -0
- platformforge/data/evals/cases/ops-rollback/case.yaml +6 -0
- platformforge/data/evals/cases/ops-verification/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-argocd-revision/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-blind-inverse/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-git-commit/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-impossible/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-k8s-annotation-restore/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-k8s-scale/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-material-tamper/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-terraform-replan/case.yaml +6 -0
- platformforge/data/evals/cases/rollback-unknown/case.yaml +6 -0
- platformforge/data/evals/cases/routing-specialist/case.yaml +9 -0
- platformforge/data/evals/cases/rtk-roundtrip/case.yaml +5 -0
- platformforge/data/evals/cases/rtk-roundtrip/fixture/verbose.txt +300 -0
- platformforge/data/evals/cases/sbom-vuln/case.yaml +9 -0
- platformforge/data/evals/cases/sbom-vuln/fixture/sbom.json +9 -0
- platformforge/data/evals/cases/secret-prose-mixed/fixture/app.env +1 -0
- platformforge/data/evals/cases/secret-prose-mixed/fixture/policy-notes.md +7 -0
- platformforge/data/evals/cases/secrets-noleak/case.yaml +5 -0
- platformforge/data/evals/cases/secrets-noleak/fixture/app.env +2 -0
- platformforge/data/evals/cases/slo-fastburn/case.yaml +8 -0
- platformforge/data/evals/cases/slo-fastburn/fixture/events.yaml +2 -0
- platformforge/data/evals/cases/slo-fastburn/fixture/slo.yaml +4 -0
- platformforge/data/evals/cases/slo-noinput/case.yaml +8 -0
- platformforge/data/evals/cases/slo-noinput/fixture/events.yaml +1 -0
- platformforge/data/evals/cases/slo-noinput/fixture/slo.yaml +4 -0
- platformforge/data/evals/cases/sot-conflict/case.yaml +6 -0
- platformforge/data/evals/cases/token-budget/case.yaml +6 -0
- platformforge/data/evals/cases/token-budget/fixture/big.py +50 -0
- platformforge/data/evals/cases/xr-delete/case.yaml +8 -0
- platformforge/data/evals/cases/xr-delete/fixture/xr.yaml +10 -0
- platformforge/data/evals/cases/xr-graph-chain/case.yaml +8 -0
- platformforge/data/evals/cases/xr-graph-chain/fixture/xrd.yaml +90 -0
- platformforge/data/evals/cases/xr-negative-crd/case.yaml +8 -0
- platformforge/data/evals/cases/xr-negative-crd/fixture/widget.yaml +19 -0
- platformforge/data/evals/cases/xr-upbound-mr/case.yaml +8 -0
- platformforge/data/evals/cases/xr-upbound-mr/fixture/bucket.yaml +12 -0
- platformforge/data/evals/qpt-bench/change-review/case.yaml +5 -0
- platformforge/data/evals/qpt-bench/change-review/fixture/plan.json +9 -0
- platformforge/data/evals/qpt-bench/gha-security/case.yaml +5 -0
- platformforge/data/evals/qpt-bench/gha-security/fixture/ci.yml +10 -0
- platformforge/data/evals/qpt-bench/iam-investigate/case.yaml +5 -0
- platformforge/data/evals/qpt-bench/iam-investigate/fixture/policy.json +6 -0
- platformforge/data/evals/qpt-bench/incident-analysis/case.yaml +5 -0
- platformforge/data/evals/qpt-bench/incident-analysis/fixture/query.json +5 -0
- platformforge/data/evals/qpt-bench/incident-analysis/fixture/rules.yaml +6 -0
- platformforge/data/evals/qpt-bench/k8s-review/case.yaml +6 -0
- platformforge/data/evals/qpt-bench/k8s-review/fixture/deploy.yaml +15 -0
- platformforge/data/evals/qpt-bench/tf-security/case.yaml +5 -0
- platformforge/data/evals/qpt-bench/tf-security/fixture/main.tf +17 -0
- platformforge/data/knowledge/aws/eks.yaml +20 -0
- platformforge/data/knowledge/aws/iam.yaml +28 -0
- platformforge/data/knowledge/aws/network-exposure.yaml +19 -0
- platformforge/data/knowledge/aws/organizations.yaml +19 -0
- platformforge/data/knowledge/crossplane/composition-providers.yaml +20 -0
- platformforge/data/knowledge/crossplane/managed-resources.yaml +26 -0
- platformforge/data/knowledge/crossplane/v1-v2.yaml +25 -0
- platformforge/data/knowledge/kubernetes/api-deprecations.yaml +33 -0
- platformforge/data/knowledge/kubernetes/autoscaling-rbac.yaml +27 -0
- platformforge/data/knowledge/kubernetes/gateway-api.yaml +20 -0
- platformforge/data/knowledge/kubernetes/pod-security.yaml +26 -0
- platformforge/data/knowledge/sources.yaml +516 -0
- platformforge/data/knowledge/terraform/lifecycle.yaml +18 -0
- platformforge/data/knowledge/terraform/plan-semantics.yaml +26 -0
- platformforge/data/lab/chaos-pod-kill/chaos.yaml +3 -0
- platformforge/data/lab/chaos-pod-kill/facts.json +13 -0
- platformforge/data/lab/fleets/acme/capacity.yaml +35 -0
- platformforge/data/lab/fleets/acme/costs.yaml +25 -0
- platformforge/data/lab/fleets/acme/events.yaml +41 -0
- platformforge/data/lab/fleets/acme/fleet.yaml +51 -0
- platformforge/data/lab/fleets/acme/graph.yaml +45 -0
- platformforge/data/lab/fleets/acme/policies.yaml +28 -0
- platformforge/data/lab/fleets/acme/requests.yaml +24 -0
- platformforge/data/lab/scenarios/argo-bad-rollout/expected.yaml +6 -0
- platformforge/data/lab/scenarios/argo-bad-rollout/fixture/app.yaml +9 -0
- platformforge/data/lab/scenarios/aws-dump/expected.yaml +19 -0
- platformforge/data/lab/scenarios/aws-dump/fixture/compute.json +4 -0
- platformforge/data/lab/scenarios/aws-dump/fixture/iam.json +7 -0
- platformforge/data/lab/scenarios/aws-dump/fixture/network.json +6 -0
- platformforge/data/lab/scenarios/aws-dump/fixture/org.json +4 -0
- platformforge/data/lab/scenarios/aws-dump/fixture/storage.json +4 -0
- platformforge/data/lab/scenarios/container-unsigned/expected.yaml +5 -0
- platformforge/data/lab/scenarios/container-unsigned/fixture/supply.json +11 -0
- platformforge/data/lab/scenarios/cost-idle-workload/expected.yaml +5 -0
- platformforge/data/lab/scenarios/cost-idle-workload/fixture/costs.json +12 -0
- platformforge/data/lab/scenarios/crossplane-platform/expected.yaml +16 -0
- platformforge/data/lab/scenarios/crossplane-platform/fixture/negative.yaml +18 -0
- platformforge/data/lab/scenarios/crossplane-platform/fixture/xrd.yaml +90 -0
- platformforge/data/lab/scenarios/demo-platform/expected.yaml +16 -0
- platformforge/data/lab/scenarios/demo-platform/fixture/.github/workflows/ci.yml +10 -0
- platformforge/data/lab/scenarios/demo-platform/fixture/deploy.yaml +16 -0
- platformforge/data/lab/scenarios/demo-platform/fixture/infra.tf +5 -0
- platformforge/data/lab/scenarios/fleet-ai/expected.yaml +12 -0
- platformforge/data/lab/scenarios/fleet-capacity/expected.yaml +12 -0
- platformforge/data/lab/scenarios/fleet-cost/expected.yaml +18 -0
- platformforge/data/lab/scenarios/fleet-federation/expected.yaml +11 -0
- platformforge/data/lab/scenarios/fleet-golden-path/expected.yaml +18 -0
- platformforge/data/lab/scenarios/fleet-op-hotspot/expected.yaml +11 -0
- platformforge/data/lab/scenarios/fleet-ownership/expected.yaml +17 -0
- platformforge/data/lab/scenarios/fleet-partial/expected.yaml +10 -0
- platformforge/data/lab/scenarios/fleet-policy-friction/expected.yaml +10 -0
- platformforge/data/lab/scenarios/fleet-recurring-incident/expected.yaml +12 -0
- platformforge/data/lab/scenarios/fleet-report/expected.yaml +13 -0
- platformforge/data/lab/scenarios/fleet-risk/expected.yaml +18 -0
- platformforge/data/lab/scenarios/gitops-drift/expected.yaml +6 -0
- platformforge/data/lab/scenarios/gitops-drift/fixture/app.yaml +12 -0
- platformforge/data/lab/scenarios/k8s-bad-readiness/expected.yaml +6 -0
- platformforge/data/lab/scenarios/k8s-bad-readiness/fixture/deploy.yaml +23 -0
- platformforge/data/lab/scenarios/k8s-bad-readiness/fixture/netpol.yaml +9 -0
- platformforge/data/lab/scenarios/k8s-missing-limits/expected.yaml +6 -0
- platformforge/data/lab/scenarios/k8s-missing-limits/fixture/deploy.yaml +26 -0
- platformforge/data/lab/scenarios/k8s-missing-limits/fixture/netpol.yaml +9 -0
- platformforge/data/lab/scenarios/k8s-single-replica/expected.yaml +5 -0
- platformforge/data/lab/scenarios/k8s-single-replica/fixture/deploy.yaml +26 -0
- platformforge/data/lab/scenarios/k8s-single-replica/fixture/netpol.yaml +4 -0
- platformforge/data/lab/scenarios/live-aws-collect/expected.yaml +4 -0
- platformforge/data/lab/scenarios/live-aws-collect/fixture/aws/ec2_describe-vpcs.json +15 -0
- platformforge/data/lab/scenarios/live-aws-collect/fixture/aws/iam_list-users.denied.txt +1 -0
- platformforge/data/lab/scenarios/live-aws-collect/fixture/aws/sts_get-caller-identity.json +5 -0
- platformforge/data/lab/scenarios/live-k8s-collect/expected.yaml +4 -0
- platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_configmaps.denied.txt +1 -0
- platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_deployments.apps.json +25 -0
- platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_pods.json +17 -0
- platformforge/data/lab/scenarios/live-k8s-collect/fixture/kubectl/get_secrets.json +13 -0
- platformforge/data/lab/scenarios/live-kind/expected.yaml +14 -0
- platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_configmaps.denied.txt +1 -0
- platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_deployments.apps.json +25 -0
- platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_pods.json +17 -0
- platformforge/data/lab/scenarios/live-kind/fixture/kubectl/get_secrets.json +13 -0
- platformforge/data/lab/scenarios/network-policy-missing/expected.yaml +6 -0
- platformforge/data/lab/scenarios/network-policy-missing/fixture/deploy.yaml +26 -0
- platformforge/data/lab/scenarios/ops-bad-rollout/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-bad-rollout/fixture/ops.yaml +33 -0
- platformforge/data/lab/scenarios/ops-break-glass/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-break-glass/fixture/ops.yaml +21 -0
- platformforge/data/lab/scenarios/ops-broken-selector/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-broken-selector/fixture/ops.yaml +21 -0
- platformforge/data/lab/scenarios/ops-changed-plan-hash/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-changed-plan-hash/fixture/ops.yaml +20 -0
- platformforge/data/lab/scenarios/ops-conflicting-operation/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-conflicting-operation/fixture/ops.yaml +21 -0
- platformforge/data/lab/scenarios/ops-expired-approval/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-expired-approval/fixture/ops.yaml +20 -0
- platformforge/data/lab/scenarios/ops-partial-failure/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-partial-failure/fixture/ops.yaml +24 -0
- platformforge/data/lab/scenarios/ops-policy-denial/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-policy-denial/fixture/ops.yaml +17 -0
- platformforge/data/lab/scenarios/ops-replica-drift/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-replica-drift/fixture/ops.yaml +28 -0
- platformforge/data/lab/scenarios/ops-rollback-annotate/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-rollback-annotate/fixture/ops.yaml +41 -0
- platformforge/data/lab/scenarios/ops-rollback-gitops/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-rollback-gitops/fixture/ops.yaml +38 -0
- platformforge/data/lab/scenarios/ops-rollback-impossible/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-rollback-impossible/fixture/ops.yaml +34 -0
- platformforge/data/lab/scenarios/ops-rollback-scale/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-rollback-scale/fixture/ops.yaml +40 -0
- platformforge/data/lab/scenarios/ops-rollback-terraform/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-rollback-terraform/fixture/ops.yaml +38 -0
- platformforge/data/lab/scenarios/ops-rollback-terraform/fixture/tf/tfplan.bin +1 -0
- platformforge/data/lab/scenarios/ops-stale-observation/expected.yaml +3 -0
- platformforge/data/lab/scenarios/ops-stale-observation/fixture/ops.yaml +20 -0
- platformforge/data/lab/scenarios/secret-exposure/expected.yaml +5 -0
- platformforge/data/lab/scenarios/secret-exposure/fixture/app.env +2 -0
- platformforge/data/lab/scenarios/slo-burn/expected.yaml +5 -0
- platformforge/data/lab/scenarios/slo-burn/fixture/events.yaml +2 -0
- platformforge/data/lab/scenarios/slo-burn/fixture/slo.yaml +4 -0
- platformforge/data/lab/scenarios/terraform-iam-wildcard/expected.yaml +5 -0
- platformforge/data/lab/scenarios/terraform-iam-wildcard/fixture/policy.json +14 -0
- platformforge/data/lab/scenarios/terraform-public-bucket/expected.yaml +6 -0
- platformforge/data/lab/scenarios/terraform-public-bucket/fixture/main.tf +5 -0
- platformforge/data/portable_skills/platformforge-agents/SKILL.md +47 -0
- platformforge/data/portable_skills/platformforge-change/SKILL.md +41 -0
- platformforge/data/portable_skills/platformforge-core/SKILL.md +62 -0
- platformforge/data/portable_skills/platformforge-economy/SKILL.md +42 -0
- platformforge/data/portable_skills/platformforge-finops/SKILL.md +34 -0
- platformforge/data/portable_skills/platformforge-fleet/SKILL.md +39 -0
- platformforge/data/portable_skills/platformforge-governance/SKILL.md +76 -0
- platformforge/data/portable_skills/platformforge-graph/SKILL.md +46 -0
- platformforge/data/portable_skills/platformforge-lab/SKILL.md +39 -0
- platformforge/data/portable_skills/platformforge-sdd/SKILL.md +39 -0
- platformforge/data/portable_skills/platformforge-security/SKILL.md +38 -0
- platformforge/data/portable_skills/platformforge-sre/SKILL.md +41 -0
- platformforge/data/rules/catalog/finops.yaml +26 -0
- platformforge/data/rules/catalog/gitops.yaml +161 -0
- platformforge/data/rules/catalog/iac.yaml +84 -0
- platformforge/data/rules/catalog/k8s.yaml +322 -0
- platformforge/data/rules/catalog/orchestration.yaml +99 -0
- platformforge/data/rules/catalog/product.yaml +42 -0
- platformforge/data/rules/catalog/routing.yaml +122 -0
- platformforge/data/rules/catalog/security.yaml +159 -0
- platformforge/data/rules/catalog/sre.yaml +67 -0
- platformforge/diagnose/__init__.py +75 -0
- platformforge/distribution/__init__.py +18 -0
- platformforge/distribution/bundle.py +127 -0
- platformforge/distribution/hostflow.py +247 -0
- platformforge/distribution/models.py +80 -0
- platformforge/distribution/service.py +225 -0
- platformforge/economy/__init__.py +27 -0
- platformforge/economy/bench.py +66 -0
- platformforge/economy/budget.py +198 -0
- platformforge/economy/cache.py +287 -0
- platformforge/economy/checkpoint.py +112 -0
- platformforge/economy/collection.py +142 -0
- platformforge/economy/doctor.py +207 -0
- platformforge/economy/engine.py +158 -0
- platformforge/economy/envelope.py +61 -0
- platformforge/economy/fleetpack.py +86 -0
- platformforge/economy/ledger.py +232 -0
- platformforge/economy/plan.py +131 -0
- platformforge/economy/pricing.py +101 -0
- platformforge/economy/qpt.py +286 -0
- platformforge/economy/reconcile.py +86 -0
- platformforge/economy/verifyplan.py +107 -0
- platformforge/economy/waste.py +123 -0
- platformforge/evals/__init__.py +16 -0
- platformforge/evals/coverage.py +140 -0
- platformforge/evals/fleet_invariants.py +260 -0
- platformforge/evals/ops_invariants.py +158 -0
- platformforge/evals/runner.py +541 -0
- platformforge/federation/__init__.py +4 -0
- platformforge/federation/node.py +135 -0
- platformforge/finops/__init__.py +14 -0
- platformforge/finops/alloc.py +31 -0
- platformforge/finops/costs.py +79 -0
- platformforge/finops/focus.py +100 -0
- platformforge/finops/graph_cost.py +51 -0
- platformforge/finops/ingest.py +144 -0
- platformforge/finops/insights.py +193 -0
- platformforge/finops/unit.py +36 -0
- platformforge/fleet/__init__.py +5 -0
- platformforge/fleet/loader.py +73 -0
- platformforge/fleet/models.py +155 -0
- platformforge/fleet/orggraph.py +172 -0
- platformforge/fleet/query.py +154 -0
- platformforge/forge/__init__.py +9 -0
- platformforge/forge/collect.py +88 -0
- platformforge/forge/delegate.py +77 -0
- platformforge/forge/manifest.py +106 -0
- platformforge/freeze/__init__.py +22 -0
- platformforge/freeze/exceptions.py +56 -0
- platformforge/freeze/manifest.py +167 -0
- platformforge/freeze/snapshots.py +108 -0
- platformforge/graph/__init__.py +39 -0
- platformforge/graph/backend.py +174 -0
- platformforge/graph/bench.py +245 -0
- platformforge/graph/build.py +130 -0
- platformforge/graph/delivery.py +183 -0
- platformforge/graph/diff.py +292 -0
- platformforge/graph/events.py +116 -0
- platformforge/graph/migrate.py +44 -0
- platformforge/graph/model.py +264 -0
- platformforge/graph/persist.py +97 -0
- platformforge/graph/query.py +290 -0
- platformforge/graph/temporal.py +78 -0
- platformforge/graph/vocab.py +63 -0
- platformforge/graphview.py +94 -0
- platformforge/iac/__init__.py +7 -0
- platformforge/iac/drift.py +53 -0
- platformforge/iac/plan.py +84 -0
- platformforge/iac/terraform.py +123 -0
- platformforge/install/__init__.py +1 -0
- platformforge/install/service.py +421 -0
- platformforge/k8s/__init__.py +8 -0
- platformforge/k8s/helm.py +152 -0
- platformforge/k8s/hubble.py +87 -0
- platformforge/k8s/manifests.py +513 -0
- platformforge/knowledge/__init__.py +1 -0
- platformforge/knowledge/packs.py +157 -0
- platformforge/knowledge/registry.py +249 -0
- platformforge/knowledge/select.py +127 -0
- platformforge/lab/__init__.py +5 -0
- platformforge/lab/chaos.py +71 -0
- platformforge/lab/fleetlab.py +351 -0
- platformforge/lab/opslab.py +271 -0
- platformforge/lab/runner.py +219 -0
- platformforge/live/__init__.py +36 -0
- platformforge/live/budget.py +92 -0
- platformforge/live/capability.py +80 -0
- platformforge/live/collectors/__init__.py +6 -0
- platformforge/live/collectors/aws.py +370 -0
- platformforge/live/collectors/aws_transport.py +98 -0
- platformforge/live/collectors/k8s.py +389 -0
- platformforge/live/collectors/k8s_transport.py +85 -0
- platformforge/live/cursors.py +48 -0
- platformforge/live/drift.py +130 -0
- platformforge/live/envelope.py +85 -0
- platformforge/live/federation.py +113 -0
- platformforge/live/fixtures.py +168 -0
- platformforge/live/identity.py +258 -0
- platformforge/live/incident.py +200 -0
- platformforge/live/models.py +435 -0
- platformforge/live/reconcile.py +382 -0
- platformforge/live/remediate.py +169 -0
- platformforge/live/store.py +256 -0
- platformforge/live/topology.py +249 -0
- platformforge/mcp/__init__.py +7 -0
- platformforge/mcp/parity.py +69 -0
- platformforge/mcp/registry.py +427 -0
- platformforge/mcp/server.py +84 -0
- platformforge/mcp/tools.py +732 -0
- platformforge/models/__init__.py +21 -0
- platformforge/models/base.py +214 -0
- platformforge/observe/__init__.py +26 -0
- platformforge/observe/capacity.py +39 -0
- platformforge/observe/dr.py +67 -0
- platformforge/observe/grafana.py +76 -0
- platformforge/observe/incident.py +58 -0
- platformforge/observe/otel.py +135 -0
- platformforge/observe/postmortem.py +72 -0
- platformforge/observe/prometheus.py +88 -0
- platformforge/observe/slo.py +125 -0
- platformforge/ops/__init__.py +8 -0
- platformforge/ops/actions.py +215 -0
- platformforge/ops/analytics.py +83 -0
- platformforge/ops/approval.py +275 -0
- platformforge/ops/autorem.py +101 -0
- platformforge/ops/config.py +175 -0
- platformforge/ops/engine.py +758 -0
- platformforge/ops/envelope.py +135 -0
- platformforge/ops/executors/__init__.py +1 -0
- platformforge/ops/executors/base.py +211 -0
- platformforge/ops/executors/git.py +77 -0
- platformforge/ops/executors/gitops.py +134 -0
- platformforge/ops/executors/terraform.py +84 -0
- platformforge/ops/gates.py +135 -0
- platformforge/ops/goldenpath.py +180 -0
- platformforge/ops/material.py +181 -0
- platformforge/ops/models.py +421 -0
- platformforge/ops/operation.py +335 -0
- platformforge/ops/opgraph.py +233 -0
- platformforge/ops/policy.py +275 -0
- platformforge/ops/preconditions.py +109 -0
- platformforge/ops/registry.py +101 -0
- platformforge/ops/risk.py +216 -0
- platformforge/ops/rollback.py +287 -0
- platformforge/ops/rollback_builders.py +163 -0
- platformforge/ops/runbook.py +269 -0
- platformforge/ops/simulate.py +125 -0
- platformforge/ops/source_of_truth.py +198 -0
- platformforge/ops/store.py +157 -0
- platformforge/ops/verify.py +190 -0
- platformforge/optimize/__init__.py +4 -0
- platformforge/optimize/engine.py +109 -0
- platformforge/optimize/models.py +68 -0
- platformforge/optimize/scan.py +196 -0
- platformforge/plan/__init__.py +107 -0
- platformforge/portable_cli.py +199 -0
- platformforge/portal_adapter.py +740 -0
- platformforge/portal_assets/chunk-7_l-b4Tr.js +1 -0
- platformforge/portal_assets/chunk-B0Iad6pD.js +1 -0
- platformforge/portal_assets/chunk-B605XnCF.js +1 -0
- platformforge/portal_assets/chunk-B7N3TXcn.js +1 -0
- platformforge/portal_assets/chunk-BAj6yGem.js +1 -0
- platformforge/portal_assets/chunk-BGUitn2r.js +1 -0
- platformforge/portal_assets/chunk-BVKnCv85.js +1 -0
- platformforge/portal_assets/chunk-BYyM9V_w.js +1 -0
- platformforge/portal_assets/chunk-BaQMhq-G.js +1 -0
- platformforge/portal_assets/chunk-BavOrxVm.js +1 -0
- platformforge/portal_assets/chunk-Bb0C24YV.js +1 -0
- platformforge/portal_assets/chunk-BfCFGPzs.js +1 -0
- platformforge/portal_assets/chunk-C2t4OUVu.js +1 -0
- platformforge/portal_assets/chunk-C3pI4QjU.js +1 -0
- platformforge/portal_assets/chunk-C4gpbtbP.js +1 -0
- platformforge/portal_assets/chunk-CGWeHhKY.js +1 -0
- platformforge/portal_assets/chunk-CJCT86Dr.js +1 -0
- platformforge/portal_assets/chunk-CXcsLDPJ.js +1 -0
- platformforge/portal_assets/chunk-CcjxoLxw.js +1 -0
- platformforge/portal_assets/chunk-D-gBPXHa.js +1 -0
- platformforge/portal_assets/chunk-D3eZogIe.js +1 -0
- platformforge/portal_assets/chunk-DQU0VyoQ.js +1 -0
- platformforge/portal_assets/chunk-DqWNkF1O.js +1 -0
- platformforge/portal_assets/chunk-DuPPkSIE.js +3 -0
- platformforge/portal_assets/chunk-DyIHOW_a.js +1 -0
- platformforge/portal_assets/chunk-Fx4zSGL5.js +1 -0
- platformforge/portal_assets/chunk-UBKt05Rg.js +1 -0
- platformforge/portal_assets/chunk-htnJDQEY.js +1 -0
- platformforge/portal_assets/chunk-kXRFMGqe.js +1 -0
- platformforge/portal_assets/chunk-qe3u763a.js +1 -0
- platformforge/portal_assets/favicon.ico +0 -0
- platformforge/portal_assets/index.html +13 -0
- platformforge/portal_assets/main-QDFVZK3T.js +5 -0
- platformforge/portal_assets/styles-MQEBDFDX.css +1 -0
- platformforge/product/__init__.py +10 -0
- platformforge/product/backstage.py +49 -0
- platformforge/product/catalog.py +74 -0
- platformforge/product/crossplane.py +341 -0
- platformforge/product/golden_paths/__init__.py +5 -0
- platformforge/product/golden_paths/engine.py +97 -0
- platformforge/product/golden_paths/library.yaml +198 -0
- platformforge/product/golden_paths/model.py +84 -0
- platformforge/product/maturity.py +107 -0
- platformforge/product/scorecards.py +84 -0
- platformforge/resources.py +36 -0
- platformforge/risk/__init__.py +5 -0
- platformforge/risk/engine.py +95 -0
- platformforge/risk/signals.py +49 -0
- platformforge/routing/__init__.py +13 -0
- platformforge/routing/decision.py +191 -0
- platformforge/routing/router.py +328 -0
- platformforge/rtk/__init__.py +9 -0
- platformforge/rtk/compact.py +127 -0
- platformforge/rtk/parsers.py +199 -0
- platformforge/rules/__init__.py +5 -0
- platformforge/rules/engine.py +345 -0
- platformforge/sandbox/__init__.py +7 -0
- platformforge/sandbox/env.py +151 -0
- platformforge/sandbox/review.py +92 -0
- platformforge/sdd/__init__.py +8 -0
- platformforge/sdd/lifecycle.py +239 -0
- platformforge/security/__init__.py +19 -0
- platformforge/security/cosign.py +67 -0
- platformforge/security/iam.py +112 -0
- platformforge/security/identity.py +84 -0
- platformforge/security/kyverno.py +106 -0
- platformforge/security/sbom.py +59 -0
- platformforge/security/scan.py +63 -0
- platformforge/security/slsa.py +86 -0
- platformforge/security/supply.py +62 -0
- platformforge/tokensave/__init__.py +20 -0
- platformforge/tokensave/budget.py +62 -0
- platformforge/tokensave/estimate.py +21 -0
- platformforge/tokensave/index.py +172 -0
- platformforge/tokensave/ledger.py +121 -0
- platformforge/tokensave/packs.py +285 -0
- platformforge/ui/__init__.py +28 -0
- platformforge/ui/app.py +465 -0
- platformforge/ui/home.py +113 -0
- platformforge/ui/i18n.py +143 -0
- platformforge/ui/kit.py +689 -0
- platformforge/ui/screen.py +628 -0
- platformforge/ui/tui.py +94 -0
- platformforge/ui/wizard.py +309 -0
- platformforge/workspace/__init__.py +13 -0
- platformforge/workspace/models.py +35 -0
- platformforge/workspace/service.py +69 -0
- platformforge-0.1.0.dist-info/METADATA +212 -0
- platformforge-0.1.0.dist-info/RECORD +659 -0
- platformforge-0.1.0.dist-info/WHEEL +4 -0
- platformforge-0.1.0.dist-info/entry_points.txt +3 -0
- 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)}}
|