@hubspot/cli 7.7.35-experimental.0 → 7.8.0-beta.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: 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);
         }

package/commands/project/dev/deprecatedFlow.js

@@ -1,13 +1,12 @@
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { getAccountConfig, getConfigAccounts, getEnv, } from '@hubspot/local-dev-lib/config';
 import { getValidEnv } from '@hubspot/local-dev-lib/environment';
 import { findProjectComponents, getProjectComponentTypes, } from '../../../lib/projects/structure.js';
 import { ComponentTypes } from '../../../types/Projects.js';
-import { i18n } from '../../../lib/lang.js';
+import { commands } from '../../../lang/en.js';
+import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
-import { uiCommandReference } from '../../../lib/ui/index.js';
 import SpinniesManager from '../../../lib/ui/SpinniesManager.js';
-import LocalDevManager from '../../../lib/projects/localDev/LocalDevManager.js';
+import LocalDevManager_DEPRECATED from '../../../lib/projects/localDev/LocalDevManager_DEPRECATED.js';
 import { confirmDefaultAccountIsTarget, suggestRecommendedNestedAccount, checkIfAccountFlagIsSupported, checkIfDefaultAccountIsSupported, createSandboxForLocalDev, createDeveloperTestAccountForLocalDev, useExistingDevTestAccount, checkIfParentAccountIsAuthed, hasSandboxes, } from '../../../lib/projects/localDev/helpers/account.js';
 import { createInitialBuildForNewProject, createNewProjectForLocalDev, } from '../../../lib/projects/localDev/helpers/project.js';
 import { handleExit } from '../../../lib/process.js';
@@ -23,28 +22,20 @@ export async function deprecatedProjectDevFlow({ args, accountId, projectConfig,
     const hasPublicApps = !!componentTypes[ComponentTypes.PublicApp];
     const accountConfig = getAccountConfig(accountId);
     if (!accountConfig) {
-        logger.error(i18n('commands.project.subcommands.dev.errors.noAccount', {
-            accountId: accountId,
-            authCommand: uiCommandReference('hs auth'),
-        }));
+        uiLogger.error(commands.project.dev.errors.noAccount(accountId));
         process.exit(EXIT_CODES.ERROR);
     }
     if (runnableComponents.length === 0) {
-        logger.error(i18n(`commands.project.subcommands.dev.errors.noRunnableComponents`, {
-            projectDir,
-            command: uiCommandReference('hs project add'),
-        }));
+        uiLogger.error(commands.project.dev.errors.noRunnableComponents);
         process.exit(EXIT_CODES.SUCCESS);
     }
     else if (hasPrivateApps && hasPublicApps) {
-        logger.error(i18n(`commands.project.subcommands.dev.errors.invalidProjectComponents`));
+        uiLogger.error(commands.project.dev.errors.invalidProjectComponents);
         process.exit(EXIT_CODES.SUCCESS);
     }
     const accounts = getConfigAccounts();
     if (!accounts) {
-        logger.error(i18n(`commands.project.subcommands.dev.errors.noAccountsInConfig`, {
-            authCommand: uiCommandReference('hs auth'),
-        }));
+        uiLogger.error(commands.project.dev.errors.noAccountsInConfig);
         process.exit(EXIT_CODES.ERROR);
     }
     let bypassRecommendedAccountPrompt = false;
@@ -110,7 +101,7 @@ export async function deprecatedProjectDevFlow({ args, accountId, projectConfig,
         targetProjectAccountId = derivedAccountId;
     }
     if (!targetProjectAccountId || !targetTestingAccountId) {
-        logger.error(i18n(`commands.project.subcommands.dev.errors.noAccount`));
+        uiLogger.error(commands.project.dev.errors.noAccount(accountId));
         process.exit(EXIT_CODES.ERROR);
     }
     // eslint-disable-next-line prefer-const
@@ -130,7 +121,7 @@ export async function deprecatedProjectDevFlow({ args, accountId, projectConfig,
         project = await createNewProjectForLocalDev(projectConfig, targetProjectAccountId, createNewSandbox, hasPublicApps);
         deployedBuild = await createInitialBuildForNewProject(projectConfig, projectDir, targetProjectAccountId);
     }
-    const LocalDev = new LocalDevManager({
+    const LocalDev = new LocalDevManager_DEPRECATED({
         runnableComponents,
         debug: args.debug,
         deployedBuild,

package/commands/project/dev/index.js

@@ -2,24 +2,24 @@ import { trackCommandUsage } from '../../../lib/usageTracking.js';
 import { getAccountId } from '@hubspot/local-dev-lib/config';
 import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
-import { uiBetaTag, uiLine } from '../../../lib/ui/index.js';
+import { uiLine } from '../../../lib/ui/index.js';
 import { deprecatedProjectDevFlow } from './deprecatedFlow.js';
 import { unifiedProjectDevFlow } from './unifiedFlow.js';
-import { useV3Api } from '../../../lib/projects/platformVersion.js';
+import { isV2Project } from '../../../lib/projects/platformVersion.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { loadProfile, exitIfUsingProfiles, } from '../../../lib/projectProfiles.js';
 import { commands } from '../../../lang/en.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 const command = 'dev';
-const describe = uiBetaTag(commands.project.dev.describe, false);
-function validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV3) {
+const describe = commands.project.dev.describe;
+function validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV2) {
     // Legacy projects do not support targetTestingAccount and targetProjectAccount
-    if (testingAccount && projectAccount && !useV3) {
+    if (testingAccount && projectAccount && !useV2) {
         uiLogger.error(commands.project.dev.errors.unsupportedAccountFlagLegacy);
         process.exit(EXIT_CODES.ERROR);
     }
-    if (userProvidedAccount && useV3) {
-        uiLogger.error(commands.project.dev.errors.unsupportedAccountFlagV3);
+    if (userProvidedAccount && useV2) {
+        uiLogger.error(commands.project.dev.errors.unsupportedAccountFlagV2);
         process.exit(EXIT_CODES.ERROR);
     }
 }
@@ -27,15 +27,15 @@ async function handler(args) {
     const { derivedAccountId, userProvidedAccount, testingAccount, projectAccount, } = args;
     const { projectConfig, projectDir } = await getProjectConfig();
     validateProjectConfig(projectConfig, projectDir);
-    const useV3 = useV3Api(projectConfig.platformVersion);
+    const useV2Projects = isV2Project(projectConfig.platformVersion);
     if (!projectDir) {
         uiLogger.error(commands.project.dev.errors.noProjectConfig);
         process.exit(EXIT_CODES.ERROR);
     }
-    validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV3);
-    uiBetaTag(commands.project.dev.logs.betaMessage);
-    if (useV3) {
-        uiLogger.log(commands.project.dev.logs.learnMoreMessageV3);
+    validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV2Projects);
+    uiLogger.log(commands.project.dev.logs.header);
+    if (useV2Projects) {
+        uiLogger.log(commands.project.dev.logs.learnMoreMessageV2);
     }
     else {
         uiLogger.log(commands.project.dev.logs.learnMoreMessageLegacy);
@@ -54,7 +54,7 @@ async function handler(args) {
     else if (userProvidedAccount && derivedAccountId) {
         targetProjectAccountId = derivedAccountId;
     }
-    if (!targetProjectAccountId && useV3Api(projectConfig.platformVersion)) {
+    if (!targetProjectAccountId && isV2Project(projectConfig.platformVersion)) {
         if (args.profile) {
             profile = loadProfile(projectConfig, projectDir, args.profile);
             if (!profile) {
@@ -73,13 +73,13 @@ async function handler(args) {
     if (!targetProjectAccountId) {
         // The user is not using profile or account flags, so we can use the derived accountId
         targetProjectAccountId = derivedAccountId;
-        if (useV3) {
+        if (useV2Projects) {
             uiLogger.log('');
             uiLogger.log(commands.project.dev.logs.defaultProjectAccountExplanation(targetProjectAccountId));
         }
     }
     trackCommandUsage('project-dev', {}, targetProjectAccountId);
-    if (useV3Api(projectConfig.platformVersion)) {
+    if (isV2Project(projectConfig.platformVersion)) {
         const targetTestingAccountId = (testingAccount && getAccountId(testingAccount)) || undefined;
         await unifiedProjectDevFlow({
             args,
@@ -109,15 +109,19 @@ function projectDevBuilder(yargs) {
     yargs.options('testing-account', {
         type: 'string',
         description: commands.project.dev.options.testingAccount,
-        hidden: true,
         implies: ['project-account'],
     });
     yargs.options('project-account', {
         type: 'string',
         description: commands.project.dev.options.projectAccount,
-        hidden: true,
         implies: ['testingAccount'],
     });
+    yargs.option('account', {
+        alias: 'a',
+        describe: '',
+        type: 'string',
+        description: commands.project.dev.options.account,
+    });
     yargs.example([['$0 project dev', commands.project.dev.examples.default]]);
     yargs.conflicts('profile', 'account');
     yargs.conflicts('profile', 'testing-account');
@@ -126,7 +130,6 @@ function projectDevBuilder(yargs) {
 }
 export const builder = makeYargsBuilder(projectDevBuilder, command, describe, {
     useGlobalOptions: true,
-    useAccountOptions: true,
     useConfigOptions: true,
     useEnvironmentOptions: true,
 });