feat(responses): Add next-step runtime responses (#420)

Add next-step instructions to runtime responses while keeping the structured
output envelope intact. The runtime now decides between minimal and normal
response detail without directly owning CLI verbosity policy.

Expose CLI control so regular CLI output can default to normal detail while
agent-oriented CLI usage can request minimal output matching MCP.

Author: cameroncooke

AGENTS.md

@@ -6,7 +6,7 @@ names:
 description: Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim).
 outputSchema:
   schema: xcodebuildmcp.output.simulator-action-result
-  version: "1"
+  version: "2"
 annotations:
   title: Boot Simulator
   readOnlyHint: false

CHANGELOG.md

@@ -6,7 +6,7 @@ names:
 description: Build for device.
 outputSchema:
   schema: xcodebuildmcp.output.build-result
-  version: "1"
+  version: "2"
 predicates:
   - hideWhenXcodeAgentMode
 annotations:

CLAUDE.md

@@ -6,7 +6,7 @@ names:
 description: Build macOS app.
 outputSchema:
   schema: xcodebuildmcp.output.build-result
-  version: "1"
+  version: "2"
 predicates:
   - hideWhenXcodeAgentMode
 annotations:

manifests/tools/boot_sim.yaml

@@ -6,7 +6,7 @@ names:
 description: Build, install, and launch on physical device. Preferred single-step run tool when defaults are set.
 outputSchema:
   schema: xcodebuildmcp.output.build-run-result
-  version: '1'
+  version: "2"
 predicates:
   - hideWhenXcodeAgentMode
 annotations:

manifests/tools/build_device.yaml

@@ -6,7 +6,7 @@ names:
 description: Build and run macOS app.
 outputSchema:
   schema: xcodebuildmcp.output.build-run-result
-  version: "1"
+  version: "2"
 predicates:
   - hideWhenXcodeAgentMode
 annotations:

manifests/tools/build_macos.yaml

@@ -6,7 +6,7 @@ names:
 description: Build, install, and launch on iOS Simulator; boots simulator and attempts to open Simulator.app as needed. Runtime logs are captured automatically and the log file path is included in the response. Preferred single-step run tool when defaults are set.
 outputSchema:
   schema: xcodebuildmcp.output.build-run-result
-  version: "1"
+  version: "2"
 predicates:
   - hideWhenXcodeAgentMode
 annotations:

manifests/tools/build_run_device.yaml

@@ -6,7 +6,7 @@ names:
 description: Build for iOS sim (compile-only, no launch).
 outputSchema:
   schema: xcodebuildmcp.output.build-result
-  version: "1"
+  version: "2"
 predicates:
   - hideWhenXcodeAgentMode
 annotations: