chore: align tooling and add package docs

- bump common to v0.2.1 (gofumpt v0.10 + k8s pkg doc)
- bump go directive to 1.25.6 (matches go.work)
- add // Package X docs to admission, affinity, metrics, main
- gofumpt v0.10: split first arg of multi-line admission/workload_validator call

Author: CMGS

admission/server.go

@@ -1,3 +1,5 @@
+// Package admission implements the cocoon-webhook mutate and validate
+// handlers (pods, workloads, and CocoonSet CRs).
 package admission
 
 import (

admission/workload_validator.go

@@ -156,7 +156,8 @@ func checkScaleDown(ctx context.Context, req *admissionv1.AdmissionRequest, oldR
 	msg := fmt.Sprintf(
 		"cocoon-webhook: scale-down blocked for cocoon %s %s/%s (%d -> %d). "+
 			"Use a CocoonHibernation CR to suspend individual agents.",
-		req.Kind.Kind, req.Namespace, req.Name, oldReplicas, newReplicas)
+		req.Kind.Kind, req.Namespace, req.Name, oldReplicas, newReplicas,
+	)
 	logger.Warn(ctx, msg)
 	metrics.RecordAdmission(metrics.HandlerValidate, metrics.DecisionDeny)
 	return commonadmission.Deny(msg)

affinity/store.go

@@ -1,3 +1,5 @@
+// Package affinity reserves and releases cocoon node-affinity slots,
+// persisted as ConfigMaps so the assignment survives webhook restarts.
 package affinity
 
 import (

go.mod

@@ -1,9 +1,9 @@
 module github.com/cocoonstack/cocoon-webhook
 
-go 1.25.0
+go 1.25.6
 
 require (
-	github.com/cocoonstack/cocoon-common v0.1.10-0.20260423175920-c8cd308978cb
+	github.com/cocoonstack/cocoon-common v0.2.1-0.20260506143712-eaa6e94cf830
 	github.com/projecteru2/core v0.0.0-20241016125006-ff909eefe04c
 	github.com/prometheus/client_golang v1.23.2
 	k8s.io/api v0.35.3

go.sum

@@ -29,6 +29,10 @@ github.com/cockroachdb/redact v1.1.3 h1:AKZds10rFSIj7qADf0g46UixK8NNLwWTNdCIGS5w
 github.com/cockroachdb/redact v1.1.3/go.mod h1:BVNblN9mBWFyMyqK1k3AAiSxhvhfK2oOZZ2lK+dpvRg=
 github.com/cocoonstack/cocoon-common v0.1.10-0.20260423175920-c8cd308978cb h1:s31sByTK+6ik1BOaAirpKZ1O9q3OSzT8kAiECci5T0k=
 github.com/cocoonstack/cocoon-common v0.1.10-0.20260423175920-c8cd308978cb/go.mod h1:cjBGOeZvsw2J5X7RIQJ44PJx0QiwgypEJVdd5V38arU=
+github.com/cocoonstack/cocoon-common v0.2.1-0.20260506141504-3f9473d6ec7c h1:lko3TWi0tqiraB4sK0urz2lxxVjaFNzx2QvRHdlynOw=
+github.com/cocoonstack/cocoon-common v0.2.1-0.20260506141504-3f9473d6ec7c/go.mod h1:xIXbJ83vngQ2mrLC6q0Tw7h21M9BYBBqqYTcHaUrm1Y=
+github.com/cocoonstack/cocoon-common v0.2.1-0.20260506143712-eaa6e94cf830 h1:L7OIAjWwvBiFH3QwLTJRF1khFW2KjyyZyPKDfotP5NY=
+github.com/cocoonstack/cocoon-common v0.2.1-0.20260506143712-eaa6e94cf830/go.mod h1:xIXbJ83vngQ2mrLC6q0Tw7h21M9BYBBqqYTcHaUrm1Y=
 github.com/codegangsta/inject v0.0.0-20150114235600-33e0aa1cb7c0/go.mod h1:4Zcjuz89kmFXt9morQgcfYZAYZ5n8WHjt81YYWIwtTM=
 github.com/coreos/etcd v3.3.10+incompatible/go.mod h1:uF7uidLiAD3TWHmW31ZFd/JWoc32PjwdhPthX9715RE=
 github.com/coreos/go-etcd v2.0.0+incompatible/go.mod h1:Jez6KQU2B/sWsbdaef3ED8NzMklzPG4d5KIOhIy30Tk=

main.go

@@ -1,3 +1,6 @@
+// Package main is the cocoon-webhook entry point. The webhook handles
+// admission review for cocoon pods, workloads, and CocoonSet CRs, and
+// owns the per-pool node-affinity reservation store.
 package main
 
 import (

metrics/metrics.go

@@ -1,3 +1,4 @@
+// Package metrics exposes cocoon-webhook Prometheus counters.
 package metrics
 
 import (