@hubspot/cli 7.8.0-experimental.0 → 7.8.2-experimental.0

package/bin/cli.js

@@ -42,7 +42,6 @@ import appCommand from '../commands/app.js';
 import testAccountCommands from '../commands/testAccount.js';
 import getStartedCommand from '../commands/getStarted.js';
 import mcpCommand from '../commands/mcp.js';
-import getStartedV2Command from '../commands/getStartedV2.js';
 function getTerminalWidth() {
     const width = yargs().terminalWidth();
     if (width >= 100)
@@ -93,7 +92,6 @@ const argv = yargs(process.argv.slice(2))
     type: 'boolean',
 })
     .check(performChecks)
-    .command(getStartedV2Command)
     .command(authCommand)
     .command(initCommand)
     .command(logsCommand)

package/commands/__tests__/getStarted.test.js

@@ -34,8 +34,8 @@ describe('commands/get-started', () => {
         });
     });
     describe('describe', () => {
-        it('should have undefined describe property', () => {
-            expect(getStartedCommand.describe).toBeUndefined();
+        it('should have a defined describe property', () => {
+            expect(getStartedCommand.describe).toBeDefined();
         });
     });
     describe('command structure', () => {

package/commands/__tests__/mcp.test.js

@@ -19,7 +19,7 @@ describe('commands/mcp', () => {
     });
     describe('describe', () => {
         it('should provide a description', () => {
-            expect(mcpCommand.describe).toBeUndefined();
+            expect(mcpCommand.describe).toBeDefined();
         });
     });
     describe('builder', () => {

package/commands/__tests__/project.test.js

@@ -51,9 +51,6 @@ describe('commands/project', () => {
         });
     });
     describe('describe', () => {
-        it('should contain the beta tag', () => {
-            expect(projectCommand.describe).toContain('[BETA]');
-        });
         it('should provide a description', () => {
             expect(projectCommand.describe).toBeDefined();
         });

package/commands/app/__tests__/migrate.test.js

@@ -103,7 +103,6 @@ describe('commands/app/migrate', () => {
                 'platform-version': expect.objectContaining({
                     type: 'string',
                     default: '2025.2',
-                    hidden: true,
                 }),
             }));
         });

package/commands/app/migrate.js

@@ -6,13 +6,13 @@ import { i18n } from '../../lib/lang.js';
 import { ApiErrorContext, logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { migrateApp2025_2 } from '../../lib/app/migrate.js';
-import { uiBetaTag, uiCommandReference, uiLink } from '../../lib/ui/index.js';
+import { uiCommandReference, uiLink } from '../../lib/ui/index.js';
 import { migrateApp2023_2 } from '../../lib/app/migrate_legacy.js';
 import { getIsInProject } from '../../lib/projects/config.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const { v2023_2, v2025_2 } = PLATFORM_VERSIONS;
 const command = 'migrate';
-const describe = undefined; // uiBetaTag(i18n(`commands.project.subcommands.migrateApp.header.text.describe`), false);
+const describe = i18n(`commands.project.subcommands.migrateApp.describe`);
 export function handlerGenerator(commandTrackingName) {
     return async function handler(args) {
         const { derivedAccountId, platformVersion, unstable } = args;
@@ -23,7 +23,7 @@ export function handlerGenerator(commandTrackingName) {
             return process.exit(EXIT_CODES.ERROR);
         }
         logger.log('');
-        logger.log(uiBetaTag(i18n(`commands.project.subcommands.migrateApp.header.text`), false));
+        logger.log(i18n(`commands.project.subcommands.migrateApp.header.text`));
         logger.log(uiLink(i18n(`commands.project.subcommands.migrateApp.header.link`), 'https://developers.hubspot.com/docs/platform/migrate-a-public-app-to-projects'));
         logger.log('');
         try {
@@ -76,7 +76,6 @@ function appMigrateBuilder(yargs) {
         'platform-version': {
             type: 'string',
             choices: [v2023_2, v2025_2],
-            hidden: true,
             default: v2025_2,
         },
         unstable: {
@@ -93,7 +92,7 @@ function appMigrateBuilder(yargs) {
     ]);
     return yargs;
 }
-const builder = makeYargsBuilder(appMigrateBuilder, command, uiBetaTag(i18n(`commands.project.subcommands.migrateApp.describe`), false), {
+const builder = makeYargsBuilder(appMigrateBuilder, command, i18n(`commands.project.subcommands.migrateApp.describe`), {
     useGlobalOptions: true,
     useConfigOptions: true,
     useAccountOptions: true,

package/commands/app/secret/add.js

@@ -7,8 +7,9 @@ import { commands } from '../../../lang/en.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
+import { uiBetaTag } from '../../../lib/ui/index.js';
 const command = 'add [name]';
-const describe = commands.app.subcommands.secret.subcommands.add.describe;
+const describe = uiBetaTag(commands.app.subcommands.secret.subcommands.add.describe, false);
 async function handler(args) {
     const { derivedAccountId } = args;
     trackCommandUsage('app-secret-add', {}, derivedAccountId);

package/commands/app/secret/delete.js

@@ -7,8 +7,9 @@ import { commands } from '../../../lang/en.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
+import { uiBetaTag } from '../../../lib/ui/index.js';
 const command = 'delete [name]';
-const describe = commands.app.subcommands.secret.subcommands.delete.describe;
+const describe = uiBetaTag(commands.app.subcommands.secret.subcommands.delete.describe, false);
 async function handler(args) {
     const { derivedAccountId, force } = args;
     trackCommandUsage('app-secret-delete', {}, derivedAccountId);

package/commands/app/secret/list.js

@@ -6,8 +6,9 @@ import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { selectAppPrompt } from '../../../lib/prompts/selectAppPrompt.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
+import { uiBetaTag } from '../../../lib/ui/index.js';
 const command = 'list';
-const describe = commands.app.subcommands.secret.subcommands.list.describe;
+const describe = uiBetaTag(commands.app.subcommands.secret.subcommands.list.describe, false);
 async function handler(args) {
     const { derivedAccountId } = args;
     trackCommandUsage('app-secret-list', {}, derivedAccountId);

package/commands/app/secret/update.js

@@ -8,8 +8,9 @@ import { commands } from '../../../lang/en.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
+import { uiBetaTag } from '../../../lib/ui/index.js';
 const command = 'update [name]';
-const describe = commands.app.subcommands.secret.subcommands.update.describe;
+const describe = uiBetaTag(commands.app.subcommands.secret.subcommands.update.describe, false);
 async function handler(args) {
     const { derivedAccountId } = args;
     trackCommandUsage('app-secret-update', {}, derivedAccountId);

package/commands/app/secret.js

@@ -4,8 +4,9 @@ import addAppSecretCommand from './secret/add.js';
 import deleteAppSecretCommand from './secret/delete.js';
 import listAppSecretsCommand from './secret/list.js';
 import updateAppSecretCommand from './secret/update.js';
+import { uiBetaTag } from '../../lib/ui/index.js';
 const command = ['secret', 'secrets'];
-const describe = undefined; // commands.app.subcommands.secret.describe;
+const describe = uiBetaTag(commands.app.subcommands.secret.describe, false);
 function appSecretBuilder(yargs) {
     yargs
         .command(addAppSecretCommand)

package/commands/app.js

@@ -1,9 +1,9 @@
 import migrateCommand from './app/migrate.js';
 import appSecretCommand from './app/secret.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
+import { commands } from '../lang/en.js';
 const command = ['app', 'apps'];
-// Keep the command hidden for now
-const describe = undefined;
+const describe = commands.app.describe;
 function appBuilder(yargs) {
     yargs.command(migrateCommand).command(appSecretCommand).demandCommand(1, '');
     return yargs;

package/commands/config/set.js

@@ -84,7 +84,6 @@ function configSetBuilder(yargs) {
         'auto-open-browser': {
             describe: commands.config.subcommands.set.options.autoOpenBrowser.describe,
             type: 'boolean',
-            hidden: true,
         },
     })
         .conflicts(getExclusiveConflicts([

package/commands/feedback.js

@@ -5,7 +5,7 @@ import { confirmPrompt } from '../lib/prompts/promptUtils.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { uiLink } from '../lib/ui/index.js';
-const FEEDBACK_URL = 'https://developers.hubspot.com/feedback.js';
+const FEEDBACK_URL = 'https://developers.hubspot.com/feedback';
 const command = 'feedback';
 const describe = i18n(`commands.project.subcommands.feedback.describe`);
 async function handler() {

package/commands/getStarted.d.ts

@@ -1,7 +1,5 @@
 import { AccountArgs, YargsCommandModule, CommonArgs, ConfigArgs, EnvironmentArgs } from '../types/Yargs.js';
-export declare const command = "get-started";
-export declare const describe: undefined;
-export type GetStartedArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
+type GetStartedArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
     name?: string;
     dest?: string;
 };

package/commands/getStarted.js

@@ -4,6 +4,7 @@ import open from 'open';
 import { getCwd } from '@hubspot/local-dev-lib/path';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
 import { commands } from '../lang/en.js';
+import { trackCommandMetadataUsage, trackCommandUsage, } from '../lib/usageTracking.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { promptUser } from '../lib/prompts/promptUtils.js';
@@ -22,14 +23,13 @@ import { getStaticAuthAppInstallUrl } from '../lib/app/urls.js';
 import { getEnv } from '@hubspot/local-dev-lib/config';
 import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
 import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
-export const command = 'get-started';
-export const describe = undefined;
+const command = 'get-started';
+const describe = commands.getStarted.describe;
 async function handler(args) {
     const { derivedAccountId } = args;
     const env = getEnv(derivedAccountId) === 'qa' ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD;
+    await trackCommandUsage('get-started', {}, derivedAccountId);
     const accountName = uiAccountDescription(derivedAccountId);
-    // TODO: Put this in constants.ts once we have a defined place for the template before INBOUND
-    const templateSource = 'robrown-hubspot/hubspot-project-components-ua-app-objects-beta';
     uiInfoSection(commands.getStarted.startTitle, () => {
         uiLogger.log(commands.getStarted.startDescription);
         uiLogger.log(commands.getStarted.guideOverview(accountName));
@@ -52,6 +52,8 @@ async function handler(args) {
             default: GET_STARTED_OPTIONS.APP,
         },
     ]);
+    // Track user's initial choice
+    await trackCommandMetadataUsage('get-started', { step: 'select-option', type: selectedOption }, derivedAccountId);
     if (selectedOption === GET_STARTED_OPTIONS.CMS) {
         uiLogger.log(' ');
         uiLogger.log(commands.getStarted.designManager);
@@ -64,6 +66,11 @@ async function handler(args) {
                     message: commands.getStarted.openDesignManagerPrompt,
                 },
             ]);
+            // Track Design Manager browser action
+            await trackCommandMetadataUsage('get-started', {
+                step: 'open-design-manager',
+                type: shouldOpen ? 'opened' : 'declined',
+            }, derivedAccountId);
             if (shouldOpen) {
                 uiLogger.log('');
                 openLink(derivedAccountId, 'design-manager');
@@ -74,36 +81,37 @@ async function handler(args) {
     else {
         uiLogger.log(' ');
         uiLogger.log(commands.getStarted.logs.appSelected);
-        // 1. Fetch project templates
-        let latestRepoReleaseTag;
         const { dest, name } = await projectNameAndDestPrompt(args);
-        // Specific template for get-started command
-        const projectTemplate = {
-            name: 'private-app-get-started-template',
-            label: 'CRM getting started project with private apps',
-            path: 'projects/private-app-get-started-template',
-        };
-        // 3. Create the project files
         const projectDest = path.resolve(getCwd(), dest);
         const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await getProjectConfig(projectDest);
         if (existingProjectConfig &&
             existingProjectDir &&
             projectDest.startsWith(existingProjectDir)) {
+            // Track nested project error
+            await trackCommandMetadataUsage('get-started', {
+                successful: false,
+                step: 'project-creation',
+            }, derivedAccountId);
             uiLogger.log(' ');
             uiLogger.error(commands.project.create.errors.cannotNestProjects(existingProjectDir));
             process.exit(EXIT_CODES.ERROR);
         }
-        const repo = templateSource || HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
         // 4. Clone the project template from GitHub
-        // This is temporary until we have the UA template in the main repo
         try {
-            await cloneGithubRepo(repo, projectDest, {
-                sourceDir: projectTemplate.path,
-                tag: latestRepoReleaseTag,
+            await cloneGithubRepo(HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, projectDest, {
+                sourceDir: '2025.2/private-app-get-started-template',
                 hideLogs: true,
             });
+            await trackCommandMetadataUsage('get-started', {
+                successful: true,
+                step: 'github-clone',
+            }, derivedAccountId);
         }
         catch (err) {
+            await trackCommandMetadataUsage('get-started', {
+                successful: false,
+                step: 'github-clone',
+            }, derivedAccountId);
             debugError(err);
             uiLogger.log(' ');
             uiLogger.error(commands.project.create.errors.failedToDownloadProject);
@@ -122,6 +130,11 @@ async function handler(args) {
         uiLogger.log(' ');
         uiLogger.log(commands.getStarted.prompts.projectCreated.description);
         uiLogger.log(' ');
+        // Track successful project creation
+        await trackCommandMetadataUsage('get-started', {
+            successful: true,
+            step: 'project-creation',
+        }, derivedAccountId);
         // 5. Install dependencies
         const installLocations = await getProjectPackageJsonLocations(projectDest);
         try {
@@ -147,11 +160,21 @@ async function handler(args) {
                 default: true,
             },
         ]);
+        // Track upload decision
+        await trackCommandMetadataUsage('get-started', {
+            step: 'upload-decision',
+            type: shouldUpload ? 'upload' : 'skip',
+        }, derivedAccountId);
         if (shouldUpload) {
             try {
                 // Get the project config for the newly created project
                 const { projectConfig: newProjectConfig, projectDir: newProjectDir } = await getProjectConfig(projectDest);
                 if (!newProjectConfig || !newProjectDir) {
+                    // Track config file not found error
+                    await trackCommandMetadataUsage('get-started', {
+                        successful: false,
+                        step: 'config-file-not-found',
+                    }, derivedAccountId);
                     uiLogger.log(' ');
                     uiLogger.error(commands.getStarted.errors.configFileNotFound);
                     process.exit(EXIT_CODES.ERROR);
@@ -172,11 +195,21 @@ async function handler(args) {
                     skipValidation: false,
                 });
                 if (uploadError) {
+                    // Track upload failure
+                    await trackCommandMetadataUsage('get-started', {
+                        successful: false,
+                        step: 'upload',
+                    }, derivedAccountId);
                     uiLogger.log(' ');
                     uiLogger.error(commands.getStarted.errors.uploadFailed);
                     debugError(uploadError);
                 }
                 else if (result) {
+                    // Track successful upload completion
+                    await trackCommandMetadataUsage('get-started', {
+                        successful: true,
+                        step: 'upload',
+                    }, derivedAccountId);
                     uiLogger.log(' ');
                     uiLogger.success(commands.getStarted.logs.uploadSuccess);
                     const { data: { results }, } = await fetchPublicAppsForPortal(derivedAccountId);
@@ -192,6 +225,11 @@ async function handler(args) {
                                 message: commands.getStarted.openInstallUrl,
                             },
                         ]);
+                        // Track Developer Overview browser action
+                        await trackCommandMetadataUsage('get-started', {
+                            step: 'open-distribution-page',
+                            type: shouldOpenOverview ? 'opened' : 'declined',
+                        }, derivedAccountId);
                         if (shouldOpenOverview) {
                             open(getStaticAuthAppInstallUrl({
                                 targetAccountId: derivedAccountId,
@@ -207,6 +245,11 @@ async function handler(args) {
                 }
             }
             catch (err) {
+                // Track upload exception
+                await trackCommandMetadataUsage('get-started', {
+                    successful: false,
+                    step: 'upload',
+                }, derivedAccountId);
                 uiLogger.log(' ');
                 uiLogger.error(commands.getStarted.errors.uploadFailed);
                 debugError(err);
@@ -214,6 +257,11 @@ async function handler(args) {
             }
         }
     }
+    // Track successful completion of get-started command
+    await trackCommandMetadataUsage('get-started', {
+        successful: true,
+        step: 'command-completed',
+    }, derivedAccountId);
     process.exit(EXIT_CODES.SUCCESS);
 }
 function getStartedBuilder(yargs) {

package/commands/mcp/__tests__/setup.test.js

@@ -3,12 +3,12 @@ vi.mock('../../../lib/commonOpts');
 describe('commands/mcp/setup', () => {
     describe('command', () => {
         it('should have the correct command structure', () => {
-            expect(setupCommand.command).toEqual(['setup', 'update']);
+            expect(setupCommand.command).toEqual(['setup']);
         });
     });
     describe('describe', () => {
         it('should be undefined to keep the command hidden', () => {
-            expect(setupCommand.describe).toBeUndefined();
+            expect(setupCommand.describe).toBeDefined();
         });
     });
     describe('builder', () => {

package/commands/mcp/setup.js

@@ -4,9 +4,18 @@ import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { addMcpServerToConfig, supportedTools } from '../../lib/mcp/setup.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
-const command = ['setup', 'update'];
-const describe = undefined; // Leave hidden for now
+import { hasFeature } from '../../lib/hasFeature.js';
+import { FEATURES } from '../../lib/constants.js';
+import { uiBetaTag } from '../../lib/ui/index.js';
+const command = ['setup'];
+const describe = uiBetaTag(commands.mcp.setup.describe, false);
 async function handler(args) {
+    const { derivedAccountId } = args;
+    const hasMcpAccess = await hasFeature(derivedAccountId, FEATURES.MCP_ACCESS);
+    if (!hasMcpAccess) {
+        uiLogger.error(commands.mcp.setup.errors.needsMcpAccess(derivedAccountId));
+        process.exit(EXIT_CODES.ERROR);
+    }
     try {
         await import('@modelcontextprotocol/sdk/server/mcp.js');
     }

package/commands/mcp.js

@@ -2,14 +2,14 @@ import startCommand from './mcp/start.js';
 import setupCommand from './mcp/setup.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { commands } from '../lang/en.js';
+import { uiBetaTag } from '../lib/ui/index.js';
 const command = 'mcp';
-// Leave this as undefined to hide the command
-const describe = undefined;
+const describe = uiBetaTag(commands.mcp.describe, false);
 function mcpBuilder(yargs) {
     yargs.command(startCommand).command(setupCommand).demandCommand(1, '');
     return yargs;
 }
-const builder = makeYargsBuilder(mcpBuilder, command, commands.mcp.describe, {
+const builder = makeYargsBuilder(mcpBuilder, command, describe, {
     useGlobalOptions: true,
 });
 const mcpCommand = {

package/commands/project/__tests__/create.test.js

@@ -48,10 +48,10 @@ describe('commands/project/create', () => {
             projectCreateCommand.builder(yargsMock);
             const optionsCall = optionsSpy.mock.calls[0][0];
             expect(optionsCall['platform-version']).toEqual(expect.objectContaining({
-                hidden: true,
+                describe: 'The target platform version for the new project.',
                 type: 'string',
                 choices: ['2023.2', '2025.1', '2025.2'],
-                default: '2023.2',
+                default: '2025.2',
             }));
         });
         it('should define project base option with correct choices', () => {
@@ -59,7 +59,7 @@ describe('commands/project/create', () => {
             projectCreateCommand.builder(yargsMock);
             const optionsCall = optionsSpy.mock.calls[0][0];
             expect(optionsCall['project-base']).toEqual(expect.objectContaining({
-                hidden: true,
+                describe: 'The top level component to include in the project.',
                 type: 'string',
                 choices: ['empty', 'app'],
             }));
@@ -69,7 +69,7 @@ describe('commands/project/create', () => {
             projectCreateCommand.builder(yargsMock);
             const optionsCall = optionsSpy.mock.calls[0][0];
             expect(optionsCall.distribution).toEqual(expect.objectContaining({
-                hidden: true,
+                describe: 'How the app will be distributed.',
                 type: 'string',
                 choices: ['private', 'marketplace'],
             }));
@@ -79,7 +79,7 @@ describe('commands/project/create', () => {
             projectCreateCommand.builder(yargsMock);
             const optionsCall = optionsSpy.mock.calls[0][0];
             expect(optionsCall.auth).toEqual(expect.objectContaining({
-                hidden: true,
+                describe: 'Authentication model for the application.',
                 type: 'string',
                 choices: ['oauth', 'static'],
             }));
@@ -89,7 +89,7 @@ describe('commands/project/create', () => {
             projectCreateCommand.builder(yargsMock);
             const optionsCall = optionsSpy.mock.calls[0][0];
             expect(optionsCall.features).toEqual(expect.objectContaining({
-                hidden: true,
+                describe: 'Features to include in the project. Only valid if project-base is app',
                 type: 'array',
             }));
         });

package/commands/project/__tests__/deploy.test.js

@@ -62,9 +62,6 @@ describe('commands/project/deploy', () => {
         });
     });
     describe('describe', () => {
-        it('should contain the beta tag', () => {
-            expect(projectDeployCommand.describe).toContain('[BETA]');
-        });
         it('should provide a description', () => {
             expect(projectDeployCommand.describe).toBeDefined();
         });

package/commands/project/__tests__/devUnifiedFlow.test.js

@@ -324,8 +324,7 @@ describe('unifiedProjectDevFlow', () => {
             });
             expect(createNewProjectForLocalDev).not.toHaveBeenCalled();
             expect(LocalDevProcess).toHaveBeenCalledWith(expect.objectContaining({
-                projectId: mockProject.id,
-                projectName: mockProject.name,
+                projectData: mockProject,
             }));
         });
     });
@@ -346,8 +345,7 @@ describe('unifiedProjectDevFlow', () => {
                 targetTestingAccountId: mockProvidedTargetTestingAccountId,
                 projectConfig: mockProjectConfig,
                 projectDir: mockProjectDir,
-                projectName: mockProject.name,
-                projectId: mockProject.id,
+                projectData: mockProject,
                 env: ENVIRONMENTS.PROD,
             });
         });

package/commands/project/__tests__/logs.test.js

@@ -45,9 +45,6 @@ describe('commands/project/logs', () => {
         });
     });
     describe('describe', () => {
-        it('should contain the beta tag', () => {
-            expect(projectLogsCommand.describe).toContain('[BETA]');
-        });
         it('should provide a description', () => {
             expect(projectLogsCommand.describe).toBeDefined();
         });

package/commands/project/__tests__/migrate.test.js

@@ -44,7 +44,7 @@ describe('commands/project/migrate', () => {
     });
     describe('describe', () => {
         it('should provide a description', () => {
-            expect(migrateCommand.describe).toBe(undefined);
+            expect(migrateCommand.describe).toBeDefined();
         });
     });
     describe('builder', () => {
@@ -54,7 +54,6 @@ describe('commands/project/migrate', () => {
                 type: 'string',
                 choices: [v2025_2],
                 default: v2025_2,
-                hidden: true,
             });
             expect(optionsSpy).toHaveBeenCalledWith('unstable', {
                 type: 'boolean',

package/commands/project/__tests__/migrateApp.test.js

@@ -57,8 +57,7 @@ describe('commands/project/migrateApp', () => {
                 'platform-version': expect.objectContaining({
                     type: 'string',
                     choices: [v2023_2, v2025_2],
-                    hidden: true,
-                    default: v2023_2,
+                    default: v2025_2,
                 }),
             });
             expect(exampleSpy).toHaveBeenCalled();

package/commands/project/__tests__/profile.test.js

@@ -19,7 +19,7 @@ describe('commands/project', () => {
     });
     describe('describe', () => {
         it('should not provide a description', () => {
-            expect(profileCommand.describe).not.toBeDefined();
+            expect(profileCommand.describe).toBeDefined();
         });
     });
     describe('builder', () => {

package/commands/project/add.js

@@ -1,6 +1,5 @@
 import { logError } from '../../lib/errorHandlers/index.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
-import { uiBetaTag } from '../../lib/ui/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
@@ -10,7 +9,7 @@ import { v3AddComponent } from '../../lib/projects/add/v3AddComponent.js';
 import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, } from '../../lib/constants.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 const command = 'add';
-const describe = uiBetaTag(commands.project.add.describe, false);
+const describe = commands.project.add.describe;
 async function handler(args) {
     try {
         const { derivedAccountId } = args;
@@ -45,19 +44,16 @@ function projectAddBuilder(yargs) {
         },
         distribution: {
             describe: commands.project.add.options.distribution.describe,
-            hidden: true,
             type: 'string',
             choices: [privateDistribution, marketplaceDistribution],
         },
         auth: {
             describe: commands.project.add.options.auth.describe,
-            hidden: true,
             type: 'string',
             choices: [oAuth, staticAuth],
         },
         features: {
             describe: commands.project.add.options.features.describe,
-            hidden: true,
             type: 'array',
         },
     });