feat: implement statefulset primitive

Makefile

@@ -115,6 +115,7 @@ build-examples: ## Build all example binaries.
 run-examples: ## Run all examples to verify they execute without error.
 	go run ./examples/deployment-primitive/.
 	go run ./examples/configmap-primitive/.
+	go run ./examples/statefulset-primitive/.
 	go run ./examples/custom-resource-implementation/.
 
 

docs/primitives.md

@@ -124,13 +124,14 @@ This design:
 
 Editors provide scoped, typed APIs for modifying specific parts of a resource:
 
-| Editor                 | Scope                                                                   |
-| ---------------------- | ----------------------------------------------------------------------- |
-| `ContainerEditor`      | Environment variables, arguments, resource limits, ports                |
-| `PodSpecEditor`        | Volumes, tolerations, node selectors, service account, security context |
-| `DeploymentSpecEditor` | Replicas, update strategy, label selectors                              |
-| `ConfigMapDataEditor`  | `.data` entries — set, remove, deep-merge YAML patches, raw access      |
-| `ObjectMetaEditor`     | Labels and annotations on any Kubernetes object                         |
+| Editor                  | Scope                                                                   |
+| ----------------------- | ----------------------------------------------------------------------- |
+| `ContainerEditor`       | Environment variables, arguments, resource limits, ports                |
+| `PodSpecEditor`         | Volumes, tolerations, node selectors, service account, security context |
+| `DeploymentSpecEditor`  | Replicas, update strategy, label selectors                              |
+| `StatefulSetSpecEditor` | Replicas, service name, pod management policy, update strategy          |
+| `ConfigMapDataEditor`   | `.data` entries — set, remove, deep-merge YAML patches, raw access      |
+| `ObjectMetaEditor`      | Labels and annotations on any Kubernetes object                         |
 
 Every editor exposes a `.Raw()` method for cases where the typed API is insufficient, giving direct access to the
 underlying Kubernetes struct while keeping the mutation scoped to that editor's target.
@@ -151,10 +152,11 @@ have been applied. This means a single mutation can safely add a container and t
 
 ## Built-in Primitives
 
-| Primitive                   | Category | Documentation                             |
-| --------------------------- | -------- | ----------------------------------------- |
-| `pkg/primitives/deployment` | Workload | [deployment.md](primitives/deployment.md) |
-| `pkg/primitives/configmap`  | Static   | [configmap.md](primitives/configmap.md)   |
+| Primitive                    | Category | Documentation                               |
+| ---------------------------- | -------- | ------------------------------------------- |
+| `pkg/primitives/deployment`  | Workload | [deployment.md](primitives/deployment.md)   |
+| `pkg/primitives/statefulset` | Workload | [statefulset.md](primitives/statefulset.md) |
+| `pkg/primitives/configmap`   | Static   | [configmap.md](primitives/configmap.md)     |
 
 ## Usage Examples