@hubspot/cli 8.14.0 → 8.15.0-beta.1

package/commands/project/validate.js

@@ -1,112 +1,89 @@
-import path from 'path';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { uiLogger } from '../../lib/ui/logger.js';
-import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
+import { getProjectConfig } from '../../lib/projects/config.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-import { validateSourceDirectory, handleTranslate, } from '../../lib/projects/upload.js';
 import { commands } from '../../lang/en.js';
-import { validateProjectForProfile } from '../../lib/projects/projectProfiles.js';
 import { logError } from '../../lib/errorHandlers/index.js';
-import { getAllHsProfiles } from '@hubspot/project-parsing-lib/profiles';
-import SpinniesManager from '../../lib/ui/SpinniesManager.js';
+import { validateProject, toIssue, } from '../../lib/projects/validate.js';
+import { ValidateSchema, } from '../../lib/jsonOutput/validate.js';
 const command = 'validate';
 const describe = commands.project.validate.describe;
-async function handler(args) {
-    const { derivedAccountId, profile, exit, addUsageMetadata } = args;
-    const { projectConfig, projectDir } = await getProjectConfig();
-    const accountConfig = getConfigAccountById(derivedAccountId);
-    const accountType = accountConfig && accountConfig.accountType;
-    addUsageMetadata({ type: accountType });
-    if (!projectConfig || !projectDir) {
-        uiLogger.error(commands.project.validate.mustBeRanWithinAProject);
-        return exit(EXIT_CODES.ERROR);
+function generateJson({ result, projectConfig, profile, }) {
+    const { valid, errors, warnings, profiles } = result;
+    const output = { valid, errors, warnings };
+    if (projectConfig) {
+        output.projectName = projectConfig.name;
+        output.platformVersion = projectConfig.platformVersion;
     }
-    if (isLegacyProject(projectConfig.platformVersion)) {
-        uiLogger.error(commands.project.validate.badVersion);
-        return exit(EXIT_CODES.ERROR);
+    if (profile) {
+        output.profile = profile;
+    }
+    if (profiles.length > 0) {
+        output.profiles = profiles;
+    }
+    return output;
+}
+async function handler(args) {
+    const { derivedAccountId, profile, exit, addUsageMetadata, formatOutputAsJson, addJsonOutput, } = args;
+    let projectConfig;
+    let projectDir;
+    function outputError(error) {
+        logError(error);
+        addJsonOutput(generateJson({
+            result: {
+                valid: false,
+                errors: [toIssue(error)],
+                warnings: [],
+                profiles: [],
+            },
+            projectConfig,
+            profile,
+        }));
     }
     try {
-        validateProjectConfig(projectConfig, projectDir);
+        const accountConfig = getConfigAccountById(derivedAccountId);
+        const accountType = accountConfig && accountConfig.accountType;
+        addUsageMetadata({ type: accountType });
+        ({ projectConfig, projectDir } = getProjectConfig());
     }
     catch (error) {
-        logError(error);
+        outputError(error);
         return exit(EXIT_CODES.ERROR);
     }
-    let validationSucceeded = true;
-    const srcDir = path.resolve(projectDir, projectConfig.srcDir);
-    const profiles = await getAllHsProfiles(path.join(projectDir, projectConfig.srcDir));
-    // If a profile is specified, only validate that profile
-    if (profile) {
-        const validationErrors = await validateProjectForProfile({
+    if (isLegacyProject(projectConfig.platformVersion)) {
+        const message = commands.project.validate.badVersion;
+        uiLogger.error(message);
+        addJsonOutput(generateJson({
+            result: {
+                valid: false,
+                errors: [{ message }],
+                warnings: [],
+                profiles: [],
+            },
+            projectConfig,
+            profile,
+        }));
+        return exit(EXIT_CODES.ERROR);
+    }
+    let result;
+    try {
+        result = await validateProject({
             projectConfig,
             projectDir,
-            profileName: profile,
             derivedAccountId,
+            profile,
+            formatOutputAsJson,
         });
-        if (validationErrors.length) {
-            logValidationErrors(validationErrors);
-            validationSucceeded = false;
-        }
-    }
-    else if (profiles.length > 0) {
-        // If no profile was specified and the project has profiles, validate all of them
-        SpinniesManager.add('validatingAllProfiles', {
-            text: commands.project.validate.spinners.validatingAllProfiles,
-        });
-        const errors = [];
-        for (const profileName of profiles) {
-            const validationErrors = await validateProjectForProfile({
-                projectConfig,
-                projectDir,
-                profileName,
-                derivedAccountId,
-                indentSpinners: true,
-            });
-            if (validationErrors.length) {
-                errors.push(...validationErrors);
-                validationSucceeded = false;
-            }
-        }
-        if (validationSucceeded) {
-            SpinniesManager.succeed('validatingAllProfiles', {
-                text: commands.project.validate.spinners.allProfilesValidationSucceeded,
-            });
-        }
-        else {
-            SpinniesManager.fail('validatingAllProfiles', {
-                text: commands.project.validate.spinners.allProfilesValidationFailed,
-            });
-        }
-        logValidationErrors(errors);
     }
-    else if (profiles.length === 0) {
-        // If the project has no profiles, validate the project without a profile
-        try {
-            await handleTranslate({
-                projectDir: projectDir,
-                projectConfig,
-                accountId: derivedAccountId,
-                skipValidation: false,
-            });
-        }
-        catch (e) {
-            uiLogger.error(commands.project.validate.failure(projectConfig.name));
-            logError(e);
-            validationSucceeded = false;
-            uiLogger.log('');
-        }
-    }
-    if (!validationSucceeded) {
+    catch (error) {
+        outputError(error);
         return exit(EXIT_CODES.ERROR);
     }
-    try {
-        await validateSourceDirectory(srcDir, projectConfig, projectDir);
-    }
-    catch (e) {
-        logError(e);
+    addJsonOutput(generateJson({ result, projectConfig, profile }));
+    if (!result.valid) {
         return exit(EXIT_CODES.ERROR);
     }
     uiLogger.success(commands.project.validate.success(projectConfig.name));
@@ -127,30 +104,23 @@ function projectValidateBuilder(yargs) {
             '$0 project validate --profile=profileName',
             commands.project.validate.examples.withProfile,
         ],
+        ['$0 project validate --json', commands.project.validate.examples.json],
     ]);
     return yargs;
 }
-function logValidationErrors(validationErrors) {
-    uiLogger.log('');
-    validationErrors.forEach(error => {
-        if (error instanceof Error) {
-            logError(error);
-        }
-        else {
-            uiLogger.log(error);
-        }
-    });
-}
 const builder = makeYargsBuilder(projectValidateBuilder, command, describe, {
     useGlobalOptions: true,
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
 });
 const projectValidateCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-validate', handler),
+    handler: makeWrappedYargsHandler('project-validate', handler, {
+        jsonOutputSchema: ValidateSchema,
+    }),
     builder,
 };
 export default projectValidateCommand;

package/commands/project/watch.js

@@ -6,7 +6,7 @@ import { createWatcher } from '../../lib/projects/watch.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { PROJECT_ERROR_TYPES } from '../../lib/constants.js';
-import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
+import { getProjectConfig } from '../../lib/projects/config.js';
 import { logFeedbackMessage } from '../../lib/projects/ui.js';
 import { handleProjectUpload } from '../../lib/projects/upload.js';
 import { pollBuildStatus, pollDeployStatus, } from '../../lib/projects/pollProjectBuildAndDeploy.js';
@@ -58,22 +58,19 @@ function handleUserInput(accountId, projectName, currentBuildId, exit) {
 async function handler(args) {
     const { initialUpload, derivedAccountId, exit } = args;
     uiCommandRelocatedMessage('hs project dev');
-    const { projectConfig, projectDir } = await getProjectConfig();
-    if (!projectConfig || !projectDir) {
-        uiLogger.error(commands.project.watch.errors.projectConfigNotFound);
-        return exit(EXIT_CODES.ERROR);
-    }
-    if (!isLegacyProject(projectConfig.platformVersion)) {
-        uiLogger.error(commands.project.watch.errors.v2ApiError(projectConfig.platformVersion));
-        return exit(EXIT_CODES.ERROR);
-    }
+    let projectConfig;
+    let projectDir;
     try {
-        validateProjectConfig(projectConfig, projectDir);
+        ({ projectConfig, projectDir } = getProjectConfig());
     }
     catch (error) {
         logError(error);
         return exit(EXIT_CODES.ERROR);
     }
+    if (!isLegacyProject(projectConfig.platformVersion)) {
+        uiLogger.error(commands.project.watch.errors.v2ApiError(projectConfig.platformVersion));
+        return exit(EXIT_CODES.ERROR);
+    }
     try {
         const { data: { results: builds }, } = await fetchProjectBuilds(derivedAccountId, projectConfig.name);
         const hasNoBuilds = !builds || !builds.length;

package/commands/project.js

@@ -33,7 +33,7 @@ const describe = commands.project.describe;
 // the CLI is not officially compatible with
 async function validatePlatformVersion() {
     try {
-        const { projectConfig } = await getProjectConfig();
+        const { projectConfig } = getProjectConfig();
         // 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 &&

package/commands/testAccount/create.d.ts

@@ -1,6 +1,6 @@
 import { AccountLevel } from '@hubspot/local-dev-lib/types/developerTestAccounts.js';
 import { CommonArgs, ConfigArgs, AccountArgs, TestingArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-import { CreateTestAccountJsonOutput } from '../../lib/jsonOutput.js';
+import { CreateTestAccountJsonOutput } from '../../lib/jsonOutput/createTestAccount.js';
 type CreateTestAccountArgs = CommonArgs & AccountArgs & ConfigArgs & TestingArgs & EnvironmentArgs & JSONOutputArgs<CreateTestAccountJsonOutput> & {
     configPath?: string;
     name?: string;

package/commands/testAccount/create.js

@@ -4,7 +4,7 @@ import { getValidEnv } from '@hubspot/local-dev-lib/environment';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { getCwd } from '@hubspot/local-dev-lib/path';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
-import { CreateTestAccountSchema, } from '../../lib/jsonOutput.js';
+import { CreateTestAccountSchema, } from '../../lib/jsonOutput/createTestAccount.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { promptUser, listPrompt } from '../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';

package/lang/en.d.ts

@@ -1466,7 +1466,6 @@ export declare const commands: {
                     duplicateTargetAccount: (targetAccountId: number) => string;
                 };
                 errors: {
-                    noProjectConfig: string;
                     unsupportedPlatformVersion: string;
                     profileExists: (profileName: string) => string;
                     invalidTargetAccount: string;
@@ -1499,7 +1498,6 @@ export declare const commands: {
                     deleteProjectPrompt: (accountId: number) => string;
                 };
                 errors: {
-                    noProjectConfig: string;
                     unsupportedPlatformVersion: string;
                     noProfileFound: (profileName: string) => string;
                     noProfilesFound: string;
@@ -1523,7 +1521,6 @@ export declare const commands: {
                 testingAccountFlagExplanation: (accountId: number) => string;
             };
             errors: {
-                noProjectConfig: string;
                 noAccount: (accountId: number) => string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 noRunnableComponents: string;
@@ -1649,7 +1646,6 @@ export declare const commands: {
             describe: string;
             errors: {
                 noProjectConfig: (command: string) => string;
-                noThemeMigrationAccess: (accountId?: number) => string;
             };
             examples: {
                 default: string;
@@ -1912,9 +1908,11 @@ export declare const commands: {
                 autoDeployDisabled: (deployCommand: string) => string;
                 autoDeploySkipped: (deployCommand: string) => string;
                 releaseManagementRequired: (releaseCommand: string) => string;
+                uploadingWithProfile: (profileName: string, accountId: number) => string;
+                uploadingToAccount: (accountId: number) => string;
+                uploadedToAccount: (accountId: number) => string;
             };
             errors: {
-                noProjectConfig: string;
                 projectLockedError: string;
                 previewRequiresTarget: string;
                 targetRequiresPreview: string;
@@ -1976,7 +1974,6 @@ export declare const commands: {
                 fileAlreadyQueued: (filePath: string) => string;
             };
             errors: {
-                projectConfigNotFound: string;
                 projectLockedError: string;
                 uploadFailed: (remotePath: string, filePath: string) => string;
                 deleteFileFailed: (remotePath: string) => string;
@@ -1988,6 +1985,7 @@ export declare const commands: {
             describe: string;
             examples: {
                 default: string;
+                json: string;
             };
             logs: {
                 downloadCancelled: string;
@@ -2043,7 +2041,6 @@ export declare const commands: {
             installationSuccessful: (directory: string) => string;
             addingDependenciesToLocation: (dependencies: string, directory: string) => string;
             installingDependenciesFailed: (directory: string) => string;
-            noProjectConfig: string;
             noPackageJsonInProject: (projectName: string) => string;
             packageManagerNotInstalled: (packageManager: string) => string;
         };
@@ -2061,7 +2058,6 @@ export declare const commands: {
                 addingLintScripts: string;
                 linting: string;
             };
-            noProjectConfig: string;
             failedToReadPackageJson: (packageJsonPath: string) => string;
             installLintPackagesPrompt: (directories: string[], missingPackages: string[]) => string;
             skippingDirectoriesWarning: (directories: string[]) => string;
@@ -2091,7 +2087,6 @@ export declare const commands: {
             updateSuccessful: (directory: string) => string;
             updatingDependenciesToLocation: (dependencies: string, directory: string) => string;
             updatingDependenciesFailed: (directory: string) => string;
-            noProjectConfig: string;
             noPackageJsonInProject: (projectName: string) => string;
             packageManagerNotInstalled: (packageManager: string) => string;
         };
@@ -2102,6 +2097,7 @@ export declare const commands: {
             examples: {
                 default: string;
                 withProfile: string;
+                json: string;
             };
             success: (projectName: string) => string;
             failure: (projectName: string, profileName?: string) => string;
@@ -2128,6 +2124,10 @@ export declare const commands: {
                 name: string;
                 platformVersion: string;
             };
+            examples: {
+                default: string;
+                json: string;
+            };
             errors: {
                 noProjectsFound: (accountId: number) => string;
             };
@@ -2161,7 +2161,6 @@ export declare const commands: {
                 uid: string;
             };
             errors: {
-                noProjectConfig: string;
                 projectNotFound: (projectName: string, accountId: number) => string;
                 noDeployedBuild: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
@@ -2223,7 +2222,6 @@ export declare const commands: {
                 profile: string;
             };
             errors: {
-                noProjectConfig: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 failedToParseProject: string;
                 noAppInProject: string;
@@ -2257,7 +2255,6 @@ export declare const commands: {
                 json: string;
             };
             errors: {
-                noProjectConfig: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 failedToParseProject: string;
                 noAppInProject: string;
@@ -3548,7 +3545,6 @@ export declare const lib: {
         };
         loadProfile: {
             errors: {
-                noProjectConfig: string;
                 profileNotFound: (profileName: string) => string;
                 missingAccountId: (profileName: string) => string;
                 listedAccountNotFound: (accountId: number, profileName: string) => string;
@@ -3590,12 +3586,6 @@ export declare const lib: {
         };
         validateProjectConfig: {
             configNotFound: string;
-            configMissingFields: (missingFields: string[]) => string;
-            srcDirNotFound: (srcDir: string, projectDir: string) => string;
-            srcOutsideProjectDir: (projectConfig: string, srcDir: string) => string;
-        };
-        getProjectConfig: {
-            error: string;
         };
         platformVersion: {
             unsupported: (currentCliVersion: string, latestSupported: string, platformVersion?: string) => string;

package/lang/en.js

@@ -1482,7 +1482,6 @@ export const commands = {
                     duplicateTargetAccount: (targetAccountId) => `The account ${uiAccountDescription(targetAccountId)} is being used in an existing profile. Make sure to edit your project's name between uploads if you do not want to overwrite the existing project in this account.`,
                 },
                 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',
@@ -1515,7 +1514,6 @@ export const commands = {
                     deleteProjectPrompt: (accountId) => `Would you like to delete this project from ${uiAccountDescription(accountId)}?`,
                 },
                 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.',
@@ -1539,7 +1537,6 @@ export const commands = {
                 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.`,
                 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.`,
@@ -1665,7 +1662,6 @@ export const commands = {
             describe: 'Migrate an existing project to the new version of the projects framework.',
             errors: {
                 noProjectConfig: (command) => `No project detected. Please run this command again from a project directory.  If you are trying to migrate an app, run ${command}`,
-                noThemeMigrationAccess: (accountId) => `This project contains a CMS theme. You must opt in to theme migration beta to continue updating it on ${uiAccountDescription(accountId)}. Try again with a different account or ${uiLink('join the beta now', getProductUpdatesUrl('253920', accountId))}`,
             },
             examples: {
                 default: 'Migrate an existing project to the new version of the projects framework.',
@@ -1928,9 +1924,11 @@ export const commands = {
                 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.`,
+                uploadingWithProfile: (profileName, accountId) => `Initializing project upload with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
+                uploadingToAccount: (accountId) => `Initializing project upload to account ${uiAccountDescription(accountId)}`,
+                uploadedToAccount: (accountId) => `Project uploaded to ${uiAccountDescription(accountId)}`,
             },
             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')}.`,
@@ -1992,7 +1990,6 @@ export const commands = {
                 fileAlreadyQueued: (filePath) => `File "${filePath}" is already queued for upload`,
             },
             errors: {
-                projectConfigNotFound: 'No project config found. Please ensure that you are in a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${chalk.bold(`hs project dev`)} command for this project. If this is you, unlock the project in Projects UI.`,
                 uploadFailed: (remotePath, filePath) => `Failed to upload file "${filePath}" to "${remotePath}"`,
                 deleteFileFailed: (remotePath) => `Failed to delete file "${remotePath}"`,
@@ -2004,6 +2001,7 @@ export const commands = {
             describe: 'Download your project files from HubSpot.',
             examples: {
                 default: 'Download the project myProject into myProjectFolder folder',
+                json: 'Output the download result as JSON for scripting',
             },
             logs: {
                 downloadCancelled: 'Cancelling project download',
@@ -2059,7 +2057,6 @@ export const commands = {
             installationSuccessful: (directory) => `Installed dependencies in ${directory}`,
             addingDependenciesToLocation: (dependencies, directory) => `Installing ${dependencies} in ${directory}`,
             installingDependenciesFailed: (directory) => `Installing dependencies for ${directory} failed`,
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             noPackageJsonInProject: (projectName) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
             packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
         },
@@ -2077,7 +2074,6 @@ export const commands = {
                 addingLintScripts: 'Adding lint scripts to package.json files…',
                 linting: 'Linting…',
             },
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             failedToReadPackageJson: (packageJsonPath) => `Failed to read package.json at ${packageJsonPath}`,
             installLintPackagesPrompt: (directories, missingPackages) => {
                 const uniquePackages = Array.from(new Set(missingPackages)).sort();
@@ -2119,7 +2115,6 @@ export const commands = {
             updateSuccessful: (directory) => `Updated dependencies in ${directory}`,
             updatingDependenciesToLocation: (dependencies, directory) => `Updating ${dependencies} in ${directory}`,
             updatingDependenciesFailed: (directory) => `Updating dependencies for ${directory} failed`,
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             noPackageJsonInProject: (projectName) => `No dependencies to update. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
             packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
         },
@@ -2130,6 +2125,7 @@ export const commands = {
             examples: {
                 default: 'Validate the project before uploading',
                 withProfile: 'Validate the project with a profile before uploading.',
+                json: 'Output validation results as JSON for scripting',
             },
             success: (projectName) => `Project ${projectName} is valid and ready to upload`,
             failure: (projectName, profileName) => `Project ${projectName} is invalid${profileName ? ` with profile "${profileName}" applied` : ''}`,
@@ -2156,6 +2152,10 @@ export const commands = {
                 name: 'Name',
                 platformVersion: 'Platform Version',
             },
+            examples: {
+                default: 'List projects in the target account',
+                json: 'Output as JSON for scripting',
+            },
             errors: {
                 noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
             },
@@ -2189,7 +2189,6 @@ export const commands = {
                 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.`,
@@ -2248,7 +2247,6 @@ export const commands = {
                 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.',
@@ -2282,7 +2280,6 @@ export const commands = {
                 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.',
@@ -3587,7 +3584,6 @@ export const lib = {
         },
         loadProfile: {
             errors: {
-                noProjectConfig: 'No project config found. Please run this command from a project directory.',
                 profileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} not found.`,
                 missingAccountId: (profileName) => `Profile ${chalk.bold(profileName)} is missing an account id.`,
                 listedAccountNotFound: (accountId, profileName) => `The account ${uiAccountDescription(accountId)} is defined in your profile ${chalk.bold(profileName)}, but is missing in your config file`,
@@ -3629,12 +3625,6 @@ export const lib = {
         },
         validateProjectConfig: {
             configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${uiCommandReference('hs project create')} to create a new project.`,
-            configMissingFields: (missingFields) => `The project configuration file is missing required field${missingFields.length > 1 ? 's' : ''}: ${missingFields.map(f => chalk.bold(f)).join(', ')}`,
-            srcDirNotFound: (srcDir, projectDir) => `Project source directory ${chalk.bold(srcDir)} could not be found in ${chalk.bold(projectDir)}.`,
-            srcOutsideProjectDir: (projectConfig, srcDir) => `Invalid value for 'srcDir' in ${projectConfig}: ${chalk.bold(`srcDir: "${srcDir}"`)}\n\t'srcDir' must be a relative path to a folder under the project root, such as "." or "./src"`,
-        },
-        getProjectConfig: {
-            error: 'Could not read from project config',
         },
         platformVersion: {
             unsupported: (currentCliVersion, latestSupported, platformVersion) => `Platform version${platformVersion ? ' ' + chalk.bold(platformVersion) : ''} is not officially supported by this version of the CLI (${chalk.bold(currentCliVersion)}).\n\nUpdate your CLI to the latest version with ${uiCommandReference('hs upgrade')} or use a compatible platform version (${chalk.bold(latestSupported)} or earlier).`,

package/lib/app/migrate.js

@@ -39,7 +39,7 @@ export function getUnmigratableReason(reasonCode, projectName, accountId) {
 export function generateFilterAppsByProjectNameFunction(projectConfig) {
     return (app) => {
         if (projectConfig) {
-            return app.projectName === projectConfig?.projectConfig?.name;
+            return app.projectName === projectConfig.projectConfig.name;
         }
         return true;
     };
@@ -70,7 +70,7 @@ export async function validateMigrationApps(appId, derivedAccountId, { migratabl
     if (allApps.length > 1 && projectConfig) {
         throw new Error(lib.migrate.errors.project.multipleApps);
     }
-    if (!projectConfig?.projectConfig) {
+    if (!projectConfig) {
         allApps.forEach(app => {
             if (app.projectName) {
                 app.isMigratable = false;
@@ -80,7 +80,7 @@ export async function validateMigrationApps(appId, derivedAccountId, { migratabl
         });
     }
     if (allApps.length === 0 && projectConfig) {
-        throw new Error(lib.migrate.errors.noAppsForProject(projectConfig?.projectConfig?.name || ''));
+        throw new Error(lib.migrate.errors.noAppsForProject(projectConfig.projectConfig.name));
     }
     if (allApps.length === 0 || !allApps.some(app => app.isMigratable)) {
         const reasons = unmigratableApps.map(app => `${chalk.bold(app.appName)}: ${getUnmigratableReason(app.unmigratableReason, app.projectName, derivedAccountId)}`);
@@ -173,9 +173,7 @@ export async function handleMigrationSetup(derivedAccountId, options, projectCon
         return {};
     }
     // If it's a project we don't want to prompt for dest and name, so just return early
-    if (projectConfig &&
-        projectConfig?.projectConfig &&
-        projectConfig?.projectDir) {
+    if (projectConfig) {
         return {
             appIdToMigrate,
             projectName: projectConfig.projectConfig.name,
@@ -309,7 +307,7 @@ export async function downloadProjectFiles(derivedAccountId, projectName, buildI
         });
         const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, buildId);
         let absoluteDestPath;
-        if (projectConfig?.projectConfig && projectConfig?.projectDir) {
+        if (projectConfig) {
             const { projectDir } = projectConfig;
             absoluteDestPath = projectDir;
             const { srcDir } = projectConfig.projectConfig;

package/lib/constants.d.ts

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

package/lib/constants.js

@@ -72,7 +72,6 @@ export const APP_AUTH_TYPES = {
 export const FEATURES = {
     UNIFIED_APPS: 'Developers:UnifiedApps:PrivateBeta',
     APP_EVENTS: 'Developers:UnifiedApps:AppEventsAccess',
-    THEME_MIGRATION_2025_2: 'Developers:ProjectThemeMigrations:2025.2',
     AGENT_TOOLS: 'ThirdPartyAgentTools',
     APP_ACTIONS: 'Developers:AppActions',
 };