@hubspot/cli 7.8.0-experimental.0 → 7.8.2-experimental.0

package/lang/en.js

@@ -5,6 +5,7 @@ import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constant
 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, } from '../lib/ui/index.js';
 import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, getAppAllowlistUrl, } from '../lib/projects/urls.js';
+import { getProductUpdatesUrl } from '../lib/links.js';
 import { APP_DISTRIBUTION_TYPES, APP_AUTH_TYPES, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, } from '../lib/constants.js';
 import { getAccountIdentifier } from '@hubspot/local-dev-lib/config/getAccountIdentifier';
 export const commands = {
@@ -18,6 +19,7 @@ export const commands = {
         },
     },
     getStarted: {
+        describe: 'A step-by-step command to get you started with a HubSpot project.',
         options: {
             dest: {
                 describe: 'Directory where the project should be created',
@@ -862,8 +864,9 @@ export const commands = {
         tailLogs: (functionPath, accountId) => `Waiting for log entries for "${functionPath}" on account "${accountId}".\n`,
     },
     mcp: {
-        describe: 'Commands for managing HubSpot MCP servers',
+        describe: 'Commands for managing HubSpot MCP servers.',
         setup: {
+            describe: 'Setup the HubSpot development MCP servers.',
             installingDocSearch: 'Adding the docs-search mcp server',
             claudeCode: 'Claude Code',
             cursor: 'Cursor',
@@ -875,6 +878,7 @@ export const commands = {
             },
             success: (derivedTargets) => `You can now use the HubSpot CLI MCP Server in ${derivedTargets.join(', ')}.  ${chalk.bold('You may need to restart these tools to apply the changes')}.`,
             errors: {
+                needsMcpAccess: (accountId) => `You must opt in to the developer MCP beta to use this feature on ${uiAccountDescription(accountId)}. Try again with a different account or ${uiLink('join the beta now', getProductUpdatesUrl('239890', accountId))}`,
                 needsNode20: `This feature requires node >=20`,
                 errorParsingJsonFIle: (filename, errorMessage) => `Unable to update ${chalk.bold(filename)} due to invalid JSON: ${errorMessage}`,
             },
@@ -1009,10 +1013,10 @@ export const commands = {
         dev: {
             describe: 'Start local dev for the current project.',
             logs: {
-                betaMessage: 'HubSpot projects local development',
+                header: 'HubSpot projects local development',
                 placeholderAccountSelection: 'Using default account as target account (for now)',
                 accountTypeInformation: 'Testing in a developer test account is strongly recommended, but you can use a sandbox account if your plan allows you to create one.',
-                learnMoreMessageV3: `Learn more about ${uiLink('HubSpot projects local dev', 'https://hubspot.mintlify.io/en-us/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server')} | ${uiLink('HubSpot account types', 'https://developers.hubspot.com/docs/getting-started/account-types')}`,
+                learnMoreMessageV3: `Learn more about ${uiLink('HubSpot projects local dev', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server')} | ${uiLink('HubSpot account types', 'https://developers.hubspot.com/docs/getting-started/account-types')}`,
                 learnMoreMessageLegacy: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/platform/project-cli-commands#start-a-local-development-server'),
                 profileProjectAccountExplanation: (accountId, profileName) => `Using account ${uiAccountDescription(accountId)} from profile ${chalk.bold(profileName)} for project upload`,
                 defaultProjectAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for project upload`,
@@ -1069,7 +1073,7 @@ export const commands = {
                     describe: 'Project name (cannot be changed)',
                 },
                 template: {
-                    describe: 'The starting template',
+                    describe: 'The starting template.  Only applies when platform version is less than 2025.2.',
                 },
                 templateSource: {
                     describe: 'Path to custom GitHub repository from which to create project template',
@@ -1135,6 +1139,7 @@ export const commands = {
             describe: 'Migrate an existing project to the new version of the projects framework.',
             errors: {
                 noProjectConfig: (command) => `No project detected. Please run this command again from a project directory.  If you are trying to migrate an app, run ${command}`,
+                noThemeMigrationAccess: (accountId) => `This project contains a CMS theme. You must opt in to theme migration beta to continue updating it on ${uiAccountDescription(accountId)}. Try again with a different account or ${uiLink('join the beta now', getProductUpdatesUrl('253920', accountId))}`,
             },
             examples: {
                 default: 'Migrate an existing project to the new version of the projects framework.',
@@ -1192,7 +1197,7 @@ export const commands = {
                 maxExceeded: (maxCount) => `This project has the maximum allowed(${maxCount})`,
                 authTypeNotAllowed: (authType) => `Auth type '${authType}' not allowed.`,
                 distributionNotAllowed: (dist) => `Distribution '${dist}' not allowed.`,
-                portalDoesNotHaveAccessToThisFeature: (accountId) => `The account ${uiAccountDescription(accountId)} does not have access to this feature`,
+                portalDoesNotHaveAccessToThisFeature: (accountId) => `The account ${uiAccountDescription(accountId)} does not have access to this feature.`,
                 locationInProject: 'This command must be run from within a project directory.',
                 failedToFetchComponentList: 'Failed to fetch the list of available features. Please try again later.',
                 projectContainsPublicApp: 'This project contains a public app. This command is currently only compatible with projects that contain private apps.',
@@ -2588,8 +2593,13 @@ export const lib = {
     LocalDevProcess: {
         projectConfigMismatch: `Unable to upload project. The project config has been modified since starting ${uiCommandReference('hs project dev')}.`,
         uploadInitiated: 'Project upload initiated from Local Dev UI.',
+        deployInitiated: 'Project deploy initiated from Local Dev UI.',
         uploadFailed: 'Project upload failed. To proceed with local development, fix any necessary errors, then re-upload your project.',
+        deployFailed: 'Project deploy failed. To proceed with local development, fix any necessary errors, then re-deploy your project.',
         uploadSuccess: 'Project upload completed successfully. Resuming local dev...',
+        uploadSuccessAutoDeployDisabled: 'Project upload completed successfully, but auto-deploy is disabled for this project. Deploy your latest build to proceed with local development.',
+        deploySuccess: 'Project deploy completed successfully. Resuming local dev...',
+        noBuildToDeploy: 'Error deploying project. No build was found to deploy.',
     },
     localDevHelpers: {
         project: {
@@ -2598,7 +2608,7 @@ export const lib = {
                 checking: 'Checking if your deployed build is up to date...',
                 upToDate: 'Deployed build is up to date.',
                 notUpToDate: `Your project contains undeployed local changes.`,
-                notUpToDateExplanation: `Run ${uiCommandReference('hs project upload')} to upload these changes to HubSpot, then re-run ${uiCommandReference('hs project dev')} to continue local development.`,
+                notUpToDateExplanation: (profile) => `Run ${uiCommandReference(`hs project upload ${profile ? `--profile ${profile}` : ''}`)} to upload these changes to HubSpot, then re-run ${uiCommandReference(`hs project dev ${profile ? `--profile ${profile}` : ''}`)} to continue local development.`,
             },
             createNewProjectForLocalDev: {
                 projectMustExistExplanation: (projectName, accountId) => `The project ${projectName} does not exist in the target account ${uiAccountDescription(accountId)}. This command requires the project to exist in the target account.`,
@@ -3105,6 +3115,7 @@ export const lib = {
         },
         projectAddPrompt: {
             selectType: '[--type] Select an app feature to add: ',
+            selectFeatures: '[--features] Select an app feature to add: ',
             enterName: '[--name] Give your component a name: ',
             errors: {
                 nameRequired: 'A component name is required',
@@ -3382,6 +3393,7 @@ export const lib = {
         sourceContentsMoved: (newLocation) => `The contents of your old source directory have been moved to ${newLocation}, move any required files to the new source directory.`,
         projectMigrationWarningTitle: 'Important: Migrating to platformVersion 2025.2 is irreversible',
         projectMigrationWarning: uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion 2025.2. 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),
+        exitWithoutMigrating: 'Exiting without migrating',
         success: {
             downloadedProject: (projectName, projectDest) => `Saved ${projectName} to ${projectDest}`,
             themesMigrationSuccess: (platformVersion) => `Successfully migrated project to platformVersion ${chalk.bold(platformVersion)}. Upload your project using ${uiCommandReference('hs project upload')}`,

package/lib/__tests__/hasFeature.test.js

@@ -1,35 +1,173 @@
 import { fetchEnabledFeatures } from '@hubspot/local-dev-lib/api/localDevAuth';
-import { hasFeature } from '../hasFeature.js';
+import { http } from '@hubspot/local-dev-lib/http';
+import { hasFeature, hasUnfiedAppsAccess } from '../hasFeature.js';
+import { FEATURES } from '../constants.js';
 vi.mock('@hubspot/local-dev-lib/api/localDevAuth');
+vi.mock('@hubspot/local-dev-lib/http');
 const mockedFetchEnabledFeatures = fetchEnabledFeatures;
+const mockedHttp = http;
 describe('lib/hasFeature', () => {
     describe('hasFeature()', () => {
         const accountId = 123;
-        beforeEach(() => {
+        afterEach(() => {
+            vi.clearAllMocks();
+        });
+        it('should return true if the feature is enabled', async () => {
             mockedFetchEnabledFeatures.mockResolvedValueOnce({
                 data: {
                     enabledFeatures: {
                         'feature-1': true,
-                        'feature-2': false,
-                        'feature-3': true,
                     },
                 },
             });
-        });
-        it('should return true if the feature is enabled', async () => {
             // @ts-expect-error test data
             const result = await hasFeature(accountId, 'feature-1');
             expect(result).toBe(true);
         });
-        it('should return false if the feature is not enabled', async () => {
+        it('should return false if the feature is disabled', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-2': false,
+                    },
+                },
+            });
             // @ts-expect-error test data
             const result = await hasFeature(accountId, 'feature-2');
             expect(result).toBe(false);
         });
         it('should return false if the feature is not present', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {},
+                },
+            });
             // @ts-expect-error test data
             const result = await hasFeature(accountId, 'feature-4');
             expect(result).toBe(false);
         });
+        it('should return true for APPS_HOME feature when not present in enabled features (defaults on)', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {},
+                },
+            });
+            const result = await hasFeature(accountId, FEATURES.APPS_HOME);
+            expect(result).toBe(true);
+        });
+        it('should respect explicit setting for APPS_HOME feature even when it defaults on', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        [FEATURES.APPS_HOME]: false,
+                    },
+                },
+            });
+            const result = await hasFeature(accountId, FEATURES.APPS_HOME);
+            expect(result).toBe(false);
+        });
+        it('should handle truthy values correctly', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-truthy': 'yes',
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const truthyResult = await hasFeature(accountId, 'feature-truthy');
+            expect(truthyResult).toBe(true);
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-number': 1,
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const numberResult = await hasFeature(accountId, 'feature-number');
+            expect(numberResult).toBe(true);
+        });
+        it('should handle falsy values correctly', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-null': null,
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const nullResult = await hasFeature(accountId, 'feature-null');
+            expect(nullResult).toBe(false);
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-zero': 0,
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const zeroResult = await hasFeature(accountId, 'feature-zero');
+            expect(zeroResult).toBe(false);
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-empty': '',
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const emptyResult = await hasFeature(accountId, 'feature-empty');
+            expect(emptyResult).toBe(false);
+        });
+        it('should propagate errors from fetchEnabledFeatures', async () => {
+            const error = new Error('API error');
+            mockedFetchEnabledFeatures.mockRejectedValueOnce(error);
+            await expect(hasFeature(accountId, FEATURES.UNIFIED_APPS)).rejects.toThrow('API error');
+        });
+    });
+    describe('hasUnfiedAppsAccess()', () => {
+        const accountId = 123;
+        afterEach(() => {
+            vi.clearAllMocks();
+        });
+        it('should return true when API returns true', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: true });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(true);
+            expect(mockedHttp.get).toHaveBeenCalledWith(accountId, {
+                url: 'developer-tooling/external/developer-portal/has-unified-dev-platform-access',
+            });
+        });
+        it('should return false when API returns false', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: false });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(false);
+        });
+        it('should handle truthy values correctly', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: 'yes' });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(true);
+        });
+        it('should handle falsy values correctly', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: null });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(false);
+        });
+        it('should handle undefined response data', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: undefined });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(false);
+        });
+        it('should propagate errors from http.get', async () => {
+            const error = new Error('Network error');
+            mockedHttp.get.mockRejectedValueOnce(error);
+            await expect(hasUnfiedAppsAccess(accountId)).rejects.toThrow('Network error');
+        });
     });
 });

package/lib/app/__tests__/migrate.test.js

@@ -1,7 +1,7 @@
 import { logger } from '@hubspot/local-dev-lib/logger';
 import { getCwd, sanitizeFileName } from '@hubspot/local-dev-lib/path';
 import { extractZipArchive } from '@hubspot/local-dev-lib/archive';
-import { validateUid, getProjectThemeDetails, } from '@hubspot/project-parsing-lib';
+import { validateUid } from '@hubspot/project-parsing-lib';
 import { UNMIGRATABLE_REASONS } from '@hubspot/local-dev-lib/constants/projects';
 import { MIGRATION_STATUS } from '@hubspot/local-dev-lib/types/Migration';
 import { downloadProject } from '@hubspot/local-dev-lib/api/projects';
@@ -12,7 +12,7 @@ import { poll } from '../../polling.js';
 import { CLI_UNMIGRATABLE_REASONS, continueAppMigration, initializeAppMigration, listAppsForMigration, } from '../../../api/migrate.js';
 import { lib } from '../../../lang/en.js';
 import { hasUnfiedAppsAccess } from '../../hasFeature.js';
-import { getUnmigratableReason, generateFilterAppsByProjectNameFunction, buildErrorMessageFromMigrationStatus, fetchMigrationApps, promptForAppToMigrate, selectAppToMigrate, handleMigrationSetup, getHasMigratableThemes, beginAppMigration, pollMigrationStatus, finalizeAppMigration, downloadProjectFiles, migrateApp2025_2, logInvalidAccountError, validateMigrationAppsAndThemes, } from '../migrate.js';
+import { getUnmigratableReason, generateFilterAppsByProjectNameFunction, buildErrorMessageFromMigrationStatus, fetchMigrationApps, promptForAppToMigrate, selectAppToMigrate, handleMigrationSetup, beginAppMigration, pollMigrationStatus, finalizeAppMigration, downloadProjectFiles, migrateApp2025_2, logInvalidAccountError, validateMigrationApps, } from '../migrate.js';
 vi.mock('@hubspot/local-dev-lib/logger');
 vi.mock('@hubspot/local-dev-lib/path');
 vi.mock('@hubspot/local-dev-lib/archive');
@@ -40,7 +40,6 @@ const mockedListPrompt = listPrompt;
 const mockedEnsureProjectExists = ensureProjectExists;
 const mockedPoll = poll;
 const mockedListAppsForMigration = listAppsForMigration;
-const mockedGetProjectThemeDetails = getProjectThemeDetails;
 const mockedInitializeAppMigration = initializeAppMigration;
 const mockedContinueAppMigration = continueAppMigration;
 const mockedHasUnfiedAppsAccess = hasUnfiedAppsAccess;
@@ -205,58 +204,31 @@ describe('lib/app/migrate', () => {
             expect(result.migratableApps[0].projectName).toBe(PROJECT_NAME);
         });
     });
-    describe('getHasMigratableThemes', () => {
-        it('should return false when no projectConfig is provided', async () => {
-            const result = await getHasMigratableThemes();
-            expect(result).toEqual({
-                hasMigratableThemes: false,
-                migratableThemesCount: 0,
-            });
-        });
-        it('should return true when there are migratable themes', async () => {
-            mockedGetProjectThemeDetails.mockResolvedValue({
-                legacyThemeDetails: [
-                    {
-                        configFilepath: 'src/theme.json',
-                        themePath: 'src/theme',
-                        themeConfig: {
-                            secret_names: ['my-secret'],
-                        },
-                    },
-                ],
-                legacyReactThemeDetails: [],
-            });
-            const projectConfig = createLoadedProjectConfig(PROJECT_NAME);
-            const result = await getHasMigratableThemes(projectConfig);
-            expect(result).toEqual({
-                hasMigratableThemes: true,
-                migratableThemesCount: 1,
-            });
-        });
-    });
-    describe('validateMigrationAppsAndThemes', () => {
+    describe('validateMigrationApps', () => {
         const mockMigratableApp1 = createMockMigratableApp(1, 'App 1', PROJECT_NAME);
         const mockMigratableApp2 = createMockMigratableApp(2, 'App 2', PROJECT_NAME);
         it('should throw an error when multiple apps are found for a project', async () => {
             const projectConfig = createLoadedProjectConfig(PROJECT_NAME);
-            await expect(validateMigrationAppsAndThemes(APP_ID, ACCOUNT_ID, {
+            await expect(validateMigrationApps(APP_ID, ACCOUNT_ID, {
                 migratableApps: [mockMigratableApp1, mockMigratableApp2],
                 unmigratableApps: [],
-            }, false, projectConfig)).rejects.toThrow(lib.migrate.errors.project.multipleApps);
-        });
-        it('should throw an error when cms themes are found for a project', async () => {
-            const projectConfig = createLoadedProjectConfig(PROJECT_NAME);
-            await expect(validateMigrationAppsAndThemes(APP_ID, ACCOUNT_ID, { migratableApps: [mockMigratableApp1], unmigratableApps: [] }, true, projectConfig)).rejects.toThrow(lib.migrate.errors.project.themesAndAppsNotAllowed);
+            }, projectConfig)).rejects.toThrow(lib.migrate.errors.project.multipleApps);
         });
         it('should throw an error when no apps are found for a project', async () => {
             const projectConfig = createLoadedProjectConfig(PROJECT_NAME);
-            await expect(validateMigrationAppsAndThemes(APP_ID, ACCOUNT_ID, { migratableApps: [], unmigratableApps: [] }, false, projectConfig)).rejects.toThrow(lib.migrate.errors.noAppsForProject(PROJECT_NAME));
+            await expect(validateMigrationApps(APP_ID, ACCOUNT_ID, { migratableApps: [], unmigratableApps: [] }, projectConfig)).rejects.toThrow(lib.migrate.errors.noAppsForProject(PROJECT_NAME));
         });
         it('should throw an error when no migratable apps are found', async () => {
-            await expect(validateMigrationAppsAndThemes(APP_ID, ACCOUNT_ID, { migratableApps: [], unmigratableApps: mockUnmigratableApps }, false)).rejects.toThrow(/No apps in account/);
+            await expect(validateMigrationApps(APP_ID, ACCOUNT_ID, {
+                migratableApps: [],
+                unmigratableApps: mockUnmigratableApps,
+            })).rejects.toThrow(/No apps in account/);
         });
         it('should throw an error when appId is provided but not found', async () => {
-            await expect(validateMigrationAppsAndThemes(APP_ID, ACCOUNT_ID, { migratableApps: [], unmigratableApps: [] }, false)).rejects.toThrow(/No apps in account/);
+            await expect(validateMigrationApps(APP_ID, ACCOUNT_ID, {
+                migratableApps: [],
+                unmigratableApps: [],
+            })).rejects.toThrow(/No apps in account/);
         });
     });
     describe('promptForAppToMigrate', () => {
@@ -330,10 +302,6 @@ describe('lib/app/migrate', () => {
                     unmigratableApps: [],
                 },
             });
-            mockedGetProjectThemeDetails.mockResolvedValue({
-                legacyThemeDetails: [],
-                legacyReactThemeDetails: [],
-            });
             mockedListPrompt.mockResolvedValue({ appId: 1 });
             mockedConfirmPrompt.mockResolvedValue(true);
             mockedEnsureProjectExists.mockResolvedValue({ projectExists: false });
@@ -352,16 +320,11 @@ describe('lib/app/migrate', () => {
                     unmigratableApps: [],
                 },
             });
-            mockedGetProjectThemeDetails.mockResolvedValueOnce({
-                legacyThemeDetails: [],
-                legacyReactThemeDetails: [],
-            });
             const result = await handleMigrationSetup(ACCOUNT_ID, defaultOptions, projectConfig);
             expect(result).toEqual({
                 appIdToMigrate: 1,
                 projectName: PROJECT_NAME,
                 projectDest: MOCK_PROJECT_DIR,
-                isThemesMigration: false,
             });
         });
         it('should prompt for project name when not provided', async () => {

package/lib/app/migrate.d.ts

@@ -12,18 +12,14 @@ export type MigrateAppArgs = CommonArgs & AccountArgs & EnvironmentArgs & Config
 export declare function getUnmigratableReason(reasonCode: string, projectName: string | undefined, accountId: number): string;
 export declare function generateFilterAppsByProjectNameFunction(projectConfig?: LoadedProjectConfig): (app: MigrationApp) => boolean;
 export declare function buildErrorMessageFromMigrationStatus(error: MigrationFailed): string;
-export declare function getHasMigratableThemes(projectConfig?: LoadedProjectConfig): Promise<{
-    hasMigratableThemes: boolean;
-    migratableThemesCount: number;
-}>;
 export declare function fetchMigrationApps(derivedAccountId: number, platformVersion: string, projectConfig?: LoadedProjectConfig): Promise<{
     migratableApps: MigratableApp[];
     unmigratableApps: UnmigratableApp[];
 }>;
-export declare function validateMigrationAppsAndThemes(appId: MigrateAppArgs['appId'], derivedAccountId: number, { migratableApps, unmigratableApps, }: {
+export declare function validateMigrationApps(appId: MigrateAppArgs['appId'], derivedAccountId: number, { migratableApps, unmigratableApps, }: {
     migratableApps: MigratableApp[];
     unmigratableApps: UnmigratableApp[];
-}, hasMigratableThemes: boolean, projectConfig?: LoadedProjectConfig): Promise<void>;
+}, projectConfig?: LoadedProjectConfig): Promise<void>;
 export declare function promptForAppToMigrate(allApps: MigrationApp[], derivedAccountId: number): Promise<number>;
 export declare function selectAppToMigrate(allApps: MigrationApp[], derivedAccountId: number, appId?: number): Promise<{
     proceed: boolean;
@@ -33,9 +29,7 @@ export declare function handleMigrationSetup(derivedAccountId: number, options:
     appIdToMigrate?: number | undefined;
     projectName?: string;
     projectDest?: string;
-    isThemesMigration?: boolean;
 }>;
-export declare function handleThemesMigration(projectConfig: LoadedProjectConfig, platformVersion: string): Promise<void>;
 export declare function beginAppMigration(derivedAccountId: number, appId: number, platformVersion: string): Promise<{
     migrationId: number;
     uidMap: Record<string, string>;

package/lib/app/migrate.js

@@ -2,7 +2,7 @@ import path from 'path';
 import { getCwd, sanitizeFileName } from '@hubspot/local-dev-lib/path';
 import { extractZipArchive } from '@hubspot/local-dev-lib/archive';
 import chalk from 'chalk';
-import { validateUid, migrateThemes, getProjectThemeDetails, } from '@hubspot/project-parsing-lib';
+import { validateUid } from '@hubspot/project-parsing-lib';
 import { UNMIGRATABLE_REASONS } from '@hubspot/local-dev-lib/constants/projects';
 import { mapToUserFacingType } from '@hubspot/project-parsing-lib/src/lib/transform.js';
 import { MIGRATION_STATUS } from '@hubspot/local-dev-lib/types/Migration';
@@ -10,19 +10,15 @@ import { downloadProject } from '@hubspot/local-dev-lib/api/projects';
 import { Separator } from '@inquirer/prompts';
 import { confirmPrompt, inputPrompt, listPrompt, } from '../prompts/promptUtils.js';
 import { uiAccountDescription, uiCommandReference, uiLine, uiLink, } from '../ui/index.js';
-import { writeProjectConfig } from '../projects/config.js';
 import { ensureProjectExists } from '../projects/ensureProjectExists.js';
 import SpinniesManager from '../ui/SpinniesManager.js';
 import { DEFAULT_POLLING_STATUS_LOOKUP, poll } from '../polling.js';
 import { checkMigrationStatusV2, CLI_UNMIGRATABLE_REASONS, continueAppMigration, initializeAppMigration, isMigrationStatus, listAppsForMigration, } from '../../api/migrate.js';
 import fs from 'fs';
 import { lib } from '../../lang/en.js';
-import { PROJECT_CONFIG_FILE } from '../constants.js';
 import { hasUnfiedAppsAccess } from '../hasFeature.js';
 import { getProjectBuildDetailUrl, getProjectDetailUrl, } from '../projects/urls.js';
 import { uiLogger } from '../ui/logger.js';
-import { debugError } from '../errorHandlers/index.js';
-import { useV3Api } from '../projects/platformVersion.js';
 export function getUnmigratableReason(reasonCode, projectName, accountId) {
     switch (reasonCode) {
         case UNMIGRATABLE_REASONS.UP_TO_DATE:
@@ -59,17 +55,6 @@ export function buildErrorMessageFromMigrationStatus(error) {
     })
         .join('\n\t- ')}`;
 }
-export async function getHasMigratableThemes(projectConfig) {
-    if (!projectConfig?.projectConfig?.name || !projectConfig?.projectDir) {
-        return { hasMigratableThemes: false, migratableThemesCount: 0 };
-    }
-    const projectSrcDir = path.resolve(projectConfig.projectDir, projectConfig.projectConfig.srcDir);
-    const { legacyThemeDetails, legacyReactThemeDetails } = await getProjectThemeDetails(projectSrcDir);
-    return {
-        hasMigratableThemes: legacyThemeDetails.length > 0 || legacyReactThemeDetails.length > 0,
-        migratableThemesCount: legacyThemeDetails.length + legacyReactThemeDetails.length,
-    };
-}
 export async function fetchMigrationApps(derivedAccountId, platformVersion, projectConfig) {
     const { data: { migratableApps, unmigratableApps }, } = await listAppsForMigration(derivedAccountId, platformVersion);
     const filteredMigratableApps = migratableApps.filter(generateFilterAppsByProjectNameFunction(projectConfig));
@@ -79,23 +64,11 @@ export async function fetchMigrationApps(derivedAccountId, platformVersion, proj
         unmigratableApps: filteredUnmigratableApps,
     };
 }
-export async function validateMigrationAppsAndThemes(appId, derivedAccountId, { migratableApps, unmigratableApps, }, hasMigratableThemes, projectConfig) {
+export async function validateMigrationApps(appId, derivedAccountId, { migratableApps, unmigratableApps, }, projectConfig) {
     const allApps = [...migratableApps, ...unmigratableApps];
     if (allApps.length > 1 && projectConfig) {
         throw new Error(lib.migrate.errors.project.multipleApps);
     }
-    if (hasMigratableThemes) {
-        if (useV3Api(projectConfig?.projectConfig?.platformVersion)) {
-            throw new Error(lib.migrate.errors.project.themesAlreadyMigrated);
-        }
-        if (allApps.length > 0 && projectConfig) {
-            throw new Error(lib.migrate.errors.project.themesAndAppsNotAllowed);
-        }
-        if (!projectConfig) {
-            throw new Error(lib.migrate.errors.project.noProjectForThemesMigration);
-        }
-        return;
-    }
     if (!projectConfig?.projectConfig) {
         allApps.forEach(app => {
             if (app.projectName) {
@@ -178,35 +151,20 @@ export async function handleMigrationSetup(derivedAccountId, options, projectCon
         text: lib.migrate.spinners.checkingForMigratableComponents,
     });
     const { name, dest, appId } = options;
-    const { hasMigratableThemes, migratableThemesCount } = await getHasMigratableThemes(projectConfig);
     const { migratableApps, unmigratableApps } = await fetchMigrationApps(derivedAccountId, options.platformVersion, projectConfig);
     SpinniesManager.remove('checkingForMigratableComponents');
-    await validateMigrationAppsAndThemes(appId, derivedAccountId, { migratableApps, unmigratableApps }, hasMigratableThemes, projectConfig);
+    await validateMigrationApps(appId, derivedAccountId, { migratableApps, unmigratableApps }, projectConfig);
     const allApps = [...migratableApps, ...unmigratableApps];
-    let proceed = false;
-    let appIdToMigrate;
-    if (hasMigratableThemes) {
-        uiLogger.log(lib.migrate.prompt.themesMigration(migratableThemesCount));
-        proceed = await confirmPrompt(lib.migrate.prompt.proceed, {
-            defaultAnswer: false,
-        });
-    }
-    else {
-        const appSelectionPrompt = await selectAppToMigrate(allApps, derivedAccountId, appId);
-        appIdToMigrate = appSelectionPrompt.appIdToMigrate;
-        proceed = appSelectionPrompt.proceed;
-    }
+    const { proceed, appIdToMigrate } = await selectAppToMigrate(allApps, derivedAccountId, appId);
     if (!proceed) {
         return {};
     }
     // If it's a project we don't want to prompt for dest and name, so just return early
-    // Theme migrations can only be initiated from the project directory
     if (projectConfig &&
         projectConfig?.projectConfig &&
         projectConfig?.projectDir) {
         return {
             appIdToMigrate,
-            isThemesMigration: hasMigratableThemes,
             projectName: projectConfig.projectConfig.name,
             projectDest: projectConfig.projectDir,
         };
@@ -231,35 +189,6 @@ export async function handleMigrationSetup(derivedAccountId, options, projectCon
         }));
     return { appIdToMigrate, projectName, projectDest };
 }
-export async function handleThemesMigration(projectConfig, platformVersion) {
-    if (!projectConfig?.projectDir || !projectConfig?.projectConfig?.srcDir) {
-        throw new Error(lib.migrate.errors.project.invalidConfig);
-    }
-    const projectSrcDir = path.resolve(projectConfig.projectDir, projectConfig.projectConfig.srcDir);
-    let migrated = false;
-    let failureReason;
-    try {
-        const migrationResult = await migrateThemes(projectConfig.projectDir, projectSrcDir);
-        migrated = migrationResult.migrated;
-        failureReason = migrationResult.failureReason;
-    }
-    catch (error) {
-        debugError(error);
-        throw new Error(lib.migrate.errors.project.failedToMigrateThemes);
-    }
-    if (!migrated) {
-        throw new Error(failureReason || lib.migrate.errors.project.failedToMigrateThemes);
-    }
-    const newProjectConfig = { ...projectConfig.projectConfig };
-    newProjectConfig.platformVersion = platformVersion;
-    const projectConfigPath = path.join(projectConfig.projectDir, PROJECT_CONFIG_FILE);
-    const success = writeProjectConfig(projectConfigPath, newProjectConfig);
-    if (!success) {
-        throw new Error(lib.migrate.errors.project.failedToUpdateProjectConfig);
-    }
-    uiLogger.log('');
-    uiLogger.log(lib.migrate.success.themesMigrationSuccess(platformVersion));
-}
 export async function beginAppMigration(derivedAccountId, appId, platformVersion) {
     SpinniesManager.add('beginningMigration', {
         text: lib.migrate.spinners.beginningMigration,
@@ -412,11 +341,7 @@ export async function migrateApp2025_2(derivedAccountId, options, projectConfig)
             throw new Error(lib.migrate.errors.project.doesNotExist(derivedAccountId));
         }
     }
-    const { appIdToMigrate, projectName, projectDest, isThemesMigration } = await handleMigrationSetup(derivedAccountId, options, projectConfig);
-    if (isThemesMigration) {
-        await handleThemesMigration(projectConfig, options.platformVersion);
-        return;
-    }
+    const { appIdToMigrate, projectName, projectDest } = await handleMigrationSetup(derivedAccountId, options, projectConfig);
     if (!appIdToMigrate || !projectName || !projectDest) {
         return;
     }

package/lib/constants.d.ts

@@ -81,17 +81,25 @@ export declare const FEATURES: {
     readonly SANDBOXES_V2: "sandboxes:v2:enabled";
     readonly SANDBOXES_V2_CLI: "sandboxes:v2:cliEnabled";
     readonly APP_EVENTS: "Developers:UnifiedApps:AppEventsAccess";
+    readonly APPS_HOME: "UIE:AppHome";
+    readonly MCP_ACCESS: "Developers:CLIMCPAccess";
+    readonly THEME_MIGRATION_2025_2: "Developers:ProjectThemeMigrations:2025.2";
+    readonly AGENT_TOOLS: "ThirdPartyAgentTools";
 };
 export declare const LOCAL_DEV_UI_MESSAGE_SEND_TYPES: {
     UPLOAD_SUCCESS: string;
     UPLOAD_FAILURE: string;
+    DEPLOY_SUCCESS: string;
+    DEPLOY_FAILURE: string;
     UPDATE_PROJECT_NODES: string;
     UPDATE_APP_DATA: string;
     UPDATE_PROJECT_DATA: string;
     UPDATE_UPLOAD_WARNINGS: string;
+    CLI_METADATA: string;
 };
 export declare const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES: {
     UPLOAD: string;
+    DEPLOY: string;
     VIEWED_WELCOME_SCREEN: string;
 };
 export declare const APP_INSTALLATION_STATES: {