@hubspot/cli 8.2.0 → 8.2.1-experimental.1

package/commands/project/lint.js

@@ -1,33 +1,42 @@
 import path from 'path';
-import { getProjectPackageJsonLocations, installPackages, } from '../../lib/dependencyManagement.js';
+import { installPackages } from '../../lib/dependencyManagement.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import SpinniesManager from '../../lib/ui/SpinniesManager.js';
-import { areAllLintPackagesInstalled, getMissingLintPackages, lintPackages, displayLintResults, hasEslintConfig, hasDeprecatedEslintConfig, getDeprecatedEslintConfigFiles, createEslintConfig, REQUIRED_PACKAGES_AND_MIN_VERSIONS, } from '../../lib/projects/uieLinting.js';
+import { addLintScriptsToPackageJson, areAllLintPackagesInstalled, createEslintConfig, displayLintResults, getDeprecatedEslintConfigFiles, getMissingLintPackages, getMissingLintScripts, getUieLintablePackageJsonLocations, hasDeprecatedEslintConfig, hasEslintConfig, lintPackages, REQUIRED_PACKAGES_AND_MIN_VERSIONS, } from '../../lib/projects/uieLinting.js';
+import { clearPackageJsonCache } from '../../lib/npm/packageJson.js';
 const command = 'lint';
 const describe = commands.project.lint.help.describe;
 async function handler(args) {
-    const { derivedAccountId, installMissingDeps } = args;
+    const { installMissingDeps, exit } = args;
     try {
-        trackCommandUsage('project-lint', undefined, derivedAccountId);
-        const projectConfig = await getProjectConfig();
-        if (!projectConfig || !projectConfig.projectDir) {
-            uiLogger.error(commands.project.lint.noProjectConfig);
-            return process.exit(EXIT_CODES.ERROR);
+        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 getProjectPackageJsonLocations();
+        const lintLocations = await getUieLintablePackageJsonLocations({
+            projectConfig,
+            projectDir,
+        });
         const locationsReadyToLint = [];
         const locationsNeedingPackages = new Map();
+        let skippedDirectoryCount = 0;
         for (const lintLocation of lintLocations) {
             if (areAllLintPackagesInstalled(lintLocation)) {
                 locationsReadyToLint.push(lintLocation);
@@ -42,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);
@@ -69,6 +78,7 @@ async function handler(args) {
                     installLocations: locationsArray,
                     dev: true,
                 });
+                clearPackageJsonCache();
                 // Re-check which locations are now ready
                 for (const location of locationsArray) {
                     if (areAllLintPackagesInstalled(location)) {
@@ -78,6 +88,9 @@ async function handler(args) {
             }
             else {
                 uiLogger.warn(commands.project.lint.skippingDirectoriesWarning(relativeLocations));
+                if (installMissingDeps === false) {
+                    skippedDirectoryCount = relativeLocations.length;
+                }
             }
         }
         if (locationsReadyToLint.length > 0) {
@@ -88,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,
@@ -104,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',
@@ -117,9 +130,10 @@ async function handler(args) {
                     SpinniesManager.add('lintConfigCreate', {
                         text: commands.project.lint.loading.creatingConfig,
                     });
+                    const platformVersion = 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');
@@ -129,23 +143,47 @@ async function handler(args) {
                 }
                 else {
                     uiLogger.error(commands.project.lint.eslintConfigRequired);
-                    return process.exit(EXIT_CODES.ERROR);
+                    return exit(EXIT_CODES.ERROR);
+                }
+            }
+            const locationsNeedingScripts = locationsReadyToLint.filter(location => getMissingLintScripts(location).length > 0);
+            if (locationsNeedingScripts.length > 0) {
+                SpinniesManager.add('lintScriptsAdd', {
+                    text: commands.project.lint.loading.addingLintScripts,
+                });
+                const addedResults = [];
+                for (const location of locationsNeedingScripts) {
+                    const result = addLintScriptsToPackageJson(location);
+                    if (result.added.length > 0) {
+                        addedResults.push(result);
+                    }
                 }
+                SpinniesManager.succeed('lintScriptsAdd');
+                addedResults.forEach(({ added, relativePath }) => {
+                    uiLogger.success(commands.project.lint.lintScriptsAdded(added, relativePath));
+                });
             }
             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) {
-                return process.exit(EXIT_CODES.ERROR);
+                return exit(EXIT_CODES.ERROR);
             }
         }
+        if (skippedDirectoryCount > 0) {
+            uiLogger.error(commands.project.lint.skippedDirectoriesError(skippedDirectoryCount));
+            return exit(EXIT_CODES.ERROR);
+        }
     }
     catch (e) {
+        if (isPromptExitError(e)) {
+            throw e;
+        }
         logError(e);
-        return process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
 }
 function projectLintBuilder(yargs) {
@@ -172,7 +210,7 @@ const builder = makeYargsBuilder(projectLintBuilder, command, describe, {
 const projectLintCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('project-lint', handler),
     builder,
 };
 export default projectLintCommand;

package/commands/project/list.d.ts

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

package/commands/project/list.js

@@ -1,4 +1,4 @@
-import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { fetchProjects } from '@hubspot/local-dev-lib/api/projects';
 import { logError } from '../../lib/errorHandlers/index.js';
@@ -9,14 +9,8 @@ import { renderTable } from '../../ui/render.js';
 const command = ['list', 'ls'];
 const describe = commands.project.list.describe;
 async function getProjectData(accountId) {
-    try {
-        const { data: projects } = await fetchProjects(accountId);
-        return projects.results;
-    }
-    catch (e) {
-        logError(e);
-        process.exit(EXIT_CODES.ERROR);
-    }
+    const { data: projects } = await fetchProjects(accountId);
+    return projects.results;
 }
 function formatProjectsAsTableRows(projects) {
     const projectListData = [];
@@ -29,12 +23,18 @@ function formatProjectsAsTableRows(projects) {
     return projectListData;
 }
 async function handler(args) {
-    const { derivedAccountId } = args;
-    trackCommandUsage('projects-list', undefined, derivedAccountId);
-    const projectData = await getProjectData(derivedAccountId);
+    const { derivedAccountId, exit } = args;
+    let projectData;
+    try {
+        projectData = await getProjectData(derivedAccountId);
+    }
+    catch (e) {
+        logError(e);
+        return exit(EXIT_CODES.ERROR);
+    }
     if (projectData.length === 0) {
         uiLogger.error(commands.project.list.errors.noProjectsFound(derivedAccountId));
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const projectListData = formatProjectsAsTableRows(projectData);
     const tableHeader = [
@@ -52,11 +52,12 @@ const builder = makeYargsBuilder(projectListBuilder, command, describe, {
     useGlobalOptions: true,
     useConfigOptions: true,
     useAccountOptions: true,
+    useEnvironmentOptions: true,
 });
 const projectListCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('project-list', handler),
     builder,
 };
 export default projectListCommand;

package/commands/project/listBuilds.d.ts

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

package/commands/project/listBuilds.js

@@ -1,28 +1,24 @@
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
 import { fetchProject, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { uiLink } from '../../lib/ui/index.js';
-import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
+import { getProjectConfig } from '../../lib/projects/config.js';
 import { getProjectDetailUrl } from '../../lib/projects/urls.js';
 import moment from 'moment';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 import { renderTable } from '../../ui/render.js';
+import { ProjectBuildsListSchema, mapBuildToJsonOutput, } from '../../lib/jsonOutput.js';
 const command = 'list-builds';
 const describe = commands.project.listBuilds.describe;
 async function fetchAndDisplayBuilds(accountId, project, options) {
     const { data: { results, paging }, } = await fetchProjectBuilds(accountId, project.name, options);
     const currentDeploy = project.deployedBuildId;
-    if (options && options.after) {
-        uiLogger.log(commands.project.listBuilds.showingNextBuilds(results.length, project.name));
-    }
-    else {
-        uiLogger.log(commands.project.listBuilds.showingRecentBuilds(results.length, project.name, uiLink(commands.project.listBuilds.viewAllBuildsLink, getProjectDetailUrl(project.name, accountId))));
-    }
     if (results.length === 0) {
         uiLogger.log(commands.project.listBuilds.errors.noBuilds);
     }
@@ -46,7 +42,16 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
         });
         renderTable(['Build ID', 'Status', 'Completed', 'Duration', 'Details'], builds);
     }
-    if (paging && paging.next) {
+    if (options.after) {
+        if (results.length > 0) {
+            uiLogger.log(commands.project.listBuilds.showingNextBuilds(results.length, project.name));
+        }
+    }
+    else {
+        uiLogger.log(commands.project.listBuilds.showingRecentBuilds(results.length, project.name, uiLink(commands.project.listBuilds.viewAllBuildsLink, getProjectDetailUrl(project.name, accountId))));
+    }
+    const canPromptForMore = options.limit === undefined && Boolean(process.stdin.isTTY);
+    if (paging?.next?.after && canPromptForMore) {
         await promptUser({
             name: 'more',
             message: commands.project.listBuilds.continueOrExitPrompt,
@@ -58,25 +63,39 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
     }
 }
 async function handler(args) {
-    const { project: projectFlagValue, limit, derivedAccountId } = args;
-    trackCommandUsage('project-list-builds', undefined, derivedAccountId);
+    const { project: projectFlagValue, limit, derivedAccountId, exit, json: formatOutputAsJson, addJsonOutput, } = args;
     let projectName = projectFlagValue;
     if (!projectName) {
-        const { projectConfig, projectDir } = await getProjectConfig();
         try {
-            validateProjectConfig(projectConfig, projectDir);
+            const { projectConfig } = getProjectConfig();
+            projectName = projectConfig.name;
         }
         catch (error) {
             logError(error);
-            process.exit(EXIT_CODES.ERROR);
+            return exit(EXIT_CODES.ERROR);
         }
-        projectName = projectConfig.name;
     }
     try {
         const { data: project } = await fetchProject(derivedAccountId, projectName);
-        await fetchAndDisplayBuilds(derivedAccountId, project, { limit });
+        if (formatOutputAsJson) {
+            const { data: { results, paging }, } = await fetchProjectBuilds(derivedAccountId, project.name, { limit });
+            addJsonOutput({
+                projectName: project.name,
+                deployedBuildId: project.deployedBuildId,
+                results: results.map(build => mapBuildToJsonOutput(build, project.deployedBuildId)),
+                paging: paging?.next?.after
+                    ? { next: { after: paging.next.after } }
+                    : undefined,
+            });
+        }
+        else {
+            await fetchAndDisplayBuilds(derivedAccountId, project, { limit });
+        }
     }
     catch (e) {
+        if (isPromptExitError(e)) {
+            return exit(e.exitCode);
+        }
         if (isHubSpotHttpError(e) && e.status === 404) {
             uiLogger.error(commands.project.listBuilds.errors.projectNotFound(projectName));
         }
@@ -86,8 +105,9 @@ async function handler(args) {
                 projectName,
             }));
         }
+        return exit(EXIT_CODES.ERROR);
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function projectListBuildsBuilder(yargs) {
     yargs.options({
@@ -97,11 +117,19 @@ function projectListBuildsBuilder(yargs) {
         },
         limit: {
             describe: commands.project.listBuilds.options.limit.describe,
-            type: 'string',
+            type: 'number',
         },
     });
     yargs.example([
         ['$0 project list-builds', commands.project.listBuilds.examples.default],
+        [
+            '$0 project list-builds --limit=5',
+            commands.project.listBuilds.examples.withLimit,
+        ],
+        [
+            '$0 project list-builds --json',
+            commands.project.listBuilds.examples.json,
+        ],
     ]);
     return yargs;
 }
@@ -110,11 +138,14 @@ const builder = makeYargsBuilder(projectListBuildsBuilder, command, describe, {
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
 });
 const projectListBuildsCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('project-list-builds', handler, {
+        jsonOutputSchema: ProjectBuildsListSchema,
+    }),
     builder,
 };
 export default projectListBuildsCommand;

package/commands/project/logs.js

@@ -1,6 +1,4 @@
-import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
-import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { getHubSpotWebsiteOriginByAccountId } from '@hubspot/local-dev-lib/urls';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { uiLine } from '../../lib/ui/index.js';
 import { projectLogsPrompt } from '../../lib/prompts/projectsLogsPrompt.js';
@@ -8,11 +6,11 @@ import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { ProjectLogsManager } from '../../lib/projects/ProjectLogsManager.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { renderTable } from '../../ui/render.js';
 function getPrivateAppsUrl(accountId) {
-    const baseUrl = getHubSpotWebsiteOrigin(getConfigAccountEnvironment(accountId));
-    return `${baseUrl}/private-apps/${accountId}`;
+    return `${getHubSpotWebsiteOriginByAccountId(accountId)}/private-apps/${accountId}`;
 }
 function logPreamble() {
     if (ProjectLogsManager.isPublicFunction) {
@@ -51,8 +49,7 @@ function logPreamble() {
 const command = 'logs';
 const describe = commands.project.logs.describe;
 async function handler(args) {
-    const { derivedAccountId } = args;
-    trackCommandUsage('project-logs', undefined, derivedAccountId);
+    const { derivedAccountId, exit } = args;
     try {
         await ProjectLogsManager.init(derivedAccountId);
         const { functionName } = await projectLogsPrompt({
@@ -68,9 +65,9 @@ async function handler(args) {
             accountId: derivedAccountId,
             projectName: ProjectLogsManager.projectName,
         });
-        return process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function projectLogsBuilder(yargs) {
     yargs.options({
@@ -113,7 +110,7 @@ const builder = makeYargsBuilder(projectLogsBuilder, command, describe, { useGlo
 const projectLogsCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('project-logs', handler),
     builder,
 };
 export default projectLogsCommand;

package/commands/project/migrate.js

@@ -1,6 +1,7 @@
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { migrateApp } from '../../lib/app/migrate.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
@@ -9,66 +10,67 @@ import { commands, lib } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { renderInline } from '../../ui/render.js';
 import { getWarningBox } from '../../ui/components/StatusMessageBoxes.js';
-import { getHasMigratableThemes, migrateThemes2025_2, } from '../../lib/theme/migrate.js';
+import { getHasMigratableThemes, migrateThemesV2, } from '../../lib/theme/migrate.js';
 import { hasFeature } from '../../lib/hasFeature.js';
 import { FEATURES } from '../../lib/constants.js';
-import { trackCommandMetadataUsage, trackCommandUsage, } from '../../lib/usageTracking.js';
-const { v2025_2 } = PLATFORM_VERSIONS;
+import { trackCommandMetadataUsage } from '../../lib/usageTracking.js';
+const { v2025_2, v2026_03_BETA, v2026_03 } = PLATFORM_VERSIONS;
 const command = 'migrate';
 const describe = commands.project.migrate.describe;
 async function handler(args) {
-    const { platformVersion, unstable, derivedAccountId } = args;
-    await trackCommandUsage('project-migrate', {}, derivedAccountId);
-    const projectConfig = await getProjectConfig();
-    if (!projectConfig.projectConfig) {
-        uiLogger.error(commands.project.migrate.errors.noProjectConfig(uiCommandReference('hs app migrate')));
-        return process.exit(EXIT_CODES.ERROR);
+    const { platformVersion, unstable, derivedAccountId, exit } = args;
+    let projectConfig;
+    let projectDir;
+    try {
+        ({ projectConfig, projectDir } = getProjectConfig());
     }
-    if (projectConfig?.projectConfig) {
-        await renderInline(getWarningBox({
-            title: lib.migrate.projectMigrationWarningTitle,
-            message: lib.migrate.projectMigrationWarning,
-        }));
+    catch {
+        uiLogger.error(commands.project.migrate.errors.noProjectConfig(uiCommandReference('hs app migrate')));
+        return exit(EXIT_CODES.ERROR);
     }
+    await renderInline(getWarningBox({
+        title: lib.migrate.projectMigrationWarningTitle(platformVersion),
+        message: lib.migrate.projectMigrationWarning(platformVersion),
+    }));
     try {
-        const { hasMigratableThemes, migratableThemesCount } = await getHasMigratableThemes(projectConfig);
+        const { hasMigratableThemes, migratableThemesCount } = await getHasMigratableThemes({ projectConfig, projectDir });
         if (hasMigratableThemes) {
             const hasThemeMigrationAccess = await hasFeature(derivedAccountId, FEATURES.THEME_MIGRATION_2025_2);
             if (!hasThemeMigrationAccess) {
                 uiLogger.error(commands.project.migrate.errors.noThemeMigrationAccess(derivedAccountId));
-                return process.exit(EXIT_CODES.ERROR);
+                return exit(EXIT_CODES.ERROR);
             }
-            await migrateThemes2025_2(derivedAccountId, {
+            await migrateThemesV2(derivedAccountId, {
                 ...args,
                 platformVersion: unstable
-                    ? PLATFORM_VERSIONS.unstable
+                    ? PLATFORM_VERSIONS.UNSTABLE
                     : platformVersion,
-            }, migratableThemesCount, projectConfig);
+            }, migratableThemesCount, { projectConfig, projectDir });
         }
         else {
             await migrateApp(derivedAccountId, {
                 ...args,
-                name: projectConfig?.projectConfig?.name,
+                name: projectConfig.name,
                 platformVersion: unstable
-                    ? PLATFORM_VERSIONS.unstable
+                    ? PLATFORM_VERSIONS.UNSTABLE
                     : platformVersion,
-            }, projectConfig);
+            }, { projectConfig, projectDir });
         }
     }
     catch (error) {
         await trackCommandMetadataUsage('project-migrate', { successful: false }, derivedAccountId);
         logError(error);
-        return process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     await trackCommandMetadataUsage('project-migrate', { successful: true }, derivedAccountId);
-    return process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function projectMigrateBuilder(yargs) {
     yargs
         .option('platform-version', {
         type: 'string',
-        choices: [v2025_2],
-        default: v2025_2,
+        choices: [v2025_2, v2026_03_BETA, v2026_03],
+        default: v2026_03,
     })
         .option('unstable', {
         type: 'boolean',
@@ -85,7 +87,7 @@ const builder = makeYargsBuilder(projectMigrateBuilder, command, commands.projec
 const migrateCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('project-migrate', handler),
     builder,
 };
 export default migrateCommand;

package/commands/project/open.js

@@ -1,5 +1,4 @@
 import open from 'open';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
@@ -7,33 +6,41 @@ import { ensureProjectExists } from '../../lib/projects/ensureProjectExists.js';
 import { getProjectDetailUrl } from '../../lib/projects/urls.js';
 import { projectNamePrompt } from '../../lib/prompts/projectNamePrompt.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'open';
 const describe = commands.project.open.describe;
 async function handler(args) {
-    const { project, derivedAccountId } = args;
-    trackCommandUsage('project-open', undefined, derivedAccountId);
-    const { projectConfig } = await getProjectConfig();
+    const { project, derivedAccountId, exit } = args;
     let projectName = project;
     if (projectName) {
         const { projectExists } = await ensureProjectExists(derivedAccountId, projectName, {
             allowCreate: false,
         });
         if (!projectExists) {
-            process.exit(EXIT_CODES.ERROR);
+            return exit(EXIT_CODES.ERROR);
         }
     }
-    else if (!projectName && projectConfig) {
-        projectName = projectConfig.name;
-    }
-    else if (!projectName && !projectConfig) {
-        const namePromptResponse = await projectNamePrompt(derivedAccountId);
-        projectName = namePromptResponse.projectName;
+    else if (!projectName) {
+        let projectConfig;
+        try {
+            ({ projectConfig } = getProjectConfig());
+        }
+        catch {
+            // Not in a project directory, fall through to prompt
+        }
+        if (projectConfig) {
+            projectName = projectConfig.name;
+        }
+        else {
+            const namePromptResponse = await projectNamePrompt(derivedAccountId);
+            projectName = namePromptResponse.projectName;
+        }
     }
     const url = getProjectDetailUrl(projectName, derivedAccountId);
     open(url, { url: true });
     uiLogger.success(commands.project.open.success(projectName));
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function projectOpenBuilder(yargs) {
     yargs.options({
@@ -55,7 +62,7 @@ const builder = makeYargsBuilder(projectOpenBuilder, command, describe, {
 const projectOpenCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('project-open', handler),
     builder,
 };
 export default projectOpenCommand;

package/commands/project/profile/add.d.ts

@@ -1,7 +1,8 @@
 import { YargsCommandModule, CommonArgs } from '../../../types/Yargs.js';
-type ProjectProfileAddArgs = CommonArgs & {
+export type ProjectProfileAddArgs = CommonArgs & {
     name?: string;
     targetAccount?: number;
+    copyFrom?: string;
 };
 declare const projectProfileAddCommand: YargsCommandModule<unknown, ProjectProfileAddArgs>;
 export default projectProfileAddCommand;