CAMEL-23226: Combined camel-jbang UX improvements for testing

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-bind.adoc

@@ -2,7 +2,10 @@
 // AUTO-GENERATED by camel-package-maven-plugin - DO NOT EDIT THIS FILE
 = camel bind
 
-Bind source and sink Kamelets as a new Camel integration
+DEPRECATED: Bind source and sink Kamelets as a new Camel integration
+
+
+CAUTION: This command is deprecated.
 
 
 == Usage
@@ -20,7 +23,7 @@ camel bind [options]
 |===
 | Option | Description | Default | Type
 | `--error-handler` | Add error handler (none|log|sink:<endpoint>). Sink endpoints are expected in the format [[apigroup/]version:]kind:[namespace/]name, plain Camel URIs or Kamelet name. |  | String
-| `--output` | Output format generated by this command (supports: file, yaml or json). | file | String
+| `--output` | Output format generated by this command (supports: ). | file | String
 | `--property` | Adds a pipe property in the form of [source|sink|error-handler|step-<n>].<key>=<value> where <n> is the step number starting from 1 |  | String
 | `--sink` | Sink (to) such as a Kamelet or Camel endpoint uri |  | String
 | `--source` | Source (from) such as a Kamelet or Camel endpoint uri |  | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-cmd-receive.adoc

@@ -28,7 +28,7 @@ camel cmd receive [options]
 | `--logging-color` | Use colored logging | true | boolean
 | `--mask` | Whether to mask endpoint URIs to avoid printing sensitive information such as password or access keys |  | boolean
 | `--only-body` | Show only message body in received messages | false | boolean
-| `--output` | Output format (text or json) |  | String
+| `--output` | Output format () |  | String
 | `--prefix` | Print prefix with running Camel integration name. auto=only prefix when running multiple integrations. true=always prefix. false=prefix off. | auto | String
 | `--pretty` | Pretty print message body when using JSon or XML format |  | boolean
 | `--prop,--property` | Additional properties; override existing (only applicable when NOT using an existing running Camel) |  | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-commands.adoc

@@ -11,7 +11,7 @@ TIP: You can also use `camel --help` or `camel <command> --help` to see availabl
 [cols="2,5",options="header"]
 |===
 | Command | Description
-| xref:jbang-commands/camel-jbang-bind.adoc[camel bind] | Bind source and sink Kamelets as a new Camel integration
+| xref:jbang-commands/camel-jbang-bind.adoc[camel bind] | DEPRECATED: Bind source and sink Kamelets as a new Camel integration
 | xref:jbang-commands/camel-jbang-catalog.adoc[camel catalog] | List artifacts from Camel Catalog
 | xref:jbang-commands/camel-jbang-cmd.adoc[camel cmd] | Performs commands in the running Camel integrations, such as start/stop route, or change logging levels.
 | xref:jbang-commands/camel-jbang-completion.adoc[camel completion] | Generate completion script for bash/zsh
@@ -43,4 +43,5 @@ TIP: You can also use `camel --help` or `camel <command> --help` to see availabl
 | xref:jbang-commands/camel-jbang-transform.adoc[camel transform] | Transform message or Camel routes
 | xref:jbang-commands/camel-jbang-update.adoc[camel update] | Update Camel project
 | xref:jbang-commands/camel-jbang-version.adoc[camel version] | Manage Camel versions
+| xref:jbang-commands/camel-jbang-wrapper.adoc[camel wrapper] | Install Camel wrapper scripts for version pinning
 |===

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-debug.adoc

@@ -67,7 +67,7 @@ camel debug [options]
 | `--package-scan-jars` | Whether to automatic package scan JARs for custom Spring or Quarkus beans making them available for Camel JBang | false | boolean
 | `--port` | Embeds a local HTTP server on this port (port 8080 by default; use 0 to dynamic assign a free random port number) |  | int
 | `--pretty` | Pretty print message body when using JSon or XML format |  | boolean
-| `--profile` | Profile to run (dev, test, or prod). | dev | String
+| `--profile` | Profile to run (). | dev | String
 | `--prompt` | Allow user to type in required parameters in prompt if not present in application | false | boolean
 | `--prop,--property` | Additional properties (override existing) |  | String
 | `--properties` | comma separated list of properties file (ex. /path/to/file.properties,/path/to/other.properties |  | String
@@ -83,7 +83,7 @@ camel debug [options]
 | `--show-exchange-properties` | Show exchange properties in debug messages | false | boolean
 | `--show-exchange-variables` | Show exchange variables in debug messages | true | boolean
 | `--show-headers` | Show message headers in debug messages | true | boolean
-| `--skip-plugins` | Skip plugins during export | false | boolean
+| `--skip-plugins` | Skip resolving plugin dependencies | false | boolean
 | `--source` | Prefer to display source filename/code instead of IDs |  | boolean
 | `--source-dir` | Source directory for dynamically loading Camel file(s) to run. When using this, then files cannot be specified at the same time. |  | String
 | `--spring-boot-version` | Spring Boot version | RuntimeType.SPRING_BOOT_VERSION | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-dependency-copy.adoc

@@ -33,12 +33,12 @@ camel dependency copy [options]
 | `--hawtio` | Whether to include Hawtio web console (only available for exporting to Spring Boot or Quarkus) | false | boolean
 | `--hawtio-version` | Version of the Hawtio web console | HawtioVersion.HAWTIO_VERSION | String
 | `--ignore-loading-error` | Whether to ignore route loading and compilation errors (use this with care!) | false | boolean
-| `--java-version` | Java version (21, 25) | 21 | String
+| `--java-version` | Java version () | 21 | String
 | `--kamelets-version` | Apache Camel Kamelets version | RuntimeType.KAMELETS_VERSION | String
 | `--lazy-bean` | Whether to use lazy bean initialization (can help with complex classloading issues | true | boolean
 | `--local-kamelet-dir` | Local directory for loading Kamelets (takes precedence) |  | String
 | `--logging` | Can be used to turn on logging to console (logs by default to file in <user home>/.camel directory) | false | boolean
-| `--logging-level` | Logging level | info | String
+| `--logging-level` | Logging level () | info | String
 | `--main-classname` | The class name of the Camel Main application class | CamelApplication | String
 | `--management-port` | To use a dedicated port for HTTP management |  | int
 | `--maven-apache-snapshot-enabled` | Whether downloading JARs from ASF Maven Snapshot repository is enabled | true | boolean
@@ -49,12 +49,12 @@ camel dependency copy [options]
 | `--name` | The integration name. Use this when the name should not get derived otherwise. |  | String
 | `--observe` | Enable observability services | false | boolean
 | `--open-api` | Adds an OpenAPI spec from the given file (json or yaml file) |  | String
-| `--output` | Output format (gav, maven, jbang) | gav | String
+| `--output` | Output format () | gav | String
 | `--output-directory` | Directory where dependencies should be copied | lib | String
 | `--package-name` | For Java source files should they have the given package name. By default the package name is computed from the Maven GAV. Use false to turn off and not include package name in the Java source files. |  | String
 | `--package-scan-jars` | Whether to automatic package scan JARs for custom Spring or Quarkus beans making them available for Camel JBang | false | boolean
 | `--port` | Embeds a local HTTP server on this port |  | int
-| `--profile` | Profile to export (dev, test, or prod). |  | String
+| `--profile` | Profile to export (). |  | String
 | `--prop,--property` | Camel application properties, ex. --property=prop1=foo |  | String
 | `--quarkus-artifact-id` | Quarkus Platform Maven artifactId | quarkus-bom | String
 | `--quarkus-group-id` | Quarkus Platform Maven groupId | io.quarkus.platform | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-dependency-list.adoc

@@ -33,12 +33,12 @@ camel dependency list [options]
 | `--hawtio` | Whether to include Hawtio web console (only available for exporting to Spring Boot or Quarkus) | false | boolean
 | `--hawtio-version` | Version of the Hawtio web console | HawtioVersion.HAWTIO_VERSION | String
 | `--ignore-loading-error` | Whether to ignore route loading and compilation errors (use this with care!) | false | boolean
-| `--java-version` | Java version (21, 25) | 21 | String
+| `--java-version` | Java version () | 21 | String
 | `--kamelets-version` | Apache Camel Kamelets version | RuntimeType.KAMELETS_VERSION | String
 | `--lazy-bean` | Whether to use lazy bean initialization (can help with complex classloading issues | true | boolean
 | `--local-kamelet-dir` | Local directory for loading Kamelets (takes precedence) |  | String
 | `--logging` | Can be used to turn on logging to console (logs by default to file in <user home>/.camel directory) | false | boolean
-| `--logging-level` | Logging level | info | String
+| `--logging-level` | Logging level () | info | String
 | `--main-classname` | The class name of the Camel Main application class | CamelApplication | String
 | `--management-port` | To use a dedicated port for HTTP management |  | int
 | `--maven-apache-snapshot-enabled` | Whether downloading JARs from ASF Maven Snapshot repository is enabled | true | boolean
@@ -49,11 +49,11 @@ camel dependency list [options]
 | `--name` | The integration name. Use this when the name should not get derived otherwise. |  | String
 | `--observe` | Enable observability services | false | boolean
 | `--open-api` | Adds an OpenAPI spec from the given file (json or yaml file) |  | String
-| `--output` | Output format (gav, maven, jbang) | gav | String
+| `--output` | Output format () | gav | String
 | `--package-name` | For Java source files should they have the given package name. By default the package name is computed from the Maven GAV. Use false to turn off and not include package name in the Java source files. |  | String
 | `--package-scan-jars` | Whether to automatic package scan JARs for custom Spring or Quarkus beans making them available for Camel JBang | false | boolean
 | `--port` | Embeds a local HTTP server on this port |  | int
-| `--profile` | Profile to export (dev, test, or prod). |  | String
+| `--profile` | Profile to export (). |  | String
 | `--prop,--property` | Camel application properties, ex. --property=prop1=foo |  | String
 | `--quarkus-artifact-id` | Quarkus Platform Maven artifactId | quarkus-bom | String
 | `--quarkus-group-id` | Quarkus Platform Maven groupId | io.quarkus.platform | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-dependency-update.adoc

@@ -34,12 +34,12 @@ camel dependency update [options]
 | `--hawtio` | Whether to include Hawtio web console (only available for exporting to Spring Boot or Quarkus) | false | boolean
 | `--hawtio-version` | Version of the Hawtio web console | HawtioVersion.HAWTIO_VERSION | String
 | `--ignore-loading-error` | Whether to ignore route loading and compilation errors (use this with care!) | false | boolean
-| `--java-version` | Java version (21, 25) | 21 | String
+| `--java-version` | Java version () | 21 | String
 | `--kamelets-version` | Apache Camel Kamelets version | RuntimeType.KAMELETS_VERSION | String
 | `--lazy-bean` | Whether to use lazy bean initialization (can help with complex classloading issues | true | boolean
 | `--local-kamelet-dir` | Local directory for loading Kamelets (takes precedence) |  | String
 | `--logging` | Can be used to turn on logging to console (logs by default to file in <user home>/.camel directory) | false | boolean
-| `--logging-level` | Logging level | info | String
+| `--logging-level` | Logging level () | info | String
 | `--main-classname` | The class name of the Camel Main application class | CamelApplication | String
 | `--management-port` | To use a dedicated port for HTTP management |  | int
 | `--maven-apache-snapshot-enabled` | Whether downloading JARs from ASF Maven Snapshot repository is enabled | true | boolean
@@ -50,11 +50,11 @@ camel dependency update [options]
 | `--name` | The integration name. Use this when the name should not get derived otherwise. |  | String
 | `--observe` | Enable observability services | false | boolean
 | `--open-api` | Adds an OpenAPI spec from the given file (json or yaml file) |  | String
-| `--output` | Output format (gav, maven, jbang) | gav | String
+| `--output` | Output format () | gav | String
 | `--package-name` | For Java source files should they have the given package name. By default the package name is computed from the Maven GAV. Use false to turn off and not include package name in the Java source files. |  | String
 | `--package-scan-jars` | Whether to automatic package scan JARs for custom Spring or Quarkus beans making them available for Camel JBang | false | boolean
 | `--port` | Embeds a local HTTP server on this port |  | int
-| `--profile` | Profile to export (dev, test, or prod). |  | String
+| `--profile` | Profile to export (). |  | String
 | `--prop,--property` | Camel application properties, ex. --property=prop1=foo |  | String
 | `--quarkus-artifact-id` | Quarkus Platform Maven artifactId | quarkus-bom | String
 | `--quarkus-group-id` | Quarkus Platform Maven groupId | io.quarkus.platform | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-explain.adoc

@@ -22,7 +22,7 @@ camel explain [options]
 | `--api-key` | API key for authentication. Also reads OPENAI_API_KEY or LLM_API_KEY env vars |  | String
 | `--api-type` | API type: 'ollama' or 'openai' (OpenAI-compatible) | ollama | ApiType
 | `--catalog-context` | Include Camel Catalog descriptions in the prompt |  | boolean
-| `--format` | Output format: text, markdown | text | String
+| `--format` | Output format () | text | String
 | `--model` | Model to use | DEFAULT_MODEL | String
 | `--show-prompt` | Show the prompt sent to the LLM |  | boolean
 | `--stream` | Stream the response as it's generated (shows progress) | true | boolean

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-export.adoc

@@ -33,12 +33,12 @@ camel export [options]
 | `--hawtio` | Whether to include Hawtio web console (only available for exporting to Spring Boot or Quarkus) | false | boolean
 | `--hawtio-version` | Version of the Hawtio web console | HawtioVersion.HAWTIO_VERSION | String
 | `--ignore-loading-error` | Whether to ignore route loading and compilation errors (use this with care!) | false | boolean
-| `--java-version` | Java version (21, 25) | 21 | String
+| `--java-version` | Java version () | 21 | String
 | `--kamelets-version` | Apache Camel Kamelets version | RuntimeType.KAMELETS_VERSION | String
 | `--lazy-bean` | Whether to use lazy bean initialization (can help with complex classloading issues | true | boolean
 | `--local-kamelet-dir` | Local directory for loading Kamelets (takes precedence) |  | String
 | `--logging` | Can be used to turn on logging to console (logs by default to file in <user home>/.camel directory) | false | boolean
-| `--logging-level` | Logging level | info | String
+| `--logging-level` | Logging level () | info | String
 | `--main-classname` | The class name of the Camel Main application class | CamelApplication | String
 | `--management-port` | To use a dedicated port for HTTP management |  | int
 | `--maven-apache-snapshot-enabled` | Whether downloading JARs from ASF Maven Snapshot repository is enabled | true | boolean
@@ -52,7 +52,7 @@ camel export [options]
 | `--package-name` | For Java source files should they have the given package name. By default the package name is computed from the Maven GAV. Use false to turn off and not include package name in the Java source files. |  | String
 | `--package-scan-jars` | Whether to automatic package scan JARs for custom Spring or Quarkus beans making them available for Camel JBang | false | boolean
 | `--port` | Embeds a local HTTP server on this port |  | int
-| `--profile` | Profile to export (dev, test, or prod). |  | String
+| `--profile` | Profile to export (). |  | String
 | `--prop,--property` | Camel application properties, ex. --property=prop1=foo |  | String
 | `--quarkus-artifact-id` | Quarkus Platform Maven artifactId | quarkus-bom | String
 | `--quarkus-group-id` | Quarkus Platform Maven groupId | io.quarkus.platform | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-harden.adoc

@@ -22,7 +22,7 @@ camel harden [options]
 | `--api-key` | API key for authentication. Also reads OPENAI_API_KEY or LLM_API_KEY env vars |  | String
 | `--api-type` | API type: 'ollama' or 'openai' (OpenAI-compatible) | ollama | ApiType
 | `--catalog-context` | Include Camel Catalog descriptions in the prompt |  | boolean
-| `--format` | Output format: text, markdown | text | String
+| `--format` | Output format () | text | String
 | `--model` | Model to use | DEFAULT_MODEL | String
 | `--show-prompt` | Show the prompt sent to the LLM |  | boolean
 | `--stream` | Stream the response as it's generated (shows progress) | true | boolean

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-run.adoc

@@ -61,7 +61,7 @@ camel run [options]
 | `--open-api` | Adds an OpenAPI spec from the given file (json or yaml file) |  | String
 | `--package-scan-jars` | Whether to automatic package scan JARs for custom Spring or Quarkus beans making them available for Camel JBang | false | boolean
 | `--port` | Embeds a local HTTP server on this port (port 8080 by default; use 0 to dynamic assign a free random port number) |  | int
-| `--profile` | Profile to run (dev, test, or prod). | dev | String
+| `--profile` | Profile to run (). | dev | String
 | `--prompt` | Allow user to type in required parameters in prompt if not present in application | false | boolean
 | `--prop,--property` | Additional properties (override existing) |  | String
 | `--properties` | comma separated list of properties file (ex. /path/to/file.properties,/path/to/other.properties |  | String
@@ -71,7 +71,7 @@ camel run [options]
 | `--reload,--dev` | Enables dev mode (live reload when source files are updated and saved) |  | boolean
 | `--repo,--repos` | Additional maven repositories (Use commas to separate multiple repositories) |  | String
 | `--runtime` | Runtime () | camel-main | RuntimeType
-| `--skip-plugins` | Skip plugins during export | false | boolean
+| `--skip-plugins` | Skip resolving plugin dependencies | false | boolean
 | `--source-dir` | Source directory for dynamically loading Camel file(s) to run. When using this, then files cannot be specified at the same time. |  | String
 | `--spring-boot-version` | Spring Boot version | RuntimeType.SPRING_BOOT_VERSION | String
 | `--stub` | Stubs all the matching endpoint uri with the given component name or pattern. Multiple names can be separated by comma. (all = stub all endpoints). |  | String

docs/user-manual/modules/ROOT/pages/jbang-commands/camel-jbang-sbom.adoc

@@ -34,12 +34,12 @@ camel sbom [options]
 | `--hawtio` | Whether to include Hawtio web console (only available for exporting to Spring Boot or Quarkus) | false | boolean
 | `--hawtio-version` | Version of the Hawtio web console | HawtioVersion.HAWTIO_VERSION | String
 | `--ignore-loading-error` | Whether to ignore route loading and compilation errors (use this with care!) | false | boolean
-| `--java-version` | Java version (21, 25) | 21 | String
+| `--java-version` | Java version () | 21 | String
 | `--kamelets-version` | Apache Camel Kamelets version | RuntimeType.KAMELETS_VERSION | String
 | `--lazy-bean` | Whether to use lazy bean initialization (can help with complex classloading issues | true | boolean
 | `--local-kamelet-dir` | Local directory for loading Kamelets (takes precedence) |  | String
 | `--logging` | Can be used to turn on logging to console (logs by default to file in <user home>/.camel directory) | false | boolean
-| `--logging-level` | Logging level | info | String
+| `--logging-level` | Logging level () | info | String
 | `--main-classname` | The class name of the Camel Main application class | CamelApplication | String
 | `--management-port` | To use a dedicated port for HTTP management |  | int
 | `--maven-apache-snapshot-enabled` | Whether downloading JARs from ASF Maven Snapshot repository is enabled | true | boolean
@@ -55,7 +55,7 @@ camel sbom [options]
 | `--package-name` | For Java source files should they have the given package name. By default the package name is computed from the Maven GAV. Use false to turn off and not include package name in the Java source files. |  | String
 | `--package-scan-jars` | Whether to automatic package scan JARs for custom Spring or Quarkus beans making them available for Camel JBang | false | boolean
 | `--port` | Embeds a local HTTP server on this port |  | int
-| `--profile` | Profile to export (dev, test, or prod). |  | String
+| `--profile` | Profile to export (). |  | String
 | `--prop,--property` | Camel application properties, ex. --property=prop1=foo |  | String
 | `--quarkus-artifact-id` | Quarkus Platform Maven artifactId | quarkus-bom | String
 | `--quarkus-group-id` | Quarkus Platform Maven groupId | io.quarkus.platform | String