@hubspot/cli 7.7.15-experimental.0 → 7.7.16-experimental.1

package/bin/cli.js

@@ -44,6 +44,8 @@ const feedback_1 = __importDefault(require("../commands/feedback"));
 const doctor_1 = __importDefault(require("../commands/doctor"));
 const completion_1 = __importDefault(require("../commands/completion"));
 const app_1 = __importDefault(require("../commands/app"));
+const testAccount_1 = __importDefault(require("../commands/testAccount"));
+const getStarted_1 = __importDefault(require("../commands/getStarted"));
 const mcp_1 = __importDefault(require("../commands/mcp"));
 function getTerminalWidth() {
     const width = yargs_1.default.terminalWidth();
@@ -123,6 +125,8 @@ const argv = yargs_1.default
     .command(doctor_1.default)
     .command(completion_1.default)
     .command(app_1.default)
+    .command(testAccount_1.default)
+    .command(getStarted_1.default)
     .command(mcp_1.default)
     .help()
     .alias('h', 'help')

package/bin/hs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-require('./silenceErrors')
+require('./silenceErrors');
 
 require('./cli');

package/commands/getStarted.d.ts

@@ -0,0 +1,9 @@
+import { AccountArgs, YargsCommandModule, CommonArgs, ConfigArgs, EnvironmentArgs } from '../types/Yargs';
+export declare const command = "get-started";
+export declare const describe: undefined;
+type GetStartedArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
+    name?: string;
+    dest?: string;
+};
+declare const getStartedCommand: YargsCommandModule<unknown, GetStartedArgs>;
+export default getStartedCommand;

package/commands/getStarted.js

@@ -0,0 +1,227 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describe = exports.command = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const open_1 = __importDefault(require("open"));
+const path_2 = require("@hubspot/local-dev-lib/path");
+const github_1 = require("@hubspot/local-dev-lib/github");
+const en_1 = require("../lang/en");
+const usageTracking_1 = require("../lib/usageTracking");
+const exitCodes_1 = require("../lib/enums/exitCodes");
+const yargsUtils_1 = require("../lib/yargsUtils");
+const promptUtils_1 = require("../lib/prompts/promptUtils");
+const createProjectPrompt_1 = require("../lib/prompts/createProjectPrompt");
+const ui_1 = require("../lib/ui");
+const logger_1 = require("../lib/ui/logger");
+const errorHandlers_1 = require("../lib/errorHandlers");
+const upload_1 = require("../lib/projects/upload");
+const constants_1 = require("../lib/constants");
+const config_1 = require("../lib/projects/config");
+const buildAndDeploy_1 = require("../lib/projects/buildAndDeploy");
+const urls_1 = require("../lib/projects/urls");
+const links_1 = require("../lib/links");
+exports.command = 'get-started';
+exports.describe = undefined;
+async function handler(args) {
+    const { derivedAccountId } = args;
+    // TODO: Put this in constants.ts once we have a defined place for the template before INBOUND
+    const templateSource = 'robrown-hubspot/hubspot-project-components-ua-app-objects-beta';
+    (0, usageTracking_1.trackCommandUsage)('get-started', {}, derivedAccountId);
+    (0, ui_1.uiInfoSection)(en_1.commands.getStarted.startTitle, () => {
+        logger_1.uiLogger.log(en_1.commands.getStarted.startDescription);
+    });
+    const { default: selectedOption } = await (0, promptUtils_1.promptUser)([
+        {
+            type: 'list',
+            name: 'default',
+            message: en_1.commands.getStarted.prompts.selectOption,
+            choices: [
+                {
+                    name: en_1.commands.getStarted.prompts.options.app,
+                    value: constants_1.GET_STARTED_OPTIONS.APP,
+                },
+                {
+                    name: en_1.commands.getStarted.prompts.options.cms,
+                    value: constants_1.GET_STARTED_OPTIONS.CMS,
+                },
+            ],
+            default: constants_1.GET_STARTED_OPTIONS.APP,
+        },
+    ]);
+    if (selectedOption === constants_1.GET_STARTED_OPTIONS.CMS) {
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.designManager);
+        if (process.env.BROWSER !== 'none') {
+            logger_1.uiLogger.log(' ');
+            const { shouldOpen } = await (0, promptUtils_1.promptUser)([
+                {
+                    name: 'shouldOpen',
+                    type: 'confirm',
+                    message: en_1.commands.getStarted.openDesignManagerPrompt,
+                },
+            ]);
+            if (shouldOpen) {
+                logger_1.uiLogger.log('');
+                (0, links_1.openLink)(derivedAccountId, 'design-manager');
+            }
+        }
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+    }
+    else {
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.prompts.appSelected);
+        // 1. Fetch project templates
+        let latestRepoReleaseTag;
+        const { dest, name } = await (0, createProjectPrompt_1.createProjectPrompt)(args);
+        // Specific template for get-started command
+        const projectTemplate = {
+            name: 'private-app-get-started-template',
+            label: 'CRM getting started project with private apps',
+            path: 'projects/private-app-get-started-template',
+        };
+        // 3. Create the project files
+        const projectDest = path_1.default.resolve((0, path_2.getCwd)(), dest);
+        const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await (0, config_1.getProjectConfig)(projectDest);
+        if (existingProjectConfig &&
+            existingProjectDir &&
+            projectDest.startsWith(existingProjectDir)) {
+            logger_1.uiLogger.log(' ');
+            logger_1.uiLogger.error(en_1.commands.project.create.errors.cannotNestProjects(existingProjectDir));
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        const repo = templateSource || constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
+        // 4. Clone the project template from GitHub
+        // This is temporary until we have the UA template in the main repo
+        try {
+            await (0, github_1.cloneGithubRepo)(repo, projectDest, {
+                sourceDir: projectTemplate.path,
+                tag: latestRepoReleaseTag,
+                hideLogs: true,
+            });
+        }
+        catch (err) {
+            (0, errorHandlers_1.debugError)(err);
+            logger_1.uiLogger.log(' ');
+            logger_1.uiLogger.error(en_1.commands.project.create.errors.failedToDownloadProject);
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        const projectConfigPath = path_1.default.join(projectDest, constants_1.PROJECT_CONFIG_FILE);
+        const parsedConfigFile = JSON.parse(fs_extra_1.default.readFileSync(projectConfigPath).toString());
+        (0, config_1.writeProjectConfig)(projectConfigPath, {
+            ...parsedConfigFile,
+            name,
+        });
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.success(en_1.commands.project.create.logs.success(name, projectDest));
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.prompts.projectCreated.title);
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.prompts.projectCreated.description);
+        logger_1.uiLogger.log(' ');
+        // 5. Ask user if they want to upload the project
+        const { shouldUpload } = await (0, promptUtils_1.promptUser)([
+            {
+                type: 'confirm',
+                name: 'shouldUpload',
+                message: en_1.commands.getStarted.prompts.uploadProject,
+                default: true,
+            },
+        ]);
+        if (shouldUpload) {
+            try {
+                // Get the project config for the newly created project
+                const { projectConfig: newProjectConfig, projectDir: newProjectDir } = await (0, config_1.getProjectConfig)(projectDest);
+                if (!newProjectConfig || !newProjectDir) {
+                    logger_1.uiLogger.log(' ');
+                    logger_1.uiLogger.error(en_1.commands.getStarted.errors.configFileNotFound);
+                    process.exit(exitCodes_1.EXIT_CODES.ERROR);
+                }
+                (0, config_1.validateProjectConfig)(newProjectConfig, newProjectDir);
+                const targetAccountId = derivedAccountId;
+                logger_1.uiLogger.log(' ');
+                logger_1.uiLogger.log(en_1.commands.getStarted.logs.uploadingProject);
+                logger_1.uiLogger.log(' ');
+                const { result, uploadError } = await (0, upload_1.handleProjectUpload)({
+                    accountId: targetAccountId,
+                    projectConfig: newProjectConfig,
+                    projectDir: newProjectDir,
+                    callbackFunc: buildAndDeploy_1.pollProjectBuildAndDeploy,
+                    uploadMessage: 'Initial upload from get-started command',
+                    forceCreate: true, // Auto-create project on HubSpot
+                    isUploadCommand: false,
+                    sendIR: (0, buildAndDeploy_1.useV3Api)(newProjectConfig.platformVersion),
+                    skipValidation: false,
+                });
+                if (uploadError) {
+                    logger_1.uiLogger.log(' ');
+                    logger_1.uiLogger.error(en_1.commands.getStarted.errors.uploadFailed);
+                    (0, errorHandlers_1.debugError)(uploadError);
+                }
+                else if (result) {
+                    logger_1.uiLogger.log(' ');
+                    logger_1.uiLogger.success(en_1.commands.getStarted.logs.uploadSuccess);
+                    if (process.env.BROWSER !== 'none') {
+                        logger_1.uiLogger.log(' ');
+                        logger_1.uiLogger.log(en_1.commands.getStarted.developerOverviewBrowserOpenPrep);
+                        logger_1.uiLogger.log(' ');
+                        const { shouldOpenOverview } = await (0, promptUtils_1.promptUser)([
+                            {
+                                name: 'shouldOpenOverview',
+                                type: 'confirm',
+                                message: en_1.commands.getStarted.openDeveloperOverviewPrompt,
+                            },
+                        ]);
+                        if (shouldOpenOverview) {
+                            (0, open_1.default)((0, urls_1.getProjectComponentDistributionUrl)(name, 'get_started_app', derivedAccountId), { url: true });
+                            logger_1.uiLogger.log(' ');
+                            logger_1.uiLogger.success(en_1.commands.getStarted.openedDeveloperOverview);
+                        }
+                    }
+                    logger_1.uiLogger.log(' ');
+                    (0, ui_1.uiFeatureHighlight)(['projectDevCommand']);
+                }
+            }
+            catch (err) {
+                logger_1.uiLogger.log(' ');
+                logger_1.uiLogger.error(en_1.commands.getStarted.errors.uploadFailed);
+                (0, errorHandlers_1.debugError)(err);
+                process.exit(exitCodes_1.EXIT_CODES.ERROR);
+            }
+        }
+    }
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+}
+function getStartedBuilder(yargs) {
+    yargs.options({
+        name: {
+            describe: en_1.commands.getStarted.options.name.describe,
+            type: 'string',
+        },
+        dest: {
+            describe: en_1.commands.getStarted.options.dest.describe,
+            type: 'string',
+        },
+        'template-source': {
+            describe: en_1.commands.getStarted.options.templateSource.describe,
+            type: 'string',
+        },
+    });
+    return yargs;
+}
+const builder = (0, yargsUtils_1.makeYargsBuilder)(getStartedBuilder, exports.command, en_1.commands.getStarted.verboseDescribe, {
+    useGlobalOptions: true,
+    useAccountOptions: true,
+    useConfigOptions: true,
+    useEnvironmentOptions: true,
+});
+const getStartedCommand = {
+    command: exports.command,
+    describe: exports.describe,
+    handler,
+    builder,
+};
+exports.default = getStartedCommand;

package/commands/init.js

@@ -132,7 +132,12 @@ async function handler(args) {
             authType: AUTH_TYPE_NAMES[authType],
             account: name || accountId,
         }));
-        (0, ui_1.uiFeatureHighlight)(['helpCommand', 'authCommand', 'accountsListCommand']);
+        (0, ui_1.uiFeatureHighlight)([
+            'getStartedCommand',
+            'helpCommand',
+            'authCommand',
+            'accountsListCommand',
+        ]);
         if (!disableTracking) {
             await (0, usageTracking_1.trackAuthAction)('init', authType, TRACKING_STATUS.COMPLETE, accountId);
         }

package/commands/mcp/setup.d.ts

@@ -1,13 +1,7 @@
-import { ArgumentsCamelCase, Argv } from 'yargs';
-interface MCPSetupArgs {
+import { CommonArgs, YargsCommandModule } from '../../types/Yargs';
+interface MCPSetupArgs extends CommonArgs {
     client?: string[];
     addDocsSearch?: boolean;
 }
-declare function handler(args: ArgumentsCamelCase<MCPSetupArgs>): Promise<void>;
-declare const _default: {
-    command: string[];
-    describe: undefined;
-    builder: (yargs: Argv) => Promise<Argv<{}>>;
-    handler: typeof handler;
-};
-export default _default;
+declare const mcpSetupCommand: YargsCommandModule<unknown, MCPSetupArgs>;
+export default mcpSetupCommand;

package/commands/mcp/setup.js

@@ -1,50 +1,13 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const child_process_1 = require("child_process");
-const util_1 = require("util");
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
-const SpinniesManager_1 = __importDefault(require("../../lib/ui/SpinniesManager"));
 const exitCodes_1 = require("../../lib/enums/exitCodes");
-const promptUtils_1 = require("../../lib/prompts/promptUtils");
 const yargsUtils_1 = require("../../lib/yargsUtils");
 const en_1 = require("../../lang/en");
-const errorHandlers_1 = require("../../lib/errorHandlers");
 const logger_1 = require("../../lib/ui/logger");
+const setup_1 = require("../../lib/mcp/setup");
+const usageTracking_1 = require("../../lib/usageTracking");
 const command = ['setup', 'update'];
 const describe = undefined; // Leave hidden for now
-const execAsync = (0, util_1.promisify)(child_process_1.exec);
-const claudeCode = 'claude';
-const windsurf = 'windsurf';
-const cursor = 'cursor';
-const mcpServerName = 'hubspot-cli-mcp';
-const supportedMintlifyClients = [windsurf, cursor];
-const supportedTools = [
-    { name: en_1.commands.mcp.setup.claudeCode, value: claudeCode },
-    { name: en_1.commands.mcp.setup.cursor, value: cursor },
-    { name: en_1.commands.mcp.setup.windsurf, value: windsurf },
-];
-const hsCommand = 'hs';
-const mcpCommandArgs = ['mcp', 'start'];
-function setupBuilder(yargs) {
-    yargs
-        .option('client', {
-        describe: en_1.commands.mcp.setup.args.client,
-        type: 'array',
-        choices: [...supportedTools.map(tool => tool.value)],
-    })
-        .option('add-docs-search', {
-        type: 'boolean',
-    });
-    return yargs;
-}
-const builder = (0, yargsUtils_1.makeYargsBuilder)(setupBuilder, command, describe, {
-    useGlobalOptions: true,
-});
 async function handler(args) {
     try {
         await import('@modelcontextprotocol/sdk/server/mcp.js');
@@ -53,192 +16,37 @@ async function handler(args) {
         logger_1.uiLogger.error(en_1.commands.mcp.setup.errors.needsNode20);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    const derivedTargets = await addMcpServerToConfig(args.client);
-    if (args.addDocsSearch) {
-        logger_1.uiLogger.info(en_1.commands.mcp.setup.installingDocSearch);
-        logger_1.uiLogger.log('');
-        await new Promise(() => {
-            const subcommands = ['mint-mcp', 'add', 'hubspot-migration'];
-            const docsSearchClients = derivedTargets.filter(target => supportedMintlifyClients.includes(target));
-            const childProcess = (0, child_process_1.spawn)(`npx`, docsSearchClients && docsSearchClients.length
-                ? [...subcommands, '--client', ...docsSearchClients]
-                : subcommands, {
-                stdio: 'inherit',
-            });
-            childProcess.on('exit', code => {
-                if (code !== 0) {
-                    process.exit(exitCodes_1.EXIT_CODES.ERROR);
-                }
-                process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
-            });
-        });
-    }
-    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
-}
-async function addMcpServerToConfig(targets) {
+    (0, usageTracking_1.trackCommandUsage)('mcp-setup', {}, args.derivedAccountId);
     try {
-        let derivedTargets = [];
-        if (!targets || targets.length === 0) {
-            const { selectedTargets } = await (0, promptUtils_1.promptUser)({
-                name: 'selectedTargets',
-                type: 'checkbox',
-                message: en_1.commands.mcp.setup.prompts.targets,
-                choices: supportedTools,
-                validate: (choices) => {
-                    return choices.length === 0
-                        ? en_1.commands.mcp.setup.prompts.targetsRequired
-                        : true;
-                },
-            });
-            derivedTargets = selectedTargets;
-        }
-        else {
-            derivedTargets = targets;
-        }
-        SpinniesManager_1.default.init();
-        if (derivedTargets.includes(claudeCode)) {
-            await runSetupFunction(setupClaudeCode);
-        }
-        if (derivedTargets.includes(cursor)) {
-            await runSetupFunction(setupCursor);
+        const derivedTargets = await (0, setup_1.addMcpServerToConfig)(args.client);
+        if (args.addDocsSearch) {
+            await (0, setup_1.addMintlifyMcpServer)(derivedTargets);
         }
-        if (derivedTargets.includes(windsurf)) {
-            await runSetupFunction(setupWindsurf);
-        }
-        logger_1.uiLogger.info(en_1.commands.mcp.setup.success(derivedTargets));
-        return derivedTargets;
-    }
-    catch (error) {
-        SpinniesManager_1.default.fail('mcpSetup', {
-            text: en_1.commands.mcp.setup.spinners.failedToConfigure,
-        });
-        (0, errorHandlers_1.logError)(error);
-        process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-}
-async function runSetupFunction(func) {
-    const result = await func();
-    if (!result) {
+    catch (e) {
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
 }
-function setupMcpConfigFile(config) {
-    try {
-        SpinniesManager_1.default.add('spinner', {
-            text: config.configuringMessage,
-        });
-        if (!fs_1.default.existsSync(config.configPath)) {
-            SpinniesManager_1.default.succeed('spinner', {
-                text: config.configMissingMessage ||
-                    `Config file not found at ${config.configPath}`,
-            });
-            return false;
-        }
-        let mcpConfig = {};
-        try {
-            const configContent = fs_1.default.readFileSync(config.configPath, 'utf8');
-            mcpConfig = JSON.parse(configContent);
-        }
-        catch (error) {
-            SpinniesManager_1.default.fail('spinner', {
-                text: config.failedMessage,
-            });
-            (0, errorHandlers_1.logError)(error);
-            return false;
-        }
-        // Initialize mcpServers if it doesn't exist
-        if (!mcpConfig.mcpServers) {
-            mcpConfig.mcpServers = {};
-        }
-        // Add or update HubSpot CLI MCP server
-        mcpConfig.mcpServers[mcpServerName] = {
-            command: hsCommand,
-            args: mcpCommandArgs,
-        };
-        // Write the updated config
-        fs_1.default.writeFileSync(config.configPath, JSON.stringify(mcpConfig, null, 2));
-        SpinniesManager_1.default.succeed('spinner', {
-            text: config.configuredMessage,
-        });
-        return true;
-    }
-    catch (error) {
-        SpinniesManager_1.default.fail('spinner', {
-            text: config.failedMessage,
-        });
-        (0, errorHandlers_1.logError)(error);
-        return false;
-    }
-}
-async function setupClaudeCode() {
-    try {
-        SpinniesManager_1.default.add('claudeCode', {
-            text: en_1.commands.mcp.setup.spinners.configuringClaudeCode,
-        });
-        try {
-            // Check if claude command is available
-            await execAsync('claude --version');
-            // Run claude mcp add command
-            const mcpConfig = JSON.stringify({
-                type: 'stdio',
-                command: hsCommand,
-                args: mcpCommandArgs,
-            });
-            const { stdout } = await execAsync('claude mcp list');
-            if (stdout.includes(mcpServerName)) {
-                SpinniesManager_1.default.update('claudeCode', {
-                    text: en_1.commands.mcp.setup.spinners.alreadyInstalled,
-                });
-                await execAsync(`claude mcp remove "${mcpServerName}" --scope user`);
-            }
-            await execAsync(`claude mcp add-json "${mcpServerName}" '${mcpConfig}' --scope user`);
-            SpinniesManager_1.default.succeed('claudeCode', {
-                text: en_1.commands.mcp.setup.spinners.configuredClaudeCode,
-            });
-            return true;
-        }
-        catch (error) {
-            if (error instanceof Error &&
-                error.message.includes('claude: command not found')) {
-                SpinniesManager_1.default.fail('claudeCode', {
-                    text: en_1.commands.mcp.setup.spinners.claudeCodeNotFound,
-                });
-            }
-            else {
-                SpinniesManager_1.default.fail('claudeCode', {
-                    text: en_1.commands.mcp.setup.spinners.claudeCodeInstallFailed,
-                });
-                (0, errorHandlers_1.logError)(error);
-            }
-            return false;
-        }
-    }
-    catch (error) {
-        SpinniesManager_1.default.fail('claudeCode', {
-            text: en_1.commands.mcp.setup.spinners.claudeCodeInstallFailed,
-        });
-        (0, errorHandlers_1.logError)(error);
-        return false;
-    }
-}
-function setupCursor() {
-    const cursorConfigPath = path_1.default.join(os_1.default.homedir(), '.cursor', 'mcp.json');
-    return setupMcpConfigFile({
-        configPath: cursorConfigPath,
-        configuringMessage: en_1.commands.mcp.setup.spinners.configuringCursor,
-        configuredMessage: en_1.commands.mcp.setup.spinners.configuredCursor,
-        failedMessage: en_1.commands.mcp.setup.spinners.failedToConfigureCursor,
-        configMissingMessage: en_1.commands.mcp.setup.spinners.noCursorMcpFile(cursorConfigPath),
-    });
-}
-function setupWindsurf() {
-    const windsurfConfigPath = path_1.default.join(os_1.default.homedir(), '.codeium', 'windsurf', 'mcp_config.json');
-    return setupMcpConfigFile({
-        configPath: windsurfConfigPath,
-        configuringMessage: en_1.commands.mcp.setup.spinners.configuringWindsurf,
-        configuredMessage: en_1.commands.mcp.setup.spinners.configuredWindsurf,
-        failedMessage: en_1.commands.mcp.setup.spinners.failedToConfigureWindsurf,
-        configMissingMessage: en_1.commands.mcp.setup.spinners.noWindsurfFile(windsurfConfigPath),
+function setupBuilder(yargs) {
+    yargs
+        .option('client', {
+        describe: en_1.commands.mcp.setup.args.client,
+        type: 'array',
+        choices: [...setup_1.supportedTools.map(tool => tool.value)],
+    })
+        .option('add-docs-search', {
+        type: 'boolean',
     });
+    return yargs;
 }
-exports.default = { command, describe, builder, handler };
+const builder = (0, yargsUtils_1.makeYargsBuilder)(setupBuilder, command, describe, {
+    useGlobalOptions: true,
+});
+const mcpSetupCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = mcpSetupCommand;

package/commands/mcp/start.d.ts

@@ -1,9 +1,3 @@
-import { Argv } from 'yargs';
-declare function handler(): Promise<void>;
-declare const _default: {
-    command: string;
-    describe: undefined;
-    builder: (yargs: Argv) => Promise<Argv<{}>>;
-    handler: typeof handler;
-};
-export default _default;
+import { CommonArgs, YargsCommandModule } from '../../types/Yargs';
+declare const mcpStartCommand: YargsCommandModule<unknown, CommonArgs>;
+export default mcpStartCommand;

package/commands/mcp/start.js

@@ -11,15 +11,11 @@ const yargsUtils_1 = require("../../lib/yargsUtils");
 const logger_1 = require("../../lib/ui/logger");
 const errorHandlers_1 = require("../../lib/errorHandlers");
 const en_1 = require("../../lang/en");
+const process_1 = require("../../lib/process");
+const usageTracking_1 = require("../../lib/usageTracking");
 const command = 'start';
 const describe = undefined; // Leave hidden for now
-function startBuilder(yargs) {
-    return yargs;
-}
-const builder = (0, yargsUtils_1.makeYargsBuilder)(startBuilder, command, describe, {
-    useGlobalOptions: true,
-});
-async function handler() {
+async function handler(args) {
     try {
         await import('@modelcontextprotocol/sdk/server/mcp.js');
     }
@@ -27,6 +23,7 @@ async function handler() {
         logger_1.uiLogger.error(en_1.commands.mcp.start.errors.needsNode20);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
+    (0, usageTracking_1.trackCommandUsage)('mcp-start', {}, args.derivedAccountId);
     await startMcpServer();
 }
 async function startMcpServer() {
@@ -54,13 +51,7 @@ async function startMcpServer() {
         child.on('close', () => {
             logger_1.uiLogger.info(en_1.commands.mcp.start.stoppedSuccessfully);
         });
-        // Handle graceful shutdown
-        process.on('SIGINT', () => {
-            logger_1.uiLogger.info(en_1.commands.mcp.start.shuttingDown);
-            child.kill('SIGTERM');
-            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
-        });
-        process.on('SIGTERM', () => {
+        (0, process_1.handleExit)(() => {
             logger_1.uiLogger.info(en_1.commands.mcp.start.shuttingDown);
             child.kill('SIGTERM');
             process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
@@ -71,4 +62,16 @@ async function startMcpServer() {
         (0, errorHandlers_1.logError)(error);
     }
 }
-exports.default = { command, describe, builder, handler };
+function startBuilder(yargs) {
+    return yargs;
+}
+const builder = (0, yargsUtils_1.makeYargsBuilder)(startBuilder, command, describe, {
+    useGlobalOptions: true,
+});
+const mcpStartCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = mcpStartCommand;

package/commands/mcp.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const start_1 = __importDefault(require("./mcp/start"));
 const setup_1 = __importDefault(require("./mcp/setup"));
 const yargsUtils_1 = require("../lib/yargsUtils");
+const en_1 = require("../lang/en");
 const command = 'mcp';
 // Leave this as undefined to hide the command
 const describe = undefined;
@@ -13,7 +14,7 @@ function mcpBuilder(yargs) {
     yargs.command(start_1.default).command(setup_1.default).demandCommand(1, '');
     return yargs;
 }
-const builder = (0, yargsUtils_1.makeYargsBuilder)(mcpBuilder, command, describe, {
+const builder = (0, yargsUtils_1.makeYargsBuilder)(mcpBuilder, command, en_1.commands.mcp.describe, {
     useGlobalOptions: true,
 });
 const mcpCommand = {

package/commands/project/deploy.d.ts

@@ -4,6 +4,7 @@ export type ProjectDeployArgs = CommonArgs & ConfigArgs & AccountArgs & Environm
     build?: number;
     buildId?: number;
     profile?: string;
+    force: boolean;
 };
 declare const projectDeployCommand: YargsCommandModule<unknown, ProjectDeployArgs>;
 export default projectDeployCommand;