@hubspot/cli 8.4.0 → 8.5.0-beta.1

package/api/migrate.js

@@ -1,4 +1,4 @@
-import { PLATFORM_VERSIONS, } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { http } from '@hubspot/local-dev-lib/http';
 const MIGRATIONS_API_PATH_V2 = 'dfs/migrations/v2';
 export const CLI_UNMIGRATABLE_REASONS = {
@@ -20,8 +20,8 @@ export async function listAppsForMigration(accountId, platformVersion, appId) {
     });
 }
 function mapPlatformVersionToEnum(platformVersion) {
-    if (platformVersion === PLATFORM_VERSIONS.unstable) {
-        return PLATFORM_VERSIONS.unstable.toUpperCase();
+    if (platformVersion === PLATFORM_VERSIONS.UNSTABLE) {
+        return PLATFORM_VERSIONS.UNSTABLE.toUpperCase();
     }
     const reformattedPlatformVersion = platformVersion
         .replaceAll('.', '_')

package/bin/cli.js

@@ -35,6 +35,7 @@ import apiCommand from '../commands/api.js';
 import { uiLogger } from '../lib/ui/logger.js';
 import { initializeSpinniesManager } from '../lib/middleware/spinniesMiddleware.js';
 import { addCommandSuggestions } from '../lib/commandSuggestion.js';
+import { pkg } from '../lib/jsonLoader.js';
 function getTerminalWidth() {
     const width = yargs().terminalWidth();
     if (width >= 100)
@@ -121,6 +122,8 @@ const argv = yargs(process.argv.slice(2))
 const argvWithSuggestions = addCommandSuggestions(argv)
     .help()
     .alias('h', 'help')
+    .version(pkg.version)
+    .alias('v', 'version')
     .recommendCommands()
     .demandCommand(1, '')
     .wrap(getTerminalWidth())

package/commands/app/migrate.js

@@ -1,5 +1,5 @@
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { trackCommandMetadataUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
@@ -9,7 +9,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { migrateApp } from '../../lib/app/migrate.js';
 import { getIsInProject } from '../../lib/projects/config.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-const { v2025_2, v2026_03_beta, v2026_03 } = PLATFORM_VERSIONS;
+const { v2025_2, v2026_03_BETA, v2026_03 } = PLATFORM_VERSIONS;
 const command = 'migrate';
 const describe = commands.project.migrateApp.describe;
 export function handlerGenerator(commandTrackingName) {
@@ -29,7 +29,7 @@ export function handlerGenerator(commandTrackingName) {
                 return exit(EXIT_CODES.ERROR);
             }
             args.platformVersion = unstable
-                ? PLATFORM_VERSIONS.unstable
+                ? PLATFORM_VERSIONS.UNSTABLE
                 : platformVersion;
             await migrateApp(derivedAccountId, args);
         }
@@ -67,7 +67,7 @@ function appMigrateBuilder(yargs) {
         },
         'platform-version': {
             type: 'string',
-            choices: [v2025_2, v2026_03_beta, v2026_03],
+            choices: [v2025_2, v2026_03_BETA, v2026_03],
             default: v2026_03,
         },
         unstable: {

package/commands/getStarted.js

@@ -16,7 +16,6 @@ import { uiLogger } from '../lib/ui/logger.js';
 import { trackCommandMetadataUsage } from '../lib/usageTracking.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { makeYargsHandlerWithUsageTracking } from '../lib/yargs/makeYargsHandlerWithUsageTracking.js';
-import { isV2Project } from '../lib/projects/platformVersion.js';
 import { pollProjectBuildAndDeploy } from '../lib/projects/pollProjectBuildAndDeploy.js';
 import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
@@ -24,6 +23,7 @@ import { getStaticAuthAppInstallUrl } from '../lib/app/urls.js';
 import ProjectValidationError from '../lib/errors/ProjectValidationError.js';
 import { openLink } from '../lib/links.js';
 import { runGetStartedV2 } from '../lib/getStarted/getStartedV2.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 const command = 'get-started';
 const describe = commands.getStarted.describe;
 async function handler(args) {
@@ -204,7 +204,7 @@ async function handler(args) {
                     uploadMessage: 'Initial upload from get-started command',
                     forceCreate: true, // Auto-create project on HubSpot
                     isUploadCommand: false,
-                    sendIR: isV2Project(newProjectConfig.platformVersion),
+                    sendIR: !isLegacyProject(newProjectConfig.platformVersion),
                     skipValidation: false,
                 });
                 if (uploadError) {

package/commands/project/add.js

@@ -5,7 +5,7 @@ import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { legacyAddComponent } from '../../lib/projects/add/legacyAddComponent.js';
 import { v2AddComponent } from '../../lib/projects/add/v2AddComponent.js';
 import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, } from '../../lib/constants.js';
@@ -20,8 +20,8 @@ async function handler(args) {
             uiLogger.error(commands.project.add.error.locationInProject);
             return exit(EXIT_CODES.ERROR);
         }
-        const isV2ProjectCreate = isV2Project(projectConfig.platformVersion);
-        if (isV2ProjectCreate) {
+        const isLegacyProjectCreate = isLegacyProject(projectConfig.platformVersion);
+        if (!isLegacyProjectCreate) {
             await v2AddComponent(args, projectDir, projectConfig, derivedAccountId);
         }
         else {

package/commands/project/create.js

@@ -2,25 +2,23 @@ import path from 'path';
 import fs from 'fs-extra';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
 import { getCwd } from '@hubspot/local-dev-lib/path';
+import { getProjectMetadata, } from '@hubspot/project-parsing-lib/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { writeProjectConfig, getProjectConfig, } from '../../lib/projects/config.js';
 import { EMPTY_PROJECT_TEMPLATE_NAME } from '../../lib/projects/create/legacy.js';
 import { generateComponentPaths } from '../../lib/projects/create/v2.js';
-import { PROJECT_WITH_APP, EMPTY_PROJECT } from '../../lib/constants.js';
 import { debugError, logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
-import { PROJECT_CONFIG_FILE, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, marketplaceDistribution, privateDistribution, oAuth, staticAuth, DEFAULT_PROJECT_TEMPLATE_BRANCH, } from '../../lib/constants.js';
+import { PROJECT_CONFIG_FILE, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, marketplaceDistribution, privateDistribution, oAuth, staticAuth, DEFAULT_PROJECT_TEMPLATE_BRANCH, PROJECT_WITH_APP, EMPTY_PROJECT, } from '../../lib/constants.js';
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { handleProjectCreationFlow, } from '../../lib/projects/create/index.js';
-import { getProjectMetadata, } from '@hubspot/project-parsing-lib/projects';
 import { updateHsMetaFilesWithAutoGeneratedFields } from '../../lib/projects/components.js';
 import SpinniesManager from '../../lib/ui/SpinniesManager.js';
 const command = ['create', 'init'];
 const describe = commands.project.create.describe;
-const { v2025_1, v2025_2, v2026_03_beta, v2026_03 } = PLATFORM_VERSIONS;
 async function handler(args) {
     const { platformVersion, templateSource, exit, addUsageMetadata } = args;
     if (templateSource && !templateSource.includes('/')) {
@@ -125,8 +123,13 @@ function projectCreateBuilder(yargs) {
         'platform-version': {
             describe: commands.project.create.options.platformVersion.describe,
             type: 'string',
-            choices: [v2025_1, v2025_2, v2026_03_beta, v2026_03],
-            default: v2026_03,
+            choices: [
+                PLATFORM_VERSIONS.v2025_1,
+                PLATFORM_VERSIONS.v2025_2,
+                PLATFORM_VERSIONS.v2026_03_BETA,
+                PLATFORM_VERSIONS.v2026_03,
+            ],
+            default: PLATFORM_VERSIONS.v2026_03,
         },
         'project-base': {
             describe: commands.project.create.options.projectBase.describe,

package/commands/project/delete.js

@@ -5,7 +5,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { renderInline } from '../../ui/render.js';
 import { getWarningBox } from '../../ui/components/StatusMessageBoxes.js';
 import { commands } from '../../lang/en.js';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { resolveProjectName, checkDeployedComponents, deleteDeployedComponents, confirmDeletion, handleProjectDeletion, } from '../../lib/projects/delete.js';
 const command = 'delete';
@@ -23,7 +23,7 @@ async function handler(args) {
         if (!force) {
             await confirmDeletion(projectName, derivedAccountId, projectId);
         }
-        if (isV2Project(platformVersion) && hasUnifiedComponents) {
+        if (!isLegacyProject(platformVersion) && hasUnifiedComponents) {
             await deleteDeployedComponents(derivedAccountId, projectName);
         }
         await handleProjectDeletion(derivedAccountId, projectName);

package/commands/project/deploy.js

@@ -1,7 +1,7 @@
 import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { projectNamePrompt } from '../../lib/prompts/projectNamePrompt.js';
@@ -31,7 +31,8 @@ async function handler(args) {
         isInProjectDirectory = true;
     }
     catch (e) { }
-    if (isInProjectDirectory && isV2Project(projectConfig?.platformVersion)) {
+    if (isInProjectDirectory &&
+        !isLegacyProject(projectConfig?.platformVersion)) {
         try {
             const profileName = await projectProfilePrompt(projectDir, projectConfig, profileOption, !!useEnvOption);
             if (profileName) {
@@ -97,7 +98,7 @@ async function handler(args) {
             uiLogger.error(commands.project.deploy.errors.noBuildId);
             return exit(EXIT_CODES.ERROR);
         }
-        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isV2Project(projectConfig?.platformVersion), forceOption);
+        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isLegacyProject(projectConfig?.platformVersion), forceOption);
         if (!deployResult) {
             return exit(EXIT_CODES.ERROR);
         }

package/commands/project/dev/index.js

@@ -5,7 +5,7 @@ import { uiLine } from '../../../lib/ui/index.js';
 import { makeYargsHandlerWithUsageTracking } from '../../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { deprecatedProjectDevFlow } from './deprecatedFlow.js';
 import { unifiedProjectDevFlow } from './unifiedFlow.js';
-import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { loadAndValidateProfile } from '../../../lib/projects/projectProfiles.js';
 import { commands } from '../../../lang/en.js';
@@ -34,7 +34,7 @@ async function handler(args) {
         logError(error);
         return exit(EXIT_CODES.ERROR);
     }
-    const useV2Projects = isV2Project(projectConfig.platformVersion);
+    const useV2Projects = !isLegacyProject(projectConfig.platformVersion);
     if (!projectDir) {
         uiLogger.error(commands.project.dev.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
@@ -69,7 +69,8 @@ async function handler(args) {
         targetProjectAccountId = derivedAccountId;
     }
     // Determine profile name: from flag or prompt
-    if (!targetProjectAccountId && isV2Project(projectConfig.platformVersion)) {
+    if (!targetProjectAccountId &&
+        !isLegacyProject(projectConfig.platformVersion)) {
         const profileName = await projectProfilePrompt(projectDir, projectConfig, profileOption);
         if (profileName) {
             try {
@@ -95,7 +96,7 @@ async function handler(args) {
     }
     addUsageMetadata({ accountId: targetProjectAccountId ?? undefined });
     try {
-        if (isV2Project(projectConfig.platformVersion)) {
+        if (!isLegacyProject(projectConfig.platformVersion)) {
             const targetTestingAccountId = testingAccount
                 ? getConfigAccountIfExists(testingAccount)?.accountId
                 : undefined;

package/commands/project/info.js

@@ -6,7 +6,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { commands } from '../../lang/en.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { getProjectInfo, logProjectInfo, } from '../../lib/projects/projectInfo.js';
 const command = 'info';
 const describe = commands.project.info.describe;
@@ -18,7 +18,7 @@ async function handler(args) {
         uiLogger.error(commands.project.info.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.info.errors.unsupportedPlatformVersion(projectConfig.platformVersion));
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/migrate.js

@@ -1,7 +1,7 @@
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { migrateApp } from '../../lib/app/migrate.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
@@ -14,7 +14,7 @@ import { getHasMigratableThemes, migrateThemesV2, } from '../../lib/theme/migrat
 import { hasFeature } from '../../lib/hasFeature.js';
 import { FEATURES } from '../../lib/constants.js';
 import { trackCommandMetadataUsage } from '../../lib/usageTracking.js';
-const { v2025_2, v2026_03_beta, v2026_03 } = PLATFORM_VERSIONS;
+const { v2025_2, v2026_03_BETA, v2026_03 } = PLATFORM_VERSIONS;
 const command = 'migrate';
 const describe = commands.project.migrate.describe;
 async function handler(args) {
@@ -41,7 +41,7 @@ async function handler(args) {
             await migrateThemesV2(derivedAccountId, {
                 ...args,
                 platformVersion: unstable
-                    ? PLATFORM_VERSIONS.unstable
+                    ? PLATFORM_VERSIONS.UNSTABLE
                     : platformVersion,
             }, migratableThemesCount, projectConfig);
         }
@@ -50,7 +50,7 @@ async function handler(args) {
                 ...args,
                 name: projectConfig?.projectConfig?.name,
                 platformVersion: unstable
-                    ? PLATFORM_VERSIONS.unstable
+                    ? PLATFORM_VERSIONS.UNSTABLE
                     : platformVersion,
             }, projectConfig);
         }
@@ -67,7 +67,7 @@ function projectMigrateBuilder(yargs) {
     yargs
         .option('platform-version', {
         type: 'string',
-        choices: [v2025_2, v2026_03_beta, v2026_03],
+        choices: [v2025_2, v2026_03_BETA, v2026_03],
         default: v2026_03,
     })
         .option('unstable', {

package/commands/project/profile/add.js

@@ -3,7 +3,7 @@ import fs from 'fs';
 import { getConfigAccountIfExists, getAllConfigAccounts, } from '@hubspot/local-dev-lib/config';
 import { getAllHsProfiles, getHsProfileFilename, loadHsProfileFile, } from '@hubspot/project-parsing-lib/profiles';
 import { getProjectConfig } from '../../../lib/projects/config.js';
-import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { uiAccountDescription } from '../../../lib/ui/index.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
@@ -57,7 +57,7 @@ async function handler(args) {
         uiLogger.error(commands.project.profile.add.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.profile.add.errors.unsupportedPlatformVersion);
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/profile/delete.js

@@ -4,7 +4,7 @@ import { getAllHsProfiles, getHsProfileFilename, loadHsProfileFile, } from '@hub
 import { fetchProject, deleteProject, } from '@hubspot/local-dev-lib/api/projects';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { getProjectConfig } from '../../../lib/projects/config.js';
-import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsHandlerWithUsageTracking } from '../../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
@@ -23,7 +23,7 @@ async function handler(args) {
         uiLogger.error(commands.project.profile.delete.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.profile.delete.errors.unsupportedPlatformVersion);
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/upload.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { logFeedbackMessage } from '../../lib/projects/ui.js';
 import { handleProjectUpload } from '../../lib/projects/upload.js';
@@ -34,7 +34,7 @@ async function handler(args) {
     }
     let targetAccountId;
     let profileName = args.profile;
-    if (isV2Project(projectConfig?.platformVersion)) {
+    if (!isLegacyProject(projectConfig?.platformVersion)) {
         try {
             const profileNamePromptResult = await projectProfilePrompt(projectDir, projectConfig, profileOption, !!useEnvOption);
             if (profileNamePromptResult) {
@@ -64,7 +64,7 @@ async function handler(args) {
             uploadMessage: message,
             forceCreate,
             isUploadCommand: true,
-            sendIR: isV2Project(projectConfig.platformVersion),
+            sendIR: !isLegacyProject(projectConfig.platformVersion),
             skipValidation,
             profile: profileName,
         });

package/commands/project/validate.js

@@ -1,6 +1,6 @@
 import path from 'path';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
@@ -24,7 +24,7 @@ async function handler(args) {
         uiLogger.error(commands.project.validate.mustBeRanWithinAProject);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.validate.badVersion);
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/watch.js

@@ -1,6 +1,6 @@
 import { cancelStagedBuild, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { commands } from '../../lang/en.js';
 import { createWatcher } from '../../lib/projects/watch.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
@@ -62,7 +62,7 @@ async function handler(args) {
         uiLogger.error(commands.project.watch.errors.projectConfigNotFound);
         return exit(EXIT_CODES.ERROR);
     }
-    if (isV2Project(projectConfig.platformVersion)) {
+    if (!isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.watch.errors.v2ApiError(projectConfig.platformVersion));
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project.js

@@ -21,7 +21,7 @@ import info from './project/info.js';
 import deleteProject from './project/delete.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { getProjectConfig } from '../lib/projects/config.js';
-import { isUnsupportedPlatformVersion, LATEST_SUPPORTED_PLATFORM_VERSION, } from '../lib/projects/platformVersion.js';
+import { isSupportedPlatformVersion, LATEST_SUPPORTED_PLATFORM_VERSION, } from '@hubspot/project-parsing-lib/projects';
 import { uiLogger } from '../lib/ui/logger.js';
 import { debugError } from '../lib/errorHandlers/index.js';
 const command = ['project', 'projects'];
@@ -31,8 +31,11 @@ const describe = commands.project.describe;
 async function validatePlatformVersion() {
     try {
         const { projectConfig } = await getProjectConfig();
-        if (isUnsupportedPlatformVersion(projectConfig?.platformVersion)) {
-            uiLogger.warn(lib.projects.platformVersion.unsupported(pkg.version, LATEST_SUPPORTED_PLATFORM_VERSION, projectConfig?.platformVersion));
+        // Only warn if a platform version is explicitly set but not supported
+        // Don't warn if the platform version is missing/undefined
+        if (projectConfig?.platformVersion &&
+            !isSupportedPlatformVersion(projectConfig.platformVersion)) {
+            uiLogger.warn(lib.projects.platformVersion.unsupported(pkg.version, LATEST_SUPPORTED_PLATFORM_VERSION, projectConfig.platformVersion));
             uiLogger.log('');
         }
     }

package/commands/testAccount/create.js

@@ -44,14 +44,14 @@ function readConfigFile(configPath) {
 async function promptForConfigPath() {
     const createTestAccountFromConfig = await listPrompt(commands.testAccount.create.createTestAccountFromConfigPrompt, {
         choices: [
-            {
-                name: commands.testAccount.create.createFromConfigOption,
-                value: true,
-            },
             {
                 name: commands.testAccount.create.createFromScratchOption,
                 value: false,
             },
+            {
+                name: commands.testAccount.create.createFromConfigOption,
+                value: true,
+            },
         ],
     });
     if (createTestAccountFromConfig) {

package/lang/en.d.ts

@@ -1684,6 +1684,7 @@ export declare const commands: {
                 noFunctionsLinkText: string;
                 noFunctionsInProject: string;
                 noFunctionWithName: (name: string) => string;
+                functionNameRequired: string;
                 functionNotDeployed: (name: string) => string;
                 projectLogsManagerNotInitialized: string;
                 noDeployedBuild: string;
@@ -3279,6 +3280,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: {
@@ -4027,6 +4037,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';
@@ -1321,7 +1321,7 @@ export const commands = {
         },
     },
     api: {
-        describe: 'Make an authenticated HTTP request to the HubSpot 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: {
@@ -1450,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: {
@@ -1700,6 +1700,7 @@ export const commands = {
                 noFunctionsLinkText: 'Visit developer docs',
                 noFunctionsInProject: `There aren't any functions in this project\n\t- Run ${uiCommandReference('hs project logs --help')} to learn more about logs\n\t- ${uiLink('Visit developer docs', 'https://developers.hubspot.com/docs/platform/serverless-functions')} to learn more about serverless functions`,
                 noFunctionWithName: (name) => `No function with name "${name}"`,
+                functionNameRequired: `A function name is required. Pass ${uiCommandReference('--function=<name>')} or run without it to select one interactively.`,
                 functionNotDeployed: (name) => `The function with name "${name}" is not deployed`,
                 projectLogsManagerNotInitialized: 'Function called on ProjectLogsManager before initialization',
                 noDeployedBuild: 'This project has not been deployed yet. Deploy the project first, then try again.',
@@ -2324,7 +2325,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}`,
@@ -3299,6 +3300,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: {
@@ -4047,6 +4057,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),
@@ -4061,7 +4072,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/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/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',
 };