@hubspot/cli 7.8.1-experimental.0 → 7.8.3-experimental.0

package/commands/project/migrate.js

@@ -8,12 +8,14 @@ import { uiCommandReference } from '../../lib/ui/index.js';
 import { commands, lib } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { logInBox } from '../../lib/ui/boxen.js';
+import { renderInline } from '../../ui/index.js';
+import { getWarningBox } from '../../ui/components/StatusMessageBoxes.js';
 import { getHasMigratableThemes, migrateThemes2025_2, } from '../../lib/theme/migrate.js';
 import { hasFeature } from '../../lib/hasFeature.js';
 import { FEATURES } from '../../lib/constants.js';
 const { v2025_2 } = PLATFORM_VERSIONS;
 const command = 'migrate';
-const describe = undefined; // commands.project.migrate.describe
+const describe = commands.project.migrate.describe;
 async function handler(args) {
     const { platformVersion, unstable } = args;
     const projectConfig = await getProjectConfig();
@@ -22,10 +24,18 @@ async function handler(args) {
         return process.exit(EXIT_CODES.ERROR);
     }
     if (projectConfig?.projectConfig) {
-        await logInBox({
-            contents: lib.migrate.projectMigrationWarning,
-            options: { title: lib.migrate.projectMigrationWarningTitle },
-        });
+        if (!process.env.HUBSPOT_ENABLE_INK) {
+            await logInBox({
+                contents: lib.migrate.projectMigrationWarning,
+                options: { title: lib.migrate.projectMigrationWarningTitle },
+            });
+        }
+        else {
+            await renderInline(getWarningBox({
+                title: lib.migrate.projectMigrationWarningTitle,
+                message: lib.migrate.projectMigrationWarning,
+            }));
+        }
     }
     const { derivedAccountId } = args;
     try {
@@ -65,7 +75,6 @@ function projectMigrateBuilder(yargs) {
         type: 'string',
         choices: [v2025_2],
         default: v2025_2,
-        hidden: true,
     })
         .option('unstable', {
         type: 'boolean',

package/commands/project/migrateApp.js

@@ -34,8 +34,7 @@ function projectMigrateAppBuilder(yargs) {
         'platform-version': {
             type: 'string',
             choices: [v2023_2, v2025_2],
-            hidden: true,
-            default: v2023_2,
+            default: v2025_2,
         },
     });
     yargs.example([

package/commands/project/open.js

@@ -6,11 +6,10 @@ import { getProjectConfig } from '../../lib/projects/config.js';
 import { ensureProjectExists } from '../../lib/projects/ensureProjectExists.js';
 import { getProjectDetailUrl } from '../../lib/projects/urls.js';
 import { projectNamePrompt } from '../../lib/prompts/projectNamePrompt.js';
-import { uiBetaTag } from '../../lib/ui/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'open';
-const describe = uiBetaTag(i18n(`commands.project.subcommands.open.describe`), false);
+const describe = i18n(`commands.project.subcommands.open.describe`);
 async function handler(args) {
     const { project, derivedAccountId } = args;
     trackCommandUsage('project-open', undefined, derivedAccountId);

package/commands/project/profile/add.js

@@ -5,7 +5,7 @@ import { getAccountIdentifier } from '@hubspot/local-dev-lib/config/getAccountId
 import { getAllHsProfiles, getHsProfileFilename, loadHsProfileFile, } from '@hubspot/project-parsing-lib';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
 import { getProjectConfig } from '../../../lib/projects/config.js';
-import { uiBetaTag, uiAccountDescription } from '../../../lib/ui/index.js';
+import { uiAccountDescription } from '../../../lib/ui/index.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
@@ -14,8 +14,8 @@ import { promptUser, listPrompt, confirmPrompt, } from '../../../lib/prompts/pro
 import { fileExists } from '../../../lib/validation.js';
 import { debugError } from '../../../lib/errorHandlers/index.js';
 const command = 'add [name]';
-const describe = uiBetaTag(commands.project.profile.add.describe, false);
-const verboseDescribe = uiBetaTag(commands.project.profile.add.verboseDescribe, false);
+const describe = commands.project.profile.add.describe;
+const verboseDescribe = commands.project.profile.add.verboseDescribe;
 async function selectProfileToCopyVariablesFrom(existingProfiles) {
     let profileToCopyVariablesFrom;
     if (existingProfiles.length == 1) {

package/commands/project/profile/delete.js

@@ -5,7 +5,6 @@ import { fetchProject, deleteProject, } from '@hubspot/local-dev-lib/api/project
 import { getAccountConfig } from '@hubspot/local-dev-lib/config';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
 import { getProjectConfig } from '../../../lib/projects/config.js';
-import { uiBetaTag } from '../../../lib/ui/index.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
@@ -15,7 +14,7 @@ import { fileExists } from '../../../lib/validation.js';
 import { debugError } from '../../../lib/errorHandlers/index.js';
 import { isDeveloperTestAccount, isSandbox, } from '../../../lib/accountTypes.js';
 const command = 'delete [name]';
-const describe = uiBetaTag(commands.project.profile.delete.describe, false);
+const describe = commands.project.profile.delete.describe;
 async function handler(args) {
     const { derivedAccountId } = args;
     trackCommandUsage('project-profile-delete', undefined, derivedAccountId);

package/commands/project/profile.js

@@ -1,11 +1,10 @@
-import { uiBetaTag } from '../../lib/ui/index.js';
 import add from './profile/add.js';
 import deleteProfile from './profile/delete.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 const command = ['profile', 'profiles'];
-const describe = undefined; // uiBetaTag(commands.project.profile.describe, false);
-const verboseDescribe = uiBetaTag(commands.project.profile.verboseDescribe, false);
+const describe = commands.project.profile.describe;
+const verboseDescribe = commands.project.profile.verboseDescribe;
 function projectProfileBuilder(yargs) {
     yargs.command(add).command(deleteProfile).demandCommand(1, '');
     return yargs;

package/commands/project/upload.js

@@ -3,7 +3,7 @@ import { logger } from '@hubspot/local-dev-lib/logger';
 import { getAccountConfig } from '@hubspot/local-dev-lib/config';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
 import { useV3Api } from '../../lib/projects/platformVersion.js';
-import { uiBetaTag, uiCommandReference } from '../../lib/ui/index.js';
+import { uiCommandReference } from '../../lib/ui/index.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { logFeedbackMessage } from '../../lib/projects/ui.js';
@@ -17,7 +17,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 const command = 'upload';
-const describe = uiBetaTag(i18n(`commands.project.subcommands.upload.describe`), false);
+const describe = i18n(`commands.project.subcommands.upload.describe`);
 async function handler(args) {
     const { forceCreate, message, derivedAccountId, skipValidation, formatOutputAsJson, profile, } = args;
     const jsonOutput = {};

package/commands/project/validate.js

@@ -11,7 +11,7 @@ import { commands } from '../../lang/en.js';
 import { loadAndValidateProfile } from '../../lib/projectProfiles.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 const command = 'validate';
-const describe = undefined;
+const describe = commands.project.validate.describe;
 async function handler(args) {
     const { derivedAccountId, profile } = args;
     const { projectConfig, projectDir } = await getProjectConfig();

package/commands/project/watch.js

@@ -1,7 +1,7 @@
 import { cancelStagedBuild, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
 import { useV3Api } from '../../lib/projects/platformVersion.js';
-import { uiCommandReference, uiLink, uiBetaTag } from '../../lib/ui/index.js';
+import { uiCommandReference, uiLink } from '../../lib/ui/index.js';
 import { i18n } from '../../lib/lang.js';
 import { createWatcher } from '../../lib/projects/watch.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
@@ -16,7 +16,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { handleKeypress, handleExit } from '../../lib/process.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'watch';
-const describe = uiBetaTag(i18n(`commands.project.subcommands.watch.describe`), false);
+const describe = i18n(`commands.project.subcommands.watch.describe`);
 async function handleBuildStatus(accountId, projectName, buildId) {
     const { isAutoDeployEnabled, deployStatusTaskLocator } = await pollBuildStatus(accountId, projectName, buildId, null);
     if (isAutoDeployEnabled && deployStatusTaskLocator) {

package/commands/project.js

@@ -1,5 +1,4 @@
 import { i18n } from '../lib/lang.js';
-import { uiBetaTag } from '../lib/ui/index.js';
 import deploy from './project/deploy.js';
 import create from './project/create.js';
 import upload from './project/upload.js';
@@ -18,7 +17,7 @@ import profile from './project/profile.js';
 import projectValidate from './project/validate.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 const command = ['project', 'projects'];
-const describe = uiBetaTag(i18n(`commands.project.describe`), false);
+const describe = i18n(`commands.project.describe`);
 function projectBuilder(yargs) {
     yargs
         .command(create)

package/commands/sandbox/delete.js

@@ -121,7 +121,7 @@ async function handler(args) {
             const newDefaultAccount = await selectAccountFromConfig();
             updateDefaultAccount(newDefaultAccount);
         }
-        else {
+        else if (isDefaultAccount && force) {
             // If force is specified, skip prompt and set the parent account id as the default account
             updateDefaultAccount(parentAccountId);
         }

package/commands/testAccount/importData.d.ts

@@ -1,6 +1,6 @@
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs.js';
 export declare const command = "import-data";
-export declare const describe: undefined;
+export declare const describe: "Import data into the CRM";
 type CrmImportDataArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
     filePath: string | undefined;
     skipConfirm: boolean | undefined;

package/commands/testAccount/importData.js

@@ -8,7 +8,7 @@ import { handleImportData, handleTargetTestAccountSelectionFlow, } from '../../l
 import { confirmImportDataPrompt } from '../../lib/prompts/confirmImportDataPrompt.js';
 import { commands } from '../../lang/en.js';
 export const command = 'import-data';
-export const describe = undefined; // commands.testAccount.subcommands.importData.describe;
+export const describe = commands.testAccount.subcommands.importData.describe;
 async function handler(args) {
     const { derivedAccountId, userProvidedAccount, filePath: providedFilePath, skipConfirm, } = args;
     trackCommandUsage('crm-import-data', {}, derivedAccountId);

package/commands/testAccount.js

@@ -5,7 +5,7 @@ import deleteTestAccountCommand from './testAccount/delete.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { commands } from '../lang/en.js';
 const command = ['test-account', 'test-accounts'];
-const describe = undefined; //commands.testAccount.describe;
+const describe = commands.testAccount.describe;
 function testAccountBuilder(yargs) {
     yargs
         .command(createTestAccountCommand)

package/lang/en.d.ts

@@ -10,6 +10,7 @@ export declare const commands: {
         };
     };
     readonly getStarted: {
+        readonly describe: "A step-by-step command to get you started with a HubSpot project.";
         readonly options: {
             readonly dest: {
                 readonly describe: "Directory where the project should be created";
@@ -859,8 +860,9 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
         readonly tailLogs: (functionPath: string, accountId: string) => string;
     };
     readonly mcp: {
-        readonly describe: "Commands for managing HubSpot MCP servers";
+        readonly describe: "Commands for managing HubSpot MCP servers.";
         readonly setup: {
+            readonly describe: "Setup the HubSpot development MCP servers.";
             readonly installingDocSearch: "Adding the docs-search mcp server";
             readonly claudeCode: "Claude Code";
             readonly cursor: "Cursor";
@@ -1009,7 +1011,7 @@ Profiles enable you to reference variables in your component configuration files
         readonly dev: {
             readonly describe: "Start local dev for the current project.";
             readonly logs: {
-                readonly betaMessage: "HubSpot projects local development";
+                readonly header: "HubSpot projects local development";
                 readonly placeholderAccountSelection: "Using default account as target account (for now)";
                 readonly accountTypeInformation: "Testing in a developer test account is strongly recommended, but you can use a sandbox account if your plan allows you to create one.";
                 readonly learnMoreMessageV3: `Learn more about ${string} | ${string}`;
@@ -1071,7 +1073,7 @@ ${string}`;
                     readonly describe: "Project name (cannot be changed)";
                 };
                 readonly template: {
-                    readonly describe: "The starting template";
+                    readonly describe: "The starting template.  Only applies when platform version is less than 2025.2.";
                 };
                 readonly templateSource: {
                     readonly describe: "Path to custom GitHub repository from which to create project template";
@@ -2593,8 +2595,13 @@ export declare const lib: {
     readonly LocalDevProcess: {
         readonly projectConfigMismatch: `Unable to upload project. The project config has been modified since starting ${string}.`;
         readonly uploadInitiated: "Project upload initiated from Local Dev UI.";
+        readonly deployInitiated: "Project deploy initiated from Local Dev UI.";
         readonly uploadFailed: "Project upload failed. To proceed with local development, fix any necessary errors, then re-upload your project.";
+        readonly deployFailed: "Project deploy failed. To proceed with local development, fix any necessary errors, then re-deploy your project.";
         readonly uploadSuccess: "Project upload completed successfully. Resuming local dev...";
+        readonly uploadSuccessAutoDeployDisabled: "Project upload completed successfully, but auto-deploy is disabled for this project. Deploy your latest build to proceed with local development.";
+        readonly deploySuccess: "Project deploy completed successfully. Resuming local dev...";
+        readonly noBuildToDeploy: "Error deploying project. No build was found to deploy.";
     };
     readonly localDevHelpers: {
         readonly project: {
@@ -3113,6 +3120,7 @@ Run ${string} to upgrade to version ${string}`;
         };
         readonly projectAddPrompt: {
             readonly selectType: "[--type] Select an app feature to add: ";
+            readonly selectFeatures: "[--features] Select an app feature to add: ";
             readonly enterName: "[--name] Give your component a name: ";
             readonly errors: {
                 readonly nameRequired: "A component name is required";

package/lang/en.js

@@ -19,6 +19,7 @@ export const commands = {
         },
     },
     getStarted: {
+        describe: 'A step-by-step command to get you started with a HubSpot project.',
         options: {
             dest: {
                 describe: 'Directory where the project should be created',
@@ -863,8 +864,9 @@ export const commands = {
         tailLogs: (functionPath, accountId) => `Waiting for log entries for "${functionPath}" on account "${accountId}".\n`,
     },
     mcp: {
-        describe: 'Commands for managing HubSpot MCP servers',
+        describe: 'Commands for managing HubSpot MCP servers.',
         setup: {
+            describe: 'Setup the HubSpot development MCP servers.',
             installingDocSearch: 'Adding the docs-search mcp server',
             claudeCode: 'Claude Code',
             cursor: 'Cursor',
@@ -1011,10 +1013,10 @@ export const commands = {
         dev: {
             describe: 'Start local dev for the current project.',
             logs: {
-                betaMessage: 'HubSpot projects local development',
+                header: 'HubSpot projects local development',
                 placeholderAccountSelection: 'Using default account as target account (for now)',
                 accountTypeInformation: 'Testing in a developer test account is strongly recommended, but you can use a sandbox account if your plan allows you to create one.',
-                learnMoreMessageV3: `Learn more about ${uiLink('HubSpot projects local dev', 'https://hubspot.mintlify.io/en-us/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server')} | ${uiLink('HubSpot account types', 'https://developers.hubspot.com/docs/getting-started/account-types')}`,
+                learnMoreMessageV3: `Learn more about ${uiLink('HubSpot projects local dev', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server')} | ${uiLink('HubSpot account types', 'https://developers.hubspot.com/docs/getting-started/account-types')}`,
                 learnMoreMessageLegacy: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/platform/project-cli-commands#start-a-local-development-server'),
                 profileProjectAccountExplanation: (accountId, profileName) => `Using account ${uiAccountDescription(accountId)} from profile ${chalk.bold(profileName)} for project upload`,
                 defaultProjectAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for project upload`,
@@ -1071,7 +1073,7 @@ export const commands = {
                     describe: 'Project name (cannot be changed)',
                 },
                 template: {
-                    describe: 'The starting template',
+                    describe: 'The starting template.  Only applies when platform version is less than 2025.2.',
                 },
                 templateSource: {
                     describe: 'Path to custom GitHub repository from which to create project template',
@@ -1195,7 +1197,7 @@ export const commands = {
                 maxExceeded: (maxCount) => `This project has the maximum allowed(${maxCount})`,
                 authTypeNotAllowed: (authType) => `Auth type '${authType}' not allowed.`,
                 distributionNotAllowed: (dist) => `Distribution '${dist}' not allowed.`,
-                portalDoesNotHaveAccessToThisFeature: (accountId) => `The account ${uiAccountDescription(accountId)} does not have access to this feature`,
+                portalDoesNotHaveAccessToThisFeature: (accountId) => `The account ${uiAccountDescription(accountId)} does not have access to this feature.`,
                 locationInProject: 'This command must be run from within a project directory.',
                 failedToFetchComponentList: 'Failed to fetch the list of available features. Please try again later.',
                 projectContainsPublicApp: 'This project contains a public app. This command is currently only compatible with projects that contain private apps.',
@@ -2591,8 +2593,13 @@ export const lib = {
     LocalDevProcess: {
         projectConfigMismatch: `Unable to upload project. The project config has been modified since starting ${uiCommandReference('hs project dev')}.`,
         uploadInitiated: 'Project upload initiated from Local Dev UI.',
+        deployInitiated: 'Project deploy initiated from Local Dev UI.',
         uploadFailed: 'Project upload failed. To proceed with local development, fix any necessary errors, then re-upload your project.',
+        deployFailed: 'Project deploy failed. To proceed with local development, fix any necessary errors, then re-deploy your project.',
         uploadSuccess: 'Project upload completed successfully. Resuming local dev...',
+        uploadSuccessAutoDeployDisabled: 'Project upload completed successfully, but auto-deploy is disabled for this project. Deploy your latest build to proceed with local development.',
+        deploySuccess: 'Project deploy completed successfully. Resuming local dev...',
+        noBuildToDeploy: 'Error deploying project. No build was found to deploy.',
     },
     localDevHelpers: {
         project: {
@@ -3108,6 +3115,7 @@ export const lib = {
         },
         projectAddPrompt: {
             selectType: '[--type] Select an app feature to add: ',
+            selectFeatures: '[--features] Select an app feature to add: ',
             enterName: '[--name] Give your component a name: ',
             errors: {
                 nameRequired: 'A component name is required',

package/lib/constants.d.ts

@@ -84,17 +84,22 @@ export declare const FEATURES: {
     readonly APPS_HOME: "UIE:AppHome";
     readonly MCP_ACCESS: "Developers:CLIMCPAccess";
     readonly THEME_MIGRATION_2025_2: "Developers:ProjectThemeMigrations:2025.2";
+    readonly AGENT_TOOLS: "ThirdPartyAgentTools";
 };
 export declare const LOCAL_DEV_UI_MESSAGE_SEND_TYPES: {
     UPLOAD_SUCCESS: string;
     UPLOAD_FAILURE: string;
+    DEPLOY_SUCCESS: string;
+    DEPLOY_FAILURE: string;
     UPDATE_PROJECT_NODES: string;
     UPDATE_APP_DATA: string;
     UPDATE_PROJECT_DATA: string;
     UPDATE_UPLOAD_WARNINGS: string;
+    CLI_METADATA: string;
 };
 export declare const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES: {
     UPLOAD: string;
+    DEPLOY: string;
     VIEWED_WELCOME_SCREEN: string;
 };
 export declare const APP_INSTALLATION_STATES: {

package/lib/constants.js

@@ -76,17 +76,22 @@ export const FEATURES = {
     APPS_HOME: 'UIE:AppHome',
     MCP_ACCESS: 'Developers:CLIMCPAccess',
     THEME_MIGRATION_2025_2: 'Developers:ProjectThemeMigrations:2025.2',
+    AGENT_TOOLS: 'ThirdPartyAgentTools',
 };
 export const LOCAL_DEV_UI_MESSAGE_SEND_TYPES = {
     UPLOAD_SUCCESS: 'server:uploadSuccess',
     UPLOAD_FAILURE: 'server:uploadFailure',
+    DEPLOY_SUCCESS: 'server:deploySuccess',
+    DEPLOY_FAILURE: 'server:deployFailure',
     UPDATE_PROJECT_NODES: 'server:updateProjectNodes',
     UPDATE_APP_DATA: 'server:updateAppData',
     UPDATE_PROJECT_DATA: 'server:updateProjectData',
     UPDATE_UPLOAD_WARNINGS: 'server:updateUploadWarnings',
+    CLI_METADATA: 'server:cliMetadata',
 };
 export const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES = {
     UPLOAD: 'client:upload',
+    DEPLOY: 'client:deploy',
     VIEWED_WELCOME_SCREEN: 'client:viewedWelcomeScreen',
 };
 export const APP_INSTALLATION_STATES = {

package/lib/mcp/setup.js

@@ -8,7 +8,7 @@ import path from 'path';
 import os from 'os';
 import fs from 'fs-extra';
 import { existsSync } from 'fs';
-const mcpServerName = 'HubSpot';
+const mcpServerName = 'HubSpotDev';
 const claudeCode = 'claude';
 const windsurf = 'windsurf';
 const cursor = 'cursor';

package/lib/middleware/fireAlarmMiddleware.js

@@ -3,6 +3,8 @@ import { fetchFireAlarms } from '@hubspot/local-dev-lib/api/fireAlarm';
 import { debugError } from '../errorHandlers/index.js';
 import pkg from '../../package.json' with { type: 'json' };
 import { logInBox } from '../ui/boxen.js';
+import { renderInline } from '../../ui/index.js';
+import { getWarningBox } from '../../ui/components/StatusMessageBoxes.js';
 /*
  * Versions can be formatted like this:
  * =7.2.2 -> targets the exact version 7.2.2
@@ -98,12 +100,20 @@ async function logFireAlarms(accountId, command, version) {
             }
             return acc;
         }, '');
-        await logInBox({
-            contents: notifications,
-            options: {
+        if (!process.env.HUBSPOT_ENABLE_INK) {
+            await logInBox({
+                contents: notifications,
+                options: {
+                    title: 'Notifications',
+                },
+            });
+        }
+        else {
+            await renderInline(getWarningBox({
                 title: 'Notifications',
-            },
-        });
+                message: notifications,
+            }));
+        }
     }
 }
 export async function checkFireAlarms(argv) {