@clix-so/clix-agent-skills 0.1.1

package/skills/integration/scripts/install-mcp.sh

@@ -0,0 +1,244 @@
+#!/usr/bin/env bash
+#
+# Clix MCP Server Installer
+#
+# Usage:
+#   bash scripts/install-mcp.sh
+#
+
+set -euo pipefail
+
+BLUE='\033[34m'
+GREEN='\033[32m'
+RED='\033[31m'
+YELLOW='\033[33m'
+RESET='\033[0m'
+
+log() {
+  printf "%b\n" "$1"
+}
+
+# Detect platform
+detect_platform() {
+  case "$(uname -s)" in
+    Darwin*) echo "darwin" ;;
+    Linux*) echo "linux" ;;
+    MINGW*|MSYS*|CYGWIN*) echo "win32" ;;
+    *) echo "unknown" ;;
+  esac
+}
+
+# Get config path for different clients
+get_config_path() {
+  local client=$1
+  local home="${HOME:-$HOME}"
+  local platform=$(detect_platform)
+
+  case "$client" in
+    codex)
+      echo "${home}/.codex/config.toml"
+      ;;
+    cursor)
+      # Check project-level first
+      if [ -f ".cursor/mcp.json" ]; then
+        echo ".cursor/mcp.json"
+      else
+        echo "${home}/.cursor/mcp.json"
+      fi
+      ;;
+    claude)
+      if [ "$platform" = "darwin" ]; then
+        echo "${home}/Library/Application Support/Claude/claude_desktop_config.json"
+      elif [ "$platform" = "win32" ]; then
+        echo "${APPDATA:-}/Claude/claude_desktop_config.json"
+      else
+        echo "${home}/.config/claude/claude_desktop_config.json"
+      fi
+      ;;
+    vscode)
+      echo "${home}/.vscode/mcp.json"
+      ;;
+    *)
+      echo ""
+      ;;
+  esac
+}
+
+# Configure MCP for Codex (TOML format)
+configure_codex() {
+  local config_path="$1"
+  local config_dir=$(dirname "$config_path")
+
+  mkdir -p "$config_dir"
+
+  if [ ! -f "$config_path" ]; then
+    cat > "$config_path" <<'EOF'
+[mcp_servers]
+EOF
+    log "${GREEN}✔ Created Codex config file${RESET}"
+  fi
+
+  # Check if already configured
+  if grep -q "clix-mcp-server" "$config_path" 2>/dev/null; then
+    log "${GREEN}✔ Clix MCP Server already configured in Codex${RESET}"
+    return 0
+  fi
+
+  # If user previously configured Codex under a different name (e.g. "clix"),
+  # tools will appear as "clix:*" instead of the expected "clix-mcp-server:*".
+  # We add the correct server name, but also warn.
+  if grep -q "\[mcp_servers\.clix\]" "$config_path" 2>/dev/null && \
+     grep -q "@clix-so/clix-mcp-server" "$config_path" 2>/dev/null; then
+    log "${YELLOW}⚠️  Found an existing Codex MCP entry named \"clix\".${RESET}"
+    log "${YELLOW}   This makes tools show up as \"clix:*\" (not \"clix-mcp-server:*\").${RESET}"
+    log "${YELLOW}   Adding the correct \"clix-mcp-server\" entry now.${RESET}"
+  fi
+
+  # Add configuration
+  if grep -q "\[mcp_servers\]" "$config_path"; then
+    # Append to existing [mcp_servers] section
+    cat >> "$config_path" <<'EOF'
+
+  [mcp_servers."clix-mcp-server"]
+  command = "npx"
+  args = ["-y", "@clix-so/clix-mcp-server@latest"]
+EOF
+  else
+    # Create new section
+    cat >> "$config_path" <<'EOF'
+[mcp_servers]
+  [mcp_servers."clix-mcp-server"]
+  command = "npx"
+  args = ["-y", "@clix-so/clix-mcp-server@latest"]
+EOF
+  fi
+
+  log "${GREEN}✔ Configured Clix MCP Server in Codex config${RESET}"
+}
+
+# Configure MCP for JSON-based clients
+configure_json_client() {
+  local config_path="$1"
+  local config_dir=$(dirname "$config_path")
+
+  mkdir -p "$config_dir"
+
+  if [ ! -f "$config_path" ]; then
+    echo '{"mcpServers": {}}' > "$config_path"
+    log "${GREEN}✔ Created config file${RESET}"
+  fi
+
+  # Check if already configured
+  if grep -q "clix-mcp-server" "$config_path" 2>/dev/null; then
+    log "${GREEN}✔ Clix MCP Server already configured${RESET}"
+    return 0
+  fi
+
+  # Use node to safely update JSON
+  if command -v node &> /dev/null; then
+    node <<EOF
+const fs = require('fs');
+const path = '$config_path';
+const config = JSON.parse(fs.readFileSync(path, 'utf8'));
+if (!config.mcpServers) config.mcpServers = {};
+config.mcpServers['clix-mcp-server'] = {
+  command: 'npx',
+  args: ['-y', '@clix-so/clix-mcp-server@latest']
+};
+fs.writeFileSync(path, JSON.stringify(config, null, 2) + '\n');
+EOF
+    log "${GREEN}✔ Configured Clix MCP Server${RESET}"
+  else
+    log "${YELLOW}⚠️  Node.js not found. Please manually add to $config_path:${RESET}"
+    log "${BLUE}{${RESET}"
+    log "${BLUE}  \"mcpServers\": {${RESET}"
+    log "${BLUE}    \"clix-mcp-server\": {${RESET}"
+    log "${BLUE}      \"command\": \"npx\",${RESET}"
+    log "${BLUE}      \"args\": [\"-y\", \"@clix-so/clix-mcp-server@latest\"]${RESET}"
+    log "${BLUE}    }${RESET}"
+    log "${BLUE}  }${RESET}"
+    log "${BLUE}}${RESET}"
+  fi
+}
+
+# Auto-detect client
+detect_client() {
+  # Check for Codex
+  if [ -f "${HOME}/.codex/config.toml" ] || command -v codex &> /dev/null; then
+    echo "codex"
+    return
+  fi
+
+  # Check for Cursor
+  if [ -f "${HOME}/.cursor/mcp.json" ] || [ -f ".cursor/mcp.json" ]; then
+    echo "cursor"
+    return
+  fi
+
+  # Check for Claude Desktop
+  if [ -f "${HOME}/Library/Application Support/Claude/claude_desktop_config.json" ] 2>/dev/null || \
+     [ -f "${APPDATA:-}/Claude/claude_desktop_config.json" ] 2>/dev/null; then
+    echo "claude"
+    return
+  fi
+
+  # Check for VS Code
+  if [ -f "${HOME}/.vscode/mcp.json" ]; then
+    echo "vscode"
+    return
+  fi
+
+  echo "unknown"
+}
+
+log "${BLUE}📦 Installing Clix MCP Server...${RESET}"
+
+# Check for npm
+if ! command -v npm &> /dev/null; then
+  log "${RED}❌ npm is not installed or not in PATH.${RESET}"
+  log "${YELLOW}Please install Node.js and npm first: https://nodejs.org/${RESET}"
+  exit 1
+fi
+
+# Install package (using npx, no need for global install)
+log "${BLUE}Verifying @clix-so/clix-mcp-server is available...${RESET}"
+if npm view @clix-so/clix-mcp-server@latest version &> /dev/null; then
+  log "${GREEN}✅ Package is available${RESET}"
+else
+  log "${RED}❌ Package not found on npm${RESET}"
+  exit 1
+fi
+
+# Auto-detect and configure
+log "${BLUE}🔍 Detecting MCP client...${RESET}"
+detected_client=$(detect_client)
+
+if [ "$detected_client" != "unknown" ]; then
+  log "${GREEN}Detected: $detected_client${RESET}"
+  config_path=$(get_config_path "$detected_client")
+
+  if [ -n "$config_path" ]; then
+    log "${BLUE}Configuring MCP server for $detected_client...${RESET}"
+
+    if [ "$detected_client" = "codex" ]; then
+      configure_codex "$config_path"
+    else
+      configure_json_client "$config_path"
+    fi
+
+    log "${GREEN}✅ Successfully configured Clix MCP Server!${RESET}"
+    log "${YELLOW}⚠️  IMPORTANT: Please RESTART $detected_client for the changes to take effect.${RESET}"
+  else
+    log "${YELLOW}⚠️  Could not determine config path for $detected_client${RESET}"
+    log "${YELLOW}Please configure manually. See references/mcp-integration.md for instructions.${RESET}"
+  fi
+else
+  log "${YELLOW}⚠️  Could not auto-detect MCP client.${RESET}"
+  log "${BLUE}The package is ready to use. Configure manually:${RESET}"
+  log "${BLUE}  - Codex: Add to ~/.codex/config.toml${RESET}"
+  log "${BLUE}  - Cursor: Add to .cursor/mcp.json or ~/.cursor/mcp.json${RESET}"
+  log "${BLUE}  - Claude Desktop: Add to config file${RESET}"
+  log "${BLUE}See references/mcp-integration.md for detailed instructions.${RESET}"
+fi
+
+log "${GREEN}✅ Setup complete!${RESET}"

package/skills/integration/scripts/validate-sdk.sh

@@ -0,0 +1,380 @@
+#!/usr/bin/env bash
+#
+# Clix SDK Validation Script (bash)
+#
+# Validates that Clix SDK is properly installed and initialized for mobile platforms:
+# - iOS (Swift Package Manager or CocoaPods)
+# - Android (Gradle)
+# - Flutter (pubspec.yaml)
+# - React Native (package.json)
+#
+# Usage:
+#   bash scripts/validate-sdk.sh
+#   bash scripts/validate-sdk.sh --check-install
+#   bash scripts/validate-sdk.sh --check-init
+#
+# Exit codes:
+#   0 = success
+#   1 = validation failed
+
+set -euo pipefail
+
+BLUE='\033[34m'
+GREEN='\033[32m'
+YELLOW='\033[33m'
+RED='\033[31m'
+RESET='\033[0m'
+
+log() {
+  # shellcheck disable=SC2059
+  printf "%b\n" "$1"
+}
+
+die() {
+  log "${RED}❌ $1${RESET}"
+  exit 1
+}
+
+usage() {
+  cat <<'EOF'
+Clix SDK Validation Script (bash)
+
+Usage:
+  bash scripts/validate-sdk.sh [--check-install] [--check-init]
+
+If no flags are provided, all checks run.
+
+Checks:
+  --check-install  Validate Clix SDK dependency is present (iOS Podfile/Package.swift, Android build.gradle.kts, Flutter pubspec.yaml, React Native package.json)
+  --check-init     Search platform-specific entrypoints for Clix.initialize(...) calls
+
+EOF
+}
+
+detect_platform() {
+  if [[ -f "Podfile" ]] || [[ -f "Package.swift" ]] || find . -maxdepth 2 -name "*.xcodeproj" -o -name "*.xcworkspace" 2>/dev/null | grep -q .; then
+    echo "ios"
+  elif [[ -f "build.gradle.kts" ]] || [[ -f "build.gradle" ]] || [[ -f "settings.gradle.kts" ]] || [[ -f "settings.gradle" ]]; then
+    echo "android"
+  elif [[ -f "pubspec.yaml" ]]; then
+    echo "flutter"
+  elif [[ -f "package.json" ]] && (grep -q "react-native" package.json 2>/dev/null || [[ -d "ios" ]] && [[ -d "android" ]]); then
+    echo "react-native"
+  else
+    echo "unknown"
+  fi
+}
+
+check_install_ios() {
+  log "${BLUE}📦 Checking iOS SDK installation...${RESET}"
+  
+  local found=0
+  
+  # Check CocoaPods Podfile
+  if [[ -f "Podfile" ]] || [[ -f "ios/Podfile" ]]; then
+    local podfile="${PODFILE:-Podfile}"
+    [[ -f "ios/Podfile" ]] && podfile="ios/Podfile"
+    
+    if grep -Eq "pod\s+['\"]ClixSDK['\"]|pod\s+['\"]Clix['\"]|:git\s*=>\s*['\"].*clix-ios-sdk" "$podfile" 2>/dev/null; then
+      log "${GREEN}✓ Clix SDK found in Podfile${RESET}"
+      found=1
+    fi
+  fi
+  
+  # Check Swift Package Manager (Package.swift or Xcode project)
+  if [[ -f "Package.swift" ]]; then
+    if grep -Eq "clix-ios-sdk|github.com/clix-so/clix-ios-sdk" Package.swift 2>/dev/null; then
+      log "${GREEN}✓ Clix SDK found in Package.swift${RESET}"
+      found=1
+    fi
+  fi
+  
+  if [[ "$found" -eq 0 ]]; then
+    log "${RED}✗ Clix SDK not found in Podfile or Package.swift${RESET}"
+    log "${YELLOW}  iOS: Add 'pod \"ClixSDK\"' to Podfile or add package via Xcode${RESET}"
+    return 1
+  fi
+  
+  return 0
+}
+
+check_install_android() {
+  log "${BLUE}📦 Checking Android SDK installation...${RESET}"
+  
+  local found=0
+  local gradle_files=()
+  
+  # Find build.gradle.kts or build.gradle files
+  if [[ -f "app/build.gradle.kts" ]]; then
+    gradle_files+=("app/build.gradle.kts")
+  elif [[ -f "build.gradle.kts" ]]; then
+    gradle_files+=("build.gradle.kts")
+  elif [[ -f "app/build.gradle" ]]; then
+    gradle_files+=("app/build.gradle")
+  elif [[ -f "build.gradle" ]]; then
+    gradle_files+=("build.gradle")
+  fi
+  
+  for gradle_file in "${gradle_files[@]}"; do
+    if grep -Eq "so\.clix:clix-android-sdk|so\.clix:clix-android-sdk" "$gradle_file" 2>/dev/null; then
+      log "${GREEN}✓ Clix SDK found in ${gradle_file}${RESET}"
+      found=1
+      break
+    fi
+  done
+  
+  if [[ "$found" -eq 0 ]]; then
+    log "${RED}✗ Clix SDK not found in build.gradle files${RESET}"
+    log "${YELLOW}  Android: Add 'implementation(\"so.clix:clix-android-sdk:1.X.X\")' to build.gradle.kts${RESET}"
+    return 1
+  fi
+  
+  return 0
+}
+
+check_install_flutter() {
+  log "${BLUE}📦 Checking Flutter SDK installation...${RESET}"
+  
+  if [[ ! -f "pubspec.yaml" ]]; then
+    log "${YELLOW}⚠️  No pubspec.yaml found${RESET}"
+    return 0
+  fi
+  
+  if grep -Eq "clix_flutter:" pubspec.yaml 2>/dev/null; then
+    log "${GREEN}✓ clix_flutter found in pubspec.yaml${RESET}"
+    return 0
+  else
+    log "${RED}✗ clix_flutter not found in pubspec.yaml${RESET}"
+    log "${YELLOW}  Flutter: Add 'clix_flutter: ^0.0.1' to pubspec.yaml dependencies${RESET}"
+    return 1
+  fi
+}
+
+check_install_react_native() {
+  log "${BLUE}📦 Checking React Native SDK installation...${RESET}"
+  
+  if [[ ! -f "package.json" ]]; then
+    log "${YELLOW}⚠️  No package.json found${RESET}"
+    return 0
+  fi
+  
+  if grep -Eq "@clix-so/react-native-sdk" package.json 2>/dev/null; then
+    log "${GREEN}✓ @clix-so/react-native-sdk found in package.json${RESET}"
+    return 0
+  else
+    log "${RED}✗ @clix-so/react-native-sdk not found in package.json${RESET}"
+    log "${YELLOW}  React Native: Run 'npm install @clix-so/react-native-sdk'${RESET}"
+    return 1
+  fi
+}
+
+check_init_ios() {
+  log "${BLUE}🔍 Checking iOS SDK initialization...${RESET}"
+  
+  local entrypoints=(
+    "AppDelegate.swift"
+    "ios/AppDelegate.swift"
+    "Sources/AppDelegate.swift"
+    "*.swift"
+  )
+  
+  # Search for Clix.initialize in Swift files
+  local found=0
+  while IFS= read -r -d '' file; do
+    if grep -Eq "Clix\.initialize|ClixConfiguration\.shared\.config" "$file" 2>/dev/null; then
+      log "${GREEN}✓ Found initialization in ${file}${RESET}"
+      found=1
+      break
+    fi
+  done < <(find . -maxdepth 4 -name "AppDelegate.swift" -o -name "*App*.swift" 2>/dev/null | head -5 | tr '\n' '\0' 2>/dev/null || true)
+  
+  if [[ "$found" -eq 0 ]]; then
+    log "${YELLOW}⚠️  SDK initialization not found in AppDelegate or app entry point${RESET}"
+    log "${YELLOW}  iOS: Ensure Clix.initialize(config: ClixConfiguration.shared.config) is called in AppDelegate${RESET}"
+    return 1
+  fi
+  
+  return 0
+}
+
+check_init_android() {
+  log "${BLUE}🔍 Checking Android SDK initialization...${RESET}"
+  
+  local entrypoints=(
+    "src/main/kotlin/**/Application.kt"
+    "src/main/java/**/Application.java"
+  )
+  
+  local found=0
+  while IFS= read -r -d '' file; do
+    if grep -Eq "Clix\.initialize|so\.clix\.core\.Clix" "$file" 2>/dev/null; then
+      log "${GREEN}✓ Found initialization in ${file}${RESET}"
+      found=1
+      break
+    fi
+  done < <(find . -path "*/src/main/kotlin/*/*Application.kt" -o -path "*/src/main/java/*/*Application.java" 2>/dev/null | head -5 | tr '\n' '\0' 2>/dev/null || true)
+  
+  if [[ "$found" -eq 0 ]]; then
+    log "${YELLOW}⚠️  SDK initialization not found in Application class${RESET}"
+    log "${YELLOW}  Android: Ensure Clix.initialize(applicationContext, config) is called in Application.onCreate()${RESET}"
+    return 1
+  fi
+  
+  return 0
+}
+
+check_init_flutter() {
+  log "${BLUE}🔍 Checking Flutter SDK initialization...${RESET}"
+  
+  local entrypoints=(
+    "lib/main.dart"
+  )
+  
+  if [[ -f "lib/main.dart" ]]; then
+    if grep -Eq "Clix\.initialize|clix_flutter" lib/main.dart 2>/dev/null; then
+      log "${GREEN}✓ Found initialization in lib/main.dart${RESET}"
+      return 0
+    fi
+  fi
+  
+  log "${YELLOW}⚠️  SDK initialization not found in lib/main.dart${RESET}"
+  log "${YELLOW}  Flutter: Ensure await Clix.initialize(config) is called before runApp()${RESET}"
+  return 1
+}
+
+check_init_react_native() {
+  log "${BLUE}🔍 Checking React Native SDK initialization...${RESET}"
+  
+  local entrypoints=(
+    "index.js"
+    "index.ts"
+    "src/index.js"
+    "src/index.ts"
+    "App.tsx"
+    "src/App.tsx"
+  )
+  
+  local found=0
+  for entrypoint in "${entrypoints[@]}"; do
+    if [[ -f "$entrypoint" ]]; then
+      if grep -Eq "Clix\.initialize|@clix-so/react-native-sdk" "$entrypoint" 2>/dev/null; then
+        log "${GREEN}✓ Found initialization in ${entrypoint}${RESET}"
+        found=1
+        break
+      fi
+    fi
+  done
+  
+  if [[ "$found" -eq 0 ]]; then
+    log "${YELLOW}⚠️  SDK initialization not found in common entry points${RESET}"
+    log "${YELLOW}  React Native: Ensure Clix.initialize(config) is called in index.js or App.tsx${RESET}"
+    return 1
+  fi
+  
+  return 0
+}
+
+check_install() {
+  local platform
+  platform="$(detect_platform)"
+  
+  case "$platform" in
+    ios)
+      check_install_ios
+      ;;
+    android)
+      check_install_android
+      ;;
+    flutter)
+      check_install_flutter
+      ;;
+    react-native)
+      check_install_react_native
+      ;;
+    *)
+      log "${YELLOW}⚠️  Could not detect platform (iOS/Android/Flutter/React Native)${RESET}"
+      log "${YELLOW}  Skipping installation check${RESET}"
+      return 0
+      ;;
+  esac
+}
+
+check_init() {
+  local platform
+  platform="$(detect_platform)"
+  
+  case "$platform" in
+    ios)
+      check_init_ios
+      ;;
+    android)
+      check_init_android
+      ;;
+    flutter)
+      check_init_flutter
+      ;;
+    react-native)
+      check_init_react_native
+      ;;
+    *)
+      log "${YELLOW}⚠️  Could not detect platform (iOS/Android/Flutter/React Native)${RESET}"
+      log "${YELLOW}  Skipping initialization check${RESET}"
+      return 0
+      ;;
+  esac
+}
+
+main() {
+  if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
+    usage
+    exit 0
+  fi
+
+  local run_install=0
+  local run_init=0
+
+  if [[ "$#" -eq 0 ]]; then
+    run_install=1
+    run_init=1
+  else
+    while [[ "$#" -gt 0 ]]; do
+      case "$1" in
+        --check-install) run_install=1 ;;
+        --check-init) run_init=1 ;;
+        *)
+          usage
+          die "Unknown option: $1"
+          ;;
+      esac
+      shift
+    done
+  fi
+
+  log "${BLUE}🔍 Clix SDK Validation${RESET}"
+  log "${BLUE}========================================${RESET}"
+
+  local platform
+  platform="$(detect_platform)"
+  log "${BLUE}Detected platform: ${platform}${RESET}"
+
+  local all_ok=1
+
+  if [[ "$run_install" -eq 1 ]]; then
+    if ! check_install; then all_ok=0; fi
+  fi
+
+  if [[ "$run_init" -eq 1 ]]; then
+    if ! check_init; then all_ok=0; fi
+  fi
+
+  log "${BLUE}\n========================================${RESET}"
+  if [[ "$all_ok" -eq 1 ]]; then
+    log "${GREEN}✅ Validation passed!${RESET}"
+    exit 0
+  else
+    log "${RED}❌ Validation failed. Please fix the issues above.${RESET}"
+    exit 1
+  fi
+}
+
+main "$@"