From 00787435ffcdf5c6beed6a246857110a152a234b Mon Sep 17 00:00:00 2001
From: AJ Emerich <aj-emerich@proton.me>
Date: Wed, 29 Jul 2026 09:54:26 +0200
Subject: [PATCH] docs(cloudquery): correctness and completeness pass on task
 docs

Add the missing @PluginSubGroup title, remove a non-existent
beforeCommands property from the CloudQueryCLI how-to entry, and fix
the malformed multi-document YAML indentation in the CloudQueryCLI
example (the --- separator and destination doc were indented under the
source spec). Documentation only.
---
 .../kestra/plugin/cloudquery/CloudQueryCLI.java  | 16 ++++++++--------
 .../kestra/plugin/cloudquery/package-info.java   |  1 +
 .../resources/doc/io.kestra.plugin.cloudquery.md |  2 +-
 3 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/src/main/java/io/kestra/plugin/cloudquery/CloudQueryCLI.java b/src/main/java/io/kestra/plugin/cloudquery/CloudQueryCLI.java
index e66ca7b..fcfac21 100644
--- a/src/main/java/io/kestra/plugin/cloudquery/CloudQueryCLI.java
+++ b/src/main/java/io/kestra/plugin/cloudquery/CloudQueryCLI.java
@@ -61,15 +61,15 @@
                           spec:
                             item_concurrency: 100
                             start_time: "{{ now() | dateAdd(-1, 'DAYS') }}"
-                          ---
-                          kind: destination
+                        ---
+                        kind: destination
+                        spec:
+                          name: duckdb
+                          path: cloudquery/duckdb
+                          version: v4.2.10
+                          write_mode: overwrite-delete-stale
                           spec:
-                            name: duckdb
-                            path: cloudquery/duckdb
-                            version: v4.2.10
-                            write_mode: overwrite-delete-stale
-                            spec:
-                              connection_string: hn.db
+                            connection_string: hn.db
                     commands:
                       - cloudquery sync config.yml --log-console"""
         )
diff --git a/src/main/java/io/kestra/plugin/cloudquery/package-info.java b/src/main/java/io/kestra/plugin/cloudquery/package-info.java
index 9e6126b..ed5c03b 100644
--- a/src/main/java/io/kestra/plugin/cloudquery/package-info.java
+++ b/src/main/java/io/kestra/plugin/cloudquery/package-info.java
@@ -1,4 +1,5 @@
 @PluginSubGroup(
+    title = "CloudQuery",
     description = "This sub-group of plugins contains tasks for using CloudQuery CLI.",
     categories = { PluginSubGroup.PluginCategory.DATA }
 )
diff --git a/src/main/resources/doc/io.kestra.plugin.cloudquery.md b/src/main/resources/doc/io.kestra.plugin.cloudquery.md
index daedda8..6c92bc7 100644
--- a/src/main/resources/doc/io.kestra.plugin.cloudquery.md
+++ b/src/main/resources/doc/io.kestra.plugin.cloudquery.md
@@ -10,4 +10,4 @@ Pass credentials via the `env` map — at minimum set `CLOUDQUERY_API_KEY` (requ
 
 `Sync` runs a CloudQuery sync from a set of source/destination configs — set `configs` (required, a list of CloudQuery source and destination configuration objects). Set `incremental: true` to persist state between runs (default `false`). The task runs in a container (default image `ghcr.io/cloudquery/cloudquery:latest-ubuntu`). Use `namespaceFiles` to reference [namespace files](https://kestra.io/docs/concepts/namespace-files), `inputFiles` to stage additional files, and `outputFiles` to retrieve results.
 
-`CloudQueryCLI` runs arbitrary CloudQuery CLI commands — set `commands` (required). Use `beforeCommands`, `env`, `namespaceFiles`, `inputFiles`, and `outputFiles` the same way as `Sync`.
+`CloudQueryCLI` runs arbitrary CloudQuery CLI commands — set `commands` (required). Use `env`, `namespaceFiles`, `inputFiles`, and `outputFiles` the same way as `Sync`.