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,135 @@
|
|
|
1
|
+
"""Cycle 4 — ExecutionEnvelope (§65–67, ADR-0021/0025).
|
|
2
|
+
|
|
3
|
+
The envelope is the *exact* set of authorized actions: executor, typed
|
|
4
|
+
actions, scope, preconditions, policy decisions, approvals, risk,
|
|
5
|
+
expected delta, verification + rollback strategies, idempotency key,
|
|
6
|
+
TTL. It is hash-pinned — after `freeze()` (approval binding) any content
|
|
7
|
+
change produces a different hash and downstream validation refuses.
|
|
8
|
+
Envelopes are minted only when policy allows; they never mint themselves.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
from dataclasses import dataclass, field
|
|
14
|
+
from typing import Any
|
|
15
|
+
|
|
16
|
+
from platformforge.live.models import canonical_hash, now_iso, parse_ts
|
|
17
|
+
from platformforge.ops.actions import validate_action
|
|
18
|
+
|
|
19
|
+
ENVELOPE_SCHEMA = "platformforge/execution/v1"
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
@dataclass
|
|
23
|
+
class ExecutionEnvelope:
|
|
24
|
+
execution_id: str = ""
|
|
25
|
+
intent_id: str = ""
|
|
26
|
+
change_plan_hash: str = ""
|
|
27
|
+
executor: str = ""
|
|
28
|
+
actions: list[dict[str, Any]] = field(default_factory=list) # {action, params, step_id}
|
|
29
|
+
scope: list[str] = field(default_factory=list)
|
|
30
|
+
preconditions: dict[str, Any] = field(default_factory=dict)
|
|
31
|
+
policy_decisions: list[dict[str, Any]] = field(default_factory=list)
|
|
32
|
+
approvals: list[str] = field(default_factory=list) # approval ids
|
|
33
|
+
risk: dict[str, Any] = field(default_factory=dict)
|
|
34
|
+
expected_delta: dict[str, Any] = field(default_factory=dict)
|
|
35
|
+
verification: dict[str, Any] = field(default_factory=dict)
|
|
36
|
+
rollback: dict[str, Any] = field(default_factory=dict)
|
|
37
|
+
idempotency_key: str = ""
|
|
38
|
+
created_at: str = ""
|
|
39
|
+
expires_at: str = ""
|
|
40
|
+
_frozen_hash: str = field(default="", repr=False, compare=False)
|
|
41
|
+
|
|
42
|
+
def __post_init__(self):
|
|
43
|
+
if not self.created_at:
|
|
44
|
+
self.created_at = now_iso()
|
|
45
|
+
if not self.idempotency_key:
|
|
46
|
+
self.idempotency_key = "idem-" + canonical_hash(
|
|
47
|
+
{"intent": self.intent_id, "plan": self.change_plan_hash,
|
|
48
|
+
"actions": self.actions})[:24]
|
|
49
|
+
|
|
50
|
+
def validate(self) -> list[dict[str, Any]]:
|
|
51
|
+
v: list[dict[str, Any]] = []
|
|
52
|
+
if not self.execution_id:
|
|
53
|
+
v.append({"refusal": "PF-OPS-BAD-EXECUTION-ID",
|
|
54
|
+
"unlock": "set execution_id"})
|
|
55
|
+
if not self.change_plan_hash:
|
|
56
|
+
v.append({"refusal": "PF-OPS-ENVELOPE-NO-PLAN",
|
|
57
|
+
"unlock": "envelope must bind to a change_plan_hash"})
|
|
58
|
+
if not self.approvals and not self.policy_decisions:
|
|
59
|
+
v.append({"refusal": "PF-OPS-ENVELOPE-UNGOVERNED",
|
|
60
|
+
"unlock": "envelope requires policy decisions and/or "
|
|
61
|
+
"approvals — execution is never self-minted"})
|
|
62
|
+
for a in self.actions:
|
|
63
|
+
r = validate_action(a.get("action", ""), a.get("params", {}))
|
|
64
|
+
if r:
|
|
65
|
+
v.append(r)
|
|
66
|
+
if self.expires_at and parse_ts(self.expires_at) is None:
|
|
67
|
+
v.append({"refusal": "PF-OPS-BAD-EXPIRY",
|
|
68
|
+
"unlock": "expires_at must be ISO-8601"})
|
|
69
|
+
return v
|
|
70
|
+
|
|
71
|
+
def hash(self) -> str:
|
|
72
|
+
return "sha256:" + canonical_hash(self.to_dict())
|
|
73
|
+
|
|
74
|
+
@property
|
|
75
|
+
def frozen(self) -> bool:
|
|
76
|
+
return bool(self._frozen_hash)
|
|
77
|
+
|
|
78
|
+
def freeze(self) -> str:
|
|
79
|
+
"""Bind the envelope to its current hash — post-approval the
|
|
80
|
+
object is treated as immutable (§67)."""
|
|
81
|
+
self._frozen_hash = self.hash()
|
|
82
|
+
return self._frozen_hash
|
|
83
|
+
|
|
84
|
+
def is_intact(self) -> bool:
|
|
85
|
+
return not self._frozen_hash or self.hash() == self._frozen_hash
|
|
86
|
+
|
|
87
|
+
def is_expired(self, at: str | None = None) -> bool:
|
|
88
|
+
exp = parse_ts(self.expires_at)
|
|
89
|
+
ref = parse_ts(at) if at else parse_ts(now_iso())
|
|
90
|
+
return bool(exp and ref and ref > exp)
|
|
91
|
+
|
|
92
|
+
def mutating_actions(self) -> list[dict[str, Any]]:
|
|
93
|
+
from platformforge.ops.actions import spec_for
|
|
94
|
+
return [a for a in self.actions
|
|
95
|
+
if (s := spec_for(a.get("action", ""))) and s.mutating]
|
|
96
|
+
|
|
97
|
+
def to_dict(self) -> dict[str, Any]:
|
|
98
|
+
from platformforge.core.redaction import redact_obj
|
|
99
|
+
return {"schema": ENVELOPE_SCHEMA,
|
|
100
|
+
"execution_id": self.execution_id,
|
|
101
|
+
"intent_id": self.intent_id,
|
|
102
|
+
"change_plan_hash": self.change_plan_hash,
|
|
103
|
+
"executor": self.executor,
|
|
104
|
+
# action params are redacted at the serialization
|
|
105
|
+
# boundary — an envelope never emits raw secrets
|
|
106
|
+
"actions": redact_obj(self.actions),
|
|
107
|
+
"scope": self.scope, "preconditions": self.preconditions,
|
|
108
|
+
"policy_decisions": self.policy_decisions,
|
|
109
|
+
"approvals": self.approvals, "risk": self.risk,
|
|
110
|
+
"expected_delta": self.expected_delta,
|
|
111
|
+
"verification": self.verification,
|
|
112
|
+
"rollback": self.rollback,
|
|
113
|
+
"idempotency_key": self.idempotency_key,
|
|
114
|
+
"created_at": self.created_at,
|
|
115
|
+
"expires_at": self.expires_at}
|
|
116
|
+
|
|
117
|
+
@classmethod
|
|
118
|
+
def from_dict(cls, d: dict[str, Any]) -> ExecutionEnvelope:
|
|
119
|
+
return cls(
|
|
120
|
+
execution_id=d.get("execution_id", ""),
|
|
121
|
+
intent_id=d.get("intent_id", ""),
|
|
122
|
+
change_plan_hash=d.get("change_plan_hash", ""),
|
|
123
|
+
executor=d.get("executor", ""),
|
|
124
|
+
actions=list(d.get("actions", [])),
|
|
125
|
+
scope=list(d.get("scope", [])),
|
|
126
|
+
preconditions=dict(d.get("preconditions", {})),
|
|
127
|
+
policy_decisions=list(d.get("policy_decisions", [])),
|
|
128
|
+
approvals=list(d.get("approvals", [])),
|
|
129
|
+
risk=dict(d.get("risk", {})),
|
|
130
|
+
expected_delta=dict(d.get("expected_delta", {})),
|
|
131
|
+
verification=dict(d.get("verification", {})),
|
|
132
|
+
rollback=dict(d.get("rollback", {})),
|
|
133
|
+
idempotency_key=d.get("idempotency_key", ""),
|
|
134
|
+
created_at=d.get("created_at", ""),
|
|
135
|
+
expires_at=d.get("expires_at", ""))
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""Executors package init."""
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
"""Cycle 4 — executor boundary (§70–71, ADR-0027).
|
|
2
|
+
|
|
3
|
+
Executors are deterministic host-side adapters. The core builds typed
|
|
4
|
+
steps; transports run them; results come back as ExecutionReceipts.
|
|
5
|
+
An executor NEVER sees LLM context and NEVER receives a raw shell
|
|
6
|
+
string — only `action` + validated `params`.
|
|
7
|
+
|
|
8
|
+
Transport contract (same shape as collectors):
|
|
9
|
+
run(argv: list[str], cwd: str|None, timeout_s: int)
|
|
10
|
+
-> (rc: int, stdout: str, stderr: str)
|
|
11
|
+
Injected per call — tests and fixtures replay deterministic transports.
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
from __future__ import annotations
|
|
15
|
+
|
|
16
|
+
import time
|
|
17
|
+
from collections.abc import Callable
|
|
18
|
+
from dataclasses import dataclass, field
|
|
19
|
+
from typing import Any
|
|
20
|
+
|
|
21
|
+
from platformforge.live.models import canonical_hash, now_iso
|
|
22
|
+
from platformforge.ops.actions import spec_for, validate_action
|
|
23
|
+
|
|
24
|
+
Transport = Callable[..., tuple[int, str, str]]
|
|
25
|
+
|
|
26
|
+
RECEIPT_SCHEMA = "platformforge/execution-receipt/v1"
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
@dataclass
|
|
30
|
+
class ExecutionReceipt:
|
|
31
|
+
"""§94–96 — what happened, hashed, reproducible."""
|
|
32
|
+
|
|
33
|
+
step_id: str
|
|
34
|
+
action: str
|
|
35
|
+
executor: str
|
|
36
|
+
ok: bool
|
|
37
|
+
dry_run: bool = False
|
|
38
|
+
rc: int = 0
|
|
39
|
+
started_at: str = ""
|
|
40
|
+
finished_at: str = ""
|
|
41
|
+
duration_ms: int = 0
|
|
42
|
+
outputs: dict[str, Any] = field(default_factory=dict)
|
|
43
|
+
refusal: dict[str, Any] | None = None
|
|
44
|
+
error: str = ""
|
|
45
|
+
argv_hash: str = "" # hash of the argv (argv may contain paths)
|
|
46
|
+
side_effects: str = ""
|
|
47
|
+
receipt_hash: str = ""
|
|
48
|
+
|
|
49
|
+
def finalize(self) -> ExecutionReceipt:
|
|
50
|
+
body = {
|
|
51
|
+
"step_id": self.step_id,
|
|
52
|
+
"action": self.action,
|
|
53
|
+
"executor": self.executor,
|
|
54
|
+
"ok": self.ok,
|
|
55
|
+
"dry_run": self.dry_run,
|
|
56
|
+
"rc": self.rc,
|
|
57
|
+
"finished_at": self.finished_at,
|
|
58
|
+
"outputs": self.outputs,
|
|
59
|
+
"error": self.error,
|
|
60
|
+
"argv_hash": self.argv_hash,
|
|
61
|
+
"refusal": self.refusal,
|
|
62
|
+
}
|
|
63
|
+
self.receipt_hash = "sha256:" + canonical_hash(body)
|
|
64
|
+
return self
|
|
65
|
+
|
|
66
|
+
def to_dict(self) -> dict[str, Any]:
|
|
67
|
+
return {
|
|
68
|
+
"schema": RECEIPT_SCHEMA,
|
|
69
|
+
"step_id": self.step_id,
|
|
70
|
+
"action": self.action,
|
|
71
|
+
"executor": self.executor,
|
|
72
|
+
"ok": self.ok,
|
|
73
|
+
"dry_run": self.dry_run,
|
|
74
|
+
"rc": self.rc,
|
|
75
|
+
"started_at": self.started_at,
|
|
76
|
+
"finished_at": self.finished_at,
|
|
77
|
+
"duration_ms": self.duration_ms,
|
|
78
|
+
"outputs": self.outputs,
|
|
79
|
+
"argv_hash": self.argv_hash,
|
|
80
|
+
"side_effects": self.side_effects,
|
|
81
|
+
"refusal": self.refusal,
|
|
82
|
+
"error": self.error,
|
|
83
|
+
"receipt_hash": self.receipt_hash,
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
class Executor:
|
|
88
|
+
"""Base: dispatch typed actions to argv builders; wrap in receipts."""
|
|
89
|
+
|
|
90
|
+
name = "abstract"
|
|
91
|
+
|
|
92
|
+
def supports(self, action: str) -> bool:
|
|
93
|
+
s = spec_for(action)
|
|
94
|
+
return bool(s and s.executor == self.name)
|
|
95
|
+
|
|
96
|
+
def argv_for(self, action: str, params: dict[str, Any], dry_run: bool) -> list[str] | dict[str, Any]:
|
|
97
|
+
"""Return argv or a refusal dict."""
|
|
98
|
+
return {"refusal": "PF-OPS-NO-EXECUTOR", "unlock": f"{self.name} has no argv builder for {action}"}
|
|
99
|
+
|
|
100
|
+
def run_step(
|
|
101
|
+
self,
|
|
102
|
+
step_id: str,
|
|
103
|
+
action: str,
|
|
104
|
+
params: dict[str, Any],
|
|
105
|
+
*,
|
|
106
|
+
transport: Transport | None = None,
|
|
107
|
+
dry_run: bool = False,
|
|
108
|
+
cwd: str | None = None,
|
|
109
|
+
timeout_s: int | None = None,
|
|
110
|
+
) -> ExecutionReceipt:
|
|
111
|
+
spec = spec_for(action)
|
|
112
|
+
started = now_iso()
|
|
113
|
+
t0 = time.monotonic()
|
|
114
|
+
r = ExecutionReceipt(
|
|
115
|
+
step_id=step_id, action=action, executor=self.name, ok=False, dry_run=dry_run, started_at=started
|
|
116
|
+
)
|
|
117
|
+
|
|
118
|
+
def finish(ok: bool, **kw) -> ExecutionReceipt:
|
|
119
|
+
r.ok = ok
|
|
120
|
+
r.finished_at = now_iso()
|
|
121
|
+
r.duration_ms = int((time.monotonic() - t0) * 1000)
|
|
122
|
+
for k, v in kw.items():
|
|
123
|
+
setattr(r, k, v)
|
|
124
|
+
return r.finalize()
|
|
125
|
+
|
|
126
|
+
if spec is None:
|
|
127
|
+
return finish(
|
|
128
|
+
False,
|
|
129
|
+
refusal={"refusal": "PF-OPS-UNKNOWN-ACTION", "unlock": f"action {action} not in vocabulary"},
|
|
130
|
+
)
|
|
131
|
+
if spec.executor != self.name:
|
|
132
|
+
return finish(
|
|
133
|
+
False,
|
|
134
|
+
refusal={
|
|
135
|
+
"refusal": "PF-OPS-WRONG-EXECUTOR",
|
|
136
|
+
"unlock": f"{action} is owned by {spec.executor}, not {self.name}",
|
|
137
|
+
},
|
|
138
|
+
)
|
|
139
|
+
err = validate_action(action, params)
|
|
140
|
+
if err:
|
|
141
|
+
return finish(False, refusal=err)
|
|
142
|
+
if dry_run and not spec.dry_run:
|
|
143
|
+
return finish(
|
|
144
|
+
False, refusal={"refusal": "PF-OPS-NO-DRYRUN", "unlock": f"{action} does not support dry-run"}
|
|
145
|
+
)
|
|
146
|
+
if spec.mutating and transport is None:
|
|
147
|
+
return finish(
|
|
148
|
+
False,
|
|
149
|
+
refusal={
|
|
150
|
+
"refusal": "PF-OPS-NO-TRANSPORT",
|
|
151
|
+
"unlock": "mutating actions require an injected host "
|
|
152
|
+
"transport — the core never executes alone",
|
|
153
|
+
},
|
|
154
|
+
)
|
|
155
|
+
argv = self.argv_for(action, params, dry_run)
|
|
156
|
+
if isinstance(argv, dict): # refusal from builder
|
|
157
|
+
return finish(False, refusal=argv)
|
|
158
|
+
r.argv_hash = "sha256:" + canonical_hash(argv)
|
|
159
|
+
r.side_effects = spec.side_effects
|
|
160
|
+
if transport is None: # non-mutating, no transport
|
|
161
|
+
return finish(True, outputs={"skipped": "no transport"})
|
|
162
|
+
try:
|
|
163
|
+
rc, out, err_s = transport(argv, cwd, timeout_s or spec.timeout_s)
|
|
164
|
+
except Exception as exc: # noqa: BLE001 — adapter failure is evidence
|
|
165
|
+
return finish(False, error=f"transport-error:{exc}")
|
|
166
|
+
r.rc = rc
|
|
167
|
+
outputs = self.parse_outputs(action, rc, out, err_s)
|
|
168
|
+
if rc != 0:
|
|
169
|
+
return finish(False, outputs=outputs, error=err_s[:2000])
|
|
170
|
+
return finish(True, outputs=outputs)
|
|
171
|
+
|
|
172
|
+
def parse_outputs(self, action: str, rc: int, out: str, err: str) -> dict[str, Any]:
|
|
173
|
+
return {"stdout_tail": out[-2000:], "stderr_tail": err[-2000:]}
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
class ObserveExecutor(Executor):
|
|
177
|
+
"""Read-only observation steps — dispatch to the live collectors'
|
|
178
|
+
contract (typed observe actions, never free-form queries)."""
|
|
179
|
+
|
|
180
|
+
name = "observe"
|
|
181
|
+
|
|
182
|
+
def argv_for(self, action, params, dry_run):
|
|
183
|
+
import json
|
|
184
|
+
|
|
185
|
+
return ["observe", action, json.dumps(params, sort_keys=True)]
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
def host_transport() -> Transport:
|
|
189
|
+
"""Host boundary: argv-only subprocess runner. Executors build the
|
|
190
|
+
argv; this never sees a shell string (no shell=True)."""
|
|
191
|
+
import subprocess
|
|
192
|
+
|
|
193
|
+
def run(argv: list[str], cwd=None, timeout_s=None):
|
|
194
|
+
if not argv or not isinstance(argv, list):
|
|
195
|
+
return 2, "", "bad argv"
|
|
196
|
+
try:
|
|
197
|
+
p = subprocess.run(
|
|
198
|
+
[str(a) for a in argv],
|
|
199
|
+
cwd=cwd,
|
|
200
|
+
capture_output=True,
|
|
201
|
+
text=True,
|
|
202
|
+
timeout=timeout_s or 300,
|
|
203
|
+
check=False,
|
|
204
|
+
)
|
|
205
|
+
return p.returncode, p.stdout, p.stderr
|
|
206
|
+
except FileNotFoundError:
|
|
207
|
+
return 127, "", f"binary not found: {argv[0]}"
|
|
208
|
+
except subprocess.TimeoutExpired:
|
|
209
|
+
return 124, "", f"timeout {timeout_s}s"
|
|
210
|
+
|
|
211
|
+
return run
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
"""Git executor (§72–74): branch, bounded patch, commit, push, PR.
|
|
2
|
+
|
|
3
|
+
`git.open_pr` does not shell out to GitHub in the core — it emits the
|
|
4
|
+
PR *spec* (title/body/head/base + plan-hash trailer). The transport may
|
|
5
|
+
be `gh pr create` host-side; the body carries reason, evidence, deltas,
|
|
6
|
+
risk, validation, rollback per §74. Force-push is never generated;
|
|
7
|
+
`--force-with-lease` only on pf/* branches and only when requested.
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
from __future__ import annotations
|
|
11
|
+
|
|
12
|
+
from typing import Any
|
|
13
|
+
|
|
14
|
+
from platformforge.ops.executors.base import Executor
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class GitExecutor(Executor):
|
|
18
|
+
name = "git"
|
|
19
|
+
|
|
20
|
+
def argv_for(self, action: str, params: dict[str, Any],
|
|
21
|
+
dry_run: bool) -> list[str] | dict[str, Any]:
|
|
22
|
+
repo = params.get("repo", ".")
|
|
23
|
+
if action == "git.create_branch":
|
|
24
|
+
base = params.get("base", "HEAD")
|
|
25
|
+
return ["git", "-C", repo, "checkout", "-b", params["branch"], base]
|
|
26
|
+
if action == "git.apply_patch":
|
|
27
|
+
if params.get("check_only") or dry_run:
|
|
28
|
+
return ["git", "-C", repo, "apply", "--check", "--index",
|
|
29
|
+
"-"] # patch content via stdin host-side
|
|
30
|
+
return ["git", "-C", repo, "apply", "--index",
|
|
31
|
+
"--whitespace=error-all", "-"]
|
|
32
|
+
if action == "git.commit":
|
|
33
|
+
argv = ["git", "-C", repo, "commit", "-m", params["message"]]
|
|
34
|
+
if params.get("signoff"):
|
|
35
|
+
argv.append("--signoff")
|
|
36
|
+
return argv
|
|
37
|
+
if action == "git.push":
|
|
38
|
+
remote = params.get("remote", "origin")
|
|
39
|
+
return ["git", "-C", repo, "push", "-u", remote,
|
|
40
|
+
params["branch"]]
|
|
41
|
+
if action == "git.open_pr":
|
|
42
|
+
# PR is a host integration — emit spec; transport runs gh/api
|
|
43
|
+
return ["pr-spec", params["repo"], params["head"],
|
|
44
|
+
params["base"], params["title"]]
|
|
45
|
+
if action == "git.delete_branch":
|
|
46
|
+
return ["git", "-C", repo, "branch", "-D", params["branch"]]
|
|
47
|
+
if action == "git.revert_commit":
|
|
48
|
+
return ["git", "-C", repo, "revert", "--no-edit",
|
|
49
|
+
params["commit_sha"]]
|
|
50
|
+
if action == "git.close_pr":
|
|
51
|
+
return ["pr-close", params["repo"], str(params["pr"])]
|
|
52
|
+
return super().argv_for(action, params, dry_run)
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
def pr_body(*, reason: str, evidence: list[str], plan_hash: str,
|
|
56
|
+
expected_delta: dict[str, Any], risk: dict[str, Any],
|
|
57
|
+
validation: list[str], rollback: dict[str, Any]) -> str:
|
|
58
|
+
"""§74 — generated PRs carry the full evidence chain."""
|
|
59
|
+
lines = [f"## Reason\n{reason}", "",
|
|
60
|
+
"## Evidence",
|
|
61
|
+
*[f"- {e}" for e in evidence], "",
|
|
62
|
+
f"Plan hash: `{plan_hash}`", "",
|
|
63
|
+
"## Expected delta",
|
|
64
|
+
"```json",
|
|
65
|
+
_j(expected_delta), "```", "",
|
|
66
|
+
"## Risk", "```json", _j(risk), "```", "",
|
|
67
|
+
"## Validation", *[f"- {v}" for v in validation], "",
|
|
68
|
+
"## Rollback", "```json", _j(rollback), "```", "",
|
|
69
|
+
"---",
|
|
70
|
+
"Generated by Platform Forge (governed operations).",
|
|
71
|
+
f"Plan-Hash: {plan_hash}"]
|
|
72
|
+
return "\n".join(lines)
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
def _j(obj: Any) -> str:
|
|
76
|
+
import json
|
|
77
|
+
return json.dumps(obj, indent=2, sort_keys=True)[:4000]
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
"""GitOps executor (§79–81): ArgoCD sync/diff/wait/rollback.
|
|
2
|
+
|
|
3
|
+
GitOps-first: the default remediation path is a Git change the
|
|
4
|
+
controller reconciles. `argocd.sync` exists for governed cases only —
|
|
5
|
+
it requires application scope, pinned revision, diff evidence, health
|
|
6
|
+
precondition, policy allow and approval. `--prune`, `--replace`,
|
|
7
|
+
`--force` are never generated by the executor: they are distinct,
|
|
8
|
+
higher-risk capabilities requiring their own envelopes.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
from typing import Any
|
|
14
|
+
|
|
15
|
+
from platformforge.ops.executors.base import Executor
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
class ArgoCDExecutor(Executor):
|
|
19
|
+
name = "argocd"
|
|
20
|
+
|
|
21
|
+
def argv_for(self, action: str, params: dict[str, Any],
|
|
22
|
+
dry_run: bool) -> list[str] | dict[str, Any]:
|
|
23
|
+
a = action.split(".", 1)[1]
|
|
24
|
+
app = params.get("app", "")
|
|
25
|
+
if a == "diff":
|
|
26
|
+
argv = ["argocd", "app", "diff", app]
|
|
27
|
+
if params.get("revision"):
|
|
28
|
+
argv += ["--revision", params["revision"]]
|
|
29
|
+
argv += ["--hard-refresh"]
|
|
30
|
+
return argv
|
|
31
|
+
if a == "sync":
|
|
32
|
+
argv = ["argocd", "app", "sync", app]
|
|
33
|
+
if params.get("revision"):
|
|
34
|
+
argv += ["--revision", params["revision"]]
|
|
35
|
+
for r in params.get("resource", []) or []:
|
|
36
|
+
argv += ["--resource", r]
|
|
37
|
+
if dry_run or params.get("dry_run"):
|
|
38
|
+
argv += ["--dry-run"]
|
|
39
|
+
# §81 guards — prune/replace/force are never emitted here
|
|
40
|
+
return argv
|
|
41
|
+
if a == "wait":
|
|
42
|
+
argv = ["argocd", "app", "wait", app, "--health", "--sync"]
|
|
43
|
+
argv += ["--timeout", str(params.get("timeout_s", 300))]
|
|
44
|
+
return argv
|
|
45
|
+
if a == "rollback":
|
|
46
|
+
argv = ["argocd", "app", "rollback", app]
|
|
47
|
+
if params.get("history_id"):
|
|
48
|
+
argv += [str(params["history_id"])]
|
|
49
|
+
return argv
|
|
50
|
+
return super().argv_for(action, params, dry_run)
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
class KubernetesExecutor(Executor):
|
|
54
|
+
"""§82–83 — narrow actions only: scale, rollout restart/undo,
|
|
55
|
+
controlled annotate, rollout status. Every write binds
|
|
56
|
+
resourceVersion/uid preconditions when supplied; arbitrary object
|
|
57
|
+
patch does not exist."""
|
|
58
|
+
|
|
59
|
+
name = "kubernetes"
|
|
60
|
+
|
|
61
|
+
def argv_for(self, action: str, params: dict[str, Any],
|
|
62
|
+
dry_run: bool) -> list[str] | dict[str, Any]:
|
|
63
|
+
a = action.split(".", 1)[1]
|
|
64
|
+
kind, name = params.get("kind", ""), params.get("name", "")
|
|
65
|
+
target = f"{kind}/{name}"
|
|
66
|
+
ns = []
|
|
67
|
+
if params.get("namespace"):
|
|
68
|
+
ns = ["-n", params["namespace"]]
|
|
69
|
+
if params.get("context"):
|
|
70
|
+
ns += ["--context", params["context"]]
|
|
71
|
+
dr = ["--dry-run=server"] if dry_run else []
|
|
72
|
+
|
|
73
|
+
if a == "scale":
|
|
74
|
+
argv = ["kubectl", "scale", target,
|
|
75
|
+
"--replicas", str(params["replicas"])] + ns
|
|
76
|
+
if params.get("current_replicas") is not None:
|
|
77
|
+
argv += ["--current-replicas",
|
|
78
|
+
str(params["current_replicas"])]
|
|
79
|
+
if params.get("resource_version"):
|
|
80
|
+
argv += ["--resource-version",
|
|
81
|
+
str(params["resource_version"])]
|
|
82
|
+
return argv + dr
|
|
83
|
+
if a == "rollout_restart":
|
|
84
|
+
return ["kubectl", "rollout", "restart", target] + ns + dr
|
|
85
|
+
if a == "rollout_undo":
|
|
86
|
+
argv = ["kubectl", "rollout", "undo", target] + ns
|
|
87
|
+
if params.get("to_revision"):
|
|
88
|
+
argv += ["--to-revision", str(params["to_revision"])]
|
|
89
|
+
return argv + dr
|
|
90
|
+
if a == "rollout_status":
|
|
91
|
+
argv = ["kubectl", "rollout", "status", target] + ns
|
|
92
|
+
argv += ["--timeout", f"{params.get('timeout_s', 300)}s"]
|
|
93
|
+
argv += ["--watch=false"]
|
|
94
|
+
return argv
|
|
95
|
+
if a == "annotate":
|
|
96
|
+
anns = params.get("annotations", {})
|
|
97
|
+
rems = params.get("remove_annotations", []) or []
|
|
98
|
+
if not isinstance(anns, dict) or (not anns and not rems):
|
|
99
|
+
return {"refusal": "PF-OPS-ANNOTATE-EMPTY",
|
|
100
|
+
"unlock": "annotations or remove_annotations "
|
|
101
|
+
"must be non-empty"}
|
|
102
|
+
safe = {k: str(v) for k, v in anns.items()
|
|
103
|
+
if _annotation_allowed(k)}
|
|
104
|
+
safe_rems = [k for k in rems if _annotation_allowed(k)]
|
|
105
|
+
if len(safe) != len(anns) or len(safe_rems) != len(rems):
|
|
106
|
+
return {"refusal": "PF-OPS-ANNOTATE-UNSAFE",
|
|
107
|
+
"unlock": "only platformforge.io/*, "
|
|
108
|
+
"ops.platformforge.io/* annotations "
|
|
109
|
+
"or whitelisted keys are writable"}
|
|
110
|
+
argv = ["kubectl", "annotate", target] + ns
|
|
111
|
+
argv += [f"{k}={v}" for k, v in safe.items()]
|
|
112
|
+
argv += [f"{k}-" for k in safe_rems] + ["--overwrite"]
|
|
113
|
+
if params.get("resource_version"):
|
|
114
|
+
# optimistic concurrency via JSON patch precondition
|
|
115
|
+
argv = ["kubectl", "patch", target, "--type=json",
|
|
116
|
+
"-p", '[{"op":"test","path":"/metadata/'
|
|
117
|
+
'resourceVersion","value":"'
|
|
118
|
+
+ str(params["resource_version"]) + '"}]'] + ns
|
|
119
|
+
return argv + dr
|
|
120
|
+
return argv + dr
|
|
121
|
+
return super().argv_for(action, params, dry_run)
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
_ANNOTATION_PREFIXES = ("platformforge.io/", "ops.platformforge.io/",
|
|
125
|
+
"pf.io/")
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
def _annotation_allowed(key: str) -> bool:
|
|
129
|
+
return key.startswith(_ANNOTATION_PREFIXES)
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
EXECUTORS = {"git": "GitExecutor", "terraform": "TerraformExecutor",
|
|
133
|
+
"tofu": "TofuExecutor", "argocd": "ArgoCDExecutor",
|
|
134
|
+
"kubernetes": "KubernetesExecutor"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
"""Terraform / OpenTofu executor (§75–78).
|
|
2
|
+
|
|
3
|
+
Contract from upstream semantics: `plan -out=<f>` → `apply <f>` where
|
|
4
|
+
the saved plan file IS the approval target (no replanning flags at
|
|
5
|
+
apply). Before apply the executor re-runs a freshness check
|
|
6
|
+
(`plan -refresh-only -detailed-exitcode`; 2 = drift) and verifies the
|
|
7
|
+
plan file hash — stale plans refuse (§77). `terraform` and `tofu` share
|
|
8
|
+
the contract; divergent flags stay per-binary.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
import hashlib
|
|
14
|
+
from pathlib import Path
|
|
15
|
+
from typing import Any
|
|
16
|
+
|
|
17
|
+
from platformforge.ops.executors.base import Executor
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
class TerraformExecutor(Executor):
|
|
21
|
+
name = "terraform"
|
|
22
|
+
binary = "terraform"
|
|
23
|
+
|
|
24
|
+
def argv_for(self, action: str, params: dict[str, Any],
|
|
25
|
+
dry_run: bool) -> list[str] | dict[str, Any]:
|
|
26
|
+
b = self.binary
|
|
27
|
+
wd = params.get("workdir", ".")
|
|
28
|
+
a = action.split(".", 1)[1] # terraform.<verb>
|
|
29
|
+
if a == "validate":
|
|
30
|
+
return [b, "-chdir=" + wd, "validate", "-json"]
|
|
31
|
+
if a == "plan":
|
|
32
|
+
argv = [b, "-chdir=" + wd, "plan", "-input=false",
|
|
33
|
+
"-detailed-exitcode"]
|
|
34
|
+
if params.get("refresh_only"):
|
|
35
|
+
argv.append("-refresh-only")
|
|
36
|
+
if params.get("out"):
|
|
37
|
+
argv.append("-out=" + params["out"])
|
|
38
|
+
for t in params.get("target", []) or []:
|
|
39
|
+
argv.append("-target=" + t)
|
|
40
|
+
return argv
|
|
41
|
+
if a == "show":
|
|
42
|
+
return [b, "-chdir=" + wd, "show", "-json",
|
|
43
|
+
params["plan_file"]]
|
|
44
|
+
if a == "apply_saved_plan":
|
|
45
|
+
pf = params["plan_file"]
|
|
46
|
+
want = params.get("plan_hash", "")
|
|
47
|
+
if want:
|
|
48
|
+
try:
|
|
49
|
+
got = "sha256:" + hashlib.sha256(
|
|
50
|
+
Path(wd, pf).read_bytes()).hexdigest()
|
|
51
|
+
except OSError as e:
|
|
52
|
+
return {"refusal": "PF-OPS-PLAN-UNREADABLE",
|
|
53
|
+
"unlock": f"plan file unreadable: {e}"}
|
|
54
|
+
if got != want:
|
|
55
|
+
return {"refusal": "PF-OPS-PLAN-HASH-MISMATCH",
|
|
56
|
+
"unlock": "saved plan hash differs from "
|
|
57
|
+
"approval — re-plan and re-approve"}
|
|
58
|
+
return [b, "-chdir=" + wd, "apply", "-input=false",
|
|
59
|
+
pf] # the plan file IS the bound artifact
|
|
60
|
+
return super().argv_for(action, params, dry_run)
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
class TofuExecutor(TerraformExecutor):
|
|
64
|
+
name = "tofu"
|
|
65
|
+
binary = "tofu"
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
def summarize_plan(show_json: dict[str, Any]) -> dict[str, Any]:
|
|
69
|
+
"""Compact plan summary for deltas/receipts (extends iac/plan.py
|
|
70
|
+
semantics with action_reason/applyable)."""
|
|
71
|
+
changes: dict[str, int] = {}
|
|
72
|
+
destructive = []
|
|
73
|
+
for rc in show_json.get("resource_changes", []) or []:
|
|
74
|
+
acts = tuple(rc.get("change", {}).get("actions", []))
|
|
75
|
+
for a in acts:
|
|
76
|
+
changes[a] = changes.get(a, 0) + 1
|
|
77
|
+
if "delete" in acts:
|
|
78
|
+
destructive.append(rc.get("address", "?"))
|
|
79
|
+
return {"applyable": bool(show_json.get("applyable")),
|
|
80
|
+
"errored": bool(show_json.get("errored")),
|
|
81
|
+
"actions": changes,
|
|
82
|
+
"destructive_addresses": destructive,
|
|
83
|
+
"drift": [d.get("address") for d in
|
|
84
|
+
show_json.get("resource_drift", []) or []]}
|