refactor: Migrate next-steps to manifest-driven templates

Move next-step definitions from inline tool logic into YAML manifests
using a new nextStepTemplates system. Templates support static params,
${arg} substitution, and runtime merging with dynamic response params.
Removes hardcoded next-step construction from individual tool handlers.

Author: cameroncooke

NEXT_STEPS_MIGRATION_TODO.md

@@ -0,0 +1,27 @@
+# Next Steps Migration TODO
+
+Generated: 2026-02-11 19:12:27 UTC
+
+## Remaining tool files with inline nextSteps
+- [x] src/mcp/tools/debugging/debug_attach_sim.ts:148
+- [x] src/mcp/tools/device/get_device_app_path.ts:140
+- [x] src/mcp/tools/device/launch_app_device.ts:135
+- [x] src/mcp/tools/device/list_devices.ts:391
+- [x] src/mcp/tools/logging/start_device_log_cap.ts:665
+- [x] src/mcp/tools/logging/start_sim_log_cap.ts:81
+- [x] src/mcp/tools/macos/get_mac_app_path.ts:167
+- [x] src/mcp/tools/project-discovery/get_app_bundle_id.ts:91
+- [x] src/mcp/tools/project-discovery/get_mac_bundle_id.ts:88
+- [x] src/mcp/tools/project-discovery/list_schemes.ts:83
+- [x] src/mcp/tools/project-discovery/show_build_settings.ts:88
+- [x] src/mcp/tools/project-scaffolding/scaffold_ios_project.ts:366
+- [x] src/mcp/tools/project-scaffolding/scaffold_macos_project.ts:340
+- [x] src/mcp/tools/simulator/boot_sim.ts:69
+- [x] src/mcp/tools/simulator/build_run_sim.ts:486
+- [x] src/mcp/tools/simulator/get_sim_app_path.ts:244
+- [x] src/mcp/tools/simulator/install_app_sim.ts:93
+- [x] src/mcp/tools/simulator/launch_app_logs_sim.ts:100
+- [x] src/mcp/tools/simulator/launch_app_sim.ts:127
+- [x] src/mcp/tools/simulator/list_sims.ts:196
+- [x] src/mcp/tools/simulator/open_sim.ts:42
+- [x] src/mcp/tools/simulator/record_sim_video.ts:130

manifests/tools/boot_sim.yaml

@@ -7,3 +7,19 @@ description: Boot iOS simulator.
 annotations:
   title: Boot Simulator
   destructiveHint: true
+nextSteps:
+  - label: Open the Simulator app (makes it visible)
+    toolId: open_sim
+    priority: 1
+  - label: Install an app
+    toolId: install_app_sim
+    params:
+      simulatorId: ${simulatorId}
+      appPath: PATH_TO_YOUR_APP
+    priority: 2
+  - label: Launch an app
+    toolId: launch_app_sim
+    params:
+      simulatorId: ${simulatorId}
+      bundleId: YOUR_APP_BUNDLE_ID
+    priority: 3

manifests/tools/build_run_sim.yaml

@@ -9,3 +9,13 @@ predicates:
 annotations:
   title: Build Run Simulator
   destructiveHint: true
+nextSteps:
+  - label: Capture structured logs (app continues running)
+    toolId: start_sim_log_cap
+    priority: 1
+  - label: Capture console + structured logs (app restarts)
+    toolId: start_sim_log_cap
+    priority: 2
+  - label: Launch app with logs in one step
+    toolId: launch_app_logs_sim
+    priority: 3

manifests/tools/debug_attach_sim.yaml

@@ -6,3 +6,13 @@ names:
 description: Attach LLDB to sim app.
 routing:
   stateful: true
+nextSteps:
+  - label: Add a breakpoint
+    toolId: debug_breakpoint_add
+    priority: 1
+  - label: Continue execution
+    toolId: debug_continue
+    priority: 2
+  - label: Show call stack
+    toolId: debug_stack
+    priority: 3

manifests/tools/get_app_bundle_id.yaml

@@ -7,3 +7,16 @@ description: Extract bundle id from .app.
 annotations:
   title: Get App Bundle ID
   readOnlyHint: true
+nextSteps:
+  - label: Install on simulator
+    toolId: install_app_sim
+    priority: 1
+  - label: Launch on simulator
+    toolId: launch_app_sim
+    priority: 2
+  - label: Install on device
+    toolId: install_app_device
+    priority: 3
+  - label: Launch on device
+    toolId: launch_app_device
+    priority: 4

manifests/tools/get_device_app_path.yaml

@@ -7,3 +7,13 @@ description: Get device built app path.
 annotations:
   title: Get Device App Path
   readOnlyHint: true
+nextSteps:
+  - label: Get bundle ID
+    toolId: get_app_bundle_id
+    priority: 1
+  - label: Install app on device
+    toolId: install_app_device
+    priority: 2
+  - label: Launch app on device
+    toolId: launch_app_device
+    priority: 3

manifests/tools/get_mac_app_path.yaml

@@ -7,3 +7,10 @@ description: Get macOS built app path.
 annotations:
   title: Get macOS App Path
   readOnlyHint: true
+nextSteps:
+  - label: Get bundle ID
+    toolId: get_mac_bundle_id
+    priority: 1
+  - label: Launch app
+    toolId: launch_mac_app
+    priority: 2

manifests/tools/get_mac_bundle_id.yaml

@@ -7,3 +7,10 @@ description: Extract bundle id from macOS .app.
 annotations:
   title: Get Mac Bundle ID
   readOnlyHint: true
+nextSteps:
+  - label: Launch the app
+    toolId: launch_mac_app
+    priority: 1
+  - label: Build again
+    toolId: build_macos
+    priority: 2

manifests/tools/get_sim_app_path.yaml

@@ -7,3 +7,16 @@ description: Get sim built app path.
 annotations:
   title: Get Simulator App Path
   readOnlyHint: true
+nextSteps:
+  - label: Get bundle ID
+    toolId: get_app_bundle_id
+    priority: 1
+  - label: Boot simulator
+    toolId: boot_sim
+    priority: 2
+  - label: Install app
+    toolId: install_app_sim
+    priority: 3
+  - label: Launch app
+    toolId: launch_app_sim
+    priority: 4

manifests/tools/install_app_sim.yaml

@@ -7,3 +7,10 @@ description: Install app on sim.
 annotations:
   title: Install App Simulator
   destructiveHint: true
+nextSteps:
+  - label: Open the Simulator app
+    toolId: open_sim
+    priority: 1
+  - label: Launch the app
+    toolId: launch_app_sim
+    priority: 2