@sylphx/flow 2.4.0 → 2.4.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @sylphx/flow
 
+## 2.4.2 (2025-12-10)
+
+### 🐛 Bug Fixes
+
+- **mcp:** wrap npx/npm commands with cmd /c on Windows ([e37b126](https://github.com/SylphxAI/flow/commit/e37b1262c4002341df32de92f84ccdc1bf359d4b))
+
+## 2.4.1 (2025-12-10)
+
+### 🐛 Bug Fixes
+
+- **backup:** handle Windows symlink permission error ([8f1337f](https://github.com/SylphxAI/flow/commit/8f1337f6d1381ecceebc8751460a6cf710a62978))
+
 ## 2.4.0 (2025-12-09)
 
 ### ✨ Features

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "2.4.0",
+	"version": "2.4.2",
 	"description": "One CLI to rule them all. Unified orchestration layer for Claude Code, OpenCode, Cursor and all AI development tools. Auto-detection, auto-installation, auto-upgrade.",
 	"type": "module",
 	"bin": {

package/src/core/backup-manager.ts

@@ -128,12 +128,26 @@ export class BackupManager {
 
       await fs.writeFile(path.join(backupPath, 'manifest.json'), JSON.stringify(manifest, null, 2));
 
-      // Create symlink to latest
+      // Create symlink to latest (with fallback for Windows)
       const latestLink = paths.latestBackup;
       if (existsSync(latestLink)) {
         await fs.unlink(latestLink);
       }
-      await fs.symlink(sessionId, latestLink);
+      try {
+        await fs.symlink(sessionId, latestLink);
+      } catch (symlinkError: unknown) {
+        // Windows without admin/Developer Mode can't create symlinks
+        // Fall back to writing session ID to a file
+        if (
+          symlinkError instanceof Error &&
+          'code' in symlinkError &&
+          symlinkError.code === 'EPERM'
+        ) {
+          await fs.writeFile(latestLink, sessionId, 'utf-8');
+        } else {
+          throw symlinkError;
+        }
+      }
 
       spinner.succeed(`Backup created: ${sessionId}`);
 

package/src/targets/shared/mcp-transforms.ts

@@ -5,6 +5,17 @@
 
 import type { MCPServerConfigUnion } from '../../types.js';
 
+// ============================================================================
+// Platform Detection
+// ============================================================================
+
+const isWindows = process.platform === 'win32';
+
+/**
+ * Commands that require cmd /c wrapper on Windows
+ */
+const WINDOWS_WRAPPED_COMMANDS = ['npx', 'npm', 'pnpm', 'yarn', 'bun', 'node'];
+
 // ============================================================================
 // Types
 // ============================================================================
@@ -36,6 +47,38 @@ export interface RemoteConfig {
   headers?: Record<string, string>;
 }
 
+// ============================================================================
+// Windows Command Wrapper
+// ============================================================================
+
+/**
+ * Wrap command for Windows if needed
+ * On Windows, npx/npm/etc. need to be executed via cmd /c
+ */
+const wrapCommandForWindows = (
+  command: string,
+  args?: string[]
+): { command: string; args: string[] } => {
+  if (!isWindows) {
+    return { command, args: args || [] };
+  }
+
+  // Check if command needs wrapping
+  const needsWrapper = WINDOWS_WRAPPED_COMMANDS.some(
+    (cmd) => command === cmd || command.endsWith(`\\${cmd}`) || command.endsWith(`/${cmd}`)
+  );
+
+  if (needsWrapper) {
+    // Wrap with cmd /c
+    return {
+      command: 'cmd',
+      args: ['/c', command, ...(args || [])],
+    };
+  }
+
+  return { command, args: args || [] };
+};
+
 // ============================================================================
 // Pure Transform Functions
 // ============================================================================
@@ -51,13 +94,16 @@ export const stdioToLocal = (config: StdioConfig): LocalConfig => ({
 
 /**
  * Convert local format to stdio format (OpenCode → Claude Code)
+ * On Windows, wraps npx/npm/etc. with cmd /c
  */
 export const localToStdio = (config: LocalConfig): StdioConfig => {
   const [command, ...args] = config.command;
+  const wrapped = wrapCommandForWindows(command, args);
+
   return {
     type: 'stdio',
-    command,
-    ...(args.length > 0 && { args }),
+    command: wrapped.command,
+    ...(wrapped.args.length > 0 && { args: wrapped.args }),
     ...(config.environment && { env: config.environment }),
   };
 };
@@ -82,13 +128,18 @@ export const remoteToHttp = (config: RemoteConfig): HttpConfig => ({
 
 /**
  * Normalize stdio config (ensure consistent structure)
+ * On Windows, wraps npx/npm/etc. with cmd /c
  */
-export const normalizeStdio = (config: StdioConfig): StdioConfig => ({
-  type: 'stdio',
-  command: config.command,
-  ...(config.args && config.args.length > 0 && { args: config.args }),
-  ...(config.env && { env: config.env }),
-});
+export const normalizeStdio = (config: StdioConfig): StdioConfig => {
+  const wrapped = wrapCommandForWindows(config.command, config.args);
+
+  return {
+    type: 'stdio',
+    command: wrapped.command,
+    ...(wrapped.args.length > 0 && { args: wrapped.args }),
+    ...(config.env && { env: config.env }),
+  };
+};
 
 /**
  * Normalize http config (ensure consistent structure)