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

package/commands/module/marketplace-validate.js

@@ -1,43 +1,31 @@
-import SpinniesManager from '../../lib/ui/SpinniesManager.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
-import { kickOffValidation, pollForValidationFinish, fetchValidationResults, processValidationErrors, displayValidationResults, } from '../../lib/marketplaceValidate.js';
-import { commands } from '../../lang/en.js';
-import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { uiCommandRelocatedMessage, uiCommandRenamedDescription, uiDeprecatedTag, } from '../../lib/ui/index.js';
+import marketplaceValidateCommand from '../cms/module/marketplace-validate.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-const command = 'marketplace-validate <src>';
-const describe = commands.module.subcommands.marketplaceValidate.describe;
+import { commands } from '../../lang/en.js';
+const command = 'marketplace-validate [src]';
+const describe = uiDeprecatedTag(marketplaceValidateCommand.describe, false);
 async function handler(args) {
-    const { src, derivedAccountId } = args;
-    trackCommandUsage('validate', undefined, derivedAccountId);
-    SpinniesManager.init();
-    SpinniesManager.add('marketplaceValidation', {
-        text: commands.module.subcommands.marketplaceValidate.logs.validatingModule(src),
-    });
-    const assetType = 'MODULE';
-    const validationId = await kickOffValidation(derivedAccountId, assetType, src);
-    await pollForValidationFinish(derivedAccountId, validationId);
-    SpinniesManager.remove('marketplaceValidation');
-    const validationResults = await fetchValidationResults(derivedAccountId, validationId);
-    processValidationErrors(commands.module.subcommands.marketplaceValidate.errors.invalidPath, validationResults);
-    displayValidationResults(commands.module.subcommands.marketplaceValidate.results, validationResults);
-    process.exit(EXIT_CODES.SUCCESS);
+    uiCommandRelocatedMessage('hs cms module marketplace-validate');
+    await marketplaceValidateCommand.handler(args);
 }
-function marketplaceValidateBuilder(yargs) {
+function deprecatedMarketplaceValidateBuilder(yargs) {
     yargs.positional('src', {
-        describe: commands.module.subcommands.marketplaceValidate.positionals.src,
+        describe: commands.cms.subcommands.module.subcommands.marketplaceValidate
+            .positionals.src,
         type: 'string',
     });
     return yargs;
 }
-const builder = makeYargsBuilder(marketplaceValidateBuilder, command, describe, {
+const verboseDescribe = uiCommandRenamedDescription(marketplaceValidateCommand.describe, 'hs cms module marketplace-validate');
+const builder = makeYargsBuilder(deprecatedMarketplaceValidateBuilder, command, verboseDescribe, {
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
 });
-const marketplaceValidateCommand = {
-    command,
+const deprecatedMarketplaceValidateCommand = {
+    ...marketplaceValidateCommand,
     describe,
     handler,
     builder,
 };
-export default marketplaceValidateCommand;
+export default deprecatedMarketplaceValidateCommand;

package/commands/module.d.ts

@@ -1,3 +1,3 @@
 import { YargsCommandModuleBucket } from '../types/Yargs.js';
-declare const moduleCommand: YargsCommandModuleBucket;
-export default moduleCommand;
+declare const deprecatedCmsModuleCommand: YargsCommandModuleBucket;
+export default deprecatedCmsModuleCommand;

package/commands/module.js

@@ -1,21 +1,23 @@
-import marketplaceValidate from './module/marketplace-validate.js';
-import { commands } from '../lang/en.js';
+import { uiCommandRelocatedMessage, uiCommandRenamedDescription, uiDeprecatedTag, } from '../lib/ui/index.js';
+import cmsModuleCommand from './cms/module.js';
+import marketplaceValidateCommand from './module/marketplace-validate.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
-const command = 'module';
-const describe = commands.module.describe;
-function moduleBuilder(yargs) {
-    yargs.command(marketplaceValidate).demandCommand(1, '');
+const command = ['module'];
+const describe = uiDeprecatedTag(cmsModuleCommand.describe, false);
+async function handler(args) {
+    uiCommandRelocatedMessage('hs cms module');
+    await cmsModuleCommand.handler(args);
+}
+function deprecatedCmsModuleBuilder(yargs) {
+    yargs.command(marketplaceValidateCommand).demandCommand(1, '');
     return yargs;
 }
-const builder = makeYargsBuilder(moduleBuilder, command, describe, {
-    useGlobalOptions: true,
-    useConfigOptions: true,
-    useAccountOptions: true,
-});
-const moduleCommand = {
-    command,
+const verboseDescribe = uiCommandRenamedDescription(cmsModuleCommand.describe, 'hs cms module');
+const builder = makeYargsBuilder(deprecatedCmsModuleBuilder, command, verboseDescribe);
+const deprecatedCmsModuleCommand = {
+    ...cmsModuleCommand,
     describe,
+    handler,
     builder,
-    handler: () => { },
 };
-export default moduleCommand;
+export default deprecatedCmsModuleCommand;

package/commands/mv.d.ts

@@ -1,7 +1,4 @@
-import { CommonArgs, ConfigArgs, EnvironmentArgs, YargsCommandModule } from '../types/Yargs.js';
-type MvArgs = CommonArgs & ConfigArgs & EnvironmentArgs & {
-    srcPath: string;
-    destPath: string;
-};
-declare const cmsMvCommand: YargsCommandModule<unknown, MvArgs>;
-export default cmsMvCommand;
+import { YargsCommandModule } from '../types/Yargs.js';
+import { MvArgs } from './cms/mv.js';
+declare const deprecatedCmsMvCommand: YargsCommandModule<unknown, MvArgs>;
+export default deprecatedCmsMvCommand;

package/commands/mv.js

@@ -1,61 +1,35 @@
-import { moveFile } from '@hubspot/local-dev-lib/api/fileMapper';
-import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { logError, ApiErrorContext } from '../lib/errorHandlers/index.js';
-import { trackCommandUsage } from '../lib/usageTracking.js';
-import { isPathFolder } from '../lib/filesystem.js';
-import { uiBetaTag } from '../lib/ui/index.js';
+import { uiCommandRelocatedMessage, uiCommandRenamedDescription, uiDeprecatedTag, } from '../lib/ui/index.js';
+import cmsMvCommand from './cms/mv.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
-import { uiLogger } from '../lib/ui/logger.js';
 import { commands } from '../lang/en.js';
-function getCorrectedDestPath(srcPath, destPath) {
-    if (!isPathFolder(srcPath)) {
-        return destPath;
-    }
-    // Makes sure that nested folders are moved independently
-    return `${destPath}/${srcPath.split('/').pop()}`;
-}
 const command = 'mv <srcPath> <destPath>';
-const describe = uiBetaTag(commands.mv.describe, false);
+const describe = uiDeprecatedTag(cmsMvCommand.describe, false);
 async function handler(args) {
-    const { srcPath, destPath, derivedAccountId } = args;
-    trackCommandUsage('mv', undefined, derivedAccountId);
-    try {
-        await moveFile(derivedAccountId, srcPath, getCorrectedDestPath(srcPath, destPath));
-        uiLogger.success(commands.mv.move(srcPath, destPath, derivedAccountId));
-    }
-    catch (error) {
-        uiLogger.error(commands.mv.errors.moveFailed(srcPath, destPath, derivedAccountId));
-        if (isSpecifiedError(error, { statusCode: 409 })) {
-            uiLogger.error(commands.mv.errors.sourcePathExists(srcPath, destPath));
-        }
-        else {
-            logError(error, new ApiErrorContext({
-                accountId: derivedAccountId,
-            }));
-        }
-    }
+    uiCommandRelocatedMessage('hs cms mv');
+    await cmsMvCommand.handler(args);
 }
-function cmsMvBuilder(yargs) {
+function deprecatedCmsMvBuilder(yargs) {
     yargs.positional('srcPath', {
-        describe: 'Remote hubspot path',
+        describe: commands.cms.subcommands.mv.positionals.srcPath.describe,
         type: 'string',
     });
     yargs.positional('destPath', {
-        describe: 'Remote hubspot path',
+        describe: commands.cms.subcommands.mv.positionals.destPath.describe,
         type: 'string',
     });
     return yargs;
 }
-const builder = makeYargsBuilder(cmsMvBuilder, command, describe, {
+const verboseDescribe = uiCommandRenamedDescription(cmsMvCommand.describe, 'hs cms mv');
+const builder = makeYargsBuilder(deprecatedCmsMvBuilder, command, verboseDescribe, {
     useGlobalOptions: true,
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
 });
-const cmsMvCommand = {
-    command,
+const deprecatedCmsMvCommand = {
+    ...cmsMvCommand,
     describe,
     handler,
     builder,
 };
-export default cmsMvCommand;
+export default deprecatedCmsMvCommand;

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

@@ -1,7 +1,7 @@
 import yargs from 'yargs';
 import projectAddCommand from '../add.js';
 import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, } from '../../../lib/constants.js';
-import { v3AddComponent } from '../../../lib/projects/add/v3AddComponent.js';
+import { v2AddComponent } from '../../../lib/projects/add/v2AddComponent.js';
 import { legacyAddComponent } from '../../../lib/projects/add/legacyAddComponent.js';
 import { getProjectConfig } from '../../../lib/projects/config.js';
 import { isV2Project } from '../../../lib/projects/platformVersion.js';
@@ -9,15 +9,15 @@ import { trackCommandUsage } from '../../../lib/usageTracking.js';
 vi.mock('../../../lib/commonOpts');
 vi.mock('../../../lib/ui/logger.js');
 vi.mock('../../../lib/errorHandlers/index.js');
-vi.mock('../../../lib/projects/add/v3AddComponent');
+vi.mock('../../../lib/projects/add/v2AddComponent');
 vi.mock('../../../lib/projects/add/legacyAddComponent');
 vi.mock('../../../lib/projects/config');
 vi.mock('../../../lib/projects/platformVersion');
 vi.mock('../../../lib/usageTracking');
-const mockedV3AddComponent = vi.mocked(v3AddComponent);
+const mockedV2AddComponent = vi.mocked(v2AddComponent);
 const mockedLegacyAddComponent = vi.mocked(legacyAddComponent);
 const mockedGetProjectConfig = vi.mocked(getProjectConfig);
-const mockedUseV3Api = vi.mocked(isV2Project);
+const mockedUseV2Api = vi.mocked(isV2Project);
 const mockedTrackCommandUsage = vi.mocked(trackCommandUsage);
 describe('commands/project/add', () => {
     const yargsMock = yargs;
@@ -61,7 +61,7 @@ describe('commands/project/add', () => {
         const mockProjectConfig = {
             name: 'test-project',
             srcDir: 'src',
-            platformVersion: 'v3',
+            platformVersion: '2025.2',
         };
         const mockProjectDir = '/path/to/project';
         const mockArgs = {
@@ -75,23 +75,23 @@ describe('commands/project/add', () => {
                 projectDir: mockProjectDir,
             });
             mockedTrackCommandUsage.mockResolvedValue();
-            mockedV3AddComponent.mockResolvedValue();
+            mockedV2AddComponent.mockResolvedValue();
             mockedLegacyAddComponent.mockResolvedValue();
             vi.spyOn(process, 'exit').mockImplementation(() => {
                 throw new Error('process.exit called');
             });
         });
-        it('should call v3AddComponent with accountId for v3 projects', async () => {
-            mockedUseV3Api.mockReturnValue(true);
+        it('should call v2AddComponent with accountId for v2 projects', async () => {
+            mockedUseV2Api.mockReturnValue(true);
             await expect(projectAddCommand.handler(mockArgs)).rejects.toThrow('process.exit called');
-            expect(mockedV3AddComponent).toHaveBeenCalledWith(mockArgs, mockProjectDir, mockProjectConfig, 123);
+            expect(mockedV2AddComponent).toHaveBeenCalledWith(mockArgs, mockProjectDir, mockProjectConfig, 123);
             expect(mockedLegacyAddComponent).not.toHaveBeenCalled();
         });
-        it('should call legacyAddComponent for non-v3 projects', async () => {
-            mockedUseV3Api.mockReturnValue(false);
+        it('should call legacyAddComponent for non-v2 projects', async () => {
+            mockedUseV2Api.mockReturnValue(false);
             await expect(projectAddCommand.handler(mockArgs)).rejects.toThrow('process.exit called');
             expect(mockedLegacyAddComponent).toHaveBeenCalledWith(mockArgs, mockProjectDir, mockProjectConfig, 123);
-            expect(mockedV3AddComponent).not.toHaveBeenCalled();
+            expect(mockedV2AddComponent).not.toHaveBeenCalled();
         });
         it('should exit with error when project config is not found', async () => {
             mockedGetProjectConfig.mockResolvedValue({

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

@@ -10,6 +10,7 @@ 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;

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

@@ -5,7 +5,7 @@ import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.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';
@@ -20,7 +20,7 @@ async function handler(args) {
         }
         const isV2ProjectCreate = isV2Project(projectConfig.platformVersion);
         if (isV2ProjectCreate) {
-            await v3AddComponent(args, projectDir, projectConfig, derivedAccountId);
+            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/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';

package/commands/project/dev/deprecatedFlow.js

@@ -6,7 +6,7 @@ import { commands } from '../../../lang/en.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.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';
@@ -121,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

@@ -12,14 +12,14 @@ import { commands } from '../../../lang/en.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 const command = 'dev';
 const describe = commands.project.dev.describe;
-function validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV3) {
+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);
     }
 }
@@ -35,7 +35,7 @@ async function handler(args) {
     validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV2Projects);
     uiLogger.log(commands.project.dev.logs.header);
     if (useV2Projects) {
-        uiLogger.log(commands.project.dev.logs.learnMoreMessageV3);
+        uiLogger.log(commands.project.dev.logs.learnMoreMessageV2);
     }
     else {
         uiLogger.log(commands.project.dev.logs.learnMoreMessageLegacy);

package/commands/project/dev/unifiedFlow.js

@@ -1,6 +1,7 @@
 import path from 'path';
 import util from 'util';
 import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
+import { startPortManagerServer, stopPortManagerServer, } from '@hubspot/local-dev-lib/portManager';
 import { isTranslationError } from '@hubspot/project-parsing-lib/src/lib/errors.js';
 import { translateForLocalDev } from '@hubspot/project-parsing-lib';
 import { getEnv, getConfigAccounts, getAccountConfig, } from '@hubspot/local-dev-lib/config';
@@ -19,7 +20,9 @@ import { isTestAccountOrSandbox, isUnifiedAccount, } from '../../../lib/accountT
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { commands } from '../../../lang/en.js';
 import LocalDevWebsocketServer from '../../../lib/projects/localDev/LocalDevWebsocketServer.js';
+import { confirmLocalDevIsNotRunning } from '../../../lib/projects/localDev/helpers/process.js';
 export async function unifiedProjectDevFlow({ args, targetProjectAccountId, providedTargetTestingAccountId, projectConfig, projectDir, }) {
+    await confirmLocalDevIsNotRunning();
     const env = getValidEnv(getEnv(targetProjectAccountId));
     let projectNodes;
     let projectProfileData;
@@ -121,6 +124,7 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
     // Check for missing/outdated dependencies
     await checkAndInstallDependencies();
     // End setup, start local dev process
+    await startPortManagerServer();
     const localDevProcess = new LocalDevProcess({
         initialProjectNodes: projectNodes,
         initialProjectProfileData: projectProfileData,
@@ -133,11 +137,11 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
         projectData: project,
         env,
     });
-    await localDevProcess.start();
-    const watcher = new LocalDevWatcher(localDevProcess);
-    watcher.start();
     const websocketServer = new LocalDevWebsocketServer(localDevProcess, args.debug);
+    const watcher = new LocalDevWatcher(localDevProcess);
     await websocketServer.start();
+    await localDevProcess.start();
+    watcher.start();
     handleKeypress(async (key) => {
         if ((key.ctrl && key.name === 'c') || key.name === 'q') {
             await Promise.all([
@@ -151,5 +155,6 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
         localDevProcess.stop(!isSIGHUP);
         watcher.stop();
         websocketServer.shutdown();
+        stopPortManagerServer();
     });
 }

package/commands/project/download.js

@@ -35,9 +35,12 @@ async function handler(args) {
             uiLogger.error(commands.project.download.errors.noBuildIdToDownload);
             process.exit(EXIT_CODES.ERROR);
         }
-        const absoluteDestPath = dest ? path.resolve(getCwd(), dest) : getCwd();
+        const sanitizedProjectName = sanitizeFileName(projectName);
+        const absoluteDestPath = dest
+            ? path.resolve(getCwd(), dest, sanitizedProjectName)
+            : path.resolve(getCwd(), sanitizedProjectName);
         const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, buildNumberToDownload);
-        await extractZipArchive(zippedProject, sanitizeFileName(projectName), path.resolve(absoluteDestPath), { includesRootDir: false });
+        await extractZipArchive(zippedProject, sanitizeFileName(projectName), path.resolve(absoluteDestPath));
         uiLogger.log(commands.project.download.logs.downloadSucceeded(buildNumberToDownload, projectName));
         process.exit(EXIT_CODES.SUCCESS);
     }

package/commands/project/installDeps.d.ts

@@ -1,5 +1,5 @@
-import { CommonArgs, YargsCommandModule } from '../../types/Yargs.js';
-export type ProjectInstallDepsArgs = CommonArgs & {
+import { CommonArgs, ConfigArgs, YargsCommandModule } from '../../types/Yargs.js';
+export type ProjectInstallDepsArgs = CommonArgs & ConfigArgs & {
     packages?: string[];
 };
 declare const projectInstallDepsCommand: YargsCommandModule<unknown, ProjectInstallDepsArgs>;

package/commands/project/installDeps.js

@@ -69,6 +69,7 @@ function projectInstallDepsBuilder(yargs) {
 }
 const builder = makeYargsBuilder(projectInstallDepsBuilder, command, describe, {
     useGlobalOptions: true,
+    useConfigOptions: true,
 });
 const projectInstallDepsCommand = {
     command,

package/commands/project/list.d.ts

@@ -0,0 +1,4 @@
+import { AccountArgs, CommonArgs, ConfigArgs, YargsCommandModule } from '../../types/Yargs.js';
+type ProjectListArgs = CommonArgs & ConfigArgs & AccountArgs;
+declare const projectListCommand: YargsCommandModule<unknown, ProjectListArgs>;
+export default projectListCommand;

package/commands/project/list.js

@@ -0,0 +1,62 @@
+import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { fetchProjects } from '@hubspot/local-dev-lib/api/projects';
+import { logError } from '../../lib/errorHandlers/index.js';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { getTableContents, getTableHeader } from '../../lib/ui/table.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { commands } from '../../lang/en.js';
+const command = ['list', 'ls'];
+const describe = commands.project.list.describe;
+async function getProjectData(accountId) {
+    try {
+        const { data: projects } = await fetchProjects(accountId);
+        return projects.results;
+    }
+    catch (e) {
+        logError(e);
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+function formatProjectsAsTableRows(projects) {
+    const projectListData = [];
+    projects.forEach(project => {
+        projectListData.push([
+            project.name,
+            project.latestBuild ? project.latestBuild.platformVersion : '',
+        ]);
+    });
+    return projectListData;
+}
+async function handler(args) {
+    const { derivedAccountId } = args;
+    trackCommandUsage('projects-list', undefined, derivedAccountId);
+    const projectData = await getProjectData(derivedAccountId);
+    if (projectData.length === 0) {
+        uiLogger.error(commands.project.list.errors.noProjectsFound(derivedAccountId));
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const projectListData = formatProjectsAsTableRows(projectData);
+    projectListData.unshift(getTableHeader([
+        commands.project.list.labels.name,
+        commands.project.list.labels.platformVersion,
+    ]));
+    uiLogger.log(commands.project.list.projects);
+    uiLogger.log(getTableContents(projectListData, { border: { bodyLeft: '  ' } }));
+}
+function projectListBuilder(yargs) {
+    yargs.example([['$0 project list']]);
+    return yargs;
+}
+const builder = makeYargsBuilder(projectListBuilder, command, describe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+});
+const projectListCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+export default projectListCommand;