@ngocsangairvds/vsaf 3.1.4 → 3.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "description": "VSAF — Agentic AI SDLC Framework. 3 integrated tools: BMAD, GitNexus, Superpowers. 2-layer review.",
   "keywords": ["claude", "claude-code", "ai", "sdlc", "framework", "bmad", "gitnexus", "superpowers"],
   "bin": {

package/src/utils.js

@@ -14,12 +14,14 @@ const step = (msg) => console.log(`\n\x1b[1m${msg}\x1b[0m`);
 const isWindows = process.platform === 'win32';
 
 function hasCommand(cmd) {
+  // Try --version first (works on most CLIs across all platforms)
   const versionCheck = spawnSync(cmd, ['--version'], { stdio: 'ignore', shell: isWindows });
   if (versionCheck.status === 0) return true;
 
-  // Some CLIs don't support --version but are still available on PATH.
+  // Fallback: check if command exists on PATH
   if (isWindows) {
-    const whereCheck = spawnSync('where', [cmd], { stdio: 'ignore', shell: true });
+    // 'where' is a native Windows command; run as a single string via shell
+    const whereCheck = spawnSync(`where "${cmd}"`, { stdio: 'ignore', shell: true });
     return whereCheck.status === 0;
   } else {
     const pathCheck = spawnSync('sh', ['-c', `command -v "${cmd}"`], { stdio: 'ignore', shell: false });

package/src/workflow.js

@@ -1,6 +1,7 @@
 'use strict';
 
-const { ok, info, warn, step, hasCommand, exec } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, isWindows } = require('./utils');
+const { execSync } = require('child_process');
 
 function runIndex() {
   step('Index');
@@ -12,7 +13,12 @@ function runIndex() {
 
   info('Running gitnexus analyze...');
   const gitnexusOk = exec('gitnexus analyze');
-  gitnexusOk ? ok('GitNexus index updated') : warn('gitnexus analyze failed — run manually');
+  if (gitnexusOk) {
+    ok('GitNexus index updated');
+  } else {
+    warn('gitnexus analyze failed — run manually');
+    printAnalyzeHint();
+  }
 
   return gitnexusOk;
 }
@@ -65,4 +71,20 @@ function runServe() {
   return exec('gitnexus serve');
 }
 
+function printAnalyzeHint() {
+  if (isWindows) {
+    info('Windows troubleshooting:');
+    info('  1. Run with verbose output:  gitnexus analyze --verbose');
+    info('  2. LadybugDB may have file-locking issues on Windows.');
+    info('     Try closing other terminals/editors that access this repo.');
+    info('  3. Clean and retry:');
+    info('       gitnexus clean');
+    info('       gitnexus analyze');
+    info('  4. If LadybugDB keeps failing, try running inside WSL:');
+    info('       wsl -- bash -c "cd $(wslpath -a .) && gitnexus analyze"');
+  } else {
+    info('Try running manually:  gitnexus analyze --verbose');
+  }
+}
+
 module.exports = { runIndex, runReview, runClean, runServe };