@ngocsangairvds/vsaf 3.2.5 → 3.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.2.5",
+  "version": "3.2.7",
   "description": "improve confluence format",
   "keywords": ["claude", "claude-code", "ai", "sdlc", "framework", "bmad", "gitnexus", "superpowers"],
   "bin": {

package/src/global.js

@@ -131,7 +131,7 @@ async function setupVdsScriptsMcp() {
     ok('Đã tìm thấy file cấu hình ~/.vds/.env');
   }
 
-  const cmd = `claude mcp add vds-orchestrator -- uv run --project "${mcpDir}" vds-mcp-server`;
+  const cmd = `claude mcp add vds-orchestrator -e VDS_SCRIPTS_ROOT="${destDir}" -- uv run --project "${mcpDir}" vds-mcp-server`;
 
   if (exec(cmd)) {
     ok('VDS Scripts MCP đã được cấu hình thành công');

package/src/project.js

@@ -5,9 +5,10 @@ const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, cleanStaleWal
 
 const PKG_ROOT  = path.join(__dirname, '..');
 const TEMPLATES = path.join(PKG_ROOT, 'assets', 'templates');
-const SKILLS_SRC = path.join(PKG_ROOT, 'tools', 'skills');
-const BMAD_SRC = path.join(PKG_ROOT, 'tools', 'bmad');
-const CWD       = process.cwd();
+const SKILLS_SRC   = path.join(PKG_ROOT, 'tools', 'skills');
+const BMAD_SRC     = path.join(PKG_ROOT, 'tools', 'bmad');
+const VDS_SCRIPTS_SRC = path.join(PKG_ROOT, 'tools', 'vds-scripts');
+const CWD          = process.cwd();
 
 async function installProject() {
   console.log('\n\x1b[1m╔══════════════════════════════════════════╗\x1b[0m');
@@ -17,6 +18,7 @@ async function installProject() {
   scaffoldFiles();
   scaffoldBmadWorkspace();
   syncLocalBmadSkills();
+  syncVdsScripts();
   initGitNexus();
 
   console.log('\n\x1b[32m\x1b[1m✓ Project ready.\x1b[0m');
@@ -157,6 +159,19 @@ function syncLocalBmadSkills() {
   ok(`${installed} BMAD skill(s) installed/updated`);
 }
 
+function syncVdsScripts() {
+  step('VDS Scripts → .claude/vds-scripts/');
+
+  if (!fs.existsSync(VDS_SCRIPTS_SRC)) {
+    warn('vds-scripts not found in package — skipping');
+    return;
+  }
+
+  const dst = path.join(CWD, '.claude', 'vds-scripts');
+  copyDir(VDS_SCRIPTS_SRC, dst);
+  ok('vds-scripts — synced to .claude/vds-scripts/');
+}
+
 function initGitNexus() {
   step('GitNexus');
   if (!hasCommand('gitnexus')) { warn('gitnexus not found — run: vsaf global'); return; }

package/src/status.js

@@ -22,8 +22,8 @@ async function showStatus() {
   checkPath('AGENTS.md',                'Workflow rules (Codex/Gemini)');
   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)');
+  checkProjectSkillDir('.claude/skills', 'Project skills (.claude)');
+  checkProjectSkillDir('.codex/skills',  'Project skills (.codex)');
   checkPath('.gitnexus',              'GitNexus index');
   console.log('');
 }
@@ -65,9 +65,12 @@ function checkProjectSkillDir(rel, label) {
     return;
   }
 
-  const count = fs.readdirSync(dir).filter((name) => name.startsWith('bmad-')).length;
+  const entries = fs.readdirSync(dir);
+  const count = entries.length;
+  const bmad = entries.filter((n) => n.startsWith('bmad-')).length;
+  const vds  = entries.filter((n) => n.startsWith('vds-')).length;
   if (count > 0) {
-    console.log(`  \x1b[32m✓\x1b[0m ${label} (${count})`);
+    console.log(`  \x1b[32m✓\x1b[0m ${label} (${count}: ${bmad} bmad, ${vds} vds)`);
   } else {
     console.log(`  \x1b[31m✗\x1b[0m ${label} (0)`);
   }

package/tools/vds-scripts/AGENTS.md

@@ -2,7 +2,7 @@
 
 Audit orchestrator: **8439 tests**, spec v4.93.0 (Phase 152 Planned)
 
-Operational rules for `WHO-project/vds-scripts`.
+Operational rules for `~/.claude/vds-scripts`.
 
 ## Scope
 

package/tools/vds-scripts/scripts/BRD-Validation-README.md

@@ -121,7 +121,7 @@ newman run "BRD-Validation-API.postman_collection.json" \
 
 ```bash
 # Run the BRD validation script directly
-cd WHO-project/vds-scripts/scripts
+cd ~/.claude/vds-scripts/scripts
 python3 validate_brd_coverage.py
 
 # View generated report
@@ -196,7 +196,7 @@ cat brd_coverage_report.json | jq '.'
 2. **Script Path Issues**:
    ```bash
    # Verify script exists
-   ls -la WHO-project/vds-scripts/scripts/validate_brd_coverage.py
+   ls -la ~/.claude/vds-scripts/scripts/validate_brd_coverage.py
    ```
 
 3. **Newman Installation**:
@@ -229,7 +229,7 @@ jobs:
         run: npm install -g newman
       - name: Run BRD Validation Tests
         run: |
-          cd WHO-project/vds-scripts/scripts
+          cd ~/.claude/vds-scripts/scripts
           newman run "BRD-Validation-API.postman_collection.json" \
             -e "brd-validation-environment.json" \
             --reporters cli,junit \
@@ -253,7 +253,7 @@ pipeline {
             steps {
                 script {
                     sh '''
-                        cd WHO-project/vds-scripts/scripts
+                        cd ~/.claude/vds-scripts/scripts
                         newman run "BRD-Validation-API.postman_collection.json" \
                           -e "brd-validation-environment.json" \
                           --reporters cli,json \
@@ -289,7 +289,7 @@ pipeline {
 - **Target State Documentation Update**: `.kiro/specs/target-state-documentation-update/`
 - **BRD Coverage Report**: `projects/INSURANCE/analysis/target-state/BRD_COVERAGE_REPORT.md`
 - **Service Specifications**: `projects/INSURANCE/analysis/target-state/service-specifications/`
-- **VDS Scripts Documentation**: `WHO-project/vds-scripts/docs/README.md`
+- **VDS Scripts Documentation**: `~/.claude/vds-scripts/docs/README.md`
 
 ## Support
 

package/tools/vds-scripts/scripts/README.md

@@ -34,7 +34,7 @@ scripts/vds_sh_helpers.sh    # runtime helpers: bind --directory and resolve pac
 
 ```bash
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=WHO-project/vds-scripts/scripts/vds_sh_helpers.sh
+# shellcheck source=~/.claude/vds-scripts/scripts/vds_sh_helpers.sh
 source "$SCRIPT_DIR/../vds_sh_helpers.sh"   # adjust depth as needed
 ```
 
@@ -49,7 +49,7 @@ disk — not where the calling script lives.
 vds_uv_run_package vds_cli vds-cli doctor
 
 # WRONG — path-coupled, breaks in worktrees and alternate checkouts
-uv run --project WHO-project/vds-scripts/vds_cli vds-cli schema convert ...
+uv run --project ~/.claude/vds-scripts/vds_cli vds-cli schema convert ...
 ```
 
 ### Syncing environments
@@ -84,7 +84,7 @@ The helper accepts either:
 - a workspace member directory name such as `vds_cli`, `audit_orchestrator`, or `markdown_orchestrator`, or
 - an explicit uv project/package name such as `vds-cli` or `vds-spec-orchestrator`
 
-For maintained scripts, prefer passing the directory/member name to the helper and let it resolve the uv project name from the member `pyproject.toml`. Do not pass filesystem paths like `WHO-project/vds-scripts/vds_cli`.
+For maintained scripts, prefer passing the directory/member name to the helper and let it resolve the uv project name from the member `pyproject.toml`. Do not pass filesystem paths like `~/.claude/vds-scripts/vds_cli`.
 
 ---
 

package/tools/vds-scripts/scripts/target-state-automation/validate_markdown.sh

@@ -17,11 +17,11 @@ set -euo pipefail
 # See scripts/vds_sh_helpers.sh for the canonical UV invocation helpers.
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=WHO-project/vds-scripts/scripts/target-state-automation/docs_root.sh
+# shellcheck source=~/.claude/vds-scripts/scripts/target-state-automation/docs_root.sh
 source "$SCRIPT_DIR/docs_root.sh"
 
 ROOT="$(resolve_repo_root)"
-VDS_SCRIPTS="$ROOT/WHO-project/vds-scripts"
+VDS_SCRIPTS="$ROOT/~/.claude/vds-scripts"
 DOCS_ROOT="$(resolve_insurance_docs_root "$ROOT")"
 TARGET_STATE="$DOCS_ROOT/projects/INSURANCE/analysis/target-state"
 

package/tools/vds-scripts/scripts/target-state-automation/validate_structure.sh

@@ -11,7 +11,7 @@ set -euo pipefail
 # - each architecture service has a matching service-spec folder
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=WHO-project/vds-scripts/scripts/target-state-automation/docs_root.sh
+# shellcheck source=~/.claude/vds-scripts/scripts/target-state-automation/docs_root.sh
 source "$SCRIPT_DIR/docs_root.sh"
 
 ROOT="$(resolve_repo_root)"

package/tools/vds-scripts/scripts/uv-workspace-alignment-verification-2026-03-25.md

@@ -2,7 +2,7 @@
 
 Date: 2026-03-25
 Branch: `feat/scripts-uv-workspace-alignment`
-Scope: helper/bootstrap/script-shell alignment for `WHO-project/vds-scripts/scripts/`
+Scope: helper/bootstrap/script-shell alignment for `~/.claude/vds-scripts/scripts/`
 
 ## Summary
 

package/tools/vds-scripts/vds_cli/src/vds_cli/cli.py

@@ -5,6 +5,7 @@ Context7: /websites/typer_tiangolo
 Key Features: typer.Typer(), @app.command(), Annotated options
 """
 
+import os
 from pathlib import Path
 
 import typer
@@ -19,8 +20,8 @@ console = Console()
 
 PASS_THRU_CONTEXT = {"allow_extra_args": True, "ignore_unknown_options": True}
 
-# Get scripts directory (parent of vds_cli package)
-SCRIPT_DIR = Path(__file__).resolve().parent.parent.parent.parent
+# Get scripts directory — prefer VDS_SCRIPTS_ROOT env var (set by vsaf MCP registration)
+SCRIPT_DIR = Path(os.environ["VDS_SCRIPTS_ROOT"]) if "VDS_SCRIPTS_ROOT" in os.environ else Path(__file__).resolve().parent.parent.parent.parent
 
 
 @app.command()

package/tools/vds-scripts/vds_cli_common/README.md

@@ -163,7 +163,7 @@ def test_output(captured_output):
 ## Development
 
 ```bash
-cd WHO-project/vds-scripts/vds_cli_common
+cd ~/.claude/vds-scripts/vds_cli_common
 
 # Install with dev dependencies
 uv sync --group dev