@hubspot/cli 8.2.0 → 8.2.1-experimental.0

package/lang/en.js

@@ -1,12 +1,12 @@
 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';
-import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, } from '../lib/projects/urls.js';
+import { APP_AUTH_TYPES, APP_DISTRIBUTION_TYPES, LEGACY_PUBLIC_APP_FILE, LOCAL_DEV_DEFAULT_PORT, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, } from '../lib/constants.js';
+import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, } from '@hubspot/local-dev-lib/constants/config';
+import { indent, UI_COLORS, uiAccountDescription, uiAuthCommandReference, uiBetaTag, uiCommandReference, uiDeprecatedTag, uiLink, } from '../lib/ui/index.js';
+import { getLocalDevUiUrl, getProjectDetailUrl, getProjectSettingsUrl, } from '../lib/projects/urls.js';
 import { getProductUpdatesUrl } from '../lib/links.js';
-import { APP_DISTRIBUTION_TYPES, APP_AUTH_TYPES, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, LEGACY_PUBLIC_APP_FILE, } from '../lib/constants.js';
 export const commands = {
     generalErrors: {
         srcIsProject: (src, command) => `"${src}" is in a project folder. Did you mean "hs project ${command}"?`,
@@ -123,6 +123,9 @@ export const commands = {
                 options: {
                     account: 'HubSpot account to authenticate',
                     personalAccessKey: 'Enter existing personal access key',
+                    default: 'Set the authenticated account as the default account',
+                    name: 'Set a name for the account in the CLI config',
+                    useDefaultName: 'Use the account name derived from the HubSpot portal name',
                 },
                 errors: {
                     invalidAccountIdProvided: `--account must be a number.`,
@@ -137,8 +140,12 @@ export const commands = {
             },
             list: {
                 accounts: `${chalk.bold('Accounts')}:`,
+                allAccounts: `${chalk.bold('All Accounts')}:`,
+                linkedAccounts: `${chalk.bold('Linked Accounts')}:`,
                 defaultAccountTitle: `${chalk.bold('Default Account')}`,
+                linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
                 currentResolvedDefaultAccount: (accountId) => `Account: ${uiAccountDescription(accountId)}`,
+                directory: (dir) => `Directory: ${dir}`,
                 describe: 'List names of accounts defined in config.',
                 configPath: (configPath) => `Source: ${configPath}`,
                 overrideFilePathTitle: `${chalk.bold('Default Account Override')}`,
@@ -185,6 +192,70 @@ export const commands = {
                 success: {
                     defaultAccountUpdated: (accountName) => `Default account updated to "${accountName}"`,
                 },
+                linked: {
+                    editingLinkedDefault: (dir) => `Editing the default linked account for this directory (not the global default):\n${indent(1)}${dir}`,
+                    alreadyDefault: (accountId) => `${uiAccountDescription(accountId)} is the only linked account and is already the default.`,
+                    setLinkedDefault: (account) => `Linked default set to ${chalk.cyan(account)}`,
+                    accountNotLinked: (account) => `${account} is not linked to this directory.`,
+                    promptToLink: (account) => `Would you like to link ${account} to this directory?`,
+                    settingGlobalDefault: 'Setting global default instead.',
+                    nonInteractiveNotLinked: (account) => `${account} is not linked to this directory. Setting global default instead.`,
+                },
+            },
+            link: {
+                describe: 'Link authenticated HubSpot accounts to the current directory',
+                verboseDescribe: `Link one or more authenticated HubSpot accounts to the current directory. Linked accounts are saved in a local ${chalk.bold('.hs/settings.json')} file (added to .gitignore automatically).\n\nThis lets the CLI know which account to use when you run commands from this directory, without changing the global default. Run ${uiCommandReference('hs account current')} to see the active configuration.`,
+                shared: {
+                    noLinkedAccounts: 'No HubSpot accounts are linked in this directory.',
+                    globalAccountsAvailable: (count) => `You have ${chalk.cyan(count.toString())} ${count === 1 ? 'account' : 'accounts'} in your global config.`,
+                    configurePrompt: `To configure this directory, run:\n${indent(1)}${uiCommandReference('hs account link')}`,
+                    deprecatedConfigNotSupported: (command) => `${uiCommandReference(command)} does not support deprecated config. Run ${uiCommandReference('hs config migrate')} to migrate to global config. Then re-run ${uiCommandReference(command)}`,
+                    writeSettingsFailed: (path, err) => `Failed to write to ${path}: ${err}`,
+                    savedToSettings: (path) => `Saved to ${path}`,
+                    usingLinkedAccounts: (settingsPath) => `This directory has linked accounts via ${settingsPath}. Only linked accounts will be available for this command. To manage linked accounts, run ${uiCommandReference('hs account link')}.`,
+                    accountAutoLinked: (accountId) => `Automatically linked ${uiAccountDescription(accountId)} to this directory.`,
+                    accountAutoLinkFailed: (accountId) => `Could not automatically link ${uiAccountDescription(accountId)} to this directory. Run ${uiCommandReference('hs account link')} to link it manually.`,
+                },
+                linkingDirectory: (dir) => `Linking HubSpot account(s) for directory:\n${indent(1)}${dir}`,
+                managingLinkedAccounts: (dir) => `Managing linked accounts for:\n${indent(1)}${dir}`,
+                settingsInfo: (path) => `\u2139 Accounts linked here are saved in ${path}`,
+                success: {
+                    created: (path) => `Linked to ${path} (created .hs and added to .gitignore).\n${indent(1)}Now when you work within this directory, the CLI will use the linked account(s).`,
+                },
+                errors: {
+                    authFailed: `Authentication failed to complete`,
+                },
+                events: {
+                    accountsLinked: (count) => `Linked ${count} account${count !== 1 ? 's' : ''}`,
+                    accountsUnlinked: (count) => `Unlinked ${count} account${count !== 1 ? 's' : ''}`,
+                    overrideAccountDetected: (accountId) => `\nCurrent default account (from .hsaccount):\n${indent(1)}${uiAccountDescription(accountId)}`,
+                    defaultAccountSet: (accountId) => `Linked default account set to ${chalk.cyan(uiAccountDescription(accountId))}`,
+                    defaultAccountRemoved: (isSelectionRequired) => `The linked default account was removed. ${isSelectionRequired ? 'A linked default account is required.\n' : ''}`,
+                    defaultAccountRemains: (accountId) => `Linked default account remains ${chalk.cyan(uiAccountDescription(accountId))}`,
+                    updatedLinkedAccounts: 'Updated linked accounts',
+                    noAccountsLinked: `All accounts have been unlinked. Your global config accounts will be used.\n${indent(1)}The ${chalk.bold('.hs')} directory is no longer needed and can be safely deleted.`,
+                    overrideFileRemoved: '.hsaccount file removed',
+                    invalidDefaultAccount: (accountId) => `Default account ${uiAccountDescription(accountId)} is not in the linked accounts list and has been reset. Please select a new default.`,
+                },
+                prompts: {
+                    howToProceed: 'How would you like to link an account?',
+                    whatToDo: 'Which action would you like to perform?',
+                    linkExisting: 'Link existing authenticated account(s)',
+                    authenticateNew: 'Authenticate and link a new account',
+                    cancel: 'Cancel',
+                    selectDefault: 'Select a linked default account',
+                    selectToLink: 'Select authenticated account(s) to link:',
+                    selectToUnlink: 'Select account(s) to unlink',
+                    alreadyLinked: '- Already linked',
+                    fromHsAccount: '(from .hsaccount)',
+                    newlyAuthenticated: '(just authenticated)',
+                    mustSelectOne: 'You must select at least one account to link',
+                    keepAsDefault: 'Keep this as the default?',
+                },
+            },
+            unlink: {
+                describe: 'Unlink HubSpot account(s) from the current directory',
+                verboseDescribe: `Remove one or more linked accounts from this directory's ${chalk.bold('.hs/settings.json')}. If the default account is removed, you will be prompted to select a new one.\n\nThis does not delete the account from the global config - it only removes the local association.`,
             },
             remove: {
                 describe: 'Remove an account from the config.',
@@ -253,6 +324,9 @@ export const commands = {
                 },
                 name: (name) => `${chalk.bold('Account name')}: ${name}`,
                 scopeGroups: `${chalk.bold('Scopes available')}:`,
+                linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
+                settingsPath: (path) => `Source: ${path}`,
+                linkedDefault: (account) => `Account: ${account}`,
             },
             clean: {
                 describe: 'Check for inactive accounts and removes them from the CLI config.',
@@ -1251,22 +1325,34 @@ export const commands = {
     },
     mcp: {
         describe: 'Commands for managing HubSpot MCP servers.',
+        promotion: {
+            activeNudge: `${chalk.bold('Tip:')} Work faster with AI coding tools. Run ${uiCommandReference('hs mcp setup')} to connect HubSpot developer context to supported clients.`,
+        },
         setup: {
-            describe: 'Setup the HubSpot development MCP servers.',
+            describe: `Run ${uiCommandReference('hs mcp setup')} to connect the HubSpot Dev MCP and work faster with your AI coding tools.`,
             installingDocSearch: 'Adding the docs-search mcp server',
             codex: 'Codex CLI',
             claudeCode: 'Claude Code',
             cursor: 'Cursor',
+            devin: 'Devin',
             gemini: 'Gemini CLI',
-            windsurf: 'Windsurf',
+            opencode: 'OpenCode',
             vsCode: 'VSCode',
+            other: 'Other (manual setup)',
             args: {
                 client: 'Target apps to configure',
+                standalone: 'Use npx for all of the hs commands run by the MCP server. This allows you to use the MCP server without having the CLI globally installed.',
+                cliVersion: 'Pin a specific CLI version for standalone mode',
                 docsSearch: 'Should the docs search mcp server be installed',
             },
+            examples: {
+                nonInteractive: 'Configure Claude Code without prompts',
+                standalone: 'Configure Cursor in standalone mode with a pinned CLI version',
+            },
             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: {
                 errorParsingJsonFIle: (filename, errorMessage) => `Unable to update ${chalk.bold(filename)} due to invalid JSON: ${errorMessage}`,
+                cliVersionRequiresStandalone: '`--cli-version` requires `--standalone`. Pass `--standalone` to use a specific CLI version.',
             },
             spinners: {
                 failedToConfigure: 'Failed to configure the HubSpot mcp server.',
@@ -1291,17 +1377,28 @@ export const commands = {
                 geminiNotFound: "Gemini CLI is not installed (missing 'gemini' command). Install it and re-run hs mcp setup.",
                 geminiInstallFailed: 'Failed to configure Gemini CLI',
                 alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
-                // Windsurf
-                configuringWindsurf: 'Configuring Windsurf...',
-                windsurfNotFound: 'Windsurf is not installed. Install it and re-run hs mcp setup.',
-                failedToConfigureWindsurf: 'Failed to configure Windsurf',
-                configuredWindsurf: 'Configured Windsurf',
+                // Devin
+                configuringDevin: 'Configuring Devin...',
+                devinNotFound: 'Devin is not installed. Install it and re-run hs mcp setup.',
+                failedToConfigureDevin: 'Failed to configure Devin',
+                configuredDevin: 'Configured Devin',
+                // OpenCode
+                configuringOpenCode: 'Configuring OpenCode...',
+                openCodeNotFound: "OpenCode is not installed (missing 'opencode' command). Install it and re-run hs mcp setup.",
+                openCodeInstallFailed: 'Failed to configure OpenCode',
+                configuredOpenCode: 'Configured OpenCode',
                 // VS Code
                 configuringVsCode: 'Configuring VSCode...',
                 failedToConfigureVsCode: 'Failed to configure VSCode',
                 configuredVsCode: 'Configured VSCode',
                 vsCodeNotFound: "VSCode CLI is not installed (missing 'code' command). Install it and re-run hs mcp setup.",
             },
+            otherInstructions: {
+                header: 'To connect the HubSpot MCP server to another tool, add the following MCP server configuration.',
+                docsNote: "Each tool handles MCP setup differently. Check your tool's documentation for how to add an MCP server using a command or JSON config.",
+                commandLabel: 'Command:',
+                jsonLabel: 'JSON configuration (for tools that use a config file):',
+            },
             prompts: {
                 targets: '[--client] Which tools would you like to add the HubSpot CLI MCP server to?',
                 targetsRequired: 'Must choose at least one app to configure.',
@@ -1320,6 +1417,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: {
@@ -1343,6 +1464,7 @@ export const commands = {
                 describe: 'Add a new project profile',
                 verboseDescribe: `Add a new project profile\n\nProfiles enable you to reference variables in your component configuration files. Use the syntax ${chalk.bold('\${VARIABLE_NAME}')} to reference profile variables in your component configuration files. Then target the profile using the ${uiCommandReference('--profile')} flag when you upload your project.`,
                 example: 'Add a new project profile named hsprofile.qa.json',
+                exampleCopyFrom: 'Add a profile and copy variables from the staging profile',
                 logs: {
                     copyExistingProfile: (profileName) => `Found an existing profile. We can copy the variables from ${chalk.bold(profileName)} into your new profile.`,
                     copyExistingProfiles: 'We can copy the variables from one of your existing profiles into your new profile.',
@@ -1361,10 +1483,12 @@ 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',
                     failedToLoadProfile: (profileName) => `Unable to copy variables. Failed to load profile ${chalk.bold(profileName)}`,
+                    copyFromProfileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} does not exist. Available profiles can be found in your project source directory.`,
                     failedToCreateProfile: 'Failed to create profile',
                 },
                 positionals: {
@@ -1372,6 +1496,7 @@ export const commands = {
                 },
                 options: {
                     targetAccount: 'The target account ID for this profile',
+                    copyFrom: 'Copy variables from an existing profile',
                 },
             },
             delete: {
@@ -1391,6 +1516,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.`,
@@ -1405,26 +1531,19 @@ export const commands = {
             describe: 'Start local dev for the current project.',
             logs: {
                 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.',
                 learnMoreMessageV2: `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/developer-tooling/local-development/hubspot-cli/project-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`,
                 projectAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --project-account flag for project upload`,
-                accountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --account flag for project upload`,
                 defaultSandboxOrDevTestTestingAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for testing`,
                 testingAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --testing-account flag for testing`,
             },
             errors: {
                 noProjectConfig: 'No project detected. Please run this command again from a project directory.',
                 noAccount: (accountId) => `An error occurred while reading account ${uiAccountDescription(accountId)} from your config. Run ${uiAuthCommandReference()} to re-auth this account.`,
-                noAccountsInConfig: `No accounts found in your config. Run ${uiAuthCommandReference()} to configure a HubSpot account with the CLI.`,
-                invalidProjectComponents: 'Projects cannot contain both private and public apps. Move your apps to separate projects before attempting local development.',
+                unsupportedPlatformVersion: (platformVersion) => `Local development is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
                 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',
                 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: {
@@ -1435,9 +1554,9 @@ export const commands = {
             },
             options: {
                 profile: 'The profile to target during local dev',
-                projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account. Supported on platform versions 2025.2 and newer.',
-                testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account. Supported on platform versions 2025.2 and newer.',
-                account: 'The id of the account to upload your project to. Unsupported on platform versions 2025.2 and newer.',
+                projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account.',
+                testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account.',
+                port: `The port for the local dev server. Defaults to ${LOCAL_DEV_DEFAULT_PORT}.`,
             },
         },
         create: {
@@ -1448,6 +1567,9 @@ export const commands = {
                 failedToFetchProjectList: 'Failed to fetch the list of available project templates. Please try again later.',
                 cannotNestProjects: (projectDir) => `A project already exists at ${projectDir}. Projects cannot be nested within other projects. Please choose a different destination and try again.`,
             },
+            warnings: {
+                betaPlatformVersion: (platformVersion) => `Your portal must be enrolled in the beta to use platform version ${platformVersion}. If you are not enrolled in the beta, your upload will fail. ${uiLink('Enroll in the beta', getProductUpdatesUrl('286886'))}`,
+            },
             logs: {
                 success: (projectName, projectDest) => `Project ${chalk.bold(projectName)} was successfully created in ${projectDest}`,
             },
@@ -1510,7 +1632,6 @@ export const commands = {
                 },
             },
             header: `This command will migrate an app to the projects framework. It will walk you through the fields required to complete the migration and download the project source code into a directory of your choosing.\n${uiLink('Learn more about migrating apps to the projects framework', 'https://developers.hubspot.com/docs/platform/migrate-a-public-app-to-projects')}`,
-            deprecationWarning: (platformVersion) => `The ${uiCommandReference('hs project migrate-app')} command is deprecated and will be removed. Use ${uiCommandReference(`hs app migrate --platform-version=${platformVersion}`)} going forward.`,
             migrationStatus: {
                 inProgress: () => `Converting app configuration to ${chalk.bold(LEGACY_PUBLIC_APP_FILE)} component definition ...`,
                 success: () => `${chalk.bold('Your app was converted and build #1 is deployed')}`,
@@ -1615,13 +1736,16 @@ 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}`,
             },
             errors: {
                 deploy: 'Deploy error: an unknown error occurred.',
                 noBuilds: 'Deploy error: no builds for this project were found.',
+                noSuccessfulBuilds: 'Deploy error: no successful builds for this project were found.',
                 noBuildId: 'You must specify a build to deploy',
+                notSupportedForBuildVersion: `This build's platform version does not support deploy. Run ${uiCommandReference('hs project release create')} to create a release instead.`,
                 projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
                 buildIdDoesNotExist: (accountId, buildId, projectName) => `Build ${buildId} does not exist for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds for this project.`,
                 buildAlreadyDeployed: (accountId, buildId, projectName) => `Build ${buildId} is already deployed. ${uiLink('View project builds in HubSpot', getProjectDetailUrl(projectName, accountId))}`,
@@ -1632,7 +1756,7 @@ export const commands = {
                 deployIssueComponentWarning: (uid, componentTypeName, message) => `- [${mapToUserFriendlyName(componentTypeName)}] ${chalk.bold('(' + uid + ')')} ${message}`,
             },
             examples: {
-                default: 'Deploy the latest build of the current project',
+                default: 'Deploy the last successful build of the current project',
                 withOptions: 'Deploy build 5 of the project my-project',
                 withProfile: 'Deploy using the provided profile',
             },
@@ -1641,7 +1765,77 @@ export const commands = {
                 project: 'Project name',
                 profile: 'The profile to target with this deploy',
                 force: 'Skip warnings and force deploy. Use this carefully as it will bypass warnings for destructive actions.',
-                deployLatestBuild: 'Deploy the latest build of the current project',
+                deployLatestBuild: 'Deploy the last successful build of the current project',
+            },
+        },
+        release: {
+            describe: 'Manage project releases.',
+            create: {
+                describe: 'Create a release for a project build.',
+                verboseDescribe: `Create a release for a project build\n\nReleases mark an uploaded build with an auto-generated semantic version tag (e.g. v1.0.0).\n\nBy default, the latest build is used. Use ${uiCommandReference('--build')} to specify a different build ID.`,
+                confirmPrompt: (projectName, buildId) => `Create a release for project ${chalk.bold(projectName)} using build ${chalk.bold(String(buildId))}?`,
+                success: (releaseTag, buildId) => `Release ${chalk.bold(releaseTag)} created for build ${chalk.bold(String(buildId))}.`,
+                cancelled: 'Release creation cancelled.',
+                buildIdPrompt: '[--build] Select a successful build to release:',
+                noUploadMessage: 'No upload message',
+                buildStatus: {
+                    BUILDING: 'Build in progress',
+                    FAILURE: 'Build failed',
+                    PENDING: 'Pending',
+                    PREPARING: 'Preparing',
+                },
+                uploadPrompt: (projectName) => `No successful builds for project ${chalk.bold(projectName)}. Would you like to upload it?`,
+                errors: {
+                    projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
+                    buildNotFound: (buildId, projectName) => `Build ${chalk.bold(String(buildId))} was not found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds or ${uiCommandReference('hs project upload')} to upload a build first.`,
+                    noSuccessfulBuilds: (projectName) => `No successful builds found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project upload')} to create a new build.`,
+                    incompatibleBuildVersion: `This build's platform version does not support releases. Upgrade your project to a newer platform version to use releases.`,
+                },
+                options: {
+                    build: 'Build ID to release. Defaults to the latest build.',
+                    force: 'Skip all confirmation prompts, including automatic upload when no build exists.',
+                },
+                examples: {
+                    default: 'Create a release for the latest build',
+                    withBuild: 'Create a release for a specific build',
+                },
+            },
+            list: {
+                describe: 'List releases for the current project.',
+                verboseDescribe: `List releases for the current project\n\nDisplays all releases in sorted order, newest first. Includes the version tag, build ID, and creation date. Use ${uiCommandReference('--limit')} to control how many results are shown.`,
+                noReleases: 'No releases found for this project.',
+                showingReleases: (count, projectName) => `Showing ${count} release${count === 1 ? '' : 's'} for ${chalk.bold(projectName)}:`,
+                continueOrExitPrompt: 'Press <enter> to load more, or ctrl+c to exit',
+                errors: {
+                    projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
+                },
+                options: {
+                    limit: 'Number of releases to show',
+                },
+                examples: {
+                    default: 'List releases for the current project',
+                    withLimit: 'Show only the 5 most recent releases',
+                },
+            },
+            info: {
+                describe: 'Show details about a specific release.',
+                verboseDescribe: `Show details about a specific release\n\nDisplays the release tag, build ID, creation date, and list of components included in the release. Use ${uiCommandReference('--json')} for machine-readable output.`,
+                releaseDetails: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} for ${chalk.bold(projectName)}:`,
+                components: 'Components:',
+                noComponents: 'No components found for this release.',
+                moreReleasesHint: `Not all releases are shown. Use ${uiCommandReference('--tag')} to look up an older release directly.`,
+                selectRelease: (projectName) => `Select a release for ${chalk.bold(projectName)}`,
+                errors: {
+                    releaseNotFound: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} was not found for project ${chalk.bold(projectName)}. Verify the project has been uploaded and the release tag exists. Run ${uiCommandReference('hs project release list')} to view existing releases.`,
+                    noReleases: 'No releases found for this project.',
+                },
+                options: {
+                    tag: 'Release tag to look up (e.g. v1.0.0)',
+                },
+                examples: {
+                    default: 'Show details about a specific release',
+                    json: 'Output release details as JSON',
+                },
             },
         },
         listBuilds: {
@@ -1674,6 +1868,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.',
@@ -1719,19 +1914,29 @@ export const commands = {
             examples: {
                 default: 'Upload a project into your HubSpot account',
                 withProfile: 'Upload a project into your HubSpot account when using profiles',
+                withPreview: 'Upload and preview the build on a target portal',
             },
             logs: {
+                forceCreateDeprecated: `The ${uiCommandReference('--force-create')} flag is deprecated. Use ${uiCommandReference('--force')} instead.`,
                 buildSucceeded: (buildId) => `Build #${buildId} succeeded\n`,
                 readyToGoLive: '🚀 Ready to take your project live?',
                 runCommand: (command) => `Run \`${uiCommandReference(command)}\``,
                 autoDeployDisabled: (deployCommand) => `Automatic deploys are disabled for this project. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
+                autoDeploySkipped: (deployCommand) => `Auto-deploy was skipped for this build. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
+                releaseManagementRequired: (releaseCommand) => `Run ${uiCommandReference(releaseCommand)} to create a release for 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.`,
+                previewRequiresTarget: `${uiCommandReference('--preview')} requires ${uiCommandReference('--target=<portalId>')} to specify the portal to preview on.`,
+                targetRequiresPreview: `${uiCommandReference('--target')} can only be used with ${uiCommandReference('--preview')}.`,
             },
             options: {
+                force: {
+                    describe: 'Skip confirmation prompts and force the upload.',
+                },
                 forceCreate: {
-                    describe: 'Automatically create project if it does not exist',
+                    describe: uiDeprecatedTag(`Automatically create project if it does not exist. Use ${uiCommandReference('--force')} instead.`, false),
                 },
                 message: {
                     describe: 'Add a message when you upload your project and create a build',
@@ -1739,6 +1944,18 @@ export const commands = {
                 profile: {
                     describe: 'Profile to target for this upload',
                 },
+                skipNpmAudit: {
+                    describe: 'Skip the npm audit security check before uploading',
+                },
+                skipAutoDeploy: {
+                    describe: 'Skip automatic deployment after a successful build',
+                },
+                preview: {
+                    describe: 'Preview the build on a target portal after a successful upload',
+                },
+                target: {
+                    describe: 'Portal ID to preview the build on',
+                },
             },
         },
         watch: {
@@ -1853,6 +2070,7 @@ export const commands = {
             loading: {
                 checking: 'Checking lint packages and configuration…',
                 creatingConfig: 'Creating ESLint configuration files…',
+                addingLintScripts: 'Adding lint scripts to package.json files…',
                 linting: 'Linting…',
             },
             noProjectConfig: 'No project detected. Run this command from a project directory.',
@@ -1862,6 +2080,7 @@ export const commands = {
                 return `The dependencies required for linting are missing or outdated.\n\nDependencies:\n${uniquePackages.map(p => `  - ${p}`).join('\n')}\n\n${directories.length === 1 ? 'Directory' : 'Directories'}:\n${directories.map(d => `  - ${d}`).join('\n')}\n\nWould you like to install the required dependencies?`;
             },
             skippingDirectoriesWarning: (directories) => `Skipping linting for the following ${directories.length === 1 ? 'directory' : 'directories'}:\n${directories.map(d => `  - ${d}`).join('\n')}`,
+            skippedDirectoriesError: (directoryCount) => `Linting could not run for ${directoryCount === 1 ? 'the directory' : 'the directories'} above because the required dependencies are missing. Run ${uiCommandReference('hs project lint --install-missing-deps')} to install them.`,
             deprecatedEslintConfigWarning: (details) => {
                 const dirCount = details.length;
                 const header = `Deprecated ESLint configuration file${dirCount === 1 ? '' : 's'} detected in the following ${dirCount === 1 ? 'directory' : 'directories'}:`;
@@ -1872,8 +2091,17 @@ export const commands = {
             },
             createEslintConfigPrompt: (directories) => `ESLint configuration file not found in the following ${directories.length === 1 ? 'directory' : 'directories'}:\n${directories.map(d => `  - ${d}`).join('\n')}\n\nWould you like to set up the required ESLint configuration?`,
             eslintConfigCreated: (configPath) => `ESLint configuration created at ${configPath}`,
+            createEslintConfigRequiresV2Platform: (platformVersion) => {
+                if (!platformVersion) {
+                    return 'Automatic ESLint configuration requires a Developer Platform project (2025.2 or later) with platformVersion set in hsproject.json. Add an eslint.config.js file manually, or set platformVersion and try again.';
+                }
+                return `Automatic ESLint configuration is not available for platform version ${platformVersion}. Use Developer Platform 2025.2 or later, or add eslint.config.js manually.`;
+            },
+            failedToFetchRemoteEslintConfig: (platformVersion) => `Could not download the ESLint config from HubSpot project components for platform version ${platformVersion}. Check your network connection and try again, or add eslint.config.js manually.`,
             failedToCreateEslintConfig: (configPath) => `Failed to create ESLint configuration at ${configPath}`,
             eslintConfigRequired: 'ESLint configuration is required to run the lint command. Run the command again to create the configuration.',
+            lintScriptsAdded: (scriptNames, packageJsonPath) => `Added ${scriptNames.map(s => `"${s}"`).join(' and ')} to ${packageJsonPath}`,
+            failedToAddLintScripts: (packageJsonPath) => `Failed to add lint scripts to ${packageJsonPath}`,
         },
         updateDeps: {
             help: {
@@ -1928,6 +2156,140 @@ export const commands = {
                 noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
             },
         },
+        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: (name) => `Project: ${name}`,
+                platformVersion: (version) => `Platform Version: ${version}`,
+                id: (id) => `Project ID: ${id}`,
+                deployedBuild: (buildId) => `Deployed Build: #${buildId}`,
+                autoDeploy: (enabled) => `Auto-deploy: ${enabled ? 'Enabled' : 'Disabled'}`,
+            },
+            app: {
+                title: 'App',
+                name: (name) => `Name: ${name}`,
+                id: (id) => `App ID: ${id}`,
+                uid: (uid) => `UID: ${uid}`,
+                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: {
+                type: 'Type',
+                uid: 'UID',
+            },
+            errors: {
+                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.\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',
+            },
+        },
+        installApp: {
+            describe: 'Install a static auth app from the current project into the target account',
+            verboseDescribe: `Install a static auth app from the current project into the target account.\n\nRun this command from within the project directory. The project must contain a privately distributed static auth app and must already be uploaded to the target account.`,
+            examples: {
+                default: 'Install the static auth app from the current project',
+                withAccount: 'Install the app into a specific account',
+                withProfile: 'Install the app into the account targeted by a profile',
+                json: 'Output install result as JSON',
+            },
+            options: {
+                force: 'Skip confirmation prompts',
+                profile: 'The profile to target with this install',
+            },
+            errors: {
+                noProjectConfig: `No project config found. Run this command from within a HubSpot project directory, or use ${uiCommandReference('hs project create')} to create a new one.`,
+                unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
+                failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
+                noAppInProject: 'No app was found in the local project. This command requires a project that contains an app.',
+                unsupportedAuthType: (authType) => `This command only supports static auth apps. Detected auth type: ${authType}.`,
+                unsupportedDistribution: (distribution) => `This command only supports privately distributed apps. Detected distribution: ${distribution}.`,
+                invalidAppDeveloperAccount: (accountId) => `Static auth apps can't be installed into the app developer account ${uiAccountDescription(accountId)}. Switch to a standard, sandbox, or developer test account with ${uiCommandReference('hs account use')}, or pass ${uiCommandReference('--account')}.`,
+                projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
+                appNotDeployed: (appName, accountId) => `The app ${chalk.bold(appName)} has not been deployed to ${uiAccountDescription(accountId)}. Upload the project with ${uiCommandReference('hs project upload')} and ensure the build succeeds, then try again.`,
+                automaticInstallUnavailable: (appName, accountId) => `${chalk.bold(appName)} could not be installed automatically in ${uiAccountDescription(accountId)}.`,
+                installFailed: (appName, accountId) => `Failed to install ${chalk.bold(appName)} in ${uiAccountDescription(accountId)}.`,
+            },
+            jsonErrors: {
+                automaticInstallUnavailable: 'Automatic install is unavailable for this account.',
+                installFailed: (appName, accountId) => `Failed to install ${appName} in account ${accountId}.`,
+            },
+            profileMessage: (profileName, accountId) => `Installing with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
+            appDeveloperAccountNotice: (accountId) => `${uiAccountDescription(accountId)} is an app developer account, which can't have apps installed into it.`,
+            selectInstallAccountPrompt: 'Select an account to install the app into',
+            uploadAndDeployPrompt: (accountId) => `The app isn't deployed to ${uiAccountDescription(accountId)} yet. Upload and deploy the project now?`,
+            alreadyInstalled: (appName, accountId) => `${chalk.bold(appName)} is already installed in ${uiAccountDescription(accountId)}.`,
+            outdatedScopes: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)} with outdated scopes.`,
+            reinstallPrompt: 'Reinstall the app to grant the latest scopes?',
+            installPrompt: (appName, accountId) => `Install ${chalk.bold(appName)} in ${uiAccountDescription(accountId)}?`,
+            installFromBrowser: (installUrl) => `Install the app in HubSpot: ${uiLink('Open install page', installUrl)}`,
+            success: (appName, accountId) => `${chalk.bold(appName)} installed in ${uiAccountDescription(accountId)}.`,
+        },
+        installStatus: {
+            describe: 'Check whether a static auth app in the current project is installed in the target account. This command must be run from within a HubSpot project directory.',
+            examples: {
+                default: 'Check install status for the static auth app in the current project',
+                json: 'Output install status as JSON',
+            },
+            errors: {
+                noProjectConfig: `No project config found. Run this command from within a HubSpot project directory, or use ${uiCommandReference('hs project create')} to create a new one.`,
+                unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
+                failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
+                noAppInProject: 'No app was found in the local project. Install status is only available for projects that contain an app.',
+                unsupportedAuthType: (authType) => `This command only supports static auth apps. Detected auth type: ${authType}.`,
+            },
+            success: {
+                installed: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)}.`,
+                installedWithOutdatedScopes: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)} with outdated scopes. Reinstall the app to grant the latest scopes.`,
+            },
+            notInstalled: (appName, accountId) => `${chalk.bold(appName)} is not installed in ${uiAccountDescription(accountId)}.`,
+        },
     },
     sandbox: {
         describe: 'Commands for managing sandboxes.',
@@ -2122,6 +2484,111 @@ export const commands = {
                     },
                 },
             },
+            logs: {
+                describe: 'View recent application logs.',
+                verboseDescribe: `View recent application logs for a specific log type.\n\nFilter by time range with ${uiCommandReference('--since')} (e.g. 1h, 30m, 2d, or an ISO timestamp). Use ${uiCommandReference('--tail')} to follow logs in real-time, ${uiCommandReference('--compact')} for one-line-per-log output, or ${uiCommandReference('--json')} for machine-readable output.\n\nRun ${uiCommandReference('hs app log-details <logId>')} to inspect a specific log entry.`,
+                options: {
+                    appId: 'App ID',
+                    type: 'Log type',
+                    json: 'Output logs as JSON',
+                    limit: 'Maximum number of logs to return',
+                    since: 'Filter logs by time ago (1h, 30m, 2d, or ISO timestamp)',
+                    tail: 'Follow logs in real-time',
+                    errorsOnly: 'Only show error logs',
+                    compact: 'Display logs in compact format (one line per log)',
+                },
+                errors: {
+                    noLogs: 'No logs found. Try a wider time range (--since) or remove --errors-only to see all logs.',
+                    noApps: `No apps found. Create an app with ${uiCommandReference('hs project create')}.`,
+                },
+                prompts: {
+                    selectType: '[--type] Select the type of logs to view:',
+                },
+                examples: {
+                    basic: 'Fetch webhook logs for app 123456',
+                    since: 'Fetch logs from the last hour',
+                    tail: 'Follow logs in real-time',
+                    json: 'Output logs as JSON',
+                    compact: 'Display logs in compact format',
+                },
+                outputMessages: {
+                    viewInHubSpot: (url) => uiLink('View in HubSpot', url),
+                    tableHeaders: {
+                        appId: 'App ID',
+                        type: 'Type',
+                        logsFound: 'Logs Found',
+                    },
+                    logDetails: {
+                        id: 'ID',
+                        duration: 'Duration',
+                        portal: 'Portal',
+                        trace: 'Trace',
+                        error: 'Error',
+                        viewDetails: (logId, appId, systemType) => `To view more details, run: ${uiCommandReference(`hs app log-details ${logId} --app=${appId} --type=${systemType}`)}`,
+                        viewInUI: (url) => uiLink('View details in UI', url),
+                    },
+                    tailMessages: {
+                        following: (appId) => `Following logs for app ${appId}`,
+                        stop: `> Press ${chalk.bold('q')} to stop following`,
+                    },
+                },
+            },
+            logDetails: {
+                describe: 'View details for a specific log entry.',
+                verboseDescribe: `View full details for a specific app log entry, including request/response bodies, context information, and error details.\n\nUse ${uiCommandReference('--json')} for machine-readable output.`,
+                positionals: {
+                    logId: 'The log ID to fetch details for',
+                },
+                options: {
+                    appId: 'App ID',
+                    type: 'Log type',
+                    json: 'Output details as JSON',
+                },
+                errors: {
+                    noApps: `No apps found. Create an app with ${uiCommandReference('hs project create')}.`,
+                },
+                prompts: {
+                    selectType: '[--type] Select the log type:',
+                },
+                examples: {
+                    basic: 'Fetch details for log abc-123',
+                    json: 'Output log details as JSON',
+                },
+                outputMessages: {
+                    viewInHubSpot: (url) => uiLink('View in HubSpot', url),
+                    logDetailsHeader: 'Log Details',
+                    basicInfo: {
+                        id: 'Log ID',
+                        timestamp: 'Timestamp',
+                        status: 'Status',
+                        duration: 'Duration',
+                        systemType: 'Type',
+                    },
+                    contextInfo: {
+                        header: 'Context',
+                        portalId: 'Portal ID',
+                        traceId: 'Trace ID',
+                        function: 'Function',
+                        location: 'Location',
+                        card: 'Card',
+                        userId: 'User ID',
+                    },
+                    requestResponse: {
+                        header: 'Request/Response',
+                        requestBody: 'Request Body',
+                        responseBody: 'Response Body',
+                    },
+                    errorInfo: {
+                        header: 'Error Details',
+                        errorType: 'Type',
+                        errorMessage: 'Message',
+                        stackTrace: 'Stack Trace',
+                    },
+                    additionalInfo: {
+                        header: 'Additional Information',
+                    },
+                },
+            },
         },
     },
     secret: {
@@ -2223,7 +2690,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}`,
@@ -2243,8 +2710,8 @@ export const commands = {
                 opsLevel: 'Operations Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
                 serviceLevel: 'Service Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
                 salesLevel: 'Sales Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
-                contentLevel: 'CMS Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
-                commerceLevel: 'Commerce Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
+                contentLevel: 'Content Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
+                commerceLevel: 'Revenue Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
             },
             example: (configPath) => `Create a test account from the config file at ${configPath}`,
             examples: {
@@ -2896,15 +3363,30 @@ export const commands = {
     },
 };
 export const lib = {
+    linkedDirectory: {
+        warning: (action, settingsPath) => `This directory has linked accounts via ${settingsPath}. ${uiCommandReference(action)} modifies your global config, not the linked directory settings. Use ${uiCommandReference('hs account link')} to manage linked accounts.\n`,
+    },
     parsing: {
         unableToParseStringToNumber: 'Unable to parse string to number',
     },
     configMiddleWare: {
         invalidAccountIdEnvironmentVariable: 'Unable to parse `HUBSPOT_ACCOUNT_ID` environment variable into a number',
     },
+    accountTargetDiscovery: {
+        errors: {
+            explicitAccountNotFound: (account) => `Account ${chalk.bold(String(account))} was not found in your config. Run ${uiCommandReference('hs account list')} to see available accounts.`,
+        },
+    },
     process: {
         exitDebug: (signal) => `Attempting to gracefully exit. Triggered by ${signal}`,
     },
+    handlerLogFile: {
+        saved: (filePath) => `Debug logs can be viewed at ${filePath}`,
+    },
+    jsonSchema: {
+        noSchemaForCommand: 'No schema defined for this command',
+        validationFailed: 'JSON output may be missing or malformed fields. The output schema may be out of date.',
+    },
     DevServerManager: {
         portConflict: (port) => `The port ${port} is already in use.`,
         notInitialized: 'The Dev Server Manager must be initialized before it is started.',
@@ -2987,6 +3469,13 @@ export const lib = {
         appDataNotFound: 'An error occurred while fetching data for your app.',
         oauthAppRedirectUrlError: (redirectUrl) => `${chalk.bold('No reponse from your OAuth service:')} ${redirectUrl}\nYour app needs a valid OAuth2 service to be installed for local dev. ${uiLink('Learn more', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/oauth/working-with-oauth')}`,
     },
+    accountAuthWebsocket: {
+        logs: {
+            openingWebBrowser: (url) => `Opening ${uiLink('HubSpot', url)} in your web browser\n`,
+            spinner: 'Waiting for HubSpot to send your personal access key... (press any key to enter it manually)',
+            received: 'Personal access key received',
+        },
+    },
     CLIWebsocketServer: {
         errors: {
             portManagerNotRunning: (prefix) => `${prefix ? `${prefix} ` : ''}PortManagerServing must be running before starting WebsocketServer.`,
@@ -2994,6 +3483,7 @@ export const lib = {
             missingTypeField: (data) => `Unsupported message received. Missing type field: ${data}`,
             invalidJSON: (data) => `Unsupported message received. Invalid JSON: ${data}`,
             unknownMessageType: (type) => `Unsupported message received. Unknown message type: ${type}`,
+            failedToBindEphemeralPort: (prefix) => `${prefix ? `${prefix} ` : ''}Failed to determine the assigned port for the WebsocketServer.`,
         },
         logs: {
             startup: (port) => `WebsocketServer running on port ${port}`,
@@ -3017,7 +3507,21 @@ 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.`,
+                changedFiles: (changed) => {
+                    const sections = [];
+                    if (changed.added.length > 0) {
+                        sections.push(`${chalk.bold('Features Added:')}\n${changed.added.map(f => `  - ${f}`).join('\n')}`);
+                    }
+                    if (changed.updated.length > 0) {
+                        sections.push(`${chalk.bold('Features Modified:')}\n${changed.updated.map(f => `  - ${f}`).join('\n')}`);
+                    }
+                    if (changed.removed.length > 0) {
+                        sections.push(`${chalk.bold('Features Removed:')}\n${changed.removed.map(f => `  - ${f}`).join('\n')}`);
+                    }
+                    return sections.join('\n\n');
+                },
                 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.`,
+                unableToCompare: `Unable to check if local *-hsmeta.json files match the deployed build. Run ${uiCommandReference('hs project upload')} to upload any local changes before continuing.`,
             },
             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.`,
@@ -3040,19 +3544,6 @@ export const lib = {
             },
         },
         account: {
-            checkIfDefaultAccountIsSupported: {
-                publicApp: `This project contains a public app. Local development of public apps is only supported on developer accounts and developer test accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
-                privateApp: `This project contains a private app. Local development of private apps is not supported in developer accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
-            },
-            validateAccountOption: {
-                invalidPublicAppAccount: `This project contains a public app. The "--account" flag must point to a developer test account to develop this project locally. Alternatively, change your default account to an app developer account using ${uiCommandReference('hs account use')} and run ${uiCommandReference('hs project dev')} to set up a new developer test account.`,
-                invalidPrivateAppAccount: `This project contains a private app. The account specified with the "--account" flag points to a developer account, which do not support the local development of private apps. Update the "--account" flag to point to a standard, sandbox, or developer test account, or change your default account by running ${uiCommandReference('hs account use')}.`,
-                nonSandboxWarning: `Testing in a sandbox is strongly recommended. To switch the target account, select an option below or run ${uiCommandReference('hs account use')} before running the command again.`,
-                publicAppNonDeveloperTestAccountWarning: `Local development of public apps is only supported in ${chalk.bold('developer test accounts')}.`,
-            },
-            checkIfParentAccountIsAuthed: {
-                notAuthedError: (parentAccountId, accountIdentifier) => `To develop this project locally, run ${uiAuthCommandReference({ accountId: parentAccountId })} to authenticate the App Developer Account ${parentAccountId} associated with ${accountIdentifier}.`,
-            },
             selectAccountTypePrompt: {
                 message: 'Choose the type of account to test on',
                 developerTestAccountOption: 'Test on a developer test account (recommended)',
@@ -3060,10 +3551,7 @@ export const lib = {
                 sandboxAccountOptionDisabled: 'Disabled - requires access to sandbox accounts',
                 productionAccountOption: (accountId) => `<${chalk.red('!')} Test on your project account: ${uiAccountDescription(accountId, false)} ${chalk.red('!')}>`,
             },
-            confirmDefaultAccountIsTarget: {
-                configError: `An error occurred while reading the default account from your config. Run ${uiAuthCommandReference()} to re-auth this account`,
-                declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
-            },
+            declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
         },
     },
     middleware: {
@@ -3086,11 +3574,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.',
@@ -3158,6 +3641,11 @@ export const lib = {
             feedbackHeader: "We'd love to hear your feedback!",
             feedbackMessage: `How are you liking the new projects and developer tools? \n > Run ${uiCommandReference('hs feedback')} to let us know what you think!\n`,
         },
+        skippedHsMetaFiles: {
+            warning: (files) => `The following *-hsmeta.json files will be skipped.\nThis CLI version doesn't support the features they require:\n${files.map(f => `  ${chalk.bold(f)}`).join('\n')}\nRun ${uiCommandReference('hs upgrade')} to update the CLI, which may add support for these features.`,
+            uploadWarning: (files) => `The following *-hsmeta.json files will be skipped during upload.\nThis CLI version doesn't support the features they require:\n${files.map(f => `  ${chalk.bold(f)}`).join('\n')}\nRun ${uiCommandReference('hs upgrade')} to update the CLI, which may add support for these features.`,
+            prompt: '[--force] Continue anyway?',
+        },
         components: {
             unableToGetUidFromHsmeta: 'Unable to get UID from hsmeta',
             buildSuccessMessage: {
@@ -3165,9 +3653,9 @@ export const lib = {
                 docsUrl: 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/overview',
                 headerCreated: (projectName, projectDest) => `${chalk.bold(projectName)} was successfully created in ${projectDest}`,
                 headerAdded: (featureText, uid, plural) => `${featureText} ${plural ? 'were' : 'was'} successfully added to ${uid}:`,
-                docsDetails: (docsLink) => `📖 ${docsLink} for more details about building and testing these features.`,
-                uploadPrompt: `🚀 Run ${uiCommandReference('hs project upload')} when you're ready to deploy.`,
-                devPrompt: `🧪 Run ${uiCommandReference('hs project dev')} to start local development.`,
+                docsDetails: (docsLink) => `${docsLink} for more details about building and testing these features.`,
+                uploadPrompt: `Run ${uiCommandReference('hs project upload')} when you're ready to deploy.`,
+                devPrompt: `Run ${uiCommandReference('hs project dev')} to start local development.`,
             },
         },
     },
@@ -3203,8 +3691,33 @@ 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}`,
+            lintPackagesNotConfigured: (packageRoot) => `Project lint: lint packages not installed for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to install them.`,
+            lintConfigNotFound: (packageRoot) => `Project lint: ESLint configuration not found for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to create an ESLint config.`,
+            lintHubSpotRulesNotActive: (packageRoot) => `Project lint: HubSpot ESLint rules not active for ${chalk.bold(packageRoot)}. Configure ${chalk.bold('@hubspot/eslint-config-ui-extensions')} — see ${uiLink('setup instructions', 'https://www.npmjs.com/package/@hubspot/eslint-config-ui-extensions')}.`,
+            npmAuditClean: (packageRoot) => `npm audit: No npm dependency issues found for ${chalk.bold(packageRoot)}`,
+            npmAuditIssues: (packageRoot, details) => `npm audit: security issues found for ${chalk.bold(packageRoot)}: ${details}`,
+            npmAuditNpmUnavailable: (packageRoot) => `npm audit: skipped for ${chalk.bold(packageRoot)} (npm not available in PATH)`,
+            npmAuditNonZeroExit: (packageRoot, exitCode) => `npm audit: ${chalk.bold(packageRoot)} exited with code ${exitCode}`,
         },
     },
+    projectPreview: {
+        triggeringPreview: (buildId, targetPortalId) => `Previewing build #${buildId} on ${uiAccountDescription(targetPortalId)}`,
+        pollingStatus: (releaseTag, targetPortalId) => `Previewing ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
+        succeeded: (releaseTag, targetPortalId) => `Previewed ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
+        triggerFailed: 'Failed to trigger preview',
+        pollFailed: 'Failed to poll preview status',
+        warning: 'The build succeeded but the preview failed. You can manually preview this build from the project UI.',
+        missingProjectId: 'Unable to preview: could not resolve the project ID.',
+    },
     importData: {
         errors: {
             incorrectAccountType: (derivedAccountId) => `The account ${uiAccountDescription(derivedAccountId)} is not a standard account, developer test account, or app developer account.`,
@@ -3313,6 +3826,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}`,
@@ -3358,6 +3874,7 @@ export const lib = {
             qa: 'Run command in QA mode',
             useEnv: 'Use environment variable config',
             jsonOutput: 'Format output as JSON',
+            jsonSchema: 'Print the JSON output schema and exit',
             debug: 'Set log level to debug',
         },
     },
@@ -3401,8 +3918,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.',
@@ -3426,13 +3949,15 @@ export const lib = {
             developerTestAccountLimit: (limit) => `Your account reached the limit of ${limit} developer test accounts.`,
             confirmDefaultAccount: (accountName, accountType) => `Continue testing on ${chalk.bold(`${accountName} (${accountType})`)}? (Y/n)`,
             confirmUseExistingDeveloperTestAccount: (accountName) => `Continue with ${accountName}? This account isn't currently connected to the HubSpot CLI. By continuing, you'll be prompted to generate a personal access key and connect it.`,
+            confirmLinkExistingDeveloperTestAccount: (accountName) => `${accountName} is not linked to this directory. Would you like to link it?`,
             noAccountId: 'No account ID found for the selected account. Please try again.',
+            fetchDeveloperTestAccountsError: 'Unable to fetch developer test accounts. Please try again.',
         },
         projectLogsPrompt: {
             functionName: (projectName) => `[--function] Select function in ${chalk.bold(projectName)} project`,
         },
         setAsDefaultAccountPrompt: {
-            setAsDefaultAccountMessage: 'Set this account as the default?',
+            setAsDefaultAccountMessage: (accountName) => `Set ${accountName} as your default account? [--default]`,
             setAsDefaultAccount: (accountName) => `Account "${accountName}" set as the default account`,
             keepingCurrentDefault: (accountName) => `Account "${accountName}" will continue to be the default account`,
         },
@@ -3497,6 +4022,7 @@ export const lib = {
                 invalidOauthClientSecretCopy: 'Please copy the actual OAuth2 client secret rather than the asterisks that mask it.',
                 invalidPersonalAccessKey: 'You did not enter a valid access key. Please try again.',
                 invalidPersonalAccessKeyCopy: 'Please copy the actual access key rather than the bullets that mask it.',
+                authCancelled: 'Authentication cancelled.',
             },
         },
         createTemplatePrompt: {
@@ -3830,6 +4356,11 @@ export const lib = {
             installed: (npmVersion) => `npm v${npmVersion} is installed`,
             unableToDetermine: 'Unable to determine if npm is installed',
         },
+        mcpChecks: {
+            configured: (clients) => `HubSpot MCP server configured in ${clients.join(', ')}`,
+            notConfigured: (clients) => `HubSpot MCP server not configured in ${clients.join(', ')}`,
+            notConfiguredSecondary: `Run ${uiCommandReference('hs mcp setup')} to connect AI coding tools to HubSpot developer context`,
+        },
         hsChecks: {
             notLatest: (hsVersion) => `Version ${hsVersion} outdated`,
             notLatestSecondary: (command, hsVersion) => `Run ${uiCommandReference(command)} to upgrade to the latest version ${hsVersion}`,
@@ -3848,9 +4379,9 @@ export const lib = {
             validJson: 'JSON files valid',
         },
         port: {
-            inUse: (port) => `Port ${port} is in use`,
-            inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}`,
-            available: (port) => `Port ${port} available for local development`,
+            inUse: (port) => `Default port ${port} is in use`,
+            inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}, or use ${uiCommandReference('--port')} to specify a different port`,
+            available: (port) => `Default port ${port} available for local development`,
         },
         projectValidation: {
             valid: 'Project configuration and structure is valid',
@@ -3939,11 +4470,12 @@ export const lib = {
         fileInvalidJson: (path) => `The file "${path}" contains invalid JSON`,
     },
     migrate: {
-        componentsToBeMigrated: (components) => `The following features will be migrated: ${components}`,
+        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: '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),
+        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),
         exitWithoutMigrating: 'Exiting without migrating',
         success: {
             downloadedProject: (projectName, projectDest) => `Saved ${projectName} to ${projectDest}`,
@@ -3955,7 +4487,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.',