@ngocsangairvds/vsaf 3.1.19 → 3.1.21

package/assets/templates/.codex/instructions.md

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

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), `.vsaf/_bmad/` (BMAD workspace), `.vsaf/docs/` (artifacts), `.vsaf/_gitnexus/` (knowledge graph index, `.gitnexus/` is a symlink here).
+Key directories: `.claude/` (settings + skills), `.vsaf/_bmad/` (BMAD workspace), `.vsaf/docs/` (artifacts), `.gitnexus/` (knowledge graph index).
 
 ---
 

package/bin/vsaf.js

@@ -11,7 +11,8 @@ USAGE
   vsaf global     Install global infra only  (skills, binaries)
   vsaf project    Scaffold project files only (assumes global done)
   vsaf status     Show installation status
-  vsaf index      Re-index codebase (GitNexus)
+  vsaf index               Re-index codebase (discovers git root)
+  vsaf index --skip-git    Re-index from CWD (skip git root discovery)
   vsaf serve      Start GitNexus web UI server
   vsaf review     Run 2-layer review flow
   vsaf clean      Clean GitNexus index
@@ -66,7 +67,8 @@ async function main() {
     }
     case 'index': {
       const { runIndex } = require('../src/workflow');
-      runAndExit(runIndex(), 'Index');
+      const skipGit = process.argv.includes('--skip-git');
+      runAndExit(runIndex({ skipGit }), 'Index');
       break;
     }
     case 'serve': {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.1.19",
-  "description": "add method for codex",
+  "version": "3.1.21",
+  "description": "fix gitnexus with windows",
   "keywords": ["claude", "claude-code", "ai", "sdlc", "framework", "bmad", "gitnexus", "superpowers"],
   "bin": {
     "vsaf": "./bin/vsaf.js"

package/src/global.js

@@ -64,9 +64,9 @@ function setupGitnexusMcp() {
   }
 
   info('Configuring GitNexus MCP...');
-  exec('claude mcp add gitnexus -- npx -y gitnexus@latest mcp')
+  exec('claude mcp add gitnexus -- npx -y gitnexus@rc mcp')
     ? ok('GitNexus MCP configured')
-    : warn('MCP setup failed — run manually: claude mcp add gitnexus -- npx -y gitnexus@latest mcp');
+    : warn('MCP setup failed — run manually: claude mcp add gitnexus -- npx -y gitnexus@rc mcp');
 }
 
 module.exports = { installGlobal };

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, ensureGitnexusSymlink } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, cleanStaleWal } = require('./utils');
 
 const PKG_ROOT  = path.join(__dirname, '..');
 const TEMPLATES = path.join(PKG_ROOT, 'assets', 'templates');
@@ -160,7 +160,7 @@ function syncLocalBmadSkills() {
 function initGitNexus() {
   step('GitNexus');
   if (!hasCommand('gitnexus')) { warn('gitnexus not found — run: vsaf global'); return; }
-  ensureGitnexusSymlink();
+  cleanStaleWal();
   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

@@ -22,7 +22,7 @@ async function showStatus() {
   checkPath('.vsaf/docs',            'Project artifact folder');
   checkProjectSkillDir('.claude/skills', 'Project BMAD skills (.claude)');
   checkProjectSkillDir('.codex/skills',  'Project BMAD skills (.codex)');
-  checkPath('.vsaf/_gitnexus',       'GitNexus index');
+  checkPath('.gitnexus',              'GitNexus index');
   console.log('');
 }
 

package/src/utils.js

@@ -55,27 +55,20 @@ function hasGitCommits() {
 }
 
 /**
- * Ensures .gitnexus is a symlink → .vsaf/_gitnexus (actual data dir).
- * Gitnexus hardcodes .gitnexus/ so we keep it at the root as a symlink
- * while the real data lives inside .vsaf/.
+ * Removes stale DuckDB WAL files from the .gitnexus directory.
+ * WAL files left behind by interrupted gitnexus analyze runs can become
+ * corrupted, causing DuckDB to crash with UNREACHABLE_CODE on next open.
  */
-function ensureGitnexusSymlink() {
-  const cwd     = process.cwd();
-  const actual   = path.join(cwd, '.vsaf', '_gitnexus');
-  const linkPath = path.join(cwd, '.gitnexus');
+function cleanStaleWal() {
+  const dir = path.join(process.cwd(), '.gitnexus');
+  if (!fs.existsSync(dir)) return;
 
-  fs.mkdirSync(actual, { recursive: true });
-
-  try {
-    const stat = fs.lstatSync(linkPath);
-    if (stat.isSymbolicLink()) return; // already a symlink — nothing to do
-    // Real directory left behind (e.g. gitnexus recreated it after clean)
-    fs.rmSync(linkPath, { recursive: true, force: true });
-  } catch {
-    // linkPath does not exist — will create below
+  for (const file of fs.readdirSync(dir)) {
+    if (file.endsWith('.wal')) {
+      fs.unlinkSync(path.join(dir, file));
+      warn(`Removed stale WAL: .gitnexus/${file}`);
+    }
   }
-
-  fs.symlinkSync(actual, linkPath);
 }
 
 function getPlatform() {
@@ -83,4 +76,4 @@ function getPlatform() {
   return 'linux';
 }
 
-module.exports = { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, CODEX_HOME, getPlatform, hasGitCommits, ensureGitnexusSymlink };
+module.exports = { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, CODEX_HOME, getPlatform, hasGitCommits, cleanStaleWal };

package/src/workflow.js

@@ -2,7 +2,7 @@
 
 const path = require('path');
 const fs = require('fs');
-const { ok, info, warn, step, hasCommand, exec, hasGitCommits, ensureGitnexusSymlink } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, hasGitCommits, cleanStaleWal } = require('./utils');
 
 function preflightCheck() {
   // Check: is this a git repo?
@@ -25,7 +25,7 @@ function preflightCheck() {
   return true;
 }
 
-function runIndex() {
+function runIndex({ skipGit = false } = {}) {
   step('Index');
 
   if (!hasCommand('gitnexus')) {
@@ -37,9 +37,10 @@ function runIndex() {
     return false;
   }
 
-  ensureGitnexusSymlink();
-  info('Running gitnexus analyze...');
-  const gitnexusOk = exec('gitnexus analyze --skip-git');
+  cleanStaleWal();
+  const cmd = skipGit ? 'gitnexus analyze --skip-git' : 'gitnexus analyze';
+  info(`Running ${cmd}...`);
+  const gitnexusOk = exec(cmd);
   if (gitnexusOk) {
     ok('GitNexus index updated');
   } else {
@@ -80,11 +81,6 @@ function runClean() {
 
   info('Running gitnexus clean...');
   const cleanOk = exec('gitnexus clean --force');
-  // gitnexus clean deletes the .gitnexus symlink — clear actual data dir too
-  const actualDir = path.join(process.cwd(), '.vsaf', '_gitnexus');
-  if (fs.existsSync(actualDir)) fs.rmSync(actualDir, { recursive: true, force: true });
-  // Restore symlink pointing at the now-empty dir
-  ensureGitnexusSymlink();
   cleanOk ? ok('GitNexus index cleaned') : warn('gitnexus clean failed — run manually');
   return cleanOk;
 }