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

package/lang/en.d.ts

@@ -8,6 +8,54 @@ export declare const commands: {
             readonly configFileExists: (configPath: string) => string;
         };
     };
+    readonly getStarted: {
+        readonly options: {
+            readonly dest: {
+                readonly describe: "Directory where the project should be created";
+            };
+            readonly name: {
+                readonly describe: "Project name (cannot be changed)";
+            };
+            readonly templateSource: {
+                readonly describe: "Path to custom GitHub repository from which to create project template";
+            };
+        };
+        readonly startTitle: "Welcome to HubSpot Development!";
+        readonly verboseDescribe: "A step-by-step command to get you started with a HubSpot project.";
+        readonly startDescription: "You can use the HubSpot CLI to build apps, CMS themes, and more.";
+        readonly designManager: "To onboard with CMS, please visit the HubSpot Design Manager in your account and follow the checklist items.";
+        readonly openDesignManager: "Click here to go to the HubSpot Design Manager";
+        readonly openDesignManagerPrompt: "Open Design Manager in your browser?";
+        readonly openedDesignManager: "Redirected to Design Manager!";
+        readonly developerOverviewBrowserOpenPrep: "We'll take you to your HubSpot account and walk you through installing and previewing your new app.";
+        readonly openDeveloperOverviewPrompt: "Open HubSpot to go to your account?";
+        readonly openedDeveloperOverview: "HubSpot opened!";
+        readonly prompts: {
+            readonly selectOption: "Are you looking to build apps or CMS?";
+            readonly options: {
+                readonly app: "App";
+                readonly cms: "CMS";
+            };
+            readonly uploadProject: "Would you like to upload your project to HubSpot now?";
+            readonly appSelected: `We'll create a new project with a sample app for you.
+Projects are what you can use to create apps, themes, and more at HubSpot.
+Usually you'll use the ${string} command, but we'll go ahead and make one now.`;
+            readonly projectCreated: {
+                readonly title: string;
+                readonly description: `Upload your project to HubSpot - typically, you'll use the command ${string} for this.
+We'll start the process now.`;
+            };
+        };
+        readonly logs: {
+            readonly uploadingProject: "Uploading your project to HubSpot...";
+            readonly uploadSuccess: "Project uploaded successfully!";
+            readonly developerOverviewLink: "Open this link to navigate to your HubSpot developer portal";
+        };
+        readonly errors: {
+            readonly uploadFailed: "Failed to upload project to HubSpot.";
+            readonly configFileNotFound: "Could not find project configuration for upload.";
+        };
+    };
     readonly completion: {
         readonly describe: "Enable bash completion shortcuts for commands. Concat the generated script to your .bashrc, .bash_profile, or .zshrc file.";
         readonly examples: {
@@ -765,6 +813,7 @@ 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 setup: {
             readonly installingDocSearch: "Adding the docs-search mcp server";
             readonly claudeCode: "Claude Code";
@@ -789,13 +838,11 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
                 readonly claudeCodeInstallFailed: "Claude Code CLI not working - skipping configuration";
                 readonly failedToConfigureClaudeDesktop: "Failed to configure Claude Desktop";
                 readonly configuringCursor: "Configuring Cursor...";
-                readonly noCursorMcpFile: (configFile: string) => string;
                 readonly failedToConfigureCursor: "Failed to configure Cursor";
                 readonly configuredCursor: "Configured Cursor";
                 readonly alreadyInstalled: "HubSpot CLI mcp server already installed, reinstalling";
-                readonly configuringWindsurf: "Configuring Cursor...";
-                readonly noWindsurfFile: (configFile: string) => string;
-                readonly failedToConfigureWindsurf: "Failed to configure Cursor";
+                readonly configuringWindsurf: "Configuring Windsurf...";
+                readonly failedToConfigureWindsurf: "Failed to configure Windsurf";
                 readonly configuredWindsurf: "Configured Windsurf";
             };
             readonly prompts: {
@@ -1320,6 +1367,20 @@ ${string}`;
             readonly noPackageJsonInProject: (projectName: string, link: string) => string;
             readonly packageManagerNotInstalled: (packageManager: string, link: string) => string;
         };
+        readonly validate: {
+            readonly describe: "Validate the project before uploading";
+            readonly mustBeRanWithinAProject: "This command must be run from within a project directory.";
+            readonly badVersion: "This command is only available for projects 2025.2 and later.";
+            readonly examples: {
+                readonly default: "Validate the project before uploading";
+            };
+            readonly success: (projectName: string) => string;
+            readonly options: {
+                readonly profile: {
+                    readonly describe: "The profile to target for this validation";
+                };
+            };
+        };
     };
     readonly remove: {
         readonly describe: "Delete a file or folder from the HubSpot CMS.";
@@ -1724,6 +1785,62 @@ ${string}`;
             readonly missingSrc: "Please specify the path to your javascript fields file or directory with the --src flag.";
         };
     };
+    readonly testAccount: {
+        readonly describe: "Commands for working with test accounts.";
+        readonly create: {
+            readonly describe: "Create a test account from a config file";
+            readonly configPathPrompt: "[--config-path] Enter the path to the test account config: ";
+            readonly createTestAccountFromConfigPrompt: "How would you like to create your test account?";
+            readonly createFromConfigOption: "Create test account from config file";
+            readonly createFromScratchOption: "Create test account from scratch";
+            readonly errors: {
+                readonly configFileNotFound: (configPath: string) => string;
+                readonly configFileParseFailed: (configPath: string) => string;
+                readonly failedToCreate: "Failed to create test account";
+            };
+            readonly success: {
+                readonly configFileUpdated: (testAccountName: string, testAccountId: number) => string;
+            };
+            readonly options: {
+                readonly configPath: "The path to the test account config";
+            };
+            readonly example: (configPath: string) => string;
+        };
+        readonly createConfig: {
+            readonly describe: "Create a test account config file.";
+            readonly pathPrompt: "[--path] What is the path to the test account config?";
+            readonly errors: {
+                readonly pathError: "Path is required";
+                readonly pathFormatError: "Path must end with .json";
+                readonly failedToCreate: "Failed to create test account config";
+                readonly pathExistsError: "A file already exists at this path. Please try again with a different path.";
+            };
+            readonly success: {
+                readonly configFileCreated: (path: string) => string;
+            };
+            readonly options: {
+                readonly name: "The name of the test account";
+                readonly description: "The description of the test account";
+                readonly tiers: "The tiers of the test account";
+                readonly path: "The path to the test account config";
+            };
+            readonly example: (name: string) => string;
+        };
+        readonly delete: {
+            readonly describe: "Delete a test account config file.";
+            readonly pathPrompt: "[--path] What is the path to the test account config?";
+            readonly errors: {
+                readonly failedToDelete: "Failed to delete test account";
+            };
+            readonly success: {
+                readonly testAccountDeleted: (testAccountId: number) => string;
+            };
+            readonly positionals: {
+                readonly testAccountId: "The id of the test account";
+            };
+            readonly example: (testAccountId: number) => string;
+        };
+    };
     readonly secrets: {
         readonly add: {
             readonly loading: {
@@ -2318,7 +2435,6 @@ export declare const lib: {
         readonly noCompatibleComponents: (serverKey: string) => string;
     };
     readonly LocalDevManager: {
-        readonly staticAuthAccountsMustMatch: "You must test static auth apps in the account the project exists in";
         readonly appNotFound: (accountId: number, appUid: string | undefined) => string;
         readonly failedToInitialize: "Missing required arguments to initialize Local Dev";
         readonly noDeployedBuild: (projectName: string, accountIdentifier: string, uploadCommand: string) => string;
@@ -2363,6 +2479,9 @@ export declare const lib: {
     };
     readonly AppDevModeInterface: {
         readonly defaultMarketplaceAppWarning: (installCount: number) => string;
+        readonly autoInstallDeclined: "You must install your app on your target test account to proceed with local development.";
+        readonly autoInstallSuccess: (appName: string, targetTestAccountId: number) => string;
+        readonly autoInstallError: (appName: string, targetTestAccountId: number) => string;
     };
     readonly LocalDevWebsocketServer: {
         readonly errors: {
@@ -2514,7 +2633,7 @@ Run ${string} to upgrade to version ${string}`;
         readonly pollProjectBuildAndDeploy: {
             readonly buildSucceededAutomaticallyDeploying: (buildId: number, accountIdentifier: string) => string;
             readonly cleanedUpTempFile: (path: string) => string;
-            readonly viewDeploys: "View all deploys for this project in HubSpot";
+            readonly viewDeploys: "view all deploys for this project in HubSpot";
             readonly unableToFindAutodeployStatus: (buildId: number, viewDeploysLink: string) => string;
         };
     };
@@ -2651,31 +2770,18 @@ Run ${string} to upgrade to version ${string}`;
     };
     readonly commonOpts: {
         readonly options: {
-            readonly account: {
-                readonly describe: "HubSpot account id or name from config";
-            };
-            readonly config: {
-                readonly describe: "Path to a config file";
-            };
-            readonly overwrite: {
-                readonly describe: "Overwrite existing files";
-            };
+            readonly account: "HubSpot account id or name from config";
+            readonly config: "Path to a config file";
+            readonly overwrite: "Overwrite existing files";
             readonly modes: {
-                readonly describe: {
-                    readonly default: (modes: string) => string;
-                    readonly read: (modes: string) => string;
-                    readonly write: (modes: string) => string;
-                };
-            };
-            readonly qa: {
-                readonly describe: "Run command in QA mode";
-            };
-            readonly useEnv: {
-                readonly describe: "Use environment variable config";
-            };
-            readonly debug: {
-                readonly describe: "Set log level to debug";
+                readonly default: (modes: string) => string;
+                readonly read: (modes: string) => string;
+                readonly write: (modes: string) => string;
             };
+            readonly qa: "Run command in QA mode";
+            readonly useEnv: "Use environment variable config";
+            readonly jsonOutput: "Format output as JSON";
+            readonly debug: "Set log level to debug";
         };
     };
     readonly configMigrate: {
@@ -2717,6 +2823,14 @@ Run ${string} to upgrade to version ${string}`;
             readonly setAsDefaultAccount: (accountName: string) => string;
             readonly keepingCurrentDefault: (accountName: string) => string;
         };
+        readonly createDeveloperTestAccountConfigPrompt: {
+            readonly namePrompt: "[--name] What is the name of the test account?";
+            readonly descriptionPrompt: "[--description] What is the description of the test account?";
+            readonly tiersPrompt: "[--tiers] Which product tiers should the test account have?";
+            readonly errors: {
+                readonly tiersError: "Cannot have more than one tier per hub";
+            };
+        };
         readonly accountNamePrompt: {
             readonly enterAccountName: "Enter a unique name to reference this account in the CLI:";
             readonly enterDeveloperTestAccountName: "Name your developer test account:";
@@ -2889,6 +3003,7 @@ Run ${string} to upgrade to version ${string}`;
             readonly explanation: "Local development requires this app to be installed in the target test account";
             readonly 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.";
             readonly prompt: "Open HubSpot to install this app?";
+            readonly autoPrompt: "Install this app in your target test account?";
             readonly reinstallPrompt: "Open HubSpot to reinstall this app?";
             readonly decline: `To continue local development of this app, install it in your target test account and re-run ${string}`;
         };

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: {
@@ -777,6 +822,7 @@ exports.commands = {
         tailLogs: (functionPath, accountId) => `Waiting for log entries for "${functionPath}" on account "${accountId}".\n`,
     },
     mcp: {
+        describe: 'Commands for managing HubSpot MCP servers',
         setup: {
             installingDocSearch: 'Adding the docs-search mcp server',
             claudeCode: 'Claude Code',
@@ -787,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`,
             },
@@ -801,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: {
@@ -1321,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.',
@@ -1725,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: {
@@ -2319,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.`,
@@ -2364,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: {
@@ -2512,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: {
@@ -2593,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',
@@ -2649,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: {
@@ -2715,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:',
@@ -2887,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<{