@hubspot/cli 8.11.0-beta.0 → 8.12.0

package/commands/account/clean.js

@@ -120,7 +120,7 @@ const builder = makeYargsBuilder(accountCleanBuilder, command, describe, {
 const accountCleanCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('accounts-clean', handler),
+    handler: makeWrappedYargsHandler('account-clean', handler),
     builder,
 };
 export default accountCleanCommand;

package/commands/account/list.js

@@ -57,7 +57,7 @@ const builder = makeYargsBuilder(accountListBuilder, command, describe, {
 const accountListCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('accounts-list', handler),
+    handler: makeWrappedYargsHandler('account-list', handler),
     builder,
 };
 export default accountListCommand;

package/commands/account/remove.js

@@ -82,7 +82,7 @@ const builder = makeYargsBuilder(accountRemoveBuilder, command, describe, {
 const accountRemoveCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('accounts-remove', handler),
+    handler: makeWrappedYargsHandler('account-remove', handler),
     builder,
 };
 export default accountRemoveCommand;

package/commands/account/rename.js

@@ -44,7 +44,7 @@ const builder = makeYargsBuilder(accountRenameBuilder, command, describe, {
 const accountRenameCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('accounts-rename', handler),
+    handler: makeWrappedYargsHandler('account-rename', handler),
     builder,
 };
 export default accountRenameCommand;

package/commands/account/use.js

@@ -146,7 +146,7 @@ const builder = makeYargsBuilder(accountUseBuilder, command, describe, {
 const accountUseCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('accounts-use', handler),
+    handler: makeWrappedYargsHandler('account-use', handler),
     builder,
 };
 export default accountUseCommand;

package/commands/api.d.ts

@@ -1,7 +1,10 @@
 import { CommonArgs, ConfigArgs, EnvironmentArgs, AccountArgs, JSONOutputArgs, YargsCommandModule } from '../types/Yargs.js';
 declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE"];
 type HttpMethod = (typeof HTTP_METHODS)[number];
-export type ApiArgs = CommonArgs & ConfigArgs & EnvironmentArgs & AccountArgs & JSONOutputArgs & {
+type JSONValue = string | number | boolean | null | {
+    [key: string]: JSONValue;
+} | Array<JSONValue>;
+export type ApiArgs = CommonArgs & ConfigArgs & EnvironmentArgs & AccountArgs & JSONOutputArgs<Record<string, JSONValue>> & {
     endpoint: string;
     method?: HttpMethod;
     data?: string;

package/commands/api.js

@@ -29,7 +29,7 @@ function normalizeEndpoint(endpoint) {
     return endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;
 }
 async function handler(args) {
-    const { endpoint, data, derivedAccountId, json: formatOutputAsJson, exit, addUsageMetadata, } = args;
+    const { endpoint, data, derivedAccountId, json: formatOutputAsJson, exit, addUsageMetadata, addJsonOutput, } = args;
     const method = resolveMethod(args);
     addUsageMetadata({ action: method });
     let parsedData;
@@ -79,10 +79,8 @@ async function handler(args) {
         }
         if (response !== undefined) {
             const responseData = response.data;
-            if (formatOutputAsJson) {
-                uiLogger.json(responseData);
-            }
-            else {
+            addJsonOutput(responseData);
+            if (!formatOutputAsJson) {
                 uiLogger.log(commands.api.responseLog);
                 uiLogger.log(JSON.stringify(responseData, null, 2));
             }
@@ -99,20 +97,19 @@ async function handler(args) {
         }
         debugError(error, errorContext);
         const errorData = error.data;
-        if (formatOutputAsJson && errorData) {
-            uiLogger.json(errorData);
+        if (errorData) {
+            addJsonOutput(errorData);
         }
-        else if (errorData) {
+        if (!formatOutputAsJson) {
             if (error.status && error.statusText) {
                 uiLogger.error(commands.api.errors.statusLine(error.status, error.statusText));
             }
-            uiLogger.log(JSON.stringify(errorData, null, 2));
-        }
-        else {
-            if (error.status && error.statusText) {
-                uiLogger.error(commands.api.errors.statusLine(error.status, error.statusText));
+            if (errorData) {
+                uiLogger.log(JSON.stringify(errorData, null, 2));
+            }
+            else {
+                uiLogger.error(error.message);
             }
-            uiLogger.error(error.message);
         }
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/appInstallStatus.d.ts

@@ -1,4 +1,5 @@
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-export type ProjectInstallStatusArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs;
+import { InstallStatusJsonOutput } from '../../lib/jsonOutput.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,6 +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 { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { ApiErrorContext, debugError, logError, } from '../../lib/errorHandlers/index.js';
@@ -16,7 +17,7 @@ import { APP_AUTH_TYPES } from '../../lib/constants.js';
 const command = 'app-install-status';
 const describe = commands.project.installStatus.describe;
 async function handler(args) {
-    const { derivedAccountId, formatOutputAsJson, exit } = args;
+    const { derivedAccountId, formatOutputAsJson, exit, addJsonOutput } = args;
     const { projectConfig, projectDir } = await getProjectConfig();
     if (!projectConfig || !projectDir) {
         uiLogger.error(commands.project.installStatus.errors.noProjectConfig);
@@ -80,25 +81,24 @@ async function handler(args) {
         }
     }
     const isInstalled = isInstalledWithScopeGroups || previouslyAuthorizedScopeGroups.length > 0;
+    addJsonOutput({
+        appId,
+        appUid: appNode.uid,
+        accountId: derivedAccountId,
+        projectId,
+        isInstalled,
+        isInstalledWithCurrentScopes: isInstalledWithScopeGroups,
+        previouslyAuthorizedScopeGroups,
+    });
     if (formatOutputAsJson) {
-        uiLogger.json({
-            appId,
-            appUid: appNode.uid,
-            accountId: derivedAccountId,
-            projectId,
-            isInstalled,
-            isInstalledWithCurrentScopes: isInstalledWithScopeGroups,
-            previouslyAuthorizedScopeGroups,
-        });
         return exit(isInstalled ? EXIT_CODES.SUCCESS : EXIT_CODES.WARNING);
     }
+    if (isInstalledWithScopeGroups) {
+        uiLogger.success(commands.project.installStatus.success.installed(appNode.config.name, derivedAccountId));
+        return exit(EXIT_CODES.SUCCESS);
+    }
     if (isInstalled) {
-        if (isInstalledWithScopeGroups) {
-            uiLogger.success(commands.project.installStatus.success.installed(appNode.config.name, derivedAccountId));
-        }
-        else {
-            uiLogger.success(commands.project.installStatus.success.installedWithOutdatedScopes(appNode.config.name, derivedAccountId));
-        }
+        uiLogger.success(commands.project.installStatus.success.installedWithOutdatedScopes(appNode.config.name, derivedAccountId));
         return exit(EXIT_CODES.SUCCESS);
     }
     uiLogger.log(commands.project.installStatus.notInstalled(appNode.config.name, derivedAccountId));
@@ -127,7 +127,9 @@ const builder = makeYargsBuilder(projectInstallStatusBuilder, command, describe,
 const projectInstallStatusCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-app-install-status', handler),
+    handler: makeWrappedYargsHandler('project-app-install-status', handler, {
+        jsonOutputSchema: InstallStatusSchema,
+    }),
     builder,
 };
 export default projectInstallStatusCommand;

package/commands/project/create.js

@@ -133,7 +133,6 @@ function projectCreateBuilder(yargs) {
             describe: commands.project.create.options.platformVersion.describe,
             type: 'string',
             choices: [
-                PLATFORM_VERSIONS.v2025_1,
                 PLATFORM_VERSIONS.v2025_2,
                 PLATFORM_VERSIONS.v2026_03_BETA,
                 PLATFORM_VERSIONS.v2026_03,

package/commands/project/deploy.d.ts

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

package/commands/project/deploy.js

@@ -1,6 +1,6 @@
 import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
-import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { 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';
@@ -10,19 +10,21 @@ 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 { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { loadProfile } from '../../lib/projects/projectProfiles.js';
 import { PROJECT_DEPLOY_TEXT } from '../../lib/constants.js';
 import { commands } from '../../lang/en.js';
 import { handleProjectDeploy, validateBuildIdForDeploy, logDeployErrors, } from '../../lib/projects/deploy.js';
+import { validateBuildForRelease } from '../../lib/projects/release.js';
+import { getLastSuccessfulBuild } from '../../lib/projects/builds.js';
 const command = 'deploy';
 const describe = commands.project.deploy.describe;
 async function handler(args) {
-    const { derivedAccountId, project: projectOption, buildId: buildIdOption, force: forceOption, deployLatestBuild: deployLatestBuildOption, json: formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, exit, addUsageMetadata, } = args;
+    const { derivedAccountId, project: projectOption, buildId: buildIdOption, force: forceOption, deployLatestBuild: deployLatestBuildOption, profile: profileOption, useEnv: useEnvOption, exit, addUsageMetadata, addJsonOutput, } = args;
     const accountConfig = getConfigAccountById(derivedAccountId);
     const accountType = accountConfig && accountConfig.accountType;
     let targetAccountId;
-    const jsonOutput = {};
     const { projectConfig, projectDir } = await getProjectConfig();
     let isInProjectDirectory = false;
     // Validate project config, but it's valid to run this command from outside a project dir
@@ -79,16 +81,21 @@ async function handler(args) {
             }
         }
         else {
+            const lastSuccessfulBuild = await getLastSuccessfulBuild(targetAccountId, projectName, latestBuild);
+            if (!lastSuccessfulBuild) {
+                uiLogger.error(commands.project.deploy.errors.noSuccessfulBuilds);
+                return exit(EXIT_CODES.ERROR);
+            }
             if (deployLatestBuildOption) {
-                buildIdToDeploy = latestBuild.buildId;
+                buildIdToDeploy = lastSuccessfulBuild.buildId;
             }
             else {
                 const deployBuildIdPromptResponse = await promptUser({
                     name: 'buildId',
                     message: commands.project.deploy.deployBuildIdPrompt,
-                    default: latestBuild.buildId === deployedBuildId
+                    default: lastSuccessfulBuild.buildId === deployedBuildId
                         ? undefined
-                        : latestBuild.buildId,
+                        : lastSuccessfulBuild.buildId,
                     validate: buildId => validateBuildIdForDeploy(buildId, deployedBuildId, latestBuild.buildId, projectName, targetAccountId),
                 });
                 buildIdToDeploy = deployBuildIdPromptResponse.buildId;
@@ -98,22 +105,33 @@ async function handler(args) {
             uiLogger.error(commands.project.deploy.errors.noBuildId);
             return exit(EXIT_CODES.ERROR);
         }
+        try {
+            const supportsReleases = await validateBuildForRelease(targetAccountId, projectName, buildIdToDeploy);
+            // The deploy verb is not compatible with builds that leverage releases. Use release create instead.
+            if (supportsReleases) {
+                uiLogger.error(commands.project.deploy.errors.notSupportedForBuildVersion);
+                return exit(EXIT_CODES.ERROR);
+            }
+        }
+        catch {
+            return exit(EXIT_CODES.ERROR);
+        }
         const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isLegacyProject(projectConfig?.platformVersion), forceOption);
         if (!deployResult) {
             return exit(EXIT_CODES.ERROR);
         }
-        else if (formatOutputAsJson) {
-            jsonOutput.deployId = deployResult.deployId;
+        else {
+            addJsonOutput({ deployId: deployResult.deployId });
         }
         if (deployResult.status === PROJECT_DEPLOY_TEXT.STATES.SUCCESS) {
             deploySuccess = true;
         }
     }
     catch (e) {
-        if (isHubSpotHttpError(e) && e.status === 404) {
+        if (isSpecifiedError(e, { statusCode: 404 })) {
             uiLogger.error(commands.project.deploy.errors.projectNotFound(targetAccountId, projectName));
         }
-        else if (isHubSpotHttpError(e) && e.status === 400) {
+        else if (isSpecifiedError(e, { statusCode: 400 })) {
             if (e.data?.message && e.data?.errors) {
                 logDeployErrors(e.data);
             }
@@ -129,9 +147,6 @@ async function handler(args) {
         }
         return exit(EXIT_CODES.ERROR);
     }
-    if (formatOutputAsJson) {
-        uiLogger.json(jsonOutput);
-    }
     if (deploySuccess) {
         return exit(EXIT_CODES.SUCCESS);
     }
@@ -194,6 +209,8 @@ const projectDeployCommand = {
     command,
     describe,
     builder,
-    handler: makeWrappedYargsHandler('project-deploy', handler),
+    handler: makeWrappedYargsHandler('project-deploy', handler, {
+        jsonOutputSchema: DeploySchema,
+    }),
 };
 export default projectDeployCommand;

package/commands/project/dev/index.js

@@ -3,7 +3,6 @@ import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { uiLine } from '../../../lib/ui/index.js';
 import { makeWrappedYargsHandler } from '../../../lib/yargs/makeWrappedYargsHandler.js';
-import { deprecatedProjectDevFlow } from './deprecatedFlow.js';
 import { unifiedProjectDevFlow } from './unifiedFlow.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
@@ -16,17 +15,8 @@ import { isPromptExitError } from '../../../lib/errors/PromptExitError.js';
 import { LOCAL_DEV_DEFAULT_PORT } from '../../../lib/constants.js';
 const command = 'dev';
 const describe = commands.project.dev.describe;
-function validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV2) {
-    // Legacy projects do not support targetTestingAccount and targetProjectAccount
-    if (testingAccount && projectAccount && !useV2) {
-        throw new Error(commands.project.dev.errors.unsupportedAccountFlagLegacy);
-    }
-    if (userProvidedAccount && useV2) {
-        throw new Error(commands.project.dev.errors.unsupportedAccountFlagV2);
-    }
-}
 async function handler(args) {
-    const { derivedAccountId, userProvidedAccount, testingAccount, projectAccount, profile: profileOption, exit, addUsageMetadata, } = args;
+    const { derivedAccountId, testingAccount, projectAccount, profile: profileOption, exit, addUsageMetadata, } = args;
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
         validateProjectConfig(projectConfig, projectDir);
@@ -35,28 +25,18 @@ async function handler(args) {
         logError(error);
         return exit(EXIT_CODES.ERROR);
     }
-    const useV2Projects = !isLegacyProject(projectConfig.platformVersion);
     if (!projectDir) {
         uiLogger.error(commands.project.dev.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
     }
-    try {
-        validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV2Projects);
-    }
-    catch (error) {
-        logError(error);
+    if (isLegacyProject(projectConfig.platformVersion)) {
+        uiLogger.error(commands.project.dev.errors.unsupportedPlatformVersion(projectConfig.platformVersion));
         return exit(EXIT_CODES.ERROR);
     }
     uiLogger.log(commands.project.dev.logs.header);
-    if (useV2Projects) {
-        uiLogger.log(commands.project.dev.logs.learnMoreMessageV2);
-    }
-    else {
-        uiLogger.log(commands.project.dev.logs.learnMoreMessageLegacy);
-    }
+    uiLogger.log(commands.project.dev.logs.learnMoreMessageV2);
     let targetProjectAccountId;
     let profile;
-    // Using the new --projectAccount flag
     if (projectAccount) {
         targetProjectAccountId =
             getConfigAccountIfExists(projectAccount)?.accountId;
@@ -64,14 +44,8 @@ async function handler(args) {
             uiLogger.log('');
             uiLogger.log(commands.project.dev.logs.projectAccountFlagExplanation(targetProjectAccountId));
         }
-        // Using the legacy --account flag
     }
-    else if (userProvidedAccount && derivedAccountId) {
-        targetProjectAccountId = derivedAccountId;
-    }
-    // Determine profile name: from flag or prompt
-    if (!targetProjectAccountId &&
-        !isLegacyProject(projectConfig.platformVersion)) {
+    if (!targetProjectAccountId) {
         const profileName = await projectProfilePrompt(projectDir, projectConfig, profileOption);
         if (profileName) {
             try {
@@ -88,36 +62,23 @@ async function handler(args) {
         }
     }
     if (!targetProjectAccountId) {
-        // The user is not using profile or account flags, so we can use the derived accountId
         targetProjectAccountId = derivedAccountId;
-        if (useV2Projects) {
-            uiLogger.log('');
-            uiLogger.log(commands.project.dev.logs.defaultProjectAccountExplanation(targetProjectAccountId));
-        }
+        uiLogger.log('');
+        uiLogger.log(commands.project.dev.logs.defaultProjectAccountExplanation(targetProjectAccountId));
     }
     addUsageMetadata({ accountId: targetProjectAccountId ?? undefined });
     try {
-        if (!isLegacyProject(projectConfig.platformVersion)) {
-            const targetTestingAccountId = testingAccount
-                ? getConfigAccountIfExists(testingAccount)?.accountId
-                : undefined;
-            await unifiedProjectDevFlow({
-                args,
-                targetProjectAccountId,
-                providedTargetTestingAccountId: targetTestingAccountId,
-                projectConfig,
-                projectDir,
-                profileConfig: profile,
-            });
-        }
-        else {
-            await deprecatedProjectDevFlow({
-                args,
-                accountId: targetProjectAccountId,
-                projectConfig,
-                projectDir,
-            });
-        }
+        const targetTestingAccountId = testingAccount
+            ? getConfigAccountIfExists(testingAccount)?.accountId
+            : undefined;
+        await unifiedProjectDevFlow({
+            args,
+            targetProjectAccountId,
+            providedTargetTestingAccountId: targetTestingAccountId,
+            projectConfig,
+            projectDir,
+            profileConfig: profile,
+        });
     }
     catch (e) {
         if (isPromptExitError(e)) {
@@ -144,19 +105,12 @@ function projectDevBuilder(yargs) {
         description: commands.project.dev.options.projectAccount,
         implies: ['testingAccount'],
     });
-    yargs.option('account', {
-        alias: 'a',
-        describe: '',
-        type: 'string',
-        description: commands.project.dev.options.account,
-    });
     yargs.option('port', {
         type: 'number',
         description: commands.project.dev.options.port,
         default: LOCAL_DEV_DEFAULT_PORT,
     });
     yargs.example([['$0 project dev', commands.project.dev.examples.default]]);
-    yargs.conflicts('profile', 'account');
     yargs.conflicts('profile', 'testing-account');
     yargs.conflicts('profile', 'project-account');
     return yargs;

package/commands/project/info.d.ts

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

package/commands/project/info.js

@@ -8,11 +8,12 @@ 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';
 const command = 'info';
 const describe = commands.project.info.describe;
 const verboseDescribe = commands.project.info.verboseDescribe;
 async function handler(args) {
-    const { derivedAccountId, formatOutputAsJson, exit } = args;
+    const { derivedAccountId, formatOutputAsJson, exit, addJsonOutput } = args;
     const { projectConfig } = await getProjectConfig();
     if (!projectConfig) {
         uiLogger.error(commands.project.info.errors.noProjectConfig);
@@ -39,11 +40,10 @@ async function handler(args) {
         return exit(EXIT_CODES.ERROR);
     }
     const projectInfo = await getProjectInfo(project, projectConfig.platformVersion, derivedAccountId);
-    if (formatOutputAsJson) {
-        uiLogger.json(projectInfo);
-        return;
+    addJsonOutput(projectInfo);
+    if (!formatOutputAsJson) {
+        logProjectInfo(projectInfo);
     }
-    logProjectInfo(projectInfo);
 }
 function projectInfoBuilder(yargs) {
     yargs.example([
@@ -62,7 +62,9 @@ const builder = makeYargsBuilder(projectInfoBuilder, command, verboseDescribe, {
 const projectInfoCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-info', handler),
+    handler: makeWrappedYargsHandler('project-info', handler, {
+        jsonOutputSchema: ProjectInfoSchema,
+    }),
     builder,
 };
 export default projectInfoCommand;

package/commands/project/installApp.d.ts

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

package/commands/project/installApp.js

@@ -1,6 +1,7 @@
 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 { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
@@ -13,7 +14,7 @@ const command = 'install-app';
 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, } = 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);
@@ -60,18 +61,16 @@ async function handler(args) {
     const needsReinstall = !isInstalledWithScopeGroups && previouslyAuthorizedScopeGroups.length > 0;
     const installationState = getAppInstallationState(isInstalledWithScopeGroups, previouslyAuthorizedScopeGroups);
     if (isInstalledWithScopeGroups) {
-        if (formatOutputAsJson) {
-            uiLogger.json({
-                appId,
-                appUid: appNode.uid,
-                accountId: installAccountId,
-                projectId,
-                installationState,
-                installed: true,
-                reinstalled: false,
-            });
-        }
-        else {
+        addJsonOutput({
+            appId,
+            appUid: appNode.uid,
+            accountId: installAccountId,
+            projectId,
+            installationState,
+            installed: true,
+            reinstalled: false,
+        });
+        if (!formatOutputAsJson) {
             uiLogger.success(commands.project.installApp.alreadyInstalled(appNode.config.name, installAccountId));
         }
         return exit(EXIT_CODES.SUCCESS);
@@ -117,18 +116,16 @@ async function handler(args) {
     if (!installed) {
         return exit(EXIT_CODES.ERROR);
     }
-    if (formatOutputAsJson) {
-        uiLogger.json({
-            appId,
-            appUid: appNode.uid,
-            accountId: installAccountId,
-            projectId,
-            installationState: APP_INSTALLATION_STATES.INSTALLED,
-            installed: true,
-            reinstalled: needsReinstall,
-        });
-    }
-    else {
+    addJsonOutput({
+        appId,
+        appUid: appNode.uid,
+        accountId: installAccountId,
+        projectId,
+        installationState: APP_INSTALLATION_STATES.INSTALLED,
+        installed: true,
+        reinstalled: needsReinstall,
+    });
+    if (!formatOutputAsJson) {
         uiLogger.success(commands.project.installApp.success(appNode.config.name, installAccountId));
     }
     return exit(EXIT_CODES.SUCCESS);
@@ -175,7 +172,9 @@ const builder = makeYargsBuilder(projectInstallAppBuilder, command, verboseDescr
 const projectInstallAppCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-install-app', handler),
+    handler: makeWrappedYargsHandler('project-install-app', handler, {
+        jsonOutputSchema: InstallAppSchema,
+    }),
     builder,
 };
 export default projectInstallAppCommand;

package/commands/project/list.js

@@ -57,7 +57,7 @@ const builder = makeYargsBuilder(projectListBuilder, command, describe, {
 const projectListCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('projects-list', handler),
+    handler: makeWrappedYargsHandler('project-list', handler),
     builder,
 };
 export default projectListCommand;

package/commands/project/release/create.d.ts

@@ -1,5 +1,6 @@
 import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../../types/Yargs.js';
-export type ProjectReleaseCreateArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs & {
+import { ReleaseJsonOutput } from '../../../lib/jsonOutput.js';
+export type ProjectReleaseCreateArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ReleaseJsonOutput> & {
     build?: number;
     force: boolean;
 };