devlens-mcp 0.4.1 → 0.5.2

package/setup.sh

@@ -0,0 +1,320 @@
+#!/usr/bin/env bash
+#
+# DevLens MCP — Setup Wizard
+#
+# Share this script with your team via Teams / Slack / email.
+# Usage:
+#   bash setup.sh
+#
+# What it does:
+#   1. Checks prerequisites (Node.js 18+, adb/simctl)
+#   2. Prompts for Azure DevOps PAT
+#   3. Configures npm to use Azure Artifacts private registry
+#   4. Installs devlens-mcp
+#   5. Configures Cursor / Claude Desktop / Claude Code
+#   6. Verifies everything works
+
+set -euo pipefail
+
+AZURE_REGISTRY="https://pkgs.dev.azure.com/JioOmni/_packaging/devlens/npm/registry/"
+AZURE_FEED_URL="https://dev.azure.com/JioOmni/OmniAI/_artifacts/feed/devlens"
+PAT_URL="https://dev.azure.com/JioOmni/_usersSettings/tokens"
+
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+ok()   { echo -e "  ${GREEN}[OK]${NC} $1"; }
+warn() { echo -e "  ${YELLOW}[!!]${NC} $1"; }
+fail() { echo -e "  ${RED}[XX]${NC} $1"; }
+info() { echo -e "  ${BLUE}[..]${NC} $1"; }
+
+banner() {
+  echo ""
+  echo -e "  ${BOLD}╔══════════════════════════════════════════╗${NC}"
+  echo -e "  ${BOLD}║         DevLens MCP — Setup Wizard       ║${NC}"
+  echo -e "  ${BOLD}╚══════════════════════════════════════════╝${NC}"
+  echo ""
+}
+
+# ── Step 1: Prerequisites ──────────────────────────────────
+
+check_prerequisites() {
+  echo -e "  ${BOLD}Step 1/6 — Checking prerequisites${NC}"
+  echo "  ──────────────────────────────────"
+
+  if ! command -v node &>/dev/null; then
+    fail "Node.js not found. Install v18+ from https://nodejs.org"
+    exit 1
+  fi
+
+  NODE_VERSION=$(node -v | sed 's/v//')
+  NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
+  if [ "$NODE_MAJOR" -lt 18 ]; then
+    fail "Node.js $NODE_VERSION detected — v18+ required"
+    exit 1
+  fi
+  ok "Node.js $NODE_VERSION"
+
+  if ! command -v npm &>/dev/null; then
+    fail "npm not found"
+    exit 1
+  fi
+  ok "npm $(npm -v)"
+
+  if command -v adb &>/dev/null; then
+    ok "Android SDK (adb) found"
+  else
+    info "Android SDK (adb) not found — Android features unavailable"
+  fi
+
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    if command -v xcrun &>/dev/null && xcrun simctl help &>/dev/null 2>&1; then
+      ok "Xcode simctl found"
+    else
+      info "Xcode simctl not found — iOS features unavailable"
+    fi
+  fi
+}
+
+# ── Step 2: Azure DevOps PAT ───────────────────────────────
+
+get_pat() {
+  echo ""
+  echo -e "  ${BOLD}Step 2/6 — Azure Artifacts authentication${NC}"
+  echo "  ──────────────────────────────────────────"
+  echo ""
+  echo "  You need a Personal Access Token (PAT) from Azure DevOps."
+  echo ""
+  echo "  How to create one:"
+  echo "    1. Open: $PAT_URL"
+  echo "    2. Click 'New Token'"
+  echo "    3. Name:  devlens-npm"
+  echo "    4. Scope: Packaging → Read"
+  echo "    5. Click 'Create' and copy the token"
+  echo ""
+
+  read -rsp "  Paste your PAT (input hidden): " PAT
+  echo ""
+
+  if [ ${#PAT} -lt 20 ]; then
+    fail "PAT looks too short. Please try again."
+    exit 1
+  fi
+
+  ok "PAT received"
+}
+
+# ── Step 3: Configure npm ──────────────────────────────────
+
+configure_npm() {
+  echo ""
+  echo -e "  ${BOLD}Step 3/6 — Configuring npm registry${NC}"
+  echo "  ─────────────────────────────────────"
+
+  BASE64_PAT=$(echo -n "$PAT" | base64)
+
+  REGISTRY_KEY="//pkgs.dev.azure.com/JioOmni/_packaging/devlens/npm/registry/"
+
+  NPMRC_FILE="$HOME/.npmrc"
+  if [ -f "$NPMRC_FILE" ]; then
+    # Remove any existing devlens registry entries
+    grep -v "pkgs.dev.azure.com/JioOmni/_packaging/devlens" "$NPMRC_FILE" > "$NPMRC_FILE.tmp" || true
+    mv "$NPMRC_FILE.tmp" "$NPMRC_FILE"
+  fi
+
+  {
+    echo "${REGISTRY_KEY}:username=JioOmni"
+    echo "${REGISTRY_KEY}:_password=${BASE64_PAT}"
+    echo "${REGISTRY_KEY}:email=npm@jio.com"
+  } >> "$NPMRC_FILE"
+
+  ok "npm credentials saved to $NPMRC_FILE"
+
+  # Create project-level .npmrc if in a project directory
+  if [ -f "package.json" ]; then
+    if [ ! -f ".npmrc" ] || ! grep -q "pkgs.dev.azure.com/JioOmni/_packaging/devlens" ".npmrc" 2>/dev/null; then
+      echo "registry=${AZURE_REGISTRY}" > .npmrc
+      echo "always-auth=true" >> .npmrc
+      ok "Project .npmrc created"
+    else
+      ok "Project .npmrc already configured"
+    fi
+  fi
+}
+
+# ── Step 4: Install DevLens ────────────────────────────────
+
+install_devlens() {
+  echo ""
+  echo -e "  ${BOLD}Step 4/6 — Installing devlens-mcp${NC}"
+  echo "  ──────────────────────────────────"
+
+  info "Installing globally from Azure Artifacts..."
+
+  if npm install -g devlens-mcp@latest --registry="$AZURE_REGISTRY"; then
+    INSTALLED_VERSION=$(devlens-mcp --version 2>/dev/null || echo "unknown")
+    ok "devlens-mcp installed globally ($INSTALLED_VERSION)"
+  else
+    fail "Global install failed — check PAT permissions (needs Packaging → Read)"
+    exit 1
+  fi
+}
+
+# ── Step 5: Configure IDEs ─────────────────────────────────
+
+configure_ide() {
+  local NAME="$1"
+  local CONFIG_PATH="$2"
+  local FIGMA_TOKEN="$3"
+
+  CONFIG_DIR=$(dirname "$CONFIG_PATH")
+
+  if [ ! -d "$CONFIG_DIR" ]; then
+    mkdir -p "$CONFIG_DIR"
+  fi
+
+  if [ -f "$CONFIG_PATH" ]; then
+    EXISTING=$(cat "$CONFIG_PATH")
+  else
+    EXISTING="{}"
+  fi
+
+  # Use node to merge JSON safely — uses global command, no npx caching issues
+  MERGED=$(node -e "
+    let config = {};
+    try { config = JSON.parse(process.argv[1]); } catch {}
+    if (!config.mcpServers) config.mcpServers = {};
+    const env = { METRO_PORT: '8081' };
+    const figma = process.argv[2];
+    if (figma) env.FIGMA_TOKEN = figma;
+    config.mcpServers.devlens = {
+      command: 'devlens-mcp',
+      args: [],
+      env
+    };
+    console.log(JSON.stringify(config, null, 2));
+  " "$EXISTING" "${FIGMA_TOKEN}" 2>/dev/null)
+
+  if [ -n "$MERGED" ]; then
+    echo "$MERGED" > "$CONFIG_PATH"
+    ok "$NAME: configured at $CONFIG_PATH"
+  else
+    warn "$NAME: could not write config"
+  fi
+}
+
+configure_ides() {
+  echo ""
+  echo -e "  ${BOLD}Step 5/6 — Configuring IDEs${NC}"
+  echo "  ──────────────────────────"
+
+  echo ""
+  read -rp "  Figma token (optional, Enter to skip): " FIGMA_TOKEN
+
+  CONFIGURED=0
+
+  # Cursor (global)
+  CURSOR_CONFIG="$HOME/.cursor/mcp.json"
+  if [ -d "$HOME/.cursor" ] || command -v cursor &>/dev/null; then
+    configure_ide "Cursor (global)" "$CURSOR_CONFIG" "$FIGMA_TOKEN"
+    CONFIGURED=$((CONFIGURED + 1))
+  fi
+
+  # Cursor (project-level) — if in a project directory
+  if [ -f "package.json" ]; then
+    PROJECT_CURSOR=".cursor/mcp.json"
+    configure_ide "Cursor (project)" "$PROJECT_CURSOR" "$FIGMA_TOKEN"
+    CONFIGURED=$((CONFIGURED + 1))
+  fi
+
+  # Claude Desktop (macOS)
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    CLAUDE_DESKTOP="$HOME/Library/Application Support/Claude/claude_desktop_config.json"
+    if [ -d "$HOME/Library/Application Support/Claude" ] || [ -d "/Applications/Claude.app" ]; then
+      configure_ide "Claude Desktop" "$CLAUDE_DESKTOP" "$FIGMA_TOKEN"
+      CONFIGURED=$((CONFIGURED + 1))
+    fi
+  fi
+
+  # Claude Code
+  if [ -d "$HOME/.claude" ] || command -v claude &>/dev/null; then
+    CLAUDE_CODE="$HOME/.claude/mcp.json"
+    configure_ide "Claude Code" "$CLAUDE_CODE" "$FIGMA_TOKEN"
+    CONFIGURED=$((CONFIGURED + 1))
+  fi
+
+  if [ $CONFIGURED -eq 0 ]; then
+    warn "No IDEs detected. Manual setup:"
+    echo ""
+    echo "    Add to .cursor/mcp.json or claude_desktop_config.json:"
+    echo '    {'
+    echo '      "mcpServers": {'
+    echo '        "devlens": {'
+    echo '          "command": "devlens-mcp",'
+    echo '          "args": [],'
+    echo '          "env": { "METRO_PORT": "8081" }'
+    echo '        }'
+    echo '      }'
+    echo '    }'
+    echo ""
+  fi
+}
+
+# ── Step 6: Verify ─────────────────────────────────────────
+
+verify() {
+  echo ""
+  echo -e "  ${BOLD}Step 6/6 — Verification${NC}"
+  echo "  ───────────────────────"
+
+  if npm view devlens-mcp version --registry="$AZURE_REGISTRY" &>/dev/null; then
+    VERSION=$(npm view devlens-mcp version --registry="$AZURE_REGISTRY" 2>/dev/null)
+    ok "Azure Artifacts: devlens-mcp@$VERSION found"
+  else
+    warn "Could not reach Azure Artifacts — check PAT permissions"
+  fi
+
+  if command -v devlens-mcp &>/dev/null; then
+    ok "devlens-mcp CLI available globally"
+  else
+    info "devlens-mcp not on PATH — will run via npx (this is fine)"
+  fi
+}
+
+# ── Done ───────────────────────────────────────────────────
+
+done_message() {
+  echo ""
+  echo -e "  ${BOLD}${GREEN}╔══════════════════════════════════════════╗${NC}"
+  echo -e "  ${BOLD}${GREEN}║            Setup Complete!                ║${NC}"
+  echo -e "  ${BOLD}${GREEN}╚══════════════════════════════════════════╝${NC}"
+  echo ""
+  echo "  What's next:"
+  echo "    1. Restart Cursor / Claude Desktop"
+  echo "    2. Start your React Native app:  npx react-native start"
+  echo "    3. Start an emulator or simulator"
+  echo "    4. Ask the AI:  \"List running devices\""
+  echo ""
+  echo "  Test it works:"
+  echo "    - \"Take a screenshot of the app\""
+  echo "    - \"Compare the screen with this Figma: <url>\""
+  echo "    - \"Run VQA validation against Figma\""
+  echo ""
+  echo -e "  Azure Artifacts Feed:  ${BLUE}${AZURE_FEED_URL}${NC}"
+  echo ""
+}
+
+# ── Main ───────────────────────────────────────────────────
+
+banner
+check_prerequisites
+get_pat
+configure_npm
+install_devlens
+configure_ides
+verify
+done_message

package/tsconfig.json

@@ -3,7 +3,7 @@
     "target": "ES2022",
     "module": "Node16",
     "moduleResolution": "Node16",
-    "lib": ["ES2022"],
+    "lib": ["ES2022", "DOM"],
     "outDir": "dist",
     "rootDir": ".",
     "strict": true,