@hubspot/cli 7.7.16-experimental.0 → 7.7.16-experimental.1

package/lang/en.js

@@ -22,6 +22,51 @@ exports.commands = {
             configFileExists: (configPath) => `A configuration file already exists at ${configPath}. To specify a new configuration file, delete the existing one and try again.`,
         },
     },
+    getStarted: {
+        options: {
+            dest: {
+                describe: 'Directory where the project should be created',
+            },
+            name: {
+                describe: 'Project name (cannot be changed)',
+            },
+            templateSource: {
+                describe: 'Path to custom GitHub repository from which to create project template',
+            },
+        },
+        startTitle: 'Welcome to HubSpot Development!',
+        verboseDescribe: 'A step-by-step command to get you started with a HubSpot project.',
+        startDescription: 'You can use the HubSpot CLI to build apps, CMS themes, and more.',
+        designManager: 'To onboard with CMS, please visit the HubSpot Design Manager in your account and follow the checklist items.',
+        openDesignManager: 'Click here to go to the HubSpot Design Manager',
+        openDesignManagerPrompt: 'Open Design Manager in your browser?',
+        openedDesignManager: 'Redirected to Design Manager!',
+        developerOverviewBrowserOpenPrep: "We'll take you to your HubSpot account and walk you through installing and previewing your new app.",
+        openDeveloperOverviewPrompt: 'Open HubSpot to go to your account?',
+        openedDeveloperOverview: 'HubSpot opened!',
+        prompts: {
+            selectOption: 'Are you looking to build apps or CMS?',
+            options: {
+                app: 'App',
+                cms: 'CMS',
+            },
+            uploadProject: 'Would you like to upload your project to HubSpot now?',
+            appSelected: `We'll create a new project with a sample app for you.\nProjects are what you can use to create apps, themes, and more at HubSpot.\nUsually you'll use the ${(0, ui_1.uiCommandReference)('hs project create')} command, but we'll go ahead and make one now.`,
+            projectCreated: {
+                title: chalk_1.default.bold('Next steps:'),
+                description: `Upload your project to HubSpot - typically, you'll use the command ${(0, ui_1.uiCommandReference)('hs project upload')} for this.\nWe'll start the process now.`,
+            },
+        },
+        logs: {
+            uploadingProject: 'Uploading your project to HubSpot...',
+            uploadSuccess: 'Project uploaded successfully!',
+            developerOverviewLink: 'Open this link to navigate to your HubSpot developer portal',
+        },
+        errors: {
+            uploadFailed: 'Failed to upload project to HubSpot.',
+            configFileNotFound: 'Could not find project configuration for upload.',
+        },
+    },
     completion: {
         describe: 'Enable bash completion shortcuts for commands. Concat the generated script to your .bashrc, .bash_profile, or .zshrc file.',
         examples: {
@@ -788,7 +833,7 @@ exports.commands = {
                 client: 'Target applications to configure',
                 docsSearch: 'Should the docs search mcp server be installed',
             },
-            success: (derivedTargets) => `You can now use the HubSpot CLI tools in ${derivedTargets.join(', ')}.  ${chalk_1.default.bold('You may need to restart these tools to apply the changes')}.`,
+            success: (derivedTargets) => `You can now use the HubSpot CLI MCP Server in ${derivedTargets.join(', ')}.  ${chalk_1.default.bold('You may need to restart these tools to apply the changes')}.`,
             errors: {
                 needsNode20: `This feature requires node >=20`,
             },
@@ -802,13 +847,11 @@ exports.commands = {
                 claudeCodeInstallFailed: 'Claude Code CLI not working - skipping configuration',
                 failedToConfigureClaudeDesktop: 'Failed to configure Claude Desktop',
                 configuringCursor: 'Configuring Cursor...',
-                noCursorMcpFile: (configFile) => `No ${configFile} file found - skipping Cursor configuration`,
                 failedToConfigureCursor: 'Failed to configure Cursor',
                 configuredCursor: 'Configured Cursor',
                 alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
-                configuringWindsurf: 'Configuring Cursor...',
-                noWindsurfFile: (configFile) => `No ${configFile} file found - skipping Windsurf configuration`,
-                failedToConfigureWindsurf: 'Failed to configure Cursor',
+                configuringWindsurf: 'Configuring Windsurf...',
+                failedToConfigureWindsurf: 'Failed to configure Windsurf',
                 configuredWindsurf: 'Configured Windsurf',
             },
             prompts: {
@@ -1322,6 +1365,20 @@ exports.commands = {
             noPackageJsonInProject: (projectName, link) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${link}`,
             packageManagerNotInstalled: (packageManager, link) => `This command depends on ${packageManager}, install ${chalk_1.default.bold(link)}`,
         },
+        validate: {
+            describe: 'Validate the project before uploading',
+            mustBeRanWithinAProject: 'This command must be run from within a project directory.',
+            badVersion: 'This command is only available for projects 2025.2 and later.',
+            examples: {
+                default: 'Validate the project before uploading',
+            },
+            success: (projectName) => `Project ${projectName} is valid and ready to upload`,
+            options: {
+                profile: {
+                    describe: 'The profile to target for this validation',
+                },
+            },
+        },
     },
     remove: {
         describe: 'Delete a file or folder from the HubSpot CMS.',
@@ -1726,6 +1783,62 @@ exports.commands = {
             missingSrc: 'Please specify the path to your javascript fields file or directory with the --src flag.',
         },
     },
+    testAccount: {
+        describe: 'Commands for working with test accounts.',
+        create: {
+            describe: 'Create a test account from a config file',
+            configPathPrompt: '[--config-path] Enter the path to the test account config: ',
+            createTestAccountFromConfigPrompt: 'How would you like to create your test account?',
+            createFromConfigOption: 'Create test account from config file',
+            createFromScratchOption: 'Create test account from scratch',
+            errors: {
+                configFileNotFound: (configPath) => `No test account config file exists at ${configPath}. Create a test account config file with the ${(0, ui_1.uiCommandReference)('hs test-account create-config')} command.`,
+                configFileParseFailed: (configPath) => `Failed to parse test account config file at ${configPath}`,
+                failedToCreate: 'Failed to create test account',
+            },
+            success: {
+                configFileUpdated: (testAccountName, testAccountId) => `Test account "${testAccountName}" successfully created with id ${testAccountId}`,
+            },
+            options: {
+                configPath: 'The path to the test account config',
+            },
+            example: (configPath) => `Create a test account from the config file at ${configPath}`,
+        },
+        createConfig: {
+            describe: 'Create a test account config file.',
+            pathPrompt: '[--path] What is the path to the test account config?',
+            errors: {
+                pathError: 'Path is required',
+                pathFormatError: 'Path must end with .json',
+                failedToCreate: 'Failed to create test account config',
+                pathExistsError: 'A file already exists at this path. Please try again with a different path.',
+            },
+            success: {
+                configFileCreated: (path) => `Test account config successfully created at ${path}`,
+            },
+            options: {
+                name: 'The name of the test account',
+                description: 'The description of the test account',
+                tiers: 'The tiers of the test account',
+                path: 'The path to the test account config',
+            },
+            example: (name) => `Create a test account config file with the name "${name}"`,
+        },
+        delete: {
+            describe: 'Delete a test account config file.',
+            pathPrompt: '[--path] What is the path to the test account config?',
+            errors: {
+                failedToDelete: 'Failed to delete test account',
+            },
+            success: {
+                testAccountDeleted: (testAccountId) => `Test account with id ${testAccountId} successfully deleted`,
+            },
+            positionals: {
+                testAccountId: 'The id of the test account',
+            },
+            example: (testAccountId) => `Delete a test account with the id "${testAccountId}"`,
+        },
+    },
     secrets: {
         add: {
             loading: {
@@ -2320,7 +2433,6 @@ exports.lib = {
         noCompatibleComponents: (serverKey) => `Skipping call to ${serverKey} because there are no compatible components in the project.`,
     },
     LocalDevManager: {
-        staticAuthAccountsMustMatch: 'You must test static auth apps in the account the project exists in',
         appNotFound: (accountId, appUid) => `Unable to find app with uid ${appUid} in account ${(0, ui_1.uiAccountDescription)(accountId)}`,
         failedToInitialize: 'Missing required arguments to initialize Local Dev',
         noDeployedBuild: (projectName, accountIdentifier, uploadCommand) => `Your project ${chalk_1.default.bold(projectName)} exists in ${accountIdentifier}, but has no deployed build. Projects must be successfully deployed to be developed locally. Address any build and deploy errors your project may have, then run ${uploadCommand} to upload and deploy your project.`,
@@ -2365,6 +2477,9 @@ exports.lib = {
     },
     AppDevModeInterface: {
         defaultMarketplaceAppWarning: (installCount) => `\n\nYour marketplace app is currently installed in ${chalk_1.default.bold(`${installCount} ${installCount === 1 ? 'account' : 'accounts'}`)}. Any uploaded changes will impact your app's users. We strongly recommend creating a copy of this app to test your changes before proceding.`,
+        autoInstallDeclined: 'You must install your app on your target test account to proceed with local development.',
+        autoInstallSuccess: (appName, targetTestAccountId) => `Successfully installed app ${appName} on account ${(0, ui_1.uiAccountDescription)(targetTestAccountId)}\n`,
+        autoInstallError: (appName, targetTestAccountId) => `Error installing app ${appName} on account ${(0, ui_1.uiAccountDescription)(targetTestAccountId)}. You may still be able to install your app in your browser.`,
     },
     LocalDevWebsocketServer: {
         errors: {
@@ -2513,8 +2628,8 @@ exports.lib = {
         pollProjectBuildAndDeploy: {
             buildSucceededAutomaticallyDeploying: (buildId, accountIdentifier) => `Build #${buildId} succeeded. ${chalk_1.default.bold('Automatically deploying')} to ${accountIdentifier}\n`,
             cleanedUpTempFile: (path) => `Cleaned up temporary file ${path}`,
-            viewDeploys: 'View all deploys for this project in HubSpot',
-            unableToFindAutodeployStatus: (buildId, viewDeploysLink) => `Unable to find the auto deploy for build #${buildId}. This deploy may have been skipped. ${viewDeploysLink}.`,
+            viewDeploys: 'view all deploys for this project in HubSpot',
+            unableToFindAutodeployStatus: (buildId, viewDeploysLink) => `Unable to find the auto deploy for build #${buildId}. This deploy may have been skipped or blocked due to components being removed. Manually deploy with ${(0, ui_1.uiCommandReference)('hs project deploy')} or ${viewDeploysLink}.`,
         },
     },
     projectUpload: {
@@ -2594,7 +2709,7 @@ exports.lib = {
                 },
                 projectDevCommand: {
                     command: 'hs project dev',
-                    message: (command) => `Run ${command} to set up your test environment and start local development`,
+                    message: (command) => `Run ${command} from within your project directory to set up your test environment and start local development`,
                 },
                 projectInstallDepsCommand: {
                     command: 'hs project install-deps',
@@ -2650,31 +2765,18 @@ exports.lib = {
     },
     commonOpts: {
         options: {
-            account: {
-                describe: 'HubSpot account id or name from config',
-            },
-            config: {
-                describe: 'Path to a config file',
-            },
-            overwrite: {
-                describe: 'Overwrite existing files',
-            },
+            account: 'HubSpot account id or name from config',
+            config: 'Path to a config file',
+            overwrite: 'Overwrite existing files',
             modes: {
-                describe: {
-                    default: (modes) => `${modes}`,
-                    read: (modes) => `Read from ${modes}`,
-                    write: (modes) => `Write to ${modes}`,
-                },
-            },
-            qa: {
-                describe: 'Run command in QA mode',
-            },
-            useEnv: {
-                describe: 'Use environment variable config',
-            },
-            debug: {
-                describe: 'Set log level to debug',
+                default: (modes) => `${modes}`,
+                read: (modes) => `Read from ${modes}`,
+                write: (modes) => `Write to ${modes}`,
             },
+            qa: 'Run command in QA mode',
+            useEnv: 'Use environment variable config',
+            jsonOutput: 'Format output as JSON',
+            debug: 'Set log level to debug',
         },
     },
     configMigrate: {
@@ -2716,6 +2818,14 @@ exports.lib = {
             setAsDefaultAccount: (accountName) => `Account "${accountName}" set as the default account`,
             keepingCurrentDefault: (accountName) => `Account "${accountName}" will continue to be the default account`,
         },
+        createDeveloperTestAccountConfigPrompt: {
+            namePrompt: '[--name] What is the name of the test account?',
+            descriptionPrompt: '[--description] What is the description of the test account?',
+            tiersPrompt: '[--tiers] Which product tiers should the test account have?',
+            errors: {
+                tiersError: 'Cannot have more than one tier per hub',
+            },
+        },
         accountNamePrompt: {
             enterAccountName: 'Enter a unique name to reference this account in the CLI:',
             enterDeveloperTestAccountName: 'Name your developer test account:',
@@ -2888,6 +2998,7 @@ exports.lib = {
             explanation: 'Local development requires this app to be installed in the target test account',
             reinstallExplanation: "This app's required scopes have been updated since it was last installed on the target test account. To avoid issues with local development, we recommend reinstalling the app with the updated scopes.",
             prompt: 'Open HubSpot to install this app?',
+            autoPrompt: 'Install this app in your target test account?',
             reinstallPrompt: 'Open HubSpot to reinstall this app?',
             decline: `To continue local development of this app, install it in your target test account and re-run ${chalk_1.default.bold('`hs project dev`')}`,
         },

package/lang/en.lyaml

@@ -694,6 +694,7 @@ en:
             buildIdDoesNotExist: "Build {{ buildId }} does not exist for project {{ projectName }}. {{ linkToProject }}"
             buildAlreadyDeployed: "Build {{ buildId }} is already deployed. {{ linkToProject}}"
             viewProjectsBuilds: 'View project builds in HubSpot'
+            deployContainsRemovals: "- This deploy would remove the {{#bold}}{{ componentName }}{{/bold}} component. To proceed, run the deploy command with the {{ forceFlag }} flag"
           examples:
             default: "Deploy the latest build of the current project"
             withOptions: "Deploy build 5 of the project my-project"
@@ -704,6 +705,8 @@ en:
               describe: "Project name"
             profile:
               describe: "The profile to target with this deploy"
+            force:
+              describe: "Skip warnings and force deploy. Use this carefully as it will bypass warnings for destructive actions."
         listBuilds:
           describe: "List the project's builds."
           continueOrExitPrompt: "Press <enter> to load more, or ctrl+c to exit"
@@ -1049,19 +1052,6 @@ en:
       logFeedbackMessage:
         feedbackHeader: "We'd love to hear your feedback!"
         feedbackMessage: "How are you liking the new projects and developer tools? \n > Run `{{#yellow}}hs feedback{{/yellow}}` to let us know what you think!\n"
-    projectBuildAndDeploy:
-      makePollTaskStatusFunc:
-        componentCountSingular: "Found 1 component in this project"
-        componentCount: "Found {{ numComponents }} components in this project"
-        successStatusText: "DONE"
-        failedStatusText: "FAILED"
-        errorFetchingTaskStatus: "An error occurred while fetching the status of the current {{ taskType }}. For more information, view this project in HubSpot by running {{ openCommand }}."
-      pollBuildAutodeployStatusError: "Error fetching autodeploy status for build #{{ buildId }}"
-      pollProjectBuildAndDeploy:
-        buildSucceededAutomaticallyDeploying: "Build #{{ buildId }} succeeded. {{#bold}}Automatically deploying{{/bold}} to {{ accountIdentifier }}\n"
-        cleanedUpTempFile: "Cleaned up temporary file {{ path }}"
-        viewDeploys: "View all deploys for this project in HubSpot"
-        unableToFindAutodeployStatus: "Unable to find the auto deploy for build #{{ buildId }}. This deploy may have been skipped. {{ viewDeploysLink }}."
     projectUpload:
       uploadProjectFiles:
         add: "Uploading {{#bold}}{{ projectName }}{{/bold}} project files to {{ accountIdentifier }}"
@@ -1107,6 +1097,9 @@ en:
           feedbackCommand:
             command: "hs feedback"
             message: "Run {{ command }} to report a bug or leave feedback"
+          getStartedCommand:
+            command: "hs get-started"
+            message: "Run {{ command }} to get started with HubSpot development"
           helpCommand:
             command: "hs help"
             message: "Run {{ command }} to see a list of available commands"
@@ -1124,7 +1117,7 @@ en:
             message: "Run {{ command }} to upload your project to your HubSpot account"
           projectDevCommand:
             command: "hs project dev"
-            message: "Run {{ command }} to set up your test environment and start local development"
+            message: "Run {{ command }} from within your project directory to set up your test environment and start local development"
           projectInstallDepsCommand:
             command: "hs project install-deps"
             message: "Run {{ command }} to install dependencies for your project components"
@@ -1165,6 +1158,8 @@ en:
           describe: "Use environment variable config"
         debug:
           describe: "Set log level to debug"
+        jsonOutput:
+          describe: "Format output as JSON"
     prompts:
       projectDevTargetAccountPrompt:
         createNewSandboxOption: "<Test on a new development sandbox>"

package/lib/app/migrate.js

@@ -236,9 +236,21 @@ async function beginMigration(derivedAccountId, appId, platformVersion) {
     if (Object.values(componentsRequiringUids).length !== 0) {
         for (const [componentId, component] of Object.entries(componentsRequiringUids)) {
             const { componentHint, componentType } = component;
-            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)(en_1.lib.migrate.prompt.uidForComponent(componentHint
-                ? `${(0, transform_1.mapToUserFacingType)(componentType)} '${componentHint}'`
-                : (0, transform_1.mapToUserFacingType)(componentType)), {
+            // Extract the internal ID from the base64-encoded ComponentExternalId
+            let internalId;
+            try {
+                const decoded = Buffer.from(componentId, 'base64').toString('utf8');
+                const parts = decoded.split('$$');
+                internalId = parts[1] || componentId;
+            }
+            catch {
+                // If decoding fails, use the componentId as the internalId
+                internalId = componentId;
+            }
+            const promptText = componentHint
+                ? `${(0, transform_1.mapToUserFacingType)(componentType)} '${componentHint}' (ID: ${internalId})`
+                : `${(0, transform_1.mapToUserFacingType)(componentType)} (ID: ${internalId})`;
+            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)(en_1.lib.migrate.prompt.uidForComponent(promptText), {
                 validate: (uid) => {
                     const result = (0, project_parsing_lib_1.validateUid)(uid);
                     return result === undefined ? true : result;

package/lib/commonOpts.d.ts

@@ -11,10 +11,12 @@ export declare function addCmsPublishModeOptions(yargs: Argv, { read, write }: {
 }): Argv;
 export declare function addTestingOptions(yargs: Argv): Argv;
 export declare function addUseEnvironmentOptions(yargs: Argv): Argv;
+export declare function addJSONOutputOptions(yargs: Argv): Argv;
 export declare function addCustomHelpOutput(yargs: Argv, command: string | string[], describe?: string): Promise<void>;
 export declare function setLogLevel(options: Arguments<{
     debug?: boolean;
     networkDebug?: boolean;
+    json?: boolean;
 }>): void;
 export declare function getCommandName(argv: Arguments): string;
 export declare function getCmsPublishMode(options: Arguments<{

package/lib/commonOpts.js

@@ -10,6 +10,7 @@ exports.addOverwriteOptions = addOverwriteOptions;
 exports.addCmsPublishModeOptions = addCmsPublishModeOptions;
 exports.addTestingOptions = addTestingOptions;
 exports.addUseEnvironmentOptions = addUseEnvironmentOptions;
+exports.addJSONOutputOptions = addJSONOutputOptions;
 exports.addCustomHelpOutput = addCustomHelpOutput;
 exports.setLogLevel = setLogLevel;
 exports.getCommandName = getCommandName;
@@ -19,16 +20,16 @@ const yargs_parser_1 = __importDefault(require("yargs-parser"));
 const logger_1 = require("@hubspot/local-dev-lib/logger");
 const files_1 = require("@hubspot/local-dev-lib/constants/files");
 const config_1 = require("@hubspot/local-dev-lib/config");
-const lang_1 = require("./lang");
 const errorHandlers_1 = require("./errorHandlers");
 const exitCodes_1 = require("./enums/exitCodes");
 const ui_1 = require("./ui");
+const lang_1 = require("./lang");
 function addGlobalOptions(yargs) {
     yargs.version(false);
     yargs.option('debug', {
         alias: 'd',
         default: false,
-        describe: (0, lang_1.i18n)(`lib.commonOpts.options.debug.describe`),
+        describe: (0, lang_1.i18n)('lib.commonOpts.options.debug.describe'),
         type: 'boolean',
     });
     yargs.option('network-debug', {
@@ -41,21 +42,21 @@ function addGlobalOptions(yargs) {
 function addAccountOptions(yargs) {
     return yargs.option('account', {
         alias: 'a',
-        describe: (0, lang_1.i18n)(`lib.commonOpts.options.account.describe`),
+        describe: (0, lang_1.i18n)('lib.commonOpts.options.account.describe'),
         type: 'string',
     });
 }
 function addConfigOptions(yargs) {
     return yargs.option('config', {
         alias: 'c',
-        describe: (0, lang_1.i18n)(`lib.commonOpts.options.config.describe`),
+        describe: (0, lang_1.i18n)('lib.commonOpts.options.config.describe'),
         type: 'string',
     });
 }
 function addOverwriteOptions(yargs) {
     return yargs.option('overwrite', {
         alias: 'o',
-        describe: (0, lang_1.i18n)(`lib.commonOpts.options.overwrite.describe`),
+        describe: (0, lang_1.i18n)('lib.commonOpts.options.overwrite.describe'),
         type: 'boolean',
         default: false,
     });
@@ -70,7 +71,7 @@ function addCmsPublishModeOptions(yargs, { read, write }) {
 }
 function addTestingOptions(yargs) {
     return yargs.option('qa', {
-        describe: (0, lang_1.i18n)(`lib.commonOpts.options.qa.describe`),
+        describe: (0, lang_1.i18n)('lib.commonOpts.options.qa.describe'),
         type: 'boolean',
         default: false,
         hidden: true,
@@ -78,12 +79,20 @@ function addTestingOptions(yargs) {
 }
 function addUseEnvironmentOptions(yargs) {
     yargs.option('use-env', {
-        describe: (0, lang_1.i18n)(`lib.commonOpts.options.useEnv.describe`),
+        describe: (0, lang_1.i18n)('lib.commonOpts.options.useEnv.describe'),
         type: 'boolean',
     });
     yargs.conflicts('use-env', 'account');
     return yargs;
 }
+function addJSONOutputOptions(yargs) {
+    return yargs.option('json', {
+        alias: 'format-output-as-json',
+        describe: (0, lang_1.i18n)('lib.commonOpts.options.jsonOutput.describe'),
+        type: 'boolean',
+        hidden: true,
+    });
+}
 async function addCustomHelpOutput(yargs, command, describe) {
     try {
         const parsedArgv = (0, yargs_parser_1.default)(process.argv.slice(2));
@@ -125,8 +134,11 @@ async function addCustomHelpOutput(yargs, command, describe) {
     }
 }
 function setLogLevel(options) {
-    const { debug, networkDebug } = options;
-    if (debug) {
+    const { debug, networkDebug, json } = options;
+    if (json) {
+        (0, logger_1.setLogLevel)(logger_1.LOG_LEVEL.NONE);
+    }
+    else if (debug) {
         (0, logger_1.setLogLevel)(logger_1.LOG_LEVEL.DEBUG);
     }
     else {

package/lib/constants.d.ts

@@ -49,6 +49,7 @@ export declare const PROJECT_ERROR_TYPES: {
     readonly BUILD_NOT_IN_PROGRESS: "BuildPipelineErrorType.BUILD_NOT_IN_PROGRESS";
     readonly SUBBUILD_FAILED: "BuildPipelineErrorType.DEPENDENT_SUBBUILD_FAILED";
     readonly SUBDEPLOY_FAILED: "DeployPipelineErrorType.DEPENDENT_SUBDEPLOY_FAILED";
+    readonly DEPLOY_CONTAINS_REMOVALS: "DeployPipelineErrorType.WARNING_DEPLOY_CONTAINS_REMOVALS";
 };
 export declare const PROJECT_TASK_TYPES: {
     [key: string]: string;
@@ -98,6 +99,10 @@ export declare const oAuth = "oauth";
 export declare const privateDistribution = "private";
 export declare const marketplaceDistribution = "marketplace";
 export declare const appComponent = "app";
+export declare const GET_STARTED_OPTIONS: {
+    readonly APP: "APP";
+    readonly CMS: "CMS";
+};
 export declare const LOCAL_DEV_SERVER_MESSAGE_TYPES: {
     readonly INITIAL: "INITIAL";
     readonly WEBSOCKET_SERVER_CONNECTED: "WEBSOCKET_SERVER_CONNECTED";

package/lib/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOCAL_DEV_SERVER_MESSAGE_TYPES = exports.appComponent = exports.marketplaceDistribution = exports.privateDistribution = exports.oAuth = exports.staticAuth = exports.APP_INSTALLATION_STATES = exports.LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES = exports.LOCAL_DEV_UI_MESSAGE_SEND_TYPES = exports.FEATURES = exports.APP_AUTH_TYPES = exports.APP_DISTRIBUTION_TYPES = exports.IR_COMPONENT_TYPES = exports.PLATFORM_VERSION_ERROR_TYPES = exports.PROJECT_COMPONENT_TYPES = exports.PROJECT_TASK_TYPES = exports.PROJECT_ERROR_TYPES = exports.PROJECT_DEPLOY_TEXT = exports.PROJECT_BUILD_TEXT = exports.PROJECT_DEPLOY_STATES = exports.PROJECT_BUILD_STATES = exports.PROJECT_CONFIG_FILE = exports.DEFAULT_POLLING_DELAY = exports.MARKETPLACE_FOLDER = exports.HUBSPOT_FOLDER = exports.FEEDBACK_INTERVAL = exports.DEFAULT_PROJECT_TEMPLATE_BRANCH = exports.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH = void 0;
+exports.LOCAL_DEV_SERVER_MESSAGE_TYPES = exports.GET_STARTED_OPTIONS = exports.appComponent = exports.marketplaceDistribution = exports.privateDistribution = exports.oAuth = exports.staticAuth = exports.APP_INSTALLATION_STATES = exports.LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES = exports.LOCAL_DEV_UI_MESSAGE_SEND_TYPES = exports.FEATURES = exports.APP_AUTH_TYPES = exports.APP_DISTRIBUTION_TYPES = exports.IR_COMPONENT_TYPES = exports.PLATFORM_VERSION_ERROR_TYPES = exports.PROJECT_COMPONENT_TYPES = exports.PROJECT_TASK_TYPES = exports.PROJECT_ERROR_TYPES = exports.PROJECT_DEPLOY_TEXT = exports.PROJECT_BUILD_TEXT = exports.PROJECT_DEPLOY_STATES = exports.PROJECT_BUILD_STATES = exports.PROJECT_CONFIG_FILE = exports.DEFAULT_POLLING_DELAY = exports.MARKETPLACE_FOLDER = exports.HUBSPOT_FOLDER = exports.FEEDBACK_INTERVAL = exports.DEFAULT_PROJECT_TEMPLATE_BRANCH = exports.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH = void 0;
 exports.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH = 'HubSpot/hubspot-project-components';
 exports.DEFAULT_PROJECT_TEMPLATE_BRANCH = 'main';
 exports.FEEDBACK_INTERVAL = 10;
@@ -41,6 +41,7 @@ exports.PROJECT_ERROR_TYPES = {
     BUILD_NOT_IN_PROGRESS: 'BuildPipelineErrorType.BUILD_NOT_IN_PROGRESS',
     SUBBUILD_FAILED: 'BuildPipelineErrorType.DEPENDENT_SUBBUILD_FAILED',
     SUBDEPLOY_FAILED: 'DeployPipelineErrorType.DEPENDENT_SUBDEPLOY_FAILED',
+    DEPLOY_CONTAINS_REMOVALS: 'DeployPipelineErrorType.WARNING_DEPLOY_CONTAINS_REMOVALS',
 };
 exports.PROJECT_TASK_TYPES = {
     PRIVATE_APP: 'private app',
@@ -93,6 +94,10 @@ exports.oAuth = 'oauth';
 exports.privateDistribution = 'private';
 exports.marketplaceDistribution = 'marketplace';
 exports.appComponent = 'app';
+exports.GET_STARTED_OPTIONS = {
+    APP: 'APP',
+    CMS: 'CMS',
+};
 exports.LOCAL_DEV_SERVER_MESSAGE_TYPES = {
     INITIAL: 'INITIAL',
     WEBSOCKET_SERVER_CONNECTED: 'WEBSOCKET_SERVER_CONNECTED',

package/lib/doctor/Doctor.js

@@ -262,7 +262,7 @@ class Doctor {
             this.diagnosis?.addCliSection({
                 type: 'success',
                 message: i18n(`lib.doctor.hsChecks.latest`, {
-                    hsVersion: latestCLIVersion,
+                    hsVersion: package_json_1.default.version,
                 }),
             });
         }

package/lib/errorHandlers/index.js

@@ -15,6 +15,10 @@ const util_1 = __importDefault(require("util"));
 const ui_1 = require("../ui");
 function logError(error, context) {
     debugError(error, context);
+    if (isProjectValidationError(error)) {
+        logger_1.logger.error(error.message);
+        return;
+    }
     if ((0, suppressError_1.shouldSuppressError)(error, context)) {
         return;
     }
@@ -89,6 +93,9 @@ class ApiErrorContext {
     }
 }
 exports.ApiErrorContext = ApiErrorContext;
+function isProjectValidationError(error) {
+    return error instanceof Error && error.name === 'ProjectValidationError';
+}
 function isErrorWithMessageOrReason(error) {
     return (typeof error === 'object' &&
         error !== null &&

package/lib/mcp/setup.d.ts

@@ -8,5 +8,14 @@ export declare const supportedTools: ({
     name: "Windsurf";
     value: string;
 })[];
+interface McpCommand {
+    command: string;
+    args: string[];
+}
 export declare function addMintlifyMcpServer(installTargets: string[]): Promise<void>;
+export declare function setupMintlify(derivedTargets?: string[]): Promise<boolean>;
 export declare function addMcpServerToConfig(targets: string[] | undefined): Promise<string[]>;
+export declare function setupClaudeCode(mcpCommand?: McpCommand): Promise<boolean>;
+export declare function setupCursor(mcpCommand?: McpCommand): boolean;
+export declare function setupWindsurf(mcpCommand?: McpCommand): boolean;
+export {};