Merge branch 'main' into dependabot/npm_and_yarn/vite-7.1.6

Author: cameroncooke

.axe-version

@@ -0,0 +1 @@
+1.1.1

.github/workflows/release.yml

@@ -101,60 +101,6 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-      - name: Setup Go (for MCP Publisher)
-        if: github.event_name == 'push'
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.22'
-
-      - name: Install MCP Publisher
-        if: github.event_name == 'push'
-        run: |
-          echo "📥 Fetching MCP Publisher"
-          git clone https://github.com/modelcontextprotocol/registry publisher-repo
-          cd publisher-repo
-          make publisher
-          # The publisher binary is output to bin/mcp-publisher by the Makefile
-          cp bin/mcp-publisher ../mcp-publisher
-          cd ..
-          chmod +x mcp-publisher
-
-      - name: Login to MCP Registry (DNS)
-        if: github.event_name == 'push'
-        env:
-          MCP_DNS_PRIVATE_KEY: ${{ secrets.MCP_DNS_PRIVATE_KEY }}
-        run: |
-          echo "🔐 Using DNS authentication for com.xcodebuildmcp/* namespace"
-          if [ -z "${MCP_DNS_PRIVATE_KEY}" ]; then
-            echo "❌ Missing secrets.MCP_DNS_PRIVATE_KEY"
-            echo "Add your DNS private key (hex) as a GitHub secret named MCP_DNS_PRIVATE_KEY."
-            echo "Generate/extract with:"
-            echo "  openssl genpkey -algorithm Ed25519 -out key.pem"
-            echo "  openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\\n'"
-            exit 1
-          fi
-          ./mcp-publisher login dns --domain xcodebuildmcp.com --private-key "${MCP_DNS_PRIVATE_KEY}"
-
-      - name: Publish to MCP Registry
-        if: github.event_name == 'push'
-        run: |
-          echo "🚢 Publishing to MCP Registry with retries..."
-          attempts=0
-          max_attempts=5
-          delay=5
-          until ./mcp-publisher publish; do
-            rc=$?
-            attempts=$((attempts+1))
-            if [ $attempts -ge $max_attempts ]; then
-              echo "❌ Publish failed after $attempts attempts (exit $rc)"
-              exit $rc
-            fi
-            echo "⚠️ Publish failed (exit $rc). Retrying in ${delay}s... (attempt ${attempts}/${max_attempts})"
-            sleep $delay
-            delay=$((delay*2))
-          done
-          echo "✅ Publish succeeded."
-
       - name: Create GitHub Release (production releases only)
         if: github.event_name == 'push'
         uses: softprops/action-gh-release@v1
@@ -198,5 +144,73 @@ jobs:
             echo "🎉 Production release completed!"
             echo "Version: ${{ steps.get_version.outputs.VERSION }}"
             echo "📦 NPM: https://www.npmjs.com/package/xcodebuildmcp/v/${{ steps.get_version.outputs.VERSION }}"
-            echo "📚 MCP Registry: published via mcp-publisher"
+            echo "📚 MCP Registry: publish attempted in separate job (mcp_registry)"
           fi
+
+  mcp_registry:
+    if: github.event_name == 'push'
+    needs: release
+    runs-on: ubuntu-latest
+    env:
+      MCP_DNS_PRIVATE_KEY: ${{ secrets.MCP_DNS_PRIVATE_KEY }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Get version from tag
+        id: get_version_mcp
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+          echo "🚢 MCP publish for version: $VERSION"
+
+      - name: Missing secret — skip MCP publish
+        if: env.MCP_DNS_PRIVATE_KEY == ''
+        run: |
+          echo "⚠️ Skipping MCP Registry publish: secrets.MCP_DNS_PRIVATE_KEY is not set."
+          echo "This is optional and does not affect the release."
+
+      - name: Setup Go (for MCP Publisher)
+        if: env.MCP_DNS_PRIVATE_KEY != ''
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+
+      - name: Install MCP Publisher
+        if: env.MCP_DNS_PRIVATE_KEY != ''
+        run: |
+          echo "📥 Fetching MCP Publisher"
+          git clone https://github.com/modelcontextprotocol/registry publisher-repo
+          cd publisher-repo
+          make publisher
+          cp bin/mcp-publisher ../mcp-publisher
+          cd ..
+          chmod +x mcp-publisher
+
+      - name: Login to MCP Registry (DNS)
+        if: env.MCP_DNS_PRIVATE_KEY != ''
+        run: |
+          echo "🔐 Using DNS authentication for com.xcodebuildmcp/* namespace"
+          ./mcp-publisher login dns --domain xcodebuildmcp.com --private-key "${MCP_DNS_PRIVATE_KEY}"
+
+      - name: Publish to MCP Registry (best-effort)
+        if: env.MCP_DNS_PRIVATE_KEY != ''
+        run: |
+          echo "🚢 Publishing to MCP Registry with retries..."
+          attempts=0
+          max_attempts=5
+          delay=5
+          until ./mcp-publisher publish; do
+            rc=$?
+            attempts=$((attempts+1))
+            if [ $attempts -ge $max_attempts ]; then
+              echo "⚠️ MCP Registry publish failed after $attempts attempts (exit $rc). Skipping without failing workflow."
+              exit 0
+            fi
+            echo "⚠️ Publish failed (exit $rc). Retrying in ${delay}s... (attempt ${attempts}/${max_attempts})"
+            sleep $delay
+            delay=$((delay*2))
+          done
+          echo "✅ MCP Registry publish succeeded."

.gitignore

@@ -107,3 +107,4 @@ bundled/
 /.mcpregistry_github_token
 /.mcpregistry_registry_token
 /key.pem
+.mcpli

README.md

@@ -86,6 +86,7 @@ The XcodeBuildMCP server provides the following tool capabilities:
 - **Log Capture**: Capture run-time logs from a simulator
 - **UI Automation**: Interact with simulator UI elements
 - **Screenshot**: Capture screenshots from a simulator
+- **Video Capture**: Start/stop simulator video capture to MP4 (AXe v1.1.0+)
 
 ### Device management
 - **Device Discovery**: List connected physical Apple devices over USB or Wi-Fi
@@ -117,7 +118,9 @@ For clients that support MCP resources XcodeBuildMCP provides efficient URI-base
 - Xcode 16.x or later
 - Node 18.x or later
 
-### Configure your MCP client
+> Video capture requires the bundled AXe binary (v1.1.0+). Run `npm run bundle:axe` once locally before using `record_sim_video`. This is not required for unit tests.
+
+Configure your MCP client
 
 #### One click install
 

docs/TOOLS.md

@@ -1,6 +1,6 @@
 # XcodeBuildMCP Tools Reference
 
-XcodeBuildMCP provides 60 tools organized into 12 workflow groups for comprehensive Apple development workflows.
+XcodeBuildMCP provides 61 tools organized into 12 workflow groups for comprehensive Apple development workflows.
 
 ## Workflow Groups
 
@@ -19,7 +19,7 @@ XcodeBuildMCP provides 60 tools organized into 12 workflow groups for comprehens
 - `stop_app_device` - Stops an app running on a physical Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). Requires deviceId and processId.
 - `test_device` - Runs tests for an Apple project or workspace on a physical device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) using xcodebuild test and parses xcresult output. Provide exactly one of projectPath or workspacePath.
 ### iOS Simulator Development (`simulator`)
-**Purpose**: Complete iOS development workflow for both .xcodeproj and .xcworkspace files targeting simulators. Build, test, deploy, and interact with iOS apps on simulators. (11 tools)
+**Purpose**: Complete iOS development workflow for both .xcodeproj and .xcworkspace files targeting simulators. Build, test, deploy, and interact with iOS apps on simulators. (12 tools)
 
 - `boot_sim` - Boots an iOS simulator. After booting, use open_sim() to make the simulator visible.
 - `build_run_sim` - Builds and runs an app from a project or workspace on a specific simulator by UUID or name. Provide exactly one of projectPath or workspacePath, and exactly one of simulatorId or simulatorName.
@@ -30,6 +30,7 @@ XcodeBuildMCP provides 60 tools organized into 12 workflow groups for comprehens
 - `launch_app_sim` - Launches an app in an iOS simulator by UUID or name. If simulator window isn't visible, use open_sim() first. or launch_app_sim({ simulatorName: 'iPhone 16', bundleId: 'com.example.MyApp' })
 - `list_sims` - Lists available iOS simulators with their UUIDs.
 - `open_sim` - Opens the iOS Simulator app.
+- `record_sim_video` - Starts or stops video capture for an iOS simulator using AXe. Provide exactly one of start=true or stop=true. On stop, outputFile is required. fps defaults to 30.
 - `stop_app_sim` - Stops an app running in an iOS simulator by UUID or name. or stop_app_sim({ simulatorName: "iPhone 16", bundleId: "com.example.MyApp" })
 - `test_sim` - Runs tests on a simulator by UUID or name using xcodebuild test and parses xcresult output. Works with both Xcode projects (.xcodeproj) and workspaces (.xcworkspace).
 ### Log Capture & Management (`logging`)
@@ -68,7 +69,7 @@ XcodeBuildMCP provides 60 tools organized into 12 workflow groups for comprehens
 ### Simulator Management (`simulator-management`)
 **Purpose**: Tools for managing simulators from booting, opening simulators, listing simulators, stopping simulators, erasing simulator content and settings, and setting simulator environment options like location, network, statusbar and appearance. (5 tools)
 
-- `erase_sims` - Erases simulator content and settings. Provide exactly one of: simulatorUuid or all=true. Optional: shutdownFirst to shut down before erasing.
+- `erase_sims` - Erases simulator content and settings. Provide exactly one of: simulatorUdid or all=true. Optional: shutdownFirst to shut down before erasing.
 - `reset_sim_location` - Resets the simulator's location to default.
 - `set_sim_appearance` - Sets the appearance mode (dark/light) of an iOS simulator.
 - `set_sim_location` - Sets a custom GPS location for the simulator.
@@ -103,9 +104,9 @@ XcodeBuildMCP provides 60 tools organized into 12 workflow groups for comprehens
 
 ## Summary Statistics
 
-- **Total Tools**: 60 canonical tools + 22 re-exports = 82 total
+- **Total Tools**: 61 canonical tools + 22 re-exports = 83 total
 - **Workflow Groups**: 12
 
 ---
 
-*This documentation is automatically generated by `scripts/update-tools-docs.ts` using static analysis. Last updated: 2025-09-21*
+*This documentation is automatically generated by `scripts/update-tools-docs.ts` using static analysis. Last updated: 2025-09-22*

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "xcodebuildmcp",
-  "version": "1.13.0",
+  "version": "1.13.1",
   "mcpName": "com.xcodebuildmcp/XcodeBuildMCP",
   "iOSTemplateVersion": "v1.0.8",
   "macOSTemplateVersion": "v1.0.5",

package.json

@@ -13,6 +13,21 @@ AXE_TEMP_DIR="/tmp/axe-download-$$"
 
 echo "🔨 Preparing AXe artifacts for bundling..."
 
+# Single source of truth for AXe version (overridable)
+# 1) Use $AXE_VERSION if provided in env
+# 2) Else, use repo-level pin from .axe-version if present
+# 3) Else, fall back to default below
+DEFAULT_AXE_VERSION="1.1.1"
+VERSION_FILE="$PROJECT_ROOT/.axe-version"
+if [ -n "${AXE_VERSION}" ]; then
+    PINNED_AXE_VERSION="${AXE_VERSION}"
+elif [ -f "$VERSION_FILE" ]; then
+    PINNED_AXE_VERSION="$(cat "$VERSION_FILE" | tr -d ' \n\r')"
+else
+    PINNED_AXE_VERSION="$DEFAULT_AXE_VERSION"
+fi
+echo "📌 Using AXe version: $PINNED_AXE_VERSION"
+
 # Clean up any existing bundled directory
 if [ -d "$BUNDLED_DIR" ]; then
     echo "🧹 Cleaning existing bundled directory..."
@@ -22,41 +37,41 @@ fi
 # Create bundled directory
 mkdir -p "$BUNDLED_DIR"
 
-# Use local AXe build if available, otherwise download from GitHub releases
-if [ -d "$AXE_LOCAL_DIR" ] && [ -f "$AXE_LOCAL_DIR/Package.swift" ]; then
+# Use local AXe build if available (unless AXE_FORCE_REMOTE=1), otherwise download from GitHub releases
+if [ -z "${AXE_FORCE_REMOTE}" ] && [ -d "$AXE_LOCAL_DIR" ] && [ -f "$AXE_LOCAL_DIR/Package.swift" ]; then
     echo "🏠 Using local AXe source at $AXE_LOCAL_DIR"
     cd "$AXE_LOCAL_DIR"
-    
+
     # Build AXe in release configuration
     echo "🔨 Building AXe in release configuration..."
     swift build --configuration release
-    
+
     # Check if build succeeded
     if [ ! -f ".build/release/axe" ]; then
         echo "❌ AXe build failed - binary not found"
         exit 1
     fi
-    
+
     echo "✅ AXe build completed successfully"
-    
+
     # Copy binary to bundled directory
     echo "📦 Copying AXe binary..."
     cp ".build/release/axe" "$BUNDLED_DIR/"
-    
+
     # Fix rpath to find frameworks in Frameworks/ subdirectory
     echo "🔧 Configuring AXe binary rpath for bundled frameworks..."
     install_name_tool -add_rpath "@executable_path/Frameworks" "$BUNDLED_DIR/axe"
-    
+
     # Create Frameworks directory and copy frameworks
     echo "📦 Copying frameworks..."
     mkdir -p "$BUNDLED_DIR/Frameworks"
-    
+
     # Copy frameworks with better error handling
     for framework in .build/release/*.framework; do
         if [ -d "$framework" ]; then
             echo "📦 Copying framework: $(basename "$framework")"
             cp -r "$framework" "$BUNDLED_DIR/Frameworks/"
-            
+
             # Only copy nested frameworks if they exist
             if [ -d "$framework/Frameworks" ]; then
                 echo "📦 Found nested frameworks in $(basename "$framework")"
@@ -66,30 +81,30 @@ if [ -d "$AXE_LOCAL_DIR" ] && [ -f "$AXE_LOCAL_DIR/Package.swift" ]; then
     done
 else
     echo "📥 Downloading latest AXe release from GitHub..."
-    
-    # Get latest release download URL
-    LATEST_RELEASE_URL="https://github.com/cameroncooke/AXe/releases/download/v1.0.0/AXe-macOS-v1.0.0.tar.gz"
-    
+
+    # Construct release download URL from pinned version
+    AXE_RELEASE_URL="https://github.com/cameroncooke/AXe/releases/download/v${PINNED_AXE_VERSION}/AXe-macOS-v${PINNED_AXE_VERSION}.tar.gz"
+
     # Create temp directory
     mkdir -p "$AXE_TEMP_DIR"
     cd "$AXE_TEMP_DIR"
-    
+
     # Download and extract the release
-    echo "📥 Downloading AXe release archive..."
-    curl -L -o "axe-release.tar.gz" "$LATEST_RELEASE_URL"
-    
+    echo "📥 Downloading AXe release archive ($AXE_RELEASE_URL)..."
+    curl -L -o "axe-release.tar.gz" "$AXE_RELEASE_URL"
+
     echo "📦 Extracting AXe release archive..."
     tar -xzf "axe-release.tar.gz"
-    
+
     # Find the extracted directory (might be named differently)
     EXTRACTED_DIR=$(find . -type d -name "*AXe*" -o -name "*axe*" | head -1)
     if [ -z "$EXTRACTED_DIR" ]; then
         # If no AXe directory found, assume files are in current directory
         EXTRACTED_DIR="."
     fi
-    
+
     cd "$EXTRACTED_DIR"
-    
+
     # Copy binary
     if [ -f "axe" ]; then
         echo "📦 Copying AXe binary..."
@@ -104,11 +119,11 @@ else
         ls -la
         exit 1
     fi
-    
+
     # Copy frameworks if they exist
     echo "📦 Copying frameworks..."
     mkdir -p "$BUNDLED_DIR/Frameworks"
-    
+
     if [ -d "Frameworks" ]; then
         cp -r Frameworks/* "$BUNDLED_DIR/Frameworks/"
     elif [ -d "lib" ]; then
@@ -153,4 +168,4 @@ BUNDLE_SIZE=$(du -sh "$BUNDLED_DIR" | cut -f1)
 echo "📊 Final bundle size: $BUNDLE_SIZE"
 
 echo "🎉 AXe bundling completed successfully!"
-echo "📁 Bundled artifacts location: $BUNDLED_DIR"
+echo "📁 Bundled artifacts location: $BUNDLED_DIR"

scripts/bundle-axe.sh

@@ -344,6 +344,14 @@ if [[ -n "$RUN_ID" ]]; then
     echo ""
     echo "❌ CI workflow failed!"
     echo ""
+    # Prefer job state: if the primary 'release' job succeeded, treat as success.
+    RELEASE_JOB_CONCLUSION=$(gh run view "$RUN_ID" --json jobs --jq '.jobs[] | select(.name=="release") | .conclusion')
+    if [ "$RELEASE_JOB_CONCLUSION" = "success" ]; then
+      echo "⚠️ Workflow reported failure, but primary 'release' job concluded SUCCESS."
+      echo "✅ Treating release as successful. Tag v$VERSION is kept."
+      echo "📦 Verify on NPM: https://www.npmjs.com/package/xcodebuildmcp/v/$VERSION"
+      exit 0
+    fi
     echo "🧹 Cleaning up tags only (keeping version commit)..."
 
     # Delete remote tag

scripts/release.sh

@@ -8,13 +8,13 @@
     "source": "github",
     "id": "945551361"
   },
-  "version": "1.13.0",
+  "version": "1.13.1",
   "packages": [
     {
       "registry_type": "npm",
       "registry_base_url": "https://registry.npmjs.org",
       "identifier": "xcodebuildmcp",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "transport": {
         "type": "stdio"
       },