test(snapshot): Add structured JSON fixture targets

[cameroncooke]

Add a structured JSON fixture corpus for the planned CLI --output json mode.

This introduces a target fixture tree under src/snapshot-tests/__fixtures__/json and a companion planning doc in docs/dev/STRUCTURED_JSON_OUTPUT_PLAN.md. The fixtures are normalized around shared schema families so we can review the output contract before wiring the producer and snapshot harness to it.

The main goal here is to lock down the result shapes early: text and current event-stream output stay unchanged for now, while the future structured JSON mode gets a concrete, reviewable contract across simulator, device, macOS, SwiftPM, debugging, discovery, session-management, and UI automation workflows.

I kept this PR fixture-only. It does not update the runtime producer, tests, or harness plumbing yet.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/xcodebuildmcp@338

commit: 9fbdebf

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Autofix Details

Bugbot Autofix prepared fixes for both issues found in the latest run.

• ✅ Fixed: Device-list schema missing isAvailable field in resources fixture
  • Added the missing isAvailable field to all device entries in resources/devices--success.json to match the device-list schema contract.
• ✅ Fixed: Simulator success fixtures inconsistently omit diagnostics field
  • Added the missing diagnostics field with empty warnings and errors arrays to simulator success fixtures for stop, install, and launch-app operations.

Or push these changes by commenting:

@cursor push d6600841ee

Preview (d6600841ee)

diff --git a/src/snapshot-tests/__fixtures__/json/resources/devices--success.json b/src/snapshot-tests/__fixtures__/json/resources/devices--success.json
--- a/src/snapshot-tests/__fixtures__/json/resources/devices--success.json
+++ b/src/snapshot-tests/__fixtures__/json/resources/devices--success.json
@@ -6,32 +6,36 @@
   "data": {
     "devices": [
       {
-        "name": "Cameron’s iPhone 16 Pro Max",
+        "name": "Cameron's iPhone 16 Pro Max",
         "deviceId": "<UUID>",
         "platform": "iOS",
         "osVersion": "26.3.1 (a)",
-        "state": "<STATUS>"
+        "state": "<STATUS>",
+        "isAvailable": true
       },
       {
         "name": "iPhone",
         "deviceId": "<UUID>",
         "platform": "iOS",
         "osVersion": "26.1",
-        "state": "<STATUS>"
+        "state": "<STATUS>",
+        "isAvailable": false
       },
       {
-        "name": "Cameron’s Apple Watch",
+        "name": "Cameron's Apple Watch",
         "deviceId": "<UUID>",
         "platform": "watchOS",
         "osVersion": "10.6.1",
-        "state": "<STATUS>"
+        "state": "<STATUS>",
+        "isAvailable": false
       },
       {
-        "name": "Cameron’s Apple Watch",
+        "name": "Cameron's Apple Watch",
         "deviceId": "<UUID>",
         "platform": "watchOS",
         "osVersion": "26.3",
-        "state": "<STATUS>"
+        "state": "<STATUS>",
+        "isAvailable": true
       }
     ]
   }

diff --git a/src/snapshot-tests/__fixtures__/json/simulator/install--success.json b/src/snapshot-tests/__fixtures__/json/simulator/install--success.json
--- a/src/snapshot-tests/__fixtures__/json/simulator/install--success.json
+++ b/src/snapshot-tests/__fixtures__/json/simulator/install--success.json
@@ -10,6 +10,10 @@
     "artifacts": {
       "simulatorId": "<UUID>",
       "appPath": "<HOME>/Library/Developer/XcodeBuildMCP/DerivedData/Build/Products/Debug-iphonesimulator/CalculatorApp.app"
+    },
+    "diagnostics": {
+      "warnings": [],
+      "errors": []
     }
   }
 }

diff --git a/src/snapshot-tests/__fixtures__/json/simulator/launch-app--success.json b/src/snapshot-tests/__fixtures__/json/simulator/launch-app--success.json
--- a/src/snapshot-tests/__fixtures__/json/simulator/launch-app--success.json
+++ b/src/snapshot-tests/__fixtures__/json/simulator/launch-app--success.json
@@ -13,6 +13,10 @@
       "processId": "<PID>",
       "runtimeLogPath": "<HOME>/Library/Developer/XcodeBuildMCP/logs/io.sentry.calculatorapp_<TIMESTAMP>_pid<PID>.log",
       "osLogPath": "<HOME>/Library/Developer/XcodeBuildMCP/logs/io.sentry.calculatorapp_oslog_<TIMESTAMP>_pid<PID>.log"
+    },
+    "diagnostics": {
+      "warnings": [],
+      "errors": []
     }
   }
 }

diff --git a/src/snapshot-tests/__fixtures__/json/simulator/stop--success.json b/src/snapshot-tests/__fixtures__/json/simulator/stop--success.json
--- a/src/snapshot-tests/__fixtures__/json/simulator/stop--success.json
+++ b/src/snapshot-tests/__fixtures__/json/simulator/stop--success.json
@@ -10,6 +10,10 @@
     "artifacts": {
       "simulatorId": "<UUID>",
       "bundleId": "io.sentry.calculatorapp"
+    },
+    "diagnostics": {
+      "warnings": [],
+      "errors": []
     }
   }
 }

_{This Bugbot Autofix run was free. To enable autofix for future PRs, go to the Cursor dashboard.}

[cameroncooke]

@cursor push d660084

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 102658c. Configure here.}