openshift-hyperfleet · yasun1 · Dec 4, 2025 · Dec 3, 2025
diff --git a/main.tsp b/main.tsp
@@ -23,3 +23,9 @@ using OpenAPI;
 @route("/api/hyperfleet/v1")
 namespace HyperFleet;
 
+// Override BearerAuth to use lowercase "bearer" as required by kin-openapi
+model BearerAuth {
+  type: AuthType.http;
+  scheme: "bearer";
+}
+
diff --git a/models-core/cluster/example_cluster.tsp b/models-core/cluster/example_cluster.tsp
@@ -12,14 +12,14 @@ const exampleCluster: Cluster = #{
   updated_time: "2021-01-01T00:00:00Z",
   generation: 1,
   status: #{
-    phase: "Ready",
+    phase: ResourcePhase.Ready,
     last_transition_time: "2021-01-01T00:00:00Z",
     observed_generation: 1,
     last_updated_time: "2021-01-01T00:00:00Z",
     conditions: #[
       #{
         type: "ValidationSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "All validations passed",
         message: "All 30 validation tests passed",
         observed_generation: 1,
@@ -29,7 +29,7 @@ const exampleCluster: Cluster = #{
       },
       #{
         type: "DNSSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "DNS configured",
         message: "DNS records created for custom.domain.com",
         observed_generation: 1,

diff --git a/models-core/nodepool/example_nodepool.tsp b/models-core/nodepool/example_nodepool.tsp
@@ -18,14 +18,14 @@ const exampleNodePool: NodePool = #{
     href: "https://api.hyperfleet.com/v1/clusters/cluster-123",
   },
   status: #{
-    phase: "Ready",
+    phase: ResourcePhase.Ready,
     last_transition_time: "2021-01-01T10:00:00Z",
     observed_generation: 1,
     last_updated_time: "2021-01-01T10:02:00Z",
     conditions: #[
       #{
         type: "ValidationSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "All validations passed",
         message: "NodePool validation passed",
         observed_generation: 1,
@@ -35,7 +35,7 @@ const exampleNodePool: NodePool = #{
       },
       #{
         type: "NodePoolSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "NodePool provisioned successfully",
         message: "NodePool has been scaled to desired count",
         observed_generation: 1,

diff --git a/models-gcp/cluster/example_cluster.tsp b/models-gcp/cluster/example_cluster.tsp
@@ -34,14 +34,14 @@ const exampleCluster: Cluster = #{
   updated_time: "2021-01-01T00:00:00Z",
   generation: 1,
   status: #{
-    phase: "Ready",
+    phase: ResourcePhase.Ready,
     last_transition_time: "2021-01-01T00:00:00Z",
     observed_generation: 1,
     last_updated_time: "2021-01-01T00:00:00Z",
     conditions: #[
       #{
         type: "ValidationSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "All validations passed",
         message: "All 30 validation tests passed",
         observed_generation: 1,
@@ -51,7 +51,7 @@ const exampleCluster: Cluster = #{
       },
       #{
         type: "DNSSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "DNS configured",
         message: "DNS records created for custom.domain.com",
         observed_generation: 1,

diff --git a/models-gcp/nodepool/example_nodepool.tsp b/models-gcp/nodepool/example_nodepool.tsp
@@ -40,14 +40,14 @@ const exampleNodePool: NodePool = #{
     href: "https://api.hyperfleet.com/v1/clusters/cluster-123",
   },
   status: #{
-    phase: "Ready",
+    phase: ResourcePhase.Ready,
     last_transition_time: "2021-01-01T10:00:00Z",
     observed_generation: 1,
     last_updated_time: "2021-01-01T10:02:00Z",
     conditions: #[
       #{
         type: "ValidationSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "All validations passed",
         message: "NodePool validation passed",
         observed_generation: 1,
@@ -57,7 +57,7 @@ const exampleNodePool: NodePool = #{
       },
       #{
         type: "NodePoolSuccessful",
-        status: "True",
+        status: ConditionStatus.True,
         reason: "NodePool provisioned successfully",
         message: "NodePool has 3 nodes running",
         observed_generation: 1,

diff --git a/models/clusters/model.tsp b/models/clusters/model.tsp
@@ -34,7 +34,7 @@ model ClusterStatus {
    * Updated when conditions are reported.
    * Note: status.phase provides aggregated view from all conditions.
    */
-  phase: "NotReady" | "Ready" | "Failed";
+  phase: ResourcePhase;
 
   /**
    * When cluster last transitioned (used by Sentinel for backoff)

diff --git a/models/common/model.tsp b/models/common/model.tsp
@@ -10,6 +10,15 @@ alias KindClusterStatus = "ClusterStatus";
 alias KindNodePoolStatus = "NodePoolStatus";
 alias KindNodePool = "NodePool";
 
+/**
+ * Phase of a resource (Cluster or NodePool)
+ */
+enum ResourcePhase {
+    NotReady,
+    Ready,
+    Failed,
+}
+
 model ID {
     /** Resource identifier */
     id?: Identifier;
@@ -47,6 +56,14 @@ model Error {
     code?: string;
     reason?: string;
     operation_id?: string;
+
+    /** Field-level validation errors (optional) */
+    details?: {
+        /** Field path that failed validation */
+        field?: string;
+        /** Validation error message for this field */
+        error?: string;
+    }[];
 }
 
 model ErrorResponse<Kind, ErrorCode> {
@@ -94,7 +111,7 @@ model QueryParams extends SearchParams {
     orderBy?: string = "created_time";
 
     @query
-    order?: OrderDirection = OrderDirection.desc;
+    order?: OrderDirection;
 }
 
 model List {

diff --git a/models/nodepools/model.tsp b/models/nodepools/model.tsp
@@ -27,7 +27,7 @@ model NodePoolStatus {
    * Updated when conditions are reported.
    * Note: status.phase provides aggregated view from all conditions.
    */
-  phase: "NotReady" | "Ready" | "Failed";
+  phase: ResourcePhase;
 
   /**
    * Last generation processed

diff --git a/models/statuses/example_adapter_status.tsp b/models/statuses/example_adapter_status.tsp
@@ -7,21 +7,21 @@ const exampleAdapterStatus: AdapterStatus = (#{
   conditions: #[
     #{
       type: "Available",
-      status: "True",
+      status: ConditionStatus.True,
       reason: "All validations passed",
       message: "All 30 validation tests passed",
       last_transition_time: "2021-01-01T10:00:00Z",
     },
     #{
       type: "Applied",
-      status: "True",
+      status: ConditionStatus.True,
       reason: "Validation job applied",
       message: "Validation job applied successfully",
       last_transition_time: "2021-01-01T10:00:00Z",
     },
     #{
       type: "Health",
-      status: "True",
+      status: ConditionStatus.True,
       reason: "All adapter operations completed successfully",
       message: "All adapter runtime operations completed successfully",
       last_transition_time: "2021-01-01T10:00:00Z",
@@ -54,19 +54,19 @@ const exampleAdapterStatusCreateRequest: AdapterStatusCreateRequest = (#{
   conditions: #[
     #{
       type: "Available",
-      status: "True",
+      status: ConditionStatus.True,
       reason: "All validations passed",
       message: "All 30 validation tests passed",
     },
     #{
       type: "Applied",
-      status: "True",
+      status: ConditionStatus.True,
       reason: "Validation job applied",
       message: "Validation job applied successfully",
     },
     #{
       type: "Health",
-      status: "True",
+      status: ConditionStatus.True,
       reason: "All adapter operations completed successfully",
       message: "All adapter runtime operations completed successfully",
     }
@@ -101,7 +101,7 @@ const exampleAdapterStatusList: AdapterStatusList = (#{
       conditions: #[
         #{
           type: "Available",
-          status: "True",
+          status: ConditionStatus.True,
           reason: "All validations passed",
           message: "All 30 validation tests passed",
           last_transition_time: "2021-01-01T10:00:00Z",
@@ -120,7 +120,7 @@ const exampleAdapterStatusList: AdapterStatusList = (#{
       conditions: #[
         #{
           type: "Available",
-          status: "True",
+          status: ConditionStatus.True,
           reason: "DNS configured",
           message: "DNS records created",
           last_transition_time: "2021-01-01T10:01:00Z",

diff --git a/models/statuses/model.tsp b/models/statuses/model.tsp
@@ -1,6 +1,15 @@
 import "../common/model.tsp";
 import "./example_adapter_status.tsp";
 
+/**
+ * Status value for conditions
+ */
+enum ConditionStatus {
+    True: "True",
+    False: "False",
+    Unknown,
+}
+
 /**
  * Base condition fields shared by all condition types
  */
@@ -13,7 +22,7 @@ model ConditionBase {
   /**
    * Condition status
    */
-  status: "True" | "False" | "Unknown";
+  status: ConditionStatus;
 
   /**
    * Machine-readable reason code
@@ -72,7 +81,7 @@ model ResourceCondition extends ConditionBase {
  */
 model ConditionRequest {
   type: string;
-  status: "True" | "False" | "Unknown";
+  status: ConditionStatus;
   reason?: string;
   message?: string;
 }
@@ -153,6 +162,5 @@ model AdapterStatusCreateRequest extends AdapterStatusBase {
  */
 @example(exampleAdapterStatusList)
 model AdapterStatusList extends List {
-  kind: "AdapterStatusList";
   items: AdapterStatus[];
 }