@xano/cli 0.0.37 → 0.0.40

package/dist/commands/profile/create/index.js

@@ -20,9 +20,6 @@ Profile 'staging' created successfully at ~/.xano/credentials.yaml
 `,
         `$ xano profile:create dev -i https://dev-instance.xano.com -t token789 -w my-workspace -b feature-branch
 Profile 'dev' created successfully at ~/.xano/credentials.yaml
-`,
-        `$ xano profile:create dev -i https://dev-instance.xano.com -t token789 -w my-workspace -b feature-branch -j my-project
-Profile 'dev' created successfully at ~/.xano/credentials.yaml
 `,
         `$ xano profile:create production --account_origin https://account.xano.com --instance_origin https://instance.xano.com --access_token token123 --default
 Profile 'production' created successfully at ~/.xano/credentials.yaml
@@ -55,16 +52,6 @@ Default profile set to 'production'
             description: 'Instance origin URL',
             required: true,
         }),
-        project: Flags.string({
-            char: 'j',
-            description: 'Project name',
-            required: false,
-        }),
-        run_base_url: Flags.string({
-            char: 'r',
-            description: 'Xano Run API base URL (default: https://app.xano.com/)',
-            required: false,
-        }),
         workspace: Flags.string({
             char: 'w',
             description: 'Workspace name',
@@ -106,8 +93,6 @@ Default profile set to 'production'
             instance_origin: flags.instance_origin,
             ...(flags.workspace && { workspace: flags.workspace }),
             ...(flags.branch && { branch: flags.branch }),
-            ...(flags.project && { project: flags.project }),
-            ...(flags.run_base_url && { run_base_url: flags.run_base_url }),
         };
         // Set default if flag is provided
         if (flags.default) {

package/dist/commands/profile/edit/index.d.ts

@@ -10,12 +10,8 @@ export default class ProfileEdit extends BaseCommand {
         account_origin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         instance_origin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'remove-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'remove-project': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'remove-run-base-url': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'remove-workspace': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        run_base_url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/profile/edit/index.js

@@ -27,12 +27,6 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
 `,
         `$ xano profile:edit --remove-branch
 Profile 'default' updated successfully at ~/.xano/credentials.yaml
-`,
-        `$ xano profile:edit -j my-project
-Profile 'default' updated successfully at ~/.xano/credentials.yaml
-`,
-        `$ xano profile:edit --remove-project
-Profile 'default' updated successfully at ~/.xano/credentials.yaml
 `,
     ];
     static flags = {
@@ -57,36 +51,16 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
             description: 'Update instance origin URL',
             required: false,
         }),
-        project: Flags.string({
-            char: 'j',
-            description: 'Update project ID',
-            required: false,
-        }),
         'remove-branch': Flags.boolean({
             default: false,
             description: 'Remove branch from profile',
             required: false,
         }),
-        'remove-project': Flags.boolean({
-            default: false,
-            description: 'Remove project from profile',
-            required: false,
-        }),
-        'remove-run-base-url': Flags.boolean({
-            default: false,
-            description: 'Remove run_base_url from profile (use default)',
-            required: false,
-        }),
         'remove-workspace': Flags.boolean({
             default: false,
             description: 'Remove workspace from profile',
             required: false,
         }),
-        run_base_url: Flags.string({
-            char: 'r',
-            description: 'Update Xano Run API base URL',
-            required: false,
-        }),
         workspace: Flags.string({
             char: 'w',
             description: 'Update workspace name',
@@ -123,10 +97,13 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
         // Get the existing profile
         const existingProfile = credentials.profiles[profileName];
         // Check if any flags were provided
-        const hasFlags = flags.account_origin || flags.instance_origin || flags.access_token ||
-            flags.workspace || flags.branch || flags.project || flags.run_base_url ||
-            flags['remove-workspace'] || flags['remove-branch'] || flags['remove-project'] ||
-            flags['remove-run-base-url'];
+        const hasFlags = flags.account_origin ||
+            flags.instance_origin ||
+            flags.access_token ||
+            flags.workspace ||
+            flags.branch ||
+            flags['remove-workspace'] ||
+            flags['remove-branch'];
         if (!hasFlags) {
             this.error('No fields specified to update. Use at least one flag to edit the profile.');
         }
@@ -138,8 +115,6 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
             ...(flags.access_token !== undefined && { access_token: flags.access_token }),
             ...(flags.workspace !== undefined && { workspace: flags.workspace }),
             ...(flags.branch !== undefined && { branch: flags.branch }),
-            ...(flags.project !== undefined && { project: flags.project }),
-            ...(flags.run_base_url !== undefined && { run_base_url: flags.run_base_url }),
         };
         // Handle removal flags
         if (flags['remove-workspace']) {
@@ -148,12 +123,6 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
         if (flags['remove-branch']) {
             delete updatedProfile.branch;
         }
-        if (flags['remove-project']) {
-            delete updatedProfile.project;
-        }
-        if (flags['remove-run-base-url']) {
-            delete updatedProfile.run_base_url;
-        }
         credentials.profiles[profileName] = updatedProfile;
         // Write the updated credentials back to the file
         try {

package/dist/commands/profile/wizard/index.d.ts

@@ -9,8 +9,6 @@ export default class ProfileWizard extends Command {
     run(): Promise<void>;
     private fetchBranches;
     private fetchInstances;
-    private fetchProjects;
-    private fetchRunProjects;
     private fetchWorkspaces;
     private getDefaultProfileName;
     private saveProfile;

package/dist/commands/profile/wizard/index.js

@@ -4,7 +4,6 @@ import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
-import { DEFAULT_RUN_BASE_URL } from '../../../lib/run-http-client.js';
 export default class ProfileWizard extends Command {
     static description = 'Create a new profile configuration using an interactive wizard';
     static examples = [
@@ -97,7 +96,6 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
             // Step 5: Workspace selection
             let workspace;
             let branch;
-            let project;
             // Fetch workspaces from the selected instance
             this.log('');
             this.log('Fetching available workspaces...');
@@ -157,56 +155,8 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
                         ]);
                         branch = selectedBranch || undefined;
                     }
-                    // Step 6: Project selection
-                    this.log('');
-                    this.log('Fetching available projects...');
-                    let projects = [];
-                    try {
-                        projects = await this.fetchProjects(accessToken, selectedInstance.origin, workspace, branch);
-                    }
-                    catch (error) {
-                        this.warn(`Failed to fetch projects: ${error instanceof Error ? error.message : String(error)}`);
-                    }
-                    // If projects were fetched, let user select one
-                    if (projects.length > 0) {
-                        this.log('');
-                        const { selectedProject } = await inquirer.prompt([
-                            {
-                                choices: [
-                                    { name: '(Skip project)', value: '' },
-                                    ...projects.map((proj) => ({
-                                        name: proj.name,
-                                        value: proj.id,
-                                    })),
-                                ],
-                                message: 'Select a project',
-                                name: 'selectedProject',
-                                type: 'list',
-                            },
-                        ]);
-                        project = selectedProject || undefined;
-                    }
                 }
             }
-            // Step 7: Fetch run projects and auto-select the first one if no project was selected
-            this.log('');
-            this.log('Fetching available run projects...');
-            try {
-                const runProjects = await this.fetchRunProjects(accessToken);
-                if (runProjects.length > 0) {
-                    // Use run project if no metadata project was selected
-                    if (!project) {
-                        project = runProjects[0].id;
-                    }
-                    this.log(`✓ Found ${runProjects.length} run project(s). Using "${runProjects[0].name}" as default.`);
-                }
-                else {
-                    this.log('No run projects found. You can create one later with "xano run projects create".');
-                }
-            }
-            catch {
-                // Silently ignore - project will remain undefined
-            }
             // Save profile
             await this.saveProfile({
                 access_token: accessToken,
@@ -214,7 +164,6 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
                 branch,
                 instance_origin: selectedInstance.origin,
                 name: profileName,
-                project,
                 workspace,
             }, true);
             this.log('');
@@ -302,60 +251,6 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
         }
         return [];
     }
-    async fetchProjects(accessToken, origin, workspaceId, branchId) {
-        const branchParam = branchId ? `?branch=${branchId}` : '';
-        const response = await fetch(`${origin}/api:meta/workspace/${workspaceId}/project${branchParam}`, {
-            headers: {
-                accept: 'application/json',
-                Authorization: `Bearer ${accessToken}`,
-            },
-            method: 'GET',
-        });
-        if (!response.ok) {
-            if (response.status === 401) {
-                throw new Error('Unauthorized. Please check your access token.');
-            }
-            throw new Error(`API request failed with status ${response.status}`);
-        }
-        const data = (await response.json());
-        // Transform API response to Project format
-        // Assuming the API returns an array or object with projects
-        if (Array.isArray(data)) {
-            return data.map((proj) => ({
-                id: proj.id || proj.name,
-                name: proj.name,
-            }));
-        }
-        // If it's an object, try to extract projects
-        if (data && typeof data === 'object') {
-            const projects = data.projects || data.data || [];
-            if (Array.isArray(projects)) {
-                return projects.map((proj) => ({
-                    id: proj.id || proj.name,
-                    name: proj.name,
-                }));
-            }
-        }
-        return [];
-    }
-    async fetchRunProjects(accessToken, runBaseUrl = DEFAULT_RUN_BASE_URL) {
-        const baseUrl = runBaseUrl.endsWith('/') ? runBaseUrl.slice(0, -1) : runBaseUrl;
-        const response = await fetch(`${baseUrl}/api:run/project`, {
-            headers: {
-                Authorization: `Bearer ${accessToken}`,
-                'Content-Type': 'application/json',
-            },
-            method: 'GET',
-        });
-        if (!response.ok) {
-            if (response.status === 401) {
-                throw new Error('Unauthorized. Please check your access token.');
-            }
-            throw new Error(`API request failed with status ${response.status}`);
-        }
-        const data = (await response.json());
-        return Array.isArray(data) ? data : [];
-    }
     async fetchWorkspaces(accessToken, origin) {
         const response = await fetch(`${origin}/api:meta/workspace`, {
             headers: {
@@ -437,7 +332,6 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
             instance_origin: profile.instance_origin,
             ...(profile.workspace && { workspace: profile.workspace }),
             ...(profile.branch && { branch: profile.branch }),
-            ...(profile.project && { project: profile.project }),
         };
         // Set as default if requested
         if (setAsDefault) {

package/dist/commands/profile/{project → workspace}/index.d.ts

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-export default class ProfileProject extends Command {
+export default class ProfileWorkspace extends Command {
     static description: string;
     static examples: string[];
     run(): Promise<void>;

package/dist/commands/profile/{project → workspace}/index.js

@@ -3,14 +3,14 @@ import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
-export default class ProfileProject extends Command {
-    static description = 'Print the project for the default profile';
+export default class ProfileWorkspace extends Command {
+    static description = 'Print the workspace ID for the default profile';
     static examples = [
-        `$ xano profile:project
-my-project-id
+        `$ xano profile:workspace
+abc123-workspace-id
 `,
-        `$ xano profile:project | pbcopy
-# Copies the project to clipboard on macOS
+        `$ xano profile:workspace | pbcopy
+# Copies the workspace ID to clipboard on macOS
 `,
     ];
     async run() {
@@ -43,12 +43,12 @@ my-project-id
             this.error(`Default profile '${defaultProfileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}`);
         }
         const profile = credentials.profiles[defaultProfileName];
-        // Get and display the project
-        if (profile.project) {
-            this.log(profile.project);
+        // Get and display the workspace ID
+        if (profile.workspace) {
+            this.log(profile.workspace);
         }
         else {
-            this.error(`Profile '${defaultProfileName}' does not have a project set. Set one using 'profile:edit -j <project>'.`);
+            this.error(`Profile '${defaultProfileName}' does not have a workspace set. Set one using 'profile:edit ${defaultProfileName} -w <workspace_id>'.`);
         }
     }
 }

package/dist/commands/release/delete/index.d.ts

@@ -1,10 +1,7 @@
 import BaseCommand from '../../../base-command.js';
 export default class ReleaseDelete extends BaseCommand {
     static args: {
-        release_id: import("@oclif/core/interfaces").Arg<number, {
-            max?: number;
-            min?: number;
-        }>;
+        release_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];
@@ -18,4 +15,5 @@ export default class ReleaseDelete extends BaseCommand {
     run(): Promise<void>;
     private confirm;
     private loadCredentials;
+    private resolveReleaseName;
 }

package/dist/commands/release/delete/index.js

@@ -6,21 +6,21 @@ import * as path from 'node:path';
 import BaseCommand from '../../../base-command.js';
 export default class ReleaseDelete extends BaseCommand {
     static args = {
-        release_id: Args.integer({
-            description: 'Release ID to delete',
+        release_name: Args.string({
+            description: 'Release name to delete',
             required: true,
         }),
     };
     static description = 'Delete a release permanently. This action cannot be undone.';
     static examples = [
-        `$ xano release delete 10
-Are you sure you want to delete release #10? This action cannot be undone. (y/N) y
-Deleted release #10
+        `$ xano release delete v1.0
+Are you sure you want to delete release 'v1.0'? This action cannot be undone. (y/N) y
+Deleted release 'v1.0'
 `,
-        `$ xano release delete 10 --force
-Deleted release #10
+        `$ xano release delete v1.0 --force
+Deleted release 'v1.0'
 `,
-        `$ xano release delete 10 -f -o json`,
+        `$ xano release delete v1.0 -f -o json`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -62,14 +62,15 @@ Deleted release #10
         if (!workspaceId) {
             this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
         }
-        const releaseId = args.release_id;
+        const releaseName = args.release_name;
         if (!flags.force) {
-            const confirmed = await this.confirm(`Are you sure you want to delete release #${releaseId}? This action cannot be undone.`);
+            const confirmed = await this.confirm(`Are you sure you want to delete release '${releaseName}'? This action cannot be undone.`);
             if (!confirmed) {
                 this.log('Deletion cancelled.');
                 return;
             }
         }
+        const releaseId = await this.resolveReleaseName(profile, workspaceId, releaseName, flags.verbose);
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/release/${releaseId}`;
         try {
             const response = await this.verboseFetch(apiUrl, {
@@ -84,10 +85,10 @@ Deleted release #10
                 this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
             }
             if (flags.output === 'json') {
-                this.log(JSON.stringify({ deleted: true, release_id: releaseId }, null, 2));
+                this.log(JSON.stringify({ deleted: true, release_name: releaseName }, null, 2));
             }
             else {
-                this.log(`Deleted release #${releaseId}`);
+                this.log(`Deleted release '${releaseName}'`);
             }
         }
         catch (error) {
@@ -131,4 +132,30 @@ Deleted release #10
             this.error(`Failed to parse credentials file: ${error}`);
         }
     }
+    async resolveReleaseName(profile, workspaceId, releaseName, verbose) {
+        const listUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/release`;
+        const response = await this.verboseFetch(listUrl, {
+            headers: {
+                'accept': 'application/json',
+                'Authorization': `Bearer ${profile.access_token}`,
+            },
+            method: 'GET',
+        }, verbose, profile.access_token);
+        if (!response.ok) {
+            const errorText = await response.text();
+            this.error(`Failed to list releases: ${response.status} ${response.statusText}\n${errorText}`);
+        }
+        const data = await response.json();
+        const releases = Array.isArray(data)
+            ? data
+            : (data && typeof data === 'object' && 'items' in data && Array.isArray(data.items))
+                ? data.items
+                : [];
+        const match = releases.find(r => r.name === releaseName);
+        if (!match) {
+            const available = releases.map(r => r.name).join(', ');
+            this.error(`Release '${releaseName}' not found.${available ? ` Available releases: ${available}` : ''}`);
+        }
+        return match.id;
+    }
 }

package/dist/commands/release/edit/index.d.ts

@@ -1,10 +1,7 @@
 import BaseCommand from '../../../base-command.js';
 export default class ReleaseEdit extends BaseCommand {
     static args: {
-        release_id: import("@oclif/core/interfaces").Arg<number, {
-            max?: number;
-            min?: number;
-        }>;
+        release_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];
@@ -18,4 +15,5 @@ export default class ReleaseEdit extends BaseCommand {
     };
     run(): Promise<void>;
     private loadCredentials;
+    private resolveReleaseName;
 }

package/dist/commands/release/edit/index.js

@@ -6,17 +6,17 @@ import * as path from 'node:path';
 import BaseCommand from '../../../base-command.js';
 export default class ReleaseEdit extends BaseCommand {
     static args = {
-        release_id: Args.integer({
-            description: 'Release ID to edit',
+        release_name: Args.string({
+            description: 'Release name to edit',
             required: true,
         }),
     };
     static description = 'Edit an existing release';
     static examples = [
-        `$ xano release edit 10 --name "v1.0-final" --description "Updated description"
+        `$ xano release edit v1.0 --name "v1.0-final" --description "Updated description"
 Updated release: v1.0-final - ID: 10
 `,
-        `$ xano release edit 10 --description "New description" -o json`,
+        `$ xano release edit v1.0 --description "New description" -o json`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -62,7 +62,7 @@ Updated release: v1.0-final - ID: 10
         if (!workspaceId) {
             this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
         }
-        const releaseId = args.release_id;
+        const releaseId = await this.resolveReleaseName(profile, workspaceId, args.release_name, flags.verbose);
         const baseUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/release/${releaseId}`;
         const headers = {
             'accept': 'application/json',
@@ -134,4 +134,30 @@ Updated release: v1.0-final - ID: 10
             this.error(`Failed to parse credentials file: ${error}`);
         }
     }
+    async resolveReleaseName(profile, workspaceId, releaseName, verbose) {
+        const listUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/release`;
+        const response = await this.verboseFetch(listUrl, {
+            headers: {
+                'accept': 'application/json',
+                'Authorization': `Bearer ${profile.access_token}`,
+            },
+            method: 'GET',
+        }, verbose, profile.access_token);
+        if (!response.ok) {
+            const errorText = await response.text();
+            this.error(`Failed to list releases: ${response.status} ${response.statusText}\n${errorText}`);
+        }
+        const data = await response.json();
+        const releases = Array.isArray(data)
+            ? data
+            : (data && typeof data === 'object' && 'items' in data && Array.isArray(data.items))
+                ? data.items
+                : [];
+        const match = releases.find(r => r.name === releaseName);
+        if (!match) {
+            const available = releases.map(r => r.name).join(', ');
+            this.error(`Release '${releaseName}' not found.${available ? ` Available releases: ${available}` : ''}`);
+        }
+        return match.id;
+    }
 }

package/dist/commands/release/export/index.d.ts

@@ -1,10 +1,7 @@
 import BaseCommand from '../../../base-command.js';
 export default class ReleaseExport extends BaseCommand {
     static args: {
-        release_id: import("@oclif/core/interfaces").Arg<number, {
-            max?: number;
-            min?: number;
-        }>;
+        release_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];
@@ -17,4 +14,5 @@ export default class ReleaseExport extends BaseCommand {
     };
     run(): Promise<void>;
     private loadCredentials;
+    private resolveReleaseName;
 }

package/dist/commands/release/export/index.js

@@ -6,18 +6,18 @@ import * as yaml from 'js-yaml';
 import BaseCommand from '../../../base-command.js';
 export default class ReleaseExport extends BaseCommand {
     static args = {
-        release_id: Args.integer({
-            description: 'Release ID to export',
+        release_name: Args.string({
+            description: 'Release name to export',
             required: true,
         }),
     };
     static description = 'Export (download) a release to a local file';
     static examples = [
-        `$ xano release export 10
-Downloaded release #10 to ./release-10.tar.gz
+        `$ xano release export v1.0
+Downloaded release 'v1.0' to ./release-v1.0.tar.gz
 `,
-        `$ xano release export 10 --output ./backups/my-release.tar.gz`,
-        `$ xano release export 10 -o json`,
+        `$ xano release export v1.0 --output ./backups/my-release.tar.gz`,
+        `$ xano release export v1.0 -o json`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -29,7 +29,7 @@ Downloaded release #10 to ./release-10.tar.gz
             required: false,
         }),
         output: Flags.string({
-            description: 'Output file path (defaults to ./release-{id}.tar.gz)',
+            description: 'Output file path (defaults to ./release-{name}.tar.gz)',
             required: false,
         }),
         workspace: Flags.string({
@@ -57,7 +57,8 @@ Downloaded release #10 to ./release-10.tar.gz
         if (!workspaceId) {
             this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
         }
-        const releaseId = args.release_id;
+        const releaseName = args.release_name;
+        const releaseId = await this.resolveReleaseName(profile, workspaceId, releaseName, flags.verbose);
         // Step 1: Get signed download URL
         const exportUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/release/${releaseId}/export`;
         try {
@@ -77,7 +78,8 @@ Downloaded release #10 to ./release-10.tar.gz
                 this.error('API did not return a download URL');
             }
             // Step 2: Download the file
-            const outputPath = flags.output || `release-${releaseId}.tar.gz`;
+            const safeFilename = releaseName.replaceAll(/[^\w.-]/g, '_');
+            const outputPath = flags.output || `release-${safeFilename}.tar.gz`;
             const resolvedPath = path.resolve(outputPath);
             const downloadResponse = await fetch(exportLink.src);
             if (!downloadResponse.ok) {
@@ -104,11 +106,11 @@ Downloaded release #10 to ./release-10.tar.gz
                 fileStream.on('error', reject);
             });
             if (flags.format === 'json') {
-                this.log(JSON.stringify({ bytes: totalBytes, file: resolvedPath, release_id: releaseId }, null, 2));
+                this.log(JSON.stringify({ bytes: totalBytes, file: resolvedPath, release_name: releaseName }, null, 2));
             }
             else {
                 const sizeMb = (totalBytes / 1024 / 1024).toFixed(2);
-                this.log(`Downloaded release #${releaseId} to ${resolvedPath} (${sizeMb} MB)`);
+                this.log(`Downloaded release '${releaseName}' to ${resolvedPath} (${sizeMb} MB)`);
             }
         }
         catch (error) {
@@ -139,4 +141,30 @@ Downloaded release #10 to ./release-10.tar.gz
             this.error(`Failed to parse credentials file: ${error}`);
         }
     }
+    async resolveReleaseName(profile, workspaceId, releaseName, verbose) {
+        const listUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/release`;
+        const response = await this.verboseFetch(listUrl, {
+            headers: {
+                'accept': 'application/json',
+                'Authorization': `Bearer ${profile.access_token}`,
+            },
+            method: 'GET',
+        }, verbose, profile.access_token);
+        if (!response.ok) {
+            const errorText = await response.text();
+            this.error(`Failed to list releases: ${response.status} ${response.statusText}\n${errorText}`);
+        }
+        const data = await response.json();
+        const releases = Array.isArray(data)
+            ? data
+            : (data && typeof data === 'object' && 'items' in data && Array.isArray(data.items))
+                ? data.items
+                : [];
+        const match = releases.find(r => r.name === releaseName);
+        if (!match) {
+            const available = releases.map(r => r.name).join(', ');
+            this.error(`Release '${releaseName}' not found.${available ? ` Available releases: ${available}` : ''}`);
+        }
+        return match.id;
+    }
 }