@ngocsangairvds/vsaf 3.1.5 → 3.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "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/global.js

@@ -1,7 +1,7 @@
 'use strict';
 const path = require('path');
 const fs = require('fs');
-const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, isWindows } = require('./utils');
 
 const PKG_ROOT   = path.join(__dirname, '..');
 const SKILLS_SRC = path.join(PKG_ROOT, '.claude', 'skills');
@@ -14,6 +14,7 @@ async function installGlobal() {
 
   installSkills();
   installBinary('gitnexus', () => exec('npm install -g gitnexus'));
+  setupGitnexusMcp();
 
   console.log('\n\x1b[32m\x1b[1m✓ Global infra ready.\x1b[0m\n');
 }
@@ -60,4 +61,24 @@ function installBinary(name, installFn) {
     : warn(`${name} install failed — run manually`);
 }
 
+function setupGitnexusMcp() {
+  step('GitNexus MCP');
+  if (!hasCommand('claude')) {
+    info('Claude Code CLI not found — skip MCP auto-setup');
+    return;
+  }
+
+  if (isWindows) {
+    info('Configuring GitNexus MCP for Windows...');
+    exec('claude mcp add gitnexus -- cmd /c npx -y gitnexus@latest mcp')
+      ? ok('GitNexus MCP configured (Windows)')
+      : warn('MCP setup failed — run manually: claude mcp add gitnexus -- cmd /c npx -y gitnexus@latest mcp');
+  } else {
+    info('Configuring GitNexus MCP...');
+    exec('claude mcp add gitnexus -- npx -y gitnexus@latest mcp')
+      ? ok('GitNexus MCP configured')
+      : warn('MCP setup failed — run manually: claude mcp add gitnexus -- npx -y gitnexus@latest mcp');
+  }
+}
+
 module.exports = { installGlobal };

package/src/project.js

@@ -141,8 +141,9 @@ function syncLocalBmadSkills() {
 function initGitNexus() {
   step('GitNexus');
   if (!hasCommand('gitnexus')) { warn('gitnexus not found — run: vsaf global'); return; }
+  const analyzeCmd = isWindows ? 'gitnexus analyze --worker-timeout 60' : 'gitnexus analyze';
   info('Indexing repository (gitnexus analyze)...');
-  exec('gitnexus analyze', { cwd: CWD }) ? ok('Repository indexed') : warn('gitnexus analyze failed — run manually');
+  exec(analyzeCmd, { cwd: CWD }) ? ok('Repository indexed') : warn('gitnexus analyze failed — run manually');
 }
 
 module.exports = { installProject };

package/src/workflow.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { ok, info, warn, step, hasCommand, exec } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, isWindows } = require('./utils');
 
 function runIndex() {
   step('Index');
@@ -10,9 +10,15 @@ function runIndex() {
     return false;
   }
 
+  const analyzeCmd = isWindows ? 'gitnexus analyze --worker-timeout 60' : 'gitnexus analyze';
   info('Running gitnexus analyze...');
-  const gitnexusOk = exec('gitnexus analyze');
-  gitnexusOk ? ok('GitNexus index updated') : warn('gitnexus analyze failed — run manually');
+  const gitnexusOk = exec(analyzeCmd);
+  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 };