세션 인계 문서 + API 핫리로드

- docs/ops/handoff-2026-06-27.md: 완료/잔여(위기 안전게이트 109·교수자 성장 UI)·재개 방법·한신대 PDF 핵심·병렬 아바타 세션 주의
- scripts/dev-up.ps1: API --reload(watchfiles) 핫리로드 — app/*.py 저장 시 자동 재기동

scripts/dev-up.ps1

@@ -3,7 +3,10 @@
   Vignette 로컬 개발 스택을 깔끔하게 (재)기동한다: 엔진 게이트웨이(9099) + API(8000) + 웹(5173).
 
 .DESCRIPTION
-  - 기존(고아 포함) 프로세스를 커맨드라인 기준으로 정확히 정리한 뒤 새로 띄운다(--reload 미사용: 결정론적).
+  - 기존(고아 포함) 프로세스를 커맨드라인 기준으로 정확히 정리한 뒤 새로 띄운다.
+    API는 --reload(watchfiles)로 핫리로드 — app/ 수정 시 자동 재기동(수동 재시작 불필요).
+    게이트웨이는 no-reload 유지(상주 claude -p 세션 보존; Windows에선 reload 시 자식 claude 고아화).
+    웹(vite)은 npm run dev 기본 HMR.
   - API는 DB 미가용 시 in-memory degraded로 기동된다(Postgres 불필요). dev-login + seed 페르소나 활성.
   - 로그는 .devlogs/ 에 남긴다. 종료는 scripts/dev-down.ps1.
 
@@ -108,11 +111,12 @@ if (-not $NoGateway) {
     -RedirectStandardError  (Join-Path $logs 'gateway.err.log')
 } else { Write-Host "[2/4] (게이트웨이 건너뜀)" }
 
-Write-Host "[3/4] API :8000 (degraded in-memory OK, seed 페르소나)..."
+Write-Host "[3/4] API :8000 (핫리로드 --reload, degraded in-memory OK, seed 페르소나)..."
 $env:AUTO_SEED_PERSONAS = 'true'
 $env:ALLOW_SEED_PERSONA_FALLBACK = 'true'
+# --reload + --reload-dir app: app/ 하위 .py 저장 시 watchfiles 가 감지해 자동 재기동.
 Start-Process -FilePath $Python `
-  -ArgumentList (@($PyPre) + @('-m','uvicorn','app.main:app','--host','127.0.0.1','--port','8000')) `
+  -ArgumentList (@($PyPre) + @('-m','uvicorn','app.main:app','--host','127.0.0.1','--port','8000','--reload','--reload-dir','app')) `
   -WorkingDirectory $api -WindowStyle Hidden `
   -RedirectStandardOutput (Join-Path $logs 'api.out.log') `
   -RedirectStandardError  (Join-Path $logs 'api.err.log')