HYPERFLEET-551 - feat: use configuration standard

Author: rh-amarin

README.md

@@ -34,7 +34,7 @@ cd hyperfleet-adapter
 ### Install Dependencies
 
 ```bash
-make tidy
+make mod-tidy
 ```
 
 ### Build
@@ -128,9 +128,9 @@ hyperfleet-adapter/
 | `make image-push` | Build and push container image to registry |
 | `make image-dev` | Build and push to personal Quay registry (requires QUAY_USER) |
 | `make fmt` | Format code |
-| `make tidy` | Tidy Go module dependencies |
+| `make mod-tidy` | Tidy Go module dependencies |
 | `make clean` | Clean build artifacts |
-| `make verify` | Run format check and go vet |
+| `make verify` | Run lint and test |
 
 💡 **Tip:** Use `make help` to see all available targets with descriptions
 
@@ -169,7 +169,7 @@ A  HyperFleet Adapter requires several files for configuration:
 - **Adapter Task config**: Configures the adapter task steps that will create resources
 - **Broker configuration**: Configures the specific broker to use by the adapter framework to receive CloudEvents
 
-To see all configuration options read [configuration.md](configuration.md) file
+To see all configuration options read [configuration.md](docs/configuration.md) file
 
 #### Adapter configuration
 
@@ -178,14 +178,16 @@ settings for the adapter process, such as client connections, retries, and broke
 subscription details. It is loaded with Viper, so values can be overridden by CLI flags
 and environment variables in this priority order: CLI flags > env vars > file > defaults.
 
+Fields use **snake_case** naming.
+
 - **Path**: `HYPERFLEET_ADAPTER_CONFIG` (required)
-- **Common fields**: `spec.adapter.version`, `spec.debugConfig`, `spec.clients.*`
-  (HyperFleet API, Maestro, broker, Kubernetes)
+- **Common fields**: `adapter.name`, `adapter.version`, `debug_config`, `clients.*`
+  (HyperFleet API: `clients.hyperfleet_api`, Maestro: `clients.maestro`, broker: `clients.broker`, Kubernetes: `clients.kubernetes`)
 
 Reference examples:
 
 - `configs/adapter-deployment-config.yaml` (full reference with env/flag notes)
-- `charts/examples/adapter-config.yaml` (minimal deployment example)
+- `charts/examples/kubernetes/adapter-config.yaml` (minimal deployment example)
 
 #### Adapter task configuration
 
@@ -194,12 +196,12 @@ processing events: parameters, preconditions, resources to create, and post-acti
 This file is loaded as **static YAML** (no Viper overrides) and is required at runtime.
 
 - **Path**: `HYPERFLEET_TASK_CONFIG` (required)
-- **Key sections**: `spec.params`, `spec.preconditions`, `spec.resources`, `spec.post`
+- **Key sections**: `params`, `preconditions`, `resources`, `post`
 - **Resource manifests**: inline YAML or external file via `manifest.ref`
 
 Reference examples:
 
-- `charts/examples/adapter-task-config.yaml` (worked example)
+- `charts/examples/kubernetes/adapter-task-config.yaml` (worked example)
 - `configs/adapter-task-config-template.yaml` (complete schema reference)
 
 ### Broker Configuration

charts/examples/README.md

@@ -8,7 +8,6 @@ This directory contains example configurations for deploying the HyperFleet Adap
 |-----------|-----------|-------------|
 | [`kubernetes/`](./kubernetes/) | Kubernetes only | Creates resources directly in the local cluster using the Kubernetes client |
 | [`maestro/`](./maestro/) | Maestro only | Deploys resources to a remote cluster via Maestro using ManifestWork |
-| [`maestro-kubernetes/`](./maestro-kubernetes/) | Maestro + Kubernetes | Hybrid example combining both transport clients in a single task |
 
 ---
 
@@ -22,6 +21,7 @@ Creates the following resources directly in the local cluster via the Kubernetes
 - An Nginx Deployment in the adapter's own namespace
 
 **Key features demonstrated:**
+
 - Inline manifests and external file references (`ref:`)
 - Preconditions with Hyperfleet API calls and CEL expressions
 - Resource discovery by name and label selectors
@@ -42,6 +42,7 @@ Deploys resources to a remote cluster through Maestro (Open Cluster Management)
 - Nested resource discovery within the ManifestWork result
 
 **Key features demonstrated:**
+
 - Maestro transport client configuration (gRPC + HTTP)
 - ManifestWork template with external file reference (`ref:`)
 - Resource discovery by name and by label selectors (`nestedDiscoveries`)
@@ -52,20 +53,6 @@ See [`maestro/README.md`](./maestro/README.md) for full details.
 
 ---
 
-### `maestro-kubernetes/` — Hybrid Maestro + Kubernetes
-
-Combines both transport clients in a single adapter task:
-
-- A ManifestWork delivered via Maestro to a remote cluster (Namespace + ConfigMap)
-- A Namespace created directly in the local cluster via the Kubernetes client
-
-**Key features demonstrated:**
-- Using multiple transport clients (`maestro` and `kubernetes`) within the same task
-- Per-resource transport selection via the `transport.client` field
-- Kubernetes transport as the default fallback when `transport` is omitted
-
----
-
 ## Common Configuration
 
 All examples share the same broker and image placeholders that must be updated before deployment.

charts/examples/kubernetes/adapter-config.yaml

@@ -1,32 +1,25 @@
 # Example HyperFleet Adapter deployment configuration
-apiVersion: hyperfleet.redhat.com/v1alpha1
-kind: AdapterConfig
-metadata:
+adapter:
   name: kubernetes-example
-  labels:
-    hyperfleet.io/adapter-type: kubernetes-example
-    hyperfleet.io/component: adapter
-spec:
-  adapter:
-    version: "0.1.0"
+  #version: "0.1.0"
 
-  # Log the full merged configuration after load (default: false)
-  debugConfig: true
-  log:
-    level: debug
+# Log the full merged configuration after load (default: false)
+debug_config: true
+log:
+  level: debug
 
-  clients:
-    hyperfleetApi:
-      baseUrl: http://hyperfleet-api:8000
-      version: v1
-      timeout: 2s
-      retryAttempts: 3
-      retryBackoff: exponential
+clients:
+  hyperfleet_api:
+    base_url: http://hyperfleet-api:8000
+    version: v1
+    timeout: 2s
+    retry_attempts: 3
+    retry_backoff: exponential
 
-    broker:
-      subscriptionId: "CHANGE_ME"
-      topic: "CHANGE_ME"
+  broker:
+    subscription_id: "CHANGE_ME"
+    topic: "CHANGE_ME"
 
-    kubernetes:
-      apiVersion: "v1"
-      #kubeConfigPath: PATH_TO_KUBECONFIG  # for local development
+  kubernetes:
+    api_version: "v1"
+    #kube_config_path: PATH_TO_KUBECONFIG  # for local development