swiftkube · iabudiab · May 4, 2026 · Mar 29, 2026 · Mar 29, 2026 · Mar 29, 2026
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,6 @@
 .DS_Store
+/.claude/settings.local.json
+/.vscode
 /.build
 /Packages
 /*.xcodeproj

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1,51 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+SwiftkubeModel is a zero-dependency Swift package providing Codable, Hashable, Sendable model structs for all Kubernetes API objects. Currently tracks Kubernetes v1.33.3.
+
+## Build & Test Commands
+
+```bash
+swift build              # Build the package
+swift test               # Run all tests
+swift test --filter SwiftkubeModelTests.GroupVersionKindTests  # Run a single test class
+swift format -i Sources/ Tests/  # Format code
+```
+
+## Architecture
+
+### Code Generation
+
+Most files under `Sources/Model/` are **generated** by an external tool called `Swiftkube:ModelGen` (not in this repo). Generated files have this header comment:
+```
+// Generated by Swiftkube:ModelGen
+// Kubernetes v1.33.3
+```
+Do not manually edit generated files unless you understand they will be overwritten on the next generation run.
+
+### Source Layout
+
+- **`Sources/Model/<group>/<version>/`** — Generated Kubernetes API structs, one file per type. Files follow the naming convention `TypeName+group.version.swift` (e.g., `Pod+core.v1.swift`). Each API group is a Swift namespace enum (e.g., `core.v1`, `apps.v1`, `networking.v1beta1`).
+
+- **`Sources/Model/`** (top-level files) — Core infrastructure:
+  - `KubernetesResource.swift` — Protocol hierarchy: `KubernetesResource` → `MetadataHavingResource` → `KubernetesAPIResource`, plus capability marker protocols (`NamespacedResource`, `ClusterScopedResource`, `ReadableResource`, `ListableResource`, `CreatableResource`, `DeletableResource`, etc.)
+  - `GroupVersionKind.swift` / `GroupVersionResource.swift` — GVK/GVR types and their lookup tables (`+DefaultResources`, `+KubernetesAPIResource`, `+Meta`, `+ResourceName`)
+  - `UnstructuredResource.swift` — Type-erased resource for unknown/CRD types
+  - `IntOrString.swift`, `Quantity.swift`, `JSONObject.swift` — Special Kubernetes types
+
+- **`Sources/Builders/`** — Closure-based builder functions under the `sk` namespace enum. Only covers common types (core/v1, apps/v1, meta/v1).
+
+- **`Sources/Codable/`** — Custom encoding/decoding support (`Any+Codable.swift`, `NullWrapper.swift`).
+
+- **`Sources/Extensions/`** — Convenience extensions on model types and `Hashes.swift` for Hashable conformance.
+
+### Key Patterns
+
+- All resources are `Codable`, `Hashable`, and `Sendable` structs.
+- API resources use `var` properties (not `let`) for mutability.
+- `apiVersion` and `kind` are `let` constants with default values on each API resource struct.
+- Resources with `JSONObject` fields (dictionary-backed) store values as `Dictionary<String, any Sendable>`.
+- The `sk` enum provides builder functions that use `inout` closure patterns via the internal `build(_:with:)` helper.
diff --git a/Sources/Builders/Builders.swift b/Sources/Builders/Builders.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 // MARK: - sk
 

diff --git a/Sources/Builders/apps/v1/appsV1+Deployment.swift b/Sources/Builders/apps/v1/appsV1+Deployment.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+ConfigMap.swift b/Sources/Builders/core/v1/coreV1+ConfigMap.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+Container.swift b/Sources/Builders/core/v1/coreV1+Container.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+Namespace.swift b/Sources/Builders/core/v1/coreV1+Namespace.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+Node.swift b/Sources/Builders/core/v1/coreV1+Node.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+ObjectReference.swift b/Sources/Builders/core/v1/coreV1+ObjectReference.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+Pod.swift b/Sources/Builders/core/v1/coreV1+Pod.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+Secret.swift b/Sources/Builders/core/v1/coreV1+Secret.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+Service.swift b/Sources/Builders/core/v1/coreV1+Service.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+ServiceAccount.swift b/Sources/Builders/core/v1/coreV1+ServiceAccount.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/core/v1/coreV1+Volume.swift b/Sources/Builders/core/v1/coreV1+Volume.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/meta/v1/metaV1+Metadata.swift b/Sources/Builders/meta/v1/metaV1+Metadata.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/meta/v1/metaV1+Selector.swift b/Sources/Builders/meta/v1/metaV1+Selector.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Builders/meta/v1/metaV1+Status.swift b/Sources/Builders/meta/v1/metaV1+Status.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension sk {
 

diff --git a/Sources/Codable/Any+Codable.swift b/Sources/Codable/Any+Codable.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 // MARK: - JSONCodingKeys
 

diff --git a/Sources/Extensions/CronJobExtensions+batch.v1.swift b/Sources/Extensions/CronJobExtensions+batch.v1.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 public extension batch.v1.CronJob {
 	func generateJob(withName name: String = "manual") throws -> batch.v1.Job {

diff --git a/Sources/Extensions/Hashes.swift b/Sources/Extensions/Hashes.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 /// GenerateRandomHash returns a three character. I
 func GenerateRandomHash(length: Int) -> String {

diff --git a/Sources/Model/GroupVersionKind.swift b/Sources/Model/GroupVersionKind.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 // MARK: - GroupVersionKind
 

diff --git a/Sources/Model/GroupVersionResource.swift b/Sources/Model/GroupVersionResource.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 // MARK: - GroupVersionResource
 

diff --git a/Sources/Model/IntOrString.swift b/Sources/Model/IntOrString.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 // MARK: - IntOrString
 

diff --git a/Sources/Model/JSONObject.swift b/Sources/Model/JSONObject.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 // MARK: - JSONObject
 

diff --git a/Sources/Model/KubernetesResource.swift b/Sources/Model/KubernetesResource.swift
@@ -14,7 +14,11 @@
 // limitations under the License.
 //
 
+#if canImport(FoundationEssentials)
+import FoundationEssentials
+#else
 import Foundation
+#endif
 
 // MARK: - KubernetesResource