@meltstudio/meltctl 4.33.1 → 4.34.0

package/dist/utils/analytics.js

@@ -3,6 +3,7 @@ import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { getStoredAuth, API_BASE } from './auth.js';
 import { getGitRepository, getGitBranch, getProjectName } from './git.js';
+import { debugLog } from './debug.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 function getVersion() {
@@ -16,14 +17,19 @@ function getVersion() {
 }
 export async function trackCommand(command, success, errorMessage) {
     try {
+        if (process.env['MELTCTL_NO_ANALYTICS']) {
+            debugLog('Analytics disabled via MELTCTL_NO_ANALYTICS');
+            return;
+        }
         const auth = await getStoredAuth();
         if (!auth || new Date(auth.expiresAt) <= new Date()) {
+            debugLog('Analytics skipped: not authenticated or token expired');
             return;
         }
         const repo = getGitRepository();
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), 3000);
-        await fetch(`${API_BASE}/events`, {
+        const res = await fetch(`${API_BASE}/events`, {
             method: 'POST',
             headers: {
                 Authorization: `Bearer ${auth.token}`,
@@ -39,10 +45,20 @@ export async function trackCommand(command, success, errorMessage) {
                 errorMessage: errorMessage?.slice(0, 500) ?? null,
             }),
             signal: controller.signal,
-        }).catch(() => { });
+        }).catch(e => {
+            debugLog(`Analytics fetch failed: ${e instanceof Error ? e.message : e}`);
+            return null;
+        });
         clearTimeout(timeout);
+        if (res && !res.ok) {
+            const body = await res.text().catch(() => '');
+            debugLog(`Analytics API error ${res.status}: ${body}`);
+        }
+        else if (res) {
+            debugLog(`Analytics event sent for "${command}"`);
+        }
     }
-    catch {
-        // Analytics must never break the CLI
+    catch (e) {
+        debugLog(`Analytics error: ${e instanceof Error ? e.message : e}`);
     }
 }

package/dist/utils/debug.d.ts

@@ -0,0 +1 @@
+export declare function debugLog(message: string): void;

package/dist/utils/debug.js

@@ -0,0 +1,6 @@
+import chalk from 'chalk';
+export function debugLog(message) {
+    if (process.env['MELTCTL_DEBUG']) {
+        console.error(chalk.dim(`[debug] ${message}`));
+    }
+}

package/dist/utils/version-check.d.ts

@@ -2,4 +2,6 @@ export declare function getCurrentCliVersion(): Promise<string>;
 export declare function getLatestCliVersion(): Promise<string | null>;
 export declare function compareVersions(current: string, latest: string): boolean;
 export declare function isCI(): boolean;
+export type UpdateSeverity = 'none' | 'patch' | 'minor' | 'major';
+export declare function getUpdateSeverity(current: string, latest: string): UpdateSeverity;
 export declare function checkAndEnforceUpdate(): Promise<void>;

package/dist/utils/version-check.js

@@ -72,6 +72,19 @@ export function isCI() {
         process.env.MELTCTL_SKIP_UPDATE_CHECK // Custom override
     );
 }
+export function getUpdateSeverity(current, latest) {
+    const parseCurrent = current.split('-')[0].split('.').map(Number);
+    const parseLatest = latest.split('-')[0].split('.').map(Number);
+    const [curMajor = 0, curMinor = 0, curPatch = 0] = parseCurrent;
+    const [latMajor = 0, latMinor = 0, latPatch = 0] = parseLatest;
+    if (latMajor > curMajor)
+        return 'major';
+    if (latMajor === curMajor && latMinor > curMinor)
+        return 'minor';
+    if (latMajor === curMajor && latMinor === curMinor && latPatch > curPatch)
+        return 'patch';
+    return 'none';
+}
 export async function checkAndEnforceUpdate() {
     // Skip update check in CI environments
     if (isCI()) {
@@ -84,27 +97,37 @@ export async function checkAndEnforceUpdate() {
         if (!latestVersion) {
             return;
         }
-        // Check if update is needed
-        if (compareVersions(currentVersion, latestVersion)) {
-            console.log();
-            console.log(chalk.red('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-            console.log(chalk.red.bold('  ⚠️  Update Required'));
-            console.log(chalk.red('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-            console.log();
-            console.log(chalk.yellow(`Current version: ${currentVersion}`));
-            console.log(chalk.green(`Latest version:  ${latestVersion}`));
-            console.log();
-            console.log(chalk.white('Please update meltctl to continue:'));
-            console.log();
-            console.log(chalk.cyan('  npm install -g @meltstudio/meltctl@latest'));
-            console.log();
-            console.log(chalk.gray('Or with yarn:'));
-            console.log(chalk.cyan('  yarn global add @meltstudio/meltctl@latest'));
+        const severity = getUpdateSeverity(currentVersion, latestVersion);
+        if (severity === 'none') {
+            return;
+        }
+        const updateCmd = 'npm install -g @meltstudio/meltctl@latest';
+        if (severity === 'patch') {
+            // Patch updates: warn but allow continuing
             console.log();
-            console.log(chalk.gray('To skip this check (CI/CD), set MELTCTL_SKIP_UPDATE_CHECK=1'));
+            console.log(chalk.yellow(`  Update available: ${currentVersion} → ${latestVersion} (run: ${updateCmd})`));
             console.log();
-            process.exit(1);
+            return;
         }
+        // Minor/major updates: block until updated
+        console.log();
+        console.log(chalk.red('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(chalk.red.bold('  ⚠️  Update Required'));
+        console.log(chalk.red('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log();
+        console.log(chalk.yellow(`Current version: ${currentVersion}`));
+        console.log(chalk.green(`Latest version:  ${latestVersion}`));
+        console.log();
+        console.log(chalk.white('Please update meltctl to continue:'));
+        console.log();
+        console.log(chalk.cyan(`  ${updateCmd}`));
+        console.log();
+        console.log(chalk.gray('Or with yarn:'));
+        console.log(chalk.cyan('  yarn global add @meltstudio/meltctl@latest'));
+        console.log();
+        console.log(chalk.gray('To skip this check (CI/CD), set MELTCTL_SKIP_UPDATE_CHECK=1'));
+        console.log();
+        process.exit(1);
     }
     catch {
         // If any error occurs during version check, allow continuing

package/dist/utils/version-check.test.js

@@ -9,7 +9,7 @@ vi.mock('fs-extra', () => ({
 }));
 import { execSync } from 'child_process';
 import fs from 'fs-extra';
-import { getCurrentCliVersion, getLatestCliVersion, compareVersions, isCI, checkAndEnforceUpdate, } from './version-check.js';
+import { getCurrentCliVersion, getLatestCliVersion, compareVersions, getUpdateSeverity, isCI, checkAndEnforceUpdate, } from './version-check.js';
 beforeEach(() => {
     vi.clearAllMocks();
     vi.spyOn(console, 'log').mockImplementation(() => { });
@@ -96,6 +96,26 @@ describe('isCI', () => {
         expect(isCI()).toBe(true);
     });
 });
+describe('getUpdateSeverity', () => {
+    it('returns major when major version is higher', () => {
+        expect(getUpdateSeverity('1.0.0', '2.0.0')).toBe('major');
+    });
+    it('returns minor when minor version is higher', () => {
+        expect(getUpdateSeverity('1.0.0', '1.1.0')).toBe('minor');
+    });
+    it('returns patch when only patch is higher', () => {
+        expect(getUpdateSeverity('1.0.0', '1.0.1')).toBe('patch');
+    });
+    it('returns none when versions are equal', () => {
+        expect(getUpdateSeverity('1.0.0', '1.0.0')).toBe('none');
+    });
+    it('returns none when current is newer', () => {
+        expect(getUpdateSeverity('2.0.0', '1.0.0')).toBe('none');
+    });
+    it('returns major over minor', () => {
+        expect(getUpdateSeverity('1.5.3', '2.0.0')).toBe('major');
+    });
+});
 describe('checkAndEnforceUpdate', () => {
     it('skips check in CI environment', async () => {
         process.env.CI = 'true';
@@ -119,13 +139,29 @@ describe('checkAndEnforceUpdate', () => {
         await checkAndEnforceUpdate();
         // Should not throw or exit
     });
-    it('calls process.exit when update is required', async () => {
+    it('blocks on minor version update', async () => {
         const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => undefined);
         fs.readJson.mockResolvedValue({ version: '4.25.0' });
         execSync.mockReturnValue('"4.26.0"\n');
         await checkAndEnforceUpdate();
         expect(exitSpy).toHaveBeenCalledWith(1);
     });
+    it('blocks on major version update', async () => {
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => undefined);
+        fs.readJson.mockResolvedValue({ version: '4.33.0' });
+        execSync.mockReturnValue('"5.0.0"\n');
+        await checkAndEnforceUpdate();
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('warns but does not block on patch update', async () => {
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => undefined);
+        fs.readJson.mockResolvedValue({ version: '4.33.0' });
+        execSync.mockReturnValue('"4.33.2"\n');
+        await checkAndEnforceUpdate();
+        expect(exitSpy).not.toHaveBeenCalled();
+        const logCalls = console.log.mock.calls.map((c) => String(c[0]));
+        expect(logCalls.some((msg) => msg.includes('Update available'))).toBe(true);
+    });
     it('allows continuing when getCurrentCliVersion throws', async () => {
         ;
         fs.readJson.mockRejectedValue(new Error('file not found'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "4.33.1",
+  "version": "4.34.0",
   "description": "AI-first development tools for teams - set up AGENTS.md, Claude Code, Cursor, and OpenCode standards",
   "main": "dist/index.js",
   "type": "module",