docs: Update CLI --help descriptions with enriched technical details

src/main/java/io/seqera/tower/cli/Tower.java

@@ -54,7 +54,7 @@
 
 @Command(
         name = "tw",
-        description = "Nextflow Tower CLI.",
+        description = "Seqera Platform CLI",
         subcommands = {
                 ActionsCmd.class,
                 CollaboratorsCmd.class,
@@ -81,19 +81,19 @@ public class Tower extends AbstractCmd {
     @Spec
     public CommandSpec spec;
 
-    @Option(names = {"-t", "--access-token"}, description = "Tower personal access token (TOWER_ACCESS_TOKEN).", defaultValue = "${TOWER_ACCESS_TOKEN}")
+    @Option(names = {"-t", "--access-token"}, description = "Seqera Platform personal access token (TOWER_ACCESS_TOKEN)", defaultValue = "${TOWER_ACCESS_TOKEN}")
     public String token;
 
-    @Option(names = {"-u", "--url"}, description = "Tower server API endpoint URL (TOWER_API_ENDPOINT) [default: 'api.cloud.seqera.io'].", defaultValue = "${TOWER_API_ENDPOINT:-https://api.cloud.seqera.io}")
+    @Option(names = {"-u", "--url"}, description = "Seqera Platform API endpoint URL (TOWER_API_ENDPOINT) [default: 'api.cloud.seqera.io']", defaultValue = "${TOWER_API_ENDPOINT:-https://api.cloud.seqera.io}")
     public String url;
 
-    @Option(names = {"-o", "--output"}, description = "Show output in defined format (only the 'json' option is available at the moment).", defaultValue = "${TOWER_CLI_OUTPUT_FORMAT:-console}")
+    @Option(names = {"-o", "--output"}, description = "Show output in defined format (currently supports 'json')", defaultValue = "${TOWER_CLI_OUTPUT_FORMAT:-console}")
     public OutputType output;
 
     @Option(names = {"-v", "--verbose"}, description = "Show HTTP request/response logs at stderr.")
     public boolean verbose;
 
-    @Option(names = {"--insecure"}, description = "Explicitly allow to connect to a non-SSL secured Tower server (this is not recommended).")
+    @Option(names = {"--insecure"}, description = "Explicitly allow to connect to a non-SSL secured Seqera Platform server (not recommended)")
     public boolean insecure;
 
     public Tower() {

src/main/java/io/seqera/tower/cli/commands/ActionsCmd.java

@@ -27,7 +27,7 @@
 
 @CommandLine.Command(
         name = "actions",
-        description = "Manage actions.",
+        description = "Manage pipeline actions",
         subcommands = {
                 ListCmd.class,
                 ViewCmd.class,

src/main/java/io/seqera/tower/cli/commands/CollaboratorsCmd.java

@@ -22,7 +22,7 @@
 
 @CommandLine.Command(
         name = "collaborators",
-        description = "Manage organization collaborators.",
+        description = "Manage organization collaborators",
         subcommands = {
                 ListCmd.class,
         }

src/main/java/io/seqera/tower/cli/commands/ComputeEnvsCmd.java

@@ -30,7 +30,7 @@
 
 @Command(
         name = "compute-envs",
-        description = "Manage workspace compute environments.",
+        description = "Manage compute environments.",
         subcommands = {
                 AddCmd.class,
                 UpdateCmd.class,

src/main/java/io/seqera/tower/cli/commands/CredentialsCmd.java

@@ -26,7 +26,7 @@
 
 @Command(
         name = "credentials",
-        description = "Manage workspace credentials.",
+        description = "Manage workspace credentials",
         subcommands = {
                 AddCmd.class,
                 UpdateCmd.class,

src/main/java/io/seqera/tower/cli/commands/DataLinksCmd.java

@@ -28,7 +28,7 @@
 
 @CommandLine.Command(
         name = "data-links",
-        description = "Manage data-links.",
+        description = "Manage data links",
         subcommands = {
                 ListCmd.class,
                 AddCmd.class,

src/main/java/io/seqera/tower/cli/commands/DatasetsCmd.java

@@ -29,7 +29,7 @@
 
 @CommandLine.Command(
         name = "datasets",
-        description = "Manage datasets.",
+        description = "Manage datasets",
         subcommands = {
                 AddCmd.class,
                 DeleteCmd.class,

src/main/java/io/seqera/tower/cli/commands/InfoCmd.java

@@ -33,7 +33,7 @@
 
 @CommandLine.Command(
         name = "info",
-        description = "System info and health status."
+        description = "Show system info and health status"
 )
 public class InfoCmd extends AbstractRootCmd {
     @Override

src/main/java/io/seqera/tower/cli/commands/LaunchCmd.java

@@ -52,41 +52,41 @@
 
 @Command(
         name = "launch",
-        description = "Launch a Nextflow pipeline execution."
+        description = "Launch a pipeline"
 )
 public class LaunchCmd extends AbstractRootCmd {
 
-    @Parameters(index = "0", paramLabel = "PIPELINE_OR_URL", description = "Workspace pipeline name or full pipeline URL.", arity = "1")
+    @Parameters(index = "0", paramLabel = "PIPELINE_OR_URL", description = "Workspace pipeline name or pipeline URL", arity = "1")
     String pipeline;
 
     @CommandLine.Mixin
     public WorkspaceOptionalOptions workspace;
 
-    @Option(names = {"--params-file"}, description = "Pipeline parameters in either JSON or YML format.")
+    @Option(names = {"--params-file"}, description = "Pipeline parameters in JSON or YAML format. Provide the path to a file containing the content.")
     Path paramsFile;
 
-    @Option(names = {"-c", "--compute-env"}, description = "Compute environment name [default: primary compute environment].")
+    @Option(names = {"-c", "--compute-env"}, description = "Compute environment identifier where the pipeline will run. Defaults to workspace primary compute environment if omitted. Provide the name or identifier.")
     String computeEnv;
 
-    @Option(names = {"-n", "--name"}, description = "Custom workflow run name")
+    @Option(names = {"-n", "--name"}, description = "Custom run name for the workflow execution.")
     String name;
 
-    @Option(names = {"--work-dir"}, description = "Path where the pipeline scratch data is stored.")
+    @Option(names = {"--work-dir"}, description = "Work directory path where workflow intermediate files are stored. Defaults to compute environment work directory if omitted.")
     String workDir;
 
-    @Option(names = {"-p", "--profile"}, split = ",", description = "Comma-separated list of one or more configuration profile names you want to use for this pipeline execution.")
+    @Option(names = {"-p", "--profile"}, split = ",", description = "Array of Nextflow configuration profile names to apply.")
     List<String> profile;
 
-    @Option(names = {"-r", "--revision"}, description = "A valid repository commit Id, tag or branch name.")
+    @Option(names = {"-r", "--revision"}, description = "Git revision, branch, or tag to use.")
     String revision;
 
-    @Option(names = {"--wait"}, description = "Wait until given status or fail. Valid options: ${COMPLETION-CANDIDATES}.")
+    @Option(names = {"--wait"}, description = "Wait until workflow reaches specified status: ${COMPLETION-CANDIDATES}")
     public WorkflowStatus wait;
 
-    @Option(names = {"-l", "--labels"}, split = ",", description = "Comma-separated list of labels for the pipeline. Use 'key=value' format for resource labels.", converter = Label.LabelConverter.class)
+    @Option(names = {"-l", "--labels"}, split = ",", description = "Labels to assign to each pipeline run. Provide comma-separated label values (use key=value format for resource labels). Labels will be created if they don't exist", converter = Label.LabelConverter.class)
     List<Label> labels;
 
-    @Option(names = {"--launch-container"}, description = "Container to be used to run the nextflow head job (BETA).")
+    @Option(names = {"--launch-container"}, description = "Container image to use for the Nextflow launcher.")
     String launchContainer;
 
     @ArgGroup(heading = "%nAdvanced options:%n", validate = false)
@@ -258,43 +258,43 @@ private AdvancedOptions adv() {
 
     public static class AdvancedOptions {
 
-        @Option(names = {"--config"}, description = "Additional Nextflow config file.")
+        @Option(names = {"--config"}, description = "Nextflow configuration as text (overrides config files). Provide the path to a file containing the content.")
         public Path config;
 
-        @Option(names = {"--pre-run"}, description = "Bash script that is executed in the same environment where Nextflow runs just before the pipeline is launched.")
+        @Option(names = {"--pre-run"}, description = "Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See: https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts. Provide the path to a file containing the content.")
         public Path preRunScript;
 
-        @Option(names = {"--post-run"}, description = "Bash script that is executed in the same environment where Nextflow runs immediately after the pipeline completion.")
+        @Option(names = {"--post-run"}, description = "Add a script that executes after all Nextflow processes have completed. See: https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts. Provide the path to a file containing the content.")
         public Path postRunScript;
 
-        @Option(names = {"--pull-latest"}, description = "Enable Nextflow to pull the latest repository version before running the pipeline.")
+        @Option(names = {"--pull-latest"}, description = "Pull the latest version of the pipeline from the repository.")
         public Boolean pullLatest;
 
-        @Option(names = {"--stub-run"}, description = "Execute the workflow replacing process scripts with command stubs.")
+        @Option(names = {"--stub-run"}, description = "Execute a stub run for testing (processes return dummy results).")
         public Boolean stubRun;
 
-        @Option(names = {"--main-script"}, description = "Pipeline main script file if different from `main.nf`.")
+        @Option(names = {"--main-script"}, description = "Alternative main script filename. Default: `main.nf`.")
         public String mainScript;
 
-        @Option(names = {"--entry-name"}, description = "Main workflow name to be executed when using DLS2 syntax.")
+        @Option(names = {"--entry-name"}, description = "Workflow entry point name when using Nextflow DSL2.")
         public String entryName;
 
-        @Option(names = {"--schema-name"}, description = "Schema name.")
+        @Option(names = {"--schema-name"}, description = "Name of the pipeline schema to use.")
         public String schemaName;
 
-        @Option(names = {"--user-secrets"}, split = ",", description = "Pipeline Secrets required by the pipeline execution that belong to the launching user personal context. User's secrets will take precedence over workspace secrets with the same name.")
+        @Option(names = {"--user-secrets"}, split = ",", description = "Array of user secrets to make available to the pipeline.")
         public List<String> userSecrets;
 
-        @Option(names = {"--workspace-secrets"}, split = ",", description = "Pipeline Secrets required by the pipeline execution. Those secrets must be defined in the launching workspace.")
+        @Option(names = {"--workspace-secrets"}, split = ",", description = "Array of workspace secrets to make available to the pipeline.")
         public List<String> workspaceSecrets;
 
         @Option(names = {"--disable-optimization"}, description = "Turn off the optimization for the pipeline before launching.")
         public Boolean disableOptimization;
 
-        @Option(names = {"--head-job-cpus"}, description = "The number of CPUs to be allocated for the Nextflow runner job (overrides compute environment setting).")
+        @Option(names = {"--head-job-cpus"}, description = "Number of CPUs allocated for the Nextflow head job.")
         public Integer headJobCpus;
 
-        @Option(names = {"--head-job-memory"}, description = "The number of MiB of memory reserved for the Nextflow runner job (overrides compute environment setting).")
+        @Option(names = {"--head-job-memory"}, description = "Memory allocation for the Nextflow head job in megabytes.")
         public Integer headJobMemoryMb;
 
     }

src/main/java/io/seqera/tower/cli/commands/MembersCmd.java

@@ -26,7 +26,7 @@
 
 @CommandLine.Command(
         name = "members",
-        description = "Manage organization members.",
+        description = "Manage organization members",
         subcommands = {
                 ListCmd.class,
                 AddCmd.class,

src/main/java/io/seqera/tower/cli/commands/OrganizationsCmd.java

@@ -26,7 +26,7 @@
 
 @CommandLine.Command(
         name = "organizations",
-        description = "Manage organizations.",
+        description = "Manage organizations",
         subcommands = {
                 ListCmd.class,
                 DeleteCmd.class,

src/main/java/io/seqera/tower/cli/commands/ParticipantsCmd.java

@@ -26,7 +26,7 @@
 
 @CommandLine.Command(
         name = "participants",
-        description = "Manage workspace participants.",
+        description = "Manage workspace participants",
         subcommands = {
                 ListCmd.class,
                 AddCmd.class,

src/main/java/io/seqera/tower/cli/commands/PipelinesCmd.java

@@ -30,7 +30,7 @@
 
 @Command(
         name = "pipelines",
-        description = "Manage workspace pipeline launchpad.",
+        description = "Manage pipelines",
         subcommands = {
                 ListCmd.class,
                 AddCmd.class,

src/main/java/io/seqera/tower/cli/commands/RunsCmd.java

@@ -28,7 +28,7 @@
 
 @CommandLine.Command(
         name = "runs",
-        description = "Manage workspace pipeline runs.",
+        description = "Manage pipeline runs",
         subcommands = {
                 ViewCmd.class,
                 ListCmd.class,

src/main/java/io/seqera/tower/cli/commands/SecretsCmd.java

@@ -23,7 +23,7 @@
 
 @Command(
         name = "secrets",
-        description = "Manage workspace secrets.",
+        description = "Manage secrets",
         subcommands = {
                 ListCmd.class,
                 AddCmd.class,

src/main/java/io/seqera/tower/cli/commands/StudiosCmd.java

@@ -30,7 +30,7 @@
 
 @CommandLine.Command(
         name = "studios",
-        description = "Manage studios.",
+        description = "Manage studios",
         subcommands = {
                 ViewCmd.class,
                 ListCmd.class,

src/main/java/io/seqera/tower/cli/commands/TeamsCmd.java

@@ -26,7 +26,7 @@
 
 @CommandLine.Command(
         name = "teams",
-        description = "Manage organization teams.",
+        description = "Manage teams",
         subcommands = {
                 ListCmd.class,
                 AddCmd.class,

src/main/java/io/seqera/tower/cli/commands/WorkspacesCmd.java

@@ -27,7 +27,7 @@
 
 @CommandLine.Command(
         name = "workspaces",
-        description = "Manage workspaces.",
+        description = "Manage workspaces",
         subcommands = {
                 ListCmd.class,
                 DeleteCmd.class,

src/main/java/io/seqera/tower/cli/commands/actions/ActionRefOptions.java

@@ -26,10 +26,10 @@ public class ActionRefOptions {
 
     public static class ActionRef {
 
-        @CommandLine.Option(names = {"-i", "--id"}, description = "Action unique id.")
+        @CommandLine.Option(names = {"-i", "--id"}, description = "Action unique identifier")
         public String actionId;
 
-        @CommandLine.Option(names = {"-n", "--name"}, description = "Action name.")
+        @CommandLine.Option(names = {"-n", "--name"}, description = "Action name")
         public String actionName;
     }
 }

src/main/java/io/seqera/tower/cli/commands/actions/AddCmd.java

@@ -28,7 +28,7 @@
 
 @CommandLine.Command(
         name = "add",
-        description = "Add a new Pipeline Action.",
+        description = "Add a pipeline action",
         subcommands = {
                 AddGitHubCmd.class,
                 AddTowerCmd.class

src/main/java/io/seqera/tower/cli/commands/actions/DeleteCmd.java

@@ -29,7 +29,7 @@
 
 @CommandLine.Command(
         name = "delete",
-        description = "Delete a Pipeline Action."
+        description = "Delete a pipeline action"
 )
 public class DeleteCmd extends AbstractActionsCmd {
 

src/main/java/io/seqera/tower/cli/commands/actions/LabelsCmd.java

@@ -26,7 +26,7 @@
 import java.io.IOException;
 import java.util.Collections;
 
-@CommandLine.Command(name = "labels", description = "Manages labels for actions.")
+@CommandLine.Command(name = "labels", description = "Manage pipeline action labels")
 public class LabelsCmd extends AbstractActionsCmd {
 
     @CommandLine.Mixin

src/main/java/io/seqera/tower/cli/commands/actions/ListCmd.java

@@ -31,7 +31,7 @@
 
 @CommandLine.Command(
         name = "list",
-        description = "List the available Pipeline Actions for the authenticated user or given workspace."
+        description = "List pipeline actions"
 )
 public class ListCmd extends AbstractActionsCmd {
 

src/main/java/io/seqera/tower/cli/commands/actions/UpdateCmd.java

@@ -35,17 +35,17 @@
 
 @CommandLine.Command(
         name = "update",
-        description = "Update a Pipeline Action."
+        description = "Update a pipeline action"
 )
 public class UpdateCmd extends AbstractActionsCmd {
 
     @CommandLine.Mixin
     ActionRefOptions actionRefOptions;
 
-    @CommandLine.Option(names = {"-s", "--status"}, description = "Action status (pause or active).")
+    @CommandLine.Option(names = {"-s", "--status"}, description = "Action status (pause or active)")
     public String status;
 
-    @CommandLine.Option(names = {"--new-name"}, description = "Action new name.")
+    @CommandLine.Option(names = {"--new-name"}, description = "Updated action name. Must be unique per workspace. Names consist of alphanumeric, hyphen, and underscore characters.")
     public String newName;
 
     @CommandLine.Mixin

src/main/java/io/seqera/tower/cli/commands/actions/ViewCmd.java

@@ -33,7 +33,7 @@
 
 @CommandLine.Command(
         name = "view",
-        description = "Describe an existing Pipeline Action."
+        description = "View pipeline action details"
 )
 public class ViewCmd extends AbstractActionsCmd {
 

src/main/java/io/seqera/tower/cli/commands/actions/add/AddGitHubCmd.java

@@ -22,7 +22,7 @@
 
 @CommandLine.Command(
         name = "github",
-        description = "Add a GitHub action."
+        description = "Add a pipeline action triggered by GitHub events"
 )
 public class AddGitHubCmd extends AbstractAddCmd {
     @Override

src/main/java/io/seqera/tower/cli/commands/actions/add/AddTowerCmd.java

@@ -22,7 +22,7 @@
 
 @CommandLine.Command(
         name = "tower",
-        description = "Add a Tower action."
+        description = "Add a pipeline action triggered by Seqera Platform events"
 )
 public class AddTowerCmd extends AbstractAddCmd {
     @Override