@hubspot/cli 8.0.11-experimental.0 → 8.0.11-experimental.2

package/lang/en.d.ts

@@ -1304,6 +1304,30 @@ export declare const commands: {
             shuttingDown: string;
         };
     };
+    api: {
+        describe: string;
+        verboseDescribe: string;
+        positionals: {
+            endpoint: {
+                describe: string;
+            };
+        };
+        options: {
+            method: {
+                describe: string;
+            };
+            data: {
+                describe: string;
+            };
+        };
+        requestLog: (method: string, url: string) => string;
+        requestBodyLog: (body: string) => string;
+        responseLog: string;
+        errors: {
+            invalidJson: string;
+            statusLine: (status: number, statusText: string) => string;
+        };
+    };
     open: {
         describe: string;
         options: {
@@ -1345,6 +1369,7 @@ export declare const commands: {
                 };
                 errors: {
                     noProjectConfig: string;
+                    unsupportedPlatformVersion: string;
                     profileExists: (profileName: string) => string;
                     invalidTargetAccount: string;
                     noAccountsConfigured: string;
@@ -1375,6 +1400,7 @@ export declare const commands: {
                 };
                 errors: {
                     noProjectConfig: string;
+                    unsupportedPlatformVersion: string;
                     noProfileFound: (profileName: string) => string;
                     noProfilesFound: string;
                     failedToDeleteProfile: (profileName: string) => string;
@@ -1598,6 +1624,7 @@ export declare const commands: {
         deploy: {
             describe: string;
             deployBuildIdPrompt: string;
+            profileMessage: (profileName: string, accountId: number) => string;
             debug: {
                 deploying: (path: string) => string;
             };
@@ -1710,6 +1737,7 @@ export declare const commands: {
                 autoDeployDisabled: (deployCommand: string) => string;
             };
             errors: {
+                noProjectConfig: string;
                 projectLockedError: string;
             };
             options: {
@@ -1906,9 +1934,9 @@ export declare const commands: {
         };
         info: {
             describe: string;
+            verboseDescribe: string;
             project: {
-                title: string;
-                name: (name: string) => string;
+                title: (name: string) => string;
                 platformVersion: (version: string) => string;
                 id: (id: number) => string;
                 deployedBuild: (buildId: number) => string;
@@ -1922,6 +1950,10 @@ export declare const commands: {
                 authType: (authType: string) => string;
                 distributionType: (distributionType: string) => string;
             };
+            examples: {
+                default: string;
+                json: string;
+            };
             viewProjectLink: string;
             componentsHeader: string;
             labels: {
@@ -1935,6 +1967,48 @@ export declare const commands: {
                 unsupportedPlatformVersion: (platformVersion: string) => string;
             };
         };
+        delete: {
+            describe: string;
+            verboseDescribe: string;
+            warnings: {
+                irreversibleTitle: string;
+                irreversible: string;
+            };
+            prompts: {
+                selectProject: (accountId: number) => string;
+                confirmDelete: (projectName: string, accountId: number) => string;
+                validation: {
+                    projectRequired: string;
+                };
+            };
+            logs: {
+                deleting: (projectName: string) => string;
+                deleted: (projectName: string, accountId: number) => string;
+                cancelled: string;
+                componentsToDeleteUnified: (components: {
+                    componentType: string;
+                    componentId: string;
+                }[]) => string;
+                componentsToDeleteLegacy: (components: string[]) => string;
+                deletingComponents: (projectName: string) => string;
+                componentsDeleted: (projectName: string) => string;
+                unableToDetermineIfComponentsWereDeleted: (projectName: string) => string;
+                installWarning: (installCount: number) => string;
+                installCountUnknown: string;
+            };
+            errors: {
+                noProjectsFound: (accountId: number) => string;
+                projectNotFound: (projectName: string, accountId: number) => string;
+                deleteFailed: (projectName: string) => string;
+                cannotDelete: (projectName: string, reason: string) => string;
+                noPlatformVersion: string;
+                componentDeletionFailed: (projectName: string) => string;
+            };
+            options: {
+                project: string;
+                force: string;
+            };
+        };
     };
     sandbox: {
         describe: string;
@@ -3093,11 +3167,6 @@ export declare const lib: {
             profileTargetAccount: (accountId: number) => string;
             profileVariables: string;
         };
-        exitIfUsingProfiles: {
-            errors: {
-                noProfileSpecified: string;
-            };
-        };
         loadProfile: {
             errors: {
                 noProjectConfig: string;
@@ -3210,6 +3279,15 @@ export declare const lib: {
             fileFiltered: (filename: string) => string;
             legacyFileDetected: (filename: string, platformVersion: string) => string;
             projectDoesNotExist: (accountId: number) => string;
+            workspaceIncluded: (workspaceDir: string, archivePath: string) => string;
+            fileDependencyIncluded: (packageName: string, localPath: string, archivePath: string) => string;
+            malformedPackageJson: (packageJsonPath: string, error: string) => string;
+            workspaceCollision: (archivePath: string, workspaceDir: string, existingWorkspace: string) => string;
+            fileDependencyAlreadyIncluded: (packageName: string, archivePath: string) => string;
+            updatingLockfile: (lockfilePath: string) => string;
+            updatingPackageJsonWorkspaces: (packageJsonPath: string) => string;
+            updatedWorkspaces: (workspaces: string) => string;
+            updatedFileDependency: (packageName: string, relativePath: string) => string;
         };
     };
     importData: {
@@ -3320,6 +3398,9 @@ export declare const lib: {
             pakFailure: string;
         };
     };
+    usageTracking: {
+        transparencyMessage: string;
+    };
     configOptions: {
         enableOrDisableBooleanFieldPrompt: {
             message: (fieldName: string) => string;
@@ -3408,8 +3489,14 @@ export declare const lib: {
         promptUtils: {
             errors: {
                 noSelectableChoices: string;
+                userCancelled: string;
             };
         };
+        projectProfilePrompt: {
+            message: string;
+            exitMessage: string;
+            noValidProfilesMessage: string;
+        };
         importDataFilePathPrompt: {
             promptContext: string;
             promptMessage: string;
@@ -3949,6 +4036,7 @@ export declare const lib: {
     migrate: {
         componentsToBeMigrated: (components: string) => string;
         componentsThatWillNotBeMigrated: (components: string) => string;
+        legacyCrmCardMigrationDocs: () => string;
         sourceContentsMoved: (newLocation: string) => string;
         projectMigrationWarningTitle: (platformVersion: string) => string;
         projectMigrationWarning: (platformVersion: string) => string;

package/lang/en.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { mapToUserFriendlyName } from '@hubspot/project-parsing-lib/transform';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constants/auth';
 import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, } from '@hubspot/local-dev-lib/constants/config';
 import { uiAccountDescription, uiBetaTag, uiCommandReference, uiLink, UI_COLORS, uiAuthCommandReference, } from '../lib/ui/index.js';
@@ -1320,6 +1320,30 @@ export const commands = {
             shuttingDown: 'Shutting down MCP server...',
         },
     },
+    api: {
+        describe: 'Make an authenticated HTTP request to any HubSpot API endpoint that supports PAKs.',
+        verboseDescribe: `Make an authenticated HTTP request to any HubSpot API that supports PAKs using your CLI authentication.\n\nThis command is intended for testing and exploration of HubSpot APIs. It uses the authentication credentials configured in the CLI to make requests on your behalf.\n\nThe endpoint should be the API path, e.g. ${chalk.bold('/crm/v3/objects/contacts')}. The request will be authenticated using the account specified by ${uiCommandReference('--account')} or the default account.\n\nNote: The available endpoints depend on the scopes granted to your personal access key. If you receive a 403 error, check that your key includes the required scopes for the endpoint you are trying to reach. ${uiLink('Learn more about the HubSpot API', 'https://developers.hubspot.com/docs/api-reference/latest/overview')}`,
+        positionals: {
+            endpoint: {
+                describe: 'API endpoint path (e.g. /crm/v3/objects/contacts)',
+            },
+        },
+        options: {
+            method: {
+                describe: 'HTTP method to use. Defaults to GET, or POST if --data is provided',
+            },
+            data: {
+                describe: 'JSON-formatted request body for POST, PUT, and PATCH requests',
+            },
+        },
+        requestLog: (method, url) => `${chalk.bold(method)} ${url}`,
+        requestBodyLog: (body) => `Request body: ${body}`,
+        responseLog: 'Response:',
+        errors: {
+            invalidJson: 'The value passed to --data is not valid JSON. Please provide a valid JSON string.',
+            statusLine: (status, statusText) => `${chalk.red(`${status} ${statusText}`)}`,
+        },
+    },
     open: {
         describe: 'Open a HubSpot page in your browser.',
         options: {
@@ -1361,6 +1385,7 @@ export const commands = {
                 },
                 errors: {
                     noProjectConfig: 'No project config found. Please run this command from a project directory.',
+                    unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
                     profileExists: (profileName) => `Profile ${chalk.bold(profileName)} already exists. Please choose a different name.`,
                     invalidTargetAccount: 'Target account is not configured in the CLI',
                     noAccountsConfigured: 'No accounts configured in the CLI',
@@ -1391,6 +1416,7 @@ export const commands = {
                 },
                 errors: {
                     noProjectConfig: 'No project config found. Please run this command from a project directory.',
+                    unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
                     noProfileFound: (profileName) => `No profile with filename ${chalk.bold(profileName)} found in your project.`,
                     noProfilesFound: 'No profiles found in your project.',
                     failedToDeleteProfile: (profileName) => `Unable to delete profile ${chalk.bold(profileName)}. Please try again.`,
@@ -1424,7 +1450,7 @@ export const commands = {
                 noRunnableComponents: `No supported components were found in this project. Run ${uiCommandReference('hs project add')} to see a list of available components and add one to your project.`,
                 accountNotCombined: `\nLocal development of unified apps is currently only compatible with accounts that are opted into the unified apps beta. Make sure that this account is opted in or switch accounts using ${uiCommandReference('hs account use')}.`,
                 unsupportedAccountFlagLegacy: 'The --project-account and --testing-account flags are not supported for projects with platform versions earlier than 2025.2.',
-                unsupportedAccountFlagV2: 'The --account flag is is not supported supported for projects with platform versions 2025.2 and newer. Use --testing-account and --project-account flags to specify accounts to use for local dev',
+                unsupportedAccountFlagV2: 'The --account flag is not supported for projects with platform versions 2025.2 and newer. Use --testing-account and --project-account flags to specify accounts to use for local dev',
                 localDevAlreadyRunning: `Another ${uiCommandReference('hs project dev')} process is already running. To proceed with local development of this project, stop the existing process and re-run ${uiCommandReference('hs project dev')}.`,
             },
             examples: {
@@ -1614,6 +1640,7 @@ export const commands = {
         deploy: {
             describe: 'Deploy a project build.',
             deployBuildIdPrompt: '[--build] Deploy which build?',
+            profileMessage: (profileName, accountId) => `Deploying with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
             debug: {
                 deploying: (path) => `Deploying project at path: ${path}`,
             },
@@ -1726,6 +1753,7 @@ export const commands = {
                 autoDeployDisabled: (deployCommand) => `Automatic deploys are disabled for this project. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
             },
             errors: {
+                noProjectConfig: 'No project detected. Run this command from a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${uiCommandReference('hs project dev')} command for this project. If this is you, unlock the project in Projects UI.`,
             },
             options: {
@@ -1929,9 +1957,9 @@ export const commands = {
         },
         info: {
             describe: 'Display information about a project, its app, and its components',
+            verboseDescribe: `Display information about a project, its app, and its components\n\nShows the project's platform version, deployed build ID, auto-deploy status, app metadata, and a list of components.\n\nRun ${uiCommandReference('hs project info --json')} to output the result as JSON for scripting.`,
             project: {
-                title: 'Project',
-                name: (name) => `Name: ${name}`,
+                title: (name) => `Project: ${name}`,
                 platformVersion: (version) => `Platform Version: ${version}`,
                 id: (id) => `Project ID: ${id}`,
                 deployedBuild: (buildId) => `Deployed Build: #${buildId}`,
@@ -1945,6 +1973,10 @@ export const commands = {
                 authType: (authType) => `Auth Type: ${authType}`,
                 distributionType: (distributionType) => `Distribution: ${distributionType}`,
             },
+            examples: {
+                default: 'Display project information',
+                json: 'Output as JSON for scripting',
+            },
             viewProjectLink: 'View project in HubSpot',
             componentsHeader: 'Components',
             labels: {
@@ -1952,12 +1984,51 @@ export const commands = {
                 uid: 'UID',
             },
             errors: {
-                noProjectConfig: 'No project found. Run this command from a project directory.',
+                noProjectConfig: `No project found in this directory.\n\nRun ${uiCommandReference('hs project create')} to start a new project, or change to a directory containing hsproject.json.`,
                 projectNotFound: (projectName, accountId) => `Project "${projectName}" was not found in account ${uiAccountDescription(accountId)}. Make sure the project has been uploaded at least once.`,
-                noDeployedBuild: 'This project has not been deployed yet. Deploy your project to see component information.',
+                noDeployedBuild: `This project has not been deployed yet.\n\nRun ${uiCommandReference('hs project deploy')} to deploy your project.`,
                 unsupportedPlatformVersion: (platformVersion) => `This command is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
             },
         },
+        delete: {
+            describe: 'Delete a project from the current target account',
+            verboseDescribe: `Delete a project from the current target account\n\nThis will permanently delete the project, all deployed components, and any app installations associated with it. Your local project files will not be affected.`,
+            warnings: {
+                irreversibleTitle: 'Warning: This will permanently delete your project',
+                irreversible: 'Deleting this project will also delete all deployed components and app installations. This action cannot be undone. Your local project files will not be affected.',
+            },
+            prompts: {
+                selectProject: (accountId) => `Select a project to delete in ${uiAccountDescription(accountId)}`,
+                confirmDelete: (projectName, accountId) => `[--force] Delete ${chalk.bold(projectName)} from ${uiAccountDescription(accountId)}? This cannot be undone.`,
+                validation: {
+                    projectRequired: 'Please select a project to delete',
+                },
+            },
+            logs: {
+                deleting: (projectName) => `Deleting project ${chalk.bold(projectName)}...`,
+                deleted: (projectName, accountId) => `Deleted project ${chalk.bold(projectName)} from ${uiAccountDescription(accountId)}`,
+                cancelled: 'Deletion cancelled',
+                componentsToDeleteUnified: (components) => `The following deployed components will be deleted:\n${components.map(c => `  - ${chalk.bold(c.componentId)} (${mapToUserFriendlyName(c.componentType)})`).join('\n')}`,
+                componentsToDeleteLegacy: (components) => `The following deployed components will be deleted:\n${components.map(c => `  - ${chalk.bold(c)}`).join('\n')}`,
+                deletingComponents: (projectName) => `Deleting deployed components from ${chalk.bold(projectName)}...`,
+                componentsDeleted: (projectName) => `Deleted deployed components from ${chalk.bold(projectName)}`,
+                unableToDetermineIfComponentsWereDeleted: (projectName) => `Unable to determine if components were successfully deleted from ${chalk.bold(projectName)}.  Please try again.`,
+                installWarning: (installCount) => `This project has ${chalk.bold(String(installCount))} active app ${installCount === 1 ? 'installation' : 'installations'} that will be deleted.`,
+                installCountUnknown: 'Unable to determine the number of active app installations for this project.',
+            },
+            errors: {
+                noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
+                projectNotFound: (projectName, accountId) => `Project ${chalk.bold(projectName)} not found in ${uiAccountDescription(accountId)}`,
+                deleteFailed: (projectName) => `Failed to delete project ${chalk.bold(projectName)}. Run with --debug for details or try again.`,
+                cannotDelete: (projectName, reason) => `Cannot delete project ${chalk.bold(projectName)}: ${reason}`,
+                noPlatformVersion: 'Unable to determine platform version for project',
+                componentDeletionFailed: (projectName) => `Failed to delete deployed components from ${chalk.bold(projectName)}. The project was not deleted.`,
+            },
+            options: {
+                project: 'name of the project to delete',
+                force: 'skip confirmation prompt',
+            },
+        },
     },
     sandbox: {
         describe: 'Commands for managing sandboxes.',
@@ -2253,7 +2324,7 @@ export const commands = {
             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',
+            createFromScratchOption: 'Select hub tiers manually',
             errors: {
                 configFileNotFound: (configPath) => `No test account config file exists at ${configPath}. Create a test account config file with the ${uiCommandReference('hs test-account create-config')} command.`,
                 configFileParseFailed: (configPath) => `Failed to parse test account config file at ${configPath}`,
@@ -3116,11 +3187,6 @@ export const lib = {
             profileTargetAccount: (accountId) => `Targeting ${uiAccountDescription(accountId)}`,
             profileVariables: 'Profile variables',
         },
-        exitIfUsingProfiles: {
-            errors: {
-                noProfileSpecified: `This project is configured to use profiles, but no profile was specified. Target a profile using the ${uiCommandReference('--profile')} flag.`,
-            },
-        },
         loadProfile: {
             errors: {
                 noProjectConfig: 'No project config found. Please run this command from a project directory.',
@@ -3233,6 +3299,15 @@ export const lib = {
             fileFiltered: (filename) => `Ignore rule triggered for "${filename}"`,
             legacyFileDetected: (filename, platformVersion) => `The ${chalk.bold(filename)} file is not supported on platform version ${chalk.bold(platformVersion)} and will be ignored.`,
             projectDoesNotExist: (accountId) => `Upload cancelled. Run ${uiCommandReference('hs project upload')} again to create the project in ${uiAccountDescription(accountId)}.`,
+            workspaceIncluded: (workspaceDir, archivePath) => `Including workspace: ${workspaceDir} → ${archivePath}`,
+            fileDependencyIncluded: (packageName, localPath, archivePath) => `Including file: dependency ${packageName}: ${localPath} → ${archivePath}`,
+            malformedPackageJson: (packageJsonPath, error) => `Skipping malformed package.json at ${packageJsonPath}: ${error}`,
+            workspaceCollision: (archivePath, workspaceDir, existingWorkspace) => `Workspace collision: ${archivePath} from ${workspaceDir} and ${existingWorkspace}`,
+            fileDependencyAlreadyIncluded: (packageName, archivePath) => `file: dependency ${packageName} already included as workspace: ${archivePath}`,
+            updatingLockfile: (lockfilePath) => `Updating package-lock.json in archive: ${lockfilePath}`,
+            updatingPackageJsonWorkspaces: (packageJsonPath) => `Updating package.json workspaces in archive: ${packageJsonPath}`,
+            updatedWorkspaces: (workspaces) => `  Updated workspaces: ${workspaces}`,
+            updatedFileDependency: (packageName, relativePath) => `  Updated dependencies.${packageName}: file:${relativePath}`,
         },
     },
     importData: {
@@ -3343,6 +3418,9 @@ export const lib = {
             pakFailure: 'Failed to generate personal access key for developer test account',
         },
     },
+    usageTracking: {
+        transparencyMessage: `HubSpot CLI collects anonymous usage data to improve the product. Run ${uiCommandReference('hs config set --enable-usage-tracking=false', false)} to opt out.\n`,
+    },
     configOptions: {
         enableOrDisableBooleanFieldPrompt: {
             message: (fieldName) => `Choose to enable or disable ${fieldName}`,
@@ -3431,8 +3509,14 @@ export const lib = {
         promptUtils: {
             errors: {
                 noSelectableChoices: 'Exiting prompt because no selectable choices are available',
+                userCancelled: 'User cancelled prompt',
             },
         },
+        projectProfilePrompt: {
+            message: '[--profile] This project is configured to use profiles. Select a profile to use:',
+            exitMessage: `This project is configured to use profiles, but no profile was specified. Try again using ${uiCommandReference('--profile')}`,
+            noValidProfilesMessage: 'There are no valid profiles in this project. Ensure the accounts they are targeting are authenticated and try again.',
+        },
         importDataFilePathPrompt: {
             promptContext: `To view the JSON schema for data imports, visit ${uiLink('the docs', 'https://developers.hubspot.com/docs/guides/api/crm/imports')}`,
             promptMessage: '[--file-path] Select the JSON file that will be used to import your data.',
@@ -3972,6 +4056,7 @@ export const lib = {
     migrate: {
         componentsToBeMigrated: (components) => `${chalk.bold('The following features will be migrated:')} ${components}`,
         componentsThatWillNotBeMigrated: (components) => `[NOTE] These features are not yet supported for migration but will be available later: ${components}`,
+        legacyCrmCardMigrationDocs: () => `For more information on migrating legacy-crm-card components, follow ${uiLink('these docs', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-legacy-crm-cards-to-app-cards')}`,
         sourceContentsMoved: (newLocation) => `The contents of your old source directory have been moved to ${newLocation}, move any required files to the new source directory.`,
         projectMigrationWarningTitle: (platformVersion) => `Important: Migrating to platformVersion ${platformVersion} is irreversible`,
         projectMigrationWarning: (platformVersion) => uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion ${platformVersion}. This action cannot be undone. To ensure you have access to your original files, they will be copied to a new directory (archive) for safekeeping.\n\nThis command will guide you through the process, prompting you to enter the required fields and will download the new project source code into your project source directory.`, false),
@@ -3986,7 +4071,7 @@ export const lib = {
                 doesNotExist: (account) => `Project does not exist in ${uiAccountDescription(account)}. Migrations are only supported for existing projects.`,
                 themesAlreadyMigrated: 'This project has already been migrated to the latest platform version.',
                 noProjectForThemesMigration: 'Theme migrations are only supported for projects. Please try again from a project directory.',
-                themesAndAppsNotAllowed: 'Support for migrating projects containing both themes and apps to the latest platform version is coming soon. Try again later.',
+                themesAndAppsNotAllowed: 'Projects containing both themes and apps cannot be migrated together. To migrate, split the project into separate theme-only and app-only projects, then run migrate on each individually.',
                 multipleApps: 'Multiple apps found in project, this is not allowed in 2025.2',
                 alreadyExists: (projectName) => `A project with name ${projectName} already exists. Please choose another name.`,
                 failedToMigrateThemes: 'Failed to migrate project themes. Please verify that your themes are properly formatted before trying again.',

package/lib/accountAuth.js

@@ -3,7 +3,7 @@ import { getAccessToken, updateConfigWithAccessToken, } from '@hubspot/local-dev
 import { toKebabCase } from '@hubspot/local-dev-lib/text';
 import { handleMerge, handleMigration } from './configMigrate.js';
 import { debugError, logError } from './errorHandlers/index.js';
-import { PromptExitError } from './errors/PromptExitError.js';
+import { isPromptExitError } from './errors/PromptExitError.js';
 import { personalAccessKeyPrompt } from './prompts/personalAccessKeyPrompt.js';
 import { cliAccountNamePrompt } from './prompts/accountNamePrompt.js';
 import { setAsDefaultAccountPrompt } from './prompts/setAsDefaultAccountPrompt.js';
@@ -37,7 +37,7 @@ async function updateConfigWithNewAccount(env, configAlreadyExists, providedPers
         return updatedConfig;
     }
     catch (e) {
-        if (e instanceof PromptExitError) {
+        if (isPromptExitError(e)) {
             throw e;
         }
         debugError(e);

package/lib/app/migrate.js

@@ -124,8 +124,12 @@ export async function selectAppToMigrate(allApps, derivedAccountId, appId) {
     const selectedApp = allApps.find(app => app.appId === appIdToMigrate);
     const migratableComponents = new Set();
     const unmigratableComponents = new Set();
+    let hasLegacyCrmCards = false;
     selectedApp?.migrationComponents.forEach(component => {
         const userFacingComponentType = mapToUserFacingType(component.componentType);
+        if (component.componentType === 'LEGACY_CRM_CARD' && !component.isSupported) {
+            hasLegacyCrmCards = true;
+        }
         const shouldDisplayComponent = !AUTO_GENERATED_COMPONENT_TYPES.includes(userFacingComponentType);
         if (shouldDisplayComponent) {
             if (component.isSupported) {
@@ -142,6 +146,9 @@ export async function selectAppToMigrate(allApps, derivedAccountId, appId) {
     if (unmigratableComponents.size !== 0) {
         uiLogger.log(lib.migrate.componentsThatWillNotBeMigrated(`\n - ${[...unmigratableComponents].join('\n - ')}`));
     }
+    if (hasLegacyCrmCards) {
+        uiLogger.info(lib.migrate.legacyCrmCardMigrationDocs());
+    }
     uiLogger.log('');
     const proceed = await confirmPrompt(lib.migrate.prompt.proceed, {
         defaultAnswer: false,

package/lib/buildAccount.js

@@ -4,7 +4,7 @@ import { uiLogger } from './ui/logger.js';
 import { createDeveloperTestAccount, fetchDeveloperTestAccountGateSyncStatus, generateDeveloperTestAccountPersonalAccessKey, } from '@hubspot/local-dev-lib/api/developerTestAccounts';
 import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
 import { createV2Sandbox, getSandboxPersonalAccessKey, } from '@hubspot/local-dev-lib/api/sandboxHubs';
-import { PromptExitError } from './errors/PromptExitError.js';
+import { isPromptExitError } from './errors/PromptExitError.js';
 import { personalAccessKeyPrompt } from './prompts/personalAccessKeyPrompt.js';
 import { createDeveloperTestAccountConfigPrompt } from './prompts/createDeveloperTestAccountConfigPrompt.js';
 import { cliAccountNamePrompt } from './prompts/accountNamePrompt.js';
@@ -128,7 +128,7 @@ export async function buildDeveloperTestAccount(testAccountName, parentAccountCo
         await saveAccountToConfig(developerTestAccountId, testAccountName, env, developerTestAccountPersonalAccessKey);
     }
     catch (err) {
-        if (err instanceof PromptExitError) {
+        if (isPromptExitError(err)) {
             throw err;
         }
         logError(err);
@@ -174,7 +174,7 @@ export async function buildV2Sandbox(sandboxName, parentAccountConfig, sandboxTy
         await saveAccountToConfig(sandbox.sandboxHubId, sandboxName, env, pak, force);
     }
     catch (err) {
-        if (err instanceof PromptExitError) {
+        if (isPromptExitError(err)) {
             throw err;
         }
         logError(err);

package/lib/constants.d.ts

@@ -78,7 +78,6 @@ export declare const APP_AUTH_TYPES: {
 export declare const FEATURES: {
     readonly UNIFIED_APPS: "Developers:UnifiedApps:PrivateBeta";
     readonly APP_EVENTS: "Developers:UnifiedApps:AppEventsAccess";
-    readonly APPS_HOME: "UIE:AppHome";
     readonly THEME_MIGRATION_2025_2: "Developers:ProjectThemeMigrations:2025.2";
     readonly AGENT_TOOLS: "ThirdPartyAgentTools";
 };

package/lib/constants.js

@@ -70,7 +70,6 @@ export const APP_AUTH_TYPES = {
 export const FEATURES = {
     UNIFIED_APPS: 'Developers:UnifiedApps:PrivateBeta',
     APP_EVENTS: 'Developers:UnifiedApps:AppEventsAccess',
-    APPS_HOME: 'UIE:AppHome',
     THEME_MIGRATION_2025_2: 'Developers:ProjectThemeMigrations:2025.2',
     AGENT_TOOLS: 'ThirdPartyAgentTools',
 };

package/lib/doctor/Diagnosis.js

@@ -1,4 +1,4 @@
-import { prefixOptions } from '../ui/spinniesUtils.js';
+import { getLabels } from '@hubspot/local-dev-lib/logger';
 import chalk from 'chalk';
 import { helpers } from '../interpolation.js';
 import { uiAccountDescription } from '../ui/index.js';
@@ -10,11 +10,11 @@ export class Diagnosis {
     errorCount = 0;
     warningCount = 0;
     constructor({ diagnosticInfo, accountId }) {
-        const { succeedPrefix, failPrefix } = prefixOptions({});
+        const labels = getLabels();
         this.prefixes = {
-            success: chalk.green(succeedPrefix),
-            error: chalk.red(failPrefix),
-            warning: helpers.orange('!'),
+            success: chalk.green(labels.success),
+            error: chalk.red(labels.error),
+            warning: helpers.orange(labels.warning),
         };
         this.diagnosis = {
             cli: {

package/lib/doctor/Doctor.js

@@ -26,7 +26,7 @@ import { isServerRunningAtUrl } from '../http.js';
 import { WEBHOOKS_KEY, APP_KEY } from '@hubspot/project-parsing-lib/constants';
 import { validateProjectConfig } from '../projects/config.js';
 import { validateSourceDirectory, handleTranslate, } from '../projects/upload.js';
-import { isV2Project } from '../projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { validateProjectForProfile } from '../projects/projectProfiles.js';
 import { getAllHsProfiles } from '@hubspot/project-parsing-lib/profiles';
 const minMajorNodeVersion = 20;
@@ -534,7 +534,7 @@ export class Doctor {
             if (!this.validateProjectConfigWrapper(projectConfig, projectDir)) {
                 return;
             }
-            if (!isV2Project(projectConfig.platformVersion)) {
+            if (isLegacyProject(projectConfig.platformVersion)) {
                 this.diagnosis?.addProjectSection({
                     type: 'success',
                     message: lib.doctor.projectValidation.valid,

package/lib/errorHandlers/index.js

@@ -7,11 +7,12 @@ import util from 'util';
 import { isProjectValidationError } from '../errors/ProjectValidationError.js';
 export function logError(error, context) {
     debugError(error, context);
-    if (isProjectValidationError(error)) {
-        uiLogger.error(error.message);
+    // This should be right after debugError.  Add anything else below it
+    if (shouldSuppressError(error, context)) {
         return;
     }
-    if (shouldSuppressError(error, context)) {
+    if (isProjectValidationError(error)) {
+        uiLogger.error(error.message);
         return;
     }
     if (isHubSpotHttpError(error)) {

package/lib/errorHandlers/suppressError.js

@@ -3,6 +3,7 @@ import { uiLogger } from '../ui/logger.js';
 import { PLATFORM_VERSION_ERROR_TYPES } from '../constants.js';
 import { lib } from '../../lang/en.js';
 import { uiAccountDescription, uiLine, uiLink } from '../ui/index.js';
+import { isPromptExitError } from '../errors/PromptExitError.js';
 function createPlatformVersionError(err, subCategory) {
     let translationKey = 'unspecifiedPlatformVersion';
     let platformVersion = 'unspecified platformVersion';
@@ -27,6 +28,9 @@ function createPlatformVersionError(err, subCategory) {
     uiLine();
 }
 export function shouldSuppressError(err, context) {
+    if (isPromptExitError(err)) {
+        return true;
+    }
     if (isMissingScopeError(err)) {
         uiLogger.error(lib.errorHandlers.suppressErrors.missingScopeError(context?.request || 'request', context?.accountId ? uiAccountDescription(context.accountId) : ''));
         return true;

package/lib/errors/PromptExitError.d.ts

@@ -1,4 +1,6 @@
+import { ExitCode } from '../../types/Yargs.js';
 export declare class PromptExitError extends Error {
-    exitCode: number;
-    constructor(message: string, exitCode: number);
+    exitCode: ExitCode;
+    constructor(message: string, exitCode: ExitCode);
 }
+export declare function isPromptExitError(e: unknown): e is PromptExitError;

package/lib/errors/PromptExitError.js

@@ -6,3 +6,6 @@ export class PromptExitError extends Error {
         this.exitCode = exitCode;
     }
 }
+export function isPromptExitError(e) {
+    return e instanceof PromptExitError;
+}

package/lib/getStartedV2Actions.js

@@ -13,7 +13,7 @@ import { getStaticAuthAppInstallUrl } from '../lib/app/urls.js';
 import { HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, PROJECT_CONFIG_FILE, } from '../lib/constants.js';
 import { ProjectNestingError, ProjectConfigNotFoundError, ProjectValidationError, ProjectUploadError, ProjectBuildDeployError, } from './errors/ProjectErrors.js';
 import { getProjectConfig, validateProjectConfig, writeProjectConfig, } from '../lib/projects/config.js';
-import { isV2Project } from '../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { pollProjectBuildAndDeploy } from '../lib/projects/pollProjectBuildAndDeploy.js';
 import { handleProjectUpload } from '../lib/projects/upload.js';
 import { validateProjectDirectory } from '../lib/prompts/projectNameAndDestPrompt.js';
@@ -109,7 +109,7 @@ export async function uploadAndDeployAction({ accountId, projectDest, }) {
             uploadMessage: commands.getStarted.logs.initialUploadMessage,
             forceCreate: true,
             isUploadCommand: false,
-            sendIR: isV2Project(projectConfig.platformVersion),
+            sendIR: !isLegacyProject(projectConfig.platformVersion),
             skipValidation: false,
         });
         if (uploadError) {

package/lib/hasFeature.js

@@ -1,7 +1,6 @@
 import { http } from '@hubspot/local-dev-lib/http';
 import { fetchEnabledFeatures } from '@hubspot/local-dev-lib/api/localDevAuth';
-import { FEATURES } from './constants.js';
-const FEATURES_THAT_DEFAULT_ON = [FEATURES.APPS_HOME];
+const FEATURES_THAT_DEFAULT_ON = [];
 export async function hasFeature(accountId, feature) {
     const { data: { enabledFeatures }, } = await fetchEnabledFeatures(accountId);
     if (enabledFeatures[feature] === undefined &&