@ngocsangairvds/vsaf 3.2.6 → 3.2.8

package/package.json

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

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/tools/skills/vds-scripts-skill/SKILL.md

@@ -18,9 +18,7 @@ metadata:
 
 Use this skill as the **platform-routing entrypoint** for the WHO scripts ecosystem.
 
-`WHO-project` is the canonical VDS ecosystem for both reusable skills and routed scripts:
-- skills live under `WHO-project/vds-skills/skills/`
-- scripts and orchestrators live under `WHO-project/vds-scripts/`
+The VDS scripts ecosystem lives at `~/.claude/vds-scripts/` (installed via `vsaf global`).
 
 This skill helps you:
 - find the right `vds-cli` command family
@@ -46,27 +44,22 @@ Do **not** use this skill as the authoritative deep runbook for:
 
 ## Canonical Sources
 
-- Scripts workspace: `WHO-project/vds-scripts/`
-- Skills catalog: `WHO-project/vds-skills/skills/`
-- Skill registry: `WHO-project/vds-skills/registry.yaml`
-- Alignment workflow: `WHO-project/vds-skills/ALIGNMENT.md`
+- Scripts workspace: `~/.claude/vds-scripts/`
 
 ## Primary Command Entry Points
 
-```/dev/null/vds-scripts-skill-entrypoints.sh#L1-12
-# Interactive monorepo-root usage
-./WHO-project/vds-scripts/scripts/worktree_uv.sh run --directory WHO-project/vds-scripts --package vds-cli vds-cli --help
-./WHO-project/vds-scripts/scripts/worktree_uv.sh run --directory WHO-project/vds-scripts --package audit_orchestrator vds-audit --help
-./WHO-project/vds-scripts/scripts/worktree_uv.sh run --directory WHO-project/vds-scripts --package spec_orchestrator vds-spec --help
-
-# Dedicated vds-scripts worktree usage
-./scripts/worktree_uv.sh run --package vds_cli vds-cli --help
-./scripts/worktree_uv.sh run --package audit_orchestrator vds-audit --help
-./scripts/worktree_uv.sh run --package spec_orchestrator vds-spec --help
-
-# Maintained shell scripts must not copy the plain patterns above.
-# They should source scripts/vds_sh_helpers.sh and use vds_uv_run_package
-# / vds_uv_sync_package / vds_uv_sync_all instead.
+```bash
+# Via vds-cli (recommended — MCP-registered)
+vds-cli --help
+vds-cli confluence --help
+vds-cli jira --help
+vds-cli bitbucket --help
+vds-cli git --help
+
+# Direct uv invocation from vds-scripts root
+~/.claude/vds-scripts/scripts/worktree_uv.sh run --directory ~/.claude/vds-scripts --package vds-cli vds-cli --help
+~/.claude/vds-scripts/scripts/worktree_uv.sh run --directory ~/.claude/vds-scripts --package audit_orchestrator vds-audit --help
+~/.claude/vds-scripts/scripts/worktree_uv.sh run --directory ~/.claude/vds-scripts --package spec_orchestrator vds-spec --help
 ```
 
 ## Platform Command Families
@@ -128,8 +121,6 @@ Use these bundled references for depth:
 
 ## Notes
 
-- Edit this skill only under `WHO-project/vds-skills/skills/vds-scripts-skill/`.
-- Do not edit `.agent/skills/` directly.
 - Keep this file concise and routing-oriented; push deeper command catalogs into `references/`.
-- For integrated `WHO-project/vds-scripts` workspace usage, Python 3.14+ is the preferred baseline for humans and AI agents.
-- After updates, sync generated agent surfaces from the monorepo root.
+- For integrated `~/.claude/vds-scripts` workspace usage, Python 3.10+ is the preferred baseline.
+- After updates, re-run `vsaf global` to sync skills to all agent surfaces.

package/tools/skills/vds-scripts-skill/references/google-sheets.md

@@ -64,10 +64,8 @@ vds-cli google-sheets -- --json-only read \
 
 Interactive monorepo-root usage commonly uses:
 
-```/dev/null/google-sheets-prefix.sh#L1-1
-./WHO-project/vds-scripts/scripts/worktree_uv.sh run --directory WHO-project/vds-scripts --package vds-cli vds-cli google-sheets <command>
+```bash
+vds-cli google-sheets <command>
+# Or direct uv invocation:
+~/.claude/vds-scripts/scripts/worktree_uv.sh run --directory ~/.claude/vds-scripts --package vds-cli vds-cli google-sheets <command>
 ```
-
-Inside a dedicated `vds-scripts` worktree, the equivalent form is `./scripts/worktree_uv.sh run --package vds_cli vds-cli google-sheets <command>`.
-
-For maintained shell scripts inside `WHO-project/vds-scripts`, do not copy raw operator forms. Source `scripts/vds_sh_helpers.sh` and use the helper contract instead.

package/tools/skills/vds-scripts-skill/references/integration-commands.md

@@ -2,10 +2,10 @@
 
 vds Representative WHO integration command families.
 
-These examples are interactive operator examples. From the umbrella monorepo root, prefer `./WHO-project/vds-scripts/scripts/worktree_uv.sh run --directory WHO-project/vds-scripts --package <uv-package-name> ...`. Inside a dedicated `vds-scripts` worktree, prefer `./scripts/worktree_uv.sh run --package <member-dir> ...`. Maintained shell scripts inside `WHO-project/vds-scripts` should source `scripts/vds_sh_helpers.sh` instead of copying raw operator forms.
+These examples use `vds-cli` (MCP-registered entrypoint). For direct uv invocation, prefer `~/.claude/vds-scripts/scripts/worktree_uv.sh run --directory ~/.claude/vds-scripts --package <uv-package-name> ...`.
 
 - `vds-cli jira ...`
-  - JQL search example: `./WHO-project/vds-scripts/scripts/worktree_uv.sh run --directory WHO-project/vds-scripts --package jira_orchestrator vds-jira-cli search "project = CBDC ORDER BY updated DESC" --limit 5 --json-only`
+  - JQL search example: `vds-cli jira search "project = CBDC ORDER BY updated DESC" --limit 5 --json-only`
   - Note: `vds-jira-cli search` now accepts `--json-only` as a command-local flag after `search`, in addition to the global pre-subcommand form.
 - `vds-cli confluence ...`
 - `vds-cli bitbucket ...`

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_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