@ngocsangairvds/vsaf 3.1.18 → 3.1.20

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/package.json

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

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?
@@ -37,7 +37,7 @@ function runIndex() {
     return false;
   }
 
-  ensureGitnexusSymlink();
+  cleanStaleWal();
   info('Running gitnexus analyze...');
   const gitnexusOk = exec('gitnexus analyze --skip-git');
   if (gitnexusOk) {
@@ -80,11 +80,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;
 }

package/tools/skills/vsaf-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vsaf-plan
-description: Plan a new feature/task. Use when receiving a requirement that needs scope analysis, impact assessment, and approach strategy. Dual brainstorm (Superpowers + BMAD). Example: /vsaf-plan create user management module
+description: "Plan a new feature/task. Use when receiving a requirement that needs scope analysis, impact assessment, and approach strategy. Dual brainstorm (Superpowers + BMAD). Example: /vsaf-plan create user management module"
 ---
 
 # VSAF Plan