@hubspot/cli 8.14.0-beta.1 → 8.15.0-beta.0

package/commands/cms/theme/preview.js

@@ -35,7 +35,14 @@ function validateSrcPath(src) {
 async function determineSrcAndDest(args) {
     let absoluteSrc;
     let dest;
-    const { projectDir, projectConfig } = await getProjectConfig();
+    let projectDir;
+    let projectConfig;
+    try {
+        ({ projectDir, projectConfig } = getProjectConfig());
+    }
+    catch {
+        // Not in a project (handled below)
+    }
     if (!(projectDir && projectConfig)) {
         // Not in a project, prompt for src and dest of traditional theme
         const previewPromptAnswers = await previewPrompt(args);

package/commands/getStarted.js

@@ -7,7 +7,7 @@ import { commands } from '../lang/en.js';
 import { GET_STARTED_OPTIONS, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, PROJECT_CONFIG_FILE, } from '../lib/constants.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { debugError, logError } from '../lib/errorHandlers/index.js';
-import { getProjectConfig, validateProjectConfig, writeProjectConfig, } from '../lib/projects/config.js';
+import { getProjectConfig, writeProjectConfig, ProjectConfigValidationError, } from '../lib/projects/config.js';
 import { handleProjectUpload } from '../lib/projects/upload.js';
 import { projectNameAndDestPrompt } from '../lib/prompts/projectNameAndDestPrompt.js';
 import { promptUser } from '../lib/prompts/promptUtils.js';
@@ -20,7 +20,6 @@ import { pollProjectBuildAndDeploy } from '../lib/projects/pollProjectBuildAndDe
 import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { getStaticAuthAppInstallUrl } from '../lib/app/urls.js';
-import ProjectValidationError from '../lib/errors/ProjectValidationError.js';
 import { openLink } from '../lib/links.js';
 import { runGetStartedV2 } from '../lib/getStarted/getStartedV2.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
@@ -98,10 +97,14 @@ async function handler(args) {
         uiLogger.log(commands.getStarted.logs.appSelected);
         const { dest, name } = await projectNameAndDestPrompt(args);
         const projectDest = path.resolve(getCwd(), dest);
-        const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await getProjectConfig(projectDest);
-        if (existingProjectConfig &&
-            existingProjectDir &&
-            projectDest.startsWith(existingProjectDir)) {
+        let existingProjectDir;
+        try {
+            existingProjectDir = getProjectConfig(projectDest).projectDir;
+        }
+        catch {
+            // Not in a project directory
+        }
+        if (existingProjectDir && projectDest.startsWith(existingProjectDir)) {
             // Track nested project error
             await trackCommandMetadataUsage('get-started', {
                 successful: false,
@@ -167,29 +170,21 @@ async function handler(args) {
         if (shouldUpload) {
             try {
                 // Get the project config for the newly created project
-                const { projectConfig: newProjectConfig, projectDir: newProjectDir } = await getProjectConfig(projectDest);
-                if (!newProjectConfig || !newProjectDir) {
-                    // Track config file not found error
-                    await trackCommandMetadataUsage('get-started', {
-                        successful: false,
-                        step: 'config-file-not-found',
-                    }, derivedAccountId);
-                    uiLogger.log(' ');
-                    uiLogger.error(commands.getStarted.errors.configFileNotFound);
-                    return exit(EXIT_CODES.ERROR);
-                }
+                let newProjectConfig;
+                let newProjectDir;
                 try {
-                    validateProjectConfig(newProjectConfig, newProjectDir);
+                    ({ projectConfig: newProjectConfig, projectDir: newProjectDir } =
+                        getProjectConfig(projectDest));
                 }
                 catch (error) {
-                    if (error instanceof ProjectValidationError) {
+                    if (error instanceof ProjectConfigValidationError) {
                         // Track validation error
                         await trackCommandMetadataUsage('get-started', {
                             successful: false,
                             step: 'project-validation-failed',
                         }, derivedAccountId);
                         uiLogger.log(' ');
-                        uiLogger.error(error.message);
+                        uiLogger.error(error.message || commands.getStarted.errors.configFileNotFound);
                         return exit(EXIT_CODES.ERROR);
                     }
                     throw error;

package/commands/project/add.js

@@ -1,5 +1,5 @@
 import { logError } from '../../lib/errorHandlers/index.js';
-import { getProjectConfig } from '../../lib/projects/config.js';
+import { getIsInProject, getProjectConfig } from '../../lib/projects/config.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
@@ -14,12 +14,13 @@ const command = 'add';
 const describe = commands.project.add.describe;
 async function handler(args) {
     const { derivedAccountId, exit } = args;
+    const isInProjectDir = getIsInProject();
+    if (!isInProjectDir) {
+        uiLogger.error(commands.project.add.error.locationInProject);
+        return exit(EXIT_CODES.ERROR);
+    }
     try {
-        const { projectConfig, projectDir } = await getProjectConfig();
-        if (!projectDir || !projectConfig) {
-            uiLogger.error(commands.project.add.error.locationInProject);
-            return exit(EXIT_CODES.ERROR);
-        }
+        const { projectConfig, projectDir } = getProjectConfig();
         const isLegacyProjectCreate = isLegacyProject(projectConfig.platformVersion);
         if (!isLegacyProjectCreate) {
             await v2AddComponent(args, projectDir, projectConfig, derivedAccountId);

package/commands/project/appInstallStatus.d.ts

@@ -1,5 +1,5 @@
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-import { InstallStatusJsonOutput } from '../../lib/jsonOutput.js';
+import { InstallStatusJsonOutput } from '../../lib/jsonOutput/appInstallStatus.js';
 export type ProjectInstallStatusArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<InstallStatusJsonOutput>;
 declare const projectInstallStatusCommand: YargsCommandModule<unknown, ProjectInstallStatusArgs>;
 export default projectInstallStatusCommand;

package/commands/project/appInstallStatus.js

@@ -5,7 +5,7 @@ import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { translateForLocalDev } from '@hubspot/project-parsing-lib/translate';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
-import { InstallStatusSchema, } from '../../lib/jsonOutput.js';
+import { InstallStatusSchema, } from '../../lib/jsonOutput/appInstallStatus.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { ApiErrorContext, debugError, logError, } from '../../lib/errorHandlers/index.js';
@@ -18,9 +18,13 @@ const command = 'app-install-status';
 const describe = commands.project.installStatus.describe;
 async function handler(args) {
     const { derivedAccountId, formatOutputAsJson, exit, addJsonOutput } = args;
-    const { projectConfig, projectDir } = await getProjectConfig();
-    if (!projectConfig || !projectDir) {
-        uiLogger.error(commands.project.installStatus.errors.noProjectConfig);
+    let projectConfig;
+    let projectDir;
+    try {
+        ({ projectConfig, projectDir } = getProjectConfig());
+    }
+    catch (error) {
+        logError(error);
         return exit(EXIT_CODES.ERROR);
     }
     if (isLegacyProject(projectConfig.platformVersion)) {

package/commands/project/create.js

@@ -15,6 +15,7 @@ import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { handleProjectCreationFlow, } from '../../lib/projects/create/index.js';
+import { getProjectCreateFailureReason } from '../../lib/projects/create/tracking.js';
 import { updateHsMetaFilesWithAutoGeneratedFields } from '../../lib/projects/components.js';
 import SpinniesManager from '../../lib/ui/SpinniesManager.js';
 import { showMcpPromotionNudge } from '../../lib/mcp/promotion.js';
@@ -24,6 +25,10 @@ const BETA_VERSIONS = [
     PLATFORM_VERSIONS.v2026_09_BETA,
     PLATFORM_VERSIONS.v2026_03_BETA,
 ];
+const TRACKING_STEP = {
+    CREATION_FLOW: 'project-creation-flow',
+    DOWNLOAD: 'download-project',
+};
 async function handler(args) {
     const { platformVersion, templateSource, exit, addUsageMetadata } = args;
     if (BETA_VERSIONS.includes(platformVersion)) {
@@ -39,6 +44,9 @@ async function handler(args) {
         handleResult = await handleProjectCreationFlow(args);
     }
     catch (error) {
+        addUsageMetadata({
+            step: `${TRACKING_STEP.CREATION_FLOW}:${getProjectCreateFailureReason(error)}`,
+        });
         logError(error);
         return exit(EXIT_CODES.ERROR);
     }
@@ -51,13 +59,16 @@ async function handler(args) {
                 .join(','),
     });
     const projectDest = path.resolve(getCwd(), projectNameAndDestPromptResponse.dest);
-    const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await getProjectConfig(projectDest);
     // Exit if the target destination is within an existing project
-    if (existingProjectConfig &&
-        existingProjectDir &&
-        projectDest.startsWith(existingProjectDir)) {
-        uiLogger.error(commands.project.create.errors.cannotNestProjects(existingProjectDir));
-        return exit(EXIT_CODES.ERROR);
+    try {
+        const { projectDir: existingProjectDir } = getProjectConfig(projectDest);
+        if (projectDest.startsWith(existingProjectDir)) {
+            uiLogger.error(commands.project.create.errors.cannotNestProjects(existingProjectDir));
+            return exit(EXIT_CODES.ERROR);
+        }
+    }
+    catch {
+        // Not in a project directory, which is the expected case for create
     }
     const components = generateComponentPaths({
         selectProjectTemplatePromptResponse,
@@ -80,6 +91,9 @@ async function handler(args) {
         });
     }
     catch (err) {
+        addUsageMetadata({
+            step: `${TRACKING_STEP.DOWNLOAD}:${getProjectCreateFailureReason(err)}`,
+        });
         SpinniesManager.fail('project-create', {
             text: commands.project.create.failure(isProjectEmpty, projectNameAndDestPromptResponse.name),
         });

package/commands/project/delete.js

@@ -23,7 +23,7 @@ async function handler(args) {
         if (!force) {
             await confirmDeletion(projectName, derivedAccountId, projectId);
         }
-        if (!isLegacyProject(platformVersion) && hasUnifiedComponents) {
+        if (hasUnifiedComponents && !isLegacyProject(platformVersion)) {
             await deleteDeployedComponents(derivedAccountId, projectName);
         }
         await handleProjectDeletion(derivedAccountId, projectName);

package/commands/project/deploy.d.ts

@@ -1,5 +1,5 @@
 import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-import { DeployJsonOutput } from '../../lib/jsonOutput.js';
+import { DeployJsonOutput } from '../../lib/jsonOutput/deploy.js';
 export type ProjectDeployArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<DeployJsonOutput> & {
     project?: string;
     build?: number;

package/commands/project/deploy.js

@@ -3,14 +3,14 @@ import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
-import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
+import { getProjectConfig } from '../../lib/projects/config.js';
 import { projectNamePrompt } from '../../lib/prompts/projectNamePrompt.js';
 import { projectProfilePrompt } from '../../lib/prompts/projectProfilePrompt.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
-import { DeploySchema } from '../../lib/jsonOutput.js';
+import { DeploySchema } from '../../lib/jsonOutput/deploy.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { loadProfile } from '../../lib/projects/projectProfiles.js';
 import { PROJECT_DEPLOY_TEXT } from '../../lib/constants.js';
@@ -25,22 +25,24 @@ async function handler(args) {
     const accountConfig = getConfigAccountById(derivedAccountId);
     const accountType = accountConfig && accountConfig.accountType;
     let targetAccountId;
-    const { projectConfig, projectDir } = await getProjectConfig();
+    let loadedConfig;
     let isInProjectDirectory = false;
-    // Validate project config, but it's valid to run this command from outside a project dir
     try {
-        validateProjectConfig(projectConfig, projectDir);
+        loadedConfig = getProjectConfig();
         isInProjectDirectory = true;
     }
-    catch (e) { }
+    catch (e) {
+        // Do nothing, it's valid to run this command from outside a project dir
+    }
     if (isInProjectDirectory &&
-        !isLegacyProject(projectConfig?.platformVersion)) {
+        loadedConfig &&
+        !isLegacyProject(loadedConfig.projectConfig.platformVersion)) {
         try {
-            const profileName = await projectProfilePrompt(projectDir, projectConfig, profileOption, !!useEnvOption);
+            const profileName = await projectProfilePrompt(loadedConfig.projectDir, loadedConfig.projectConfig, profileOption, !!useEnvOption);
             if (profileName) {
                 // Use loadProfile instead of loadAndValidateProfile because the local
                 // profile does not need to be valid to successfully deploy
-                const profile = loadProfile(projectConfig, projectDir, profileName);
+                const profile = loadProfile(loadedConfig.projectConfig, loadedConfig.projectDir, profileName);
                 targetAccountId = profile.accountId;
                 uiLogger.log(commands.project.deploy.profileMessage(profileName, targetAccountId));
                 uiLogger.log('');
@@ -58,8 +60,8 @@ async function handler(args) {
         addUsageMetadata({ type: accountType });
     }
     let projectName = projectOption;
-    if (!projectOption && projectConfig) {
-        projectName = projectConfig.name;
+    if (!projectOption && loadedConfig) {
+        projectName = loadedConfig.projectConfig.name;
     }
     const namePromptResponse = await projectNamePrompt(targetAccountId, {
         project: projectName,
@@ -116,7 +118,7 @@ async function handler(args) {
         catch {
             return exit(EXIT_CODES.ERROR);
         }
-        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isLegacyProject(projectConfig?.platformVersion), forceOption);
+        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isLegacyProject(loadedConfig?.projectConfig.platformVersion), forceOption);
         if (!deployResult) {
             return exit(EXIT_CODES.ERROR);
         }

package/commands/project/dev/index.js

@@ -1,5 +1,5 @@
 import { getConfigAccountIfExists } from '@hubspot/local-dev-lib/config';
-import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
+import { getProjectConfig } from '../../../lib/projects/config.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { uiLine } from '../../../lib/ui/index.js';
 import { makeWrappedYargsHandler } from '../../../lib/yargs/makeWrappedYargsHandler.js';
@@ -17,18 +17,15 @@ const command = 'dev';
 const describe = commands.project.dev.describe;
 async function handler(args) {
     const { derivedAccountId, testingAccount, projectAccount, profile: profileOption, exit, addUsageMetadata, } = args;
-    const { projectConfig, projectDir } = await getProjectConfig();
+    let projectConfig;
+    let projectDir;
     try {
-        validateProjectConfig(projectConfig, projectDir);
+        ({ projectConfig, projectDir } = getProjectConfig());
     }
     catch (error) {
         logError(error);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!projectDir) {
-        uiLogger.error(commands.project.dev.errors.noProjectConfig);
-        return exit(EXIT_CODES.ERROR);
-    }
     if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.dev.errors.unsupportedPlatformVersion(projectConfig.platformVersion));
         return exit(EXIT_CODES.ERROR);

package/commands/project/download.js

@@ -4,7 +4,7 @@ import { extractZipArchive } from '@hubspot/local-dev-lib/archive';
 import { downloadProject, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
-import { getProjectConfig } from '../../lib/projects/config.js';
+import { getIsInProject } from '../../lib/projects/config.js';
 import { downloadProjectPrompt } from '../../lib/prompts/downloadProjectPrompt.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
@@ -15,8 +15,8 @@ const command = 'download';
 const describe = commands.project.download.describe;
 async function handler(args) {
     const { dest, build, derivedAccountId, exit } = args;
-    const { projectConfig } = await getProjectConfig();
-    if (projectConfig) {
+    const isInProjectDir = getIsInProject();
+    if (isInProjectDir) {
         uiLogger.error(commands.project.download.warnings.cannotDownloadWithinProject);
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/info.d.ts

@@ -1,5 +1,5 @@
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-import { ProjectInfoJsonOutput } from '../../lib/jsonOutput.js';
+import { ProjectInfoJsonOutput } from '../../lib/jsonOutput/info.js';
 export type ProjectInfoArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ProjectInfoJsonOutput>;
 declare const projectInfoCommand: YargsCommandModule<unknown, ProjectInfoArgs>;
 export default projectInfoCommand;

package/commands/project/info.js

@@ -1,22 +1,25 @@
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
-import { debugError } from '../../lib/errorHandlers/index.js';
+import { debugError, logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { commands } from '../../lang/en.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { getProjectInfo, logProjectInfo, } from '../../lib/projects/projectInfo.js';
-import { ProjectInfoSchema, } from '../../lib/jsonOutput.js';
+import { ProjectInfoSchema, } from '../../lib/jsonOutput/info.js';
 const command = 'info';
 const describe = commands.project.info.describe;
 const verboseDescribe = commands.project.info.verboseDescribe;
 async function handler(args) {
     const { derivedAccountId, formatOutputAsJson, exit, addJsonOutput } = args;
-    const { projectConfig } = await getProjectConfig();
-    if (!projectConfig) {
-        uiLogger.error(commands.project.info.errors.noProjectConfig);
+    let projectConfig;
+    try {
+        ({ projectConfig } = getProjectConfig());
+    }
+    catch (error) {
+        logError(error);
         return exit(EXIT_CODES.ERROR);
     }
     if (isLegacyProject(projectConfig.platformVersion)) {

package/commands/project/installApp.d.ts

@@ -1,5 +1,5 @@
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-import { InstallAppJsonOutput } from '../../lib/jsonOutput.js';
+import { InstallAppJsonOutput } from '../../lib/jsonOutput/installApp.js';
 export type ProjectInstallAppArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<InstallAppJsonOutput> & {
     force: boolean;
     profile?: string;

package/commands/project/installApp.js

@@ -1,9 +1,10 @@
 import { getConfigAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
-import { InstallAppSchema, } from '../../lib/jsonOutput.js';
+import { InstallAppSchema, } from '../../lib/jsonOutput/installApp.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
+import { logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { commands } from '../../lang/en.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
@@ -15,9 +16,13 @@ const describe = commands.project.installApp.describe;
 const verboseDescribe = commands.project.installApp.verboseDescribe;
 async function handler(args) {
     const { derivedAccountId, formatOutputAsJson, force, profile: profileOption, useEnv: useEnvOption, exit, addJsonOutput, } = args;
-    const { projectConfig, projectDir } = await getProjectConfig();
-    if (!projectConfig || !projectDir) {
-        uiLogger.error(commands.project.installApp.errors.noProjectConfig);
+    let projectConfig;
+    let projectDir;
+    try {
+        ({ projectConfig, projectDir } = getProjectConfig());
+    }
+    catch (error) {
+        logError(error);
         return exit(EXIT_CODES.ERROR);
     }
     if (isLegacyProject(projectConfig.platformVersion)) {

package/commands/project/installDeps.js

@@ -5,7 +5,6 @@ import { getProjectConfig } from '../../lib/projects/config.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import path from 'path';
 import { commands } from '../../lang/en.js';
-import { uiLogger } from '../../lib/ui/logger.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
@@ -15,12 +14,14 @@ const describe = commands.project.installDeps.help.describe;
 async function handler(args) {
     const { packages, exit } = args;
     try {
-        const projectConfig = await getProjectConfig();
-        if (!projectConfig || !projectConfig.projectDir) {
-            uiLogger.error(commands.project.installDeps.noProjectConfig);
+        let projectDir;
+        try {
+            ({ projectDir } = getProjectConfig());
+        }
+        catch (error) {
+            logError(error);
             return exit(EXIT_CODES.ERROR);
         }
-        const { projectDir } = projectConfig;
         let installLocations = await getProjectPackageJsonLocations();
         if (packages) {
             const { selectedInstallLocations } = await promptUser([

package/commands/project/lint.js

@@ -17,16 +17,23 @@ const describe = commands.project.lint.help.describe;
 async function handler(args) {
     const { installMissingDeps, exit } = args;
     try {
-        const projectConfig = await getProjectConfig();
-        if (!projectConfig || !projectConfig.projectDir) {
-            uiLogger.error(commands.project.lint.noProjectConfig);
+        let projectConfig;
+        let projectDir;
+        try {
+            ({ projectConfig, projectDir } = getProjectConfig());
+        }
+        catch (error) {
+            logError(error);
             return exit(EXIT_CODES.ERROR);
         }
         SpinniesManager.init({ succeedColor: 'white' });
         SpinniesManager.add('lintCheck', {
             text: commands.project.lint.loading.checking,
         });
-        const lintLocations = await getUieLintablePackageJsonLocations(projectConfig);
+        const lintLocations = await getUieLintablePackageJsonLocations({
+            projectConfig,
+            projectDir,
+        });
         const locationsReadyToLint = [];
         const locationsNeedingPackages = new Map();
         let skippedDirectoryCount = 0;
@@ -44,7 +51,7 @@ async function handler(args) {
         SpinniesManager.succeed('lintCheck');
         if (locationsNeedingPackages.size > 0) {
             const locationsArray = Array.from(locationsNeedingPackages.keys());
-            const relativeLocations = locationsArray.map(loc => path.relative(projectConfig.projectDir, loc));
+            const relativeLocations = locationsArray.map(loc => path.relative(projectDir, loc));
             const allMissingPackages = [];
             for (const packages of locationsNeedingPackages.values()) {
                 allMissingPackages.push(...packages);
@@ -94,7 +101,7 @@ async function handler(args) {
                 const hasModernConfig = hasEslintConfig(location);
                 const hasDeprecatedConfig = hasDeprecatedEslintConfig(location);
                 if (hasDeprecatedConfig) {
-                    const relativePath = path.relative(projectConfig.projectDir, location);
+                    const relativePath = path.relative(projectDir, location);
                     const deprecatedFiles = getDeprecatedEslintConfigFiles(location);
                     deprecatedConfigDetails.push({
                         path: relativePath,
@@ -110,7 +117,7 @@ async function handler(args) {
                 uiLogger.warn(commands.project.lint.deprecatedEslintConfigWarning(deprecatedConfigDetails));
             }
             if (locationsNeedingConfig.length > 0) {
-                const relativeLocations = locationsNeedingConfig.map(loc => path.relative(projectConfig.projectDir, loc));
+                const relativeLocations = locationsNeedingConfig.map(loc => path.relative(projectDir, loc));
                 const { shouldCreateConfig } = await promptUser([
                     {
                         name: 'shouldCreateConfig',
@@ -123,7 +130,7 @@ async function handler(args) {
                     SpinniesManager.add('lintConfigCreate', {
                         text: commands.project.lint.loading.creatingConfig,
                     });
-                    const platformVersion = projectConfig.projectConfig?.platformVersion ?? null;
+                    const platformVersion = projectConfig.platformVersion ?? null;
                     const createdConfigs = [];
                     for (const location of locationsNeedingConfig) {
                         const configPath = await createEslintConfig(location, platformVersion);
@@ -159,7 +166,7 @@ async function handler(args) {
             SpinniesManager.add('lintRun', {
                 text: commands.project.lint.loading.linting,
             });
-            const { success, results } = await lintPackages(locationsReadyToLint, projectConfig.projectDir);
+            const { success, results } = await lintPackages(locationsReadyToLint, projectDir);
             SpinniesManager.succeed('lintRun');
             displayLintResults(results);
             if (!success) {

package/commands/project/list.d.ts

@@ -1,4 +1,5 @@
-import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs.js';
-type ProjectListArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs;
+import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
+import { ProjectListJsonOutput } from '../../lib/jsonOutput/projectList.js';
+export type ProjectListArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ProjectListJsonOutput>;
 declare const projectListCommand: YargsCommandModule<unknown, ProjectListArgs>;
 export default projectListCommand;

package/commands/project/list.js

@@ -6,6 +6,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { commands } from '../../lang/en.js';
 import { renderTable } from '../../ui/render.js';
+import { ProjectListSchema, mapProjectToListItem, } from '../../lib/jsonOutput/projectList.js';
 const command = ['list', 'ls'];
 const describe = commands.project.list.describe;
 async function getProjectData(accountId) {
@@ -23,7 +24,7 @@ function formatProjectsAsTableRows(projects) {
     return projectListData;
 }
 async function handler(args) {
-    const { derivedAccountId, exit } = args;
+    const { derivedAccountId, formatOutputAsJson, exit, addJsonOutput } = args;
     let projectData;
     try {
         projectData = await getProjectData(derivedAccountId);
@@ -33,9 +34,20 @@ async function handler(args) {
         return exit(EXIT_CODES.ERROR);
     }
     if (projectData.length === 0) {
+        if (formatOutputAsJson) {
+            addJsonOutput({ accountId: derivedAccountId, results: [] });
+            return exit(EXIT_CODES.SUCCESS);
+        }
         uiLogger.error(commands.project.list.errors.noProjectsFound(derivedAccountId));
         return exit(EXIT_CODES.ERROR);
     }
+    if (formatOutputAsJson) {
+        addJsonOutput({
+            accountId: derivedAccountId,
+            results: projectData.map(mapProjectToListItem),
+        });
+        return exit(EXIT_CODES.SUCCESS);
+    }
     const projectListData = formatProjectsAsTableRows(projectData);
     const tableHeader = [
         commands.project.list.labels.name,
@@ -45,7 +57,10 @@ async function handler(args) {
     renderTable(tableHeader, projectListData);
 }
 function projectListBuilder(yargs) {
-    yargs.example([['$0 project list']]);
+    yargs.example([
+        ['$0 project list', commands.project.list.examples.default],
+        ['$0 project list --json', commands.project.list.examples.json],
+    ]);
     return yargs;
 }
 const builder = makeYargsBuilder(projectListBuilder, command, describe, {
@@ -53,11 +68,14 @@ const builder = makeYargsBuilder(projectListBuilder, command, describe, {
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
 });
 const projectListCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-list', handler),
+    handler: makeWrappedYargsHandler('project-list', handler, {
+        jsonOutputSchema: ProjectListSchema,
+    }),
     builder,
 };
 export default projectListCommand;

package/commands/project/listBuilds.d.ts

@@ -1,5 +1,5 @@
 import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-import { ProjectBuildsListJsonOutput } from '../../lib/jsonOutput.js';
+import { ProjectBuildsListJsonOutput } from '../../lib/jsonOutput/listBuilds.js';
 export type ProjectListBuildsArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ProjectBuildsListJsonOutput> & {
     project?: string;
     limit?: number;