codymaster 4.5.4 → 4.8.0

package/install.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # ════════════════════════════════════════════════════════════════
-#  CodyMaster Skills Kit v4.3.0 — Universal Installer
+#  CodyMaster Skills Kit — Universal Installer (see VERSION below)
 #  Inspired by: npx skills add (vercel-labs/skills)
 #
 #  Usage:
@@ -8,31 +8,48 @@
 #    bash install.sh --claude           Claude Code (non-interactive)
 #    bash install.sh --claude --global  Claude Code, user scope
 #    bash install.sh --claude --project Claude Code, project scope
-#    bash install.sh --gemini           Gemini CLI
+#    bash install.sh --gemini           Gemini CLI / Antigravity (all skills)
+#    bash install.sh --gemini --profile core   Antigravity: core profile only (token budget)
+#    bash install.sh --windsurf --profile core  Same for project .windsurf/rules
 #    bash install.sh --aider            Aider
 #    bash install.sh --continue         Continue.dev
 #    bash install.sh --amazon-q         Amazon Q CLI (q)
 #    bash install.sh --amp              Amp
-#    bash install.sh --all              All detected platforms
+#    bash install.sh --all              All detected platforms (no interactive menu)
+#    bash install.sh --yes              Skip onboarding menu (with --gemini, etc.)
+#    bash install.sh --cursor --cursor-project   Force ./.cursor/rules (run from repo root)
 # ════════════════════════════════════════════════════════════════
 
 set -e
 
+# Directory containing this script (for skills/profiles when ~/.cody-master is stale)
+CM_SCRIPT_DIR=""
+_cm_src="${BASH_SOURCE[0]:-$0}"
+if [[ "$_cm_src" != /dev/fd/* ]] && [[ "$_cm_src" != /proc/self/fd/* ]]; then
+  CM_SCRIPT_DIR="$(cd "$(dirname "$_cm_src")" && pwd)"
+fi
+
 # ── Colors ──────────────────────────────────────────────────────
 G='\033[0;32m'; B='\033[0;34m'; P='\033[0;35m'; O='\033[0;33m'
 C='\033[0;36m'; R='\033[0;31m'; W='\033[1;37m'; NC='\033[0m'; BOLD='\033[1m'; DIM='\033[2m'
 
 REPO_URL="https://github.com/tody-agent/codymaster"
 RAW_URL="https://raw.githubusercontent.com/tody-agent/codymaster/main"
-VERSION="4.4.0"
+VERSION="4.7.0"
 SCOPE="user"   # default scope for Claude Code
+SKILL_PROFILE="full"   # core|growth|design|knowledge|full — see skills/profiles/
+INSTALL_CMD=""         # set by parse_install_args
+# Skip hamster onboarding menu (non-interactive / one-liner installs)
+SKIP_INSTALL_ONBOARDING=0
+# Force Cursor rules into ./.cursor/rules (run from repo root)
+CURSOR_RULES_PROJECT=0
 
 if [ -d "skills" ]; then
-  TOTAL_SKILLS=$(ls -1d skills/*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
+  TOTAL_SKILLS=$(ls -1d skills/cm-*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
 elif [ -d "$HOME/.cody-master/skills" ]; then
-  TOTAL_SKILLS=$(ls -1d "$HOME/.cody-master/skills"/*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
+  TOTAL_SKILLS=$(ls -1d "$HOME/.cody-master/skills"/cm-*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
 else
-  TOTAL_SKILLS="60+"
+  TOTAL_SKILLS="45"
 fi
 
 
@@ -55,7 +72,7 @@ msg() {
   local key="$1"
   case "$LANG_CODE:$key" in
     vi:welcome)   echo "Chào mừng bạn đến với CodyMaster v${VERSION}" ;;
-    vi:tagline)   echo "60+ kỹ năng AI cho Claude Code và các AI agents khác" ;;
+    vi:tagline)   echo "${TOTAL_SKILLS} kỹ năng AI cho Claude Code và các AI agents khác" ;;
     vi:detecting) echo "🔍 Đang phát hiện các AI agent đã cài..." ;;
     vi:found)     echo "✅ Đã tìm thấy" ;;
     vi:not_found) echo "❌ Không tìm thấy" ;;
@@ -66,9 +83,10 @@ msg() {
     vi:done)      echo "✅ Hoàn tất!" ;;
     vi:onboard)   echo "🎯 Bắt đầu ngay với AI Agent của bạn:" ;;
     vi:docs)      echo "📚 Tài liệu:" ;;
+    vi:press_enter) echo "Nhấn ENTER để tiếp tục" ;;
 
     zh:welcome)   echo "欢迎使用 CodyMaster v${VERSION}" ;;
-    zh:tagline)   echo "Claude Code 的 60+ AI 技能" ;;
+    zh:tagline)   echo "Claude Code 的 ${TOTAL_SKILLS} AI 技能" ;;
     zh:detecting) echo "🔍 检测已安装的 AI Agent..." ;;
     zh:found)     echo "✅ 已找到" ;;
     zh:not_found) echo "❌ 未找到" ;;
@@ -79,9 +97,10 @@ msg() {
     zh:done)      echo "✅ 完成！" ;;
     zh:onboard)   echo "🎯 立即开始与您的 AI Agent 合作:" ;;
     zh:docs)      echo "📚 文档:" ;;
+    zh:press_enter) echo "按 Enter 继续" ;;
 
     ko:welcome)   echo "CodyMaster v${VERSION}에 오신 것을 환영합니다" ;;
-    ko:tagline)   echo "Claude Code용 60+ AI 스킬" ;;
+    ko:tagline)   echo "Claude Code용 ${TOTAL_SKILLS} AI 스킬" ;;
     ko:detecting) echo "🔍 설치된 AI Agent 감지 중..." ;;
     ko:found)     echo "✅ 발견됨" ;;
     ko:not_found) echo "❌ 없음" ;;
@@ -92,11 +111,12 @@ msg() {
     ko:done)      echo "✅ 완료!" ;;
     ko:onboard)   echo "🎯 AI Agent와 즉시 시작하세요:" ;;
     ko:docs)      echo "📚 문서:" ;;
+    ko:press_enter) echo "Enter를 눌러 계속" ;;
 
     *)
       case "$key" in
         welcome)   echo "Welcome to CodyMaster v${VERSION}" ;;
-        tagline)   echo "60+ AI skills for Claude Code and other AI agents" ;;
+        tagline)   echo "${TOTAL_SKILLS} AI skills for Claude Code and other AI agents" ;;
         detecting) echo "🔍 Detecting installed AI agents..." ;;
         found)     echo "✅ Found" ;;
         not_found) echo "❌ Not found" ;;
@@ -107,6 +127,7 @@ msg() {
         done)      echo "✅ Done!" ;;
         onboard)   echo "🎯 Get started immediately with your AI Agent:" ;;
         docs)      echo "📚 Documentation:" ;;
+        press_enter) echo "Press ENTER to continue" ;;
       esac
       ;;
   esac
@@ -114,7 +135,7 @@ msg() {
 
 # ── Header ───────────────────────────────────────────────────────
 print_header() {
-  clear
+  clear 2>/dev/null || true
   hamster_sentiment "start"
   echo -e "    ${O}( . \ --- / . )${NC}"
   echo -e "     ${O}/${NC}   ${O}${BOLD}^   ^${NC}   ${O}\\\\${NC}"
@@ -491,12 +512,17 @@ install_claude() {
     # Cleanup old marketplace if exists
     claude plugin marketplace remove cody-master 2>/dev/null || true
     echo -e "  ${W}Adding marketplace...${NC}"
-    claude plugin marketplace add tody-agent/codymaster 2>/dev/null || true
+    if ! claude plugin marketplace add tody-agent/codymaster; then
+      echo -e "  ${R}⚠️  Marketplace add failed. Run:${NC} ${C}claude plugin marketplace add tody-agent/codymaster${NC}"
+    fi
     echo -e "  ${W}Installing plugin (scope: ${scope})...${NC}"
-    claude plugin install cm@codymaster --scope "$scope"
-    echo ""
-    echo -e "  ${G}✅ cm installed — scope: ${scope}${NC}"
-    print_onboarding "$scope"
+    if ! claude plugin install cm@codymaster --scope "$scope"; then
+      echo -e "  ${R}⚠️  Plugin install failed. Run:${NC} ${C}claude plugin install cm@codymaster --scope ${scope}${NC}"
+    else
+      echo ""
+      echo -e "  ${G}✅ Claude plugin installed — scope: ${scope}${NC}"
+    fi
+    maybe_print_onboarding
   else
     echo -e "  ${R}Claude Code CLI not found. Install from: https://claude.ai/code${NC}"
     echo ""
@@ -516,10 +542,11 @@ install_gemini() {
   echo ""
   target="$HOME/.gemini/antigravity/skills"
   install_skills_to "$target"
+  ensure_gemini_md_hint
   echo ""
   echo -e "  ${G}✅ Skills installed to ${target}${NC}"
-  echo -e "  ${C}ℹ  Add to your GEMINI.md: @~/.gemini/antigravity/skills/cm-skill-index/SKILL.md${NC}"
-  echo -e "  ${C}ℹ  Skills will auto-activate in Antigravity and Gemini CLI${NC}"
+  echo -e "  ${C}ℹ  GEMINI.md should reference: @~/.gemini/antigravity/skills/cm-skill-index/SKILL.md${NC}"
+  echo -e "  ${C}ℹ  Restart Gemini / Antigravity if it was open during install${NC}"
 }
 
 # ── Aider installer ──────────────────────────────────────────────
@@ -567,23 +594,49 @@ install_amp() {
   echo -e "  ${C}ℹ  Reference skills in Amp via your AGENTS.md or system prompt${NC}"
 }
 
-# ── CLI installer ────────────────────────────────────────────────
 install_cli() {
+  local auto="$1"
   if command -v npm &>/dev/null; then
     echo ""
-    echo -e "${G}${BOLD}CLI Dashboard — Installing Cody Master CLI${NC}"
+    echo -e "${G}${BOLD}CLI Dashboard — Cody Master CLI${NC}"
     echo ""
-    echo -e "  To get the full experience with the ${C}cm${NC} command and visual dashboard,"
-    echo -e "  it is recommended to install the global npm package."
+    echo -e "  ${C}Official paths:${NC}"
+    echo -e "    ${W}Per-project:${NC} ${C}npm install codymaster${NC}  →  ${C}npx cm${NC}"
+    echo -e "    ${W}Global:${NC}      ${C}npm install -g codymaster${NC}  →  ${C}cm${NC}"
     echo ""
-    read -p "  Install codymaster globally? (y/N): " install_npm
-    if [[ "$install_npm" =~ ^[Yy]$ ]]; then
-      echo -e "  ${W}Running: npm install -g codymaster${NC}"
-      npm install -g codymaster || echo -e "  ${O}Note: You might need sudo for global install: sudo npm install -g codymaster${NC}"
+    if [[ "$auto" == "--auto" ]]; then
+      echo -e "  ${W}Auto: trying global install (optional — use per-project + npx if you prefer).${NC}"
+      npm install -g codymaster || echo -e "  ${O}Global install failed (try: npm install codymaster in your repo, then npx cm).${NC}"
+      if [ -f "package.json" ]; then
+        if grep -q '"name": "codymaster"' package.json; then
+          npm link &>/dev/null || true
+        fi
+      fi
+    else
+      read -p "  Install codymaster globally now? (y/N): " install_npm
+      if [[ "$install_npm" =~ ^[Yy]$ ]]; then
+        echo -e "  ${W}Running: npm install -g codymaster${NC}"
+        npm install -g codymaster || echo -e "  ${O}Note: sudo may be needed, or use: npm install codymaster && npx cm${NC}"
+      fi
     fi
   fi
 }
 
+install_openviking() {
+  echo ""
+  echo -e "${G}${BOLD}OpenViking — Installing Core Feature${NC}"
+  echo ""
+  if command -v pip3 &>/dev/null; then
+    echo -e "  ${W}Running: pip3 install openviking${NC}"
+    pip3 install openviking || echo -e "  ${O}⚠️ Could not install OpenViking automatically.${NC}"
+  elif command -v pip &>/dev/null; then
+    echo -e "  ${W}Running: pip install openviking${NC}"
+    pip install openviking || echo -e "  ${O}⚠️ Could not install OpenViking automatically.${NC}"
+  else
+    echo -e "  ${R}Python pip not found. Please install pip to get OpenViking.${NC}"
+  fi
+}
+
 # ── Ensure clone exists ──────────────────────────────────────────
 CLONE_DIR=""
 ensure_clone() {
@@ -602,12 +655,17 @@ ensure_clone() {
   # Clone the repo
   echo -e "  ${W}Cloning CodyMaster to ~/.cody-master...${NC}"
   git clone --depth 1 "${REPO_URL}.git" "$HOME/.cody-master" 2>/dev/null || {
+
     echo -e "  ${R}Error: Failed to clone ${REPO_URL}${NC}"
     echo -e "  ${R}Check your internet connection and try again.${NC}"
     exit 1
   }
   CLONE_DIR="$HOME/.cody-master"
   echo -e "  ${G}✅ Cloned to ~/.cody-master${NC}"
+  # Update total skills after pulling down new repo
+  if [ -d "$CLONE_DIR/skills" ]; then
+    TOTAL_SKILLS=$(ls -1d "$CLONE_DIR/skills"/cm-*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
+  fi
 }
 
 # ── Copy skills to target directory ──────────────────────────────
@@ -617,12 +675,50 @@ install_skills_to() {
   ensure_clone
   echo ""
   echo -e "${G}${BOLD}Installing skills to: ${target}${NC}"
+  if [[ -n "${SKILL_PROFILE:-}" && "$SKILL_PROFILE" != "full" ]]; then
+    echo -e "  ${C}Profile: ${SKILL_PROFILE}${NC}"
+  fi
   echo ""
   mkdir -p "$target"
   local count=0
   local installed=()
-  for skill_dir in "${CLONE_DIR}"/skills/*/; do
+  local -a allow=()
+  local use_profile=0
+  if [[ -n "${SKILL_PROFILE:-}" && "$SKILL_PROFILE" != "full" ]]; then
+    local pf="${CLONE_DIR}/skills/profiles/${SKILL_PROFILE}.txt"
+    if [[ ! -f "$pf" && -n "${CM_SCRIPT_DIR}" && -f "${CM_SCRIPT_DIR}/skills/profiles/${SKILL_PROFILE}.txt" ]]; then
+      pf="${CM_SCRIPT_DIR}/skills/profiles/${SKILL_PROFILE}.txt"
+    fi
+    if [[ ! -f "$pf" ]]; then
+      echo -e "  ${R}Unknown profile '${SKILL_PROFILE}'. Valid: core, growth, design, knowledge, full${NC}"
+      echo -e "  ${R}Expected: \${CLONE_DIR}/skills/profiles/${SKILL_PROFILE}.txt (git pull ~/.cody-master or run install.sh from repo)${NC}"
+      exit 1
+    fi
+    use_profile=1
+    while IFS= read -r line || [[ -n "$line" ]]; do
+      [[ "$line" =~ ^[[:space:]]*# ]] && continue
+      line="${line%%#*}"
+      line="${line#"${line%%[![:space:]]*}"}"
+      line="${line%"${line##*[![:space:]]}"}"
+      [[ -z "$line" ]] && continue
+      allow+=("$line")
+    done < "$pf"
+  fi
+  for skill_dir in "${CLONE_DIR}"/skills/cm-*/; do
     skill_name=$(basename "$skill_dir")
+    if [[ "$use_profile" -eq 1 ]]; then
+      local found=0
+      local a
+      for a in "${allow[@]}"; do
+        if [[ "$a" == "$skill_name" ]]; then
+          found=1
+          break
+        fi
+      done
+      if [[ "$found" -eq 0 ]]; then
+        continue
+      fi
+    fi
     if [ -f "${skill_dir}SKILL.md" ]; then
       if [[ "$format" == "mdc" ]]; then
         # Create Cursor glob native format
@@ -679,6 +775,109 @@ select_scope() {
   esac
 }
 
+# ── Cursor rules path: avoid writing to a random cwd (e.g. /tmp) ──
+resolve_cursor_rules_dir() {
+  local mode="${1:-cursor}"
+  if [[ "$mode" == "all" ]]; then
+    printf '%s' "${HOME}/.cursor/rules"
+    return
+  fi
+  if [[ "$CURSOR_RULES_PROJECT" == "1" ]]; then
+    printf '%s' ".cursor/rules"
+    return
+  fi
+  if [[ -d .git ]] || [[ -f package.json ]]; then
+    printf '%s' ".cursor/rules"
+  else
+    printf '%s' "${HOME}/.cursor/rules"
+  fi
+}
+
+# ── Gemini: ensure GEMINI.md points at skill index ───────────────
+ensure_gemini_md_hint() {
+  mkdir -p "${HOME}/.gemini" 2>/dev/null || true
+  local f="${HOME}/.gemini/GEMINI.md"
+  local hint="@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md"
+  if [[ ! -f "$f" ]]; then
+    {
+      echo "# Gemini CLI / Antigravity"
+      echo "# CodyMaster: load the progressive skill index first (then pull full skills as needed)"
+      echo "$hint"
+    } > "$f"
+    echo -e "  ${G}✅ Created ${f} with skill index line${NC}"
+    return
+  fi
+  if ! grep -q "cm-skill-index" "$f" 2>/dev/null; then
+    {
+      echo ""
+      echo "# CodyMaster — skill index"
+      echo "$hint"
+    } >> "$f"
+    echo -e "  ${G}✅ Appended CodyMaster skill index to ${f}${NC}"
+  fi
+}
+
+maybe_print_onboarding() {
+  [[ "$SKIP_INSTALL_ONBOARDING" == "1" ]] && return 0
+  print_onboarding
+}
+
+print_all_done_summary() {
+  echo ""
+  echo -e "${W}${BOLD}═══ Next steps — verify each tool you use ═══${NC}"
+  echo ""
+  echo -e "  ${BOLD}Claude Code:${NC} Open Claude Code → ${C}/cm:demo${NC} or ${C}/help${NC}. If the plugin is missing:"
+  echo -e "    ${C}claude plugin marketplace add tody-agent/codymaster${NC}"
+  echo -e "    ${C}claude plugin install cm@codymaster --scope user${NC}"
+  echo ""
+  echo -e "  ${BOLD}Gemini / Antigravity:${NC} Skills → ${C}~/.gemini/antigravity/skills/${NC}"
+  echo -e "    ${C}~/.gemini/GEMINI.md${NC} should include ${C}@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md${NC}"
+  echo ""
+  echo -e "  ${BOLD}Cursor IDE:${NC} Rules → ${C}${HOME}/.cursor/rules${NC} ${DIM}(from one-liner --all)${NC}"
+  echo -e "    Agent chat: ${C}/add-plugin cody-master${NC}"
+  echo -e "    Project-only rules: ${C}cd your-repo && bash install.sh --cursor --cursor-project${NC}"
+  echo ""
+  echo -e "  ${BOLD}Terminal CLI:${NC} ${C}npm install -g codymaster${NC} → ${C}cm${NC}   |   ${C}npm install codymaster${NC} → ${C}npx cm${NC}"
+  echo ""
+  echo -e "  ${BOLD}Skill sources:${NC} ${C}~/.cody-master/skills/${NC}"
+  echo ""
+}
+
+# ── Parse argv: --profile NAME + first platform flag ────────────
+parse_install_args() {
+  INSTALL_CMD=""
+  local args=("$@")
+  local i=0
+  while [[ $i -lt ${#args[@]} ]]; do
+    local a="${args[i]}"
+    case "$a" in
+      --profile)
+        SKILL_PROFILE="${args[i+1]:-full}"
+        ((i+=2))
+        continue
+        ;;
+    esac
+    if [[ -z "$INSTALL_CMD" ]]; then
+      case "$a" in
+        --claude)       INSTALL_CMD="claude" ;;
+        --gemini|--antigravity) INSTALL_CMD="gemini" ;;
+        --cursor)       INSTALL_CMD="cursor" ;;
+        --aider)        INSTALL_CMD="aider" ;;
+        --continue)     INSTALL_CMD="continue" ;;
+        --amazon-q)     INSTALL_CMD="amazon-q" ;;
+        --amp)          INSTALL_CMD="amp" ;;
+        --kiro)         INSTALL_CMD="kiro" ;;
+        --windsurf)     INSTALL_CMD="windsurf" ;;
+        --cline)        INSTALL_CMD="cline" ;;
+        --opencode)     INSTALL_CMD="opencode" ;;
+        --copilot)      INSTALL_CMD="copilot" ;;
+        --all)          INSTALL_CMD="all" ;;
+      esac
+    fi
+    ((i++)) || true
+  done
+}
+
 # ════════════════════════════════════════════════════════════════
 #  MAIN
 # ════════════════════════════════════════════════════════════════
@@ -690,92 +889,111 @@ for arg in "$@"; do
   case "$arg" in
     --global|--user)   SCOPE="user" ;;
     --project|--local) SCOPE="project" ;;
+    --yes|-y)           SKIP_INSTALL_ONBOARDING=1 ;;
+    --cursor-project)   CURSOR_RULES_PROJECT=1 ;;
   esac
 done
 
-if [[ "$1" == "--claude" ]]; then
+parse_install_args "$@"
+
+# One-liner full install should finish without the interactive onboarding menu
+if [[ "$INSTALL_CMD" == "all" ]]; then
+  SKIP_INSTALL_ONBOARDING=1
+fi
+
+if [[ "$INSTALL_CMD" == "claude" ]]; then
   install_claude "$SCOPE"
   exit 0
 fi
 
-if [[ "$1" == "--gemini" ]] || [[ "$1" == "--antigravity" ]]; then
+if [[ "$INSTALL_CMD" == "gemini" ]]; then
   install_gemini
-  print_onboarding
+  if [[ -n "${SKILL_PROFILE:-}" && "$SKILL_PROFILE" != "full" ]]; then
+    echo -e "  ${C}ℹ  Add more skills: bash install.sh --gemini --profile growth (same target merges new folders)${NC}"
+    echo -e "  ${C}ℹ  Point GEMINI.md at: @~/.gemini/antigravity/skills/cm-skill-index/SKILL.md${NC}"
+  fi
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--cursor" ]]; then
+if [[ "$INSTALL_CMD" == "cursor" ]]; then
   echo ""
   echo -e "${B}${BOLD}Cursor — Installing Cody Master${NC}"
   echo ""
-  target=".cursor/rules"
+  target="$(resolve_cursor_rules_dir cursor)"
   install_skills_to "$target" "mdc"
-  echo -e "  ${C}ℹ  Cursor will automatically load .mdc rules from this project${NC}"
-  print_onboarding
+  echo -e "  ${C}ℹ  Cursor rules installed to: ${BOLD}${target}${NC}"
+  echo -e "  ${C}ℹ  Reopen Cursor or open a workspace folder. Also try Agent: ${BOLD}/add-plugin cody-master${NC}"
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--aider" ]]; then
+if [[ "$INSTALL_CMD" == "aider" ]]; then
   install_aider
-  print_onboarding
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--continue" ]]; then
+if [[ "$INSTALL_CMD" == "continue" ]]; then
   install_continue
-  print_onboarding
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--amazon-q" ]]; then
+if [[ "$INSTALL_CMD" == "amazon-q" ]]; then
   install_amazon_q
-  print_onboarding
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--amp" ]]; then
+if [[ "$INSTALL_CMD" == "amp" ]]; then
   install_amp
-  print_onboarding
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--kiro" ]]; then
+if [[ "$INSTALL_CMD" == "kiro" ]]; then
   echo ""
   echo -e "${O}${BOLD}Kiro — Installing Cody Master${NC}"
   echo ""
   install_skills_to ".kiro/steering" "raw"
-  print_onboarding
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--windsurf" ]]; then
+if [[ "$INSTALL_CMD" == "windsurf" ]]; then
   echo ""
   echo -e "${O}${BOLD}Windsurf — Installing Cody Master${NC}"
   echo ""
+  echo -e "  ${C}ℹ  This writes to project ${BOLD}.windsurf/rules${NC}${C} (run from repo root).${NC}"
+  echo -e "  ${C}ℹ  Some Windsurf builds also use global skills under Codeium paths — use the same profile flags if you copy there.${NC}"
   install_skills_to ".windsurf/rules" "raw"
-  print_onboarding
+  if [[ -n "${SKILL_PROFILE:-}" && "$SKILL_PROFILE" != "full" ]]; then
+    echo -e "  ${C}ℹ  Add more: bash install.sh --windsurf --profile growth${NC}"
+  fi
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--cline" ]]; then
+if [[ "$INSTALL_CMD" == "cline" ]]; then
   echo ""
   echo -e "${O}${BOLD}Cline/RooCode — Installing Cody Master${NC}"
   echo ""
   install_skills_to ".cline/skills" "raw"
-  print_onboarding
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--opencode" ]]; then
+if [[ "$INSTALL_CMD" == "opencode" ]]; then
   echo ""
   echo -e "${G}${BOLD}OpenCode — Installing Cody Master${NC}"
   echo ""
   install_skills_to ".opencode/skills" "raw"
-  print_onboarding
+  maybe_print_onboarding
   exit 0
 fi
 
-if [[ "$1" == "--copilot" ]]; then
+if [[ "$INSTALL_CMD" == "copilot" ]]; then
   echo ""
   echo -e "${G}${BOLD}GitHub Copilot — Installing Cody Master${NC}"
   echo ""
@@ -784,7 +1002,7 @@ if [[ "$1" == "--copilot" ]]; then
   exit 0
 fi
 
-if [[ "$1" == "--all" ]]; then
+if [[ "$INSTALL_CMD" == "all" ]]; then
   echo -e "${W}${BOLD}Installing to all detected platforms...${NC}"
   echo ""
   command -v claude &>/dev/null && install_claude "$SCOPE"
@@ -794,10 +1012,16 @@ if [[ "$1" == "--all" ]]; then
   command -v q      &>/dev/null && install_amazon_q
   command -v amp    &>/dev/null && install_amp
   [ -d "$HOME/.cursor" ] || [ -d "/Applications/Cursor.app" ] && {
-    install_skills_to ".cursor/rules" "mdc"
+    _cm_cursor_rules="$(resolve_cursor_rules_dir all)"
+    echo -e "  ${W}Cursor → ${_cm_cursor_rules} ${DIM}(not your current shell cwd)${NC}"
+    install_skills_to "${_cm_cursor_rules}" "mdc"
   }
-  install_cli
-  print_onboarding
+  install_openviking
+  install_cli "--auto"
+  echo ""
+  echo -e "${G}${BOLD}✅ All installations completed!${NC}"
+  echo -e "${C}$(msg docs) https://cody.todyle.com/docs${NC}"
+  print_all_done_summary
   exit 0
 fi
 
@@ -844,8 +1068,11 @@ for platform in "${platforms[@]}"; do
       ;;
     cursor)
       echo ""
-      echo -e "${B}${BOLD}Cursor — Plugin Install${NC}"
-      echo -e "  In Cursor Agent chat, run: ${C}/add-plugin cm${NC}"
+      echo -e "${B}${BOLD}Cursor — Rules + plugin${NC}"
+      _cm_cursor_rules="$(resolve_cursor_rules_dir cursor)"
+      install_skills_to "${_cm_cursor_rules}" "mdc"
+      echo -e "  ${C}ℹ  Rules → ${_cm_cursor_rules}${NC}"
+      echo -e "  In Cursor Agent chat: ${C}/add-plugin cody-master${NC}"
       ;;
     codex)
       echo ""
@@ -889,6 +1116,7 @@ for platform in "${platforms[@]}"; do
   esac
 done
 
+install_openviking
 install_cli
 print_onboarding
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codymaster",
-  "version": "4.5.4",
+  "version": "4.8.0",
   "description": "68+ Skills. Ship 10x faster. AI-powered coding skill kit for Claude, Cursor, Gemini & more.",
   "main": "dist/index.js",
   "repository": {
@@ -19,15 +19,23 @@
     "build": "tsc",
     "start": "ts-node src/index.ts",
     "test:gate": "vitest run --reporter=verbose",
+    "test:gate:kit": "npm run build && npm run validate:skills && npm run check:skills && vitest run --reporter=verbose",
     "gate:secrets": "node scripts/gate-0-secrets.js",
+    "gate:hygiene": "node scripts/gate-0-repo-hygiene.js",
     "gate:fix": "node scripts/security-fixer.js --fix",
     "gate:check": "node scripts/security-fixer.js",
     "gate:syntax": "node scripts/gate-1-syntax.js",
     "gate:dist": "node scripts/gate-5-dist-verify.js",
     "gate:smoke": "node scripts/gate-6-smoke-test.js",
-    "deploy": "npm run gate:secrets && npm run gate:syntax && npm run test:gate && npm run gate:dist && npm run gate:smoke",
-    "deploy:dry": "npm run gate:secrets && npm run gate:syntax && npm run test:gate && npm run gate:dist && echo '✅ All gates passed. Ready to deploy.'",
-    "postinstall": "node scripts/postinstall.js"
+    "deploy": "npm run gate:secrets && npm run gate:hygiene && npm run gate:syntax && npm run test:gate:kit && npm run gate:dist && npm run gate:smoke",
+    "deploy:dry": "npm run gate:secrets && npm run gate:hygiene && npm run gate:syntax && npm run test:gate:kit && npm run gate:dist && echo '✅ All gates passed. Ready to deploy.'",
+    "postinstall": "node scripts/postinstall.js",
+    "validate:skills": "node scripts/validate-skills.mjs",
+    "build:skills": "node scripts/build-skills.mjs",
+    "check:skills": "node scripts/build-skills.mjs --check",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   },
   "keywords": [
     "ai",
@@ -65,7 +73,8 @@
     "chokidar": "^5.0.0",
     "commander": "^14.0.3",
     "express": "^5.2.1",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -74,8 +83,10 @@
     "@types/prompts": "^2.4.9",
     "acorn": "^8.16.0",
     "jsdom": "^29.0.1",
+    "playwright": "^1.50.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
     "vitest": "^4.1.0"
   },
   "overrides": {