@hubspot/cli 8.0.11-experimental.1 → 8.0.12-experimental.0

package/api/migrate.js

@@ -1,4 +1,4 @@
-import { PLATFORM_VERSIONS, } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { http } from '@hubspot/local-dev-lib/http';
 const MIGRATIONS_API_PATH_V2 = 'dfs/migrations/v2';
 export const CLI_UNMIGRATABLE_REASONS = {
@@ -20,8 +20,8 @@ export async function listAppsForMigration(accountId, platformVersion, appId) {
     });
 }
 function mapPlatformVersionToEnum(platformVersion) {
-    if (platformVersion === PLATFORM_VERSIONS.unstable) {
-        return PLATFORM_VERSIONS.unstable.toUpperCase();
+    if (platformVersion === PLATFORM_VERSIONS.UNSTABLE) {
+        return PLATFORM_VERSIONS.UNSTABLE.toUpperCase();
     }
     const reformattedPlatformVersion = platformVersion
         .replaceAll('.', '_')

package/bin/cli.js

@@ -35,6 +35,7 @@ import apiCommand from '../commands/api.js';
 import { uiLogger } from '../lib/ui/logger.js';
 import { initializeSpinniesManager } from '../lib/middleware/spinniesMiddleware.js';
 import { addCommandSuggestions } from '../lib/commandSuggestion.js';
+import { pkg } from '../lib/jsonLoader.js';
 function getTerminalWidth() {
     const width = yargs().terminalWidth();
     if (width >= 100)
@@ -121,6 +122,8 @@ const argv = yargs(process.argv.slice(2))
 const argvWithSuggestions = addCommandSuggestions(argv)
     .help()
     .alias('h', 'help')
+    .version(pkg.version)
+    .alias('v', 'version')
     .recommendCommands()
     .demandCommand(1, '')
     .wrap(getTerminalWidth())

package/commands/account/link.d.ts

@@ -0,0 +1,4 @@
+import { YargsCommandModule } from '../../types/Yargs.js';
+import { LinkArgs } from '../../types/Link.js';
+declare const linkCommand: YargsCommandModule<unknown, LinkArgs>;
+export default linkCommand;

package/commands/account/link.js

@@ -0,0 +1,88 @@
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { getAllConfigAccounts } from '@hubspot/local-dev-lib/config';
+import { getCwd } from '@hubspot/local-dev-lib/path';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { getHsSettingsFileIfExists, getHsSettingsFilePath, } from '@hubspot/local-dev-lib/config/hsSettings';
+import { getDefaultAccountOverrideAccountId } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
+import { checkAndAddHsFolderToGitignore } from '@hubspot/local-dev-lib/gitignore';
+import { DEFAULT_HS_SETTINGS_PATH, EMPTY_HS_SETTINGS_FILE, } from '@hubspot/local-dev-lib/constants/config';
+import { handleLinkFlow } from '../../lib/link/index.js';
+import { hasDeprecatedConfigConflict, writeLinkedSettings, } from '../../lib/link/linkUtils.js';
+import { renderLinkedAccountsTable } from '../../lib/link/renderLinkedAccountsTable.js';
+import { commands } from '../../lang/en.js';
+import { debugError } from '../../lib/errorHandlers/index.js';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+const command = 'link';
+// Hide the command until we're done testing and ready to make linking GA
+// const describe = commands.account.subcommands.link.describe;
+const describe = undefined;
+async function handler(args) {
+    const { exit } = args;
+    if (hasDeprecatedConfigConflict(args._)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    const existingSettings = getHsSettingsFileIfExists();
+    const isNewFile = existingSettings === null;
+    if (isNewFile) {
+        uiLogger.log(commands.account.subcommands.link.linkingDirectory(getCwd()));
+    }
+    else {
+        uiLogger.log(commands.account.subcommands.link.managingLinkedAccounts(getCwd()));
+    }
+    uiLogger.log('');
+    const settingsFilePath = getHsSettingsFilePath() || DEFAULT_HS_SETTINGS_PATH;
+    uiLogger.log(commands.account.subcommands.link.settingsInfo(settingsFilePath));
+    uiLogger.log('');
+    const settings = isNewFile ? EMPTY_HS_SETTINGS_FILE : existingSettings;
+    const accounts = getAllConfigAccounts();
+    const accountOverrideId = getDefaultAccountOverrideAccountId(accounts);
+    if (settings.accounts.length !== 0) {
+        await renderLinkedAccountsTable(settings);
+        uiLogger.log('');
+    }
+    const result = await handleLinkFlow({
+        settings,
+        accountOverrideId,
+        args,
+    });
+    if (result.status === 'error') {
+        uiLogger.error(result.reason);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (result.status === 'noop') {
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    const settingsPath = getHsSettingsFilePath() || DEFAULT_HS_SETTINGS_PATH;
+    if (!writeLinkedSettings(result.settings, settingsPath)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    try {
+        checkAndAddHsFolderToGitignore(settingsPath);
+    }
+    catch (e) {
+        debugError(e);
+    }
+    if (isNewFile) {
+        uiLogger.success(commands.account.subcommands.link.success.created(settingsPath));
+    }
+    else {
+        uiLogger.success(commands.account.subcommands.link.shared.savedToSettings(settingsPath));
+    }
+    return exit(EXIT_CODES.SUCCESS);
+}
+function linkBuilder(yargs) {
+    yargs.example([['$0 link']]);
+    return yargs;
+}
+const builder = makeYargsBuilder(linkBuilder, command, commands.account.subcommands.link.verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+});
+const linkCommand = {
+    command,
+    describe,
+    handler: makeYargsHandlerWithUsageTracking('account-link', handler),
+    builder,
+};
+export default linkCommand;

package/commands/account/unlink.d.ts

@@ -0,0 +1,4 @@
+import { YargsCommandModule } from '../../types/Yargs.js';
+import { LinkArgs } from '../../types/Link.js';
+declare const unlinkCommand: YargsCommandModule<unknown, LinkArgs>;
+export default unlinkCommand;

package/commands/account/unlink.js

@@ -0,0 +1,69 @@
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { getAllConfigAccounts } from '@hubspot/local-dev-lib/config';
+import { getCwd } from '@hubspot/local-dev-lib/path';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { getHsSettingsFileIfExists, getHsSettingsFilePath, } from '@hubspot/local-dev-lib/config/hsSettings';
+import { ActionHandlers } from '../../lib/link/index.js';
+import { hasDeprecatedConfigConflict, isDirectoryLinked, writeLinkedSettings, } from '../../lib/link/linkUtils.js';
+import { commands } from '../../lang/en.js';
+import { DEFAULT_HS_SETTINGS_PATH } from '@hubspot/local-dev-lib/constants/config';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+const command = 'unlink';
+// Hide the command until we're done testing and ready to make linking GA
+// const describe = commands.account.subcommands.link.describe;
+const describe = undefined;
+async function handler(args) {
+    const { exit } = args;
+    if (hasDeprecatedConfigConflict(args._)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    const existingSettings = getHsSettingsFileIfExists();
+    if (!isDirectoryLinked(existingSettings)) {
+        const globalAccounts = getAllConfigAccounts();
+        uiLogger.log(commands.account.subcommands.link.shared.noLinkedAccounts);
+        uiLogger.log(commands.account.subcommands.link.shared.globalAccountsAvailable(globalAccounts.length));
+        uiLogger.log('');
+        uiLogger.log(commands.account.subcommands.link.shared.configurePrompt);
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    uiLogger.log(commands.account.subcommands.link.managingLinkedAccounts(getCwd()));
+    uiLogger.log('');
+    const result = await ActionHandlers.unlink({
+        state: existingSettings,
+        context: {
+            globalAccountsList: getAllConfigAccounts(),
+            globalDefaultAccount: undefined,
+            accountOverrideId: null,
+        },
+        args,
+    });
+    if (result.status === 'error') {
+        uiLogger.error(result.reason);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (result.status === 'noop') {
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    const settingsPath = getHsSettingsFilePath() || DEFAULT_HS_SETTINGS_PATH;
+    if (!writeLinkedSettings(result.settings, settingsPath)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    uiLogger.success(commands.account.subcommands.link.shared.savedToSettings(settingsPath));
+    return exit(EXIT_CODES.SUCCESS);
+}
+function unlinkBuilder(yargs) {
+    yargs.example([['$0 account unlink']]);
+    return yargs;
+}
+const builder = makeYargsBuilder(unlinkBuilder, command, commands.account.subcommands.unlink.verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+});
+const unlinkCommand = {
+    command,
+    describe,
+    handler: makeYargsHandlerWithUsageTracking('account-unlink', handler),
+    builder,
+};
+export default unlinkCommand;

package/commands/account.js

@@ -8,12 +8,16 @@ import remove from './account/remove.js';
 import clean from './account/clean.js';
 import createOverride from './account/createOverride.js';
 import removeOverride from './account/removeOverride.js';
+import link from './account/link.js';
+import unlink from './account/unlink.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 const command = ['account', 'accounts'];
 const describe = commands.account.describe;
 function accountBuilder(yargs) {
     yargs
         .command(auth)
+        .command(link)
+        .command(unlink)
         .command(list)
         .command(rename)
         .command(use)

package/commands/app/migrate.js

@@ -1,5 +1,5 @@
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { trackCommandMetadataUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
@@ -9,7 +9,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { migrateApp } from '../../lib/app/migrate.js';
 import { getIsInProject } from '../../lib/projects/config.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-const { v2025_2, v2026_03_beta, v2026_03 } = PLATFORM_VERSIONS;
+const { v2025_2, v2026_03_BETA, v2026_03 } = PLATFORM_VERSIONS;
 const command = 'migrate';
 const describe = commands.project.migrateApp.describe;
 export function handlerGenerator(commandTrackingName) {
@@ -29,7 +29,7 @@ export function handlerGenerator(commandTrackingName) {
                 return exit(EXIT_CODES.ERROR);
             }
             args.platformVersion = unstable
-                ? PLATFORM_VERSIONS.unstable
+                ? PLATFORM_VERSIONS.UNSTABLE
                 : platformVersion;
             await migrateApp(derivedAccountId, args);
         }
@@ -67,7 +67,7 @@ function appMigrateBuilder(yargs) {
         },
         'platform-version': {
             type: 'string',
-            choices: [v2025_2, v2026_03_beta, v2026_03],
+            choices: [v2025_2, v2026_03_BETA, v2026_03],
             default: v2026_03,
         },
         unstable: {

package/commands/getStarted.js

@@ -16,7 +16,6 @@ import { uiLogger } from '../lib/ui/logger.js';
 import { trackCommandMetadataUsage } from '../lib/usageTracking.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { makeYargsHandlerWithUsageTracking } from '../lib/yargs/makeYargsHandlerWithUsageTracking.js';
-import { isV2Project } from '../lib/projects/platformVersion.js';
 import { pollProjectBuildAndDeploy } from '../lib/projects/pollProjectBuildAndDeploy.js';
 import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
@@ -24,6 +23,7 @@ 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';
 const command = 'get-started';
 const describe = commands.getStarted.describe;
 async function handler(args) {
@@ -204,7 +204,7 @@ async function handler(args) {
                     uploadMessage: 'Initial upload from get-started command',
                     forceCreate: true, // Auto-create project on HubSpot
                     isUploadCommand: false,
-                    sendIR: isV2Project(newProjectConfig.platformVersion),
+                    sendIR: !isLegacyProject(newProjectConfig.platformVersion),
                     skipValidation: false,
                 });
                 if (uploadError) {

package/commands/project/add.js

@@ -5,7 +5,7 @@ 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';
@@ -20,8 +20,8 @@ async function handler(args) {
             uiLogger.error(commands.project.add.error.locationInProject);
             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 {

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,27 +2,32 @@ 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 { 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, v2026_03_beta, v2026_03 } = PLATFORM_VERSIONS;
+const BETA_VERSIONS = [
+    PLATFORM_VERSIONS.v2026_09_BETA,
+    PLATFORM_VERSIONS.v2026_03_BETA,
+];
 async function handler(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);
         return exit(EXIT_CODES.ERROR);
@@ -125,8 +130,14 @@ function projectCreateBuilder(yargs) {
         'platform-version': {
             describe: commands.project.create.options.platformVersion.describe,
             type: 'string',
-            choices: [v2025_1, v2025_2, v2026_03_beta, v2026_03],
-            default: v2026_03,
+            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,

package/commands/project/delete.js

@@ -5,7 +5,7 @@ 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 { isV2Project } from '../../lib/projects/platformVersion.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';
@@ -23,7 +23,7 @@ async function handler(args) {
         if (!force) {
             await confirmDeletion(projectName, derivedAccountId, projectId);
         }
-        if (isV2Project(platformVersion) && hasUnifiedComponents) {
+        if (!isLegacyProject(platformVersion) && hasUnifiedComponents) {
             await deleteDeployedComponents(derivedAccountId, projectName);
         }
         await handleProjectDeletion(derivedAccountId, projectName);

package/commands/project/deploy.js

@@ -1,7 +1,7 @@
 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 { isV2Project } from '../../lib/projects/platformVersion.js';
+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 { projectNamePrompt } from '../../lib/prompts/projectNamePrompt.js';
@@ -31,7 +31,8 @@ async function handler(args) {
         isInProjectDirectory = true;
     }
     catch (e) { }
-    if (isInProjectDirectory && isV2Project(projectConfig?.platformVersion)) {
+    if (isInProjectDirectory &&
+        !isLegacyProject(projectConfig?.platformVersion)) {
         try {
             const profileName = await projectProfilePrompt(projectDir, projectConfig, profileOption, !!useEnvOption);
             if (profileName) {
@@ -97,7 +98,7 @@ async function handler(args) {
             uiLogger.error(commands.project.deploy.errors.noBuildId);
             return exit(EXIT_CODES.ERROR);
         }
-        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isV2Project(projectConfig?.platformVersion), forceOption);
+        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, isLegacyProject(projectConfig?.platformVersion), forceOption);
         if (!deployResult) {
             return exit(EXIT_CODES.ERROR);
         }

package/commands/project/dev/index.js

@@ -5,7 +5,7 @@ import { uiLine } from '../../../lib/ui/index.js';
 import { makeYargsHandlerWithUsageTracking } from '../../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { deprecatedProjectDevFlow } from './deprecatedFlow.js';
 import { unifiedProjectDevFlow } from './unifiedFlow.js';
-import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { loadAndValidateProfile } from '../../../lib/projects/projectProfiles.js';
 import { commands } from '../../../lang/en.js';
@@ -34,7 +34,7 @@ async function handler(args) {
         logError(error);
         return exit(EXIT_CODES.ERROR);
     }
-    const useV2Projects = isV2Project(projectConfig.platformVersion);
+    const useV2Projects = !isLegacyProject(projectConfig.platformVersion);
     if (!projectDir) {
         uiLogger.error(commands.project.dev.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
@@ -69,7 +69,8 @@ async function handler(args) {
         targetProjectAccountId = derivedAccountId;
     }
     // Determine profile name: from flag or prompt
-    if (!targetProjectAccountId && isV2Project(projectConfig.platformVersion)) {
+    if (!targetProjectAccountId &&
+        !isLegacyProject(projectConfig.platformVersion)) {
         const profileName = await projectProfilePrompt(projectDir, projectConfig, profileOption);
         if (profileName) {
             try {
@@ -95,7 +96,7 @@ async function handler(args) {
     }
     addUsageMetadata({ accountId: targetProjectAccountId ?? undefined });
     try {
-        if (isV2Project(projectConfig.platformVersion)) {
+        if (!isLegacyProject(projectConfig.platformVersion)) {
             const targetTestingAccountId = testingAccount
                 ? getConfigAccountIfExists(testingAccount)?.accountId
                 : undefined;

package/commands/project/info.js

@@ -6,7 +6,7 @@ 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 { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { getProjectInfo, logProjectInfo, } from '../../lib/projects/projectInfo.js';
 const command = 'info';
 const describe = commands.project.info.describe;
@@ -18,7 +18,7 @@ async function handler(args) {
         uiLogger.error(commands.project.info.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.info.errors.unsupportedPlatformVersion(projectConfig.platformVersion));
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/lint.js

@@ -117,9 +117,10 @@ async function handler(args) {
                     SpinniesManager.add('lintConfigCreate', {
                         text: commands.project.lint.loading.creatingConfig,
                     });
+                    const platformVersion = projectConfig.projectConfig?.platformVersion ?? null;
                     const createdConfigs = [];
                     for (const location of locationsNeedingConfig) {
-                        const configPath = createEslintConfig(location);
+                        const configPath = await createEslintConfig(location, platformVersion);
                         createdConfigs.push(configPath);
                     }
                     SpinniesManager.succeed('lintConfigCreate');