@hubspot/cli 7.8.12-experimental.0 → 7.9.0-beta.0

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

@@ -3,6 +3,7 @@ import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
 import { translateForLocalDev } from '@hubspot/project-parsing-lib';
 import { getConfigAccounts, getAccountConfig, } from '@hubspot/local-dev-lib/config';
 import { getValidEnv } from '@hubspot/local-dev-lib/environment';
+import { getServerPortByInstanceId } from '@hubspot/local-dev-lib/portManager';
 import { logError } from '../../../lib/errorHandlers/index.js';
 import { ensureProjectExists } from '../../../lib/projects/ensureProjectExists.js';
 import { createInitialBuildForNewProject, createNewProjectForLocalDev, } from '../../../lib/projects/localDev/helpers/project.js';
@@ -33,6 +34,7 @@ vi.mock('@hubspot/ui-extensions-dev-server', () => ({
 vi.mock('@hubspot/project-parsing-lib');
 vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('@hubspot/local-dev-lib/environment');
+vi.mock('@hubspot/local-dev-lib/portManager');
 vi.mock('../../../lib/errorHandlers');
 vi.mock('../../../lib/projects/ensureProjectExists');
 vi.mock('../../../lib/projects/localDev/helpers/project');
@@ -135,6 +137,7 @@ describe('unifiedProjectDevFlow', () => {
         uiLogger.error.mockImplementation(() => { });
         uiLogger.log.mockImplementation(() => { });
         uiLine.mockImplementation(() => { });
+        getServerPortByInstanceId.mockRejectedValue(new Error('No server running'));
     });
     describe('successful flow', () => {
         it('should complete successfully with existing project and provided testing account', async () => {
@@ -400,4 +403,33 @@ describe('unifiedProjectDevFlow', () => {
             expect(uiLogger.log).toHaveBeenCalledWith(commands.project.dev.logs.testingAccountFlagExplanation(providedTestingAccountId));
         });
     });
+    describe('confirmLocalDevIsNotRunning', () => {
+        it('should exit with error when local dev is already running', async () => {
+            getServerPortByInstanceId.mockResolvedValue(3000);
+            const mockExit = vi.spyOn(process, 'exit').mockImplementation(() => {
+                throw new Error('Process.exit called');
+            });
+            await unifiedProjectDevFlow({
+                args: mockArgs,
+                targetProjectAccountId: mockTargetProjectAccountId,
+                providedTargetTestingAccountId: mockProvidedTargetTestingAccountId,
+                projectConfig: mockProjectConfig,
+                projectDir: mockProjectDir,
+            });
+            expect(uiLogger.error).toHaveBeenCalledWith(commands.project.dev.errors.localDevAlreadyRunning);
+            expect(mockExit).toHaveBeenCalledWith(1);
+            mockExit.mockRestore();
+        });
+        it('should continue when local dev is not running', async () => {
+            getServerPortByInstanceId.mockRejectedValue(new Error('No server running'));
+            await unifiedProjectDevFlow({
+                args: mockArgs,
+                targetProjectAccountId: mockTargetProjectAccountId,
+                providedTargetTestingAccountId: mockProvidedTargetTestingAccountId,
+                projectConfig: mockProjectConfig,
+                projectDir: mockProjectDir,
+            });
+            expect(mockLocalDevProcess.start).toHaveBeenCalled();
+        });
+    });
 });

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');

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' },
@@ -74,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));

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

@@ -3,9 +3,9 @@ import { getProjectConfig } from '../../lib/projects/config.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';
@@ -18,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);
@@ -68,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,7 +5,7 @@ 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 { uiFeatureHighlight } from '../../lib/ui/index.js';
 import { debugError, logError } from '../../lib/errorHandlers/index.js';
@@ -97,7 +97,6 @@ async function handler(args) {
         'projectInstallDepsCommand',
         'projectHelpCommand',
         'feedbackCommand',
-        'sampleProjects',
     ]);
     process.exit(EXIT_CODES.SUCCESS);
 }

package/commands/project/deploy.js

@@ -1,7 +1,7 @@
 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';
@@ -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,