feat: add pipeline versioning support

conf/reflect-config.json

@@ -1469,12 +1469,6 @@
   "allDeclaredMethods":true,
   "methods":[{"name":"<init>","parameterTypes":[] }]
 },
-{
-  "name":"io.seqera.tower.cli.commands.pipelines.LabelsCmd",
-  "allDeclaredFields":true,
-  "queryAllDeclaredMethods":true,
-  "methods":[{"name":"<init>","parameterTypes":[] }]
-},
 {
   "name":"io.seqera.tower.cli.commands.pipelines.LaunchOptions",
   "allDeclaredFields":true,
@@ -1511,6 +1505,60 @@
   "allDeclaredMethods":true,
   "methods":[{"name":"<init>","parameterTypes":[] }]
 },
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.labels.LabelsCmd",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.ListCmd",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.UpdateCmd",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.UpdateCmd$UpdateOptions",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.VersionRefOptions",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.VersionRefOptions$VersionRef",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.VersionsCmd",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.ViewCmd",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
+{
+  "name":"io.seqera.tower.cli.commands.pipelines.versions.ViewCmd$VersionRef",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "methods":[{"name":"<init>","parameterTypes":[] }]
+},
 {
   "name":"io.seqera.tower.cli.commands.pipelineschemas.AbstractPipelineSchemasCmd",
   "allDeclaredFields":true,
@@ -2187,12 +2235,36 @@
   "allDeclaredMethods":true,
   "allDeclaredConstructors":true
 },
+{
+  "name":"io.seqera.tower.cli.responses.pipelines.PipelinesUpdated",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "queryAllDeclaredConstructors":true
+},
 {
   "name":"io.seqera.tower.cli.responses.pipelines.PipelinesView",
   "allDeclaredFields":true,
   "queryAllDeclaredMethods":true,
   "queryAllDeclaredConstructors":true
 },
+{
+  "name":"io.seqera.tower.cli.responses.pipelines.versions.ListPipelineVersionsCmdResponse",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "queryAllDeclaredConstructors":true
+},
+{
+  "name":"io.seqera.tower.cli.responses.pipelines.versions.UpdatePipelineVersionCmdResponse",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "queryAllDeclaredConstructors":true
+},
+{
+  "name":"io.seqera.tower.cli.responses.pipelines.versions.ViewPipelineVersionCmdResponse",
+  "allDeclaredFields":true,
+  "queryAllDeclaredMethods":true,
+  "queryAllDeclaredConstructors":true
+},
 {
   "name":"io.seqera.tower.cli.responses.pipelineschemas.PipelineSchemasAdded",
   "allDeclaredFields":true,
@@ -4027,6 +4099,7 @@
 },
 {
   "name":"io.seqera.tower.model.ListPipelineVersionsResponse",
+  "allDeclaredFields":true,
   "queryAllDeclaredMethods":true,
   "queryAllDeclaredConstructors":true,
   "methods":[{"name":"<init>","parameterTypes":[] }, {"name":"addVersionsItem","parameterTypes":["io.seqera.tower.model.PipelineDbDto"] }, {"name":"equals","parameterTypes":["java.lang.Object"] }, {"name":"getTotalSize","parameterTypes":[] }, {"name":"getVersions","parameterTypes":[] }, {"name":"hashCode","parameterTypes":[] }, {"name":"setTotalSize","parameterTypes":["java.lang.Long"] }, {"name":"setVersions","parameterTypes":["java.util.List"] }, {"name":"toIndentedString","parameterTypes":["java.lang.Object"] }, {"name":"toString","parameterTypes":[] }, {"name":"totalSize","parameterTypes":["java.lang.Long"] }, {"name":"versions","parameterTypes":["java.util.List"] }]
@@ -4352,6 +4425,7 @@
 },
 {
   "name":"io.seqera.tower.model.PipelineVersionManageRequest",
+  "allDeclaredFields":true,
   "queryAllDeclaredMethods":true,
   "queryAllDeclaredConstructors":true,
   "methods":[{"name":"<init>","parameterTypes":[] }, {"name":"equals","parameterTypes":["java.lang.Object"] }, {"name":"getIsDefault","parameterTypes":[] }, {"name":"getName","parameterTypes":[] }, {"name":"hashCode","parameterTypes":[] }, {"name":"isDefault","parameterTypes":["java.lang.Boolean"] }, {"name":"name","parameterTypes":["java.lang.String"] }, {"name":"setIsDefault","parameterTypes":["java.lang.Boolean"] }, {"name":"setName","parameterTypes":["java.lang.String"] }, {"name":"toIndentedString","parameterTypes":["java.lang.Object"] }, {"name":"toString","parameterTypes":[] }]

conf/resource-config.json

@@ -82,10 +82,10 @@
     "locales":["und"]
   }, {
     "name":"org.glassfish.jersey.client.internal.localization",
-    "locales":["und"]
+    "locales":["", "und"]
   }, {
     "name":"org.glassfish.jersey.internal.localization",
-    "locales":["und"]
+    "locales":["", "und"]
   }, {
     "name":"org.glassfish.jersey.media.multipart.internal.localization"
   }]

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

@@ -31,6 +31,7 @@
 import io.seqera.tower.api.OrgsApi;
 import io.seqera.tower.api.PipelineSchemasApi;
 import io.seqera.tower.api.PipelineSecretsApi;
+import io.seqera.tower.api.PipelineVersionsApi;
 import io.seqera.tower.api.PipelinesApi;
 import io.seqera.tower.api.PlatformsApi;
 import io.seqera.tower.api.ServiceInfoApi;
@@ -44,6 +45,7 @@
 import io.seqera.tower.cli.Tower;
 import io.seqera.tower.cli.commands.labels.Label;
 import io.seqera.tower.cli.commands.labels.LabelsFinder;
+import io.seqera.tower.cli.commands.pipelines.versions.VersionRefOptions;
 import io.seqera.tower.cli.exceptions.ComputeEnvNotFoundException;
 import io.seqera.tower.cli.exceptions.InvalidWorkspaceParameterException;
 import io.seqera.tower.cli.exceptions.MissingTowerAccessTokenException;
@@ -60,10 +62,12 @@
 import io.seqera.tower.model.Credentials;
 import io.seqera.tower.model.DataStudioQueryAttribute;
 import io.seqera.tower.model.ListComputeEnvsResponseEntry;
+import io.seqera.tower.model.ListPipelineVersionsResponse;
 import io.seqera.tower.model.ListWorkspacesAndOrgResponse;
 import io.seqera.tower.model.OrgAndWorkspaceDto;
 import io.seqera.tower.model.PipelineDbDto;
 import io.seqera.tower.model.PipelineQueryAttribute;
+import io.seqera.tower.model.PipelineVersionFullInfoDto;
 import io.seqera.tower.model.UserResponseDto;
 import io.seqera.tower.model.WorkflowQueryAttribute;
 import org.glassfish.jersey.CommonProperties;
@@ -83,6 +87,7 @@
 import java.util.Map;
 import java.util.Objects;
 import java.util.Properties;
+import java.util.function.Predicate;
 import java.util.logging.Logger;
 import java.util.stream.Collectors;
 
@@ -116,6 +121,7 @@ public abstract class AbstractApiCmd extends AbstractCmd {
     private PipelinesApi pipelinesApi;
     private PipelineSchemasApi pipelineSchemasApi;
     private PipelineSecretsApi pipelineSecretsApi;
+    private PipelineVersionsApi pipelineVersionsApi;
     private PlatformsApi platformsApi;
     private ServiceInfoApi serviceInfoApi;
     private StudiosApi studiosApi;
@@ -235,6 +241,10 @@ protected PipelinesApi pipelinesApi() throws ApiException {
         return pipelinesApi == null ? new PipelinesApi(apiClient()) : pipelinesApi;
     }
 
+    protected PipelineVersionsApi pipelineVersionsApi() throws ApiException {
+        return pipelineVersionsApi == null ? new PipelineVersionsApi(apiClient()) : pipelineVersionsApi;
+    }
+
     protected PlatformsApi platformsApi() throws ApiException {
         return platformsApi == null ? new PlatformsApi(apiClient()) : platformsApi;
     }
@@ -580,6 +590,39 @@ protected String workspaceRef(Long workspaceId) throws ApiException {
         return buildWorkspaceRef(orgName(workspaceId), workspaceName(workspaceId));
     }
 
+    protected PipelineVersionFullInfoDto findPipelineVersionByRef(Long pipelineId, Long wspId, VersionRefOptions.VersionRef ref) throws ApiException {
+        String search = ref.versionName;
+        Boolean isPublished = ref.versionName != null ? true : null;
+        Predicate<PipelineVersionFullInfoDto> matcher = ref.versionId != null
+                ? v -> ref.versionId.equals(v.getId())
+                : v -> ref.versionName.equals(v.getName());
+
+        ListPipelineVersionsResponse response = pipelineVersionsApi()
+                .listPipelineVersions(pipelineId, wspId, null, null, search, isPublished);
+
+        if (response.getVersions() == null) {
+            throw new TowerException("No versions available for the pipeline, check if Pipeline versioning feature is enabled for the workspace");
+        }
+
+        return response.getVersions().stream()
+                .map(PipelineDbDto::getVersion)
+                .filter(Objects::nonNull)
+                .filter(matcher)
+                .findFirst()
+                .orElse(null);
+    }
+
+    protected String resolvePipelineVersionId(Long pipelineId, Long wspId, VersionRefOptions.VersionRef versionRef) throws ApiException {
+        if (versionRef == null) return null;
+        if (versionRef.versionId != null) return versionRef.versionId;
+
+        PipelineVersionFullInfoDto version = findPipelineVersionByRef(pipelineId, wspId, versionRef);
+        if (version == null) {
+            throw new TowerException(String.format("Pipeline version '%s' not found", versionRef.versionName));
+        }
+        return version.getId();
+    }
+
     protected Long sourceWorkspaceId(Long currentWorkspace, PipelineDbDto pipeline) {
         if (pipeline == null)
             return null;

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

@@ -21,6 +21,7 @@
 import io.seqera.tower.cli.commands.enums.OutputType;
 import io.seqera.tower.cli.commands.global.WorkspaceOptionalOptions;
 import io.seqera.tower.cli.commands.labels.Label;
+import io.seqera.tower.cli.commands.pipelines.versions.VersionRefOptions;
 import io.seqera.tower.cli.exceptions.InvalidResponseException;
 import io.seqera.tower.cli.responses.Response;
 import io.seqera.tower.cli.responses.runs.RunSubmited;
@@ -83,6 +84,10 @@ public class LaunchCmd extends AbstractRootCmd {
     @Option(names = {"--commit-id"}, description = "Specific Git commit hash to pin the pipeline execution to.")
     String commitId;
 
+    // Explicit "0..1" for clarity — contrasts with the required "1" in VersionRefOptions. @Mixin won't work here as it would lose mutual exclusivity.
+    @ArgGroup(multiplicity = "0..1")
+    VersionRefOptions.VersionRef versionRef;
+
     @Option(names = {"--wait"}, description = "Wait until workflow reaches specified status: ${COMPLETION-CANDIDATES}")
     public WorkflowStatus wait;
 
@@ -178,8 +183,9 @@ protected Response runTowerPipeline(Long wspId) throws ApiException, IOException
         }
 
         Long sourceWorkspaceId = sourceWorkspaceId(wspId, pipe);
+        String versionId = resolvePipelineVersionId(pipe.getPipelineId(), wspId, versionRef);
 
-        LaunchDbDto launch = pipelinesApi().describePipelineLaunch(pipe.getPipelineId(), wspId, sourceWorkspaceId, null).getLaunch();
+        LaunchDbDto launch = pipelinesApi().describePipelineLaunch(pipe.getPipelineId(), wspId, sourceWorkspaceId, versionId).getLaunch();
 
         WorkflowLaunchRequest launchRequest = createLaunchRequest(launch);
         if (computeEnv != null) {

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

@@ -21,10 +21,11 @@
 import io.seqera.tower.cli.commands.pipelines.DeleteCmd;
 import io.seqera.tower.cli.commands.pipelines.ExportCmd;
 import io.seqera.tower.cli.commands.pipelines.ImportCmd;
-import io.seqera.tower.cli.commands.pipelines.LabelsCmd;
+import io.seqera.tower.cli.commands.pipelines.labels.LabelsCmd;
 import io.seqera.tower.cli.commands.pipelines.ListCmd;
 import io.seqera.tower.cli.commands.pipelines.UpdateCmd;
 import io.seqera.tower.cli.commands.pipelines.ViewCmd;
+import io.seqera.tower.cli.commands.pipelines.versions.VersionsCmd;
 import picocli.CommandLine.Command;
 
 
@@ -40,6 +41,7 @@
                 ExportCmd.class,
                 ImportCmd.class,
                 LabelsCmd.class,
+                VersionsCmd.class
         }
 )
 public class PipelinesCmd extends AbstractRootCmd {

src/main/java/io/seqera/tower/cli/commands/pipelines/AbstractPipelinesCmd.java

@@ -63,6 +63,13 @@ protected PipelineDbDto fetchPipeline(PipelineRefOptions pipelineRefOptions, Lon
         return pipelinesApi().describePipeline(pipelineId, List.of(attributes), wspId, null).getPipeline();
     }
 
+    protected void throwPipelineNotFoundException(PipelineRefOptions pipelineRefOptions, Long wspId) throws ApiException, PipelineNotFoundException {
+        if (pipelineRefOptions.pipeline.pipelineId != null) {
+            throw new PipelineNotFoundException(pipelineRefOptions.pipeline.pipelineId, workspaceRef(wspId));
+        }
+        throw new PipelineNotFoundException(pipelineRefOptions.pipeline.pipelineName, workspaceRef(wspId));
+    }
+
     private static String quotePipelineName(String pipelineName) {
 
         if (pipelineName == null) return null;