feat(flow): focus session api v2 웹 계약 전환

docs/90_current_state.md

@@ -12,7 +12,7 @@ Last Updated: 2026-03-16
   - no-session `/app`을 `goal + duration + atmosphere` 중심의 premium entry shell로 교체했다
   - `microStep` 입력은 entry에서 제거했고, `예상 시간(분)` 입력과 12개 dummy atmosphere grid를 추가했다
   - atmosphere는 `scene + sound`가 함께 묶인 선택 단위로 동작하며, 선택한 atmosphere가 `/app` 배경과 `/space` start payload에 같이 반영된다
-  - custom duration server contract 전까지는 입력한 분 값을 가장 가까운 기본 리듬(`25/5`, `50/10`, `90/20`)으로 매핑한다
+  - 입력한 duration은 raw `focusDurationMinutes`로 server에 전달된다
   - weekly review entry는 main CTA를 먹지 않도록 no-session shell의 quiet secondary dock 위치로 이동했다
 - `/app` Atmosphere Entry Shell visual premium polish:
   - no-session shell을 `decision rail + selected atmosphere stage + curated atmosphere library` 구조로 다시 짰다
@@ -142,17 +142,13 @@ Last Updated: 2026-03-16
   - current session이 없고 최근 7일 데이터가 충분할 때 `/app`의 quiet secondary review dock에서 `Weekly Review` entry를 노출한다
   - current session이 있으면 `/app` 자체가 `/space`로 이동하므로, `/app` review entry는 no-session entry shell 안에서만 다룬다
 - `/stats -> /app` handoff의 2차 연결:
-  - `/stats` 마지막 CTA는 `/app?review=weekly&carryHint=...&entryPreset=forest-50-10`으로 연결된다
+  - `/stats` 마지막 CTA는 `/app?review=weekly&carryHint=...&entryAtmosphereId=forest-draft&entryDurationMinutes=50`으로 연결된다
   - `/app`은 이 query를 받아 entry stage 위의 review-aware return hint를 노출한다
   - goal과 duration은 자동 입력하지 않고, 방향만 가볍게 제안한다
 - Pro personalized handoff 3차 연결:
   - Pro에서는 `/stats` carry-forward 섹션에 추천 ritual을 함께 보여준다
-  - `/stats` 마지막 CTA 카피가 generic start가 아니라 `가장 잘 맞은 ritual로 /app 돌아가기`로 바뀐다
+  - `/stats` 마지막 CTA 카피가 generic start가 아니라 `가장 잘 맞은 atmosphere로 /app 돌아가기`로 바뀐다
   - `/app` teaser와 review return hint도 Pro에서 더 구체적인 next-session handoff 톤으로 표시된다
-- `/space` secondary review teaser 4차 연결:
-  - goal complete로 setup 상태로 돌아왔을 때만 setup drawer 아래에 low-emphasis review teaser가 보인다
-  - teaser는 `주간 review 보기`로 `/stats`를 열고, 방금 끝낸 흐름 반영을 과장하지 않는 카피만 사용한다
-  - 다시 시작하거나 dismiss하면 사라지며, live execution 중에는 보이지 않는다
 - `Weekly Review` recovery의 서버 연결:
   - server `focus-summary` 응답에 `recovery`가 추가됐다
   - `pause_count / resume_count` 기반 `pause 뒤 복귀`를 실제 수치로 보여준다
@@ -184,7 +180,6 @@ Last Updated: 2026-03-16
   - HUD 내부 status line을 제거하고 상단 중앙 고정 토스트로 통합
   - Notes 저장/Undo, Goal 전환, 잠금 안내 피드백이 동일 위치에서 노출
 - Free 코어 루프 개방:
-  - Quick Controls Time의 `90/20` 잠금을 제거
   - 기본 Sound 잠금 제거로 Free에서도 기본 3~6 프리셋 선택 가능
 - Pro 가치 재배치:
   - Pro 잠금 대상을 `Daily Focus Plan / Rituals / Weekly Review`로 재정의
@@ -210,11 +205,11 @@ Last Updated: 2026-03-16
   - 모드 설명 1줄(기본: 모든 컨트롤 표시, 몰입: 필수만 남기고 숨김) 추가
   - 모드 상태를 workspace -> tools-dock -> focus-hud 경로로 연결해 HUD 톤 반영 유지
 - `/space` Scene 기반 자동 추천 적용:
-  - `RoomTheme`에 `recommendedSoundPresetId`, `recommendedTimerPresetId` 필드 추가
-  - 첫 진입/시작 시 Scene 추천 타이머/사운드가 자동 반영되도록 초기화 로직 정리
-  - Scene 변경 시 `override.sound/timer`가 `false`인 항목만 자동 동기화
+  - `RoomTheme`에 `recommendedSoundPresetId` 필드 추가
+  - 첫 진입/시작 시 Scene 추천 사운드와 atmosphere 기반 duration이 자동 반영되도록 초기화 로직 정리
+  - Scene 변경 시 `override.sound/duration`가 `false`인 항목만 자동 동기화
 - `/space` 사용자 override 존중 규칙 도입:
-  - `override.sound`, `override.timer` UI 상태 추가
+  - `override.sound`, `override.duration` UI 상태 추가
   - 사용자가 직접 고른 항목은 이후 Scene 변경에도 자동 덮어쓰기되지 않도록 반영
   - `추천으로 되돌리기(더미)` 액션으로 override 초기화 + 추천값 즉시 복원 지원
 - `Control Center`를 Scene/Time 중심으로 단순화:
@@ -224,8 +219,8 @@ Last Updated: 2026-03-16
 - 우하단 Sound Quick 경로를 override 적용의 명시적 경로로 분리:
   - `onQuickSoundSelect` 콜백으로 연결해 `override.sound` 규칙을 코드 레벨에서 고정
 - 세션 상태 더미 저장/복원 추가:
-  - `sceneId`, `timerPresetId`, `soundPresetId`, `goal`, `override(sound/timer)`를 localStorage에 저장
-  - 복원 우선순위: 쿼리 파라미터 > 저장 상태 > Scene 추천
+  - `sceneId`, `durationMinutes`, `soundPresetId`, `goal`, `override(sound/duration)`를 localStorage에 저장
+  - 복원 우선순위: 저장 상태 > 사용자 기본 설정 > atmosphere 추천
 - `/space` 진입 Resume CTA 추가:
   - 저장된 목표가 있고 쿼리 오버라이드가 없을 때 `지난 한 조각 이어서` 블록 1회 노출
   - `이어서 시작`: 저장 목표로 즉시 Focus 진입