@hubspot/cli 8.15.0-beta.1 → 8.15.0-beta.2

package/bin/cli.js

@@ -33,6 +33,7 @@ import mcpCommand from '../commands/mcp.js';
 import upgradeCommand from '../commands/upgrade.js';
 import apiCommand from '../commands/api.js';
 import { uiLogger } from '../lib/ui/logger.js';
+import { lib } from '../lang/en.js';
 import { initializeSpinniesManager } from '../lib/middleware/spinniesMiddleware.js';
 import { addCommandSuggestions } from '../lib/commandSuggestion.js';
 import { pkg } from '../lib/jsonLoader.js';
@@ -80,10 +81,14 @@ const argv = yargs(process.argv.slice(2))
     describe: 'prevent hyperlinks from displaying in the ui',
     hidden: true,
     type: 'boolean',
+})
+    .option('color', {
+    default: true,
+    describe: lib.commonOpts.options.color,
+    type: 'boolean',
 })
     .option('noColor', {
     default: false,
-    describe: 'prevent color from displaying in the ui',
     hidden: true,
     type: 'boolean',
 })

package/bin/hs.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import './setupColor.js';
 import './silenceErrors.js';
 
 import './cli.js';

package/bin/hscms.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import './setupColor.js';
 import './silenceErrors.js';
 
 import './cli.js';

package/bin/setupColor.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/setupColor.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { hasColorDisableSignal } from '../lib/ui/supportsColor.js';
+// Runs before cli.js so it executes before chalk is imported. chalk reads
+// FORCE_COLOR (but not NO_COLOR / COLOR) once at load and caches its color
+// level, and lang/en.ts bakes chalk styling into strings at import time. So
+// translating a no-color request into FORCE_COLOR=0 here, ahead of those
+// imports, is what makes NO_COLOR / COLOR actually disable color everywhere.
+if (hasColorDisableSignal()) {
+    process.env.FORCE_COLOR = '0';
+}

package/lang/en.d.ts

@@ -1376,6 +1376,7 @@ export declare const commands: {
                 failedToConfigureVsCode: string;
                 configuredVsCode: string;
                 vsCodeNotFound: string;
+                vsCodeVersionUnsupported: string;
             };
             otherInstructions: {
                 header: string;
@@ -3838,6 +3839,7 @@ export declare const lib: {
             jsonOutput: string;
             jsonSchema: string;
             debug: string;
+            color: string;
         };
     };
     configMigrate: {

package/lang/en.js

@@ -1392,6 +1392,7 @@ export const commands = {
                 failedToConfigureVsCode: 'Failed to configure VSCode',
                 configuredVsCode: 'Configured VSCode',
                 vsCodeNotFound: "VSCode CLI is not installed (missing 'code' command). Install it and re-run hs mcp setup.",
+                vsCodeVersionUnsupported: 'VSCode 1.99 or later is required for MCP server support. Please update VSCode and try again.',
             },
             otherInstructions: {
                 header: 'To connect the HubSpot MCP server to another tool, add the following MCP server configuration.',
@@ -3877,6 +3878,7 @@ export const lib = {
             jsonOutput: 'Format output as JSON',
             jsonSchema: 'Print the JSON output schema and exit',
             debug: 'Set log level to debug',
+            color: 'Enable colored output (use --no-color to disable)',
         },
     },
     configMigrate: {

package/lib/mcp/setup.js

@@ -9,6 +9,7 @@ import path from 'path';
 import os from 'os';
 import fs from 'fs-extra';
 import { existsSync } from 'fs';
+import semver from 'semver';
 const mcpServerName = MCP_SERVER_NAME;
 const claudeCode = 'claude';
 const cursor = 'cursor';
@@ -18,6 +19,7 @@ const codex = 'codex';
 const gemini = 'gemini';
 const opencode = 'opencode';
 const OTHER_TOOL = 'other';
+const MINIMUM_VSCODE_VERSION = '1.99.0';
 const clientLabels = {
     codex: commands.mcp.setup.codex,
     claude: commands.mcp.setup.claudeCode,
@@ -204,11 +206,19 @@ function setupMcpConfigFile(config) {
     }
 }
 export async function setupVsCode(mcpCommand = defaultMcpCommand) {
+    const commandWithAgent = buildCommandWithAgentString(mcpCommand, vscode);
     try {
         SpinniesManager.add('vsCode', {
             text: commands.mcp.setup.spinners.configuringVsCode,
         });
-        const commandWithAgent = buildCommandWithAgentString(mcpCommand, vscode);
+        const { stdout } = await execAsync('code --version');
+        const version = stdout.trim().split('\n')[0];
+        if (!semver.gte(version, MINIMUM_VSCODE_VERSION)) {
+            SpinniesManager.fail('vsCode', {
+                text: commands.mcp.setup.spinners.vsCodeVersionUnsupported,
+            });
+            return false;
+        }
         const configObject = {
             name: mcpServerName,
             ...commandWithAgent,

package/lib/testUtils.d.ts

@@ -11,4 +11,5 @@ type MockErrorResponse = {
 };
 export declare function mockHubSpotHttpResponse<T>(data?: any): HubSpotPromise<T>;
 export declare function mockHubSpotHttpError(message: string, response: MockErrorResponse): HubSpotHttpError;
+export declare function stubColorEnv(): void;
 export {};

package/lib/testUtils.js

@@ -1,3 +1,4 @@
+import { vi } from 'vitest';
 import { HubSpotHttpError } from '@hubspot/local-dev-lib/models/HubSpotHttpError';
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function mockHubSpotHttpResponse(data) {
@@ -16,3 +17,16 @@ export function mockHubSpotHttpError(message, response) {
         cause: { isAxiosError: true, response },
     });
 }
+// Stubs the color-detection env to a color-capable interactive baseline.
+// Call vi.unstubAllEnvs() in afterEach to restore.
+export function stubColorEnv() {
+    [
+        'CI',
+        'NO_COLOR',
+        'COLOR',
+        'FORCE_COLOR',
+        'COLORTERM',
+        'TERM_PROGRAM',
+    ].forEach(key => vi.stubEnv(key, undefined));
+    vi.stubEnv('TERM', 'xterm-256color');
+}

package/lib/theme/cmsDevServerProcess.js

@@ -10,7 +10,7 @@ import { EXIT_CODES } from '../enums/exitCodes.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 // cms-dev-server version to install to isolated cache
-const TARGET_CMS_DEV_SERVER_VERSION = '1.2.44';
+const TARGET_CMS_DEV_SERVER_VERSION = '1.2.70';
 /**
  * Ensures cms-dev-server is installed in an isolated cache directory.
  * This prevents React version conflicts with the CLI.

package/lib/ui/SpinniesManager.d.ts

@@ -13,6 +13,7 @@ declare class SpinniesManager {
     private currentFrameIndex;
     private spin;
     private sigintHandler;
+    private rawOutputCache;
     constructor();
     init(options?: Partial<SpinnerState>): void;
     private resetState;

package/lib/ui/SpinniesManager.js

@@ -12,6 +12,7 @@ import chalk from 'chalk';
 import cliCursor from 'cli-cursor';
 import { breakText, cleanStream, colorOptions, getLinesLength, prefixOptions, purgeSpinnerOptions, purgeSpinnersOptions, SPINNERS, writeStream, } from './spinniesUtils.js';
 import { isUnicodeSupported } from '@hubspot/local-dev-lib/isUnicodeSupported';
+import { hasColorDisableSignal } from './supportsColor.js';
 import { uiLogger } from './logger.js';
 function safeColor(text, color) {
     const chalkFn = chalk[color];
@@ -31,6 +32,7 @@ class SpinniesManager {
     currentFrameIndex = 0;
     spin;
     sigintHandler = null;
+    rawOutputCache = {};
     constructor() {
         this.resetState();
     }
@@ -46,8 +48,8 @@ class SpinniesManager {
         this.spin =
             !this.options.disableSpins &&
                 !process.env.CI &&
-                process.stderr &&
-                process.stderr.isTTY;
+                !hasColorDisableSignal() &&
+                Boolean(process.stderr?.isTTY);
         if (!this.hasAnySpinners()) {
             this.resetState();
         }
@@ -64,6 +66,7 @@ class SpinniesManager {
         this.stream = process.stderr;
         this.lineCount = 0;
         this.currentFrameIndex = 0;
+        this.rawOutputCache = {};
     }
     setDisableOutput(disableOutput) {
         this.disableOutput = disableOutput;
@@ -105,6 +108,7 @@ class SpinniesManager {
             return;
         }
         delete this.spinners[name];
+        delete this.rawOutputCache[name];
         // Update the spinner state to clean up the deleted spinner
         this.updateSpinnerState();
     }
@@ -230,8 +234,13 @@ class SpinniesManager {
         this.lineCount = linesLength.length;
     }
     setRawStreamOutput() {
-        Object.values(this.spinners).forEach(i => {
-            process.stderr.write(`- ${i.text}\n`);
+        Object.entries(this.spinners).forEach(([name, spinner]) => {
+            const line = `- ${spinner.text ?? ''}\n`;
+            if (this.rawOutputCache[name] === line) {
+                return;
+            }
+            this.rawOutputCache[name] = line;
+            process.stderr.write(line);
         });
     }
     checkIfActiveSpinners() {
@@ -246,6 +255,7 @@ class SpinniesManager {
                 cliCursor.show();
             }
             this.spinners = {};
+            this.rawOutputCache = {};
         }
     }
     bindSigint() {

package/lib/ui/index.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import { getConfigAccountIfExists, globalConfigFileExists, } from '@hubspot/local-dev-lib/config';
 import { uiLogger } from './logger.js';
 import { supportsHyperlinkModule } from './supportHyperlinks.js';
-import { supportsColor } from './supportsColor.js';
+import { isColorEnabled } from './supportsColor.js';
 import { uiMessages } from './uiMessages.js';
 import { HUBSPOT_ACCOUNT_TYPE_STRINGS } from '@hubspot/local-dev-lib/constants/config';
 export const UI_COLORS = {
@@ -16,7 +16,7 @@ export function uiLine() {
 export function getTerminalUISupport() {
     return {
         hyperlinks: supportsHyperlinkModule.stdout,
-        color: supportsColor.stdout.hasBasic,
+        color: isColorEnabled(),
     };
 }
 export function uiLink(linkText, url) {

package/lib/ui/supportsColor.d.ts

@@ -4,6 +4,7 @@ interface ColorSupportLevel {
     has256: boolean;
     has16m: boolean;
 }
+export declare function hasColorDisableSignal(): boolean;
 declare function createSupportsColor(stream: {
     isTTY?: boolean;
 } | null, options?: {
@@ -14,4 +15,7 @@ export declare const supportsColor: {
     stdout: ColorSupportLevel;
     stderr: ColorSupportLevel;
 };
+export declare function isColorEnabled(stream?: {
+    isTTY?: boolean;
+} | null): boolean;
 export {};

package/lib/ui/supportsColor.js

@@ -19,17 +19,29 @@ function translateLevel(level) {
         has16m: level >= 3,
     };
 }
+function resolveColorPreference() {
+    const { NO_COLOR, COLOR, FORCE_COLOR, TERM } = env;
+    if (hasFlag('no-color') || hasFlag('noColor'))
+        return 'never';
+    if (NO_COLOR)
+        return 'never';
+    if (COLOR === 'false' || COLOR === '0')
+        return 'never';
+    if (FORCE_COLOR !== undefined) {
+        return FORCE_COLOR === '0' || FORCE_COLOR === 'false' ? 'never' : 'always';
+    }
+    if (TERM === 'dumb')
+        return 'never';
+    return 'auto';
+}
+export function hasColorDisableSignal() {
+    return resolveColorPreference() === 'never';
+}
 function _supportsColor(haveStream, { streamIsTTY } = {}) {
     if (haveStream && !streamIsTTY) {
         return 0;
     }
     const min = 0;
-    if (env.TERM === 'dumb') {
-        return min;
-    }
-    if (hasFlag('noColor')) {
-        return 0;
-    }
     if (process.platform === 'win32') {
         // Windows 10 build 10586 is the first Windows release that supports 256 colors.
         // Windows 10 build 14931 is the first release that supports 16m/TrueColor.
@@ -95,3 +107,10 @@ export const supportsColor = {
     stdout: createSupportsColor({ isTTY: tty.isatty(1) }),
     stderr: createSupportsColor({ isTTY: tty.isatty(2) }),
 };
+export function isColorEnabled(stream = process.stdout) {
+    const preference = resolveColorPreference();
+    if (preference !== 'auto') {
+        return preference === 'always';
+    }
+    return createSupportsColor(stream, { streamIsTTY: stream?.isTTY }).hasBasic;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/cli",
-    "version": "8.15.0-beta.1",
+    "version": "8.15.0-beta.2",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",