feat: 운영 안정성과 세션 음성 경험 개선

docs/ops/public-runtime-watchdog.md

@@ -60,8 +60,19 @@ Use this when you want to force a runtime restore immediately:
 powershell -NoProfile -ExecutionPolicy Bypass -File scripts\start-public-runtime.ps1
 ```
 
-`start-public-runtime.ps1` now verifies or starts the engine gateway before it
-starts the prod API and cloudflared.
+`start-public-runtime.ps1`는 관리자·인증 제어면과 엔진을 분리한다. 이미
+`environment=prod`, `db=true`인 API와 정상 웹·터널은 유지하고, 엔진만 실패한 경우
+엔진만 복구한다. 엔진이 늦게 준비돼도 관리자·인증 API 기동을 막지 않는다.
+
+API 코드 변경을 운영 프로세스에 반영할 때는 다른 표면을 유지한 채 API만 명시적으로 교체한다.
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File scripts\start-public-runtime.ps1 `
+  -ForceApiRestart `
+  -SkipEngineRestart `
+  -SkipWebRestart `
+  -SkipCloudflaredRestart
+```
 
 ## Health Checks
 
@@ -113,6 +124,11 @@ and `C:\Users\<user>\.cloudflared\vignette-config.yml`.
 If engine health fails, verify that `claude` runs for the same Windows user that
 owns the scheduled task and that the user has completed Claude CLI login.
 
+엔진 장애 중에도 `http://127.0.0.1:8001/health`의 `environment=prod`, `db=true`가
+유지되면 관리자·인증 제어면은 정상이다. 이때 watchdog은 API·웹·터널을 재시작하지
+않는다. 예약 작업 확인 기준은 `VignettePublicRuntime`의 `LastTaskResult=0`과
+`public-runtime-watchdog.failcount=0`이다.
+
 If API health fails with `environment`, `db`, or auth configuration errors,
 inspect `apps/api/.env`; do not copy secret values into scripts or task
 arguments.