Browsable Markdown reference, regenerated from the Go types on every make -C operators manifests:
v1alpha1.md— all eight kinds, every field, every validation marker.
The source of truth is the Go types in operators/api/{platform,agents,governance}/v1alpha1/ plus the generated manifests in operators/config/crd/bases/; this Markdown is a rendered view of them.
Each Go type carries:
- kubebuilder validation markers (regex / enum / minimum / pattern constraints),
- kubebuilder default markers,
- per-field godoc explaining intent.
The generated YAML manifests are the operational truth — they're what gets applied to the cluster and what the apiserver validates kubectl apply against.
| Kind | Group | Scope | Go type | Generated CRD manifest |
|---|---|---|---|---|
Tenant |
platform.nanohype.dev |
Cluster | tenant_types.go |
platform.nanohype.dev_tenants.yaml |
Platform |
platform.nanohype.dev |
Namespaced | platform_types.go |
platform.nanohype.dev_platforms.yaml |
ModelGateway (+ ModelRoute) |
agents.nanohype.dev |
Namespaced | modelgateway_types.go |
agents.nanohype.dev_modelgateways.yaml |
AgentFleet (+ Agent, ScalingSpec) |
agents.nanohype.dev |
Namespaced | agentfleet_types.go |
agents.nanohype.dev_agentfleets.yaml |
AgentSandbox |
agents.nanohype.dev |
Namespaced | agentsandbox_types.go |
agents.nanohype.dev_agentsandboxes.yaml |
SandboxPool (+ SandboxScalingSpec) |
agents.nanohype.dev |
Namespaced | sandboxpool_types.go |
agents.nanohype.dev_sandboxpools.yaml |
BatchJob |
agents.nanohype.dev |
Namespaced | batchjob_types.go |
agents.nanohype.dev_batchjobs.yaml |
BudgetPolicy |
governance.nanohype.dev |
Namespaced | budgetpolicy_types.go |
governance.nanohype.dev_budgetpolicies.yaml |
EvalSuite |
governance.nanohype.dev |
Namespaced | evalsuite_types.go |
governance.nanohype.dev_evalsuites.yaml |
Regenerate manifests + DeepCopy: make -C operators manifests (also copies to charts/operator/crds/).
Read the Go types directly — godoc comments are the canonical field description. go doc against any of the type files renders the field-by-field reference at terminal speed.
v1alpha1.md is rendered by elastic/crd-ref-docs, wired into the manifests target (config: operators/hack/crd-ref-docs.yaml). Whenever you edit kubebuilder annotations or godoc on a type, make -C operators manifests regenerates CRDs, copies them into the Helm chart, and re-renders this Markdown — no manual sync needed.