@ngocsangairvds/vsaf 3.1.3 → 3.1.5

package/bin/vsaf.js

@@ -95,24 +95,50 @@ async function main() {
 
 function printInstallHint() {
   const pkg = '@ngocsangairvds/vsaf';
+  const { getPlatform } = require('../src/utils');
+  const platform = getPlatform();
+
   console.log('\n\x1b[1m╔══════════════════════════════════════════════════════════╗\x1b[0m');
-  console.log(  '\x1b[1m║   🚀  Cài lệnh  vsaf  để dùng mọi lúc                   ║\x1b[0m');
+  console.log(  '\x1b[1m║   Install vsaf globally for easy access                  ║\x1b[0m');
   console.log(  '\x1b[1m╚══════════════════════════════════════════════════════════╝\x1b[0m');
-  console.log(`
-  Lệnh \x1b[36mvsaf\x1b[0m chưa được cài vào PATH vì bạn vừa chạy qua \x1b[33mnpx\x1b[0m.
-  Để dùng \x1b[36mvsaf\x1b[0m trực tiếp từ terminal, hãy cài global một lần:
-
-  \x1b[1m\x1b[32m  npm install -g ${pkg}\x1b[0m
 
-  Sau đó bạn có thể dùng:
+  console.log(`\n  Detected OS: \x1b[36m${platform}\x1b[0m\n`);
 
-    \x1b[36mvsaf status\x1b[0m    # kiểm tra cài đặt
-    \x1b[36mvsaf index\x1b[0m     # index codebase (GitNexus)
-    \x1b[36mvsaf review\x1b[0m    # chạy 2-layer review
+  if (platform === 'windows') {
+    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`);
+    console.log(`  \x1b[1mOption 2: PowerShell setup script\x1b[0m`);
+    console.log(`    \x1b[32mSet-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass\x1b[0m`);
+    console.log(`    \x1b[32m.\\scripts\\setup-vsaf.ps1\x1b[0m\n`);
+    console.log(`  \x1b[1mOption 3: WSL (Windows Subsystem for Linux)\x1b[0m`);
+    console.log(`    \x1b[90mRun inside WSL terminal for full Linux compatibility:\x1b[0m`);
+    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m`);
+    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
+    console.log(`  \x1b[1mOption 4: Git Bash\x1b[0m`);
+    console.log(`    \x1b[90mIf you have Git for Windows installed:\x1b[0m`);
+    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m`);
+    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
+  } else if (platform === 'macos') {
+    console.log(`  \x1b[1m\x1b[33m[macOS]\x1b[0m Recommended installation methods:\n`);
+    console.log(`  \x1b[1mOption 1: npm global install\x1b[0m`);
+    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m\n`);
+    console.log(`  \x1b[1mOption 2: Setup script\x1b[0m`);
+    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
+  } else {
+    console.log(`  \x1b[1m\x1b[33m[Linux]\x1b[0m Recommended installation methods:\n`);
+    console.log(`  \x1b[1mOption 1: npm global install\x1b[0m`);
+    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m\n`);
+    console.log(`  \x1b[1mOption 2: Setup script\x1b[0m`);
+    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
+  }
 
-  \x1b[90mHoặc tiếp tục dùng npx nếu không muốn cài global:\x1b[0m
-  \x1b[90m  npx ${pkg} <command>\x1b[0m
-`);
+  console.log(`  After installation, you can use:\n`);
+  console.log(`    \x1b[36mvsaf status\x1b[0m    # check installation`);
+  console.log(`    \x1b[36mvsaf index\x1b[0m     # index codebase (GitNexus)`);
+  console.log(`    \x1b[36mvsaf review\x1b[0m    # run 2-layer review\n`);
+  console.log(`  \x1b[90mOr continue using npx without global install:\x1b[0m`);
+  console.log(`  \x1b[90m  npx ${pkg} <command>\x1b[0m\n`);
 }
 
 main().catch(err => {

package/package.json

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

@@ -1,7 +1,7 @@
 'use strict';
 const path = require('path');
 const fs   = require('fs');
-const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, isWindows } = require('./utils');
 
 const PKG_ROOT  = path.join(__dirname, '..');
 const TEMPLATES = path.join(PKG_ROOT, 'assets', 'templates');
@@ -49,7 +49,7 @@ function scaffoldFiles() {
       ok(`${dst} — already exists, skipped`);
     } else {
       copyFile(src, dstAbs);
-      if (chmod) fs.chmodSync(dstAbs, chmod);
+      if (chmod && !isWindows) fs.chmodSync(dstAbs, chmod);
       ok(`${dst} — created`);
     }
   }

package/src/utils.js

@@ -11,13 +11,22 @@ const info = (msg) => console.log(`  \x1b[36m→\x1b[0m ${msg}`);
 const warn = (msg) => console.log(`  \x1b[33m!\x1b[0m ${msg}`);
 const step = (msg) => console.log(`\n\x1b[1m${msg}\x1b[0m`);
 
+const isWindows = process.platform === 'win32';
+
 function hasCommand(cmd) {
-  const versionCheck = spawnSync(cmd, ['--version'], { stdio: 'ignore', shell: false });
+  // 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.
-  const pathCheck = spawnSync('sh', ['-c', `command -v "${cmd}"`], { stdio: 'ignore', shell: false });
-  return pathCheck.status === 0;
+  // Fallback: check if command exists on PATH
+  if (isWindows) {
+    // '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 });
+    return pathCheck.status === 0;
+  }
 }
 
 function exec(cmd, opts = {}) {
@@ -43,4 +52,10 @@ function copyFile(src, dst) {
   fs.copyFileSync(src, dst);
 }
 
-module.exports = { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME };
+function getPlatform() {
+  if (process.platform === 'win32') return 'windows';
+  if (process.platform === 'darwin') return 'macos';
+  return 'linux';
+}
+
+module.exports = { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, isWindows, getPlatform };