@ngocsangairvds/vsaf 4.1.7 → 4.1.9

package/skills/vds-skill/install-deps.mjs

@@ -1,410 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * VDS Skill Pack — credential & config setup
- *
- * Merges credential stubs into ~/.vds/.env (the shared VDS env file
- * that all orchestrators read via pydantic-settings).
- *
- * Usage:
- *   node install-deps.mjs [projectPath]
- */
-
-import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync, chmodSync, unlinkSync } from 'fs';
-import { join, dirname, delimiter } from 'path';
-import { homedir } from 'os';
-
-const projectPath = process.argv[2] || process.cwd();
-const packDir = process.argv[3] || dirname(new URL(import.meta.url).pathname);
-
-// ── Config ──
-
-const VDS_DIR = join(homedir(), '.vds');
-const CONFIG_FILE = join(VDS_DIR, '.env');
-
-const REQUIRED_VARS = [
-  // Personal Access Tokens — primary auth (one token per service)
-  { name: 'INTERNAL_CONFLUENCE_TOKEN', desc: 'Confluence internal server PAT', skills: 'push-prd, push-srs, search-confluence' },
-  { name: 'JIRA_TOKEN', desc: 'Jira personal access token', skills: 'create-jira-epic, search-confluence' },
-  { name: 'BITBUCKET_TOKEN', desc: 'Bitbucket personal access token', skills: 'create-bitbucket-pr' },
-];
-
-// Optional — basic auth fallback (only needed if PATs not available)
-const OPTIONAL_VARS = [
-  { name: 'VDS_USERNAME', desc: 'VDS username (basic auth fallback)', skills: 'confluence, jira, bitbucket' },
-  { name: 'VDS_PASSWORD', desc: 'VDS password (basic auth fallback)', skills: 'confluence, jira, bitbucket' },
-];
-
-// ── Helpers ──
-
-function log(icon, msg) {
-  console.log(`  ${icon} ${msg}`);
-}
-
-function parseExistingConfig(filePath) {
-  if (!existsSync(filePath)) return {};
-  const vars = {};
-  for (const line of readFileSync(filePath, 'utf-8').split('\n')) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-    const eq = trimmed.indexOf('=');
-    if (eq > 0) {
-      const key = trimmed.slice(0, eq);
-      const val = trimmed.slice(eq + 1).replace(/^['"]|['"]$/g, '');
-      if (val) vars[key] = val;
-    }
-  }
-  return vars;
-}
-
-// ── Step 1: Ensure ~/.vds/ directory ──
-
-console.log('\n[vds-skill] Setting up VDS credentials...\n');
-
-mkdirSync(VDS_DIR, { recursive: true });
-
-// ── Step 2: Create or merge config template ──
-
-const existing = parseExistingConfig(CONFIG_FILE);
-const missing = [];
-const filled = [];
-
-for (const v of REQUIRED_VARS) {
-  if (existing[v.name]) {
-    filled.push(v);
-  } else {
-    missing.push(v);
-  }
-}
-
-if (!existsSync(CONFIG_FILE)) {
-  // Create fresh template
-  const lines = [
-    '# VDS shared environment — credential config',
-    '# File: ~/.vds/.env',
-    '# Permissions: 600 (auto-set by installer)',
-    '#',
-    '# Set per-service Personal Access Tokens (recommended):',
-    '#   INTERNAL_CONFLUENCE_TOKEN, JIRA_TOKEN, BITBUCKET_TOKEN',
-    '# Or basic auth fallback: VDS_USERNAME + VDS_PASSWORD (works for all services)',
-    '# To rotate a credential: update the value here, orchestrators pick it up next run.',
-    '',
-  ];
-
-  for (const v of REQUIRED_VARS) {
-    lines.push(`# ${v.desc}`);
-    lines.push(`# Used by: ${v.skills}`);
-    lines.push(`${v.name}=`);
-    lines.push('');
-  }
-
-  lines.push('# --- Basic auth fallback (optional, only if PATs not available) ---');
-  lines.push('');
-  for (const v of OPTIONAL_VARS) {
-    lines.push(`# ${v.desc}`);
-    lines.push(`# ${v.name}=`);
-  }
-  lines.push('');
-
-  writeFileSync(CONFIG_FILE, lines.join('\n'));
-  if (process.platform !== 'win32') {
-    chmodSync(CONFIG_FILE, 0o600);
-  }
-  log('✅', `Config created: ${CONFIG_FILE}`);
-} else if (missing.length > 0) {
-  // Append missing vars to existing config
-  const appendLines = ['\n# --- Added by vds-skill install ---\n'];
-  for (const v of missing) {
-    if (!readFileSync(CONFIG_FILE, 'utf-8').includes(v.name)) {
-      appendLines.push(`# ${v.desc}`);
-      appendLines.push(`# Used by: ${v.skills}`);
-      appendLines.push(`${v.name}=`);
-      appendLines.push('');
-    }
-  }
-  if (appendLines.length > 1) {
-    writeFileSync(CONFIG_FILE, readFileSync(CONFIG_FILE, 'utf-8') + appendLines.join('\n'));
-    if (process.platform !== 'win32') {
-      chmodSync(CONFIG_FILE, 0o600);
-    }
-    log('✅', `Config updated: ${CONFIG_FILE}`);
-  }
-} else {
-  log('✅', `Config already complete: ${CONFIG_FILE}`);
-}
-
-// ── Step 3: Print status ──
-
-console.log('');
-if (filled.length > 0) {
-  log('✅', `${filled.length} credential(s) already configured:`);
-  for (const v of filled) {
-    log('  ', `${v.name} — ${v.desc}`);
-  }
-}
-
-if (missing.length > 0) {
-  console.log('');
-  log('⚠️', `${missing.length} credential(s) need to be filled:`);
-  console.log('');
-  console.log('  ┌────────────────────────────────────┬──────────────────────────────────────────────┐');
-  console.log('  │ Variable                           │ Description                                  │');
-  console.log('  ├────────────────────────────────────┼──────────────────────────────────────────────┤');
-  for (const v of missing) {
-    const name = v.name.padEnd(36);
-    const desc = v.desc.padEnd(44);
-    console.log(`  │ ${name}│ ${desc}│`);
-  }
-  console.log('  └────────────────────────────────────┴──────────────────────────────────────────────┘');
-  console.log('');
-  log('📝', `Edit config file:`);
-  console.log(`       ${CONFIG_FILE}`);
-  console.log('');
-  log('💡', 'Skills will also lazy-prompt at runtime if values are empty.');
-}
-
-// ── Step 4: Deploy bundled vds-scripts to project ──
-
-console.log('');
-const { execSync } = await import('child_process');
-
-const localVdsScripts = join(projectPath, '.claude', 'vds-scripts');
-const globalVdsScripts = join(homedir(), '.claude', 'vds-scripts');
-const bundledVdsScripts = join(packDir, 'vds-scripts');
-
-if (!existsSync(localVdsScripts) && existsSync(bundledVdsScripts)) {
-  log('📦', 'Deploying bundled vds-scripts to .claude/vds-scripts/ ...');
-  try {
-    mkdirSync(join(projectPath, '.claude'), { recursive: true });
-    cpSync(bundledVdsScripts, localVdsScripts, { recursive: true });
-    log('✅', `vds-scripts deployed: ${localVdsScripts}`);
-  } catch (e) {
-    log('⚠️', `Failed to deploy vds-scripts: ${e.message}`);
-  }
-} else if (existsSync(localVdsScripts)) {
-  log('✅', 'vds-scripts already exists at .claude/vds-scripts/');
-}
-
-// Detect vds-scripts location (project-local preferred, then global)
-const vdsScriptsDir = existsSync(localVdsScripts) ? localVdsScripts
-  : existsSync(globalVdsScripts) ? globalVdsScripts
-  : null;
-
-let vdsCliFound = false;
-
-// Check if vds-cli is already on PATH
-try {
-  const version = execSync('vds-cli version', { stdio: 'pipe', encoding: 'utf-8' }).trim();
-  log('✅', `vds-cli ${version} (on PATH)`);
-  vdsCliFound = true;
-} catch {
-  // Not on PATH — try to create project-local wrapper
-}
-
-// Create project-local vds-cli wrapper if vds-scripts exists but vds-cli not on PATH
-if (!vdsCliFound && vdsScriptsDir) {
-  const wrapperDir = join(projectPath, '.claude', 'bin');
-  const wrapperPath = join(wrapperDir, 'vds-cli');
-  // Check vds-scripts has valid structure (pyproject.toml = uv project)
-  if (existsSync(join(vdsScriptsDir, 'pyproject.toml'))) {
-    mkdirSync(wrapperDir, { recursive: true });
-
-    if (process.platform === 'win32') {
-      // Windows: Node.js wrapper + .cmd shim
-      const wrapperContent = `#!/usr/bin/env node
-// Project-local vds-cli wrapper — created by vsaf install vds-skill
-const { execFileSync } = require('child_process');
-try {
-  execFileSync('uv', ['run', '--directory', ${JSON.stringify(vdsScriptsDir)}, '--package', 'vds-cli', 'vds-cli', ...process.argv.slice(2)], { stdio: 'inherit', shell: true });
-} catch (e) {
-  process.exit(e.status || 1);
-}
-`;
-      writeFileSync(wrapperPath, wrapperContent);
-      writeFileSync(wrapperPath + '.cmd', `@node "%~dp0\\vds-cli" %*\r\n`);
-    } else {
-      // Unix: pure bash wrapper — no node/nvm dependency
-      const wrapperContent = `#!/usr/bin/env bash
-# Project-local vds-cli wrapper — created by vsaf install vds-skill
-# Uses bash instead of node to avoid nvm/node PATH issues
-exec uv run --directory ${JSON.stringify(vdsScriptsDir)} --package vds-cli vds-cli "$@"
-`;
-      writeFileSync(wrapperPath, wrapperContent);
-      chmodSync(wrapperPath, 0o755);
-    }
-    log('✅', `vds-cli wrapper created: ${wrapperPath}`);
-    log('  ', `Points to: ${vdsScriptsDir}`);
-
-    // Auto-register .claude/bin in CLAUDE.md so Claude Code always finds vds-cli
-    const claudeMdPath = join(projectPath, 'CLAUDE.md');
-    try {
-      const content = existsSync(claudeMdPath) ? readFileSync(claudeMdPath, 'utf-8') : '';
-      const pathExport = 'export PATH=".claude/bin:$PATH"';
-      if (!content.includes('.claude/bin')) {
-        const block = `\n\n## vds-cli PATH\n\nBefore running any \`vds-cli\` command, prepend the local bin directory:\n\`\`\`bash\n${pathExport}\n\`\`\`\nOr use the full path: \`.claude/bin/vds-cli\`\n`;
-        writeFileSync(claudeMdPath, content + block);
-        log('✅', 'PATH hint added to CLAUDE.md');
-      }
-    } catch {
-      // CLAUDE.md update is best-effort
-    }
-
-    // Also add Bash permission for .claude/bin/vds-cli in settings.local.json
-    const settingsPath = join(projectPath, '.claude', 'settings.local.json');
-    try {
-      const settings = existsSync(settingsPath)
-        ? JSON.parse(readFileSync(settingsPath, 'utf-8'))
-        : {};
-      if (!settings.permissions) settings.permissions = {};
-      if (!settings.permissions.allow) settings.permissions.allow = [];
-      const vdsRule = 'Bash(.claude/bin/vds-cli *)';
-      if (!settings.permissions.allow.some(r => r.includes('.claude/bin/vds-cli'))) {
-        settings.permissions.allow.push(vdsRule);
-        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-        log('✅', 'vds-cli permission added to settings.local.json');
-      }
-    } catch {
-      // settings update is best-effort
-    }
-
-    vdsCliFound = true;
-  }
-}
-
-if (!vdsCliFound) {
-  log('⚠️', 'vds-cli not found — required for non-dry-run execution');
-  log('  ', 'Option 1: Clone vds-scripts into .claude/vds-scripts/ then re-run install');
-  log('  ', 'Option 2: Install vds-cli globally (pip install / Viettel internal)');
-  log('  ', 'Verify:   vds-cli version');
-}
-
-// ── Step 5: Sync all vds-scripts packages (ensures subcommand binaries exist) ──
-
-if (vdsScriptsDir) {
-  log('📂', `vds-scripts: ${vdsScriptsDir}`);
-  if (existsSync(join(vdsScriptsDir, 'pyproject.toml'))) {
-    // Check uv is available before attempting sync
-    let uvAvailable = false;
-    try {
-      execSync('uv --version', { stdio: 'pipe', encoding: 'utf-8', timeout: 10000 });
-      uvAvailable = true;
-    } catch {
-      log('⚠️', 'uv (Python package manager) not found — required for vds-scripts');
-      if (process.platform === 'win32') {
-        log('  ', 'Install: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"');
-        log('  ', '  or:    winget install astral-sh.uv');
-      } else {
-        log('  ', 'Install: curl -LsSf https://astral.sh/uv/install.sh | sh');
-        log('  ', '  or:    brew install uv');
-      }
-    }
-
-    if (uvAvailable) {
-      console.log('');
-      log('🔄', 'Syncing vds-scripts packages (uv sync --all-packages)...');
-      try {
-        execSync('uv sync --all-packages', {
-          stdio: 'pipe',
-          encoding: 'utf-8',
-          timeout: 600000,
-          cwd: vdsScriptsDir,
-          env: { ...process.env, UV_HTTP_TIMEOUT: '300' },
-        });
-        log('✅', 'All vds-scripts packages synced');
-      } catch (e) {
-        log('⚠️', 'Failed to sync vds-scripts packages — subcommands like confluence/jira may not work');
-        if (e.stderr) log('  ', `Error: ${e.stderr.trim().split('\n')[0]}`);
-        log('  ', `Fix: cd ${vdsScriptsDir} && uv sync --all-packages`);
-      }
-    }
-  }
-} else {
-  log('⚠️', 'vds-scripts not found at .claude/vds-scripts/ or ~/.claude/vds-scripts/');
-}
-
-// ── Step 6: Verify vds-cli actually works (catch broken shims) ──
-
-console.log('');
-log('🔍', 'Verifying vds-cli...');
-
-let verified = false;
-
-// First pass: try vds-cli on PATH
-try {
-  const ver = execSync('vds-cli version', { stdio: 'pipe', encoding: 'utf-8', timeout: 60000 }).trim();
-  log('✅', `vds-cli ${ver} — working`);
-  verified = true;
-} catch {
-  // vds-cli on PATH failed — check if a broken shim exists and auto-remove it
-  try {
-    const whichCmd = process.platform === 'win32' ? 'where' : 'which';
-    const shimPath = execSync(`${whichCmd} vds-cli`, { stdio: 'pipe', encoding: 'utf-8' }).trim().split('\n')[0];
-    // Shim exists but doesn't work — remove it automatically
-    log('🗑️', `Removing broken shim: ${shimPath}`);
-    try {
-      unlinkSync(shimPath);
-      log('✅', 'Broken shim removed');
-    } catch (e) {
-      log('⚠️', `Cannot auto-remove shim (${e.code || e.message})`);
-      if (process.platform === 'win32') {
-        log('  ', 'Fix: open cmd as Administrator, then run:');
-        log('  ', `  del "${shimPath}"`);
-        log('  ', '  vsaf install vds-skill');
-      } else {
-        log('  ', `Fix: rm "${shimPath}"  then re-run: vsaf install vds-skill`);
-      }
-    }
-  } catch {
-    // No shim found — that's fine
-  }
-}
-
-// Second pass: try project-local wrapper
-if (!verified) {
-  try {
-    const wrapperPath = join(projectPath, '.claude', 'bin');
-    const ver = execSync('vds-cli version', {
-      stdio: 'pipe', encoding: 'utf-8', timeout: 60000,
-      env: { ...process.env, PATH: `${wrapperPath}${delimiter}${process.env.PATH}` },
-    }).trim();
-    log('✅', `vds-cli ${ver} — working (via .claude/bin/vds-cli)`);
-    verified = true;
-  } catch (e) {
-    log('❌', 'vds-cli not working — skills will be BLOCKED at runtime');
-    if (e.stderr) log('  ', `stderr: ${e.stderr.toString().trim().split('\n').slice(0, 3).join('\n         ')}`);
-    else log('  ', `Error: ${e.message || e}`);
-
-    // Diagnostic: test uv run directly to isolate the issue
-    if (vdsScriptsDir) {
-      try {
-        const uvVer = execSync(`uv run --directory ${JSON.stringify(vdsScriptsDir)} --package vds-cli vds-cli version`, {
-          stdio: 'pipe', encoding: 'utf-8', timeout: 60000,
-        }).trim();
-        log('  ', `Direct uv run works: ${uvVer}`);
-        log('  ', 'Issue is with the wrapper script, not uv/vds-cli');
-      } catch (uvErr) {
-        log('  ', `Direct uv run also fails: ${uvErr.stderr ? uvErr.stderr.toString().trim().split('\n')[0] : uvErr.message}`);
-      }
-    }
-  }
-}
-
-// ── Step 7: Print verification commands for user ──
-
-console.log('');
-console.log('  ┌──────────────────────────────────────────────────────┐');
-console.log('  │  Verify commands (run these to confirm setup):       │');
-console.log('  ├──────────────────────────────────────────────────────┤');
-console.log('  │  vds-cli version            # CLI is executable     │');
-console.log('  │  vds-cli confluence --help   # Confluence subcommand │');
-console.log('  │  vds-cli jira --help         # Jira subcommand      │');
-console.log('  │  vds-cli bitbucket --help    # Bitbucket subcommand │');
-console.log('  └──────────────────────────────────────────────────────┘');
-
-if (!verified) {
-  console.log('');
-  log('⚠️', 'vds-cli is NOT working — skills will be BLOCKED at runtime.');
-  log('  ', 'Fix vds-cli first, then run the verify commands above.');
-}
-
-console.log('\n[vds-skill] Setup complete ✅\n');

package/skills/vds-skill/pack.yaml

@@ -1,24 +0,0 @@
-name: vds-skill
-version: 1.0.0
-description: Viettel VDS automation skills — opt-in pack wrapping vds-cli for Confluence/Jira/Bitbucket integration with SDLC flow
-author: "@ngocsangairvds/vsaf"
-
-# Skills deployed WITH prefix: /vds-skill-<name>
-skills:
-  # Knowledge sync
-  - pull                      # /vds-skill-pull — git pull + stale index detection
-
-  # Discovery enrichment (helper for Phase 1)
-  - search-confluence         # /vds-skill-search-confluence — search Confluence + Jira for historical context
-
-  # PRD/SRS publication (helper for Phase 2/4)
-  - push-prd                  # /vds-skill-push-prd — push PRD to Confluence via vds-cli
-  - push-srs                  # /vds-skill-push-srs — push SRS to Confluence via vds-cli + link PRD
-
-  # Epic/PR creation (helper for Phase 2/9)
-  - create-jira-epic          # /vds-skill-create-jira-epic — create Jira Epic from PRD
-  - create-bitbucket-pr       # /vds-skill-create-bitbucket-pr — create Bitbucket PR after ship
-
-# Bundled external skills — deployed WITHOUT prefix (as-is)
-bundled:
-  - vds-scripts-skill         # /vds-scripts-skill — platform-routing skill (imported from /Downloads/vds-scripts/)

package/skills/vds-skill/pull/SKILL.md

@@ -1,38 +0,0 @@
----
-name: vds-skill-pull
-description: Pull latest code via `git pull` then detect stale local knowledge index (`.gitnexus/`, `graphify-out/graph.json`) by comparing mtime with `.git/FETCH_HEAD`. Suggest `/sdlc-onboard-code` if stale. Use instead of bare `git pull` for projects using SDLC pack.
----
-
-# /vds-skill-pull
-
-Wrapper for `git pull` that detects stale local knowledge index after pull and suggests rebuild.
-
-## Usage
-
-```bash
-/vds-skill-pull              # equivalent to `git pull`
-/vds-skill-pull --rebase     # forwards args to git pull
-/vds-skill-pull origin main  # also forwards
-```
-
-## Behavior
-
-1. Run `git pull` with all passed args
-2. If pull succeeds, check `.gitnexus/` and `graphify-out/graph.json` mtime vs `.git/FETCH_HEAD`
-3. If any stale → print suggestion to run `/sdlc-onboard-code`
-4. Exit 0 (advisory, does not block workflow)
-
-## Implementation
-
-Invoke the bundled script:
-
-```bash
-node .claude/skills/vds-skill-pull/scripts/pull.js "$@"
-```
-
-## Notes
-
-- Works for both Viettel and non-Viettel projects (no vds-cli dependency).
-- If `.gitnexus/` or `graphify-out/` does not exist, that's OK — only flagged if present-but-stale.
-- Skill exits 0 even when knowledge is stale (advisory only — user decides whether to onboard now or later).
-- `.gitnexus/` staleness uses directory mtime — this catches new files but may miss in-place edits. If GitNexus rewrites files without re-creating them, the check could give a false "fresh" reading. Acceptable for advisory mode.

package/skills/vds-skill/pull/scripts/pull.js

@@ -1,59 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * vds-skill-pull: git pull + detect stale local knowledge index.
- * Usage: node pull.js [...git pull args]
- * Exit: forwards git pull exit code. Advisory stale warnings never block.
- */
-
-const { execSync } = require('child_process');
-const { existsSync, statSync } = require('fs');
-
-const args = process.argv.slice(2);
-
-// Forward git pull with all args, inherit I/O
-let exitCode = 0;
-try {
-  execSync(`git pull ${args.map(a => JSON.stringify(a)).join(' ')}`, { stdio: 'inherit' });
-} catch (err) {
-  exitCode = err.status || 1;
-  process.exit(exitCode);
-}
-
-// Skip stale check if FETCH_HEAD doesn't exist
-if (!existsSync('.git/FETCH_HEAD')) {
-  process.exit(0);
-}
-
-const fetchMtime = statSync('.git/FETCH_HEAD').mtimeMs;
-const staleReasons = [];
-
-// Check .gitnexus/
-if (existsSync('.gitnexus')) {
-  const gnMtime = statSync('.gitnexus').mtimeMs;
-  if (gnMtime < fetchMtime) {
-    staleReasons.push('.gitnexus/ index older than fetched commits');
-  }
-}
-
-// Check graphify-out/graph.json
-if (existsSync('graphify-out/graph.json')) {
-  const gMtime = statSync('graphify-out/graph.json').mtimeMs;
-  if (gMtime < fetchMtime) {
-    staleReasons.push('graphify-out/graph.json older than fetched commits');
-  }
-}
-
-if (staleReasons.length > 0) {
-  console.log('');
-  console.log('  Knowledge index may be stale after pull:');
-  for (const reason of staleReasons) {
-    console.log(`   - ${reason}`);
-  }
-  console.log('');
-  console.log('   Recommend: run /sdlc-onboard-code to rebuild GitNexus + Graphify locally.');
-  console.log('');
-}
-
-process.exit(0);