@ngocsangairvds/vsaf 3.1.13 → 3.1.14

package/assets/templates/CLAUDE.md

@@ -22,7 +22,7 @@ VSAF is a meta-framework for AI-driven SDLC — not an application. It has no so
 | Code Intelligence | GitNexus (MCP) | Impact analysis, call graph, blast radius |
 | Implementation | Superpowers, Claude Code | Brainstorm, TDD execution, code review |
 
-Key directories: `.claude/` (settings + skills), `_bmad/` (BMAD workspace), `.gitnexus/` (knowledge graph index).
+Key directories: `.claude/` (settings + skills), `.vsaf/_bmad/` (BMAD workspace), `.vsaf/docs/` (artifacts), `.gitnexus/` (knowledge graph index).
 
 ---
 

package/bin/vsaf.js

@@ -104,36 +104,12 @@ 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`);
-    console.log(`  \x1b[1mOption 2: Setup script (CMD)\x1b[0m`);
-    console.log(`    \x1b[32mscripts\\setup-vsaf.bat\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`);
-  }
+  const label = platform === 'macos' ? 'macOS' : 'Linux';
+  console.log(`  \x1b[1m\x1b[33m[${label}]\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`);
 
   console.log(`  After installation, you can use:\n`);
   console.log(`    \x1b[36mvsaf status\x1b[0m    # check installation`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.1.13",
+  "version": "3.1.14",
   "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": {
@@ -15,8 +15,7 @@
   "files": [
     "bin/",
     "src/",
-    ".claude/skills/",
-    "_bmad/",
+    "tools/",
     "assets/"
   ],
   "license": "MIT"

package/src/global.js

@@ -1,10 +1,10 @@
 'use strict';
 const path = require('path');
 const fs = require('fs');
-const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, isWindows } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME } = require('./utils');
 
 const PKG_ROOT   = path.join(__dirname, '..');
-const SKILLS_SRC = path.join(PKG_ROOT, '.claude', 'skills');
+const SKILLS_SRC = path.join(PKG_ROOT, 'tools', 'skills');
 const SKILLS_DST = path.join(CLAUDE_HOME, 'skills');
 
 async function installGlobal() {
@@ -14,7 +14,6 @@ async function installGlobal() {
 
   installSkills();
   installBinary('gitnexus', () => exec('npm install -g gitnexus'));
-  if (isWindows) ensureLadybugDbWindows();
   setupGitnexusMcp();
 
   console.log('\n\x1b[32m\x1b[1m✓ Global infra ready.\x1b[0m\n');
@@ -62,33 +61,6 @@ function installBinary(name, installFn) {
     : warn(`${name} install failed — run manually`);
 }
 
-function ensureLadybugDbWindows() {
-  step('LadybugDB native binding (Windows)');
-
-  try {
-    const npmRoot = require('child_process')
-      .execSync('npm root -g', { encoding: 'utf8', shell: true }).trim();
-    const nativePath = path.join(npmRoot, 'gitnexus', 'node_modules', '@ladybugdb', 'core', 'lbugjs.node');
-    if (fs.existsSync(nativePath)) {
-      ok('LadybugDB native binding present (lbugjs.node)');
-      return;
-    }
-    warn('LadybugDB native binding missing — installing @ladybugdb/core-win32-x64...');
-    const gitnexusDir = path.join(npmRoot, 'gitnexus');
-    if (exec('npm install @ladybugdb/core-win32-x64 --no-save', { cwd: gitnexusDir })) {
-      ok('LadybugDB native binding installed');
-    } else {
-      warn('Could not install LadybugDB binding. Run manually:');
-      warn('  cd "' + gitnexusDir + '"');
-      warn('  npm install @ladybugdb/core-win32-x64 --no-save');
-    }
-  } catch {
-    warn('Could not verify LadybugDB binding — if gitnexus analyze fails at 60%, run:');
-    info('  npm root -g   (find global node_modules path)');
-    info('  cd <path>\\gitnexus && npm install @ladybugdb/core-win32-x64 --no-save');
-  }
-}
-
 function setupGitnexusMcp() {
   step('GitNexus MCP');
   if (!hasCommand('claude')) {
@@ -96,17 +68,10 @@ function setupGitnexusMcp() {
     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');
-  }
+  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

@@ -1,12 +1,12 @@
 'use strict';
 const path = require('path');
 const fs   = require('fs');
-const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, isWindows } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile } = require('./utils');
 
 const PKG_ROOT  = path.join(__dirname, '..');
 const TEMPLATES = path.join(PKG_ROOT, 'assets', 'templates');
-const SKILLS_SRC = path.join(PKG_ROOT, '.claude', 'skills');
-const BMAD_SRC = path.join(PKG_ROOT, '_bmad');
+const SKILLS_SRC = path.join(PKG_ROOT, 'tools', 'skills');
+const BMAD_SRC = path.join(PKG_ROOT, 'tools', 'bmad');
 const CWD       = process.cwd();
 
 async function installProject() {
@@ -49,7 +49,7 @@ function scaffoldFiles() {
       ok(`${dst} — already exists, skipped`);
     } else {
       copyFile(src, dstAbs);
-      if (chmod && !isWindows) fs.chmodSync(dstAbs, chmod);
+      if (chmod) fs.chmodSync(dstAbs, chmod);
       ok(`${dst} — created`);
     }
   }
@@ -60,7 +60,7 @@ function scaffoldFiles() {
 function scaffoldBmadWorkspace() {
   step('BMAD workspace');
 
-  const bmadDst = path.join(CWD, '_bmad');
+  const bmadDst = path.join(CWD, '.vsaf', '_bmad');
   if (!fs.existsSync(BMAD_SRC)) {
     warn('Packaged _bmad not found — skipping BMAD workspace scaffold');
   } else if (fs.existsSync(bmadDst)) {
@@ -71,11 +71,11 @@ function scaffoldBmadWorkspace() {
   }
 
   const outputDirs = [
-    path.join(CWD, 'docs', 'project'),
-    path.join(CWD, 'docs', 'project', 'srs'),
-    path.join(CWD, 'docs', 'project', 'testcases'),
-    path.join(CWD, 'docs', 'project', 'planning-artifacts'),
-    path.join(CWD, 'docs', 'project', 'implementation-artifacts'),
+    path.join(CWD, '.vsaf', 'docs'),
+    path.join(CWD, '.vsaf', 'docs', 'srs'),
+    path.join(CWD, '.vsaf', 'docs', 'testcases'),
+    path.join(CWD, '.vsaf', 'docs', 'planning-artifacts'),
+    path.join(CWD, '.vsaf', 'docs', 'implementation-artifacts'),
   ];
 
   let created = 0;
@@ -141,7 +141,7 @@ function syncLocalBmadSkills() {
 function initGitNexus() {
   step('GitNexus');
   if (!hasCommand('gitnexus')) { warn('gitnexus not found — run: vsaf global'); return; }
-  const analyzeCmd = 'gitnexus analyze';
+  const analyzeCmd = 'gitnexus analyze --skip-git';
   info('Indexing repository (gitnexus analyze)...');
   exec(analyzeCmd, { cwd: CWD }) ? ok('Repository indexed') : warn('gitnexus analyze failed — run manually');
 }

package/src/status.js

@@ -15,8 +15,8 @@ async function showStatus() {
   console.log('\n\x1b[1mProject  (current repo)\x1b[0m');
   checkPath('.claude/settings.json', 'Project settings');
   checkPath('CLAUDE.md',             'Workflow rules');
-  checkPath('_bmad',                 'BMAD workspace');
-  checkPath('docs/project',          'Project artifact folder');
+  checkPath('.vsaf/_bmad',           'BMAD workspace');
+  checkPath('.vsaf/docs',            'Project artifact folder');
   checkProjectSkillDir('.claude/skills', 'Project BMAD skills (.claude)');
   checkProjectSkillDir('.codex/skills',  'Project BMAD skills (.codex)');
   checkPath('.gitnexus',             'GitNexus index');

package/src/utils.js

@@ -11,22 +11,14 @@ 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) {
-  // Try --version first (works on most CLIs across all platforms)
-  const versionCheck = spawnSync(cmd, ['--version'], { stdio: 'ignore', shell: isWindows });
+  // Try --version first (works on most CLIs)
+  const versionCheck = spawnSync(cmd, ['--version'], { stdio: 'ignore', shell: false });
   if (versionCheck.status === 0) return true;
 
   // 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;
-  }
+  const pathCheck = spawnSync('sh', ['-c', `command -v "${cmd}"`], { stdio: 'ignore', shell: false });
+  return pathCheck.status === 0;
 }
 
 function exec(cmd, opts = {}) {
@@ -62,9 +54,8 @@ function hasGitCommits() {
 }
 
 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, hasGitCommits };
+module.exports = { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, getPlatform, hasGitCommits };

package/src/workflow.js

@@ -2,7 +2,7 @@
 
 const path = require('path');
 const fs = require('fs');
-const { ok, info, warn, step, hasCommand, exec, isWindows, hasGitCommits } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, hasGitCommits } = require('./utils');
 
 function preflightCheck() {
   // Check: is this a git repo?
@@ -22,24 +22,6 @@ function preflightCheck() {
     return false;
   }
 
-  // Check (Windows): is LadybugDB native binding present?
-  if (isWindows) {
-    try {
-      const npmRoot = require('child_process')
-        .execSync('npm root -g', { encoding: 'utf8', shell: true }).trim();
-      const lbugNode = path.join(npmRoot, 'gitnexus', 'node_modules', '@ladybugdb', 'core', 'lbugjs.node');
-      if (!fs.existsSync(lbugNode)) {
-        warn('LadybugDB native binding missing (lbugjs.node).');
-        warn('gitnexus analyze will fail at 60% without it.');
-        info('Fix: run this in CMD:');
-        info('  cd "' + path.join(npmRoot, 'gitnexus') + '"');
-        info('  npm install @ladybugdb/core-win32-x64 --no-save');
-        info('Then retry: vsaf index');
-        return false;
-      }
-    } catch { /* can't check, proceed anyway */ }
-  }
-
   return true;
 }
 
@@ -116,23 +98,7 @@ function runServe() {
 }
 
 function printAnalyzeHint() {
-  if (isWindows) {
-    warn('Windows troubleshooting:');
-    warn('');
-    warn('  [Most common] PowerShell blocks npm global scripts (.ps1).');
-    warn('  Use CMD instead of PowerShell, or prefix with cmd /c:');
-    warn('');
-    warn('    cmd /c gitnexus analyze');
-    warn('');
-    info('  Other options:');
-    info('    - Run via npx:   npx gitnexus analyze');
-    info('    - Use Git Bash:  bash -c "gitnexus analyze"');
-    info('    - Use WSL:       wsl -- bash -c "cd $(wslpath -a .) && gitnexus analyze"');
-    info('    - Or fix PowerShell permanently (Admin):');
-    info('        Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned');
-  } else {
-    info('Try running manually:  gitnexus analyze --verbose');
-  }
+  info('Try running manually:  gitnexus analyze --verbose');
 }
 
 module.exports = { runIndex, runReview, runClean, runServe };

package/.claude/skills/graphify/.graphify_version

@@ -1 +0,0 @@
-0.4.14

package/.claude/skills/graphify/SKILL.md

@@ -1,4 +0,0 @@
----
-name: graphify
-description: DEPRECATED — skill has been removed from the project. Do not use.
----