CAMEL-22544: jbang dependency update supports multi-file and --scan-routes

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

@@ -4192,7 +4192,7 @@ The camel.jbang supports 45 options, which are listed below.
 |===
 | Name | Description | Default | Type
 | *camel.jbang.camel-version* | The version of Apache Camel to use |  | String
-| *camel.jbang.camelSpringBoot{zwsp}Version* | To use a custom Camel version when running or export to Spring Boot |  | String
+| *camel.jbang.camelSpringBootVersion* | To use a custom Camel version when running or export to Spring Boot |  | String
 | *camel.jbang.classpathFiles* | Additional files to add to classpath (Use commas to separate multiple files). |  | String
 | *camel.jbang.compileWorkDir* | Work directory for compiler. Can be used to write compiled classes or other resources. | .camel-jbang/compile | String
 | *camel.jbang.console* | Developer console at /q/dev on local HTTP server (port 8080 by default) | false | boolean

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

@@ -45,7 +45,7 @@ camel debug [options]
 | `--log-lines` | Number of log lines to display on top of screen | 10 | int
 | `--logging` | Can be used to turn off logging | true | boolean
 | `--logging-category` | Used for individual logging levels (ex: org.apache.kafka=DEBUG) |  | List
-| `--logging-color` | Use colored logging | true | boolean
+| `--logging-color` | Use colored logging. Default is auto-detected based on NO_COLOR, CI, FORCE_COLOR environment variables and terminal capabilities |  | boolean
 | `--logging-config-path` | Path to file with custom logging configuration |  | String
 | `--logging-json` | Use JSON logging (ECS Layout) | false | boolean
 | `--logging-level` | Logging level () | info | String
@@ -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

@@ -26,19 +26,20 @@ camel dependency copy [options]
 | `--dep,--dependency` | Add additional dependencies |  | List
 | `--dir,--directory` | Directory where the project will be exported | . | String
 | `--download` | Whether to allow automatic downloading JAR dependencies (over the internet) | true | boolean
+| `--dry-run` | Preview export without writing files | false | boolean
 | `--exclude` | Exclude files by name or pattern |  | List
 | `--fresh` | Make sure we use fresh (i.e. non-cached) resources | false | boolean
 | `--gav` | The Maven group:artifact:version |  | String
 | `--groovy-pre-compiled` | Whether to include pre-compiled Groovy classes in the export (only supported with runtime=camel-main) | false | boolean
 | `--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 +50,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
@@ -65,6 +66,7 @@ camel dependency copy [options]
 | `--skip-plugins` | Skip plugins during export | false | boolean
 | `--spring-boot-version` | Spring Boot version | RuntimeType.SPRING_BOOT_VERSION | String
 | `--verbose` | Verbose output of startup activity (dependency resolution and downloading | false | boolean
+| `--yes,-y` | Automatically answer yes to confirmation prompts (e.g. when using --clean-dir) | false | boolean
 | `-h,--help` | Display the help and sub-commands |  | boolean
 |===
 

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

@@ -26,19 +26,20 @@ camel dependency list [options]
 | `--dep,--dependency` | Add additional dependencies |  | List
 | `--dir,--directory` | Directory where the project will be exported | . | String
 | `--download` | Whether to allow automatic downloading JAR dependencies (over the internet) | true | boolean
+| `--dry-run` | Preview export without writing files | false | boolean
 | `--exclude` | Exclude files by name or pattern |  | List
 | `--fresh` | Make sure we use fresh (i.e. non-cached) resources | false | boolean
 | `--gav` | The Maven group:artifact:version |  | String
 | `--groovy-pre-compiled` | Whether to include pre-compiled Groovy classes in the export (only supported with runtime=camel-main) | false | boolean
 | `--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 +50,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
@@ -64,6 +65,7 @@ camel dependency list [options]
 | `--skip-plugins` | Skip plugins during export | false | boolean
 | `--spring-boot-version` | Spring Boot version | RuntimeType.SPRING_BOOT_VERSION | String
 | `--verbose` | Verbose output of startup activity (dependency resolution and downloading | false | boolean
+| `--yes,-y` | Automatically answer yes to confirmation prompts (e.g. when using --clean-dir) | false | boolean
 | `-h,--help` | Display the help and sub-commands |  | boolean
 |===
 

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

@@ -2,7 +2,7 @@
 // AUTO-GENERATED by camel-package-maven-plugin - DO NOT EDIT THIS FILE
 = camel dependency update
 
-Updates dependencies in Maven pom.xml or Java source file (JBang style)
+Updates dependencies in Maven pom.xml or Java source files (JBang style)
 
 
 == Usage
@@ -27,19 +27,20 @@ camel dependency update [options]
 | `--dep,--dependency` | Add additional dependencies |  | List
 | `--dir,--directory` | Directory where the project will be exported | . | String
 | `--download` | Whether to allow automatic downloading JAR dependencies (over the internet) | true | boolean
+| `--dry-run` | Preview export without writing files | false | boolean
 | `--exclude` | Exclude files by name or pattern |  | List
 | `--fresh` | Make sure we use fresh (i.e. non-cached) resources | false | boolean
 | `--gav` | The Maven group:artifact:version |  | String
 | `--groovy-pre-compiled` | Whether to include pre-compiled Groovy classes in the export (only supported with runtime=camel-main) | false | boolean
 | `--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,21 +51,23 @@ 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
 | `--quarkus-version` | Quarkus Platform version | RuntimeType.QUARKUS_VERSION | String
 | `--quiet` | Will be quiet, only print when error occurs | false | boolean
 | `--repo,--repos` | Additional maven repositories (Use commas to separate multiple repositories) |  | String
 | `--runtime` | Runtime () |  | RuntimeType
+| `--scan-routes` | Sync dependencies from route definitions. Only manages org.apache.camel dependencies, preserving non-Camel dependencies. Removes unused Camel dependencies. |  | boolean
 | `--skip-plugins` | Skip plugins during export | false | boolean
 | `--spring-boot-version` | Spring Boot version | RuntimeType.SPRING_BOOT_VERSION | String
 | `--verbose` | Verbose output of startup activity (dependency resolution and downloading | false | boolean
+| `--yes,-y` | Automatically answer yes to confirmation prompts (e.g. when using --clean-dir) | false | boolean
 | `-h,--help` | Display the help and sub-commands |  | boolean
 |===
 

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

@@ -21,7 +21,7 @@ camel dependency [options]
 | xref:jbang-commands/camel-jbang-dependency-copy.adoc[copy] | Copies all Camel dependencies required to run to a specific directory
 | xref:jbang-commands/camel-jbang-dependency-list.adoc[list] | Displays all Camel dependencies required to run
 | xref:jbang-commands/camel-jbang-dependency-runtime.adoc[runtime] | Display Camel runtime and version for given Maven project
-| xref:jbang-commands/camel-jbang-dependency-update.adoc[update] | Updates dependencies in Maven pom.xml or Java source file (JBang style)
+| xref:jbang-commands/camel-jbang-dependency-update.adoc[update] | Updates dependencies in Maven pom.xml or Java source files (JBang style)
 |===
 
 

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