Rename xcode_run to xcode_build_and_run for clarity

BREAKING CHANGE: Tool name changed from xcode_run to xcode_build_and_run

- Updated tool definitions to use new name xcode_build_and_run
- Modified CLI command mapping: run → build-and-run
- Updated all tool handlers and server references
- Fixed all test cases and parameter consistency tests
- Updated README documentation
- Enhanced description to emphasize build + run behavior

This change makes the tool name more explicit about its dual functionality
of building the project first, then running it.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: lapfelix

README.md

@@ -188,7 +188,7 @@ xcodecontrol xcresult-get-ui-hierarchy --xcresult-path /path/to/result.xcresult
 CLI commands use kebab-case instead of underscores:
 - `xcode_build` → `build`
 - `xcode_test` → `test`  
-- `xcode_run` → `run`
+- `xcode_build_and_run` → `build-and-run`
 - `xcode_health_check` → `health-check`
 - `xcresult_browse` → `xcresult-browse`
 - `find_xcresults` → `find-xcresults`
@@ -205,7 +205,7 @@ CLI commands use kebab-case instead of underscores:
 - `xcode_build` - Build with detailed error parsing
 - `xcode_clean` - Clean build artifacts
 - `xcode_test` - Run tests with optional arguments
-- `xcode_run` - Run the active scheme
+- `xcode_build_and_run` - Build and run the active scheme
 - `xcode_debug` - Start debugging session
 - `xcode_stop` - Stop current operation
 

__tests__/cli-parameter-consistency.vitest.test.ts

@@ -19,7 +19,7 @@ describe('CLI Parameter Consistency', () => {
         expectedError: 'Project file does not exist', // Project not found, but parameters accepted
       },
       {
-        command: 'run --xcodeproj /fake/project.xcodeproj --scheme TestScheme --command-line-arguments arg1',
+        command: 'build-and-run --xcodeproj /fake/project.xcodeproj --scheme TestScheme --command-line-arguments arg1',
         expectedError: 'Project file does not exist', // Project not found, but parameters accepted
       },
       {
@@ -68,7 +68,7 @@ describe('CLI Parameter Consistency', () => {
       { command: 'open-file --help', expected: ['--file-path', '--line-number'] },
       { command: 'set-active-scheme --help', expected: ['--scheme-name'] },
       { command: 'test --help', expected: ['--command-line-arguments'] },
-      { command: 'run --help', expected: ['--command-line-arguments'] },
+      { command: 'build-and-run --help', expected: ['--command-line-arguments'] },
       { command: 'debug --help', expected: ['--skip-building'] },
       { command: 'xcresult-get-ui-element --help', expected: ['--hierarchy-json-path', '--element-index'] },
       { command: 'xcresult-export-attachment --help', expected: ['--attachment-index'] },

__tests__/functional.vitest.test.js

@@ -31,7 +31,7 @@ describe('XcodeMCP Server Functional Tests', () => {
       'xcode_build', 
       'xcode_clean',
       'xcode_test',
-      'xcode_run',
+      'xcode_build_and_run',
       'xcode_debug',
       'xcode_stop',
       'xcode_get_schemes',
@@ -45,7 +45,7 @@ describe('XcodeMCP Server Functional Tests', () => {
     expect(expectedTools.length).toBe(13);
     expect(expectedTools).toContain('xcode_build');
     expect(expectedTools).toContain('xcode_test');
-    expect(expectedTools).toContain('xcode_run');
+    expect(expectedTools).toContain('xcode_build_and_run');
   });
 
   test('should validate JXA script generation patterns', () => {

__tests__/mcp-handlers.test.js

@@ -91,7 +91,7 @@ describeIfXcode('MCP Tool Handlers', () => {
       expect(toolNames).toContain('xcode_open_project');
       expect(toolNames).toContain('xcode_build');
       expect(toolNames).toContain('xcode_test');
-      expect(toolNames).toContain('xcode_run');
+      expect(toolNames).toContain('xcode_build_and_run');
       expect(toolNames).toContain('xcode_debug');
     });
 

__tests__/parameter-mismatch-prevention.vitest.test.js

@@ -72,7 +72,7 @@ describe('Parameter Mismatch Prevention', () => {
         { tool: 'xcode_build', method: 'build', args: ['args.path', 'args.scheme', 'args.destination'] },
         { tool: 'xcode_clean', method: 'clean', args: ['args.path'] },
         { tool: 'xcode_test', method: 'test', args: ['args.path', 'args.commandLineArguments'] },
-        { tool: 'xcode_run', method: 'run', args: ['args.path', 'args.commandLineArguments'] },
+        { tool: 'xcode_build_and_run', method: 'run', args: ['args.path', 'args.commandLineArguments'] },
         { tool: 'xcode_debug', method: 'debug', args: ['args.path', 'args.scheme', 'args.skipBuilding'] },
         { tool: 'xcode_stop', method: 'stop', args: ['args.xcodeproj'] },
         { tool: 'xcode_get_schemes', method: 'getSchemes', args: ['args.path'] },

__tests__/simple-unit.vitest.test.js

@@ -74,7 +74,7 @@ describe('XcodeMCPServer Basic Tests', () => {
       'xcode_build',
       'xcode_clean',
       'xcode_test',
-      'xcode_run',
+      'xcode_build_and_run',
       'xcode_debug',
       'xcode_stop',
       'xcode_get_schemes',