@hubspot/cli 7.9.0 → 7.9.1-experimental.0

package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js

@@ -2,6 +2,7 @@ import util from 'util';
 import { vi } from 'vitest';
 vi.mock('@hubspot/local-dev-lib/fs');
 vi.mock('@hubspot/local-dev-lib/config');
+vi.mock('@hubspot/local-dev-lib/config/defaultAccountOverride');
 vi.mock('@hubspot/local-dev-lib/personalAccessKey');
 vi.mock('../../projects/config');
 vi.mock('@hubspot/local-dev-lib/api/projects');
@@ -16,17 +17,19 @@ vi.mock('../../jsonLoader.js', () => {
     };
 });
 import { DiagnosticInfoBuilder, } from '../DiagnosticInfoBuilder.js';
-import { getAccountId as _getAccountId, getAccountConfig as _getAccountConfig, getConfigPath as _getConfigPath, getDefaultAccountOverrideFilePath as _getDefaultAccountOverrideFilePath, isConfigFlagEnabled as _isConfigFlagEnabled, } from '@hubspot/local-dev-lib/config';
+import { getConfigAccountIfExists as _getConfigAccountIfExists, getConfigAccountById as _getConfigAccountById, getConfigFilePath as _getConfigFilePath, isConfigFlagEnabled as _isConfigFlagEnabled, getConfigDefaultAccountIfExists as _getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
+import { getDefaultAccountOverrideFilePath as _getDefaultAccountOverrideFilePath } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
 import { getAccessToken as _getAccessToken } from '@hubspot/local-dev-lib/personalAccessKey';
 import { walk as _walk } from '@hubspot/local-dev-lib/fs';
 import { getProjectConfig as _getProjectConfig } from '../../projects/config.js';
 import { fetchProject as _fetchProject } from '@hubspot/local-dev-lib/api/projects';
 const walk = _walk;
 const getAccessToken = _getAccessToken;
-const getAccountConfig = _getAccountConfig;
-const getConfigPath = _getConfigPath;
+const getConfigAccountById = _getConfigAccountById;
+const getConfigAccountIfExists = _getConfigAccountIfExists;
+const getConfigDefaultAccountIfExists = _getConfigDefaultAccountIfExists;
+const getConfigFilePath = _getConfigFilePath;
 const getDefaultAccountOverrideFilePath = _getDefaultAccountOverrideFilePath;
-const getAccountId = _getAccountId;
 const getProjectConfig = _getProjectConfig;
 const isConfigFlagEnabled = _isConfigFlagEnabled;
 const fetchProject = _fetchProject;
@@ -36,6 +39,8 @@ util.promisify = utilPromisify;
 describe('lib/doctor/DiagnosticInfo', () => {
     const accountId = 898989;
     const accountConfig = {
+        name: 'test-account',
+        accountId: accountId,
         env: 'prod',
         authType: 'personalaccesskey',
         accountType: 'STANDARD',
@@ -73,16 +78,19 @@ describe('lib/doctor/DiagnosticInfo', () => {
     const configPath = '/path/to/config';
     const defaultAccountOverrideFile = 'path/to/default/account/override/.hsaccount';
     beforeEach(() => {
-        getAccountId.mockReturnValue(accountId);
-        getAccountConfig.mockReturnValue(accountConfig);
+        getConfigAccountIfExists.mockReturnValue({
+            accountId,
+            name: 'test',
+        });
+        getConfigAccountById.mockReturnValue(accountConfig);
+        getConfigDefaultAccountIfExists.mockReturnValue(accountConfig);
         walk.mockResolvedValue(projectFiles);
         isConfigFlagEnabled.mockReturnValue(false);
         mockPromisifyImpl.mockResolvedValue(npmVersion);
     });
     it('should initialize the required state on creation', () => {
         const builder = new DiagnosticInfoBuilder(processInfo);
-        expect(getAccountId).toHaveBeenCalledTimes(1);
-        expect(getAccountConfig).toHaveBeenCalledTimes(1);
+        expect(getConfigDefaultAccountIfExists).toHaveBeenCalledTimes(1);
         expect(builder.accountId).toEqual(accountId);
         expect(builder.env).toEqual(accountConfig.env);
         expect(builder.authType).toEqual(accountConfig.authType);
@@ -131,7 +139,7 @@ describe('lib/doctor/DiagnosticInfo', () => {
                 data: projectDetails,
             });
             getAccessToken.mockResolvedValue(accessToken);
-            getConfigPath.mockReturnValue(configPath);
+            getConfigFilePath.mockReturnValue(configPath);
             getDefaultAccountOverrideFilePath.mockReturnValue(defaultAccountOverrideFile);
         });
         it('should gather the required data and generate the diagnostic', async () => {

package/lib/doctor/__tests__/Doctor.test.js

@@ -6,6 +6,7 @@ import { HubSpotHttpError } from '@hubspot/local-dev-lib/models/HubSpotHttpError
 import { AxiosError } from 'axios';
 import { isSpecifiedError as _isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
 import { promisify as _promisify } from 'util';
+import { getConfigDefaultAccount as _getConfigDefaultAccount, getConfigDefaultAccountIfExists as _getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
 vi.mock('../../ui/logger.js');
 vi.mock('../Diagnosis');
 vi.mock('../../ui/SpinniesManager');
@@ -15,6 +16,7 @@ vi.mock('../../npm');
 vi.mock('@hubspot/local-dev-lib/portManager');
 vi.mock('@hubspot/local-dev-lib/personalAccessKey');
 vi.mock('@hubspot/local-dev-lib/errors/index');
+vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('util');
 const hasMissingPackages = vi.mocked(_hasMissingPackages);
 const isPortManagerPortAvailable = vi.mocked(_isPortManagerPortAvailable);
@@ -23,6 +25,8 @@ const accessTokenForPersonalAccessKey = vi.mocked(_accessTokenForPersonalAccessK
 const authorizedScopesForPortalAndUser = vi.mocked(_authorizedScopesForPortalAndUser);
 const scopesOnAccessToken = vi.mocked(_scopesOnAccessToken);
 const isSpecifiedError = vi.mocked(_isSpecifiedError);
+const getConfigDefaultAccount = vi.mocked(_getConfigDefaultAccount);
+const getConfigDefaultAccountIfExists = vi.mocked(_getConfigDefaultAccountIfExists);
 describe('lib/doctor/Doctor', () => {
     let doctor;
     // @ts-ignore
@@ -57,6 +61,16 @@ describe('lib/doctor/Doctor', () => {
         },
     };
     beforeEach(() => {
+        // Mock config functions
+        const mockAccount = {
+            accountId: 123456,
+            accountType: 'STANDARD',
+            name: 'Test Account',
+            authType: 'personalaccesskey',
+            personalAccessKey: 'test-key',
+        };
+        getConfigDefaultAccount.mockReturnValue(mockAccount);
+        getConfigDefaultAccountIfExists.mockReturnValue(mockAccount);
         doctor = new Doctor({
             generateDiagnosticInfo: vi.fn().mockResolvedValue({
                 ...diagnosticInfo,

package/lib/importData.js

@@ -1,4 +1,4 @@
-import { getAccountConfig, getAccountId, getEnv, } from '@hubspot/local-dev-lib/config';
+import { getConfigAccountById, getConfigAccountEnvironment, getConfigAccountIfExists, } from '@hubspot/local-dev-lib/config';
 import { createImport } from '@hubspot/local-dev-lib/api/crm';
 import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
 import { importDataTestAccountSelectPrompt } from './prompts/importDataTestAccountSelectPrompt.js';
@@ -7,7 +7,7 @@ import { isAppDeveloperAccount, isDeveloperTestAccount, isStandardAccount, } fro
 import { uiLogger } from './ui/logger.js';
 export async function handleImportData(targetAccountId, dataFileNames, importRequest) {
     try {
-        const baseUrl = getHubSpotWebsiteOrigin(getEnv());
+        const baseUrl = getHubSpotWebsiteOrigin(getConfigAccountEnvironment(targetAccountId));
         const response = await createImport(targetAccountId, importRequest, dataFileNames);
         const importId = response.data.id;
         uiLogger.info(lib.importData.viewImportLink(baseUrl, targetAccountId, importId));
@@ -18,19 +18,20 @@ export async function handleImportData(targetAccountId, dataFileNames, importReq
     }
 }
 export async function handleTargetTestAccountSelectionFlow(derivedAccountId, userProvidedAccount) {
-    let targetAccountId = null;
+    let targetAccountId;
+    let testAccount;
     if (userProvidedAccount) {
-        targetAccountId = getAccountId(userProvidedAccount);
+        testAccount = getConfigAccountIfExists(userProvidedAccount);
+        targetAccountId = testAccount?.accountId;
     }
     // Only allow users to pass in test accounts
     if (targetAccountId) {
-        const testAccount = getAccountConfig(targetAccountId);
-        if (!testAccount || !isDeveloperTestAccount(testAccount)) {
+        if (testAccount && !isDeveloperTestAccount(testAccount)) {
             throw new Error(lib.importData.errors.notDeveloperTestAccount);
         }
     }
     else {
-        const targetProjectAccountConfig = getAccountConfig(derivedAccountId);
+        const targetProjectAccountConfig = getConfigAccountById(derivedAccountId);
         if (!targetProjectAccountConfig) {
             throw new Error(lib.importData.errors.noAccountConfig(derivedAccountId));
         }

package/lib/links.js

@@ -1,7 +1,7 @@
 import open from 'open';
-import { getEnv } from '@hubspot/local-dev-lib/config';
-import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
+import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
+import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
 import { uiLogger } from './ui/logger.js';
 import { getTableContents, getTableHeader } from './ui/table.js';
 const COMMON_SITE_LINKS = {
@@ -75,7 +75,7 @@ const COMMON_SITE_LINKS = {
     },
 };
 export function getSiteLinksAsArray(accountId) {
-    const baseUrl = getHubSpotWebsiteOrigin(getEnv() === 'qa' ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD);
+    const baseUrl = getHubSpotWebsiteOrigin(getConfigAccountEnvironment(accountId));
     return Object.values(COMMON_SITE_LINKS)
         .sort((a, b) => (a.shortcut < b.shortcut ? -1 : 1))
         .map(l => ({ ...l, url: l.getUrl(accountId, baseUrl) }));
@@ -95,12 +95,12 @@ export function openLink(accountId, shortcut) {
         uiLogger.error(`We couldn't find a shortcut matching ${shortcut}.  Type 'hs open list' to see a list of available shortcuts`);
         return;
     }
-    const baseUrl = getHubSpotWebsiteOrigin(getEnv() === 'qa' ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD);
+    const baseUrl = getHubSpotWebsiteOrigin(getConfigAccountEnvironment(accountId));
     open(match.getUrl(accountId, baseUrl), { url: true });
     uiLogger.success(`We opened ${match.getUrl(accountId, baseUrl)} in your browser`);
 }
 export function getProductUpdatesUrl(rolloutId, accountId) {
-    const baseUrl = getHubSpotWebsiteOrigin(getEnv() === 'qa' ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD);
+    const baseUrl = getHubSpotWebsiteOrigin(accountId ? getConfigAccountEnvironment(accountId) : ENVIRONMENTS.PROD);
     if (accountId) {
         return `${baseUrl}/product-updates/${accountId}/in-beta?rollout=${rolloutId}`;
     }

package/lib/mcp/__tests__/setup.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/mcp/__tests__/setup.test.js

@@ -0,0 +1,127 @@
+import { execAsync } from '../../../mcp-server/utils/command.js';
+import { setupCodex, supportedTools } from '../setup.js';
+import SpinniesManager from '../../ui/SpinniesManager.js';
+import { logError } from '../../errorHandlers/index.js';
+import { commands } from '../../../lang/en.js';
+// Mock dependencies
+vi.mock('../../../mcp-server/utils/command.js');
+vi.mock('../../ui/SpinniesManager.js');
+vi.mock('../../ui/logger.js');
+vi.mock('../../errorHandlers/index.js');
+vi.mock('../../../lang/en.js', () => ({
+    commands: {
+        mcp: {
+            setup: {
+                codex: 'Codex CLI',
+                claudeCode: 'Claude Code',
+                cursor: 'Cursor',
+                vsCode: 'VS Code',
+                windsurf: 'Windsurf',
+                success: vi.fn(targets => `Success message for ${targets.join(', ')}`),
+                spinners: {
+                    configuringCodex: 'Configuring Codex...',
+                    configuredCodex: 'Configured Codex',
+                    codexNotFound: 'Codex command not found - skipping configuration',
+                    codexInstallFailed: 'Failed to configure Codex',
+                },
+            },
+        },
+    },
+}));
+const mockedExecAsync = vi.mocked(execAsync);
+const mockedSpinniesManager = vi.mocked(SpinniesManager);
+const mockedLogError = vi.mocked(logError);
+describe('lib/mcp/setup', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    describe('supportedTools', () => {
+        it('should include Codex in the supported tools list', () => {
+            const codexTool = supportedTools.find(tool => tool.value === 'codex');
+            expect(codexTool).toBeDefined();
+            expect(codexTool?.name).toBe(commands.mcp.setup.codex);
+            expect(codexTool?.value).toBe('codex');
+        });
+        it('should have Codex as the first tool in the list', () => {
+            expect(supportedTools[0].value).toBe('codex');
+        });
+        it('should contain all expected tools', () => {
+            const toolValues = supportedTools.map(tool => tool.value);
+            expect(toolValues).toContain('codex');
+            expect(toolValues).toContain('claude');
+            expect(toolValues).toContain('cursor');
+            expect(toolValues).toContain('vscode');
+            expect(toolValues).toContain('windsurf');
+        });
+    });
+    describe('setupCodex', () => {
+        const mockMcpCommand = {
+            command: 'test-command',
+            args: ['--arg1', '--arg2'],
+        };
+        it('should successfully configure Codex when command is available', async () => {
+            mockedExecAsync.mockResolvedValueOnce({
+                stdout: 'codex version 1.0.0',
+                stderr: '',
+            }); // version check
+            mockedExecAsync.mockResolvedValueOnce({ stdout: '', stderr: '' }); // mcp add command
+            const result = await setupCodex(mockMcpCommand);
+            expect(result).toBe(true);
+            expect(mockedSpinniesManager.add).toHaveBeenCalledWith('codexSpinner', {
+                text: commands.mcp.setup.spinners.configuringCodex,
+            });
+            expect(mockedExecAsync).toHaveBeenCalledWith('codex --version');
+            expect(mockedExecAsync).toHaveBeenCalledWith('codex mcp add "HubSpotDev" -- test-command --arg1 --arg2 --ai-agent codex');
+            expect(mockedSpinniesManager.succeed).toHaveBeenCalledWith('codexSpinner', {
+                text: commands.mcp.setup.spinners.configuredCodex,
+            });
+        });
+        it('should use default mcp command when none provided', async () => {
+            mockedExecAsync.mockResolvedValueOnce({
+                stdout: 'codex version 1.0.0',
+                stderr: '',
+            }); // version check
+            mockedExecAsync.mockResolvedValueOnce({ stdout: '', stderr: '' }); // mcp add command
+            const result = await setupCodex();
+            expect(result).toBe(true);
+            expect(mockedExecAsync).toHaveBeenCalledWith('codex mcp add "HubSpotDev" -- hs mcp start --ai-agent codex');
+        });
+        it('should handle codex command not found', async () => {
+            const error = new Error('Command not found: codex');
+            mockedExecAsync.mockRejectedValueOnce(error);
+            const result = await setupCodex(mockMcpCommand);
+            expect(result).toBe(false);
+            expect(mockedSpinniesManager.fail).toHaveBeenCalledWith('codexSpinner', {
+                text: commands.mcp.setup.spinners.codexNotFound,
+            });
+        });
+        it('should handle codex installation failure', async () => {
+            const error = new Error('Some other error');
+            mockedExecAsync.mockResolvedValueOnce({
+                stdout: 'codex version 1.0.0',
+                stderr: '',
+            }); // version check passes
+            mockedExecAsync.mockRejectedValueOnce(error); // mcp add fails
+            const result = await setupCodex(mockMcpCommand);
+            expect(result).toBe(false);
+            expect(mockedSpinniesManager.fail).toHaveBeenCalledWith('codexSpinner', {
+                text: commands.mcp.setup.spinners.codexInstallFailed,
+            });
+            expect(mockedLogError).toHaveBeenCalledWith(error);
+        });
+        it('should handle unexpected errors during spinner setup', async () => {
+            const error = new Error('Unexpected error');
+            mockedSpinniesManager.add.mockImplementationOnce(() => {
+                throw error;
+            });
+            const result = await setupCodex(mockMcpCommand);
+            expect(result).toBe(false);
+            expect(mockedSpinniesManager.fail).toHaveBeenCalledWith('codexSpinner', {
+                text: commands.mcp.setup.spinners.codexInstallFailed,
+            });
+            expect(mockedLogError).toHaveBeenCalledWith(error);
+        });
+    });
+    // Note: addMcpServerToConfig integration tests would require mocking many dependencies
+    // and complex setup. The setupCodex function tests above cover the new functionality.
+});

package/lib/mcp/setup.d.ts

@@ -1,16 +1,7 @@
-export declare const supportedTools: ({
-    name: "Claude Code";
+export declare const supportedTools: {
+    name: string;
     value: string;
-} | {
-    name: "Cursor";
-    value: string;
-} | {
-    name: "Windsurf";
-    value: string;
-} | {
-    name: "VSCode";
-    value: string;
-})[];
+}[];
 interface McpCommand {
     command: string;
     args: string[];
@@ -20,4 +11,5 @@ export declare function setupVsCode(mcpCommand?: McpCommand): Promise<boolean>;
 export declare function setupClaudeCode(mcpCommand?: McpCommand): Promise<boolean>;
 export declare function setupCursor(mcpCommand?: McpCommand): boolean;
 export declare function setupWindsurf(mcpCommand?: McpCommand): boolean;
+export declare function setupCodex(mcpCommand?: McpCommand): Promise<boolean>;
 export {};

package/lib/mcp/setup.js

@@ -13,11 +13,13 @@ const claudeCode = 'claude';
 const windsurf = 'windsurf';
 const cursor = 'cursor';
 const vscode = 'vscode';
+const codex = 'codex';
 export const supportedTools = [
+    { name: commands.mcp.setup.codex, value: codex },
     { name: commands.mcp.setup.claudeCode, value: claudeCode },
     { name: commands.mcp.setup.cursor, value: cursor },
-    { name: commands.mcp.setup.windsurf, value: windsurf },
     { name: commands.mcp.setup.vsCode, value: vscode },
+    { name: commands.mcp.setup.windsurf, value: windsurf },
 ];
 const defaultMcpCommand = {
     command: 'hs',
@@ -56,6 +58,9 @@ export async function addMcpServerToConfig(targets) {
         if (derivedTargets.includes(vscode)) {
             await runSetupFunction(setupVsCode);
         }
+        if (derivedTargets.includes(codex)) {
+            await runSetupFunction(setupCodex);
+        }
         uiLogger.info(commands.mcp.setup.success(derivedTargets));
         return derivedTargets;
     }
@@ -231,6 +236,34 @@ export function setupWindsurf(mcpCommand = defaultMcpCommand) {
         mcpCommand: buildCommandWithAgentString(mcpCommand, windsurf),
     });
 }
+export async function setupCodex(mcpCommand = defaultMcpCommand) {
+    try {
+        SpinniesManager.add('codexSpinner', {
+            text: commands.mcp.setup.spinners.configuringCodex,
+        });
+        // Check if codex command is available
+        await execAsync('codex --version');
+        await execAsync(`codex mcp add "${mcpServerName}" -- ${mcpCommand.command} ${mcpCommand.args.join(' ')} --ai-agent codex`);
+        SpinniesManager.succeed('codexSpinner', {
+            text: commands.mcp.setup.spinners.configuredCodex,
+        });
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('codex')) {
+            SpinniesManager.fail('codexSpinner', {
+                text: commands.mcp.setup.spinners.codexNotFound,
+            });
+        }
+        else {
+            SpinniesManager.fail('codexSpinner', {
+                text: commands.mcp.setup.spinners.codexInstallFailed,
+            });
+            logError(error);
+        }
+        return false;
+    }
+}
 function buildCommandWithAgentString(mcpCommand, agent) {
     const mcpCommandCopy = structuredClone(mcpCommand);
     mcpCommandCopy.args.push('--ai-agent', agent);

package/lib/middleware/__test__/commandTargetingUtils.test.js

@@ -1,7 +1,7 @@
 import * as cliConfig from '@hubspot/local-dev-lib/config';
 import { isTargetedCommand, shouldLoadConfigForCommand, shouldRunAccountValidationForCommand, shouldRunConfigValidationForCommand, } from '../commandTargetingUtils.js';
 vi.mock('@hubspot/local-dev-lib/config');
-const configFileExistsSpy = vi.spyOn(cliConfig, 'configFileExists');
+const globalConfigFileExistsSpy = vi.spyOn(cliConfig, 'globalConfigFileExists');
 const targetCommandMap = {
     init: true,
     account: {
@@ -56,12 +56,12 @@ describe('lib/middleware/commandTargetingUtils', () => {
             expect(result).toBe(false);
         });
         it('should return false when the user is trying to migrate the global config', () => {
-            configFileExistsSpy.mockReturnValue(false);
+            globalConfigFileExistsSpy.mockReturnValue(false);
             const result = shouldLoadConfigForCommand(['config', 'migrate']);
             expect(result).toBe(false);
         });
         it('should return true when the global config file does exist', () => {
-            configFileExistsSpy.mockReturnValue(true);
+            globalConfigFileExistsSpy.mockReturnValue(true);
             const result = shouldLoadConfigForCommand(['account', 'use']);
             expect(result).toBe(true);
         });

package/lib/middleware/__test__/configMiddleware.test.js

@@ -2,7 +2,7 @@ import { uiLogger } from '../../ui/logger.js';
 import * as cliConfig from '@hubspot/local-dev-lib/config';
 import * as validation from '../../validation.js';
 import { EXIT_CODES } from '../../enums/exitCodes.js';
-import { handleDeprecatedEnvVariables, injectAccountIdMiddleware, loadAndValidateConfigMiddleware, validateAccountOptions, } from '../configMiddleware.js';
+import { handleDeprecatedEnvVariables, injectAccountIdMiddleware, validateConfigMiddleware, validateAccountOptions, } from '../configMiddleware.js';
 vi.mock('../../ui/logger.js', () => ({
     uiLogger: {
         error: vi.fn(),
@@ -12,10 +12,10 @@ vi.mock('../../ui/logger.js', () => ({
 vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('../../validation');
 const validateAccountSpy = vi.spyOn(validation, 'validateAccount');
-const loadConfigSpy = vi.spyOn(cliConfig, 'loadConfig');
-const getAccountIdSpy = vi.spyOn(cliConfig, 'getAccountId');
+const getConfigAccountIfExistsSpy = vi.spyOn(cliConfig, 'getConfigAccountIfExists');
+const globalConfigFileExistsSpy = vi.spyOn(cliConfig, 'globalConfigFileExists');
 const configFileExistsSpy = vi.spyOn(cliConfig, 'configFileExists');
-const getConfigPathSpy = vi.spyOn(cliConfig, 'getConfigPath');
+const getConfigFilePathSpy = vi.spyOn(cliConfig, 'getConfigFilePath');
 const validateConfigSpy = vi.spyOn(cliConfig, 'validateConfig');
 const processExitSpy = vi.spyOn(process, 'exit');
 describe('lib/middleware/configMiddleware', () => {
@@ -23,7 +23,7 @@ describe('lib/middleware/configMiddleware', () => {
         processExitSpy.mockImplementation(code => {
             throw new Error(`Process.exit called with code ${code}`);
         });
-        getConfigPathSpy.mockReturnValue('/path/to/config');
+        getConfigFilePathSpy.mockReturnValue('/path/to/config');
     });
     describe('handleDeprecatedEnvVariables()', () => {
         it('should handle deprecated HUBSPOT_PORTAL_ID environment variable', () => {
@@ -76,11 +76,13 @@ describe('lib/middleware/configMiddleware', () => {
             await injectAccountIdMiddleware(argv);
             expect(argv.userProvidedAccount).toBeUndefined();
             expect(argv.derivedAccountId).toBe(123);
-            expect(getAccountIdSpy).not.toHaveBeenCalled();
+            expect(getConfigAccountIfExistsSpy).not.toHaveBeenCalled();
             process.env = originalEnv;
         });
         it('should use getAccountId when useEnv is false', async () => {
-            getAccountIdSpy.mockReturnValue(456);
+            getConfigAccountIfExistsSpy.mockReturnValue({
+                accountId: 456,
+            });
             const argv = {
                 _: ['some-command'],
                 account: 'test-account',
@@ -90,41 +92,40 @@ describe('lib/middleware/configMiddleware', () => {
             await injectAccountIdMiddleware(argv);
             expect(argv.userProvidedAccount).toBe('test-account');
             expect(argv.derivedAccountId).toBe(456);
-            expect(getAccountIdSpy).toHaveBeenCalledWith('test-account');
+            expect(getConfigAccountIfExistsSpy).toHaveBeenCalledWith('test-account');
         });
     });
-    describe('loadAndValidateConfigMiddleware()', () => {
-        it('should exit with error when config file exists and --config flag is used', async () => {
+    describe('validateConfigMiddleware()', () => {
+        it('should allow using --config flag', async () => {
             configFileExistsSpy.mockReturnValue(true);
+            validateConfigSpy.mockReturnValue({ isValid: true, errors: [] });
             const argv = {
                 _: ['some-command'],
                 config: 'custom-config.json',
                 $0: 'hs',
             };
-            await expect(loadAndValidateConfigMiddleware(argv)).rejects.toThrow();
-            expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
-            expect(uiLogger.error).toHaveBeenCalledWith('A configuration file already exists at /path/to/config. To specify a new configuration file, delete the existing one and try again.');
+            await validateConfigMiddleware(argv);
+            // Should not throw or exit - this is now allowed
+            expect(processExitSpy).not.toHaveBeenCalled();
+            expect(uiLogger.error).not.toHaveBeenCalled();
         });
-        it('should load config and validate for non-init commands', async () => {
-            configFileExistsSpy.mockReturnValue(false);
-            loadConfigSpy.mockReturnValue({});
-            validateConfigSpy.mockReturnValue(true);
+        it('should validate config for non-init commands', async () => {
+            globalConfigFileExistsSpy.mockReturnValue(true);
+            validateConfigSpy.mockReturnValue({ isValid: true, errors: [] });
             const argv = {
                 _: ['some-command'],
                 $0: 'hs',
             };
-            await loadAndValidateConfigMiddleware(argv);
-            expect(loadConfigSpy).toHaveBeenCalled();
+            await validateConfigMiddleware(argv);
             expect(validateConfigSpy).toHaveBeenCalled();
         });
         it('should skip validation for init command', async () => {
-            configFileExistsSpy.mockReturnValue(false);
+            globalConfigFileExistsSpy.mockReturnValue(false);
             const argv = {
                 _: ['init'],
                 $0: 'hs',
             };
-            await loadAndValidateConfigMiddleware(argv);
-            expect(loadConfigSpy).not.toHaveBeenCalled();
+            await validateConfigMiddleware(argv);
             expect(validateConfigSpy).not.toHaveBeenCalled();
         });
     });

package/lib/middleware/__test__/gitMiddleware.test.js

@@ -3,19 +3,19 @@ import * as gitUI from '../../ui/git.js';
 import { checkAndWarnGitInclusionMiddleware } from '../gitMiddleware.js';
 vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('../../ui/git');
-const getConfigPathSpy = vi.spyOn(config, 'getConfigPath');
+const getConfigFilePathSpy = vi.spyOn(config, 'getConfigFilePath');
 const checkAndWarnGitInclusionSpy = vi.spyOn(gitUI, 'checkAndWarnGitInclusion');
 describe('lib/middleware/gitMiddleware', () => {
     describe('checkAndWarnGitInclusionMiddleware()', () => {
         it('should call checkAndWarnGitInclusion when command is provided and config path exists', () => {
             const mockConfigPath = '/path/to/config.js';
-            getConfigPathSpy.mockReturnValue(mockConfigPath);
+            getConfigFilePathSpy.mockReturnValue(mockConfigPath);
             const argv = {
                 _: ['some-command'],
                 $0: 'hs',
             };
             checkAndWarnGitInclusionMiddleware(argv);
-            expect(getConfigPathSpy).toHaveBeenCalledTimes(1);
+            expect(getConfigFilePathSpy).toHaveBeenCalledTimes(1);
             expect(checkAndWarnGitInclusionSpy).toHaveBeenCalledWith(mockConfigPath);
         });
         it('should not call checkAndWarnGitInclusion when no command is provided', () => {
@@ -24,17 +24,19 @@ describe('lib/middleware/gitMiddleware', () => {
                 $0: 'hs',
             };
             checkAndWarnGitInclusionMiddleware(argv);
-            expect(getConfigPathSpy).not.toHaveBeenCalled();
+            expect(getConfigFilePathSpy).not.toHaveBeenCalled();
             expect(checkAndWarnGitInclusionSpy).not.toHaveBeenCalled();
         });
-        it('should not call checkAndWarnGitInclusion when config path is null', () => {
-            getConfigPathSpy.mockReturnValue(null);
+        it('should not call checkAndWarnGitInclusion when config path does not exist', () => {
+            getConfigFilePathSpy.mockImplementation(() => {
+                throw new Error('Config path does not exist');
+            });
             const argv = {
                 _: ['some-command'],
                 $0: 'hs',
             };
             checkAndWarnGitInclusionMiddleware(argv);
-            expect(getConfigPathSpy).toHaveBeenCalledTimes(1);
+            expect(getConfigFilePathSpy).toHaveBeenCalledTimes(1);
             expect(checkAndWarnGitInclusionSpy).not.toHaveBeenCalled();
         });
     });

package/lib/middleware/autoUpdateMiddleware.d.ts

@@ -1,2 +1,4 @@
 import { Arguments } from 'yargs';
-export declare function autoUpdateCLI(argv: Arguments): Promise<void>;
+export declare function autoUpdateCLI(argv: Arguments<{
+    useEnv?: boolean;
+}>): Promise<void>;

package/lib/middleware/autoUpdateMiddleware.js

@@ -1,5 +1,5 @@
 import updateNotifier from 'update-notifier';
-import { isConfigFlagEnabled } from '@hubspot/local-dev-lib/config';
+import { getConfig } from '@hubspot/local-dev-lib/config';
 import { pkg } from '../jsonLoader.js';
 import { UI_COLORS } from '../ui/index.js';
 import SpinniesManager from '../ui/SpinniesManager.js';
@@ -45,10 +45,18 @@ const preventAutoUpdateForCommand = (commandParts) => {
 export async function autoUpdateCLI(argv) {
     // This lets us back to default update-notifier behavior
     let showManualInstallHelp = true;
+    let config;
+    try {
+        config = getConfig();
+    }
+    catch (e) {
+        debugError(e);
+    }
     if (notifier &&
         notifier.update &&
+        !argv.useEnv &&
         !process.env.SKIP_HUBSPOT_CLI_AUTO_UPDATES &&
-        isConfigFlagEnabled('allowAutoUpdates') &&
+        config?.allowAutoUpdates !== false &&
         !preventAutoUpdateForCommand(argv._)) {
         // Ignore all update notifications if the current version is a pre-release
         if (!notifier.update.current.includes('-')) {

package/lib/middleware/commandTargetingUtils.js

@@ -1,4 +1,4 @@
-import { configFileExists } from '@hubspot/local-dev-lib/config';
+import { globalConfigFileExists } from '@hubspot/local-dev-lib/config';
 export function isTargetedCommand(commandParts, targetCommandMap) {
     const currentCommandPart = commandParts[0];
     if (!targetCommandMap[currentCommandPart]) {
@@ -23,7 +23,7 @@ const SKIP_CONFIG_LOADING_COMMANDS = {
 };
 // Returns true if the command requires a config file to be present
 export function shouldLoadConfigForCommand(commandParts) {
-    const globalConfigExists = configFileExists(true);
+    const globalConfigExists = globalConfigFileExists();
     // the user is trying to migrate the global config
     const isGlobalConfigMigration = !globalConfigExists &&
         isTargetedCommand(commandParts, {