@gordon.gan/specflow 1.3.1-beta → 1.3.2-beta

package/README.md

@@ -124,7 +124,7 @@ npm install -g @gordon.gan/specflow
 npm install -g github:Gordon-Gan-Jiang/specflow
 
 # 验证
-specflow --version   # 以 npm / package.json 为准（当前 1.3.1-beta）
+specflow --version   # 以 npm / package.json 为准（当前 1.3.2-beta）
 specflow --help
 ```
 

package/dist/core/opener-launch.d.ts

@@ -5,14 +5,15 @@ export interface OpenerSpawnPlan {
     readonly args: string[];
     readonly options: SpawnSyncOptions;
 }
+export declare function selectWindowsOpenerPath(output: string): string | null;
 /**
  * Build spawn argv for launching a workspace-file opener.
  *
- * On Windows, Cursor/VS Code ship as `*.cmd` shims. Node's spawn with
- * `shell: false` cannot execute those directly (ENOENT). Follow Node's
- * recommended pattern: `cmd.exe /d /s /c` with a single quoted command line
- * and `windowsVerbatimArguments`, without enabling shell interpolation.
+ * On Windows, Cursor/VS Code normally ship as `*.cmd` shims. Resolve the shim
+ * to an absolute path first: invoking a bare command while cwd is a project
+ * can make the shim resolve its own relative Cursor.exe path from the project.
+ * Batch shims run through cmd.exe; native executables run directly.
  */
-export declare function buildOpenerSpawn(opener: OpenerDefinition, workspacePath: string, primaryPath: string, platform?: NodeJS.Platform, comSpec?: string): OpenerSpawnPlan;
+export declare function buildOpenerSpawn(opener: OpenerDefinition, workspacePath: string, primaryPath: string, platform?: NodeJS.Platform, comSpec?: string, resolvedPath?: string): OpenerSpawnPlan;
 export declare function isOpenerAvailable(opener: OpenerDefinition): boolean;
 export declare function launchOpener(opener: OpenerDefinition, workspacePath: string, primaryPath: string): void;

package/dist/core/opener-launch.js

@@ -1,13 +1,36 @@
 import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+export function selectWindowsOpenerPath(output) {
+    return (output
+        .split(/\r?\n/)
+        .map((candidate) => candidate.trim())
+        .find((candidate) => /\.(?:cmd|bat|exe)$/i.test(candidate)) ?? null);
+}
+function resolveWindowsOpenerPath(opener) {
+    for (const suffix of ['.cmd', '.bat', '.exe']) {
+        const result = spawnSync('where.exe', [`${opener.command}${suffix}`], {
+            encoding: 'utf8',
+            shell: false,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        if (result.status === 0) {
+            const executablePath = selectWindowsOpenerPath(result.stdout ?? '');
+            if (executablePath) {
+                return executablePath;
+            }
+        }
+    }
+    return null;
+}
 /**
  * Build spawn argv for launching a workspace-file opener.
  *
- * On Windows, Cursor/VS Code ship as `*.cmd` shims. Node's spawn with
- * `shell: false` cannot execute those directly (ENOENT). Follow Node's
- * recommended pattern: `cmd.exe /d /s /c` with a single quoted command line
- * and `windowsVerbatimArguments`, without enabling shell interpolation.
+ * On Windows, Cursor/VS Code normally ship as `*.cmd` shims. Resolve the shim
+ * to an absolute path first: invoking a bare command while cwd is a project
+ * can make the shim resolve its own relative Cursor.exe path from the project.
+ * Batch shims run through cmd.exe; native executables run directly.
  */
-export function buildOpenerSpawn(opener, workspacePath, primaryPath, platform = process.platform, comSpec = process.env.ComSpec || 'cmd.exe') {
+export function buildOpenerSpawn(opener, workspacePath, primaryPath, platform = process.platform, comSpec = process.env.ComSpec || 'cmd.exe', resolvedPath) {
     const baseOptions = {
         cwd: primaryPath,
         shell: false,
@@ -20,27 +43,48 @@ export function buildOpenerSpawn(opener, workspacePath, primaryPath, platform =
             options: baseOptions,
         };
     }
-    // Escape " for cmd.exe by doubling; wrap each token so spaces are preserved.
-    const quote = (value) => `"${value.replace(/"/g, '""')}"`;
+    if (!resolvedPath) {
+        throw new Error(`Could not resolve '${opener.command}.cmd' or '${opener.command}.exe' on PATH.`);
+    }
+    const executablePath = path.win32.normalize(resolvedPath);
+    const extension = path.win32.extname(executablePath).toLowerCase();
+    const shimOptions = {
+        ...baseOptions,
+        // Cursor's .cmd shim derives Cursor.exe from its own directory.
+        cwd: path.win32.dirname(executablePath),
+    };
+    if (extension === '.exe') {
+        return {
+            command: executablePath,
+            args: [workspacePath],
+            options: shimOptions,
+        };
+    }
+    // cmd.exe's /s removes the outer pair of quotes. Supply that pair explicitly
+    // so the batch-file path and workspace path retain their independent quotes.
+    const commandLine = `""${executablePath.replace(/"/g, '""')}" "${workspacePath.replace(/"/g, '""')}""`;
     return {
         command: comSpec,
-        args: ['/d', '/s', '/c', `${quote(opener.command)} ${quote(workspacePath)}`],
+        args: ['/d', '/s', '/c', commandLine],
         options: {
-            ...baseOptions,
+            ...shimOptions,
             windowsVerbatimArguments: true,
         },
     };
 }
 export function isOpenerAvailable(opener) {
-    // `where.exe` resolves .cmd/.bat shims the same way cmd does.
-    const result = spawnSync(process.platform === 'win32' ? 'where' : 'which', [opener.command], {
+    if (process.platform === 'win32') {
+        return resolveWindowsOpenerPath(opener) !== null;
+    }
+    const result = spawnSync('which', [opener.command], {
         stdio: 'ignore',
         shell: false,
     });
     return result.status === 0;
 }
 export function launchOpener(opener, workspacePath, primaryPath) {
-    const plan = buildOpenerSpawn(opener, workspacePath, primaryPath);
+    const resolvedPath = process.platform === 'win32' ? resolveWindowsOpenerPath(opener) : undefined;
+    const plan = buildOpenerSpawn(opener, workspacePath, primaryPath, process.platform, process.env.ComSpec || 'cmd.exe', resolvedPath ?? undefined);
     const child = spawnSync(plan.command, plan.args, plan.options);
     if (child.error) {
         throw child.error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gordon.gan/specflow",
-  "version": "1.3.1-beta",
+  "version": "1.3.2-beta",
   "type": "module",
   "description": "SpecFlow — unified spec-driven development: OpenSpec planning + Superpowers execution in one CLI and cross-IDE workflow",
   "keywords": [