@ngocsangairvds/vsaf 4.0.8 → 4.0.10

package/skills/vds-skill/create-bitbucket-pr/scripts/create-pr.sh

@@ -1,105 +0,0 @@
-#!/bin/bash
-# vds-skill-create-bitbucket-pr: create Bitbucket PR via vds-cli
-# Usage: create-pr.sh [--dry-run] [--target BRANCH] [--description-file FILE] [--title TITLE]
-# Auto-extracts project/repo from `git remote get-url origin`.
-
-# NOTE: No `set -e` — we want full control of the exit-code path.
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=/dev/null
-source "$SCRIPT_DIR/../../_shared/vds-skill/credentials.sh"
-
-require_command git
-# Note: require_command vds-cli moved AFTER dry-run check.
-
-DRY_RUN=false
-TARGET_BRANCH="master"
-DESC_FILE=""
-TITLE=""
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --dry-run) DRY_RUN=true; shift ;;
-        --target) TARGET_BRANCH="$2"; shift 2 ;;
-        --description-file) DESC_FILE="$2"; shift 2 ;;
-        --title) TITLE="$2"; shift 2 ;;
-        *) echo "Unknown arg: $1" >&2; exit 2 ;;
-    esac
-done
-
-REMOTE_URL=$(git remote get-url origin 2>/dev/null || true)
-if [[ -z "$REMOTE_URL" ]]; then
-    echo "ERROR: No git remote 'origin' configured" >&2
-    exit 1
-fi
-
-if [[ ! "$REMOTE_URL" =~ bitbucket\.digital\.vn ]]; then
-    echo "WARNING: Remote URL does not match bitbucket.digital.vn pattern:" >&2
-    echo "  $REMOTE_URL" >&2
-    echo "  This skill is for Viettel Bitbucket. For GitHub, use 'gh pr create'." >&2
-    exit 1
-fi
-
-# Extract PROJECT/REPO from URL
-# Handles:
-#   ssh://git@bitbucket.digital.vn/PROJECT/repo.git
-#   ssh://git@bitbucket.digital.vn:7999/PROJECT/repo.git
-#   https://bitbucket.digital.vn/scm/PROJECT/repo.git
-if [[ "$REMOTE_URL" =~ /scm/([^/]+)/([^/]+)\.git$ ]]; then
-    PROJECT="${BASH_REMATCH[1]}"
-    REPO="${BASH_REMATCH[2]}"
-elif [[ "$REMOTE_URL" =~ /([^/]+)/([^/]+)\.git$ ]]; then
-    PROJECT="${BASH_REMATCH[1]}"
-    REPO="${BASH_REMATCH[2]}"
-else
-    echo "ERROR: Cannot parse PROJECT/REPO from remote URL: $REMOTE_URL" >&2
-    exit 1
-fi
-
-SOURCE_BRANCH=$(git rev-parse --abbrev-ref HEAD)
-if [[ -z "$SOURCE_BRANCH" ]] || [[ "$SOURCE_BRANCH" == "HEAD" ]]; then
-    echo "ERROR: Not on a named branch" >&2
-    exit 1
-fi
-
-if [[ -z "$TITLE" ]]; then
-    TITLE=$(git log -1 --pretty=%s)
-fi
-
-if [[ -z "$DESC_FILE" ]]; then
-    DESC_FILE=$(find .vsaf/docs/features -name '09-ship.md' 2>/dev/null | head -1)
-    [[ -z "$DESC_FILE" ]] && DESC_FILE=$(find .vsaf/docs/hotfixes -name '03-ship.md' 2>/dev/null | head -1)
-fi
-
-CMD=(vds-cli bitbucket pr create "$PROJECT/$REPO"
-     --source "$SOURCE_BRANCH"
-     --target "$TARGET_BRANCH"
-     --title "$TITLE")
-[[ -n "$DESC_FILE" ]] && [[ -f "$DESC_FILE" ]] && CMD+=(--description-file "$DESC_FILE")
-
-if [[ "$DRY_RUN" == "true" ]]; then
-    echo "DRY-RUN — would execute:"
-    printf '  %q' "${CMD[@]}"
-    echo ""
-    echo "  + --yes --json-only"
-    exit 0
-fi
-
-require_command vds-cli
-
-ensure_env VDS_BITBUCKET_TOKEN "Enter VDS Bitbucket personal access token"
-
-echo "About to create PR:"
-echo "  Project/Repo: $PROJECT/$REPO"
-echo "  Source:       $SOURCE_BRANCH"
-echo "  Target:       $TARGET_BRANCH"
-echo "  Title:        $TITLE"
-echo "  Description:  ${DESC_FILE:-<empty>}"
-echo ""
-read -rp "Proceed? [y/N]: " confirm
-if [[ "$confirm" != "y" ]] && [[ "$confirm" != "Y" ]]; then
-    echo "Aborted"
-    exit 1
-fi
-
-"${CMD[@]}" --yes --json-only

package/skills/vds-skill/create-jira-epic/scripts/create-epic.sh

@@ -1,113 +0,0 @@
-#!/bin/bash
-# vds-skill-create-jira-epic: create a Jira Epic via vds-cli
-# Usage: create-epic.sh [--dry-run] [--project KEY] [--description-file FILE] [--feature NAME]
-
-# NOTE: No `set -e` — we want full control of the exit-code path.
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=/dev/null
-source "$SCRIPT_DIR/../../_shared/vds-skill/credentials.sh"
-
-require_command python3
-# Note: require_command vds-cli moved AFTER dry-run check so --dry-run
-#       works without vds-cli installed (preview mode).
-
-DRY_RUN=false
-PROJECT_KEY=""
-DESC_FILE=""
-FEATURE_NAME=""
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --dry-run) DRY_RUN=true; shift ;;
-        --project) PROJECT_KEY="$2"; shift 2 ;;
-        --description-file) DESC_FILE="$2"; shift 2 ;;
-        --feature) FEATURE_NAME="$2"; shift 2 ;;
-        *) echo "Unknown arg: $1" >&2; exit 2 ;;
-    esac
-done
-
-# Determine PRD file path
-if [[ -z "$DESC_FILE" ]]; then
-    if [[ -n "$FEATURE_NAME" ]]; then
-        for path in ".vsaf/docs/features/$FEATURE_NAME/02-prd.md"; do
-            [[ -f "$path" ]] && DESC_FILE="$path" && break
-        done
-    fi
-
-    # Fallback: most recent 02-prd.md
-    if [[ -z "$DESC_FILE" ]]; then
-        DESC_FILE=$(find .vsaf/docs/features -name '02-prd.md' 2>/dev/null \
-                    | xargs -I{} ls -t {} 2>/dev/null | head -1)
-    fi
-fi
-
-if [[ -z "$DESC_FILE" ]] || [[ ! -f "$DESC_FILE" ]]; then
-    echo "ERROR: PRD file not found. Run /sdlc-prd first or specify --description-file" >&2
-    exit 1
-fi
-
-# Derive feature name from PRD path if not given
-if [[ -z "$FEATURE_NAME" ]]; then
-    FEATURE_NAME=$(basename "$(dirname "$DESC_FILE")")
-fi
-
-# Extract summary from PRD (first H1)
-SUMMARY=$(grep -m1 '^# ' "$DESC_FILE" | sed 's/^# //' || true)
-[[ -z "$SUMMARY" ]] && SUMMARY="$FEATURE_NAME"
-
-if [[ "$DRY_RUN" == "true" ]]; then
-    DISPLAY_PROJECT="${PROJECT_KEY:-${VDS_JIRA_PROJECT_DEFAULT:-<VDS_JIRA_PROJECT_DEFAULT>}}"
-    CMD_DRY=(vds-cli jira create
-         --project "$DISPLAY_PROJECT"
-         --issuetype Epic
-         --summary "$SUMMARY"
-         --description-file "$DESC_FILE")
-    echo "DRY-RUN — would execute:"
-    printf '  %q' "${CMD_DRY[@]}"
-    echo ""
-    echo "  + --yes --json-only"
-    exit 0
-fi
-
-require_command vds-cli
-
-# Ensure credentials
-ensure_env VDS_JIRA_TOKEN "Enter VDS Jira personal access token"
-ensure_env VDS_JIRA_PROJECT_DEFAULT "Enter default Jira project key (e.g. NTTC)" false
-
-PROJECT_KEY="${PROJECT_KEY:-$VDS_JIRA_PROJECT_DEFAULT}"
-
-CMD=(vds-cli jira create
-     --project "$PROJECT_KEY"
-     --issuetype Epic
-     --summary "$SUMMARY"
-     --description-file "$DESC_FILE")
-
-echo "About to create Jira Epic:"
-echo "  Project:      $PROJECT_KEY"
-echo "  Summary:      $SUMMARY"
-echo "  Description:  $DESC_FILE"
-echo "  Feature:      $FEATURE_NAME"
-echo ""
-read -rp "Proceed? [y/N]: " confirm
-if [[ "$confirm" != "y" ]] && [[ "$confirm" != "Y" ]]; then
-    echo "Aborted"
-    exit 1
-fi
-
-RESULT=$("${CMD[@]}" --yes --json-only)
-EPIC_KEY=$(echo "$RESULT" | python3 -c 'import json,sys; print(json.load(sys.stdin).get("key",""))')
-
-if [[ -z "$EPIC_KEY" ]]; then
-    echo "ERROR: Failed to extract epic key from vds-cli response" >&2
-    echo "Response: $RESULT" >&2
-    exit 1
-fi
-
-EPIC_KEY_FILE="$(dirname "$DESC_FILE")/jira-epic-key.txt"
-echo "$EPIC_KEY" > "$EPIC_KEY_FILE"
-
-echo ""
-echo "✓ Created Jira Epic: $EPIC_KEY"
-echo "  Saved key to: $EPIC_KEY_FILE"

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

@@ -1,52 +0,0 @@
-#!/bin/bash
-# vds-skill-pull: git pull + detect stale local knowledge index
-# Exit codes: forwards `git pull` exit code (0 on success even if knowledge stale)
-
-# Run git pull, forwarding all args. Capture exit code for explicit forwarding.
-# (No `set -e` — we want full control of the exit-code path for the advisory stale check.)
-git pull "$@"
-EXIT=$?
-
-if [[ $EXIT -ne 0 ]]; then
-    exit $EXIT
-fi
-
-# Skip stale check if not a fetch-based pull (e.g., --no-rebase --quiet might skip FETCH_HEAD)
-if [[ ! -f .git/FETCH_HEAD ]]; then
-    exit 0
-fi
-
-FETCH_HEAD_MTIME=$(stat -c %Y .git/FETCH_HEAD 2>/dev/null || stat -f %m .git/FETCH_HEAD 2>/dev/null || echo 0)
-STALE_REASONS=()
-
-# Check .gitnexus/
-if [[ -d .gitnexus ]]; then
-    GITNEXUS_MTIME=$(stat -c %Y .gitnexus 2>/dev/null || stat -f %m .gitnexus 2>/dev/null || echo 0)
-    if [[ $GITNEXUS_MTIME -lt $FETCH_HEAD_MTIME ]]; then
-        STALE_REASONS+=(".gitnexus/ index older than fetched commits")
-    fi
-fi
-# Note: .gitnexus missing is OK (project may not use GitNexus)
-
-# Check graphify-out/graph.json
-if [[ -f graphify-out/graph.json ]]; then
-    GRAPH_MTIME=$(stat -c %Y graphify-out/graph.json 2>/dev/null || stat -f %m graphify-out/graph.json 2>/dev/null || echo 0)
-    if [[ $GRAPH_MTIME -lt $FETCH_HEAD_MTIME ]]; then
-        STALE_REASONS+=("graphify-out/graph.json older than fetched commits")
-    fi
-fi
-# Note: graphify-out missing is OK
-
-# Print suggestion if anything stale
-if [[ ${#STALE_REASONS[@]} -gt 0 ]]; then
-    echo ""
-    echo "⚠️  Knowledge index có thể stale sau pull:"
-    for reason in "${STALE_REASONS[@]}"; do
-        echo "   - $reason"
-    done
-    echo ""
-    echo "   Khuyến nghị: chạy /sdlc-onboard-code để rebuild GitNexus + Graphify locally."
-    echo ""
-fi
-
-exit 0

package/skills/vds-skill/search-confluence/scripts/search.sh

@@ -1,128 +0,0 @@
-#!/bin/bash
-# vds-skill-search-confluence: search Confluence + Jira for feature discovery context
-# Usage: search.sh --feature NAME --query KEYWORDS [--dry-run] [--days N] [--limit N]
-
-# NOTE: No `set -e` — we want full control of the exit-code path.
-
-# Source credentials helper (deployed path: .claude/skills/_shared/vds-skill/credentials.sh)
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=/dev/null
-source "$SCRIPT_DIR/../../_shared/vds-skill/credentials.sh"
-
-require_command python3
-# Note: require_command vds-cli moved AFTER dry-run check so --dry-run
-#       works without vds-cli installed (preview mode).
-
-FEATURE=""
-QUERY=""
-DAYS=180
-LIMIT=30
-DRY_RUN=false
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --feature) FEATURE="$2"; shift 2 ;;
-        --query) QUERY="$2"; shift 2 ;;
-        --days) DAYS="$2"; shift 2 ;;
-        --limit) LIMIT="$2"; shift 2 ;;
-        --dry-run) DRY_RUN=true; shift ;;
-        *) echo "Unknown arg: $1" >&2; exit 2 ;;
-    esac
-done
-
-if [[ -z "$FEATURE" ]]; then
-    echo "ERROR: --feature is required" >&2
-    exit 2
-fi
-if [[ -z "$QUERY" ]]; then
-    echo "ERROR: --query (search keywords) is required" >&2
-    exit 2
-fi
-
-# Determine output dir
-OUT_DIR=".vsaf/docs/features/$FEATURE"
-
-OUT_JSON="$OUT_DIR/01-discovery-historical.json"
-OUT_MD="$OUT_DIR/01-discovery-historical.md"
-
-if [[ "$DRY_RUN" == "true" ]]; then
-    SPACE="${VDS_CONFLUENCE_SPACE_DEFAULT:-<VDS_CONFLUENCE_SPACE_DEFAULT>}"
-    PROJECT="${VDS_JIRA_PROJECT_DEFAULT:-<VDS_JIRA_PROJECT_DEFAULT>}"
-    CQL="space=$SPACE AND text ~ \"$QUERY\" AND lastmodified > now(\"-${DAYS}d\")"
-    JQL="project = $PROJECT AND text ~ \"$QUERY\" AND created > -${DAYS}d ORDER BY created DESC"
-    echo "DRY-RUN — would execute:"
-    echo "  vds-cli confluence search --cql \"$CQL\" --limit $LIMIT --json-only"
-    echo "  vds-cli jira search \"$JQL\" --limit $LIMIT --json-only"
-    echo "  Write to: $OUT_JSON + $OUT_MD"
-    exit 0
-fi
-
-require_command vds-cli
-
-# Ensure credentials
-ensure_env VDS_CONFLUENCE_TOKEN "Enter VDS Confluence personal access token"
-ensure_env VDS_JIRA_TOKEN "Enter VDS Jira personal access token"
-ensure_env VDS_CONFLUENCE_SPACE_DEFAULT "Enter default Confluence space key (e.g. ENG)" false
-ensure_env VDS_JIRA_PROJECT_DEFAULT "Enter default Jira project key (e.g. NTTC)" false
-
-# Build CQL + JQL (now using real env vars)
-CQL="space=$VDS_CONFLUENCE_SPACE_DEFAULT AND text ~ \"$QUERY\" AND lastmodified > now(\"-${DAYS}d\")"
-JQL="project = $VDS_JIRA_PROJECT_DEFAULT AND text ~ \"$QUERY\" AND created > -${DAYS}d ORDER BY created DESC"
-
-# Create output dir now (after dry-run exits early)
-mkdir -p "$OUT_DIR"
-
-# Execute searches
-echo "Searching Confluence (limit $LIMIT, last ${DAYS}d)..."
-CONF_RESULTS=$(vds-cli confluence search --cql "$CQL" --limit "$LIMIT" --json-only 2>/dev/null || echo '{"results":[]}')
-
-echo "Searching Jira (limit $LIMIT, last ${DAYS}d)..."
-JIRA_RESULTS=$(vds-cli jira search "$JQL" --limit "$LIMIT" --json-only 2>/dev/null || echo '{"issues":[]}')
-
-# Combined JSON output + Markdown summary
-python3 - "$CONF_RESULTS" "$JIRA_RESULTS" "$OUT_JSON" "$OUT_MD" "$QUERY" "$DAYS" <<'PYEOF'
-import json, sys
-conf_raw, jira_raw, out_json, out_md, query, days = sys.argv[1:7]
-conf = json.loads(conf_raw) if conf_raw.strip() else {"results":[]}
-jira = json.loads(jira_raw) if jira_raw.strip() else {"issues":[]}
-
-combined = {
-    "query": query,
-    "days_back": int(days),
-    "confluence": conf.get("results", []),
-    "jira": jira.get("issues", []),
-}
-with open(out_json, "w") as f:
-    json.dump(combined, f, indent=2, ensure_ascii=False)
-
-lines = [
-    f"# Discovery Historical Context — {query}",
-    f"",
-    f"> Generated by /vds-skill-search-confluence — searched last {days} days",
-    f"",
-    f"## Confluence pages ({len(combined['confluence'])} results)",
-    f"",
-]
-for page in combined["confluence"][:10]:
-    title = page.get("title", "<no title>")
-    url = page.get("url", page.get("_links", {}).get("webui", ""))
-    modified = page.get("lastModified", page.get("version", {}).get("when", "?"))
-    lines.append(f"- [{title}]({url}) — modified {modified}")
-
-lines += [
-    f"",
-    f"## Jira tickets ({len(combined['jira'])} results)",
-    f"",
-]
-for issue in combined["jira"][:15]:
-    key = issue.get("key", "?")
-    summary = issue.get("fields", {}).get("summary", "<no summary>")
-    status = issue.get("fields", {}).get("status", {}).get("name", "?")
-    lines.append(f"- **{key}** — {summary} ({status})")
-
-with open(out_md, "w") as f:
-    f.write("\n".join(lines) + "\n")
-
-print(f"Wrote: {out_json}")
-print(f"Wrote: {out_md}")
-PYEOF