@hubspot/cli 7.8.0-experimental.0 → 7.8.0

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__/installDeps.test.js

@@ -1,13 +1,13 @@
 import yargs from 'yargs';
 import path from 'path';
-import { logger } from '@hubspot/local-dev-lib/logger';
+import { uiLogger } from '../../../lib/ui/logger.js';
 import * as projectUtils from '../../../lib/projects/config.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
 import * as dependencyManagement from '../../../lib/dependencyManagement.js';
 import * as promptUtils from '../../../lib/prompts/promptUtils.js';
 import projectInstallDepsCommand from '../installDeps.js';
-vi.mock('@hubspot/local-dev-lib/logger');
+vi.mock('../../../lib/ui/logger.js');
 vi.mock('../../../lib/projects/config');
 vi.mock('../../../lib/dependencyManagement');
 vi.mock('../../../lib/prompts/promptUtils');
@@ -56,8 +56,8 @@ describe('commands/project/installDeps', () => {
                 throw error;
             });
             await projectInstallDepsCommand.handler(args);
-            expect(logger.error).toHaveBeenCalledTimes(1);
-            expect(logger.error).toHaveBeenCalledWith(error.message);
+            expect(uiLogger.error).toHaveBeenCalledTimes(1);
+            expect(uiLogger.error).toHaveBeenCalledWith(error.message);
             expect(processExitSpy).toHaveBeenCalledTimes(1);
             expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
         });
@@ -67,8 +67,8 @@ describe('commands/project/installDeps', () => {
                 projectConfig: null,
             });
             await projectInstallDepsCommand.handler(args);
-            expect(logger.error).toHaveBeenCalledTimes(1);
-            expect(logger.error).toHaveBeenCalledWith('No project detected. Run this command from a project directory.');
+            expect(uiLogger.error).toHaveBeenCalledTimes(1);
+            expect(uiLogger.error).toHaveBeenCalledWith('No project detected. Run this command from a project directory.');
             expect(processExitSpy).toHaveBeenCalledTimes(1);
             expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
         });
@@ -78,8 +78,8 @@ describe('commands/project/installDeps', () => {
                 projectConfig: null,
             });
             await projectInstallDepsCommand.handler(args);
-            expect(logger.error).toHaveBeenCalledTimes(1);
-            expect(logger.error).toHaveBeenCalledWith('No project detected. Run this command from a project directory.');
+            expect(uiLogger.error).toHaveBeenCalledTimes(1);
+            expect(uiLogger.error).toHaveBeenCalledWith('No project detected. Run this command from a project directory.');
             expect(processExitSpy).toHaveBeenCalledTimes(1);
             expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
         });

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

@@ -0,0 +1,31 @@
+import yargs from 'yargs';
+import { addAccountOptions, addConfigOptions, } from '../../../lib/commonOpts.js';
+import projectListCommand from '../list.js';
+vi.mock('../../../lib/commonOpts');
+describe('commands/project/list', () => {
+    const yargsMock = yargs;
+    describe('command', () => {
+        it('should have the correct command structure', () => {
+            expect(projectListCommand.command).toEqual(['list', 'ls']);
+        });
+    });
+    describe('describe', () => {
+        it('should provide a description', () => {
+            expect(projectListCommand.describe).toBeDefined();
+        });
+    });
+    describe('builder', () => {
+        it('should support the correct options', () => {
+            projectListCommand.builder(yargsMock);
+            expect(addAccountOptions).toHaveBeenCalledTimes(1);
+            expect(addAccountOptions).toHaveBeenCalledWith(yargsMock);
+            expect(addConfigOptions).toHaveBeenCalledTimes(1);
+            expect(addConfigOptions).toHaveBeenCalledWith(yargsMock);
+        });
+        it('should define examples', () => {
+            const exampleSpy = vi.spyOn(yargsMock, 'example');
+            projectListCommand.builder(yargsMock);
+            expect(exampleSpy).toHaveBeenCalled();
+        });
+    });
+});

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

@@ -8,7 +8,7 @@ import * as ui from '../../../lib/ui/index.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { logError } from '../../../lib/errorHandlers/index.js';
 import projectLogsCommand from '../logs.js';
-vi.mock('@hubspot/local-dev-lib/logger');
+vi.mock('../../ui/logger.js');
 vi.mock('../../../lib/commonOpts');
 vi.mock('../../../lib/usageTracking');
 vi.mock('../../../lib/validation');
@@ -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

@@ -1,15 +1,16 @@
 import yargs from 'yargs';
-import { logger } from '@hubspot/local-dev-lib/logger';
+import { uiLogger } from '../../../lib/ui/logger.js';
 import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
 import migrateCommand from '../migrate.js';
 import { migrateApp2025_2 } from '../../../lib/app/migrate.js';
 import { getProjectConfig } from '../../../lib/projects/config.js';
 import { commands } from '../../../lang/en.js';
 import { uiBetaTag, uiCommandReference } from '../../../lib/ui/index.js';
-vi.mock('@hubspot/local-dev-lib/logger');
+vi.mock('../../../lib/ui/logger.js');
 vi.mock('../../../lib/app/migrate');
 vi.mock('../../../lib/projects/config');
 vi.mock('../../../lib/ui');
+vi.mock('../../../lib/usageTracking.js');
 const { v2025_2 } = PLATFORM_VERSIONS;
 describe('commands/project/migrate', () => {
     const yargsMock = yargs;
@@ -24,8 +25,8 @@ describe('commands/project/migrate', () => {
         .mockImplementation(() => undefined);
     beforeEach(() => {
         // Mock logger methods
-        vi.spyOn(logger, 'log').mockImplementation(() => { });
-        vi.spyOn(logger, 'error').mockImplementation(() => { });
+        vi.spyOn(uiLogger, 'log').mockImplementation(() => { });
+        vi.spyOn(uiLogger, 'error').mockImplementation(() => { });
         migrateApp2025_2Mock.mockResolvedValue(undefined);
         getProjectConfigMock.mockResolvedValue({
             projectConfig: { name: 'test-project' },
@@ -44,7 +45,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 +55,6 @@ describe('commands/project/migrate', () => {
                 type: 'string',
                 choices: [v2025_2],
                 default: v2025_2,
-                hidden: true,
             });
             expect(optionsSpy).toHaveBeenCalledWith('unstable', {
                 type: 'boolean',
@@ -75,7 +75,7 @@ describe('commands/project/migrate', () => {
         it('should exit with error if no project config exists', async () => {
             getProjectConfigMock.mockResolvedValue({ projectConfig: null });
             await migrateCommand.handler(options);
-            expect(logger.error).toHaveBeenCalledWith(commands.project.migrate.errors.noProjectConfig('command reference'));
+            expect(uiLogger.error).toHaveBeenCalledWith(commands.project.migrate.errors.noProjectConfig('command reference'));
             expect(mockExit).toHaveBeenCalledWith(1);
             expect(mockExit).toHaveBeenCalledTimes(1);
         });

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

@@ -1,11 +1,10 @@
 import yargs from 'yargs';
-import { i18n } from '../../../lib/lang.js';
 import { uiCommandReference, uiDeprecatedTag } from '../../../lib/ui/index.js';
 import { handlerGenerator } from '../../app/migrate.js';
 import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
 import migrateAppCommand from '../migrateApp.js';
-vi.mock('@hubspot/local-dev-lib/logger');
-vi.mock('../../../lib/lang');
+vi.mock('../../ui/logger.js');
+vi.mock('../../../lang/en.js');
 vi.mock('../../../lib/ui');
 vi.mock('../../app/migrate');
 const { v2023_2, v2025_2 } = PLATFORM_VERSIONS;
@@ -14,13 +13,11 @@ describe('commands/project/migrateApp', () => {
     const optionsSpy = vi.spyOn(yargsMock, 'options').mockReturnValue(yargsMock);
     const exampleSpy = vi.spyOn(yargsMock, 'example').mockReturnValue(yargsMock);
     // Mock the imported functions
-    const i18nMock = i18n;
     const uiDeprecatedTagMock = uiDeprecatedTag;
     const uiCommandReferenceMock = uiCommandReference;
     const handlerGeneratorMock = handlerGenerator;
     beforeEach(() => {
         vi.clearAllMocks();
-        i18nMock.mockReturnValue('test description');
         uiDeprecatedTagMock.mockReturnValue('deprecated test description');
         uiCommandReferenceMock.mockReturnValue('command reference');
         handlerGeneratorMock.mockReturnValue(vi.fn().mockResolvedValue(undefined));
@@ -57,8 +54,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/__tests__/validate.test.js

@@ -0,0 +1,98 @@
+import path from 'path';
+import { vi } from 'vitest';
+import { validateSourceDirectory } from '../../../lib/projects/upload.js';
+import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
+import { uiLogger } from '../../../lib/ui/logger.js';
+import { commands } from '../../../lang/en.js';
+import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { loadAndValidateProfile } from '../../../lib/projectProfiles.js';
+import { trackCommandUsage } from '../../../lib/usageTracking.js';
+import { getAccountConfig } from '@hubspot/local-dev-lib/config';
+import { handleTranslate } from '../../../lib/projects/upload.js';
+import projectValidateCommand from '../validate.js';
+// Mock dependencies
+vi.mock('../../../lib/projects/upload.js');
+vi.mock('../../../lib/projects/config.js');
+vi.mock('../../../lib/ui/logger.js');
+vi.mock('../../../lib/usageTracking.js');
+vi.mock('../../../lib/projectProfiles.js');
+vi.mock('../../../lib/errorHandlers/index.js');
+vi.mock('@hubspot/local-dev-lib/config');
+vi.mock('../../../lib/projects/platformVersion.js');
+describe('commands/project/validate', () => {
+    const projectDir = '/test/project';
+    let exitSpy;
+    beforeEach(() => {
+        // Mock process.exit to throw to stop execution
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation(code => {
+            throw new Error(`Process exited with code ${code}`);
+        });
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        exitSpy.mockRestore();
+    });
+    describe('project configuration validation', () => {
+        it('should exit with error when project config is null', async () => {
+            vi.mocked(getProjectConfig).mockResolvedValue({
+                projectConfig: null,
+                projectDir: null,
+            });
+            await expect(
+            // @ts-expect-error partial mock
+            projectValidateCommand.handler({
+                derivedAccountId: 123,
+                d: false,
+                debug: false,
+            })).rejects.toThrow('Process exited with code 1');
+            expect(uiLogger.error).toHaveBeenCalledWith(commands.project.validate.mustBeRanWithinAProject);
+        });
+        it('should exit with error when project directory is null', async () => {
+            vi.mocked(getProjectConfig).mockResolvedValue({
+                projectConfig: {
+                    name: 'test',
+                    srcDir: 'src',
+                    platformVersion: '2025.2',
+                },
+                projectDir: null,
+            });
+            await expect(
+            // @ts-expect-error partial mock
+            projectValidateCommand.handler({
+                derivedAccountId: 123,
+                d: false,
+                debug: false,
+            })).rejects.toThrow('Process exited with code 1');
+            expect(uiLogger.error).toHaveBeenCalledWith(commands.project.validate.mustBeRanWithinAProject);
+        });
+    });
+    it('should call validateSourceDirectory with correct parameters', async () => {
+        const mockProjectConfig = {
+            name: 'test-project',
+            srcDir: 'src',
+            platformVersion: '2025.2',
+        };
+        vi.mocked(getProjectConfig).mockResolvedValue({
+            projectConfig: mockProjectConfig,
+            projectDir,
+        });
+        vi.mocked(isV2Project).mockReturnValue(true);
+        vi.mocked(validateProjectConfig).mockReturnValue(undefined);
+        vi.mocked(loadAndValidateProfile).mockResolvedValue(123);
+        vi.mocked(getAccountConfig).mockReturnValue({
+            accountType: 'STANDARD',
+            accountId: 123,
+            env: 'prod',
+        });
+        vi.mocked(trackCommandUsage);
+        vi.mocked(validateSourceDirectory).mockResolvedValue(undefined);
+        vi.mocked(handleTranslate).mockResolvedValue(undefined);
+        await expect(projectValidateCommand.handler({
+            derivedAccountId: 123,
+            d: false,
+            debug: false,
+        })).rejects.toThrow('Process exited with code 0');
+        const expectedSrcDir = path.resolve(projectDir, mockProjectConfig.srcDir);
+        expect(validateSourceDirectory).toHaveBeenCalledWith(expectedSrcDir, mockProjectConfig, projectDir);
+    });
+});

package/commands/project/add.d.ts

@@ -1,5 +1,5 @@
-import { YargsCommandModule, CommonArgs } from '../../types/Yargs.js';
-export type ProjectAddArgs = CommonArgs & {
+import { YargsCommandModule, CommonArgs, ConfigArgs } from '../../types/Yargs.js';
+export type ProjectAddArgs = CommonArgs & ConfigArgs & {
     type?: string;
     name?: string;
     features?: string[];

package/commands/project/add.js

@@ -1,16 +1,15 @@
 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';
-import { useV3Api } from '../../lib/projects/platformVersion.js';
+import { isV2Project } from '../../lib/projects/platformVersion.js';
 import { legacyAddComponent } from '../../lib/projects/add/legacyAddComponent.js';
-import { v3AddComponent } from '../../lib/projects/add/v3AddComponent.js';
+import { v2AddComponent } from '../../lib/projects/add/v2AddComponent.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;
@@ -19,9 +18,9 @@ async function handler(args) {
             uiLogger.error(commands.project.add.error.locationInProject);
             process.exit(EXIT_CODES.ERROR);
         }
-        const isV3ProjectCreate = useV3Api(projectConfig.platformVersion);
-        if (isV3ProjectCreate) {
-            await v3AddComponent(args, projectDir, projectConfig, derivedAccountId);
+        const isV2ProjectCreate = isV2Project(projectConfig.platformVersion);
+        if (isV2ProjectCreate) {
+            await v2AddComponent(args, projectDir, projectConfig, derivedAccountId);
         }
         else {
             await legacyAddComponent(args, projectDir, projectConfig, derivedAccountId);
@@ -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',
         },
     });
@@ -72,6 +68,7 @@ function projectAddBuilder(yargs) {
 }
 const builder = makeYargsBuilder(projectAddBuilder, command, describe, {
     useGlobalOptions: true,
+    useConfigOptions: true,
 });
 const projectAddCommand = {
     command,

package/commands/project/cloneApp.js

@@ -1,7 +1,7 @@
 import path from 'path';
 import fs from 'fs';
 import { trackCommandUsage, trackCommandMetadataUsage, } from '../../lib/usageTracking.js';
-import { i18n } from '../../lib/lang.js';
+import { commands } from '../../lang/en.js';
 import { selectPublicAppForMigrationPrompt } from '../../lib/prompts/selectPublicAppForMigrationPrompt.js';
 import { projectNameAndDestPrompt } from '../../lib/prompts/projectNameAndDestPrompt.js';
 import { poll } from '../../lib/polling.js';
@@ -12,7 +12,7 @@ import { writeProjectConfig } from '../../lib/projects/config.js';
 import { PROJECT_CONFIG_FILE } from '../../lib/constants.js';
 import { cloneApp, checkCloneStatus, downloadClonedProject, } from '@hubspot/local-dev-lib/api/projects';
 import { getCwd, sanitizeFileName } from '@hubspot/local-dev-lib/path';
-import { logger } from '@hubspot/local-dev-lib/logger';
+import { uiLogger } from '../../lib/ui/logger.js';
 import { extractZipArchive } from '@hubspot/local-dev-lib/archive';
 import { getAccountConfig } from '@hubspot/local-dev-lib/config';
 import SpinniesManager from '../../lib/ui/SpinniesManager.js';
@@ -20,7 +20,7 @@ import { logInvalidAccountError } from '../../lib/app/migrate.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiDeprecatedTag, uiLine, uiAccountDescription, } from '../../lib/ui/index.js';
 const command = 'clone-app';
-const describe = uiDeprecatedTag(i18n(`commands.project.subcommands.cloneApp.describe`), false);
+const describe = uiDeprecatedTag(commands.project.cloneApp.describe, false);
 const deprecated = true;
 async function handler(args) {
     const { derivedAccountId } = args;
@@ -28,7 +28,7 @@ async function handler(args) {
     const accountConfig = getAccountConfig(derivedAccountId);
     const accountName = uiAccountDescription(derivedAccountId);
     if (!accountConfig) {
-        throw new Error(i18n(`commands.projects.subcommands.cloneApp.errors.noAccountConfig`));
+        throw new Error(commands.project.cloneApp.errors.noAccountConfig(derivedAccountId));
     }
     const defaultAccountIsUnified = await isUnifiedAccount(accountConfig);
     if (!isAppDeveloperAccount(accountConfig) && !defaultAccountIsUnified) {
@@ -60,7 +60,7 @@ async function handler(args) {
     try {
         SpinniesManager.init();
         SpinniesManager.add('cloneApp', {
-            text: i18n(`commands.project.subcommands.cloneApp.cloneStatus.inProgress`),
+            text: commands.project.cloneApp.cloneStatus.inProgress,
         });
         const { data: { exportId }, } = await cloneApp(derivedAccountId, appId);
         const { status } = await poll(() => checkCloneStatus(derivedAccountId, exportId));
@@ -84,25 +84,23 @@ async function handler(args) {
             };
             const success = writeProjectConfig(configPath, configContent);
             SpinniesManager.succeed('cloneApp', {
-                text: i18n(`commands.project.subcommands.cloneApp.cloneStatus.done`),
+                text: commands.project.cloneApp.cloneStatus.done,
                 succeedColor: 'white',
             });
             if (!success) {
-                logger.error(i18n(`commands.project.subcommands.cloneApp.errors.couldNotWriteConfigPath`), configPath);
+                uiLogger.error(commands.project.cloneApp.errors.couldNotWriteConfigPath(configPath));
             }
-            logger.log('');
+            uiLogger.log('');
             uiLine();
-            logger.success(i18n(`commands.project.subcommands.cloneApp.cloneStatus.success`, {
-                dest: projectDest,
-            }));
-            logger.log('');
+            uiLogger.success(commands.project.cloneApp.cloneStatus.success(projectDest));
+            uiLogger.log('');
             process.exit(EXIT_CODES.SUCCESS);
         }
     }
     catch (error) {
         await trackCommandMetadataUsage('clone-app', { successful: false }, derivedAccountId);
         SpinniesManager.fail('cloneApp', {
-            text: i18n(`commands.project.subcommands.cloneApp.cloneStatus.failure`),
+            text: commands.project.cloneApp.cloneStatus.failure,
             failColor: 'white',
         });
         // Migrations endpoints return a response object with an errors property. The errors property contains an array of errors.
@@ -122,19 +120,16 @@ async function handler(args) {
 function cloneAppBuilder(yargs) {
     yargs.options({
         dest: {
-            describe: i18n(`commands.project.subcommands.cloneApp.options.dest.describe`),
+            describe: commands.project.cloneApp.options.dest.describe,
             type: 'string',
         },
         'app-id': {
-            describe: i18n(`commands.project.subcommands.cloneApp.options.appId.describe`),
+            describe: commands.project.cloneApp.options.appId.describe,
             type: 'number',
         },
     });
     yargs.example([
-        [
-            '$0 project clone-app',
-            i18n(`commands.project.subcommands.cloneApp.examples.default`),
-        ],
+        ['$0 project clone-app', commands.project.cloneApp.examples.default],
     ]);
     return yargs;
 }

package/commands/project/create.js

@@ -5,9 +5,9 @@ import { getCwd } from '@hubspot/local-dev-lib/path';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { writeProjectConfig, getProjectConfig, } from '../../lib/projects/config.js';
 import { EMPTY_PROJECT_TEMPLATE_NAME } from '../../lib/projects/create/legacy.js';
-import { generateComponentPaths } from '../../lib/projects/create/v3.js';
+import { generateComponentPaths } from '../../lib/projects/create/v2.js';
 import { PROJECT_WITH_APP, EMPTY_PROJECT } from '../../lib/constants.js';
-import { uiBetaTag, uiFeatureHighlight } from '../../lib/ui/index.js';
+import { uiFeatureHighlight } from '../../lib/ui/index.js';
 import { debugError, logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { PROJECT_CONFIG_FILE, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, marketplaceDistribution, privateDistribution, oAuth, staticAuth, DEFAULT_PROJECT_TEMPLATE_BRANCH, } from '../../lib/constants.js';
@@ -19,7 +19,7 @@ import { handleProjectCreationFlow, } from '../../lib/projects/create/index.js';
 import { getProjectMetadata, } from '@hubspot/project-parsing-lib/src/lib/project.js';
 import { updateHsMetaFilesWithAutoGeneratedFields } from '../../lib/projects/components.js';
 const command = ['create', 'init'];
-const describe = uiBetaTag(commands.project.create.describe, false);
+const describe = commands.project.create.describe;
 const { v2023_2, v2025_1, v2025_2 } = PLATFORM_VERSIONS;
 async function handler(args) {
     const { derivedAccountId, platformVersion, templateSource } = args;
@@ -97,7 +97,6 @@ async function handler(args) {
         'projectInstallDepsCommand',
         'projectHelpCommand',
         'feedbackCommand',
-        'sampleProjects',
     ]);
     process.exit(EXIT_CODES.SUCCESS);
 }
@@ -112,7 +111,6 @@ function projectCreateBuilder(yargs) {
             type: 'string',
         },
         template: {
-            // TODO: When we release 2025.2 scaffolding, we need to point out this is only valid for 2025.1 prior
             describe: commands.project.create.options.template.describe,
             type: 'string',
         },
@@ -122,32 +120,27 @@ function projectCreateBuilder(yargs) {
         },
         'platform-version': {
             describe: commands.project.create.options.platformVersion.describe,
-            hidden: true,
             type: 'string',
             choices: [v2023_2, v2025_1, v2025_2],
-            default: v2023_2,
+            default: v2025_2,
         },
         'project-base': {
             describe: commands.project.create.options.projectBase.describe,
-            hidden: true,
             type: 'string',
             choices: [EMPTY_PROJECT, PROJECT_WITH_APP],
         },
         distribution: {
             describe: commands.project.create.options.distribution.describe,
-            hidden: true,
             type: 'string',
             choices: [privateDistribution, marketplaceDistribution],
         },
         auth: {
             describe: commands.project.create.options.auth.describe,
-            hidden: true,
             type: 'string',
             choices: [oAuth, staticAuth],
         },
         features: {
             describe: commands.project.create.options.features.describe,
-            hidden: true,
             type: 'array',
         },
     });

package/commands/project/deploy.js

@@ -1,13 +1,13 @@
 import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
 import { getAccountConfig } from '@hubspot/local-dev-lib/config';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
-import { useV3Api } from '../../lib/projects/platformVersion.js';
+import { isV2Project } from '../../lib/projects/platformVersion.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
 import { projectNamePrompt } from '../../lib/prompts/projectNamePrompt.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
-import { uiBetaTag, uiLine } from '../../lib/ui/index.js';
+import { uiLine } from '../../lib/ui/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
@@ -16,7 +16,7 @@ import { PROJECT_DEPLOY_TEXT } from '../../lib/constants.js';
 import { commands } from '../../lang/en.js';
 import { handleProjectDeploy, validateBuildIdForDeploy, logDeployErrors, } from '../../lib/projects/deploy.js';
 const command = 'deploy';
-const describe = uiBetaTag(commands.project.deploy.describe, false);
+const describe = commands.project.deploy.describe;
 async function handler(args) {
     const { derivedAccountId, project: projectOption, buildId: buildIdOption, force: forceOption, deployLatestBuild: deployLatestBuildOption, json: formatOutputAsJson, } = args;
     const accountConfig = getAccountConfig(derivedAccountId);
@@ -24,7 +24,7 @@ async function handler(args) {
     let targetAccountId;
     const jsonOutput = {};
     const { projectConfig, projectDir } = await getProjectConfig();
-    if (useV3Api(projectConfig?.platformVersion)) {
+    if (isV2Project(projectConfig?.platformVersion)) {
         if (args.profile) {
             logProfileHeader(args.profile);
             const profile = loadProfile(projectConfig, projectDir, args.profile);
@@ -87,7 +87,7 @@ async function handler(args) {
             uiLogger.error(commands.project.deploy.errors.noBuildId);
             return process.exit(EXIT_CODES.ERROR);
         }
-        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, useV3Api(projectConfig?.platformVersion), forceOption);
+        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isV2Project(projectConfig?.platformVersion), forceOption);
         if (!deployResult) {
             return process.exit(EXIT_CODES.ERROR);
         }