Merge pull request #38 from rafabene/HYPERFLEET-1017-rename-available-to-last-known-reconciled

openshift-merge-bot[bot] · web-flow · commit 6f87b76f6aed · 2026-05-07T15:45:19.000Z
HYPERFLEET-1017 - feat: rename aggregated condition Available to LastKnownReconciled
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -15,6 +15,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Renamed aggregated condition `Available` to `LastKnownReconciled` in cluster and nodepool status conditions (HYPERFLEET-1017)
+- Updated condition examples and descriptions to reflect `LastKnownReconciled` semantics
+- Fixed typo `Avaliable` → `Available` in adapter example constants (HYPERFLEET-971)
 - Improved README.md structure to align with HyperFleet documentation standards
 
 ## [1.0.10] - 2026-05-05
diff --git a/aliases.tsp b/aliases.tsp
@@ -1 +1 @@
-aliases-core.tsp
+aliases-gcp.tsp
diff --git a/main.tsp b/main.tsp
@@ -20,7 +20,7 @@ using OpenAPI;
  *
  */
 @service(#{ title: "HyperFleet API" })
-@info(#{ version: "1.0.10", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })
+@info(#{ version: "1.0.11", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })
 @server("https://hyperfleet.redhat.com", "Production")
 @route("/api/hyperfleet/v1")
 namespace HyperFleet;
diff --git a/models-core/cluster/example_cluster.tsp b/models-core/cluster/example_cluster.tsp
@@ -33,10 +33,10 @@ const exampleCluster: Cluster = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 1,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
@@ -101,10 +101,10 @@ const exampleDeletedCluster: Cluster = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 2,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
diff --git a/models-core/nodepool/example_nodepool.tsp b/models-core/nodepool/example_nodepool.tsp
@@ -38,10 +38,10 @@ const exampleNodePool: NodePool = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 1,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
@@ -111,10 +111,10 @@ const exampleDeletedNodePool: NodePool = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 2,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
diff --git a/models-gcp/cluster/example_cluster.tsp b/models-gcp/cluster/example_cluster.tsp
@@ -55,10 +55,10 @@ const exampleCluster: Cluster = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 1,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
@@ -145,10 +145,10 @@ const exampleDeletedCluster: Cluster = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 2,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
diff --git a/models-gcp/nodepool/example_nodepool.tsp b/models-gcp/nodepool/example_nodepool.tsp
@@ -60,10 +60,10 @@ const exampleNodePool: NodePool = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 1,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
@@ -155,10 +155,10 @@ const exampleDeletedNodePool: NodePool = #{
         last_transition_time: "2021-01-01T10:00:00Z",
       },
       #{
-        type: ConditionType.Available,
+        type: ConditionType.LastKnownReconciled,
         status: ResourceConditionStatus.True,
-        reason: ExampleAvailableReason,
-        message: ExampleAvailableMessage,
+        reason: ExampleLastKnownReconciledReason,
+        message: ExampleLastKnownReconciledMessage,
         observed_generation: 2,
         created_time: "2021-01-01T10:00:00Z",
         last_updated_time: "2021-01-01T10:00:00Z",
diff --git a/models/clusters/model.tsp b/models/clusters/model.tsp
@@ -35,7 +35,7 @@ model ClusterStatus {
    * **Mandatory conditions**: 
    * - `type: "Ready"` *(deprecated — use Reconciled)*: Whether all adapters report successfully at the current generation.
    * - `type: "Reconciled"`: Whether the resource's desired state has been fully reconciled by all adapters at the current generation.
-   * - `type: "Available"`: Aggregated adapter result for a common observed_generation.   
+   * - `type: "LastKnownReconciled"`: Sticky cross-generation condition — stays True as long as all required adapters were reconciled at a common observed generation, even if a newer generation is being processed.
    * 
    * These conditions are present immediately upon resource creation.
    */
diff --git a/models/common/model.tsp b/models/common/model.tsp
@@ -177,7 +177,8 @@ union ConditionType {
     string,
     Available: "Available",
     Ready: "Ready",
-    Reconciled: "Reconciled"
+    Reconciled: "Reconciled",
+    LastKnownReconciled: "LastKnownReconciled"
 }
 
 /**
@@ -243,8 +244,8 @@ model ResourceCondition {
   @format("date-time") last_updated_time: string;
 }
 
-    const ExampleAvailableReason: string = "All adapters reported Available True for the same generation";
-    const ExampleAvailableMessage: string = "All adapters reported Available True for the same generation";
+    const ExampleLastKnownReconciledReason: string = "All required adapters were reconciled at a common observed generation";
+    const ExampleLastKnownReconciledMessage: string = "All required adapters were reconciled at a common observed generation";
     const ExampleReadyReason: string = "All adapters reported Available=True for the current generation";
     const ExampleReadyMessage: string = "All adapters reported Available=True for the current generation";
     const ExampleReconciledReason: string = "All required adapters reported Available=True or Finalized=True at the current generation";
diff --git a/models/nodepools/model.tsp b/models/nodepools/model.tsp
@@ -32,7 +32,7 @@ model NodePoolStatus {
    * **Mandatory conditions**: 
    * - `type: "Ready"` *(deprecated — use Reconciled)*: Whether all adapters report successfully at the current generation.
    * - `type: "Reconciled"`: Whether the resource's desired state has been fully reconciled by all adapters at the current generation.
-   * - `type: "Available"`: Aggregated adapter result for a common observed_generation.   
+   * - `type: "LastKnownReconciled"`: Sticky cross-generation condition — stays True as long as all required adapters were reconciled at a common observed generation, even if a newer generation is being processed.
    * 
    * These conditions are present immediately upon resource creation.
    */
diff --git a/schemas/core/openapi.yaml b/schemas/core/openapi.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: HyperFleet API
-  version: 1.0.10
+  version: 1.0.11
   contact:
     name: HyperFleet Team
   license:
@@ -50,7 +50,7 @@ paths:
 
         **Note**: The `status` object in the response is read-only and computed by the service.
         It is NOT part of the request body. Initially,
-        status.conditions will include mandatory "Available", "Ready" and "Reconciled" conditions.
+        status.conditions will include mandatory "LastKnownReconciled", "Ready" and "Reconciled" conditions.
       parameters: []
       responses:
         '201':
@@ -189,10 +189,10 @@ paths:
                       created_time: '2021-01-01T10:00:00Z'
                       last_updated_time: '2021-01-01T10:00:00Z'
                       last_transition_time: '2021-01-01T10:00:00Z'
-                    - type: Available
+                    - type: LastKnownReconciled
                       status: 'True'
-                      reason: All adapters reported Available True for the same generation
-                      message: All adapters reported Available True for the same generation
+                      reason: All required adapters were reconciled at a common observed generation
+                      message: All required adapters were reconciled at a common observed generation
                       observed_generation: 2
                       created_time: '2021-01-01T10:00:00Z'
                       last_updated_time: '2021-01-01T10:00:00Z'
@@ -394,10 +394,10 @@ paths:
                       created_time: '2021-01-01T10:00:00Z'
                       last_updated_time: '2021-01-01T10:00:00Z'
                       last_transition_time: '2021-01-01T10:00:00Z'
-                    - type: Available
+                    - type: LastKnownReconciled
                       status: 'True'
-                      reason: All adapters reported Available True for the same generation
-                      message: All adapters reported Available True for the same generation
+                      reason: All required adapters were reconciled at a common observed generation
+                      message: All required adapters were reconciled at a common observed generation
                       observed_generation: 2
                       created_time: '2021-01-01T10:00:00Z'
                       last_updated_time: '2021-01-01T10:00:00Z'
@@ -1146,10 +1146,10 @@ components:
               created_time: '2021-01-01T10:00:00Z'
               last_updated_time: '2021-01-01T10:00:00Z'
               last_transition_time: '2021-01-01T10:00:00Z'
-            - type: Available
+            - type: LastKnownReconciled
               status: 'True'
-              reason: All adapters reported Available True for the same generation
-              message: All adapters reported Available True for the same generation
+              reason: All required adapters were reconciled at a common observed generation
+              message: All required adapters were reconciled at a common observed generation
               observed_generation: 1
               created_time: '2021-01-01T10:00:00Z'
               last_updated_time: '2021-01-01T10:00:00Z'
@@ -1270,7 +1270,7 @@ components:
             **Mandatory conditions**: 
             - `type: "Ready"` *(deprecated — use Reconciled)*: Whether all adapters report successfully at the current generation.
             - `type: "Reconciled"`: Whether the resource's desired state has been fully reconciled by all adapters at the current generation.
-            - `type: "Available"`: Aggregated adapter result for a common observed_generation.   
+            - `type: "LastKnownReconciled"`: Sticky cross-generation condition — stays True as long as all required adapters were reconciled at a common observed generation, even if a newer generation is being processed.
 
             These conditions are present immediately upon resource creation.
       description: |-
@@ -1445,10 +1445,10 @@ components:
               created_time: '2021-01-01T10:00:00Z'
               last_updated_time: '2021-01-01T10:00:00Z'
               last_transition_time: '2021-01-01T10:00:00Z'
-            - type: Available
+            - type: LastKnownReconciled
               status: 'True'
-              reason: All adapters reported Available True for the same generation
-              message: All adapters reported Available True for the same generation
+              reason: All required adapters were reconciled at a common observed generation
+              message: All required adapters were reconciled at a common observed generation
               observed_generation: 1
               created_time: '2021-01-01T10:00:00Z'
               last_updated_time: '2021-01-01T10:00:00Z'
@@ -1636,7 +1636,7 @@ components:
             **Mandatory conditions**: 
             - `type: "Ready"` *(deprecated — use Reconciled)*: Whether all adapters report successfully at the current generation.
             - `type: "Reconciled"`: Whether the resource's desired state has been fully reconciled by all adapters at the current generation.
-            - `type: "Available"`: Aggregated adapter result for a common observed_generation.   
+            - `type: "LastKnownReconciled"`: Sticky cross-generation condition — stays True as long as all required adapters were reconciled at a common observed generation, even if a newer generation is being processed.
 
             These conditions are present immediately upon resource creation.
       description: |-
diff --git a/schemas/core/swagger.yaml b/schemas/core/swagger.yaml
@@ -16,7 +16,7 @@ info:
     name: Apache 2.0
     url: 'https://www.apache.org/licenses/LICENSE-2.0'
   title: HyperFleet API
-  version: 1.0.10
+  version: 1.0.11
 host: hyperfleet.redhat.com
 basePath: /
 schemes:
@@ -112,8 +112,8 @@ paths:
 
         It is NOT part of the request body. Initially,
 
-        status.conditions will include mandatory "Available", "Ready" and
-        "Reconciled" conditions.
+        status.conditions will include mandatory "LastKnownReconciled", "Ready"
+        and "Reconciled" conditions.
       operationId: postCluster
       summary: Create cluster
   '/api/hyperfleet/v1/clusters/{cluster_id}':
@@ -177,14 +177,14 @@ paths:
                     last_transition_time: '2021-01-01T10:00:00Z'
                     last_updated_time: '2021-01-01T10:00:00Z'
                     message: >-
-                      All adapters reported Available True for the same
+                      All required adapters were reconciled at a common observed
                       generation
                     observed_generation: 2
                     reason: >-
-                      All adapters reported Available True for the same
+                      All required adapters were reconciled at a common observed
                       generation
                     status: 'True'
-                    type: Available
+                    type: LastKnownReconciled
                   - created_time: '2021-01-01T10:00:00Z'
                     last_transition_time: '2021-01-01T10:00:00Z'
                     last_updated_time: '2021-01-01T10:00:00Z'
@@ -463,14 +463,14 @@ paths:
                     last_transition_time: '2021-01-01T10:00:00Z'
                     last_updated_time: '2021-01-01T10:00:00Z'
                     message: >-
-                      All adapters reported Available True for the same
+                      All required adapters were reconciled at a common observed
                       generation
                     observed_generation: 2
                     reason: >-
-                      All adapters reported Available True for the same
+                      All required adapters were reconciled at a common observed
                       generation
                     status: 'True'
-                    type: Available
+                    type: LastKnownReconciled
                   - created_time: '2021-01-01T10:00:00Z'
                     last_transition_time: '2021-01-01T10:00:00Z'
                     last_updated_time: '2021-01-01T10:00:00Z'
@@ -1251,11 +1251,15 @@ definitions:
           - created_time: '2021-01-01T10:00:00Z'
             last_transition_time: '2021-01-01T10:00:00Z'
             last_updated_time: '2021-01-01T10:00:00Z'
-            message: All adapters reported Available True for the same generation
+            message: >-
+              All required adapters were reconciled at a common observed
+              generation
             observed_generation: 1
-            reason: All adapters reported Available True for the same generation
+            reason: >-
+              All required adapters were reconciled at a common observed
+              generation
             status: 'True'
-            type: Available
+            type: LastKnownReconciled
           - created_time: '2021-01-01T10:00:00Z'
             last_transition_time: '2021-01-01T10:00:00Z'
             last_updated_time: '2021-01-01T10:00:00Z'
@@ -1448,8 +1452,10 @@ definitions:
           - `type: "Reconciled"`: Whether the resource's desired state has been
           fully reconciled by all adapters at the current generation.
 
-          - `type: "Available"`: Aggregated adapter result for a common
-          observed_generation.   
+          - `type: "LastKnownReconciled"`: Sticky cross-generation condition —
+          stays True as long as all required adapters were reconciled at a
+          common observed generation, even if a newer generation is being
+          processed.
 
 
           These conditions are present immediately upon resource creation.
@@ -1571,11 +1577,15 @@ definitions:
           - created_time: '2021-01-01T10:00:00Z'
             last_transition_time: '2021-01-01T10:00:00Z'
             last_updated_time: '2021-01-01T10:00:00Z'
-            message: All adapters reported Available True for the same generation
+            message: >-
+              All required adapters were reconciled at a common observed
+              generation
             observed_generation: 1
-            reason: All adapters reported Available True for the same generation
+            reason: >-
+              All required adapters were reconciled at a common observed
+              generation
             status: 'True'
-            type: Available
+            type: LastKnownReconciled
           - created_time: '2021-01-01T10:00:00Z'
             last_transition_time: '2021-01-01T10:00:00Z'
             last_updated_time: '2021-01-01T10:00:00Z'
@@ -1835,8 +1845,10 @@ definitions:
           - `type: "Reconciled"`: Whether the resource's desired state has been
           fully reconciled by all adapters at the current generation.
 
-          - `type: "Available"`: Aggregated adapter result for a common
-          observed_generation.   
+          - `type: "LastKnownReconciled"`: Sticky cross-generation condition —
+          stays True as long as all required adapters were reconciled at a
+          common observed generation, even if a newer generation is being
+          processed.
 
 
           These conditions are present immediately upon resource creation.
diff --git a/schemas/gcp/openapi.yaml b/schemas/gcp/openapi.yaml
diff --git a/schemas/gcp/swagger.yaml b/schemas/gcp/swagger.yaml
diff --git a/services/clusters.tsp b/services/clusters.tsp

Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@ using OpenAPI;`
`20`	`20`	`*`
`21`	`21`	`*/`
`22`	`22`	`@service(#{ title: "HyperFleet API" })`
`23`		`-@info(#{ version: "1.0.10", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })`
	`23`	`+@info(#{ version: "1.0.11", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })`
`24`	`24`	`@server("https://hyperfleet.redhat.com", "Production")`
`25`	`25`	`@route("/api/hyperfleet/v1")`
`26`	`26`	`namespace HyperFleet;`
Original file line number	Diff line number	Diff line change
`@@ -35,7 +35,7 @@ model ClusterStatus {`
`35`	`35`	`* Mandatory conditions:`
`36`	`36`	* - `type: "Ready"` (deprecated — use Reconciled): Whether all adapters report successfully at the current generation.
`37`	`37`	* - `type: "Reconciled"`: Whether the resource's desired state has been fully reconciled by all adapters at the current generation.
`38`		- * - `type: "Available"`: Aggregated adapter result for a common observed_generation.
	`38`	+ * - `type: "LastKnownReconciled"`: Sticky cross-generation condition — stays True as long as all required adapters were reconciled at a common observed generation, even if a newer generation is being processed.
`39`	`39`	`*`
`40`	`40`	`* These conditions are present immediately upon resource creation.`
`41`	`41`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ model NodePoolStatus {`
`32`	`32`	`* Mandatory conditions:`
`33`	`33`	* - `type: "Ready"` (deprecated — use Reconciled): Whether all adapters report successfully at the current generation.
`34`	`34`	* - `type: "Reconciled"`: Whether the resource's desired state has been fully reconciled by all adapters at the current generation.
`35`		- * - `type: "Available"`: Aggregated adapter result for a common observed_generation.
	`35`	+ * - `type: "LastKnownReconciled"`: Sticky cross-generation condition — stays True as long as all required adapters were reconciled at a common observed generation, even if a newer generation is being processed.
`36`	`36`	`*`
`37`	`37`	`* These conditions are present immediately upon resource creation.`
`38`	`38`	`*/`