@veloxts/mcp 0.6.51 → 0.6.52

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @veloxts/mcp
 
+## 0.6.52
+
+### Patch Changes
+
+- feat(mcp): smart CLI resolution with fallbacks
+- Updated dependencies
+  - @veloxts/cli@0.6.52
+  - @veloxts/router@0.6.52
+  - @veloxts/validation@0.6.52
+
 ## 0.6.51
 
 ### Patch Changes

package/dist/tools/generate.js

@@ -5,6 +5,7 @@
  */
 import { spawn } from 'node:child_process';
 import { z } from 'zod';
+import { resolveVeloxCLI } from '../utils/cli.js';
 import { findProjectRoot } from '../utils/project.js';
 // ============================================================================
 // Output Validation Schemas
@@ -55,10 +56,11 @@ export async function generate(options) {
         };
     }
     const args = buildArgs(options);
+    const resolved = resolveVeloxCLI(projectRoot, args);
     return new Promise((resolve) => {
-        const child = spawn('npx', ['velox', ...args], {
+        const child = spawn(resolved.command, resolved.args, {
             cwd: projectRoot,
-            shell: true,
+            shell: resolved.isNpx, // Only use shell for npx fallback
             stdio: ['pipe', 'pipe', 'pipe'],
         });
         let stdout = '';

package/dist/tools/migrate.js

@@ -5,6 +5,7 @@
  */
 import { spawn } from 'node:child_process';
 import { z } from 'zod';
+import { resolveVeloxCLI } from '../utils/cli.js';
 import { findProjectRoot } from '../utils/project.js';
 // ============================================================================
 // Output Validation Schemas
@@ -54,10 +55,11 @@ export async function migrate(options) {
         };
     }
     const args = buildArgs(options);
+    const resolved = resolveVeloxCLI(projectRoot, args);
     return new Promise((resolve) => {
-        const child = spawn('npx', ['velox', ...args], {
+        const child = spawn(resolved.command, resolved.args, {
             cwd: projectRoot,
-            shell: true,
+            shell: resolved.isNpx, // Only use shell for npx fallback
             stdio: ['pipe', 'pipe', 'pipe'],
         });
         let stdout = '';

package/dist/utils/cli.d.ts

@@ -0,0 +1,26 @@
+/**
+ * CLI Resolution Utilities
+ *
+ * Utilities for finding and executing the VeloxTS CLI binary.
+ */
+/**
+ * Resolved CLI command information
+ */
+export interface ResolvedCLI {
+    /** Command to execute (binary path, 'node', or 'npx') */
+    command: string;
+    /** Arguments to pass (includes binary path if using node, or '@veloxts/cli' if using npx) */
+    args: string[];
+    /** Whether we're using npx fallback */
+    isNpx: boolean;
+}
+/**
+ * Resolve the VeloxTS CLI binary path with smart fallbacks
+ *
+ * Resolution order:
+ * 1. Local node_modules/.bin/velox (fastest, respects local version)
+ * 2. Windows .cmd wrapper (node_modules/.bin/velox.cmd)
+ * 3. Resolve @veloxts/cli package and find bin entry
+ * 4. Fallback to npx @veloxts/cli (slowest, downloads if needed)
+ */
+export declare function resolveVeloxCLI(projectRoot: string, args: string[]): ResolvedCLI;

package/dist/utils/cli.js

@@ -0,0 +1,68 @@
+/**
+ * CLI Resolution Utilities
+ *
+ * Utilities for finding and executing the VeloxTS CLI binary.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Resolve the VeloxTS CLI binary path with smart fallbacks
+ *
+ * Resolution order:
+ * 1. Local node_modules/.bin/velox (fastest, respects local version)
+ * 2. Windows .cmd wrapper (node_modules/.bin/velox.cmd)
+ * 3. Resolve @veloxts/cli package and find bin entry
+ * 4. Fallback to npx @veloxts/cli (slowest, downloads if needed)
+ */
+export function resolveVeloxCLI(projectRoot, args) {
+    const isWindows = process.platform === 'win32';
+    // 1. Try local .bin/velox (Unix)
+    if (!isWindows) {
+        const localBin = join(projectRoot, 'node_modules', '.bin', 'velox');
+        if (existsSync(localBin)) {
+            return {
+                command: localBin,
+                args,
+                isNpx: false,
+            };
+        }
+    }
+    // 2. Try Windows .cmd wrapper
+    if (isWindows) {
+        const localBinCmd = join(projectRoot, 'node_modules', '.bin', 'velox.cmd');
+        if (existsSync(localBinCmd)) {
+            return {
+                command: localBinCmd,
+                args,
+                isNpx: false,
+            };
+        }
+    }
+    // 3. Try resolving @veloxts/cli package directly
+    try {
+        const cliPackageJson = join(projectRoot, 'node_modules', '@veloxts', 'cli', 'package.json');
+        if (existsSync(cliPackageJson)) {
+            const pkg = JSON.parse(readFileSync(cliPackageJson, 'utf-8'));
+            const binRelative = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.velox;
+            if (binRelative) {
+                const binPath = join(projectRoot, 'node_modules', '@veloxts', 'cli', binRelative);
+                if (existsSync(binPath)) {
+                    return {
+                        command: 'node',
+                        args: [binPath, ...args],
+                        isNpx: false,
+                    };
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore resolution errors, fall through to npx
+    }
+    // 4. Fallback to npx (works even if not installed locally)
+    return {
+        command: 'npx',
+        args: ['@veloxts/cli', ...args],
+        isNpx: true,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/mcp",
-  "version": "0.6.51",
+  "version": "0.6.52",
   "description": "Model Context Protocol server for VeloxTS - expose project context to AI tools",
   "type": "module",
   "main": "dist/index.js",
@@ -23,9 +23,9 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.25.1",
-    "@veloxts/router": "0.6.51",
-    "@veloxts/validation": "0.6.51",
-    "@veloxts/cli": "0.6.51"
+    "@veloxts/cli": "0.6.52",
+    "@veloxts/validation": "0.6.52",
+    "@veloxts/router": "0.6.52"
   },
   "peerDependencies": {
     "zod": ">=3.25.0"