@hubspot/cli 8.2.0 → 8.2.1-experimental.0

package/commands/feedback.js

@@ -1,5 +1,6 @@
 import open from 'open';
 import { confirmPrompt } from '../lib/prompts/promptUtils.js';
+import { makeWrappedYargsHandler } from '../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { EXIT_CODES } from '../lib/enums/exitCodes.js';
 import { commands } from '../lang/en.js';
@@ -7,15 +8,16 @@ import { uiLogger } from '../lib/ui/logger.js';
 import { FEEDBACK_URL } from '../lib/constants.js';
 const command = 'feedback';
 const describe = commands.project.feedback.describe;
-async function handler() {
+async function handler(args) {
+    const { exit } = args;
     const shouldOpen = await confirmPrompt(commands.project.feedback.openPrompt);
     if (!shouldOpen) {
         uiLogger.log(commands.project.feedback.error(FEEDBACK_URL));
-        process.exit(EXIT_CODES.SUCCESS);
+        return exit(EXIT_CODES.SUCCESS);
     }
     open(FEEDBACK_URL, { url: true });
     uiLogger.success(commands.project.feedback.success(FEEDBACK_URL));
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function feedbackBuilder(yargs) {
     return yargs;
@@ -26,7 +28,7 @@ const builder = makeYargsBuilder(feedbackBuilder, command, describe, {
 const feedbackCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('feedback', handler),
     builder,
 };
 export default feedbackCommand;

package/commands/filemanager/fetch.js

@@ -1,29 +1,28 @@
 import { downloadFileOrFolder } from '@hubspot/local-dev-lib/fileManager';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { resolveLocalPath } from '../../lib/filesystem.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { addOverwriteOptions } from '../../lib/commonOpts.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'fetch <src> [dest]';
 const describe = commands.filemanager.subcommands.fetch.describe;
 async function handler(args) {
-    const { src, includeArchived, derivedAccountId, overwrite } = args;
+    const { src, includeArchived, derivedAccountId, overwrite, exit } = args;
     if (typeof src !== 'string') {
         uiLogger.error(commands.filemanager.subcommands.fetch.errors.sourceRequired);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const dest = resolveLocalPath(args.dest);
-    trackCommandUsage('filemanager-fetch', {}, derivedAccountId);
     try {
         // Fetch and write file/folder.
         await downloadFileOrFolder(derivedAccountId, src, dest, overwrite, includeArchived || false);
     }
     catch (err) {
         logError(err);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
 }
 function fileManagerFetchBuilder(yargs) {
@@ -52,7 +51,7 @@ const builder = makeYargsBuilder(fileManagerFetchBuilder, command, describe, {
 const fileManagerFetchCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('filemanager-fetch', handler),
     builder,
 };
 export default fileManagerFetchCommand;

package/commands/filemanager/upload.js

@@ -7,14 +7,14 @@ import { uiLogger } from '../../lib/ui/logger.js';
 import { validateSrcAndDestPaths } from '@hubspot/local-dev-lib/cms/modules';
 import { shouldIgnoreFile } from '@hubspot/local-dev-lib/ignoreRules';
 import { ApiErrorContext, logError } from '../../lib/errorHandlers/index.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'upload <src> <dest>';
 const describe = commands.filemanager.subcommands.upload.describe;
 async function handler(args) {
-    const { src, dest, derivedAccountId } = args;
+    const { src, dest, derivedAccountId, addUsageMetadata, exit } = args;
     const absoluteSrcPath = path.resolve(getCwd(), src);
     let stats;
     try {
@@ -33,11 +33,11 @@ async function handler(args) {
         return;
     }
     const normalizedDest = convertToUnixPath(dest);
-    trackCommandUsage('filemanager-upload', { type: stats.isFile() ? 'file' : 'folder' }, derivedAccountId);
+    addUsageMetadata({ type: stats.isFile() ? 'file' : 'folder' });
     const srcDestIssues = await validateSrcAndDestPaths({ isLocal: true, path: src }, { isHubSpot: true, path: dest });
     if (srcDestIssues.length) {
         srcDestIssues.forEach(({ message }) => uiLogger.error(message));
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     if (stats.isFile()) {
         if (shouldIgnoreFile(absoluteSrcPath)) {
@@ -91,7 +91,7 @@ const builder = makeYargsBuilder(fileManagerUploadBuilder, command, describe, {
 const fileManagerUploadCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('filemanager-upload', handler),
     builder,
 };
 export default fileManagerUploadCommand;

package/commands/getStarted.js

@@ -13,9 +13,9 @@ import { projectNameAndDestPrompt } from '../lib/prompts/projectNameAndDestPromp
 import { promptUser } from '../lib/prompts/promptUtils.js';
 import { uiAccountDescription, uiFeatureHighlight, uiInfoSection, } from '../lib/ui/index.js';
 import { uiLogger } from '../lib/ui/logger.js';
-import { trackCommandMetadataUsage, trackCommandUsage, } from '../lib/usageTracking.js';
+import { trackCommandMetadataUsage } from '../lib/usageTracking.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
-import { isV2Project } from '../lib/projects/platformVersion.js';
+import { makeWrappedYargsHandler } from '../lib/yargs/makeWrappedYargsHandler.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';
@@ -23,12 +23,13 @@ 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';
+import { showMcpPromotionNudge } from '../lib/mcp/promotion.js';
 const command = 'get-started';
 const describe = commands.getStarted.describe;
 async function handler(args) {
-    const { derivedAccountId } = args;
+    const { derivedAccountId, exit } = args;
     const env = getConfigAccountEnvironment(derivedAccountId);
-    await trackCommandUsage('get-started', {}, derivedAccountId);
     const accountName = uiAccountDescription(derivedAccountId);
     if (args.v2) {
         try {
@@ -37,13 +38,11 @@ async function handler(args) {
                 name: args.name,
                 dest: args.dest,
             });
-            process.exit(EXIT_CODES.SUCCESS);
-            return;
+            return exit(EXIT_CODES.SUCCESS);
         }
         catch (error) {
             logError(error);
-            process.exit(EXIT_CODES.ERROR);
-            return;
+            return exit(EXIT_CODES.ERROR);
         }
     }
     uiInfoSection(commands.getStarted.startTitle, () => {
@@ -92,7 +91,7 @@ async function handler(args) {
                 openLink(derivedAccountId, 'design-manager');
             }
         }
-        process.exit(EXIT_CODES.SUCCESS);
+        return exit(EXIT_CODES.SUCCESS);
     }
     else {
         uiLogger.log(' ');
@@ -110,12 +109,12 @@ async function handler(args) {
             }, derivedAccountId);
             uiLogger.log(' ');
             uiLogger.error(commands.project.create.errors.cannotNestProjects(existingProjectDir));
-            process.exit(EXIT_CODES.ERROR);
+            return exit(EXIT_CODES.ERROR);
         }
         // 4. Clone the project template from GitHub
         try {
             await cloneGithubRepo(HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, projectDest, {
-                sourceDir: '2025.2/private-app-get-started-template',
+                sourceDir: '2026.03/private-app-get-started-template',
                 hideLogs: true,
             });
             await trackCommandMetadataUsage('get-started', {
@@ -131,7 +130,7 @@ async function handler(args) {
             debugError(err);
             uiLogger.log(' ');
             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());
@@ -177,7 +176,7 @@ async function handler(args) {
                     }, derivedAccountId);
                     uiLogger.log(' ');
                     uiLogger.error(commands.getStarted.errors.configFileNotFound);
-                    process.exit(EXIT_CODES.ERROR);
+                    return exit(EXIT_CODES.ERROR);
                 }
                 try {
                     validateProjectConfig(newProjectConfig, newProjectDir);
@@ -191,7 +190,7 @@ async function handler(args) {
                         }, derivedAccountId);
                         uiLogger.log(' ');
                         uiLogger.error(error.message);
-                        process.exit(EXIT_CODES.ERROR);
+                        return exit(EXIT_CODES.ERROR);
                     }
                     throw error;
                 }
@@ -206,8 +205,9 @@ 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,
+                    force: true,
                 });
                 if (uploadError) {
                     // Track upload failure
@@ -268,21 +268,22 @@ async function handler(args) {
                 uiLogger.log(' ');
                 uiLogger.error(commands.getStarted.errors.uploadFailed);
                 debugError(err);
-                process.exit(EXIT_CODES.ERROR);
+                return exit(EXIT_CODES.ERROR);
             }
         }
         else {
             uiLogger.log(' ');
             uiFeatureHighlight(['projectUploadCommand', 'projectDevCommand']);
-            process.exit(EXIT_CODES.SUCCESS);
+            return exit(EXIT_CODES.SUCCESS);
         }
     }
+    await showMcpPromotionNudge(args._.join(' '));
     // Track successful completion of get-started command
     await trackCommandMetadataUsage('get-started', {
         successful: true,
         step: 'command-completed',
     }, derivedAccountId);
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function getStartedBuilder(yargs) {
     yargs.options({
@@ -316,7 +317,7 @@ const builder = makeYargsBuilder(getStartedBuilder, command, commands.getStarted
 const getStartedCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('get-started', handler),
     builder,
 };
 export default getStartedCommand;

package/commands/hubdb/clear.js

@@ -1,16 +1,16 @@
 import { uiLogger } from '../../lib/ui/logger.js';
 import { logError } from '../../lib/errorHandlers/index.js';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { clearHubDbTableRows } from '@hubspot/local-dev-lib/hubdb';
 import { publishTable } from '@hubspot/local-dev-lib/api/hubdb';
 import { selectHubDBTablePrompt } from '../../lib/prompts/selectHubDBTablePrompt.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'clear [table-id]';
 const describe = commands.hubdb.subcommands.clear.describe;
 async function handler(args) {
     const { derivedAccountId } = args;
-    trackCommandUsage('hubdb-clear', {}, derivedAccountId);
     try {
         const { tableId } = 'tableId' in args
             ? args
@@ -29,6 +29,9 @@ async function handler(args) {
         }
     }
     catch (e) {
+        if (isPromptExitError(e)) {
+            throw e;
+        }
         logError(e);
     }
 }
@@ -48,7 +51,7 @@ const builder = makeYargsBuilder(hubdbClearBuilder, command, describe, {
 const hubdbClearCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('hubdb-clear', handler),
     builder,
 };
 export default hubdbClearCommand;

package/commands/hubdb/create.js

@@ -5,9 +5,9 @@ import { getCwd, untildify, isValidPath } from '@hubspot/local-dev-lib/path';
 import { createHubDbTable } from '@hubspot/local-dev-lib/hubdb';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { checkAndConvertToJson } from '../../lib/validation.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'create';
 const describe = commands.hubdb.subcommands.create.describe;
@@ -33,8 +33,7 @@ function selectPathPrompt(options) {
     ]);
 }
 async function handler(args) {
-    const { derivedAccountId } = args;
-    trackCommandUsage('hubdb-create', {}, derivedAccountId);
+    const { derivedAccountId, exit } = args;
     let filePath;
     try {
         filePath =
@@ -42,7 +41,7 @@ async function handler(args) {
                 ? path.resolve(getCwd(), args.path)
                 : path.resolve(getCwd(), (await selectPathPrompt(args)).path);
         if (!checkAndConvertToJson(filePath)) {
-            process.exit(EXIT_CODES.ERROR);
+            return exit(EXIT_CODES.ERROR);
         }
         const table = await createHubDbTable(derivedAccountId, path.resolve(getCwd(), filePath));
         uiLogger.success(commands.hubdb.subcommands.create.success.create(table.tableId, derivedAccountId, table.rowCount));
@@ -68,7 +67,7 @@ const builder = makeYargsBuilder(hubdbCreateBuilder, command, describe, {
 const hubdbCreateCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('hubdb-create', handler),
     builder,
 };
 export default hubdbCreateCommand;

package/commands/hubdb/delete.js

@@ -1,17 +1,17 @@
 import { uiLogger } from '../../lib/ui/logger.js';
 import { logError } from '../../lib/errorHandlers/index.js';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { deleteTable } from '@hubspot/local-dev-lib/api/hubdb';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { selectHubDBTablePrompt } from '../../lib/prompts/selectHubDBTablePrompt.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { commands } from '../../lang/en.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'delete [table-id]';
 const describe = commands.hubdb.subcommands.delete.describe;
 async function handler(args) {
-    const { force, derivedAccountId } = args;
-    trackCommandUsage('hubdb-delete', {}, derivedAccountId);
+    const { force, derivedAccountId, exit } = args;
     try {
         const { tableId } = 'tableId' in args && args.tableId
             ? args
@@ -26,14 +26,17 @@ async function handler(args) {
                 message: commands.hubdb.subcommands.delete.shouldDeleteTable(tableId),
             });
             if (!shouldDeleteTable) {
-                process.exit(EXIT_CODES.SUCCESS);
+                return exit(EXIT_CODES.SUCCESS);
             }
         }
         await deleteTable(derivedAccountId, tableId);
         uiLogger.success(commands.hubdb.subcommands.delete.success.delete(tableId, derivedAccountId));
-        process.exit(EXIT_CODES.SUCCESS);
+        return exit(EXIT_CODES.SUCCESS);
     }
     catch (e) {
+        if (isPromptExitError(e)) {
+            throw e;
+        }
         uiLogger.error(commands.hubdb.subcommands.delete.errors.delete(args.tableId || ''));
         logError(e);
     }
@@ -58,7 +61,7 @@ const builder = makeYargsBuilder(hubdbDeleteBuilder, command, describe, {
 const hubdbDeleteCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('hubdb-delete', handler),
     builder,
 };
 export default hubdbDeleteCommand;

package/commands/hubdb/fetch.js

@@ -1,15 +1,15 @@
 import { uiLogger } from '../../lib/ui/logger.js';
 import { logError } from '../../lib/errorHandlers/index.js';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { downloadHubDbTable } from '@hubspot/local-dev-lib/hubdb';
 import { selectHubDBTablePrompt } from '../../lib/prompts/selectHubDBTablePrompt.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'fetch [table-id] [dest]';
 const describe = commands.hubdb.subcommands.fetch.describe;
 async function handler(args) {
     const { derivedAccountId } = args;
-    trackCommandUsage('hubdb-fetch', {}, derivedAccountId);
     try {
         const promptAnswers = await selectHubDBTablePrompt({
             accountId: derivedAccountId,
@@ -22,6 +22,9 @@ async function handler(args) {
         uiLogger.success(commands.hubdb.subcommands.fetch.success.fetch(tableId, filePath));
     }
     catch (e) {
+        if (isPromptExitError(e)) {
+            throw e;
+        }
         logError(e);
     }
 }
@@ -45,7 +48,7 @@ const builder = makeYargsBuilder(hubdbFetchBuilder, command, describe, {
 const hubdbFetchCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('hubdb-fetch', handler),
     builder,
 };
 export default hubdbFetchCommand;

package/commands/hubdb/list.d.ts

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

package/commands/hubdb/list.js

@@ -1,23 +1,18 @@
 import { fetchTables } from '@hubspot/local-dev-lib/api/hubdb';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
+import { uiLine } from '../../lib/ui/index.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { commands } from '../../lang/en.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { renderTable } from '../../ui/render.js';
-import { getBaseHubSpotUrlForAccount } from '../../lib/projects/urls.js';
+import { getHubSpotWebsiteOriginByAccountId } from '@hubspot/local-dev-lib/urls';
 const command = ['list', 'ls'];
 const describe = commands.hubdb.subcommands.list.describe;
 async function getTableData(accountId) {
-    try {
-        const response = await fetchTables(accountId);
-        return response.data;
-    }
-    catch (err) {
-        logError(err);
-        process.exit(EXIT_CODES.ERROR);
-    }
+    const response = await fetchTables(accountId);
+    return response.data;
 }
 // stripping the types and unnecessary fields so this data can be turned into a UI table
 function mapTablesToUI(tables) {
@@ -30,9 +25,17 @@ function mapTablesToUI(tables) {
     ]);
 }
 async function handler(args) {
-    const { derivedAccountId } = args;
-    trackCommandUsage('hubdb-list', {}, derivedAccountId);
-    const { results: tables, total } = await getTableData(derivedAccountId);
+    const { derivedAccountId, exit } = args;
+    let tableData;
+    try {
+        tableData = await getTableData(derivedAccountId);
+    }
+    catch (err) {
+        logError(err);
+        return exit(EXIT_CODES.ERROR);
+        return;
+    }
+    const { results: tables, total } = tableData;
     const tableUIData = mapTablesToUI(tables);
     const tableHeader = [
         commands.hubdb.subcommands.list.labels.id,
@@ -42,23 +45,21 @@ async function handler(args) {
         commands.hubdb.subcommands.list.labels.rows,
     ];
     uiLogger.success(commands.hubdb.subcommands.list.success(derivedAccountId));
-    uiLogger.log(' ');
-    // link devs to the hubdb page in hubspot for easy access
-    const baseUrl = getBaseHubSpotUrlForAccount(derivedAccountId);
-    uiLogger.log(commands.hubdb.subcommands.list.viewTablesLink(baseUrl, derivedAccountId));
     // don't bother showing an empty list of tables
     if (tables.length > 0) {
+        uiLogger.log(commands.hubdb.subcommands.list.tables);
+        renderTable(tableHeader, tableUIData);
         // if truncated is 0, it will be interpreted as falsy
         const truncated = total - tables.length;
+        uiLine();
         uiLogger.log(commands.hubdb.subcommands.list.tablesDisplayed(tables.length, total, truncated));
-        uiLogger.log('--------------------------------');
-        uiLogger.log(commands.hubdb.subcommands.list.tables);
-        renderTable(tableHeader, tableUIData);
     }
     else {
         uiLogger.log(commands.hubdb.subcommands.list.noTables(derivedAccountId));
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    // link devs to the hubdb page in hubspot for easy access
+    uiLogger.log(commands.hubdb.subcommands.list.viewTablesLink(getHubSpotWebsiteOriginByAccountId(derivedAccountId), derivedAccountId));
+    return exit(EXIT_CODES.SUCCESS);
 }
 function hubdbListBuilder(yargs) {
     yargs.example([['$0 hubdb list']]);
@@ -73,7 +74,7 @@ const builder = makeYargsBuilder(hubdbListBuilder, command, describe, {
 const hubdbListCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('hubdb-list', handler),
     builder,
 };
 export default hubdbListCommand;

package/commands/init.js

@@ -12,16 +12,19 @@ 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 { OAUTH_FLOW, legacyPersonalAccessKeyPrompt as 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 { makeWrappedYargsHandler } from '../lib/yargs/makeWrappedYargsHandler.js';
 import { uiLogger } from '../lib/ui/logger.js';
 import { commands } from '../lang/en.js';
 import { parseStringToNumber } from '../lib/parsing.js';
+import { showMcpPromotionNudge } from '../lib/mcp/promotion.js';
 const TRACKING_STATUS = {
     STARTED: 'started',
     ERROR: 'error',
@@ -61,7 +64,7 @@ async function oauthConfigCreationFlow(env) {
     }
     catch (e) {
         logError(e);
-        process.exit(EXIT_CODES.ERROR);
+        throw e;
     }
     return oauthAccount;
 }
@@ -72,7 +75,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 +84,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 +96,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);
@@ -144,17 +143,21 @@ async function handler(args) {
             'authCommand',
             'accountsListCommand',
         ]);
+        await showMcpPromotionNudge(args._.join(' '));
         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 +193,7 @@ const builder = makeYargsBuilder(initBuilder, command, commands.init.verboseDesc
 const initCommand = {
     command,
     describe,
-    handler,
+    handler: makeWrappedYargsHandler('init', handler),
     builder,
 };
 export default initCommand;

package/commands/mcp/setup.d.ts

@@ -1,6 +1,8 @@
 import { CommonArgs, YargsCommandModule } from '../../types/Yargs.js';
 interface MCPSetupArgs extends CommonArgs {
     client?: string[];
+    standalone?: boolean;
+    cliVersion?: string;
 }
 declare const mcpSetupCommand: YargsCommandModule<unknown, MCPSetupArgs>;
 export default mcpSetupCommand;