@ngocsangairvds/vsaf 3.1.6 → 3.1.8

package/bin/vsaf.js

@@ -105,6 +105,9 @@ function printInstallHint() {
   console.log(`\n  Detected OS: \x1b[36m${platform}\x1b[0m\n`);
 
   if (platform === 'windows') {
+    console.log(`  \x1b[1m\x1b[31m[IMPORTANT]\x1b[0m PowerShell blocks npm global scripts by default.`);
+    console.log(`  Run this first (one-time, in PowerShell as Admin):\n`);
+    console.log(`    \x1b[32mSet-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned\x1b[0m\n`);
     console.log(`  \x1b[1m\x1b[33m[Windows]\x1b[0m Recommended installation methods:\n`);
     console.log(`  \x1b[1mOption 1: PowerShell (Admin)\x1b[0m`);
     console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.1.6",
+  "version": "3.1.8",
   "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,7 +1,6 @@
 'use strict';
 
 const { ok, info, warn, step, hasCommand, exec, isWindows } = require('./utils');
-const { execSync } = require('child_process');
 
 function runIndex() {
   step('Index');
@@ -11,8 +10,9 @@ function runIndex() {
     return false;
   }
 
+  const analyzeCmd = isWindows ? 'gitnexus analyze --worker-timeout 60' : 'gitnexus analyze';
   info('Running gitnexus analyze...');
-  const gitnexusOk = exec('gitnexus analyze');
+  const gitnexusOk = exec(analyzeCmd);
   if (gitnexusOk) {
     ok('GitNexus index updated');
   } else {
@@ -73,15 +73,20 @@ function runServe() {
 
 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"');
+    warn('Windows troubleshooting:');
+    warn('');
+    warn('  [Most common] PowerShell blocks npm global scripts by default.');
+    warn('  Fix: run this command once in PowerShell (Admin):');
+    warn('');
+    warn('    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned');
+    warn('');
+    warn('  Then retry:  vsaf index');
+    warn('');
+    info('  Other options:');
+    info('    - Use CMD instead of PowerShell (CMD does not block scripts)');
+    info('    - Use Git Bash:  bash -c "gitnexus analyze"');
+    info('    - Run via npx:   npx gitnexus analyze');
+    info('    - Use WSL:       wsl -- bash -c "cd $(wslpath -a .) && gitnexus analyze"');
   } else {
     info('Try running manually:  gitnexus analyze --verbose');
   }