@hubspot/cli 8.1.0 → 8.1.1-experimental.0

package/commands/init.js

@@ -12,13 +12,15 @@ import { setCLILogLevel } from '../lib/commonOpts.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { handleExit } from '../lib/process.js';
 import { debugError, logError } from '../lib/errorHandlers/index.js';
-import { trackCommandUsage, trackAuthAction } from '../lib/usageTracking.js';
+import { isPromptExitError } from '../lib/errors/PromptExitError.js';
+import { trackAuthAction } from '../lib/usageTracking.js';
 import { promptUser } from '../lib/prompts/promptUtils.js';
 import { OAUTH_FLOW, personalAccessKeyPrompt, } from '../lib/prompts/personalAccessKeyPrompt.js';
 import { cliAccountNamePrompt } from '../lib/prompts/accountNamePrompt.js';
 import { authenticateWithOauth } from '../lib/oauth.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { uiCommandReference, uiFeatureHighlight } from '../lib/ui/index.js';
+import { makeYargsHandlerWithUsageTracking } from '../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { uiLogger } from '../lib/ui/logger.js';
 import { commands } from '../lang/en.js';
 import { parseStringToNumber } from '../lib/parsing.js';
@@ -61,7 +63,7 @@ async function oauthConfigCreationFlow(env) {
     }
     catch (e) {
         logError(e);
-        process.exit(EXIT_CODES.ERROR);
+        throw e;
     }
     return oauthAccount;
 }
@@ -72,7 +74,7 @@ const AUTH_TYPE_NAMES = {
 const command = 'init';
 const describe = commands.init.describe;
 async function handler(args) {
-    const { authType: authTypeFlagValue, c: configFlagValue, disableTracking, userProvidedAccount, } = args;
+    const { authType: authTypeFlagValue, c: configFlagValue, disableTracking, userProvidedAccount, exit, addUsageMetadata, } = args;
     let parsedUserProvidedAccountId;
     try {
         if (userProvidedAccount) {
@@ -81,7 +83,7 @@ async function handler(args) {
     }
     catch (err) {
         uiLogger.error(commands.init.errors.invalidAccountIdProvided);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const authType = (authTypeFlagValue && authTypeFlagValue.toLowerCase()) ||
         PERSONAL_ACCESS_KEY_AUTH_METHOD.value;
@@ -93,22 +95,18 @@ async function handler(args) {
     }
     catch (err) { }
     setCLILogLevel(args);
-    if (!disableTracking) {
-        trackCommandUsage('init', {
-            authType,
-        });
-    }
+    addUsageMetadata({ authType });
     const env = args.qa ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD;
     // Only check for global config if user is not providing a custom config path
     if (!configFlagValue && globalConfigFileExists()) {
         uiLogger.error(commands.init.errors.globalConfigFileExists);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     // Check if the specific config file path already exists
     if (existingConfigPath && existsSync(existingConfigPath)) {
         uiLogger.error(commands.init.errors.configFileExists(existingConfigPath));
         uiLogger.info(commands.init.logs.updateConfig);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     if (!disableTracking) {
         await trackAuthAction('init', authType, TRACKING_STATUS.STARTED, parsedUserProvidedAccountId);
@@ -147,14 +145,17 @@ async function handler(args) {
         if (!disableTracking) {
             await trackAuthAction('init', authType, TRACKING_STATUS.COMPLETE, accountId);
         }
-        process.exit(EXIT_CODES.SUCCESS);
+        return exit(EXIT_CODES.SUCCESS);
     }
     catch (err) {
+        if (isPromptExitError(err)) {
+            throw err;
+        }
         logError(err);
         if (!disableTracking) {
             await trackAuthAction('init', authType, TRACKING_STATUS.ERROR, parsedUserProvidedAccountId);
         }
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
 }
 function initBuilder(yargs) {
@@ -190,7 +191,7 @@ const builder = makeYargsBuilder(initBuilder, command, commands.init.verboseDesc
 const initCommand = {
     command,
     describe,
-    handler,
+    handler: makeYargsHandlerWithUsageTracking('init', handler),
     builder,
 };
 export default initCommand;

package/commands/mcp/setup.js

@@ -1,28 +1,19 @@
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
-import { uiLogger } from '../../lib/ui/logger.js';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { addMcpServerToConfig, supportedTools } from '../../lib/mcp/setup.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
-import { hasFeature } from '../../lib/hasFeature.js';
-import { FEATURES } from '../../lib/constants.js';
 const command = ['setup'];
 const describe = commands.mcp.setup.describe;
 async function handler(args) {
-    const { derivedAccountId } = args;
-    const hasMcpAccess = await hasFeature(derivedAccountId, FEATURES.MCP_ACCESS);
-    if (!hasMcpAccess) {
-        uiLogger.error(commands.mcp.setup.errors.needsMcpAccess(derivedAccountId));
-        process.exit(EXIT_CODES.ERROR);
-    }
-    trackCommandUsage('mcp-setup', {}, args.derivedAccountId);
+    const { exit } = args;
     try {
         await addMcpServerToConfig(args.client);
     }
     catch (e) {
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function setupBuilder(yargs) {
     yargs.option('client', {
@@ -38,7 +29,7 @@ const builder = makeYargsBuilder(setupBuilder, command, describe, {
 const mcpSetupCommand = {
     command,
     describe,
-    handler,
+    handler: makeYargsHandlerWithUsageTracking('mcp-setup', handler),
     builder,
 };
 export default mcpSetupCommand;

package/commands/mcp/start.js

@@ -7,14 +7,13 @@ import { uiLogger } from '../../lib/ui/logger.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { commands } from '../../lang/en.js';
 import { handleExit } from '../../lib/process.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { fileURLToPath } from 'url';
 const command = 'start';
 const describe = undefined; // Leave hidden for now
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 async function handler(args) {
-    trackCommandUsage('mcp-start', {}, args.derivedAccountId);
     await startMcpServer(args.aiAgent);
 }
 async function startMcpServer(aiAgent) {
@@ -28,7 +27,6 @@ async function startMcpServer(aiAgent) {
         uiLogger.debug(commands.mcp.start.startingServer);
         uiLogger.debug(commands.mcp.start.stopInstructions);
         const args = [serverPath];
-        // Start the server using ts-node
         const child = spawn(`node`, args, {
             stdio: 'inherit',
             env: {
@@ -67,7 +65,7 @@ const builder = makeYargsBuilder(startBuilder, command, describe, {
 const mcpStartCommand = {
     command,
     describe,
-    handler,
+    handler: makeYargsHandlerWithUsageTracking('mcp-start', handler),
     builder,
 };
 export default mcpStartCommand;

package/commands/open.js

@@ -1,8 +1,8 @@
-import { trackCommandUsage } from '../lib/usageTracking.js';
 import { logSiteLinks, getSiteLinksAsArray, openLink } from '../lib/links.js';
 import { promptUser } from '../lib/prompts/promptUtils.js';
 import { commands } from '../lang/en.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
+import { makeYargsHandlerWithUsageTracking } from '../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 const separator = ' => ';
 async function createListPrompt(accountId) {
@@ -22,8 +22,7 @@ async function createListPrompt(accountId) {
 const command = 'open [shortcut]';
 const describe = commands.open.describe;
 async function handler(args) {
-    const { shortcut, list, derivedAccountId } = args;
-    trackCommandUsage('open', undefined, derivedAccountId);
+    const { shortcut, list, derivedAccountId, exit } = args;
     if (shortcut === undefined && !list) {
         const { open } = await createListPrompt(derivedAccountId);
         openLink(derivedAccountId, open);
@@ -34,7 +33,7 @@ async function handler(args) {
     else if (shortcut) {
         openLink(derivedAccountId, shortcut);
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function openBuilder(yargs) {
     yargs.positional('[shortcut]', {
@@ -64,7 +63,7 @@ const builder = makeYargsBuilder(openBuilder, command, describe, {
 const openCommand = {
     command,
     describe,
-    handler,
+    handler: makeYargsHandlerWithUsageTracking('open', handler),
     builder,
 };
 export default openCommand;

package/commands/project/add.js

@@ -1,9 +1,11 @@
 import { logError } from '../../lib/errorHandlers/index.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { legacyAddComponent } from '../../lib/projects/add/legacyAddComponent.js';
 import { v2AddComponent } from '../../lib/projects/add/v2AddComponent.js';
 import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, } from '../../lib/constants.js';
@@ -11,15 +13,15 @@ import { uiLogger } from '../../lib/ui/logger.js';
 const command = 'add';
 const describe = commands.project.add.describe;
 async function handler(args) {
+    const { derivedAccountId, exit } = args;
     try {
-        const { derivedAccountId } = args;
         const { projectConfig, projectDir } = await getProjectConfig();
         if (!projectDir || !projectConfig) {
             uiLogger.error(commands.project.add.error.locationInProject);
-            process.exit(EXIT_CODES.ERROR);
+            return exit(EXIT_CODES.ERROR);
         }
-        const isV2ProjectCreate = isV2Project(projectConfig.platformVersion);
-        if (isV2ProjectCreate) {
+        const isLegacyProjectCreate = isLegacyProject(projectConfig.platformVersion);
+        if (!isLegacyProjectCreate) {
             await v2AddComponent(args, projectDir, projectConfig, derivedAccountId);
         }
         else {
@@ -27,10 +29,13 @@ async function handler(args) {
         }
     }
     catch (e) {
+        if (isPromptExitError(e)) {
+            throw e;
+        }
         logError(e);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function projectAddBuilder(yargs) {
     yargs.options({
@@ -73,7 +78,7 @@ const builder = makeYargsBuilder(projectAddBuilder, command, describe, {
 const projectAddCommand = {
     command,
     describe,
-    handler,
+    handler: makeYargsHandlerWithUsageTracking('project-add', handler),
     builder,
 };
 export default projectAddCommand;

package/commands/project/appInstallStatus.d.ts

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

package/commands/project/appInstallStatus.js

@@ -0,0 +1,132 @@
+import path from 'path';
+import { fetchAppInstallationData } from '@hubspot/local-dev-lib/api/localDevAuth';
+import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
+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 { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { ApiErrorContext, debugError, 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';
+import { isAppIRNode } from '../../lib/projects/structure.js';
+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 { projectConfig, projectDir } = await getProjectConfig();
+    if (!projectConfig || !projectDir) {
+        uiLogger.error(commands.project.installStatus.errors.noProjectConfig);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (isLegacyProject(projectConfig.platformVersion)) {
+        uiLogger.error(commands.project.installStatus.errors.unsupportedPlatformVersion(projectConfig.platformVersion));
+        return exit(EXIT_CODES.ERROR);
+    }
+    let appNode;
+    try {
+        const { intermediateNodesIndexedByUid } = await translateForLocalDev({
+            projectSourceDir: path.join(projectDir, projectConfig.srcDir),
+            platformVersion: projectConfig.platformVersion,
+            accountId: derivedAccountId,
+        }, { skipValidation: true });
+        appNode = Object.values(intermediateNodesIndexedByUid).find(isAppIRNode);
+    }
+    catch (error) {
+        debugError(error);
+        uiLogger.error(commands.project.installStatus.errors.failedToParseProject);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (!appNode) {
+        uiLogger.error(commands.project.installStatus.errors.noAppInProject);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (appNode.config.auth.type.toLowerCase() !== APP_AUTH_TYPES.STATIC) {
+        uiLogger.error(commands.project.installStatus.errors.unsupportedAuthType(appNode.config.auth.type));
+        return exit(EXIT_CODES.ERROR);
+    }
+    let projectId;
+    try {
+        const response = await fetchProject(derivedAccountId, projectConfig.name);
+        projectId = response.data.id;
+    }
+    catch (error) {
+        logError(error, new ApiErrorContext({
+            accountId: derivedAccountId,
+            projectName: projectConfig.name,
+        }));
+        return exit(EXIT_CODES.ERROR);
+    }
+    let isInstalledWithScopeGroups = false;
+    let previouslyAuthorizedScopeGroups = [];
+    let appId;
+    try {
+        const response = await fetchAppInstallationData(derivedAccountId, projectId, appNode.uid, appNode.config.auth.requiredScopes, appNode.config.auth.optionalScopes);
+        isInstalledWithScopeGroups = response.data.isInstalledWithScopeGroups;
+        previouslyAuthorizedScopeGroups =
+            response.data.previouslyAuthorizedScopeGroups;
+        appId = response.data.appId;
+    }
+    catch (error) {
+        if (!isHubSpotHttpError(error) || error.status !== 404) {
+            logError(error, new ApiErrorContext({
+                accountId: derivedAccountId,
+                projectName: projectConfig.name,
+            }));
+            return exit(EXIT_CODES.ERROR);
+        }
+    }
+    const isInstalled = isInstalledWithScopeGroups || previouslyAuthorizedScopeGroups.length > 0;
+    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 (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));
+        }
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    uiLogger.log(commands.project.installStatus.notInstalled(appNode.config.name, derivedAccountId));
+    return exit(EXIT_CODES.WARNING);
+}
+function projectInstallStatusBuilder(yargs) {
+    yargs.example([
+        [
+            '$0 project app-install-status',
+            commands.project.installStatus.examples.default,
+        ],
+        [
+            '$0 project app-install-status --json',
+            commands.project.installStatus.examples.json,
+        ],
+    ]);
+    return yargs;
+}
+const builder = makeYargsBuilder(projectInstallStatusBuilder, command, describe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+    useJSONOutputOptions: true,
+});
+const projectInstallStatusCommand = {
+    command,
+    describe,
+    handler: makeYargsHandlerWithUsageTracking('project-app-install-status', handler),
+    builder,
+};
+export default projectInstallStatusCommand;

package/commands/project/create.js

@@ -2,30 +2,35 @@ import path from 'path';
 import fs from 'fs-extra';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
 import { getCwd } from '@hubspot/local-dev-lib/path';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { getProjectMetadata, } from '@hubspot/project-parsing-lib/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { writeProjectConfig, getProjectConfig, } from '../../lib/projects/config.js';
 import { EMPTY_PROJECT_TEMPLATE_NAME } from '../../lib/projects/create/legacy.js';
 import { generateComponentPaths } from '../../lib/projects/create/v2.js';
-import { PROJECT_WITH_APP, EMPTY_PROJECT } from '../../lib/constants.js';
 import { debugError, logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
-import { PROJECT_CONFIG_FILE, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, marketplaceDistribution, privateDistribution, oAuth, staticAuth, DEFAULT_PROJECT_TEMPLATE_BRANCH, } from '../../lib/constants.js';
+import { PROJECT_CONFIG_FILE, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, marketplaceDistribution, privateDistribution, oAuth, staticAuth, DEFAULT_PROJECT_TEMPLATE_BRANCH, PROJECT_WITH_APP, EMPTY_PROJECT, } from '../../lib/constants.js';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { handleProjectCreationFlow, } from '../../lib/projects/create/index.js';
-import { getProjectMetadata, } from '@hubspot/project-parsing-lib/projects';
 import { updateHsMetaFilesWithAutoGeneratedFields } from '../../lib/projects/components.js';
 import SpinniesManager from '../../lib/ui/SpinniesManager.js';
 const command = ['create', 'init'];
 const describe = commands.project.create.describe;
-const { v2025_1, v2025_2 } = PLATFORM_VERSIONS;
+const BETA_VERSIONS = [
+    PLATFORM_VERSIONS.v2026_09_BETA,
+    PLATFORM_VERSIONS.v2026_03_BETA,
+];
 async function handler(args) {
-    const { derivedAccountId, platformVersion, templateSource } = args;
+    const { platformVersion, templateSource, exit, addUsageMetadata } = args;
+    if (BETA_VERSIONS.includes(platformVersion)) {
+        uiLogger.warn(commands.project.create.warnings.betaPlatformVersion(platformVersion));
+    }
     if (templateSource && !templateSource.includes('/')) {
         uiLogger.error(commands.project.create.errors.invalidTemplateSource);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const repo = templateSource || HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
     let handleResult;
@@ -34,16 +39,16 @@ async function handler(args) {
     }
     catch (error) {
         logError(error);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const { authType, distribution, repoConfig, projectContents, selectProjectTemplatePromptResponse, projectNameAndDestPromptResponse, } = handleResult;
-    trackCommandUsage('project-create', {
+    addUsageMetadata({
         type: selectProjectTemplatePromptResponse.projectTemplate?.name ||
             (selectProjectTemplatePromptResponse.componentTemplates || [])
                 // @ts-expect-error
                 .map((item) => item.type)
                 .join(','),
-    }, derivedAccountId);
+    });
     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
@@ -51,7 +56,7 @@ async function handler(args) {
         existingProjectDir &&
         projectDest.startsWith(existingProjectDir)) {
         uiLogger.error(commands.project.create.errors.cannotNestProjects(existingProjectDir));
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const components = generateComponentPaths({
         selectProjectTemplatePromptResponse,
@@ -79,7 +84,7 @@ async function handler(args) {
         });
         debugError(err);
         uiLogger.error(commands.project.create.errors.failedToDownloadProject);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const projectConfigPath = path.join(projectDest, PROJECT_CONFIG_FILE);
     const parsedConfigFile = JSON.parse(fs.readFileSync(projectConfigPath).toString());
@@ -102,7 +107,7 @@ async function handler(args) {
     if (isProjectEmpty) {
         fs.ensureDirSync(path.join(projectDest, 'src'));
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function projectCreateBuilder(yargs) {
     yargs.options({
@@ -125,8 +130,14 @@ function projectCreateBuilder(yargs) {
         'platform-version': {
             describe: commands.project.create.options.platformVersion.describe,
             type: 'string',
-            choices: [v2025_1, v2025_2],
-            default: v2025_2,
+            choices: [
+                PLATFORM_VERSIONS.v2025_1,
+                PLATFORM_VERSIONS.v2025_2,
+                PLATFORM_VERSIONS.v2026_03_BETA,
+                PLATFORM_VERSIONS.v2026_03,
+                PLATFORM_VERSIONS.v2026_09_BETA,
+            ],
+            default: PLATFORM_VERSIONS.v2026_03,
         },
         'project-base': {
             describe: commands.project.create.options.projectBase.describe,
@@ -169,7 +180,7 @@ const builder = makeYargsBuilder(projectCreateBuilder, command, describe, {
 const projectCreateCommand = {
     command,
     describe,
-    handler,
+    handler: makeYargsHandlerWithUsageTracking('project-create', handler),
     builder,
 };
 export default projectCreateCommand;

package/commands/project/delete.d.ts

@@ -0,0 +1,7 @@
+import { AccountArgs, CommonArgs, ConfigArgs, YargsCommandModule } from '../../types/Yargs.js';
+export type ProjectDeleteArgs = CommonArgs & ConfigArgs & AccountArgs & {
+    projectName?: string;
+    force: boolean;
+};
+declare const projectDeleteCommand: YargsCommandModule<unknown, ProjectDeleteArgs>;
+export default projectDeleteCommand;

package/commands/project/delete.js

@@ -0,0 +1,74 @@
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { logError } from '../../lib/errorHandlers/index.js';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { renderInline } from '../../ui/render.js';
+import { getWarningBox } from '../../ui/components/StatusMessageBoxes.js';
+import { commands } from '../../lang/en.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
+import { resolveProjectName, checkDeployedComponents, deleteDeployedComponents, confirmDeletion, handleProjectDeletion, } from '../../lib/projects/delete.js';
+const command = 'delete';
+const describe = commands.project.delete.describe;
+const verboseDescribe = commands.project.delete.verboseDescribe;
+async function handler(args) {
+    const { derivedAccountId, projectName: projectNameArg, force, exit } = args;
+    await renderInline(getWarningBox({
+        title: commands.project.delete.warnings.irreversibleTitle,
+        message: commands.project.delete.warnings.irreversible,
+    }));
+    try {
+        const projectName = await resolveProjectName(derivedAccountId, projectNameArg);
+        const { platformVersion, hasUnifiedComponents, projectId } = await checkDeployedComponents(derivedAccountId, projectName);
+        if (!force) {
+            await confirmDeletion(projectName, derivedAccountId, projectId);
+        }
+        if (!isLegacyProject(platformVersion) && hasUnifiedComponents) {
+            await deleteDeployedComponents(derivedAccountId, projectName);
+        }
+        await handleProjectDeletion(derivedAccountId, projectName);
+    }
+    catch (e) {
+        if (isPromptExitError(e)) {
+            throw e;
+        }
+        logError(e);
+        return exit(EXIT_CODES.ERROR);
+    }
+    return exit(EXIT_CODES.SUCCESS);
+}
+function projectDeleteBuilder(yargs) {
+    yargs.option('project-name', {
+        describe: commands.project.delete.options.project,
+        type: 'string',
+    });
+    yargs.option('force', {
+        describe: commands.project.delete.options.force,
+        type: 'boolean',
+        default: false,
+    });
+    yargs.example([
+        [
+            '$0 project delete --project-name=my-project',
+            'Delete a project in the current account named "my-project"',
+        ],
+        [
+            '$0 project delete --project-name=my-project --force',
+            'Delete and skip confirmation prompt',
+        ],
+    ]);
+    return yargs;
+}
+const builder = makeYargsBuilder(projectDeleteBuilder, command, verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+    useEnvironmentOptions: true,
+});
+const projectDeleteCommand = {
+    command,
+    describe,
+    handler: makeYargsHandlerWithUsageTracking('project-delete', handler),
+    builder,
+};
+export default projectDeleteCommand;