@hubspot/cli 7.8.0-experimental.0 → 7.8.0

package/commands/hubdb/fetch.js

@@ -1,12 +1,12 @@
-import { logger } from '@hubspot/local-dev-lib/logger';
+import { uiLogger } from '../../lib/ui/logger.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { downloadHubDbTable } from '@hubspot/local-dev-lib/hubdb';
 import { selectHubDBTablePrompt } from '../../lib/prompts/selectHubDBTablePrompt.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
-import { i18n } from '../../lib/lang.js';
+import { commands } from '../../lang/en.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'fetch [table-id] [dest]';
-const describe = i18n('commands.hubdb.subcommands.fetch.describe');
+const describe = commands.hubdb.subcommands.fetch.describe;
 async function handler(args) {
     const { derivedAccountId } = args;
     trackCommandUsage('hubdb-fetch', {}, derivedAccountId);
@@ -19,10 +19,7 @@ async function handler(args) {
         const tableId = args.tableId || promptAnswers.tableId;
         const dest = args.dest || promptAnswers.dest;
         const { filePath } = await downloadHubDbTable(derivedAccountId, tableId, dest);
-        logger.success(i18n('commands.hubdb.subcommands.fetch.success.fetch', {
-            path: filePath,
-            tableId,
-        }));
+        uiLogger.success(commands.hubdb.subcommands.fetch.success.fetch(tableId, filePath));
     }
     catch (e) {
         logError(e);
@@ -30,11 +27,11 @@ async function handler(args) {
 }
 function hubdbFetchBuilder(yargs) {
     yargs.positional('table-id', {
-        describe: i18n('commands.hubdb.subcommands.fetch.positionals.tableId.describe'),
+        describe: commands.hubdb.subcommands.fetch.positionals.tableId.describe,
         type: 'string',
     });
     yargs.positional('dest', {
-        describe: i18n('commands.hubdb.subcommands.fetch.positionals.dest.describe'),
+        describe: commands.hubdb.subcommands.fetch.positionals.dest.describe,
         type: 'string',
     });
     return yargs;

package/commands/hubdb.d.ts

@@ -1,5 +1,5 @@
 import { YargsCommandModuleBucket } from '../types/Yargs.js';
 export declare const command = "hubdb";
-export declare const describe: string;
+export declare const describe: "Commands for managing HubDB tables.";
 declare const hubdbCommand: YargsCommandModuleBucket;
 export default hubdbCommand;

package/commands/hubdb.js

@@ -3,10 +3,10 @@ import fetchCommand from './hubdb/fetch.js';
 import deleteCommand from './hubdb/delete.js';
 import clearCommand from './hubdb/clear.js';
 import listCommand from './hubdb/list.js';
-import { i18n } from '../lib/lang.js';
+import { commands } from '../lang/en.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 export const command = 'hubdb';
-export const describe = i18n('commands.hubdb.describe');
+export const describe = commands.hubdb.describe;
 function hubdbBuilder(yargs) {
     yargs
         .command(clearCommand)

package/commands/init.js

@@ -9,7 +9,7 @@ import { getCwd } from '@hubspot/local-dev-lib/path';
 import { toKebabCase } from '@hubspot/local-dev-lib/text';
 import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
 import { getAccountIdentifier } from '@hubspot/local-dev-lib/config/getAccountIdentifier';
-import { setLogLevel } from '../lib/commonOpts.js';
+import { setCLILogLevel } from '../lib/commonOpts.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { handleExit } from '../lib/process.js';
 import { debugError, logError } from '../lib/errorHandlers/index.js';
@@ -74,7 +74,7 @@ async function handler(args) {
         PERSONAL_ACCESS_KEY_AUTH_METHOD.value;
     const configPath = (configFlagValue && path.join(getCwd(), configFlagValue)) ||
         getConfigPath('', useHiddenConfig);
-    setLogLevel(args);
+    setCLILogLevel(args);
     if (!disableTracking) {
         trackCommandUsage('init', {
             authType,
@@ -99,7 +99,6 @@ async function handler(args) {
         uiLogger.error(commands.init.errors.bothConfigFilesNotAllowed(path));
         process.exit(EXIT_CODES.ERROR);
     }
-    trackAuthAction('init', authType, TRACKING_STATUS.STARTED, parsedUserProvidedAccountId);
     createEmptyConfigFile({ path: configPath }, useHiddenConfig);
     //Needed to load deprecated config
     loadConfig(configPath, args);

package/commands/lint.js

@@ -1,11 +1,11 @@
 import { lint } from '@hubspot/local-dev-lib/cms/validate';
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { logError } from '../lib/errorHandlers/index.js';
 import { trackCommandUsage } from '../lib/usageTracking.js';
-import { i18n } from '../lib/lang.js';
+import { commands } from '../lang/en.js';
 import { resolveLocalPath } from '../lib/filesystem.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
+import { uiLogger } from '../lib/ui/logger.js';
 const command = 'lint <path>';
 // Hiding since this command is still experimental
 const describe = undefined; //'Lint a file or folder for HubL syntax';
@@ -14,8 +14,12 @@ function getErrorsFromHublValidationObject(validation) {
 }
 function printHublValidationError(err) {
     const { severity, message, lineno, startPosition } = err;
-    const method = severity === 'FATAL' ? 'error' : 'warn';
-    logger[method]('[%d, %d]: %s', lineno, startPosition, message);
+    if (severity === 'FATAL') {
+        uiLogger.error(`[${lineno}, ${startPosition}]: ${message}`);
+    }
+    else {
+        uiLogger.warn(`[${lineno}, ${startPosition}]: ${message}`);
+    }
 }
 function printHublValidationResult({ file, validation }) {
     let count = 0;
@@ -26,7 +30,7 @@ function printHublValidationResult({ file, validation }) {
     if (!errors.length) {
         return count;
     }
-    logger.group(file);
+    uiLogger.group(file);
     errors.forEach(err => {
         if (err.reason !== 'SYNTAX_ERROR') {
             return;
@@ -34,17 +38,15 @@ function printHublValidationResult({ file, validation }) {
         ++count;
         printHublValidationError(err);
     });
-    logger.groupEnd();
+    uiLogger.groupEnd();
     return count;
 }
 async function handler(args) {
     const { path: lintPath, derivedAccountId } = args;
     const localPath = resolveLocalPath(lintPath);
-    const groupName = i18n(`commands.lint.groupName`, {
-        path: localPath,
-    });
+    const groupName = commands.lint.groupName(localPath);
     trackCommandUsage('lint', undefined, derivedAccountId);
-    logger.group(groupName);
+    uiLogger.group(groupName);
     let count = 0;
     try {
         await lint(derivedAccountId, localPath, (result) => {
@@ -52,18 +54,16 @@ async function handler(args) {
         });
     }
     catch (err) {
-        logger.groupEnd();
+        uiLogger.groupEnd();
         logError(err, { accountId: derivedAccountId });
         process.exit(EXIT_CODES.ERROR);
     }
-    logger.groupEnd();
-    logger.log(i18n(`commands.lint.issuesFound`, {
-        count,
-    }));
+    uiLogger.groupEnd();
+    uiLogger.log(commands.lint.issuesFound(count));
 }
 function lintBuilder(yargs) {
     yargs.positional('path', {
-        describe: i18n(`commands.lint.positionals.path.describe`),
+        describe: commands.lint.positionals.path.describe,
         required: true,
         type: 'string',
     });

package/commands/list.js

@@ -1,13 +1,13 @@
 import chalk from 'chalk';
 import { trackCommandUsage } from '../lib/usageTracking.js';
 import { isPathFolder } from '../lib/filesystem.js';
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { logError } from '../lib/errorHandlers/index.js';
 import { getDirectoryContentsByPath } from '@hubspot/local-dev-lib/api/fileMapper';
 import { HUBSPOT_FOLDER, MARKETPLACE_FOLDER } from '../lib/constants.js';
-import { i18n } from '../lib/lang.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
+import { uiLogger } from '../lib/ui/logger.js';
+import { commands } from '../lang/en.js';
 function addColorToContents(fileOrFolder) {
     if (!isPathFolder(fileOrFolder)) {
         return chalk.reset.cyan(fileOrFolder);
@@ -35,15 +35,13 @@ function sortContents(a, b) {
     return a.localeCompare(b);
 }
 const command = ['list [path]', 'ls [path]'];
-const describe = i18n(`commands.list.describe`);
+const describe = commands.list.describe;
 async function handler(args) {
     const { path, derivedAccountId } = args;
     const directoryPath = path || '/';
     let contentsResp;
     trackCommandUsage('list', undefined, derivedAccountId);
-    logger.debug(i18n(`commands.list.gettingPathContents`, {
-        path: directoryPath,
-    }));
+    uiLogger.debug(commands.list.gettingPathContents(directoryPath));
     try {
         const { data } = await getDirectoryContentsByPath(derivedAccountId, directoryPath);
         contentsResp = data;
@@ -53,9 +51,7 @@ async function handler(args) {
         process.exit(EXIT_CODES.ERROR);
     }
     if (!contentsResp.folder) {
-        logger.info(i18n(`commands.list.noFilesFoundAtPath`, {
-            path: directoryPath,
-        }));
+        uiLogger.info(commands.list.noFilesFoundAtPath(directoryPath));
         return;
     }
     // getDirectoryContentsByPath omits @hubspot
@@ -63,21 +59,19 @@ async function handler(args) {
         ? ['@hubspot', ...contentsResp.children]
         : contentsResp.children;
     if (contents.length === 0) {
-        logger.info(i18n(`commands.list.noFilesFoundAtPath`, {
-            path: directoryPath,
-        }));
+        uiLogger.info(commands.list.noFilesFoundAtPath(directoryPath));
         return;
     }
     const folderContentsOutput = contents
         .map(addColorToContents)
         .sort(sortContents)
         .join('\n');
-    logger.log(folderContentsOutput);
+    uiLogger.log(folderContentsOutput);
     process.exit(EXIT_CODES.SUCCESS);
 }
 function cmsListBuilder(yargs) {
     yargs.positional('path', {
-        describe: i18n(`commands.list.positionals.path.describe`),
+        describe: commands.list.positionals.path.describe,
         type: 'string',
     });
     yargs.example([['$0 list'], ['$0 list /'], ['$0 list my-modules']]);

package/commands/logs.js

@@ -1,19 +1,16 @@
 import { trackCommandUsage } from '../lib/usageTracking.js';
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { outputLogs } from '../lib/ui/serverlessFunctionLogs.js';
 import { getFunctionLogs, getLatestFunctionLog, } from '@hubspot/local-dev-lib/api/functions';
 import { tailLogs } from '../lib/serverlessLogs.js';
-import { i18n } from '../lib/lang.js';
 import { promptUser } from '../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
+import { uiLogger } from '../lib/ui/logger.js';
+import { commands } from '../lang/en.js';
 const handleLogsError = (e, accountId, functionPath) => {
     if (isHubSpotHttpError(e) && (e.status === 404 || e.status == 400)) {
-        logger.error(i18n(`commands.logs.errors.noLogsFound`, {
-            accountId,
-            functionPath,
-        }));
+        uiLogger.error(commands.logs.errors.noLogsFound(functionPath, accountId));
     }
 };
 const endpointLog = async (accountId, functionPath, options) => {
@@ -24,10 +21,7 @@ const endpointLog = async (accountId, functionPath, options) => {
         follow,
         endpoint: functionPath,
     };
-    logger.debug(i18n(`commands.logs.gettingLogs`, {
-        latest,
-        functionPath,
-    }));
+    uiLogger.debug(commands.logs.gettingLogs(latest, functionPath));
     let logsResp;
     if (follow) {
         const tailCall = (after) => getFunctionLogs(accountId, functionPath, { after });
@@ -67,48 +61,48 @@ const endpointLog = async (accountId, functionPath, options) => {
     }
 };
 const command = 'logs [endpoint]';
-const describe = i18n(`commands.logs.describe`);
+const describe = commands.logs.describe;
 const handler = async (options) => {
     const { endpoint: endpointArgValue, latest, derivedAccountId } = options;
     trackCommandUsage('logs', latest ? { action: 'latest' } : {}, derivedAccountId);
     const { endpointPromptValue } = await promptUser({
         name: 'endpointPromptValue',
-        message: i18n(`commands.logs.endpointPrompt`),
+        message: commands.logs.endpointPrompt,
         when: !endpointArgValue,
     });
     await endpointLog(derivedAccountId, endpointArgValue || endpointPromptValue, options);
 };
 function logsBuilder(yargs) {
     yargs.positional('endpoint', {
-        describe: i18n(`commands.logs.positionals.endpoint.describe`),
+        describe: commands.logs.positionals.endpoint.describe,
         type: 'string',
     });
     yargs
         .options({
         latest: {
             alias: 'l',
-            describe: i18n(`commands.logs.options.latest.describe`),
+            describe: commands.logs.options.latest.describe,
             type: 'boolean',
         },
         compact: {
-            describe: i18n(`commands.logs.options.compact.describe`),
+            describe: commands.logs.options.compact.describe,
             type: 'boolean',
         },
         follow: {
             alias: ['f'],
-            describe: i18n(`commands.logs.options.follow.describe`),
+            describe: commands.logs.options.follow.describe,
             type: 'boolean',
         },
         limit: {
-            describe: i18n(`commands.logs.options.limit.describe`),
+            describe: commands.logs.options.limit.describe,
             type: 'number',
         },
     })
         .conflicts('follow', 'limit');
     yargs.example([
-        ['$0 logs my-endpoint', i18n(`commands.logs.examples.default`)],
-        ['$0 logs my-endpoint --limit=10', i18n(`commands.logs.examples.limit`)],
-        ['$0 logs my-endpoint --follow', i18n(`commands.logs.examples.follow`)],
+        ['$0 logs my-endpoint', commands.logs.examples.default],
+        ['$0 logs my-endpoint --limit=10', commands.logs.examples.limit],
+        ['$0 logs my-endpoint --follow', commands.logs.examples.follow],
     ]);
     return yargs;
 }

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

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

package/commands/mcp/setup.js

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

package/commands/mcp.js

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

package/commands/mv.js

@@ -1,12 +1,12 @@
-import { logger } from '@hubspot/local-dev-lib/logger';
 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 { i18n } from '../lib/lang.js';
 import { uiBetaTag } from '../lib/ui/index.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;
@@ -15,29 +15,18 @@ function getCorrectedDestPath(srcPath, destPath) {
     return `${destPath}/${srcPath.split('/').pop()}`;
 }
 const command = 'mv <srcPath> <destPath>';
-const describe = uiBetaTag(i18n(`commands.mv.describe`), false);
+const describe = uiBetaTag(commands.mv.describe, false);
 async function handler(args) {
     const { srcPath, destPath, derivedAccountId } = args;
     trackCommandUsage('mv', undefined, derivedAccountId);
     try {
         await moveFile(derivedAccountId, srcPath, getCorrectedDestPath(srcPath, destPath));
-        logger.success(i18n(`commands.mv.move`, {
-            accountId: derivedAccountId,
-            destPath,
-            srcPath,
-        }));
+        uiLogger.success(commands.mv.move(srcPath, destPath, derivedAccountId));
     }
     catch (error) {
-        logger.error(i18n(`commands.mv.errors.moveFailed`, {
-            accountId: derivedAccountId,
-            destPath,
-            srcPath,
-        }));
+        uiLogger.error(commands.mv.errors.moveFailed(srcPath, destPath, derivedAccountId));
         if (isSpecifiedError(error, { statusCode: 409 })) {
-            logger.error(i18n(`commands.mv.errors.sourcePathExists`, {
-                destPath,
-                srcPath,
-            }));
+            uiLogger.error(commands.mv.errors.sourcePathExists(srcPath, destPath));
         }
         else {
             logError(error, new ApiErrorContext({

package/commands/open.js

@@ -1,7 +1,7 @@
 import { trackCommandUsage } from '../lib/usageTracking.js';
 import { logSiteLinks, getSiteLinksAsArray, openLink } from '../lib/links.js';
 import { promptUser } from '../lib/prompts/promptUtils.js';
-import { i18n } from '../lib/lang.js';
+import { commands } from '../lang/en.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 const separator = ' => ';
@@ -10,7 +10,7 @@ async function createListPrompt(accountId) {
         name: 'open',
         type: 'rawlist',
         pageSize: 20,
-        message: i18n('commands.open.selectLink'),
+        message: commands.open.selectLink,
         choices: getSiteLinksAsArray(accountId)
             .filter(l => !!l.url)
             .map(l => ({
@@ -20,7 +20,7 @@ async function createListPrompt(accountId) {
     });
 }
 const command = 'open [shortcut]';
-const describe = i18n('commands.open.describe');
+const describe = commands.open.describe;
 async function handler(args) {
     const { shortcut, list, derivedAccountId } = args;
     trackCommandUsage('open', undefined, derivedAccountId);
@@ -38,12 +38,12 @@ async function handler(args) {
 }
 function openBuilder(yargs) {
     yargs.positional('[shortcut]', {
-        describe: i18n('commands.open.positionals.shortcut.describe'),
+        describe: commands.open.positionals.shortcut.describe,
         type: 'string',
     });
     yargs.option('list', {
         alias: 'l',
-        describe: i18n('commands.open.options.list.describe'),
+        describe: commands.open.options.list.describe,
         type: 'boolean',
     });
     yargs.example([

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

@@ -1,21 +1,23 @@
 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 { useV3Api } from '../../../lib/projects/platformVersion.js';
+import { isV2Project } from '../../../lib/projects/platformVersion.js';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
 vi.mock('../../../lib/commonOpts');
-vi.mock('../../../lib/projects/add/v3AddComponent');
+vi.mock('../../../lib/ui/logger.js');
+vi.mock('../../../lib/errorHandlers/index.js');
+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(useV3Api);
+const mockedUseV2Api = vi.mocked(isV2Project);
 const mockedTrackCommandUsage = vi.mocked(trackCommandUsage);
 describe('commands/project/add', () => {
     const yargsMock = yargs;
@@ -59,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 = {
@@ -73,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__/create.test.js

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

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

@@ -1,7 +1,6 @@
 import { HttpStatusCode } from 'axios';
 import yargs from 'yargs';
 import chalk from 'chalk';
-import { logger } from '@hubspot/local-dev-lib/logger';
 import * as configUtils from '@hubspot/local-dev-lib/config';
 import * as projectApiUtils from '@hubspot/local-dev-lib/api/projects';
 import * as ui from '../../../lib/ui/index.js';
@@ -29,7 +28,7 @@ vi.mock('../../../lib/prompts/projectNamePrompt');
 vi.mock('../../../lib/prompts/promptUtils');
 vi.mock('../../../lib/usageTracking');
 vi.mock('../../../lib/ui/logger');
-vi.mock('@hubspot/local-dev-lib/logger');
+vi.mock('../../ui/logger.js');
 vi.spyOn(ui, 'uiLine');
 const uiCommandReferenceSpy = vi.spyOn(ui, 'uiCommandReference');
 const uiAccountDescriptionSpy = vi.spyOn(ui, 'uiAccountDescription');
@@ -62,9 +61,6 @@ describe('commands/project/deploy', () => {
         });
     });
     describe('describe', () => {
-        it('should contain the beta tag', () => {
-            expect(projectDeployCommand.describe).toContain('[BETA]');
-        });
         it('should provide a description', () => {
             expect(projectDeployCommand.describe).toBeDefined();
         });
@@ -300,8 +296,8 @@ describe('commands/project/deploy', () => {
                 });
             });
             await projectDeployCommand.handler(args);
-            expect(logger.error).toHaveBeenCalledTimes(1);
-            expect(logger.error).toHaveBeenCalledWith(`The request for 'project deploy' in account ${args.derivedAccountId} failed due to a client error.`);
+            expect(uiLogger.error).toHaveBeenCalledTimes(1);
+            expect(uiLogger.error).toHaveBeenCalledWith(`The request for 'project deploy' in account ${args.derivedAccountId} failed due to a client error.`);
             expect(processExitSpy).toHaveBeenCalledTimes(1);
             expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
         });