Public: anyone can read this; nobody can change it.

POL-0: Kyverno policy-governance model (design) — plat/mitosis#38 #49

Merged opened this view on origin

Check · Review · Land done · Live — Landed; nothing deploys from this branch, so this is the end of its path.

Merged

Governance-of-governance doc that gates the whole Kyverno track (POL-1..POL-5). Design only — no code. Adds docs/proposals/policy-governance-kyverno.md.

Notes

shipped merged

opened this view on origin

POL-0: Kyverno policy-governance model (design only)

Governance-of-governance doc that gates the whole Kyverno track (POL-1..POL-5). Design only — no code. Adds docs/proposals/policy-governance-kyverno.md.

Framing (held): Kyverno is the deterministic backend (validate/mutate/generate/verifyImages, with generate synchronize:true reverting tampering). The agent authoring policy YAML from an NL prompt is the frontend. Kyverno is not a language-to-system compiler. Today all governance is hand-rolled TS in overlayManifests() (mcp/src/server.ts:2182), rendered once with no drift correction; adding Kyverno is a cheap Flux seam (dependsOn: cert-manager).

Decisions (each with a recommendation + tradeoff):

  1. Policy repo location — recommend a separate policy repo (stricter reviewer set), CODEOWNERS-gated gitops path as bootstrap.
  2. Agent write access — recommend propose-only via human-merged PR, never direct write; per-category yes/no (quota tier: propose; default-deny / PSA / RBAC / failurePolicy: human-only). Tied to RBAC-1.
  3. enforce vs audit — recommend audit-first for new policies (parity migrations of existing TS may ship enforce); generate drift-correction is not delayed.
  4. failurePolicy — recommend fail-closed (Fail), narrowly scoped + HA + break-glass + a kill-the-webhook test, matching authorize() (server.ts:987).

Invariants enumerated so POL-1..POL-5 become buildable: POL-1 baselines; POL-2 generate-migration of overlayManifests(); POL-3 verifyImages/cosign; POL-4 secrets+domains+network; POL-5 RBAC.

Do not merge — for review.

roadmap POL-0 (#38)

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs