diff --git a/docs/release-control/v6/internal/subsystems/deployment-installability.md b/docs/release-control/v6/internal/subsystems/deployment-installability.md index 7896ec0656..839b2f5a60 100644 --- a/docs/release-control/v6/internal/subsystems/deployment-installability.md +++ b/docs/release-control/v6/internal/subsystems/deployment-installability.md @@ -210,9 +210,10 @@ entrypoint for routine startup instead of teaching direct script invocation as the primary habit. That operator-guidance rule also applies to the managed launcher's recovery and diagnostic messages: when `hot-dev-bg` tells users how to start, restart, -verify, or inspect the routine local dev runtime, it must route them to the -repo-root `npm run dev`, `npm run dev:verify`, and `npm run dev:logs` wrappers -instead of teaching direct raw script invocations for those day-to-day flows. +verify, supervise, or inspect the routine local dev runtime, it must route them +to the repo-root `npm run dev`, `npm run dev:verify`, and `npm run dev:logs` +wrappers instead of teaching direct raw script invocations for those day-to-day +flows. That same dev-runtime helper boundary also includes the auxiliary operator controls that start, stop, restart, or recover local development. The repo-root Makefile targets, `scripts/toggle-mock.sh`, and `scripts/clean-mock-alerts.sh` must diff --git a/scripts/hot-dev-bg.sh b/scripts/hot-dev-bg.sh index 7f74c766ed..42ccccc61b 100755 --- a/scripts/hot-dev-bg.sh +++ b/scripts/hot-dev-bg.sh @@ -692,7 +692,7 @@ launchd_session_bg() { managed_pid="$(managed_session_pid)" if [[ -n "${managed_pid}" ]] && has_unmanaged_listeners "${managed_pid}"; then if [[ "${takeover}" != "true" ]]; then - fail "Managed runtime has split ownership. Rerun with: ./scripts/hot-dev-bg.sh launchd-session --takeover" + fail "Managed runtime has split ownership. Rerun with: npm run dev" fi log "Managed runtime has split ownership. Reclaiming ports before launchd supervision..." stop_bg diff --git a/scripts/tests/test-hot-dev-bg.sh b/scripts/tests/test-hot-dev-bg.sh index 8e09e463b5..ebb7cdcf13 100755 --- a/scripts/tests/test-hot-dev-bg.sh +++ b/scripts/tests/test-hot-dev-bg.sh @@ -329,6 +329,7 @@ test_hot_dev_bg_script_advertises_managed_entrypoint() { assert_contains "hot-dev-bg still documents direct launcher start" "${output}" "./scripts/hot-dev-bg.sh start [--takeover]" assert_contains "hot-dev-bg routes log guidance to managed wrapper" "${output}" "Check logs with: npm run dev:logs" assert_contains "hot-dev-bg routes verify guidance to managed wrapper" "${output}" "Rerun with: npm run dev:verify" + assert_contains "hot-dev-bg routes launchd supervision guidance to managed wrapper" "${output}" "Rerun with: npm run dev" } test_clean_mock_alerts_prefers_managed_runtime() {